@wenathlan/extension 1.1.47 → 1.1.48

package/extension/dist/background.js

@@ -224,6 +224,156 @@ function expireprofilerecords(input) {
   };
 }
 
+// emulation.ts
+var emulationkinds = ["emulatedevice", "emulatenetwork", "emulatelocate", "setuseragent", "overridepermission", "blackboxscripts"];
+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 revertplanof(value) {
+  const steps = Array.isArray(value) ? value.filter((step) => typeof step === "string" && step.trim().length > 0) : [];
+  return steps.length > 0 ? steps : void 0;
+}
+function newlayer(input) {
+  return { id: input.id, runid: input.runid, stepid: input.stepid, family: input.family, name: input.name, originscope: input.originscope, appliedat: input.at, ...input.prior !== void 0 ? { prior: input.prior } : {}, revertplan: [...input.revertplan] };
+}
+function emulationstateof(input) {
+  return { runid: input.runid, tabid: input.tabid, origin: input.origin, layers: [], updatedat: input.now };
+}
+function applylayer(state, layer, at) {
+  const layers = [...state.layers.filter((item) => item.id !== layer.id), layer];
+  return { ...state, layers, updatedat: at };
+}
+function revertalllayers(state, at) {
+  const reverted = [...state.layers].reverse().filter((layer) => layer.revertedat === void 0);
+  const layers = state.layers.map((layer) => layer.revertedat === void 0 ? { ...layer, revertedat: at } : layer);
+  return { state: { ...state, layers, updatedat: at }, reverted };
+}
+function activelayers(state) {
+  return state ? state.layers.filter((layer) => layer.revertedat === void 0) : [];
+}
+function layernames(state) {
+  return activelayers(state).map((layer) => layer.name);
+}
+function locationrangevalid(latitude, longitude) {
+  return Number.isFinite(latitude) && Number.isFinite(longitude) && latitude >= -90 && latitude <= 90 && longitude >= -180 && longitude <= 180;
+}
+function agentgrammarvalid(useragent) {
+  const text2 = useragent.trim();
+  if (text2.length === 0 || text2.length > 512) return false;
+  if (/[\r\n]/.test(text2)) return false;
+  if (!/^[A-Za-z0-9][A-Za-z0-9._+\-()/:; ,]*$/.test(text2)) return false;
+  return /\/\d/.test(text2) || /\d+\.\d+/.test(text2);
+}
+function permissiongrade(name) {
+  return name === "geolocation" || name === "camera" || name === "microphone" || name === "notifications" ? "powerful" : "standard";
+}
+function expirelayers(state, retention, now) {
+  if (retention === void 0) return state;
+  const layers = state.layers.map((layer) => {
+    if (layer.revertedat === void 0 || layer.prior === void 0 || layer.priorexpired === true) return layer;
+    if (now - layer.revertedat <= retention) return layer;
+    const { prior, ...metadata } = layer;
+    void prior;
+    return { ...metadata, priorexpired: true };
+  });
+  return { ...state, layers, updatedat: now };
+}
+function exportpresetlibrary(input) {
+  return { version: 1, devices: [...input.devices], networks: [...input.networks], locations: [...input.locations], agents: [...input.agents], exportedat: input.now };
+}
+function importpresetlibrary(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) return void 0;
+  const entry = value;
+  const devices = (Array.isArray(entry.devices) ? entry.devices : []).flatMap((preset) => {
+    const parsed = devicepresetof(preset);
+    return parsed !== void 0 ? [parsed] : [];
+  });
+  const networks = (Array.isArray(entry.networks) ? entry.networks : []).flatMap((preset) => {
+    const parsed = networkpresetof(preset);
+    return parsed !== void 0 ? [parsed] : [];
+  });
+  const locations = (Array.isArray(entry.locations) ? entry.locations : []).flatMap((preset) => {
+    const parsed = locationpresetof(preset);
+    return parsed !== void 0 ? [parsed] : [];
+  });
+  const agents = (Array.isArray(entry.agents) ? entry.agents : []).flatMap((preset) => {
+    const parsed = agentpresetof(preset);
+    return parsed !== void 0 ? [parsed] : [];
+  });
+  if (devices.length + networks.length + locations.length + agents.length === 0) return void 0;
+  return { version: typeof entry.version === "number" && Number.isInteger(entry.version) && entry.version >= 1 ? entry.version : 1, devices, networks, locations, agents, exportedat: typeof entry.exportedat === "number" ? entry.exportedat : Date.now() };
+}
+function locationconsentcovers(origin, latitude, longitude, consents) {
+  return consents.some((consent) => consent.origin === origin && consent.approved === true && consent.revokedat === void 0 && consent.latitude === latitude && consent.longitude === longitude);
+}
+
 // memory.ts
 var sessionmemory = class {
   constructor(adapter) {
@@ -1594,6 +1744,83 @@ var sessionmemory = class {
     await this.adapter.set("sourcemapconsents", updated);
     return revoked;
   }
+  /** Stores the emulation state of one run keyed by its run id; the reverted layer prior states expire after the user configured retention window while the layer history always survives. */
+  async setemulationstate(state) {
+    const retention = (await this.getsettings())?.emulationretention;
+    await this.adapter.set(`emulationstate${state.runid}`, expirelayers(state, retention, Date.now()));
+  }
+  /** Returns the persisted emulation state of one run so the layers survive service worker restarts. */
+  async getemulationstate(runid) {
+    return this.adapter.get(`emulationstate${runid}`);
+  }
+  /** Returns the active and past layers of one run, newest last in apply order; the listlayers accessor of the emulation memory. */
+  async listlayers(runid) {
+    const state = await this.getemulationstate(runid);
+    return state?.layers ?? [];
+  }
+  /** Stores one user curated device preset by its name so the preset library stays user data instead of a hardcoded list. */
+  async setdevicepreset(preset) {
+    const records = (await this.adapter.get("devicepresets") ?? []).filter((item) => item.name !== preset.name);
+    await this.adapter.set("devicepresets", [...records, preset]);
+  }
+  /** Returns every user curated device preset. */
+  async getdevicepresets() {
+    return await this.adapter.get("devicepresets") ?? [];
+  }
+  /** Stores one user curated network preset by its name with editable values. */
+  async setnetworkpreset(preset) {
+    const records = (await this.adapter.get("networkpresets") ?? []).filter((item) => item.name !== preset.name);
+    await this.adapter.set("networkpresets", [...records, preset]);
+  }
+  /** Returns every user curated network preset. */
+  async getnetworkpresets() {
+    return await this.adapter.get("networkpresets") ?? [];
+  }
+  /** Stores one user curated location preset by its name. */
+  async setlocationpreset(preset) {
+    const records = (await this.adapter.get("locationpresets") ?? []).filter((item) => item.name !== preset.name);
+    await this.adapter.set("locationpresets", [...records, preset]);
+  }
+  /** Returns every user curated location preset. */
+  async getlocationpresets() {
+    return await this.adapter.get("locationpresets") ?? [];
+  }
+  /** Stores one user curated agent preset by its name. */
+  async setagentpreset(preset) {
+    const records = (await this.adapter.get("agentpresets") ?? []).filter((item) => item.name !== preset.name);
+    await this.adapter.set("agentpresets", [...records, preset]);
+  }
+  /** Returns every user curated agent preset. */
+  async getagentpresets() {
+    return await this.adapter.get("agentpresets") ?? [];
+  }
+  /** Replaces the blackbox rule set of one origin so third party script blackboxing stays scoped per origin. */
+  async setblackboxrules(origin, rules) {
+    const records = (await this.adapter.get("blackboxrules") ?? []).filter((item) => item.origin !== origin);
+    await this.adapter.set("blackboxrules", [...records, { origin, rules }]);
+  }
+  /** Returns every stored blackbox rule set with its origin. */
+  async getblackboxrules() {
+    return await this.adapter.get("blackboxrules") ?? [];
+  }
+  /** Records one permission override of a run with its prior state captured for the exact restore. */
+  async addpermissionoverride(record2) {
+    const records = (await this.adapter.get("permissionoverrides") ?? []).filter((item) => item.id !== record2.id);
+    await this.adapter.set("permissionoverrides", [record2, ...records]);
+  }
+  /** Returns the permission override history with restore states, newest first. */
+  async getpermissionoverrides() {
+    return await this.adapter.get("permissionoverrides") ?? [];
+  }
+  /** Stores one location consent decision per origin, replacing the previous decision of its id. */
+  async setlocationconsent(consent) {
+    const records = (await this.adapter.get("locationconsents") ?? []).filter((item) => item.id !== consent.id);
+    await this.adapter.set("locationconsents", [consent, ...records]);
+  }
+  /** Returns every location consent decision, newest first. */
+  async getlocationconsents() {
+    return await this.adapter.get("locationconsents") ?? [];
+  }
 };
 function mediakindof(record2) {
   if ("pages" in record2) return "pdf";
@@ -2813,9 +3040,9 @@ function consolediff(input) {
 }
 
 // policy.ts
-var sensitiveactions = /* @__PURE__ */ new Set(["click", "type", "navigate", "select", "presskey", "drag", "drop", "upload", "clear", "check", "uncheck", "toggle", "submit", "reload", "back", "forward", "writestorage", "setattribute", "removeattribute", "evaluate", "tabcreate", "tabactivate", "tabclose", "tabreload", "windowcreate", "windowclose", "windowresize", "downloadfile", "clickpoint", "shiftclick", "dismissdialog", "enterframe", "typetime", "appendtext", "setvalue", "typeedit", "keyhold", "keyrelease", "submitsearch", "selectmulti", "chooseradio", "setslider", "setdate", "setcolor", "openlink", "openprivate", "reloadcache", "stopnav", "followlink", "spanav", "rewritequery", "setfragment", "navlist", "navprofile", "handleauth", "printpdf", "prefetch", "preconnect", "deeplink", "reopentab", "pausenav", "navrate", "openclipboard", "batchopen", "duplicatetab", "closepattern", "pintab", "mutetab", "movetab", "movetabwindow", "grouptabs", "colorgroup", "collapsegroup", "discardtab", "reloadtabs", "zoomin", "zoomout", "switchtab", "maximizewindow", "minimizewindow", "restorewindow", "focuswindow", "scratchwindow", "incognitowindow", "restoretab", "restorelayout", "reopenrun", "badgetab", "fillform", "filllabel", "fillplaceholder", "submitform", "retryform", "runwizard", "selectchain", "picktypeahead", "pickdate", "attachfile", "fillcard", "fillcode", "consentpassword", "exportcsv", "exportjson", "exportexcel", "copytable", "pushsheets", "streamdisk", "paginateextract", "resumeextract", "batchdownload", "pausedownload", "resumedownload", "interceptmime", "readclipboard", "writeclipboard", "copyscreen", "quarantinedownload", "scanvirus", "cleanupartifacts", "recordscreen", "captureaudio", "downloadimages", "callrest", "callgraphql", "sendmessage", "blockrequest", "mockresponse", "rewriteheaders", "setcookies", "clearcookies", "authflow", "saveapikey", "routeproxy", "postform", "postfiles", "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"]);
 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"]);
 var allowedactions = /* @__PURE__ */ new Set([...sensitiveactions, ...interactionactions, ...readactions]);
 var watchactions = /* @__PURE__ */ new Set(["watchmutate", "watchbanner", "watchfocus", "watchtab"]);
 var targetactions = /* @__PURE__ */ new Set(["inspect", "focus", "click", "type", "scroll", "select", "hover", "clickdeep", "rightclick", "doubleclick", "drag", "drop", "upload", "clear", "check", "uncheck", "toggle", "submit", "readattribute", "readstyle", "readgeometry", "readvalue", "readtext", "readhtml", "countelements", "readtable", "highlight", "setattribute", "removeattribute", "waitfor", "shiftclick", "typetime", "appendtext", "setvalue", "typeedit", "submitsearch", "selectmulti", "chooseradio", "setslider", "setdate", "setcolor", "expanddetails", "verifyvisible", "verifyenabled", "pierceshadow", "deriveselector", "fingerprintsection", "submitform", "retryform", "selectchain", "picktypeahead", "pickdate", "attachfile", "fillcode", "consentpassword", "scrapetable", "paginateextract", "shotelement", "captureframe", "shotcanvas"]);
@@ -2834,6 +3061,7 @@ var controlactions = /* @__PURE__ */ new Set(["blockrequest", "mockresponse", "r
 var debugactions = /* @__PURE__ */ new Set(["watchconsole", "watcherrors", "watchtasks"]);
 var cdpactions = /* @__PURE__ */ new Set(["attachcdp", "detachcdp", "cdpcmd", "watchcdp", "setbreakpoint", "stepcode", "watchexpr", "overridescript"]);
 var profileractions = /* @__PURE__ */ new Set(["measureflow", "heapshot", "trackmemory", "profilecpu", "watchshifts", "traceload", "annotatetrace", "replaytrace", "capturesourcemaps"]);
+var emulationactions = /* @__PURE__ */ new Set(["emulatedevice", "emulatenetwork", "emulatelocate", "setuseragent", "overridepermission", "blackboxscripts"]);
 var credentialheaders = /* @__PURE__ */ new Set(["authorization", "proxy-authorization", "cookie", "cookie2", "set-cookie", "api-key", "x-api-key", "x-auth-token", "x-session-token", "proxy-authorization"]);
 var fieldkinds = ["text", "email", "phone", "date", "number", "select", "check", "radio", "file", "password", "card", "code"];
 var layoutmutationactions = /* @__PURE__ */ new Set(["grouptabs", "colorgroup", "collapsegroup", "savelayout", "restorelayout"]);
@@ -2858,6 +3086,9 @@ function iscdpkind(kind) {
 function isprofilekind(kind) {
   return profileractions.has(kind);
 }
+function isemulationkind(kind) {
+  return emulationactions.has(kind);
+}
 function actionrisk(kind) {
   if (!allowedactions.has(kind)) throw new Error("Unsupported browser action.");
   if (sensitiveactions.has(kind)) return "sensitive";
@@ -4221,6 +4452,74 @@ function breakpointbudgetallowed(active, ceiling) {
 function breakpointceilingof(settings) {
   return settings?.breakpointceiling;
 }
+function emugate(input) {
+  const gate = sessiongate({ session: input.session, tabid: input.tabid, origin: input.origin, now: input.now, action: "emulate the run tab" });
+  if (!gate.allowed) return gate;
+  if (!input.plan || input.plan.state !== "approved") return { allowed: false, reason: "Emulation layers need an approved plan before they apply." };
+  let options = {};
+  try {
+    options = parseoptions(input.step);
+  } catch {
+    options = {};
+  }
+  if (options.reviewed !== true) return { allowed: false, reason: `The ${input.step.kind} layer needs the explicit reviewed flag before any mask applies.` };
+  if (revertplanof(options.revertplan) === void 0) return { allowed: false, reason: `Every ${input.step.kind} layer needs a reviewed revert plan beside it before any mask applies.` };
+  return { allowed: true };
+}
+function emulationstackallowed(plan, kind, active) {
+  if (!plan) return { allowed: false, reason: "Layer stacking needs the reviewed plan first." };
+  const listed = plan.steps.filter((step) => step.kind === kind).length;
+  if (active >= listed) return { allowed: false, reason: `The plan lists ${listed} reviewed ${kind} step${listed === 1 ? "" : "s"} and ${active} layer${active === 1 ? "" : "s"} of that family are already active; stacking beyond the reviewed plan is refused.` };
+  return { allowed: true };
+}
+function locationconsentgate(origin, latitude, longitude, consents) {
+  if (consents.some((consent) => consent.origin === origin && consent.revokedat !== void 0)) return { allowed: false, reason: `The location consent on ${origin} was revoked; approve a new prompt before the location override runs again.` };
+  if (locationconsentcovers(origin, latitude, longitude, consents)) return { allowed: true };
+  return { allowed: false, reason: `The location override of ${latitude}, ${longitude} on ${origin} needs the reviewed location consent first; approve the prompt with the coordinates shown in the review panel.` };
+}
+function validateemulationgrammar(step, options) {
+  const kind = step.kind;
+  if (revertplanof(options.revertplan) === void 0) return { allowed: false, reason: `Every ${kind} layer needs a reviewed revert plan before any mask applies.` };
+  if (kind === "emulatedevice") {
+    const preset = devicepresetof(options.device);
+    if (!preset) return { allowed: false, reason: "The device layer needs a reviewed preset with a name, positive integer width and height and a positive pixel ratio." };
+    if (options.reload !== void 0 && typeof options.reload !== "boolean") return { allowed: false, reason: "The reviewed reload flag must be a boolean; the page reloads only when the reviewed plan asks." };
+    return { allowed: true };
+  }
+  if (kind === "emulatenetwork") {
+    const preset = networkpresetof(options.network);
+    if (!preset) return { allowed: false, reason: "The network layer needs a reviewed preset with a name and zero or positive latency, download and upload bounds." };
+    if (options.window !== void 0 && (typeof options.window !== "number" || !Number.isFinite(options.window) || options.window < 0)) return { allowed: false, reason: "The reviewed offline window must be zero or a positive number of milliseconds with no code ceiling." };
+    return { allowed: true };
+  }
+  if (kind === "emulatelocate") {
+    const preset = locationpresetof(options.location);
+    if (!preset) return { allowed: false, reason: "The location layer needs a reviewed preset with a name, a latitude inside -90 and 90, a longitude inside -180 and 180 and a zero or positive accuracy radius." };
+    if (!locationrangevalid(preset.latitude, preset.longitude)) return { allowed: false, reason: "The reviewed latitude must stay inside -90 and 90 degrees and the longitude inside -180 and 180 degrees." };
+    return { allowed: true };
+  }
+  if (kind === "setuseragent") {
+    const preset = agentpresetof(options.agent);
+    if (!preset) return { allowed: false, reason: "The agent layer needs a reviewed preset with a user agent string of the reviewed grammar, a platform and a non-empty brand list." };
+    if (!agentgrammarvalid(preset.useragent)) return { allowed: false, reason: "The reviewed user agent string must use the reviewed grammar of tokens, separators and version marks without line breaks." };
+    return { allowed: true };
+  }
+  if (kind === "overridepermission") {
+    const grant = permissiongrantof(options.permission);
+    if (!grant) return { allowed: false, reason: `The permission override needs a reviewed name of the browser permission set (${browserpermissions.join(", ")}) and a state of ${permissionstates.join(", ")}.` };
+    void permissiongrade(grant.name);
+    return { allowed: true };
+  }
+  if (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 { allowed: false, reason: "The blackbox layer needs a reviewed non-empty rule list where every pattern names its origin explicitly and carries a trace scope." };
+    return { allowed: true };
+  }
+  return { allowed: true };
+}
 function validatecdpgrammar(step, options) {
   const kind = step.kind;
   if (kind === "attachcdp") {
@@ -4782,6 +5081,10 @@ function validatestep(step, origin) {
     const profilecheck = validateprofilegrammar(step, options);
     if (!profilecheck.allowed) return profilecheck;
   }
+  if (isemulationkind(step.kind)) {
+    const emulationcheck = validateemulationgrammar(step, options);
+    if (!emulationcheck.allowed) return emulationcheck;
+  }
   if (step.kind === "tabcreate") {
     if (options.background !== void 0 && typeof options.background !== "boolean") return { allowed: false, reason: "The reviewed background flag must be a boolean." };
     if (options.window !== void 0 && (typeof options.window !== "number" || !Number.isInteger(options.window) || options.window < 0)) return { allowed: false, reason: "The reviewed target window id must be a non-negative integer." };
@@ -4951,6 +5254,10 @@ function canexecute(input) {
       }
     }
   }
+  if (isemulationkind(input.step.kind)) {
+    const emugatecheck = emugate({ session: input.session, plan: input.plan, step: input.step, tabid: input.tabid, origin: input.origin, now });
+    if (!emugatecheck.allowed) return emugatecheck;
+  }
   if (iscontrolkind(input.step.kind)) {
     const controlgate = sessiongate({ session: input.session, tabid: input.tabid, origin: input.origin, now, action: "control the network" });
     if (!controlgate.allowed) return controlgate;
@@ -5196,9 +5503,14 @@ function recordprofile(progress, planid, stepid, entry, now) {
   const outcome = { stepid, ok: true, summary: `The profiling ${entry.family} capture ran${counts.length > 0 ? ` with ${counts}` : ""}.`, details: { profile: entry }, at: now };
   return recordoutcome(base, planid, outcome, now);
 }
+function recordemulation(progress, planid, stepid, entry, now) {
+  const base = progress && progress.planid === planid ? progress : emptyprogress(planid, now);
+  const outcome = { stepid, ok: true, summary: `${entry.reason}: ${entry.applied.length} applied layer${entry.applied.length === 1 ? "" : "s"}${entry.applied.length > 0 ? ` (${entry.applied.join(", ")})` : ""} and ${entry.reverted.length} reverted layer${entry.reverted.length === 1 ? "" : "s"}${entry.reverted.length > 0 ? ` (${entry.reverted.join(", ")})` : ""}.`, details: { emulation: entry }, at: now };
+  return recordoutcome(base, planid, outcome, now);
+}
 
 // version.ts
-var packageversion = "1.1.47";
+var packageversion = "1.1.48";
 
 // types.ts
 var protocolversion = packageversion;
@@ -5370,6 +5682,28 @@ function parseproposal(value, origin, grants) {
       }
       if (step.kind === "annotatetrace" && (!Array.isArray(profileoptions.annotations) || profileoptions.annotations.length === 0 || !profileoptions.annotations.every((annotation) => annotationof(annotation) !== void 0))) throw new Error("Trace annotation steps without reviewed step annotations are refused.");
     }
+    if (isemulationkind(step.kind)) {
+      const granted = covered.some((pattern) => {
+        try {
+          return new URL(origin).origin === new URL(pattern).origin;
+        } catch {
+          return false;
+        }
+      });
+      if (!granted) throw new Error(`The ${step.kind} step of ${origin} targets an origin outside the grants.`);
+      let emulationoptions = {};
+      try {
+        emulationoptions = parseoptions(step);
+      } catch {
+        emulationoptions = {};
+      }
+      if (revertplanof(emulationoptions.revertplan) === void 0) throw new Error("Emulation steps without a reviewed revert plan are refused.");
+      if (step.kind === "emulatelocate") {
+        const preset = locationpresetof(emulationoptions.location);
+        if (preset === void 0) throw new Error("Location emulation needs a reviewed preset with coordinates inside the latitude and longitude ranges.");
+      }
+      if (step.kind === "overridepermission" && permissiongrantof(emulationoptions.permission) === void 0) throw new Error("Permission overrides of unknown permission names are refused.");
+    }
     const evaluation = validatestep(step, origin);
     if (!evaluation.allowed) throw new Error(evaluation.reason);
     const target = outboundtarget(step);
@@ -5444,7 +5778,7 @@ function requestbody(input) {
   return JSON.stringify({ version: protocolversion, objective: input.objective, session: input.session, observation: input.observation, capabilities: input.capabilities });
 }
 function outcomeresponse(input) {
-  return JSON.stringify({ version: protocolversion, planid: input.plan.id, planstate: input.plan.state, outcome: input.outcome, ...input.resolvedtarget ? { resolvedtarget: input.resolvedtarget } : {}, ...input.capture ? { capture: input.capture } : {}, ...input.media ? { media: input.media } : {}, ...input.transport ? { transport: input.transport } : {}, ...input.network ? { network: input.network } : {}, ...input.control ? { control: input.control } : {}, ...input.timeline ? { timeline: input.timeline } : {}, ...input.cdp ? { cdp: input.cdp } : {}, ...input.profile ? { profile: input.profile } : {} });
+  return JSON.stringify({ version: protocolversion, planid: input.plan.id, planstate: input.plan.state, outcome: input.outcome, ...input.resolvedtarget ? { resolvedtarget: input.resolvedtarget } : {}, ...input.capture ? { capture: input.capture } : {}, ...input.media ? { media: input.media } : {}, ...input.transport ? { transport: input.transport } : {}, ...input.network ? { network: input.network } : {}, ...input.control ? { control: input.control } : {}, ...input.timeline ? { timeline: input.timeline } : {}, ...input.cdp ? { cdp: input.cdp } : {}, ...input.profile ? { profile: input.profile } : {}, ...input.emulation ? { emulation: input.emulation } : {} });
 }
 function mapresponse(input) {
   return JSON.stringify({ version: protocolversion, planid: input.plan.id, planstate: input.plan.state, map: input.map });
@@ -5567,6 +5901,14 @@ function profilereport(input) {
   });
   return { version: protocolversion, flows: input.flows, heaps: input.heaps, samples: input.samples, trends: input.trends, profiles: input.profiles, shifts: input.shifts, traces: input.traces, sourcemaps: input.sourcemaps, consents };
 }
+function emulationreport(input) {
+  const consents = input.consents.map((consent) => {
+    const { prompt, ...metadata } = consent;
+    void prompt;
+    return metadata;
+  });
+  return { version: protocolversion, ...input.state !== void 0 ? { state: input.state } : {}, layers: input.state?.layers ?? [], devices: input.devices, networks: input.networks, locations: input.locations, agents: input.agents, blackbox: input.blackbox, permissions: input.permissions, consents };
+}
 
 // capture.ts
 var capturekinds = ["shotview", "shotfullpage", "shotelement", "shotregion", "contactsheet"];
@@ -7255,7 +7597,7 @@ function stepoptions2(step) {
 }
 async function refreshcapabilities() {
   const report = await readcapabilities();
-  const withmedia = { ...report, captures: [...capturekinds], media: [...mediakinds], http: [...httpkinds], netwatch: [...socketkinds, ...netwatchkinds], control: [...controlkinds], debug: [...timelinekinds, ...cdpkinds], profile: [...profilerkinds] };
+  const withmedia = { ...report, captures: [...capturekinds], media: [...mediakinds], http: [...httpkinds], netwatch: [...socketkinds, ...netwatchkinds], control: [...controlkinds], debug: [...timelinekinds, ...cdpkinds], profile: [...profilerkinds], emulation: [...emulationkinds] };
   await memory.setcapabilities(withmedia);
   return withmedia;
 }
@@ -7696,6 +8038,8 @@ async function tracktabupdate(tabid2, changeinfo) {
       });
       await stopprofileinstrumentsforrun(runid, `the run tab navigated to ${url}`).catch(() => {
       });
+      await revertemulationforrun(runid, `the run tab navigated to ${url}`).catch(() => {
+      });
     }
     return;
   }
@@ -7721,6 +8065,10 @@ chrome.tabs.onActivated.addListener((activeinfo) => {
   void recordtabwatchevent("activated", activeinfo.tabId);
 });
 chrome.tabs.onRemoved.addListener((tabid2) => {
+  for (const [runid, state] of [...activeemulation.entries()]) {
+    if (state.tabid === tabid2) void revertemulationforrun(runid, `the run tab ${tabid2} dropped`, tabid2).catch(() => {
+    });
+  }
   const url = lastknownurls.get(tabid2);
   const title = lastknowntitles.get(tabid2) ?? "";
   const windowid = 0;
@@ -11360,11 +11708,116 @@ async function refreshbadge() {
   const observedrequests = (await memory.getexchanges()).length;
   const livechannels = (await memory.getchannels()).filter((channel) => channel.state === "open" || channel.state === "connecting").length;
   const activerulescount = [...activerules.values()].reduce((total2, ruleset) => total2 + ruleset.blocks.filter((rule) => rule.revertedat === void 0).length + ruleset.mocks.filter((rule) => rule.revertedat === void 0).length + ruleset.rewrites.filter((rule) => rule.revertedat === void 0).length + (ruleset.proxy !== void 0 && ruleset.proxy.revertedat === void 0 ? 1 : 0), 0);
+  const locationprompts = (await memory.getlocationconsents()).filter((consent) => consent.approved === void 0).length;
+  const emulatedlayers = [...activeemulation.values()].reduce((total2, state) => total2 + activelayers(state).length, 0);
   const tasktabs2 = new Set(badges.map((badge) => badge.tabid)).size;
-  const total = (queues?.prefetch ?? 0) + (queues?.batchopen ?? 0) + tasktabs2 + prompts + consents + quarantined + datasets + captures + media + recordingprompts + fetchprompts + consoleprompts + debuggerprompts + observedrequests + livechannels + activerulescount;
+  const total = (queues?.prefetch ?? 0) + (queues?.batchopen ?? 0) + tasktabs2 + prompts + consents + quarantined + datasets + captures + media + recordingprompts + fetchprompts + consoleprompts + debuggerprompts + locationprompts + emulatedlayers + observedrequests + livechannels + activerulescount;
   await chrome.action.setBadgeText({ text: total > 0 ? String(total) : "" }).catch(() => {
   });
 }
+var activeemulation = /* @__PURE__ */ new Map();
+async function loademulationstate(runid) {
+  const existing = activeemulation.get(runid);
+  if (existing) return existing;
+  const stored = await memory.getemulationstate(runid);
+  if (stored) activeemulation.set(runid, stored);
+  return stored;
+}
+async function revertemulationforrun(runid, reason, tabid2) {
+  const state = await loademulationstate(runid);
+  if (!state) return;
+  const now = Date.now();
+  const outcome = revertalllayers(state, now);
+  const target = tabid2 ?? state.tabid;
+  if (outcome.reverted.length > 0 && target !== void 0) {
+    for (const layer of outcome.reverted) {
+      await chrome.scripting.executeScript({ target: { tabId: target }, func: (family, prior) => {
+        const bridge = globalThis.devthinkbridge;
+        if (bridge) bridge.revertemulationlayer(family, prior);
+      }, args: [layer.family, layer.prior] }).catch(() => {
+      });
+    }
+  }
+  activeemulation.set(runid, outcome.state);
+  await memory.setemulationstate(outcome.state);
+  const session = await memory.getsession();
+  for (const layer of outcome.reverted) {
+    await audit("emulation", `Reverted the ${layer.family} layer ${layer.name} of run ${runid} on ${reason}; the prior state${layer.prior !== void 0 ? " restored exactly" : " needed no page state"} through the revert plan of ${layer.revertplan.join(", ")}.`, { ...session ? { sessionid: session.id } : {}, planid: runid, stepid: layer.stepid });
+  }
+  if (outcome.reverted.length > 0) {
+    const plan = await memory.getplan();
+    if (plan) await memory.setprogress(recordemulation(await memory.getprogress(), plan.id, outcome.reverted[0]?.stepid ?? "", { applied: [], reverted: outcome.reverted.map((layer) => layer.name), reason: `Emulation reverted on ${reason}` }, now));
+    await refreshbadge();
+  }
+}
+async function executeemulationstep(step, session, plan, tabid2, origin) {
+  const options = stepoptions2(step);
+  const extra = { sessionid: session.id, planid: plan.id, stepid: step.id };
+  const revertplan = revertplanof(options.revertplan) ?? [];
+  const family = familyofkind(step.kind) ?? "device";
+  const state = await loademulationstate(plan.id) ?? emulationstateof({ runid: plan.id, tabid: tabid2, origin, now: Date.now() });
+  const stacked = activelayers(state).filter((layer2) => layer2.family === family).length;
+  const stackgate2 = emulationstackallowed(plan, step.kind, stacked);
+  if (!stackgate2.allowed) throw new Error(stackgate2.reason);
+  if (step.kind === "emulatelocate") {
+    const preset = locationpresetof(options.location);
+    if (!preset) throw new Error("A reviewed location preset is required before the location override applies.");
+    const consents = await memory.getlocationconsents();
+    const consentgate = locationconsentgate(origin, preset.latitude, preset.longitude, consents);
+    if (!consentgate.allowed) {
+      const pending = consents.find((consent) => consent.origin === origin && consent.approved === void 0 && consent.latitude === preset.latitude && consent.longitude === preset.longitude);
+      if (!pending) {
+        await memory.setlocationconsent({ id: randomid(), prompt: `Location override of ${preset.latitude}, ${preset.longitude} on ${origin} for run ${plan.id} through a page-injected geolocation override; the true browser location stays untouched.`, origin, latitude: preset.latitude, longitude: preset.longitude, consentedat: Date.now() });
+        await refreshbadge();
+      }
+      throw new Error(`${consentgate.reason} The prompt is open in the review panel with the coordinates shown; approve it and run the step again.`);
+    }
+  }
+  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) throw new Error("A reviewed non-empty blackbox rule list is required.");
+    const output2 = await dispatchpagestep(step, tabid2, origin, plan) ?? { ok: false, summary: "The blackbox registration returned no result." };
+    if (!output2.ok) return output2;
+    await memory.setblackboxrules(origin, rules);
+    const name2 = `${rules.length} blackbox rule${rules.length === 1 ? "" : "s"}`;
+    const layer2 = newlayer({ id: randomid(), runid: plan.id, stepid: step.id, family: "blackbox", name: name2, originscope: origin, revertplan, at: Date.now() });
+    const updated2 = applylayer(state, layer2, Date.now());
+    activeemulation.set(plan.id, updated2);
+    await memory.setemulationstate(updated2);
+    await memory.setprogress(recordemulation(await memory.getprogress(), plan.id, step.id, { applied: [name2], reverted: [], reason: "Blackbox rules registered" }, Date.now()));
+    await audit("emulation", `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 ${origin} with the ${rules.map((rule) => rule.tracescope).join(", ")} scope${revertplan.length > 0 ? ` and the revert plan of ${revertplan.join(", ")}` : ""}; the rules stay read only trace shaping.`, extra);
+    await refreshbadge();
+    return { ok: true, summary: output2.summary, details: { ...output2.details ?? {}, emulation: { applied: [name2], reverted: [] } } };
+  }
+  const priorpermission = step.kind === "overridepermission" ? await chrome.scripting.executeScript({ target: { tabId: tabid2 }, func: (name2) => navigator.permissions?.query({ name: name2 }).then((status) => status.state).catch(() => "prompt"), args: [permissiongrantof(options.permission)?.name ?? ""] }).then((result) => result[0]?.result).catch(() => "prompt") : void 0;
+  const output = await dispatchpagestep(step, tabid2, origin, plan) ?? { ok: false, summary: "The emulation step returned no result." };
+  if (!output.ok) return output;
+  const prior = output.details?.prior;
+  let name = family;
+  if (step.kind === "emulatedevice") name = devicepresetof(options.device)?.name ?? "device";
+  if (step.kind === "emulatenetwork") name = networkpresetof(options.network)?.name ?? "network";
+  if (step.kind === "emulatelocate") name = locationpresetof(options.location)?.name ?? "location";
+  if (step.kind === "setuseragent") name = agentpresetof(options.agent)?.name ?? "agent";
+  if (step.kind === "overridepermission") name = `${permissiongrantof(options.permission)?.name ?? "permission"} ${permissiongrantof(options.permission)?.state ?? ""}`.trim();
+  const layer = newlayer({ id: randomid(), runid: plan.id, stepid: step.id, family, name, originscope: origin, revertplan, ...prior !== void 0 ? { prior } : {}, at: Date.now() });
+  const updated = applylayer(state, layer, Date.now());
+  activeemulation.set(plan.id, updated);
+  await memory.setemulationstate(updated);
+  if (step.kind === "overridepermission") {
+    const grant = permissiongrantof(options.permission);
+    if (grant) await memory.addpermissionoverride({ id: layer.id, runid: plan.id, stepid: step.id, origin, name: grant.name, state: grant.state, priorstate: priorpermission === "granted" || priorpermission === "denied" || priorpermission === "prompt" ? priorpermission : "prompt", appliedat: Date.now() });
+  }
+  if (step.kind === "emulatedevice" && options.reload === true) await chrome.tabs.reload(tabid2).catch(() => {
+  });
+  const grade = step.kind === "overridepermission" ? ` graded ${permissiongrade(permissiongrantof(options.permission)?.name ?? "")} by the reviewed permission name` : "";
+  await memory.setprogress(recordemulation(await memory.getprogress(), plan.id, step.id, { applied: [name], reverted: [], reason: `Emulation layer applied${grade}` }, Date.now()));
+  await audit("emulation", `Applied the ${family} layer ${name} of run ${plan.id} on ${origin}${grade}${prior !== void 0 ? " with the prior page state captured for the exact revert" : ""} and the revert plan of ${revertplan.join(", ")}; the mask is a page-injected override through the scripting api because no debugger or platform permission exists in the manifest.`, extra);
+  await refreshbadge();
+  return { ok: true, summary: output.summary, details: { ...output.details ?? {}, emulation: { applied: [name], reverted: [] } } };
+}
 async function executestep(stepid) {
   const session = await memory.getsession();
   const plan = await memory.getplan();
@@ -11438,6 +11891,9 @@ async function executestep(stepid) {
     } else if (isprofilekind(step.kind)) {
       if (!session || !plan || plan.state !== "approved") throw new Error("Profiling kinds refuse to run outside an approved session plan.");
       output = await executeprofilestep(step, session, plan, tab.id, origin);
+    } else if (isemulationkind(step.kind)) {
+      if (!session || !plan || plan.state !== "approved") throw new Error("Emulation kinds refuse to run outside an approved session plan.");
+      output = await executeemulationstep(step, session, plan, tab.id, origin);
     } else {
       if (step.target && freshcheckkinds.has(step.kind)) {
         const fresh = await snapshot(tab.id);
@@ -11502,6 +11958,8 @@ async function executestep(stepid) {
       });
       await stopprofileinstrumentsforrun(plan.id, "plan completion").catch(() => {
       });
+      await revertemulationforrun(plan.id, "plan completion").catch(() => {
+      });
       const done = { ...plan, state: "completed", completedat: Date.now() };
       await memory.setplan(done);
       await audit("complete", "Every reviewed step of the approved plan has executed.", { ...session ? { sessionid: session.id } : {}, planid: done.id });
@@ -11678,7 +12136,7 @@ async function handlerequest(message, sender) {
       const livetab = session ? await chrome.tabs.get(session.tabid).catch(() => void 0) : void 0;
       const waitprofile = session ? waitprofiles.find((record2) => record2.origin === session.origin) : void 0;
       const livestate = { phase: livetab?.status === "loading" ? "loading" : "complete", ...navrecords[0] ? { finalurl: navrecords[0].finalurl, redirects: navrecords[0].chain } : {} };
-      return { config: await memory.getconfig(), session, plan, progress: plan && progress?.planid === plan.id ? progress : void 0, diagnostic: await memory.getdiagnostic(), audit: await memory.getaudit(), capabilities: await refreshcapabilities(), outcomes: await memory.getoutcomes(), holds: heldkeysreport({ tabid: session?.tabid ?? 0, holds }), dialogs: await memory.getdialogs(), retries: await memory.getretries(), ...signals ? { signals: signalsreport({ signals }) } : { signals: signalsreport({}) }, banners: await memory.getbanners(), mutationevents: await memory.getmutationevents(), focusevents: await memory.getfocusevents(), diffs: await memory.getdiffs(), selectors: await memory.getselectors(), ...a11y ? { a11y } : {}, ...reader ? { reader } : {}, ...map ? { map } : {}, trail: trailreport({ ...session ? { sessionid: session.id } : {}, trail }), navrecords, ratestates, safeties, curated, waitprofiles, auths, navcontrol, navqueues, artifacts, navstate: livestate, ...waitprofile ? { waitprofile } : {}, offline: !navigator.onLine, tabs, windows, layouts: layoutreport({ layouts }), tabgroups, tabmetas, badges, snapshots, closedtabs, tabwatchevents, clones, tasktabgauge: taskgauge, ...controltab ? { controltab } : {}, tabreport: report, profiles, tickets, wizards: wizardreport({ ...session ? { sessionid: session.id } : {}, wizards, picks }), picks, errorreports, captchas, detections, ...codeentry !== void 0 ? { codeentry: true } : {}, datasets, imports, extractsessions, streams, exports, provenances, taskrules, sheetendpoints: sheetgrants, downloads, netlogs, clipconsents, clips, quarantines, cleanuprules, cleanupruns, capturecounters, inventory, mimefilters, scanhooks, captures: capturemetadata, capturepairs, capturepolicy: runsettings?.capturepolicy ?? "manual", media: mediarecords, imagebatches, recordingconsents, recordingactive: [...activerecordings.values()].map((active) => ({ id: active.record.id, kind: active.record.kind, scope: active.record.scope, startedat: active.record.startedat, stopat: active.stopat })), recordingwindow: runsettings?.recordingwindow, calls, endpoints, fetchconsents, apikeys, callretention: runsettings?.callretention, fetchesactive: activefetches.size, exchanges, channels, subscriptions, apimap, messages: messagecount, webrequestgrant: runsettings?.webrequestgrant === true, bodyretention: runsettings?.bodyretention, timelineretention: runsettings?.timelineretention, timeline, consoleconsents: await memory.getconsoleconsents(), rotationtargets: await memory.getrotationtargets(), levelsummaries: await memory.getlevelsummaries(), cdpsessions: await memory.getcdpsessions(), cdpcommands: await memory.getcdpcommands(), cdpeventrules: await memory.getcdpeventrules(), breakpoints: await memory.getbreakpoints(), pauses: await memory.getpauses(), watchexpressions: await memory.getwatchexpressions(), scriptoverrides: await memory.getscriptoverrides(), debuggergrants: await memory.getdebuggergrants(), pauseretention: runsettings?.pauseretention, breakpointceiling: runsettings?.breakpointceiling, cdpattached: [...activecdpsessions.values()].filter((active) => active.session.detachedat === void 0).length, profileretention: runsettings?.profileretention, traceceiling: runsettings?.traceceiling, profile: profilereport({ flows: await memory.getflowmetrics(), heaps: await memory.getheaprecords(), samples: await memory.getgrowsamples(), trends: await memory.gettrends(), profiles: await memory.getcpuprofiles(), shifts: await memory.getshiftentries(), traces: await memory.gettracerecords(), sourcemaps: await memory.getsourcemaps(), consents: await memory.getsourcemapconsents() }), profileactive: activememorytrackers.size + activeprofiletargets.size, profiletargets: [...activeprofiletargets.values()].flatMap((entry) => entry.targets), socketsactive: activesockets.size, traffic, tokens, authflows, activerules: [...activerules.values()].reduce((total, ruleset) => total + ruleset.blocks.filter((rule) => rule.revertedat === void 0).length + ruleset.mocks.filter((rule) => rule.revertedat === void 0).length + ruleset.rewrites.filter((rule) => rule.revertedat === void 0).length + (ruleset.proxy !== void 0 && ruleset.proxy.revertedat === void 0 ? 1 : 0), 0), ...stitchprogress.size > 0 ? { stitchprogress: [...stitchprogress.values()] } : {} };
+      return { config: await memory.getconfig(), session, plan, progress: plan && progress?.planid === plan.id ? progress : void 0, diagnostic: await memory.getdiagnostic(), audit: await memory.getaudit(), capabilities: await refreshcapabilities(), outcomes: await memory.getoutcomes(), holds: heldkeysreport({ tabid: session?.tabid ?? 0, holds }), dialogs: await memory.getdialogs(), retries: await memory.getretries(), ...signals ? { signals: signalsreport({ signals }) } : { signals: signalsreport({}) }, banners: await memory.getbanners(), mutationevents: await memory.getmutationevents(), focusevents: await memory.getfocusevents(), diffs: await memory.getdiffs(), selectors: await memory.getselectors(), ...a11y ? { a11y } : {}, ...reader ? { reader } : {}, ...map ? { map } : {}, trail: trailreport({ ...session ? { sessionid: session.id } : {}, trail }), navrecords, ratestates, safeties, curated, waitprofiles, auths, navcontrol, navqueues, artifacts, navstate: livestate, ...waitprofile ? { waitprofile } : {}, offline: !navigator.onLine, tabs, windows, layouts: layoutreport({ layouts }), tabgroups, tabmetas, badges, snapshots, closedtabs, tabwatchevents, clones, tasktabgauge: taskgauge, ...controltab ? { controltab } : {}, tabreport: report, profiles, tickets, wizards: wizardreport({ ...session ? { sessionid: session.id } : {}, wizards, picks }), picks, errorreports, captchas, detections, ...codeentry !== void 0 ? { codeentry: true } : {}, datasets, imports, extractsessions, streams, exports, provenances, taskrules, sheetendpoints: sheetgrants, downloads, netlogs, clipconsents, clips, quarantines, cleanuprules, cleanupruns, capturecounters, inventory, mimefilters, scanhooks, captures: capturemetadata, capturepairs, capturepolicy: runsettings?.capturepolicy ?? "manual", media: mediarecords, imagebatches, recordingconsents, recordingactive: [...activerecordings.values()].map((active) => ({ id: active.record.id, kind: active.record.kind, scope: active.record.scope, startedat: active.record.startedat, stopat: active.stopat })), recordingwindow: runsettings?.recordingwindow, calls, endpoints, fetchconsents, apikeys, callretention: runsettings?.callretention, fetchesactive: activefetches.size, exchanges, channels, subscriptions, apimap, messages: messagecount, webrequestgrant: runsettings?.webrequestgrant === true, bodyretention: runsettings?.bodyretention, timelineretention: runsettings?.timelineretention, timeline, consoleconsents: await memory.getconsoleconsents(), rotationtargets: await memory.getrotationtargets(), levelsummaries: await memory.getlevelsummaries(), cdpsessions: await memory.getcdpsessions(), cdpcommands: await memory.getcdpcommands(), cdpeventrules: await memory.getcdpeventrules(), breakpoints: await memory.getbreakpoints(), pauses: await memory.getpauses(), watchexpressions: await memory.getwatchexpressions(), scriptoverrides: await memory.getscriptoverrides(), debuggergrants: await memory.getdebuggergrants(), pauseretention: runsettings?.pauseretention, breakpointceiling: runsettings?.breakpointceiling, cdpattached: [...activecdpsessions.values()].filter((active) => active.session.detachedat === void 0).length, profileretention: runsettings?.profileretention, traceceiling: runsettings?.traceceiling, profile: profilereport({ flows: await memory.getflowmetrics(), heaps: await memory.getheaprecords(), samples: await memory.getgrowsamples(), trends: await memory.gettrends(), profiles: await memory.getcpuprofiles(), shifts: await memory.getshiftentries(), traces: await memory.gettracerecords(), sourcemaps: await memory.getsourcemaps(), consents: await memory.getsourcemapconsents() }), profileactive: activememorytrackers.size + activeprofiletargets.size, profiletargets: [...activeprofiletargets.values()].flatMap((entry) => entry.targets), socketsactive: activesockets.size, emulation: emulationreport({ ...plan && await loademulationstate(plan.id) !== void 0 ? { state: await loademulationstate(plan.id) } : {}, devices: await memory.getdevicepresets(), networks: await memory.getnetworkpresets(), locations: await memory.getlocationpresets(), agents: await memory.getagentpresets(), blackbox: await memory.getblackboxrules(), permissions: await memory.getpermissionoverrides(), consents: await memory.getlocationconsents() }), emulatedlayers: plan ? layernames(await loademulationstate(plan.id)) : [], emulationretention: runsettings?.emulationretention, traffic, tokens, authflows, activerules: [...activerules.values()].reduce((total, ruleset) => total + ruleset.blocks.filter((rule) => rule.revertedat === void 0).length + ruleset.mocks.filter((rule) => rule.revertedat === void 0).length + ruleset.rewrites.filter((rule) => rule.revertedat === void 0).length + (ruleset.proxy !== void 0 && ruleset.proxy.revertedat === void 0 ? 1 : 0), 0), ...stitchprogress.size > 0 ? { stitchprogress: [...stitchprogress.values()] } : {} };
     }
     case "capabilities":
       return refreshcapabilities();
@@ -12396,6 +12854,103 @@ async function handlerequest(message, sender) {
       await refreshbadge();
       return { revoked, tokenids };
     }
+    case "emulationreport": {
+      const plan = await memory.getplan();
+      const storedemulation = plan ? await loademulationstate(plan.id) : void 0;
+      return emulationreport({ ...storedemulation !== void 0 ? { state: storedemulation } : {}, devices: await memory.getdevicepresets(), networks: await memory.getnetworkpresets(), locations: await memory.getlocationpresets(), agents: await memory.getagentpresets(), blackbox: await memory.getblackboxrules(), permissions: await memory.getpermissionoverrides(), consents: await memory.getlocationconsents() });
+    }
+    case "revertemulation": {
+      const plan = await memory.getplan();
+      if (!plan) throw new Error("No plan is available for an emulation revert.");
+      const state = await loademulationstate(plan.id);
+      if (!state || activelayers(state).length === 0) throw new Error("No active emulation layer covers this run.");
+      await revertemulationforrun(plan.id, "review panel demand");
+      return { reverted: true, layers: await memory.listlayers(plan.id) };
+    }
+    case "restoreemulation": {
+      const plan = await memory.getplan();
+      if (!plan) throw new Error("No plan is available for an emulation restore.");
+      const stored = await memory.getemulationstate(plan.id);
+      if (!stored || stored.layers.length === 0) throw new Error("No stored emulation layer history covers this run.");
+      activeemulation.set(plan.id, stored);
+      await refreshbadge();
+      await audit("emulation", `Restored the stored emulation state of run ${plan.id} with ${activelayers(stored).length} active layer${activelayers(stored).length === 1 ? "" : "s"} on user demand after the service worker restart; the layer history stayed persisted through the run record.`, { planid: plan.id });
+      return { restored: true, layers: stored.layers };
+    }
+    case "approvelocationconsent": {
+      const inputapprove = message;
+      const records = await memory.getlocationconsents();
+      const record2 = records.find((item) => item.id === inputapprove.id);
+      if (!record2) throw new Error("No location consent prompt matches the id.");
+      const decided = { ...record2, approved: true, usedat: Date.now() };
+      await memory.setlocationconsent(decided);
+      await audit("consent", `Location override consent on ${record2.origin} for ${record2.latitude}, ${record2.longitude} approved from the review panel; the decision persists for those coordinates of that origin.`, { planid: record2.id });
+      await refreshbadge();
+      return { approved: true, origin: record2.origin, latitude: record2.latitude, longitude: record2.longitude };
+    }
+    case "setdevicepreset": {
+      const inputpreset = message;
+      const preset = devicepresetof(inputpreset.device);
+      if (!preset) throw new Error("A reviewed device preset needs a name, positive integer width and height and a positive pixel ratio.");
+      await memory.setdevicepreset(preset);
+      await audit("emulation", `Stored the device preset ${preset.name} of ${preset.width} by ${preset.height} css pixels with pixel ratio ${preset.pixelratio} and the ${preset.mobile ? "mobile" : "desktop"} hint in the user curated library.`, {});
+      return preset;
+    }
+    case "setnetworkpreset": {
+      const inputpreset = message;
+      const preset = networkpresetof(inputpreset.network);
+      if (!preset) throw new Error("A reviewed network preset needs a name and zero or positive latency, download and upload bounds.");
+      await memory.setnetworkpreset(preset);
+      await audit("emulation", `Stored 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" : ""} in the user curated library.`, {});
+      return preset;
+    }
+    case "setlocationpreset": {
+      const inputpreset = message;
+      const preset = locationpresetof(inputpreset.location);
+      if (!preset) throw new Error("A reviewed location preset needs a name, a latitude inside -90 and 90, a longitude inside -180 and 180 and a zero or positive accuracy radius.");
+      await memory.setlocationpreset(preset);
+      await audit("emulation", `Stored the location preset ${preset.name} of ${preset.latitude}, ${preset.longitude} with the ${preset.accuracy} meter accuracy radius in the user curated library.`, {});
+      return preset;
+    }
+    case "setagentpreset": {
+      const inputpreset = message;
+      const preset = agentpresetof(inputpreset.agent);
+      if (!preset) throw new Error("A reviewed agent preset needs a user agent string of the reviewed grammar, a platform and a non-empty brand list.");
+      await memory.setagentpreset(preset);
+      await audit("emulation", `Stored the agent preset ${preset.name} with platform ${preset.platform} and ${preset.brands.length} brand${preset.brands.length === 1 ? "" : "s"} in the user curated library.`, {});
+      return preset;
+    }
+    case "exportpresets": {
+      const session = await memory.getsession();
+      if (!session || session.stoppedat || session.expiresat <= Date.now()) throw new Error("Preset exports stay behind the consent gate of an active session.");
+      const granted = await chrome.permissions.contains({ permissions: ["downloads"] }).catch(() => false);
+      if (!granted) throw new Error("The preset export needs the downloads capability; request it from the review panel.");
+      const file = exportpresetlibrary({ devices: await memory.getdevicepresets(), networks: await memory.getnetworkpresets(), locations: await memory.getlocationpresets(), agents: await memory.getagentpresets(), now: Date.now() });
+      const dataurl = `data:application/json;base64,${btoa(JSON.stringify(file, null, 2))}`;
+      await chrome.downloads.download({ url: dataurl, filename: `devthink-presets-${Date.now()}.json` });
+      await audit("emulation", `The review panel exported the versioned preset library of ${file.devices.length + file.networks.length + file.locations.length + file.agents.length} preset${file.devices.length + file.networks.length + file.locations.length + file.agents.length === 1 ? "" : "s"} through the reviewed download flow.`, { sessionid: session.id });
+      return { exported: file.devices.length + file.networks.length + file.locations.length + file.agents.length, version: file.version };
+    }
+    case "importpresets": {
+      const inputimport = message;
+      const library = importpresetlibrary(inputimport.file);
+      if (!library) throw new Error("The reviewed preset file carries no valid preset of any family; the import is refused.");
+      for (const preset of library.devices) await memory.setdevicepreset(preset);
+      for (const preset of library.networks) await memory.setnetworkpreset(preset);
+      for (const preset of library.locations) await memory.setlocationpreset(preset);
+      for (const preset of library.agents) await memory.setagentpreset(preset);
+      const session = await memory.getsession();
+      await audit("emulation", `Imported the reviewed preset library version ${library.version} with ${library.devices.length} device, ${library.networks.length} network, ${library.locations.length} location and ${library.agents.length} agent preset${library.devices.length + library.networks.length + library.locations.length + library.agents.length === 1 ? "" : "s"} through review.`, { ...session ? { sessionid: session.id } : {} });
+      return { imported: library.devices.length + library.networks.length + library.locations.length + library.agents.length, version: library.version };
+    }
+    case "setemulationretention": {
+      const inputretention = message;
+      const settings = await memory.getsettings();
+      const retention = typeof inputretention.retention === "number" && Number.isInteger(inputretention.retention) && inputretention.retention >= 0 ? inputretention.retention : void 0;
+      await memory.setsettings({ ...settings, ...retention !== void 0 ? { emulationretention: retention } : {} });
+      await audit("configure", `The user set the reverted emulation layer state retention to ${retention === void 0 ? "keep every prior state" : retention} layer${retention === 1 ? "" : "s"}; the layer history itself always survives.`);
+      return { emulationretention: retention };
+    }
     case "revertproxyroute": {
       const inputrevert = message;
       const plan = await memory.getplan();
@@ -12607,11 +13162,15 @@ async function handlerequest(message, sender) {
         });
         await stopprofileinstrumentsforrun(stoppedplan.id, "run cancel").catch(() => {
         });
+        await revertemulationforrun(stoppedplan.id, "run cancel").catch(() => {
+        });
       } else {
         await closechannelsforrun("none").catch(() => {
         });
         await revertcontrolsforrun("none", "run cancel").catch(() => {
         });
+        await revertemulationforrun("none", "run cancel").catch(() => {
+        });
       }
       for (const [runid, active] of [...activecdpsessions.entries()]) {
         active.cancelled = true;
@@ -12620,6 +13179,10 @@ async function handlerequest(message, sender) {
         await stopprofileinstrumentsforrun(runid, "run cancel").catch(() => {
         });
       }
+      for (const runid of [...activeemulation.keys()]) {
+        await revertemulationforrun(runid, "run cancel").catch(() => {
+        });
+      }
       for (const [id, active] of [...activerecordings.entries()]) {
         const finished = finishrecording(active.record, Date.now());
         await memory.addmedia(finished).catch(() => {
@@ -12650,6 +13213,12 @@ async function reconcilewatches() {
 }
 reconcilewatches().catch(() => {
 });
+async function restoreemulationstate() {
+  const plan = await memory.getplan();
+  if (plan) await loademulationstate(plan.id);
+}
+restoreemulationstate().catch(() => {
+});
 chrome.runtime.onConnect.addListener((port) => {
   if (port.name !== "devthinksidepanel" || port.sender?.id !== chrome.runtime.id || !port.sender.url?.startsWith(chrome.runtime.getURL(""))) return port.disconnect();
   port.onMessage.addListener((message) => {