@skrillex1224/playwright-toolkit 2.1.183 → 2.1.184

package/dist/browser.js

@@ -1317,6 +1317,636 @@ var ByPass = {
   resolveRouteByProxy
 };
 
+// src/runtime-env.js
+var BROWSER_PROFILE_SCHEMA_VERSION = 1;
+var rememberedRuntimeState = null;
+var isPlainObject = (value) => value && typeof value === "object" && !Array.isArray(value);
+var deepClone = (value) => {
+  if (value == null) return value;
+  try {
+    return JSON.parse(JSON.stringify(value));
+  } catch {
+    return value;
+  }
+};
+var tryParseJSON = (value) => {
+  if (value == null) return null;
+  if (typeof value === "object") return value;
+  const raw = String(value || "").trim();
+  if (!raw) return null;
+  try {
+    return JSON.parse(raw);
+  } catch {
+    return null;
+  }
+};
+var normalizeLocalStorage = (value) => {
+  const source = value && typeof value === "object" && !Array.isArray(value) ? value : {};
+  return Object.entries(source).reduce((acc, [key, item]) => {
+    const safeKey = String(key || "").trim();
+    const safeValue = String(item != null ? item : "").trim();
+    if (!safeKey || !safeValue || safeValue === "<nil>") return acc;
+    acc[safeKey] = safeValue;
+    return acc;
+  }, {});
+};
+var normalizeSessionStorage = (value) => {
+  const source = value && typeof value === "object" && !Array.isArray(value) ? value : {};
+  return Object.entries(source).reduce((acc, [key, item]) => {
+    const safeKey = String(key || "").trim();
+    const safeValue = String(item != null ? item : "").trim();
+    if (!safeKey || !safeValue || safeValue === "<nil>") return acc;
+    acc[safeKey] = safeValue;
+    return acc;
+  }, {});
+};
+var normalizeAuth = (value) => {
+  const source = value && typeof value === "object" && !Array.isArray(value) ? value : {};
+  return Object.entries(source).reduce((acc, [key, item]) => {
+    const safeKey = String(key || "").trim();
+    const safeValue = String(item != null ? item : "").trim();
+    if (!safeKey || !safeValue || safeValue === "<nil>") return acc;
+    acc[safeKey] = safeValue;
+    return acc;
+  }, {});
+};
+var normalizeCookies = (value) => {
+  if (!Array.isArray(value)) return [];
+  return value.map((item) => {
+    var _a;
+    const raw = item && typeof item === "object" ? item : {};
+    const name = String(raw.name || "").trim();
+    const cookieValue = String((_a = raw.value) != null ? _a : "").trim();
+    if (!name || !cookieValue || cookieValue === "<nil>") return null;
+    const domain = String(raw.domain || "").trim();
+    const path = String(raw.path || "").trim() || "/";
+    const sameSiteRaw = String(raw.sameSite || "").trim();
+    return {
+      ...raw,
+      name,
+      value: cookieValue,
+      domain,
+      path,
+      ...sameSiteRaw ? { sameSite: sameSiteRaw } : {}
+    };
+  }).filter(Boolean);
+};
+var buildCookieMap = (cookies) => cookies.reduce((acc, item) => {
+  acc[item.name] = item.value;
+  return acc;
+}, {});
+var normalizeHttpUrl = (value) => {
+  const raw = String(value || "").trim();
+  if (!raw) return "";
+  try {
+    const parsed = new URL(raw);
+    if (parsed.protocol !== "http:" && parsed.protocol !== "https:") return "";
+    parsed.hash = "";
+    return parsed.toString();
+  } catch {
+    return "";
+  }
+};
+var uniqueStrings = (value) => {
+  const list = Array.isArray(value) ? value : [];
+  const seen = /* @__PURE__ */ new Set();
+  const result = [];
+  list.forEach((item) => {
+    const normalized = String(item || "").trim();
+    if (!normalized || seen.has(normalized)) return;
+    seen.add(normalized);
+    result.push(normalized);
+  });
+  return result;
+};
+var normalizeHttpUrlList = (value) => uniqueStrings(
+  (Array.isArray(value) ? value : [value]).map((item) => normalizeHttpUrl(item)).filter(Boolean)
+);
+var normalizeCookieDomain = (value) => String(value || "").trim().replace(/^\./, "").toLowerCase();
+var normalizeCookiePath = (value) => {
+  const raw = String(value || "").trim();
+  if (!raw) return "/";
+  return raw.startsWith("/") ? raw : `/${raw}`;
+};
+var doesCookieMatchUrl = (cookie, url) => {
+  if (!cookie || !url) return false;
+  try {
+    const parsed = new URL(url);
+    const host = String(parsed.hostname || "").trim().toLowerCase();
+    const pathname = String(parsed.pathname || "/").trim() || "/";
+    const cookieDomain = normalizeCookieDomain(cookie.domain);
+    const cookiePath = normalizeCookiePath(cookie.path);
+    if (!host || !cookieDomain) return false;
+    const domainMatched = host === cookieDomain || host.endsWith(`.${cookieDomain}`);
+    if (!domainMatched) return false;
+    if (cookie.secure && parsed.protocol !== "https:") return false;
+    return pathname.startsWith(cookiePath);
+  } catch {
+    return false;
+  }
+};
+var normalizeRawSnapshot = (value = {}) => {
+  var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k;
+  const source = isPlainObject(value) ? value : {};
+  const pageUrl = normalizeHttpUrl((_a = source.page_url) != null ? _a : source.pageUrl);
+  const frameUrls = normalizeHttpUrlList((_b = source.frame_urls) != null ? _b : source.frameUrls);
+  const resourceUrls = normalizeHttpUrlList((_c = source.resource_urls) != null ? _c : source.resourceUrls);
+  const browserProfileObservedSource = (_i = (_h = (_f = (_d = source.browser_profile_observed) != null ? _d : source.browserProfileObserved) != null ? _f : (_e = source.browser_profile) == null ? void 0 : _e.observed) != null ? _h : (_g = source.browserProfile) == null ? void 0 : _g.observed) != null ? _i : source.browserProfile;
+  return {
+    page_url: pageUrl,
+    frame_urls: frameUrls,
+    resource_urls: resourceUrls,
+    cookies: Array.isArray(source.cookies) ? deepClone(source.cookies) : [],
+    local_storage: normalizeLocalStorage((_j = source.local_storage) != null ? _j : source.localStorage),
+    session_storage: normalizeSessionStorage((_k = source.session_storage) != null ? _k : source.sessionStorage),
+    browser_profile_observed: normalizeObservedBrowserProfile(browserProfileObservedSource),
+    auth: normalizeAuth(source.auth)
+  };
+};
+var collectCookieUrlsFromSnapshot = (snapshot = {}) => {
+  const normalized = normalizeRawSnapshot(snapshot);
+  return uniqueStrings([
+    normalized.page_url,
+    ...normalized.frame_urls,
+    ...normalized.resource_urls
+  ].filter(Boolean));
+};
+var filterCookiesBySnapshot = (cookies = [], snapshot = {}) => {
+  const normalizedCookies = normalizeCookies(cookies);
+  const cookieUrls = collectCookieUrlsFromSnapshot(snapshot);
+  if (cookieUrls.length === 0) {
+    return normalizedCookies;
+  }
+  return normalizedCookies.filter((cookie) => cookieUrls.some((url) => doesCookieMatchUrl(cookie, url)));
+};
+var buildEnvPayloadFromSnapshot = (snapshot = {}, options = {}) => {
+  var _a, _b, _c, _d, _e;
+  const normalized = normalizeRawSnapshot(snapshot);
+  const cookies = filterCookiesBySnapshot((snapshot == null ? void 0 : snapshot.cookies) || normalized.cookies, normalized);
+  const localStorage = normalized.local_storage;
+  const sessionStorage = normalized.session_storage;
+  const auth = normalizeAuth((_a = options.auth) != null ? _a : normalized.auth);
+  const browserProfileCore = normalizeBrowserProfileCore(
+    (_e = (_c = options.browserProfileCore) != null ? _c : (_b = snapshot == null ? void 0 : snapshot.browser_profile) == null ? void 0 : _b.core) != null ? _e : (_d = snapshot == null ? void 0 : snapshot.browserProfile) == null ? void 0 : _d.core
+  );
+  const browserProfile = buildBrowserProfilePayload(browserProfileCore, normalized.browser_profile_observed);
+  const payload = {
+    ...cookies.length > 0 ? { cookies } : {},
+    ...Object.keys(localStorage).length > 0 ? { local_storage: localStorage } : {},
+    ...Object.keys(sessionStorage).length > 0 ? { session_storage: sessionStorage } : {},
+    ...Object.keys(auth).length > 0 ? { auth } : {},
+    ...Object.keys(browserProfile).length > 0 ? { browser_profile: browserProfile } : {}
+  };
+  return Object.keys(payload).length > 0 ? payload : null;
+};
+var captureRawSnapshotFromPage = async (page) => {
+  const frameUrls = typeof (page == null ? void 0 : page.frames) === "function" ? page.frames().map((frame) => {
+    try {
+      return frame.url();
+    } catch {
+      return "";
+    }
+  }) : [];
+  const snapshot = await page.evaluate(() => {
+    const localStorage = {};
+    const sessionStorage = {};
+    const resourceUrls = [];
+    const frameUrls2 = [];
+    try {
+      for (let i = 0; i < window.localStorage.length; i += 1) {
+        const key = window.localStorage.key(i);
+        if (!key) continue;
+        const value = window.localStorage.getItem(key);
+        if (value !== null) localStorage[key] = value;
+      }
+    } catch {
+    }
+    try {
+      for (let i = 0; i < window.sessionStorage.length; i += 1) {
+        const key = window.sessionStorage.key(i);
+        if (!key) continue;
+        const value = window.sessionStorage.getItem(key);
+        if (value !== null) sessionStorage[key] = value;
+      }
+    } catch {
+    }
+    try {
+      const perfEntries = performance.getEntriesByType("resource") || [];
+      perfEntries.forEach((entry) => {
+        const name = String((entry == null ? void 0 : entry.name) || "").trim();
+        if (name) resourceUrls.push(name);
+      });
+    } catch {
+    }
+    try {
+      document.querySelectorAll("iframe,frame").forEach((node) => {
+        const src = String((node == null ? void 0 : node.src) || "").trim();
+        if (src) frameUrls2.push(src);
+      });
+    } catch {
+    }
+    const nav = window.navigator || {};
+    const screen = window.screen || {};
+    const timezone = Intl.DateTimeFormat().resolvedOptions().timeZone || "";
+    return {
+      page_url: window.location.href || "",
+      frame_urls: frameUrls2,
+      resource_urls: resourceUrls,
+      local_storage: localStorage,
+      session_storage: sessionStorage,
+      browser_profile_observed: {
+        user_agent: nav.userAgent || "",
+        platform: nav.platform || "",
+        language: nav.language || "",
+        languages: Array.isArray(nav.languages) ? nav.languages : [],
+        hardware_concurrency: Number(nav.hardwareConcurrency || 0),
+        device_memory: Number(nav.deviceMemory || 0),
+        timezone,
+        viewport: {
+          width: Number(window.innerWidth || 0),
+          height: Number(window.innerHeight || 0)
+        },
+        screen: {
+          width: Number(screen.width || 0),
+          height: Number(screen.height || 0),
+          avail_width: Number(screen.availWidth || 0),
+          avail_height: Number(screen.availHeight || 0),
+          color_depth: Number(screen.colorDepth || 0),
+          pixel_depth: Number(screen.pixelDepth || 0)
+        }
+      }
+    };
+  });
+  return normalizeRawSnapshot({
+    ...snapshot,
+    frame_urls: [...frameUrls, ...(snapshot == null ? void 0 : snapshot.frame_urls) || []]
+  });
+};
+var normalizeObservedBrowserProfile = (value) => {
+  const source = isPlainObject(value) ? value : {};
+  const profile = {};
+  const stringFields = {
+    user_agent: source.user_agent,
+    platform: source.platform,
+    language: source.language,
+    timezone: source.timezone
+  };
+  Object.entries(stringFields).forEach(([key, item]) => {
+    const safeValue = String(item || "").trim();
+    if (safeValue) {
+      profile[key] = safeValue;
+    }
+  });
+  if (Array.isArray(source.languages)) {
+    const languages = source.languages.map((item) => String(item || "").trim()).filter(Boolean);
+    if (languages.length > 0) {
+      profile.languages = languages;
+    }
+  }
+  const numericFields = {
+    hardware_concurrency: Number(source.hardware_concurrency || 0),
+    device_memory: Number(source.device_memory || 0)
+  };
+  Object.entries(numericFields).forEach(([key, item]) => {
+    if (Number.isFinite(item) && item > 0) {
+      profile[key] = item;
+    }
+  });
+  if (isPlainObject(source.viewport)) {
+    const width = Number(source.viewport.width || 0);
+    const height = Number(source.viewport.height || 0);
+    if (width > 0 && height > 0) {
+      profile.viewport = { width, height };
+    }
+  }
+  if (isPlainObject(source.screen)) {
+    const screenProfile = {};
+    const screenFields = {
+      width: Number(source.screen.width || 0),
+      height: Number(source.screen.height || 0),
+      avail_width: Number(source.screen.avail_width || 0),
+      avail_height: Number(source.screen.avail_height || 0),
+      color_depth: Number(source.screen.color_depth || 0),
+      pixel_depth: Number(source.screen.pixel_depth || 0)
+    };
+    Object.entries(screenFields).forEach(([key, item]) => {
+      if (Number.isFinite(item) && item > 0) {
+        screenProfile[key] = item;
+      }
+    });
+    if (Object.keys(screenProfile).length > 0) {
+      profile.screen = screenProfile;
+    }
+  }
+  return profile;
+};
+var normalizeBrowserProfileCore = (value) => {
+  const source = isPlainObject(value) ? value : {};
+  const profile = {};
+  if (isPlainObject(source.fingerprint) && Object.keys(source.fingerprint).length > 0) {
+    profile.fingerprint = deepClone(source.fingerprint);
+  }
+  const timezoneId = String(source.timezone_id || "").trim();
+  if (timezoneId) {
+    profile.timezone_id = timezoneId;
+  }
+  const locale = String(source.locale || "").trim();
+  if (locale) {
+    profile.locale = locale;
+  }
+  const profileKey = String(source.profile_key || "").trim();
+  if (profileKey) {
+    profile.profile_key = profileKey;
+  }
+  const browserMajorVersion = Number(source.browser_major_version || 0);
+  if (Number.isFinite(browserMajorVersion) && browserMajorVersion > 0) {
+    profile.browser_major_version = browserMajorVersion;
+  }
+  const schemaVersion = Number(source.schema_version || 0);
+  if (Number.isFinite(schemaVersion) && schemaVersion > 0) {
+    profile.schema_version = schemaVersion;
+  } else if (Object.keys(profile).length > 0) {
+    profile.schema_version = BROWSER_PROFILE_SCHEMA_VERSION;
+  }
+  return profile;
+};
+var buildBrowserProfilePayload = (core = {}, observed = {}) => {
+  const payload = {};
+  if (isPlainObject(core) && Object.keys(core).length > 0) {
+    payload.core = core;
+  }
+  if (isPlainObject(observed) && Object.keys(observed).length > 0) {
+    payload.observed = observed;
+  }
+  return payload;
+};
+var mergePlainObject = (target = {}, source = {}) => {
+  const next = isPlainObject(target) ? deepClone(target) : {};
+  if (!isPlainObject(source)) return next;
+  Object.entries(source).forEach(([key, value]) => {
+    if (!key) return;
+    if (isPlainObject(value) && isPlainObject(next[key])) {
+      next[key] = mergePlainObject(next[key], value);
+      return;
+    }
+    next[key] = deepClone(value);
+  });
+  return next;
+};
+var mergeBrowserProfilePayload = (target = {}, source = {}) => {
+  const current = isPlainObject(target) ? target : {};
+  const incoming = isPlainObject(source) ? source : {};
+  const currentCore = normalizeBrowserProfileCore(current.core);
+  const incomingCore = normalizeBrowserProfileCore(incoming.core);
+  const currentObserved = normalizeObservedBrowserProfile(current.observed);
+  const incomingObserved = normalizeObservedBrowserProfile(incoming.observed);
+  let mergedCore = currentCore;
+  if (Object.keys(mergedCore).length === 0 && Object.keys(incomingCore).length > 0) {
+    mergedCore = incomingCore;
+  } else if (Object.keys(incomingCore).length > 0) {
+    const currentVersion = Number(currentCore.browser_major_version || 0);
+    const incomingVersion = Number(incomingCore.browser_major_version || 0);
+    if (currentVersion > 0 && incomingVersion > 0 && currentVersion !== incomingVersion) {
+      mergedCore = incomingCore;
+    }
+  }
+  const mergedObserved = mergePlainObject(currentObserved, incomingObserved);
+  return buildBrowserProfilePayload(mergedCore, mergedObserved);
+};
+var mergeEnvPatchObjects = (...patches) => {
+  const merged = {};
+  patches.forEach((patch) => {
+    if (!isPlainObject(patch)) return;
+    Object.entries(patch).forEach(([key, value]) => {
+      if (!key) return;
+      if (key === "browser_profile") {
+        const browserProfile = mergeBrowserProfilePayload(merged.browser_profile, value);
+        if (Object.keys(browserProfile).length > 0) {
+          merged.browser_profile = browserProfile;
+        }
+        return;
+      }
+      if (isPlainObject(value) && isPlainObject(merged[key])) {
+        merged[key] = mergePlainObject(merged[key], value);
+        return;
+      }
+      merged[key] = deepClone(value);
+    });
+  });
+  return Object.keys(merged).length > 0 ? merged : null;
+};
+var normalizeBrowserProfile = (value) => {
+  const source = isPlainObject(value) ? value : {};
+  const coreSource = isPlainObject(source.core) ? source.core : {};
+  const observedSource = isPlainObject(source.observed) ? source.observed : {};
+  const core = normalizeBrowserProfileCore(coreSource);
+  const observed = normalizeObservedBrowserProfile(observedSource);
+  return {
+    core,
+    observed,
+    payload: buildBrowserProfilePayload(core, observed)
+  };
+};
+var rememberRuntimeState = (state) => {
+  rememberedRuntimeState = deepClone(state);
+  return rememberedRuntimeState;
+};
+var normalizeRuntimeState = (source = {}, actor = "") => {
+  if (source && typeof source === "object" && source.runtime && typeof source.runtime === "object" && !Array.isArray(source.runtime) && Object.prototype.hasOwnProperty.call(source, "browserProfileCore")) {
+    return source;
+  }
+  return RuntimeEnv.parseInput(source, actor);
+};
+var RuntimeEnv = {
+  tryParseJSON,
+  normalizeCookies,
+  normalizeLocalStorage,
+  normalizeSessionStorage,
+  normalizeAuth,
+  normalizeBrowserProfileCore,
+  normalizeObservedBrowserProfile,
+  normalizeSnapshot(snapshot = {}) {
+    return normalizeRawSnapshot(snapshot);
+  },
+  collectCookieUrls(snapshot = {}) {
+    return collectCookieUrlsFromSnapshot(snapshot);
+  },
+  buildRuntimeEnvFromSnapshot(snapshot = {}, options = {}) {
+    return buildEnvPayloadFromSnapshot(snapshot, options);
+  },
+  buildEnvPatchFromSnapshot(snapshot = {}, options = {}) {
+    return buildEnvPayloadFromSnapshot(snapshot, options);
+  },
+  mergeEnvPatches(...patches) {
+    return mergeEnvPatchObjects(...patches);
+  },
+  // parseInput 把 Actor 输入里的 runtime 字段标准化成 toolkit 内部统一结构。
+  // 后续 visitor 只和这个 state 交互，不再自己拼 token/cookie 逻辑。
+  parseInput(input = {}, actor = "") {
+    const runtime = tryParseJSON(input == null ? void 0 : input.runtime) || {};
+    const resolvedActor = String(actor || (input == null ? void 0 : input.actor) || "").trim();
+    const cookies = normalizeCookies(runtime == null ? void 0 : runtime.cookies);
+    const cookieMap = buildCookieMap(cookies);
+    const localStorage = normalizeLocalStorage(runtime == null ? void 0 : runtime.local_storage);
+    const sessionStorage = normalizeSessionStorage(runtime == null ? void 0 : runtime.session_storage);
+    const auth = normalizeAuth(runtime == null ? void 0 : runtime.auth);
+    const browserProfile = normalizeBrowserProfile(runtime == null ? void 0 : runtime.browser_profile);
+    const envId = String((input == null ? void 0 : input.env_id) || "").trim();
+    const normalizedRuntime = {
+      ...runtime,
+      ...cookies.length > 0 ? { cookies } : {},
+      ...Object.keys(localStorage).length > 0 ? { local_storage: localStorage } : {},
+      ...Object.keys(sessionStorage).length > 0 ? { session_storage: sessionStorage } : {},
+      ...Object.keys(auth).length > 0 ? { auth } : {}
+    };
+    if (Object.keys(browserProfile.payload).length > 0) {
+      normalizedRuntime.browser_profile = browserProfile.payload;
+    } else {
+      delete normalizedRuntime.browser_profile;
+    }
+    const state = {
+      actor: resolvedActor,
+      runtime: normalizedRuntime,
+      envId,
+      auth,
+      cookies,
+      cookieMap,
+      localStorage,
+      sessionStorage,
+      browserProfile: browserProfile.payload,
+      browserProfileCore: browserProfile.core,
+      browserProfileObserved: browserProfile.observed
+    };
+    rememberRuntimeState(state);
+    return state;
+  },
+  // buildEnvPatch 只构造允许回写到后端 env 的字段集合。
+  buildEnvPatch(source = {}, actor = "") {
+    const state = normalizeRuntimeState(source, actor);
+    const browserProfile = buildBrowserProfilePayload(state.browserProfileCore, state.browserProfileObserved);
+    const envPatch = {
+      ...Object.keys(state.auth || {}).length > 0 ? { auth: state.auth } : {},
+      ...Array.isArray(state.cookies) && state.cookies.length > 0 ? { cookies: state.cookies } : {},
+      ...Object.keys(state.localStorage || {}).length > 0 ? { local_storage: state.localStorage } : {},
+      ...Object.keys(state.sessionStorage || {}).length > 0 ? { session_storage: state.sessionStorage } : {},
+      ...Object.keys(browserProfile).length > 0 ? { browser_profile: browserProfile } : {}
+    };
+    return Object.keys(envPatch).length > 0 ? envPatch : null;
+  },
+  // hasLoginState 用来区分“必须鉴权的平台”和“可匿名运行的平台”。
+  hasLoginState(source = {}, actor = "") {
+    const state = normalizeRuntimeState(source, actor);
+    return Array.isArray(state.cookies) && state.cookies.length > 0 || Object.keys(state.localStorage || {}).length > 0 || Object.keys(state.sessionStorage || {}).length > 0 || Object.keys(state.auth || {}).length > 0;
+  },
+  getAuthValue(source = {}, key = "", actor = "") {
+    var _a, _b;
+    const state = normalizeRuntimeState(source, actor);
+    const safeKey = String(key || "").trim();
+    if (!safeKey) return "";
+    return String((_b = (_a = state.auth) == null ? void 0 : _a[safeKey]) != null ? _b : "").trim();
+  },
+  rememberState(source = {}) {
+    const state = normalizeRuntimeState(source);
+    rememberRuntimeState(state);
+    return RuntimeEnv.peekRememberedState();
+  },
+  peekRememberedState() {
+    return rememberedRuntimeState ? deepClone(rememberedRuntimeState) : null;
+  },
+  getBrowserProfileCore(source = {}, actor = "") {
+    const state = normalizeRuntimeState(source, actor);
+    return deepClone(state.browserProfileCore || {});
+  },
+  setBrowserProfileCore(source = {}, core = {}, actor = "") {
+    const state = normalizeRuntimeState(source, actor);
+    const normalizedCore = normalizeBrowserProfileCore(core);
+    state.browserProfileCore = normalizedCore;
+    state.browserProfile = buildBrowserProfilePayload(normalizedCore, state.browserProfileObserved);
+    if (Object.keys(state.browserProfile).length > 0) {
+      state.runtime.browser_profile = state.browserProfile;
+    } else {
+      delete state.runtime.browser_profile;
+    }
+    rememberRuntimeState(state);
+    return state;
+  },
+  // applyToPage 只负责把登录态相关字段注入页面：
+  // cookies / localStorage / sessionStorage。
+  // 指纹、时区、UA、viewport 的回放发生在 launch.js 启动阶段，不在这里做。
+  async applyToPage(page, source = {}, options = {}) {
+    if (!page) return;
+    const state = normalizeRuntimeState(source, (options == null ? void 0 : options.actor) || "");
+    const localStorage = state.localStorage || {};
+    const sessionStorage = state.sessionStorage || {};
+    const cookies = (state.cookies || []).map((cookie) => {
+      const normalized = { ...cookie };
+      if (!normalized.path) {
+        normalized.path = "/";
+      }
+      if (!normalized.domain) {
+        return null;
+      }
+      return normalized;
+    }).filter(Boolean);
+    if (cookies.length > 0) {
+      await page.context().addCookies(cookies);
+    }
+    if (Object.keys(localStorage).length > 0) {
+      await page.addInitScript((payload) => {
+        try {
+          Object.entries(payload || {}).forEach(([key, value]) => {
+            if (!key) return;
+            window.localStorage.setItem(key, String(value != null ? value : ""));
+          });
+        } catch (error) {
+        }
+      }, localStorage);
+    }
+    if (Object.keys(sessionStorage).length > 0) {
+      await page.addInitScript((payload) => {
+        try {
+          Object.entries(payload || {}).forEach(([key, value]) => {
+            if (!key) return;
+            window.sessionStorage.setItem(key, String(value != null ? value : ""));
+          });
+        } catch (error) {
+        }
+      }, sessionStorage);
+    }
+  },
+  // captureEnvPatch 在任务结束时采集最新环境快照，用于 pushSuccess / pushFailed 自动回写。
+  async captureEnvPatch(page, source = {}, options = {}) {
+    const state = normalizeRuntimeState(source, (options == null ? void 0 : options.actor) || "");
+    const baseline = RuntimeEnv.buildEnvPatch(state) || {};
+    if (!page || typeof page.evaluate !== "function" || typeof page.context !== "function") {
+      return Object.keys(baseline).length > 0 ? baseline : null;
+    }
+    try {
+      const rawSnapshot = await captureRawSnapshotFromPage(page);
+      const cookieUrls = collectCookieUrlsFromSnapshot(rawSnapshot);
+      let cookies = [];
+      try {
+        cookies = cookieUrls.length > 0 ? await page.context().cookies(cookieUrls) : await page.context().cookies();
+      } catch {
+        cookies = [];
+      }
+      const capturedPatch = RuntimeEnv.buildEnvPatchFromSnapshot(
+        {
+          ...rawSnapshot,
+          cookies
+        },
+        {
+          auth: state.auth,
+          browserProfileCore: state.browserProfileCore
+        }
+      );
+      return RuntimeEnv.mergeEnvPatches(baseline, capturedPatch);
+    } catch {
+    }
+    return Object.keys(baseline).length > 0 ? baseline : null;
+  }
+};
+
 // entrys/browser.js
 var usePlaywrightToolKit = () => {
   return {
@@ -1324,6 +1954,7 @@ var usePlaywrightToolKit = () => {
     Display,
     ByPass,
     Constants: constants_exports,
+    RuntimeEnv,
     $Internals: {
       LOG_TEMPLATES,
       stripAnsi