opensteer 0.6.12 → 0.6.13

package/dist/index.cjs

@@ -491,8 +491,10 @@ __export(index_exports, {
   getElementValue: () => getElementValue,
   getModelProvider: () => getModelProvider,
   getOrCreatePersistentProfile: () => getOrCreatePersistentProfile,
+  getOwnedRealBrowserProcessPolicy: () => getOwnedRealBrowserProcessPolicy,
   getPageHtml: () => getPageHtml,
   getPageTitle: () => getPageTitle,
+  hasActiveRuntimeProfileCreations: () => hasActiveRuntimeProfileCreations,
   importCookies: () => importCookies,
   isCloudActionMethod: () => isCloudActionMethod,
   isCloudErrorCode: () => isCloudErrorCode,
@@ -531,10 +533,7 @@ module.exports = __toCommonJS(index_exports);
 var import_crypto = require("crypto");
 
 // src/browser/pool.ts
-var import_node_child_process2 = require("child_process");
-var import_promises2 = require("fs/promises");
-var import_node_net = require("net");
-var import_playwright = require("playwright");
+var import_playwright2 = require("playwright");
 
 // src/browser/cdp-proxy.ts
 var import_ws = __toESM(require("ws"), 1);
@@ -1027,1064 +1026,2644 @@ function listLocalChromeProfiles(userDataDir = detectChromePaths().defaultUserDa
 }
 
 // src/browser/persistent-profile.ts
+var import_node_crypto3 = require("crypto");
+var import_node_child_process2 = require("child_process");
+var import_node_fs3 = require("fs");
+var import_promises4 = require("fs/promises");
+var import_node_os = require("os");
+var import_node_path4 = require("path");
+var import_node_util2 = require("util");
+
+// src/browser/persistent-profile-coordination.ts
+var import_node_path2 = require("path");
+
+// src/browser/dir-lock.ts
 var import_node_crypto = require("crypto");
-var import_node_child_process = require("child_process");
 var import_node_fs = require("fs");
-var import_promises = require("fs/promises");
-var import_node_os = require("os");
+var import_promises2 = require("fs/promises");
 var import_node_path = require("path");
+
+// src/browser/process-owner.ts
+var import_node_child_process = require("child_process");
+var import_promises = require("fs/promises");
 var import_node_util = require("util");
 var execFileAsync = (0, import_node_util.promisify)(import_node_child_process.execFile);
-var OPENSTEER_META_FILE = ".opensteer-meta.json";
-var OPENSTEER_RUNTIME_META_FILE = ".opensteer-runtime.json";
-var LOCK_OWNER_FILE = "owner.json";
-var LOCK_RECLAIMER_DIR = "reclaimer";
 var PROCESS_STARTED_AT_MS = Math.floor(Date.now() - process.uptime() * 1e3);
 var PROCESS_START_TIME_TOLERANCE_MS = 1e3;
-var PROFILE_LOCK_RETRY_DELAY_MS = 50;
+var PROCESS_LIST_MAX_BUFFER_BYTES = 16 * 1024 * 1024;
 var PS_COMMAND_ENV = { ...process.env, LC_ALL: "C" };
 var LINUX_STAT_START_TIME_FIELD_INDEX = 19;
-var CHROME_SINGLETON_ENTRIES = /* @__PURE__ */ new Set([
-  "SingletonCookie",
-  "SingletonLock",
-  "SingletonSocket",
-  "DevToolsActivePort",
-  "lockfile"
-]);
-var COPY_SKIP_ENTRIES = /* @__PURE__ */ new Set([
-  ...CHROME_SINGLETON_ENTRIES,
-  OPENSTEER_META_FILE,
-  OPENSTEER_RUNTIME_META_FILE
-]);
-var SKIPPED_ROOT_DIRECTORIES = /* @__PURE__ */ new Set([
-  "Crash Reports",
-  "Crashpad",
-  "BrowserMetrics",
-  "GrShaderCache",
-  "ShaderCache",
-  "GraphiteDawnCache",
-  "component_crx_cache",
-  "Crowd Deny",
-  "hyphen-data",
-  "OnDeviceHeadSuggestModel",
-  "OptimizationGuidePredictionModels",
-  "Segmentation Platform",
-  "SmartCardDeviceNames",
-  "WidevineCdm",
-  "pnacl"
-]);
-var CURRENT_PROCESS_LOCK_OWNER = {
+var CURRENT_PROCESS_OWNER = {
   pid: process.pid,
   processStartedAtMs: PROCESS_STARTED_AT_MS
 };
 var linuxClockTicksPerSecondPromise = null;
-async function getOrCreatePersistentProfile(sourceUserDataDir, profileDirectory, profilesRootDir = defaultPersistentProfilesRootDir()) {
-  const resolvedSourceUserDataDir = expandHome(sourceUserDataDir);
-  const targetUserDataDir = (0, import_node_path.join)(
-    expandHome(profilesRootDir),
-    buildPersistentProfileKey(resolvedSourceUserDataDir, profileDirectory)
-  );
-  const sourceProfileDir = (0, import_node_path.join)(resolvedSourceUserDataDir, profileDirectory);
-  const metadata = buildPersistentProfileMetadata(
-    resolvedSourceUserDataDir,
-    profileDirectory
-  );
-  await (0, import_promises.mkdir)((0, import_node_path.dirname)(targetUserDataDir), { recursive: true });
-  return await withPersistentProfileLock(targetUserDataDir, async () => {
-    await cleanOrphanedOwnedDirs(
-      (0, import_node_path.dirname)(targetUserDataDir),
-      buildPersistentProfileTempDirNamePrefix(targetUserDataDir)
-    );
-    if (!(0, import_node_fs.existsSync)(sourceProfileDir)) {
-      throw new Error(
-        `Chrome profile "${profileDirectory}" was not found in "${resolvedSourceUserDataDir}".`
-      );
-    }
-    const created = await createPersistentProfileClone(
-      resolvedSourceUserDataDir,
-      sourceProfileDir,
-      targetUserDataDir,
-      profileDirectory,
-      metadata
-    );
-    await ensurePersistentProfileMetadata(targetUserDataDir, metadata);
-    return {
-      created,
-      userDataDir: targetUserDataDir
-    };
-  });
-}
-async function clearPersistentProfileSingletons(userDataDir) {
-  await Promise.all(
-    [...CHROME_SINGLETON_ENTRIES].map(
-      (entry) => (0, import_promises.rm)((0, import_node_path.join)(userDataDir, entry), {
-        force: true,
-        recursive: true
-      }).catch(() => void 0)
-    )
-  );
-}
-async function createIsolatedRuntimeProfile(sourceUserDataDir, runtimesRootDir = defaultRuntimeProfilesRootDir()) {
-  const resolvedSourceUserDataDir = expandHome(sourceUserDataDir);
-  const runtimeRootDir = expandHome(runtimesRootDir);
-  await (0, import_promises.mkdir)(runtimeRootDir, { recursive: true });
-  return await withPersistentProfileLock(
-    resolvedSourceUserDataDir,
-    async () => {
-      const sourceMetadata = await readPersistentProfileMetadata(
-        resolvedSourceUserDataDir
-      );
-      await cleanOrphanedOwnedDirs(
-        runtimeRootDir,
-        buildRuntimeProfileDirNamePrefix(resolvedSourceUserDataDir)
-      );
-      const runtimeUserDataDir = await (0, import_promises.mkdtemp)(
-        buildRuntimeProfileDirPrefix(
-          runtimeRootDir,
-          resolvedSourceUserDataDir
-        )
-      );
-      try {
-        await copyUserDataDirSnapshot(
-          resolvedSourceUserDataDir,
-          runtimeUserDataDir
-        );
-        await writeRuntimeProfileMetadata(
-          runtimeUserDataDir,
-          await buildRuntimeProfileMetadata(
-            runtimeUserDataDir,
-            sourceMetadata?.profileDirectory ?? null
-          )
-        );
-        return {
-          persistentUserDataDir: resolvedSourceUserDataDir,
-          userDataDir: runtimeUserDataDir
-        };
-      } catch (error) {
-        await (0, import_promises.rm)(runtimeUserDataDir, {
-          recursive: true,
-          force: true
-        }).catch(() => void 0);
-        throw error;
-      }
-    }
-  );
-}
-async function persistIsolatedRuntimeProfile(runtimeUserDataDir, persistentUserDataDir) {
-  const resolvedRuntimeUserDataDir = expandHome(runtimeUserDataDir);
-  const resolvedPersistentUserDataDir = expandHome(persistentUserDataDir);
-  await withPersistentProfileLock(resolvedPersistentUserDataDir, async () => {
-    await (0, import_promises.mkdir)((0, import_node_path.dirname)(resolvedPersistentUserDataDir), { recursive: true });
-    await cleanOrphanedOwnedDirs(
-      (0, import_node_path.dirname)(resolvedPersistentUserDataDir),
-      buildPersistentProfileTempDirNamePrefix(resolvedPersistentUserDataDir)
-    );
-    const metadata = await requirePersistentProfileMetadata(
-      resolvedPersistentUserDataDir
-    );
-    const runtimeMetadata = await requireRuntimeProfileMetadata(
-      resolvedRuntimeUserDataDir,
-      metadata.profileDirectory
-    );
-    await mergePersistentProfileSnapshot(
-      resolvedRuntimeUserDataDir,
-      resolvedPersistentUserDataDir,
-      metadata,
-      runtimeMetadata
-    );
-  });
-  await (0, import_promises.rm)(resolvedRuntimeUserDataDir, {
-    recursive: true,
-    force: true
-  });
-}
-function buildPersistentProfileKey(sourceUserDataDir, profileDirectory) {
-  const hash = (0, import_node_crypto.createHash)("sha256").update(`${sourceUserDataDir}\0${profileDirectory}`).digest("hex").slice(0, 16);
-  const sourceLabel = sanitizePathSegment((0, import_node_path.basename)(sourceUserDataDir) || "user-data");
-  const profileLabel = sanitizePathSegment(profileDirectory || "Default");
-  return `${sourceLabel}-${profileLabel}-${hash}`;
+function parseProcessOwner(value) {
+  if (!value || typeof value !== "object") {
+    return null;
+  }
+  const parsed = value;
+  const pid = Number(parsed.pid);
+  const processStartedAtMs = Number(parsed.processStartedAtMs);
+  if (!Number.isInteger(pid) || pid <= 0) {
+    return null;
+  }
+  if (!Number.isInteger(processStartedAtMs) || processStartedAtMs <= 0) {
+    return null;
+  }
+  return {
+    pid,
+    processStartedAtMs
+  };
 }
-function defaultPersistentProfilesRootDir() {
-  return (0, import_node_path.join)((0, import_node_os.homedir)(), ".opensteer", "real-browser-profiles");
+function processOwnersEqual(left, right) {
+  if (!left || !right) {
+    return left === right;
+  }
+  return left.pid === right.pid && left.processStartedAtMs === right.processStartedAtMs;
 }
-function defaultRuntimeProfilesRootDir() {
-  return (0, import_node_path.join)((0, import_node_os.tmpdir)(), "opensteer-real-browser-runtimes");
+async function getProcessLiveness(owner) {
+  if (owner.pid === process.pid && hasMatchingProcessStartTime(
+    owner.processStartedAtMs,
+    PROCESS_STARTED_AT_MS
+  )) {
+    return "live";
+  }
+  const startedAtMs = await readProcessStartedAtMs(owner.pid);
+  if (typeof startedAtMs === "number") {
+    return hasMatchingProcessStartTime(
+      owner.processStartedAtMs,
+      startedAtMs
+    ) ? "live" : "dead";
+  }
+  return isProcessRunning(owner.pid) ? "unknown" : "dead";
 }
-function sanitizePathSegment(value) {
-  const sanitized = value.replace(/[^a-zA-Z0-9._-]+/g, "-").replace(/-+/g, "-");
-  return sanitized.replace(/^-|-$/g, "") || "profile";
+function isProcessRunning(pid) {
+  try {
+    process.kill(pid, 0);
+    return true;
+  } catch (error) {
+    const code = typeof error === "object" && error !== null && "code" in error && typeof error.code === "string" ? error.code : void 0;
+    return code !== "ESRCH";
+  }
 }
-function isProfileDirectory(userDataDir, entry) {
-  return (0, import_node_fs.existsSync)((0, import_node_path.join)(userDataDir, entry, "Preferences"));
+async function readProcessOwner(pid) {
+  const processStartedAtMs = await readProcessStartedAtMs(pid);
+  if (processStartedAtMs === null) {
+    return null;
+  }
+  return {
+    pid,
+    processStartedAtMs
+  };
 }
-async function copyUserDataDirSnapshot(sourceUserDataDir, targetUserDataDir) {
-  await (0, import_promises.cp)(sourceUserDataDir, targetUserDataDir, {
-    recursive: true,
-    filter: (candidatePath) => shouldCopyRuntimeSnapshotEntry(sourceUserDataDir, candidatePath)
-  });
+function hasMatchingProcessStartTime(expectedStartedAtMs, actualStartedAtMs) {
+  return Math.abs(expectedStartedAtMs - actualStartedAtMs) <= PROCESS_START_TIME_TOLERANCE_MS;
 }
-function shouldCopyRuntimeSnapshotEntry(userDataDir, candidatePath) {
-  const candidateRelativePath = (0, import_node_path.relative)(userDataDir, candidatePath);
-  if (!candidateRelativePath) {
-    return true;
+async function readProcessStartedAtMs(pid) {
+  if (pid <= 0) {
+    return null;
   }
-  const segments = candidateRelativePath.split(import_node_path.sep).filter(Boolean);
-  if (segments.length !== 1) {
-    return true;
+  if (process.platform === "linux") {
+    return await readLinuxProcessStartedAtMs(pid);
   }
-  return !COPY_SKIP_ENTRIES.has(segments[0]);
+  if (process.platform === "win32") {
+    return await readWindowsProcessStartedAtMs(pid);
+  }
+  return await readPsProcessStartedAtMs(pid);
 }
-async function copyRootLevelEntries(sourceUserDataDir, targetUserDataDir, targetProfileDirectory) {
-  let entries;
+async function readLinuxProcessStartedAtMs(pid) {
+  let statRaw;
   try {
-    entries = await (0, import_promises.readdir)(sourceUserDataDir);
+    statRaw = await (0, import_promises.readFile)(`/proc/${pid}/stat`, "utf8");
   } catch {
-    return;
+    return null;
   }
-  const copyTasks = [];
-  for (const entry of entries) {
-    if (COPY_SKIP_ENTRIES.has(entry)) continue;
-    if (entry === targetProfileDirectory) continue;
-    const sourcePath = (0, import_node_path.join)(sourceUserDataDir, entry);
-    const targetPath = (0, import_node_path.join)(targetUserDataDir, entry);
-    if ((0, import_node_fs.existsSync)(targetPath)) continue;
-    let entryStat;
-    try {
-      entryStat = await (0, import_promises.stat)(sourcePath);
-    } catch {
-      continue;
-    }
-    if (entryStat.isFile()) {
-      copyTasks.push((0, import_promises.copyFile)(sourcePath, targetPath).catch(() => void 0));
-    } else if (entryStat.isDirectory()) {
-      if (isProfileDirectory(sourceUserDataDir, entry)) continue;
-      if (SKIPPED_ROOT_DIRECTORIES.has(entry)) continue;
-      copyTasks.push(
-        (0, import_promises.cp)(sourcePath, targetPath, { recursive: true }).catch(
-          () => void 0
-        )
-      );
-    }
+  const startTicks = parseLinuxProcessStartTicks(statRaw);
+  if (startTicks === null) {
+    return null;
   }
-  await Promise.all(copyTasks);
-}
-async function writePersistentProfileMetadata(userDataDir, metadata) {
-  await (0, import_promises.writeFile)(
-    (0, import_node_path.join)(userDataDir, OPENSTEER_META_FILE),
-    JSON.stringify(metadata, null, 2)
+  const [bootTimeMs, clockTicksPerSecond] = await Promise.all([
+    readLinuxBootTimeMs(),
+    readLinuxClockTicksPerSecond()
+  ]);
+  if (bootTimeMs === null || clockTicksPerSecond === null) {
+    return null;
+  }
+  return Math.floor(
+    bootTimeMs + startTicks * 1e3 / clockTicksPerSecond
   );
 }
-function buildPersistentProfileMetadata(sourceUserDataDir, profileDirectory) {
-  return {
-    createdAt: (/* @__PURE__ */ new Date()).toISOString(),
-    profileDirectory,
-    source: sourceUserDataDir
-  };
-}
-async function createPersistentProfileClone(sourceUserDataDir, sourceProfileDir, targetUserDataDir, profileDirectory, metadata) {
-  if ((0, import_node_fs.existsSync)(targetUserDataDir)) {
-    return false;
+function parseLinuxProcessStartTicks(statRaw) {
+  const closingParenIndex = statRaw.lastIndexOf(")");
+  if (closingParenIndex === -1) {
+    return null;
   }
-  const tempUserDataDir = await (0, import_promises.mkdtemp)(
-    buildPersistentProfileTempDirPrefix(targetUserDataDir)
-  );
-  let published = false;
-  try {
-    await materializePersistentProfileSnapshot(
-      sourceUserDataDir,
-      sourceProfileDir,
-      tempUserDataDir,
-      profileDirectory,
-      metadata
+  const fields = statRaw.slice(closingParenIndex + 2).trim().split(/\s+/);
+  const startTicks = Number(fields[LINUX_STAT_START_TIME_FIELD_INDEX]);
+  return Number.isFinite(startTicks) && startTicks >= 0 ? startTicks : null;
+}
+async function readLinuxBootTimeMs() {
+  try {
+    const statRaw = await (0, import_promises.readFile)("/proc/stat", "utf8");
+    const bootTimeLine = statRaw.split("\n").find((line) => line.startsWith("btime "));
+    if (!bootTimeLine) {
+      return null;
+    }
+    const bootTimeSeconds = Number.parseInt(
+      bootTimeLine.slice("btime ".length),
+      10
+    );
+    return Number.isFinite(bootTimeSeconds) ? bootTimeSeconds * 1e3 : null;
+  } catch {
+    return null;
+  }
+}
+async function readLinuxClockTicksPerSecond() {
+  if (!linuxClockTicksPerSecondPromise) {
+    linuxClockTicksPerSecondPromise = execFileAsync("getconf", ["CLK_TCK"], {
+      encoding: "utf8",
+      maxBuffer: PROCESS_LIST_MAX_BUFFER_BYTES
+    }).then(({ stdout }) => {
+      const value = Number.parseInt(stdout.trim(), 10);
+      return Number.isFinite(value) && value > 0 ? value : null;
+    }).catch(() => null);
+  }
+  return await linuxClockTicksPerSecondPromise;
+}
+async function readWindowsProcessStartedAtMs(pid) {
+  try {
+    const { stdout } = await execFileAsync(
+      "powershell.exe",
+      [
+        "-NoProfile",
+        "-Command",
+        `(Get-Process -Id ${pid}).StartTime.ToUniversalTime().ToString("o")`
+      ],
+      {
+        encoding: "utf8",
+        maxBuffer: PROCESS_LIST_MAX_BUFFER_BYTES
+      }
+    );
+    const isoTimestamp = stdout.trim();
+    if (!isoTimestamp) {
+      return null;
+    }
+    const startedAtMs = Date.parse(isoTimestamp);
+    return Number.isFinite(startedAtMs) ? startedAtMs : null;
+  } catch {
+    return null;
+  }
+}
+async function readPsProcessStartedAtMs(pid) {
+  try {
+    const { stdout } = await execFileAsync(
+      "ps",
+      ["-o", "lstart=", "-p", String(pid)],
+      {
+        encoding: "utf8",
+        env: PS_COMMAND_ENV,
+        maxBuffer: PROCESS_LIST_MAX_BUFFER_BYTES
+      }
     );
+    const startedAt = stdout.trim();
+    if (!startedAt) {
+      return null;
+    }
+    const startedAtMs = Date.parse(startedAt.replace(/\s+/g, " "));
+    return Number.isFinite(startedAtMs) ? startedAtMs : null;
+  } catch {
+    return null;
+  }
+}
+
+// src/browser/dir-lock.ts
+var LOCK_OWNER_FILE = "owner.json";
+var LOCK_RECLAIMER_DIR = "reclaimer";
+var LOCK_RETRY_DELAY_MS = 50;
+async function withDirLock(lockDirPath, action) {
+  const releaseLock = await acquireDirLock(lockDirPath);
+  try {
+    return await action();
+  } finally {
+    await releaseLock();
+  }
+}
+async function acquireDirLock(lockDirPath) {
+  while (true) {
+    const releaseLock = await tryAcquireDirLock(lockDirPath);
+    if (releaseLock) {
+      return releaseLock;
+    }
+    await sleep(LOCK_RETRY_DELAY_MS);
+  }
+}
+async function tryAcquireDirLock(lockDirPath) {
+  await (0, import_promises2.mkdir)((0, import_node_path.dirname)(lockDirPath), { recursive: true });
+  while (true) {
+    const tempLockDirPath = `${lockDirPath}-${process.pid}-${CURRENT_PROCESS_OWNER.processStartedAtMs}-${(0, import_node_crypto.randomUUID)()}`;
+    try {
+      await (0, import_promises2.mkdir)(tempLockDirPath);
+      await writeLockOwner(tempLockDirPath, CURRENT_PROCESS_OWNER);
+      try {
+        await (0, import_promises2.rename)(tempLockDirPath, lockDirPath);
+        break;
+      } catch (error) {
+        if (!wasDirPublishedByAnotherProcess(error, lockDirPath)) {
+          throw error;
+        }
+      }
+    } finally {
+      await (0, import_promises2.rm)(tempLockDirPath, {
+        recursive: true,
+        force: true
+      }).catch(() => void 0);
+    }
+    const owner = await readLockOwner(lockDirPath);
+    if ((!owner || await getProcessLiveness(owner) === "dead") && await tryReclaimStaleLock(lockDirPath, owner)) {
+      continue;
+    }
+    return null;
+  }
+  return async () => {
+    await (0, import_promises2.rm)(lockDirPath, {
+      recursive: true,
+      force: true
+    }).catch(() => void 0);
+  };
+}
+async function isDirLockHeld(lockDirPath) {
+  if (!(0, import_node_fs.existsSync)(lockDirPath)) {
+    return false;
+  }
+  const owner = await readLockOwner(lockDirPath);
+  if ((!owner || await getProcessLiveness(owner) === "dead") && await tryReclaimStaleLock(lockDirPath, owner)) {
+    return false;
+  }
+  return (0, import_node_fs.existsSync)(lockDirPath);
+}
+function getErrorCode(error) {
+  return typeof error === "object" && error !== null && "code" in error && typeof error.code === "string" ? error.code : void 0;
+}
+function wasDirPublishedByAnotherProcess(error, targetDirPath) {
+  const code = getErrorCode(error);
+  return (0, import_node_fs.existsSync)(targetDirPath) && (code === "EEXIST" || code === "ENOTEMPTY" || code === "EPERM");
+}
+async function writeLockOwner(lockDirPath, owner) {
+  await (0, import_promises2.writeFile)((0, import_node_path.join)(lockDirPath, LOCK_OWNER_FILE), JSON.stringify(owner));
+}
+async function readLockOwner(lockDirPath) {
+  return await readLockParticipant((0, import_node_path.join)(lockDirPath, LOCK_OWNER_FILE));
+}
+async function readLockParticipant(filePath) {
+  return (await readLockParticipantRecord(filePath)).owner;
+}
+async function readLockParticipantRecord(filePath) {
+  try {
+    const raw = await (0, import_promises2.readFile)(filePath, "utf8");
+    const owner = parseProcessOwner(JSON.parse(raw));
+    return {
+      exists: true,
+      owner
+    };
+  } catch (error) {
+    return {
+      exists: getErrorCode(error) !== "ENOENT",
+      owner: null
+    };
+  }
+}
+async function readLockReclaimerRecord(lockDirPath) {
+  return await readLockParticipantRecord(
+    (0, import_node_path.join)(buildLockReclaimerDirPath(lockDirPath), LOCK_OWNER_FILE)
+  );
+}
+async function tryReclaimStaleLock(lockDirPath, expectedOwner) {
+  if (!await tryAcquireLockReclaimer(lockDirPath)) {
+    return false;
+  }
+  let reclaimed = false;
+  try {
+    const owner = await readLockOwner(lockDirPath);
+    if (!processOwnersEqual(owner, expectedOwner)) {
+      return false;
+    }
+    if (owner && await getProcessLiveness(owner) !== "dead") {
+      return false;
+    }
+    await (0, import_promises2.rm)(lockDirPath, {
+      recursive: true,
+      force: true
+    }).catch(() => void 0);
+    reclaimed = !(0, import_node_fs.existsSync)(lockDirPath);
+    return reclaimed;
+  } finally {
+    if (!reclaimed) {
+      await (0, import_promises2.rm)(buildLockReclaimerDirPath(lockDirPath), {
+        recursive: true,
+        force: true
+      }).catch(() => void 0);
+    }
+  }
+}
+async function tryAcquireLockReclaimer(lockDirPath) {
+  const reclaimerDirPath = buildLockReclaimerDirPath(lockDirPath);
+  while (true) {
+    const tempReclaimerDirPath = `${reclaimerDirPath}-${process.pid}-${CURRENT_PROCESS_OWNER.processStartedAtMs}-${(0, import_node_crypto.randomUUID)()}`;
     try {
-      await (0, import_promises.rename)(tempUserDataDir, targetUserDataDir);
+      await (0, import_promises2.mkdir)(tempReclaimerDirPath);
+      await writeLockOwner(tempReclaimerDirPath, CURRENT_PROCESS_OWNER);
+      try {
+        await (0, import_promises2.rename)(tempReclaimerDirPath, reclaimerDirPath);
+        return true;
+      } catch (error) {
+        if (getErrorCode(error) === "ENOENT") {
+          return false;
+        }
+        if (!wasDirPublishedByAnotherProcess(error, reclaimerDirPath)) {
+          throw error;
+        }
+      }
     } catch (error) {
-      if (wasDirPublishedByAnotherProcess(error, targetUserDataDir)) {
+      const code = getErrorCode(error);
+      if (code === "ENOENT") {
         return false;
       }
       throw error;
-    }
-    published = true;
-    return true;
-  } finally {
-    if (!published) {
-      await (0, import_promises.rm)(tempUserDataDir, {
+    } finally {
+      await (0, import_promises2.rm)(tempReclaimerDirPath, {
         recursive: true,
         force: true
       }).catch(() => void 0);
     }
+    const reclaimerRecord = await readLockReclaimerRecord(lockDirPath);
+    if (!reclaimerRecord.exists || !reclaimerRecord.owner) {
+      return false;
+    }
+    if (await getProcessLiveness(reclaimerRecord.owner) !== "dead") {
+      return false;
+    }
+    await (0, import_promises2.rm)(reclaimerDirPath, {
+      recursive: true,
+      force: true
+    }).catch(() => void 0);
   }
 }
-async function materializePersistentProfileSnapshot(sourceUserDataDir, sourceProfileDir, targetUserDataDir, profileDirectory, metadata) {
-  if (!(0, import_node_fs.existsSync)(sourceProfileDir)) {
-    throw new Error(
-      `Chrome profile "${profileDirectory}" was not found in "${sourceUserDataDir}".`
-    );
+function buildLockReclaimerDirPath(lockDirPath) {
+  return (0, import_node_path.join)(lockDirPath, LOCK_RECLAIMER_DIR);
+}
+async function sleep(ms) {
+  await new Promise((resolve) => setTimeout(resolve, ms));
+}
+
+// src/browser/persistent-profile-coordination.ts
+var PERSISTENT_PROFILE_LOCK_RETRY_DELAY_MS = 50;
+async function withPersistentProfileControlLock(targetUserDataDir, action) {
+  return await withDirLock(
+    buildPersistentProfileControlLockDirPath(targetUserDataDir),
+    action
+  );
+}
+async function acquirePersistentProfileWriteLock(targetUserDataDir) {
+  const controlLockDirPath = buildPersistentProfileControlLockDirPath(targetUserDataDir);
+  const writeLockDirPath = buildPersistentProfileWriteLockDirPath(
+    targetUserDataDir
+  );
+  while (true) {
+    let releaseWriteLock = null;
+    const releaseControlLock = await acquireDirLock(controlLockDirPath);
+    try {
+      releaseWriteLock = await tryAcquireDirLock(writeLockDirPath);
+    } finally {
+      await releaseControlLock();
+    }
+    if (releaseWriteLock) {
+      return releaseWriteLock;
+    }
+    await sleep2(PERSISTENT_PROFILE_LOCK_RETRY_DELAY_MS);
   }
-  await (0, import_promises.cp)(sourceProfileDir, (0, import_node_path.join)(targetUserDataDir, profileDirectory), {
-    recursive: true
-  });
-  await copyRootLevelEntries(sourceUserDataDir, targetUserDataDir, profileDirectory);
-  await writePersistentProfileMetadata(targetUserDataDir, metadata);
 }
-async function mergePersistentProfileSnapshot(runtimeUserDataDir, persistentUserDataDir, metadata, runtimeMetadata) {
-  const tempUserDataDir = await (0, import_promises.mkdtemp)(
-    buildPersistentProfileTempDirPrefix(persistentUserDataDir)
+async function isPersistentProfileWriteLocked(targetUserDataDir) {
+  return await isDirLockHeld(
+    buildPersistentProfileWriteLockDirPath(targetUserDataDir)
   );
-  let published = false;
+}
+function buildPersistentProfileWriteLockDirPath(targetUserDataDir) {
+  return (0, import_node_path2.join)((0, import_node_path2.dirname)(targetUserDataDir), `${(0, import_node_path2.basename)(targetUserDataDir)}.lock`);
+}
+function buildPersistentProfileControlLockDirPath(targetUserDataDir) {
+  return (0, import_node_path2.join)(
+    (0, import_node_path2.dirname)(targetUserDataDir),
+    `${(0, import_node_path2.basename)(targetUserDataDir)}.control.lock`
+  );
+}
+async function sleep2(ms) {
+  await new Promise((resolve) => setTimeout(resolve, ms));
+}
+
+// src/browser/shared-real-browser-session-state.ts
+var import_node_crypto2 = require("crypto");
+var import_node_fs2 = require("fs");
+var import_promises3 = require("fs/promises");
+var import_node_path3 = require("path");
+var SHARED_SESSION_METADATA_FILE = "session.json";
+var SHARED_SESSION_CLIENTS_DIR = "clients";
+var SHARED_SESSION_RETRY_DELAY_MS = 50;
+var SHARED_SESSION_METADATA_TEMP_FILE_PREFIX = `${SHARED_SESSION_METADATA_FILE}.`;
+var SHARED_SESSION_METADATA_TEMP_FILE_SUFFIX = ".tmp";
+function buildSharedSessionDirPath(persistentUserDataDir) {
+  return (0, import_node_path3.join)(
+    (0, import_node_path3.dirname)(persistentUserDataDir),
+    `${(0, import_node_path3.basename)(persistentUserDataDir)}.session`
+  );
+}
+function buildSharedSessionLockPath(persistentUserDataDir) {
+  return `${buildSharedSessionDirPath(persistentUserDataDir)}.lock`;
+}
+function buildSharedSessionClientsDirPath(persistentUserDataDir) {
+  return (0, import_node_path3.join)(
+    buildSharedSessionDirPath(persistentUserDataDir),
+    SHARED_SESSION_CLIENTS_DIR
+  );
+}
+function buildSharedSessionClientPath(persistentUserDataDir, clientId) {
+  return (0, import_node_path3.join)(
+    buildSharedSessionClientsDirPath(persistentUserDataDir),
+    `${clientId}.json`
+  );
+}
+async function readSharedSessionMetadata(persistentUserDataDir) {
+  return (await readSharedSessionMetadataRecord(persistentUserDataDir)).metadata;
+}
+async function writeSharedSessionMetadata(persistentUserDataDir, metadata) {
+  const sessionDirPath = buildSharedSessionDirPath(persistentUserDataDir);
+  const metadataPath = buildSharedSessionMetadataPath(persistentUserDataDir);
+  const tempPath = buildSharedSessionMetadataTempPath(sessionDirPath);
+  await (0, import_promises3.mkdir)(sessionDirPath, { recursive: true });
   try {
-    const baseEntries = deserializeSnapshotManifestEntries(
-      runtimeMetadata.baseEntries
-    );
-    const currentEntries = await collectPersistentSnapshotEntries(
-      persistentUserDataDir,
-      metadata.profileDirectory
-    );
-    const runtimeEntries = await collectPersistentSnapshotEntries(
-      runtimeUserDataDir,
-      metadata.profileDirectory
-    );
-    const mergedEntries = resolveMergedSnapshotEntries(
-      baseEntries,
-      currentEntries,
-      runtimeEntries
-    );
-    await materializeMergedPersistentProfileSnapshot(
-      tempUserDataDir,
-      currentEntries,
-      runtimeEntries,
-      mergedEntries
-    );
-    await writePersistentProfileMetadata(tempUserDataDir, metadata);
-    await replaceProfileDirectory(persistentUserDataDir, tempUserDataDir);
-    published = true;
+    await (0, import_promises3.writeFile)(tempPath, JSON.stringify(metadata, null, 2));
+    await (0, import_promises3.rename)(tempPath, metadataPath);
+  } finally {
+    await (0, import_promises3.rm)(tempPath, { force: true }).catch(() => void 0);
+  }
+}
+async function hasLiveSharedRealBrowserSession(persistentUserDataDir) {
+  const sessionDirPath = buildSharedSessionDirPath(persistentUserDataDir);
+  const metadataRecord = await readSharedSessionMetadataRecord(
+    persistentUserDataDir
+  );
+  if (!metadataRecord.exists) {
+    return await hasLiveSharedSessionPublisherOrClients(sessionDirPath);
+  }
+  if (!metadataRecord.metadata) {
+    return true;
+  }
+  if (await getProcessLiveness(metadataRecord.metadata.browserOwner) === "dead") {
+    await (0, import_promises3.rm)(sessionDirPath, {
+      force: true,
+      recursive: true
+    }).catch(() => void 0);
+    return false;
+  }
+  return true;
+}
+async function waitForSharedRealBrowserSessionToDrain(persistentUserDataDir) {
+  while (true) {
+    if (!await hasLiveSharedRealBrowserSession(persistentUserDataDir)) {
+      return;
+    }
+    await sleep3(SHARED_SESSION_RETRY_DELAY_MS);
+  }
+}
+async function readSharedSessionMetadataRecord(persistentUserDataDir) {
+  try {
+    const raw = await (0, import_promises3.readFile)(
+      buildSharedSessionMetadataPath(persistentUserDataDir),
+      "utf8"
+    );
+    return {
+      exists: true,
+      metadata: parseSharedSessionMetadata(JSON.parse(raw))
+    };
+  } catch (error) {
+    return {
+      exists: getErrorCode2(error) !== "ENOENT",
+      metadata: null
+    };
+  }
+}
+async function hasLiveSharedSessionPublisherOrClients(sessionDirPath) {
+  if (!(0, import_node_fs2.existsSync)(sessionDirPath)) {
+    return false;
+  }
+  let entries;
+  try {
+    entries = await readDirNames(sessionDirPath);
+  } catch (error) {
+    return getErrorCode2(error) !== "ENOENT";
+  }
+  let hasUnknownEntries = false;
+  for (const entry of entries) {
+    if (entry === SHARED_SESSION_METADATA_FILE) {
+      return true;
+    }
+    if (entry === SHARED_SESSION_CLIENTS_DIR) {
+      if (await hasDirectoryEntries((0, import_node_path3.join)(sessionDirPath, entry))) {
+        return true;
+      }
+      continue;
+    }
+    const owner = parseSharedSessionMetadataTempOwner(entry);
+    if (!owner) {
+      if (isSharedSessionMetadataTempFile(entry)) {
+        continue;
+      }
+      hasUnknownEntries = true;
+      continue;
+    }
+    if (await getProcessLiveness(owner) !== "dead") {
+      return true;
+    }
+  }
+  if (hasUnknownEntries) {
+    return true;
+  }
+  await (0, import_promises3.rm)(sessionDirPath, {
+    force: true,
+    recursive: true
+  }).catch(() => void 0);
+  return false;
+}
+function buildSharedSessionMetadataPath(persistentUserDataDir) {
+  return (0, import_node_path3.join)(
+    buildSharedSessionDirPath(persistentUserDataDir),
+    SHARED_SESSION_METADATA_FILE
+  );
+}
+function buildSharedSessionMetadataTempPath(sessionDirPath) {
+  return (0, import_node_path3.join)(
+    sessionDirPath,
+    [
+      SHARED_SESSION_METADATA_FILE,
+      CURRENT_PROCESS_OWNER.pid,
+      CURRENT_PROCESS_OWNER.processStartedAtMs,
+      (0, import_node_crypto2.randomUUID)(),
+      "tmp"
+    ].join(".")
+  );
+}
+function parseSharedSessionMetadata(value) {
+  if (!value || typeof value !== "object") {
+    return null;
+  }
+  const parsed = value;
+  const browserOwner = parseProcessOwner(parsed.browserOwner);
+  const stateOwner = parseProcessOwner(parsed.stateOwner);
+  const state = parsed.state === "launching" || parsed.state === "ready" || parsed.state === "closing" ? parsed.state : null;
+  if (!browserOwner || !stateOwner || typeof parsed.createdAt !== "string" || typeof parsed.debugPort !== "number" || typeof parsed.executablePath !== "string" || typeof parsed.headless !== "boolean" || typeof parsed.persistentUserDataDir !== "string" || typeof parsed.profileDirectory !== "string" || typeof parsed.sessionId !== "string" || !state) {
+    return null;
+  }
+  return {
+    browserOwner,
+    createdAt: parsed.createdAt,
+    debugPort: parsed.debugPort,
+    executablePath: parsed.executablePath,
+    headless: parsed.headless,
+    persistentUserDataDir: parsed.persistentUserDataDir,
+    profileDirectory: parsed.profileDirectory,
+    sessionId: parsed.sessionId,
+    state,
+    stateOwner
+  };
+}
+function parseSharedSessionMetadataTempOwner(entryName) {
+  if (!isSharedSessionMetadataTempFile(entryName)) {
+    return null;
+  }
+  const segments = entryName.split(".");
+  if (segments.length < 5) {
+    return null;
+  }
+  return parseProcessOwner({
+    pid: Number.parseInt(segments[2] ?? "", 10),
+    processStartedAtMs: Number.parseInt(segments[3] ?? "", 10)
+  });
+}
+function isSharedSessionMetadataTempFile(entryName) {
+  return entryName.startsWith(SHARED_SESSION_METADATA_TEMP_FILE_PREFIX) && entryName.endsWith(SHARED_SESSION_METADATA_TEMP_FILE_SUFFIX);
+}
+function getErrorCode2(error) {
+  return typeof error === "object" && error !== null && "code" in error && typeof error.code === "string" ? error.code : void 0;
+}
+async function hasDirectoryEntries(dirPath) {
+  try {
+    return (await readDirNames(dirPath)).length > 0;
+  } catch (error) {
+    return getErrorCode2(error) !== "ENOENT";
+  }
+}
+async function readDirNames(dirPath) {
+  return await (0, import_promises3.readdir)(dirPath, { encoding: "utf8" });
+}
+async function sleep3(ms) {
+  await new Promise((resolve) => setTimeout(resolve, ms));
+}
+
+// src/browser/persistent-profile.ts
+var execFileAsync2 = (0, import_node_util2.promisify)(import_node_child_process2.execFile);
+var OPENSTEER_META_FILE = ".opensteer-meta.json";
+var OPENSTEER_RUNTIME_META_FILE = ".opensteer-runtime.json";
+var OPENSTEER_RUNTIME_CREATING_FILE = ".opensteer-runtime-creating.json";
+var PROCESS_LIST_MAX_BUFFER_BYTES2 = 16 * 1024 * 1024;
+var PS_COMMAND_ENV2 = { ...process.env, LC_ALL: "C" };
+var CHROME_SINGLETON_ENTRIES = /* @__PURE__ */ new Set([
+  "SingletonCookie",
+  "SingletonLock",
+  "SingletonSocket",
+  "DevToolsActivePort",
+  "lockfile"
+]);
+var COPY_SKIP_ENTRIES = /* @__PURE__ */ new Set([
+  ...CHROME_SINGLETON_ENTRIES,
+  OPENSTEER_META_FILE,
+  OPENSTEER_RUNTIME_META_FILE,
+  OPENSTEER_RUNTIME_CREATING_FILE
+]);
+var SKIPPED_ROOT_DIRECTORIES = /* @__PURE__ */ new Set([
+  "Crash Reports",
+  "Crashpad",
+  "BrowserMetrics",
+  "GrShaderCache",
+  "ShaderCache",
+  "GraphiteDawnCache",
+  "component_crx_cache",
+  "Crowd Deny",
+  "hyphen-data",
+  "OnDeviceHeadSuggestModel",
+  "OptimizationGuidePredictionModels",
+  "Segmentation Platform",
+  "SmartCardDeviceNames",
+  "WidevineCdm",
+  "pnacl"
+]);
+async function getOrCreatePersistentProfile(sourceUserDataDir, profileDirectory, profilesRootDir = defaultPersistentProfilesRootDir()) {
+  const resolvedSourceUserDataDir = expandHome(sourceUserDataDir);
+  const targetUserDataDir = (0, import_node_path4.join)(
+    expandHome(profilesRootDir),
+    buildPersistentProfileKey(resolvedSourceUserDataDir, profileDirectory)
+  );
+  const sourceProfileDir = (0, import_node_path4.join)(resolvedSourceUserDataDir, profileDirectory);
+  const metadata = buildPersistentProfileMetadata(
+    resolvedSourceUserDataDir,
+    profileDirectory
+  );
+  await (0, import_promises4.mkdir)((0, import_node_path4.dirname)(targetUserDataDir), { recursive: true });
+  if (await isHealthyPersistentProfile(
+    targetUserDataDir,
+    resolvedSourceUserDataDir,
+    profileDirectory
+  ) && !await isPersistentProfileWriteLocked(targetUserDataDir)) {
+    return {
+      created: false,
+      userDataDir: targetUserDataDir
+    };
+  }
+  return await withPersistentProfileWriteAccess(targetUserDataDir, async () => {
+    await recoverPersistentProfileBackup(targetUserDataDir);
+    await cleanOrphanedOwnedDirs(
+      (0, import_node_path4.dirname)(targetUserDataDir),
+      buildPersistentProfileTempDirNamePrefix(targetUserDataDir)
+    );
+    if (!(0, import_node_fs3.existsSync)(sourceProfileDir)) {
+      throw new Error(
+        `Chrome profile "${profileDirectory}" was not found in "${resolvedSourceUserDataDir}".`
+      );
+    }
+    const created = await createPersistentProfileClone(
+      resolvedSourceUserDataDir,
+      sourceProfileDir,
+      targetUserDataDir,
+      profileDirectory,
+      metadata
+    );
+    await ensurePersistentProfileMetadata(targetUserDataDir, metadata);
+    return {
+      created,
+      userDataDir: targetUserDataDir
+    };
+  });
+}
+async function clearPersistentProfileSingletons(userDataDir) {
+  await Promise.all(
+    [...CHROME_SINGLETON_ENTRIES].map(
+      (entry) => (0, import_promises4.rm)((0, import_node_path4.join)(userDataDir, entry), {
+        force: true,
+        recursive: true
+      }).catch(() => void 0)
+    )
+  );
+}
+async function createIsolatedRuntimeProfile(sourceUserDataDir, runtimesRootDir = defaultRuntimeProfilesRootDir()) {
+  const resolvedSourceUserDataDir = expandHome(sourceUserDataDir);
+  const runtimeRootDir = expandHome(runtimesRootDir);
+  await (0, import_promises4.mkdir)(runtimeRootDir, { recursive: true });
+  const sourceMetadata = await requirePersistentProfileMetadata(
+    resolvedSourceUserDataDir
+  );
+  const runtimeProfile = await reserveRuntimeProfileCreation(
+    resolvedSourceUserDataDir,
+    runtimeRootDir,
+    sourceMetadata.profileDirectory
+  );
+  try {
+    await cleanOrphanedRuntimeProfileDirs(
+      runtimeRootDir,
+      buildRuntimeProfileDirNamePrefix(resolvedSourceUserDataDir)
+    );
+    await copyUserDataDirSnapshot(
+      resolvedSourceUserDataDir,
+      runtimeProfile.userDataDir
+    );
+    const currentSourceMetadata = await readPersistentProfileMetadata(
+      resolvedSourceUserDataDir
+    );
+    await writeRuntimeProfileMetadata(
+      runtimeProfile.userDataDir,
+      await buildRuntimeProfileMetadata(
+        runtimeProfile.userDataDir,
+        resolvedSourceUserDataDir,
+        currentSourceMetadata?.profileDirectory ?? sourceMetadata.profileDirectory
+      )
+    );
+    await clearRuntimeProfileCreationState(
+      runtimeProfile.userDataDir,
+      resolvedSourceUserDataDir
+    );
+    return {
+      persistentUserDataDir: resolvedSourceUserDataDir,
+      userDataDir: runtimeProfile.userDataDir
+    };
+  } catch (error) {
+    await clearRuntimeProfileCreationState(
+      runtimeProfile.userDataDir,
+      resolvedSourceUserDataDir
+    );
+    await (0, import_promises4.rm)(runtimeProfile.userDataDir, {
+      recursive: true,
+      force: true
+    }).catch(() => void 0);
+    throw error;
+  }
+}
+async function persistIsolatedRuntimeProfile(runtimeUserDataDir, persistentUserDataDir) {
+  const resolvedRuntimeUserDataDir = expandHome(runtimeUserDataDir);
+  const resolvedPersistentUserDataDir = expandHome(persistentUserDataDir);
+  let claimedRuntimeUserDataDir = null;
+  try {
+    await withPersistentProfileWriteAccess(
+      resolvedPersistentUserDataDir,
+      async () => {
+        await (0, import_promises4.mkdir)((0, import_node_path4.dirname)(resolvedPersistentUserDataDir), {
+          recursive: true
+        });
+        await recoverPersistentProfileBackup(resolvedPersistentUserDataDir);
+        await cleanOrphanedOwnedDirs(
+          (0, import_node_path4.dirname)(resolvedPersistentUserDataDir),
+          buildPersistentProfileTempDirNamePrefix(
+            resolvedPersistentUserDataDir
+          )
+        );
+        const metadata = await requirePersistentProfileMetadata(
+          resolvedPersistentUserDataDir
+        );
+        claimedRuntimeUserDataDir = await claimRuntimeProfileForPersist(
+          resolvedRuntimeUserDataDir
+        );
+        const runtimeMetadata = await requireRuntimeProfileMetadata(
+          claimedRuntimeUserDataDir,
+          resolvedPersistentUserDataDir,
+          metadata.profileDirectory,
+          resolvedRuntimeUserDataDir
+        );
+        await mergePersistentProfileSnapshot(
+          claimedRuntimeUserDataDir,
+          resolvedPersistentUserDataDir,
+          metadata,
+          runtimeMetadata
+        );
+      }
+    );
+  } catch (error) {
+    if (claimedRuntimeUserDataDir) {
+      try {
+        await restoreClaimedRuntimeProfile(
+          claimedRuntimeUserDataDir,
+          resolvedRuntimeUserDataDir
+        );
+      } catch (restoreError) {
+        throw new AggregateError(
+          [error, restoreError],
+          `Failed to restore runtime profile "${resolvedRuntimeUserDataDir}" after persistence failed.`
+        );
+      }
+    }
+    throw error;
+  }
+  if (claimedRuntimeUserDataDir) {
+    await (0, import_promises4.rm)(claimedRuntimeUserDataDir, {
+      recursive: true,
+      force: true
+    }).catch(() => void 0);
+  }
+}
+function buildPersistentProfileKey(sourceUserDataDir, profileDirectory) {
+  const hash = (0, import_node_crypto3.createHash)("sha256").update(`${sourceUserDataDir}\0${profileDirectory}`).digest("hex").slice(0, 16);
+  const sourceLabel = sanitizePathSegment((0, import_node_path4.basename)(sourceUserDataDir) || "user-data");
+  const profileLabel = sanitizePathSegment(profileDirectory || "Default");
+  return `${sourceLabel}-${profileLabel}-${hash}`;
+}
+function defaultPersistentProfilesRootDir() {
+  return (0, import_node_path4.join)((0, import_node_os.homedir)(), ".opensteer", "real-browser-profiles");
+}
+function defaultRuntimeProfilesRootDir() {
+  return (0, import_node_path4.join)((0, import_node_os.tmpdir)(), "opensteer-real-browser-runtimes");
+}
+function sanitizePathSegment(value) {
+  const sanitized = value.replace(/[^a-zA-Z0-9._-]+/g, "-").replace(/-+/g, "-");
+  return sanitized.replace(/^-|-$/g, "") || "profile";
+}
+function isProfileDirectory(userDataDir, entry) {
+  return (0, import_node_fs3.existsSync)((0, import_node_path4.join)(userDataDir, entry, "Preferences"));
+}
+async function copyUserDataDirSnapshot(sourceUserDataDir, targetUserDataDir) {
+  await (0, import_promises4.cp)(sourceUserDataDir, targetUserDataDir, {
+    recursive: true,
+    filter: (candidatePath) => shouldCopyRuntimeSnapshotEntry(sourceUserDataDir, candidatePath)
+  });
+}
+function shouldCopyRuntimeSnapshotEntry(userDataDir, candidatePath) {
+  const candidateRelativePath = (0, import_node_path4.relative)(userDataDir, candidatePath);
+  if (!candidateRelativePath) {
+    return true;
+  }
+  const segments = candidateRelativePath.split(import_node_path4.sep).filter(Boolean);
+  if (segments.length !== 1) {
+    return true;
+  }
+  return !COPY_SKIP_ENTRIES.has(segments[0]);
+}
+async function copyRootLevelEntries(sourceUserDataDir, targetUserDataDir, targetProfileDirectory) {
+  let entries;
+  try {
+    entries = await (0, import_promises4.readdir)(sourceUserDataDir);
+  } catch {
+    return;
+  }
+  const copyTasks = [];
+  for (const entry of entries) {
+    if (COPY_SKIP_ENTRIES.has(entry)) continue;
+    if (entry === targetProfileDirectory) continue;
+    const sourcePath = (0, import_node_path4.join)(sourceUserDataDir, entry);
+    const targetPath = (0, import_node_path4.join)(targetUserDataDir, entry);
+    if ((0, import_node_fs3.existsSync)(targetPath)) continue;
+    let entryStat;
+    try {
+      entryStat = await (0, import_promises4.stat)(sourcePath);
+    } catch {
+      continue;
+    }
+    if (entryStat.isFile()) {
+      copyTasks.push((0, import_promises4.copyFile)(sourcePath, targetPath).catch(() => void 0));
+    } else if (entryStat.isDirectory()) {
+      if (isProfileDirectory(sourceUserDataDir, entry)) continue;
+      if (SKIPPED_ROOT_DIRECTORIES.has(entry)) continue;
+      copyTasks.push(
+        (0, import_promises4.cp)(sourcePath, targetPath, { recursive: true }).catch(
+          () => void 0
+        )
+      );
+    }
+  }
+  await Promise.all(copyTasks);
+}
+async function writePersistentProfileMetadata(userDataDir, metadata) {
+  await (0, import_promises4.writeFile)(
+    (0, import_node_path4.join)(userDataDir, OPENSTEER_META_FILE),
+    JSON.stringify(metadata, null, 2)
+  );
+}
+function buildPersistentProfileMetadata(sourceUserDataDir, profileDirectory) {
+  return {
+    createdAt: (/* @__PURE__ */ new Date()).toISOString(),
+    profileDirectory,
+    source: sourceUserDataDir
+  };
+}
+async function createPersistentProfileClone(sourceUserDataDir, sourceProfileDir, targetUserDataDir, profileDirectory, metadata) {
+  if ((0, import_node_fs3.existsSync)(targetUserDataDir)) {
+    return false;
+  }
+  const tempUserDataDir = await (0, import_promises4.mkdtemp)(
+    buildPersistentProfileTempDirPrefix(targetUserDataDir)
+  );
+  let published = false;
+  try {
+    await materializePersistentProfileSnapshot(
+      sourceUserDataDir,
+      sourceProfileDir,
+      tempUserDataDir,
+      profileDirectory,
+      metadata
+    );
+    try {
+      await (0, import_promises4.rename)(tempUserDataDir, targetUserDataDir);
+    } catch (error) {
+      if (wasDirPublishedByAnotherProcess2(error, targetUserDataDir)) {
+        return false;
+      }
+      throw error;
+    }
+    published = true;
+    return true;
+  } finally {
+    if (!published) {
+      await (0, import_promises4.rm)(tempUserDataDir, {
+        recursive: true,
+        force: true
+      }).catch(() => void 0);
+    }
+  }
+}
+async function materializePersistentProfileSnapshot(sourceUserDataDir, sourceProfileDir, targetUserDataDir, profileDirectory, metadata) {
+  if (!(0, import_node_fs3.existsSync)(sourceProfileDir)) {
+    throw new Error(
+      `Chrome profile "${profileDirectory}" was not found in "${sourceUserDataDir}".`
+    );
+  }
+  await (0, import_promises4.cp)(sourceProfileDir, (0, import_node_path4.join)(targetUserDataDir, profileDirectory), {
+    recursive: true
+  });
+  await copyRootLevelEntries(sourceUserDataDir, targetUserDataDir, profileDirectory);
+  await writePersistentProfileMetadata(targetUserDataDir, metadata);
+}
+async function mergePersistentProfileSnapshot(runtimeUserDataDir, persistentUserDataDir, metadata, runtimeMetadata) {
+  const tempUserDataDir = await (0, import_promises4.mkdtemp)(
+    buildPersistentProfileTempDirPrefix(persistentUserDataDir)
+  );
+  let published = false;
+  try {
+    const baseEntries = deserializeSnapshotManifestEntries(
+      runtimeMetadata.baseEntries
+    );
+    const currentEntries = await collectPersistentSnapshotEntries(
+      persistentUserDataDir,
+      metadata.profileDirectory
+    );
+    const runtimeEntries = await collectPersistentSnapshotEntries(
+      runtimeUserDataDir,
+      metadata.profileDirectory
+    );
+    const mergedEntries = resolveMergedSnapshotEntries(
+      baseEntries,
+      currentEntries,
+      runtimeEntries
+    );
+    await materializeMergedPersistentProfileSnapshot(
+      tempUserDataDir,
+      currentEntries,
+      runtimeEntries,
+      mergedEntries
+    );
+    await writePersistentProfileMetadata(tempUserDataDir, metadata);
+    await replaceProfileDirectory(persistentUserDataDir, tempUserDataDir);
+    published = true;
   } finally {
     if (!published) {
-      await (0, import_promises.rm)(tempUserDataDir, {
+      await (0, import_promises4.rm)(tempUserDataDir, {
+        recursive: true,
+        force: true
+      }).catch(() => void 0);
+    }
+  }
+}
+async function buildRuntimeProfileMetadata(runtimeUserDataDir, persistentUserDataDir, profileDirectory) {
+  const baseEntries = profileDirectory ? serializeSnapshotManifestEntries(
+    await collectPersistentSnapshotEntries(
+      runtimeUserDataDir,
+      profileDirectory
+    )
+  ) : {};
+  return {
+    baseEntries,
+    creator: CURRENT_PROCESS_OWNER,
+    persistentUserDataDir,
+    profileDirectory
+  };
+}
+async function writeRuntimeProfileMetadata(userDataDir, metadata) {
+  await (0, import_promises4.writeFile)(
+    (0, import_node_path4.join)(userDataDir, OPENSTEER_RUNTIME_META_FILE),
+    JSON.stringify(metadata, null, 2)
+  );
+}
+async function writeRuntimeProfileCreationMarker(userDataDir, marker) {
+  await (0, import_promises4.writeFile)(
+    (0, import_node_path4.join)(userDataDir, OPENSTEER_RUNTIME_CREATING_FILE),
+    JSON.stringify(marker, null, 2)
+  );
+}
+async function readRuntimeProfileMetadata(userDataDir) {
+  try {
+    const raw = await (0, import_promises4.readFile)(
+      (0, import_node_path4.join)(userDataDir, OPENSTEER_RUNTIME_META_FILE),
+      "utf8"
+    );
+    const parsed = JSON.parse(raw);
+    const creator = parseProcessOwner(parsed.creator);
+    const persistentUserDataDir = typeof parsed.persistentUserDataDir === "string" ? parsed.persistentUserDataDir : void 0;
+    const profileDirectory = parsed.profileDirectory === null ? null : typeof parsed.profileDirectory === "string" ? parsed.profileDirectory : void 0;
+    if (!creator || persistentUserDataDir === void 0 || profileDirectory === void 0 || typeof parsed.baseEntries !== "object" || parsed.baseEntries === null || Array.isArray(parsed.baseEntries)) {
+      return null;
+    }
+    const baseEntries = deserializeSnapshotManifestEntries(
+      parsed.baseEntries
+    );
+    return {
+      baseEntries: Object.fromEntries(baseEntries),
+      creator,
+      persistentUserDataDir,
+      profileDirectory
+    };
+  } catch {
+    return null;
+  }
+}
+async function readRuntimeProfileCreationMarker(userDataDir) {
+  try {
+    const raw = await (0, import_promises4.readFile)(
+      (0, import_node_path4.join)(userDataDir, OPENSTEER_RUNTIME_CREATING_FILE),
+      "utf8"
+    );
+    return parseRuntimeProfileCreationMarker(JSON.parse(raw));
+  } catch {
+    return null;
+  }
+}
+async function requireRuntimeProfileMetadata(userDataDir, expectedPersistentUserDataDir, expectedProfileDirectory, displayUserDataDir = userDataDir) {
+  const metadata = await readRuntimeProfileMetadata(userDataDir);
+  if (!metadata) {
+    throw new Error(
+      `Runtime profile metadata was not found for "${displayUserDataDir}".`
+    );
+  }
+  if (metadata.profileDirectory !== expectedProfileDirectory) {
+    throw new Error(
+      `Runtime profile "${displayUserDataDir}" was created for profile "${metadata.profileDirectory ?? "unknown"}", expected "${expectedProfileDirectory}".`
+    );
+  }
+  if (metadata.persistentUserDataDir !== expectedPersistentUserDataDir) {
+    throw new Error(
+      `Runtime profile "${displayUserDataDir}" does not belong to persistent profile "${expectedPersistentUserDataDir}".`
+    );
+  }
+  return metadata;
+}
+async function collectPersistentSnapshotEntries(userDataDir, profileDirectory) {
+  let rootEntries;
+  try {
+    rootEntries = await (0, import_promises4.readdir)(userDataDir, {
+      encoding: "utf8",
+      withFileTypes: true
+    });
+  } catch {
+    return /* @__PURE__ */ new Map();
+  }
+  rootEntries.sort((left, right) => left.name.localeCompare(right.name));
+  const collected = /* @__PURE__ */ new Map();
+  for (const entry of rootEntries) {
+    if (!shouldIncludePersistentRootEntry(
+      userDataDir,
+      profileDirectory,
+      entry.name
+    )) {
+      continue;
+    }
+    await collectSnapshotEntry(
+      (0, import_node_path4.join)(userDataDir, entry.name),
+      entry.name,
+      collected
+    );
+  }
+  return collected;
+}
+function shouldIncludePersistentRootEntry(userDataDir, profileDirectory, entry) {
+  if (entry === profileDirectory) {
+    return true;
+  }
+  if (COPY_SKIP_ENTRIES.has(entry)) {
+    return false;
+  }
+  if (SKIPPED_ROOT_DIRECTORIES.has(entry)) {
+    return false;
+  }
+  return !isProfileDirectory(userDataDir, entry);
+}
+async function collectSnapshotEntry(sourcePath, relativePath, collected) {
+  let entryStat;
+  try {
+    entryStat = await (0, import_promises4.stat)(sourcePath);
+  } catch {
+    return;
+  }
+  if (entryStat.isDirectory()) {
+    collected.set(relativePath, {
+      kind: "directory",
+      hash: null,
+      sourcePath
+    });
+    let children;
+    try {
+      children = await (0, import_promises4.readdir)(sourcePath, {
+        encoding: "utf8",
+        withFileTypes: true
+      });
+    } catch {
+      return;
+    }
+    children.sort((left, right) => left.name.localeCompare(right.name));
+    for (const child of children) {
+      await collectSnapshotEntry(
+        (0, import_node_path4.join)(sourcePath, child.name),
+        (0, import_node_path4.join)(relativePath, child.name),
+        collected
+      );
+    }
+    return;
+  }
+  if (entryStat.isFile()) {
+    collected.set(relativePath, {
+      kind: "file",
+      hash: await hashSnapshotFile(sourcePath, relativePath),
+      sourcePath
+    });
+  }
+}
+function serializeSnapshotManifestEntries(entries) {
+  return Object.fromEntries(
+    [...entries.entries()].sort(([leftPath], [rightPath]) => leftPath.localeCompare(rightPath)).map(([relativePath, entry]) => [
+      relativePath,
+      {
+        kind: entry.kind,
+        hash: entry.hash
+      }
+    ])
+  );
+}
+function deserializeSnapshotManifestEntries(entries) {
+  const manifestEntries = /* @__PURE__ */ new Map();
+  for (const [relativePath, entry] of Object.entries(entries)) {
+    if (!entry || entry.kind !== "directory" && entry.kind !== "file" || !(entry.hash === null || typeof entry.hash === "string")) {
+      throw new Error(
+        `Runtime profile metadata for "${relativePath}" is invalid.`
+      );
+    }
+    manifestEntries.set(relativePath, {
+      kind: entry.kind,
+      hash: entry.hash
+    });
+  }
+  return manifestEntries;
+}
+function resolveMergedSnapshotEntries(baseEntries, currentEntries, runtimeEntries) {
+  const mergedEntries = /* @__PURE__ */ new Map();
+  const relativePaths = /* @__PURE__ */ new Set([
+    ...baseEntries.keys(),
+    ...currentEntries.keys(),
+    ...runtimeEntries.keys()
+  ]);
+  for (const relativePath of [...relativePaths].sort(compareSnapshotPaths)) {
+    mergedEntries.set(
+      relativePath,
+      resolveMergedSnapshotEntrySelection(
+        relativePath,
+        baseEntries.get(relativePath) ?? null,
+        currentEntries.get(relativePath) ?? null,
+        runtimeEntries.get(relativePath) ?? null
+      )
+    );
+  }
+  return mergedEntries;
+}
+function resolveMergedSnapshotEntrySelection(relativePath, baseEntry, currentEntry, runtimeEntry) {
+  if (snapshotEntriesEqual(runtimeEntry, baseEntry)) {
+    return currentEntry ? "current" : null;
+  }
+  if (snapshotEntriesEqual(currentEntry, baseEntry)) {
+    return runtimeEntry ? "runtime" : null;
+  }
+  if (!baseEntry) {
+    if (!currentEntry) {
+      return runtimeEntry ? "runtime" : null;
+    }
+    if (!runtimeEntry) {
+      return "current";
+    }
+    if (snapshotEntriesEqual(currentEntry, runtimeEntry)) {
+      return "current";
+    }
+    throw new Error(
+      `Concurrent runtime updates changed "${relativePath}" differently; refusing to overwrite the persistent profile.`
+    );
+  }
+  if (!currentEntry && !runtimeEntry) {
+    return null;
+  }
+  if (snapshotEntriesEqual(currentEntry, runtimeEntry)) {
+    return currentEntry ? "current" : null;
+  }
+  throw new Error(
+    `Concurrent runtime updates changed "${relativePath}" differently; refusing to overwrite the persistent profile.`
+  );
+}
+function snapshotEntriesEqual(left, right) {
+  if (!left || !right) {
+    return left === right;
+  }
+  return left.kind === right.kind && left.hash === right.hash;
+}
+async function materializeMergedPersistentProfileSnapshot(targetUserDataDir, currentEntries, runtimeEntries, mergedEntries) {
+  const selectedEntries = [...mergedEntries.entries()].filter(([, selection]) => selection !== null).sort(
+    ([leftPath], [rightPath]) => compareSnapshotPaths(leftPath, rightPath)
+  );
+  for (const [relativePath, selection] of selectedEntries) {
+    const entry = (selection === "current" ? currentEntries.get(relativePath) : runtimeEntries.get(relativePath)) ?? null;
+    if (!entry) {
+      continue;
+    }
+    const targetPath = (0, import_node_path4.join)(targetUserDataDir, relativePath);
+    if (entry.kind === "directory") {
+      await (0, import_promises4.mkdir)(targetPath, { recursive: true });
+      continue;
+    }
+    await (0, import_promises4.mkdir)((0, import_node_path4.dirname)(targetPath), { recursive: true });
+    await (0, import_promises4.copyFile)(entry.sourcePath, targetPath);
+  }
+}
+function compareSnapshotPaths(left, right) {
+  const leftDepth = left.split(import_node_path4.sep).length;
+  const rightDepth = right.split(import_node_path4.sep).length;
+  if (leftDepth !== rightDepth) {
+    return leftDepth - rightDepth;
+  }
+  return left.localeCompare(right);
+}
+async function hashSnapshotFile(filePath, relativePath) {
+  const normalizedJson = await readNormalizedSnapshotJson(filePath, relativePath);
+  if (normalizedJson !== null) {
+    return (0, import_node_crypto3.createHash)("sha256").update(JSON.stringify(normalizedJson)).digest("hex");
+  }
+  return await hashFile(filePath);
+}
+async function readNormalizedSnapshotJson(filePath, relativePath) {
+  const normalizer = SNAPSHOT_JSON_NORMALIZERS.get(relativePath);
+  if (!normalizer) {
+    return null;
+  }
+  try {
+    const parsed = JSON.parse(await (0, import_promises4.readFile)(filePath, "utf8"));
+    return normalizer(parsed);
+  } catch {
+    return null;
+  }
+}
+var SNAPSHOT_JSON_NORMALIZERS = /* @__PURE__ */ new Map([["Local State", normalizeLocalStateSnapshotJson]]);
+function normalizeLocalStateSnapshotJson(value) {
+  if (!isJsonRecord(value)) {
+    return value;
+  }
+  const { user_experience_metrics: _ignored, ...rest } = value;
+  return rest;
+}
+function isJsonRecord(value) {
+  return !!value && typeof value === "object" && !Array.isArray(value);
+}
+async function hashFile(filePath) {
+  return new Promise((resolve, reject) => {
+    const hash = (0, import_node_crypto3.createHash)("sha256");
+    const stream = (0, import_node_fs3.createReadStream)(filePath);
+    stream.on("data", (chunk) => {
+      hash.update(chunk);
+    });
+    stream.on("error", reject);
+    stream.on("end", () => {
+      resolve(hash.digest("hex"));
+    });
+  });
+}
+async function ensurePersistentProfileMetadata(userDataDir, metadata) {
+  if ((0, import_node_fs3.existsSync)((0, import_node_path4.join)(userDataDir, OPENSTEER_META_FILE))) {
+    return;
+  }
+  await writePersistentProfileMetadata(userDataDir, metadata);
+}
+async function recoverPersistentProfileBackup(targetUserDataDir) {
+  const backupDirPaths = await listPersistentProfileBackupDirs(targetUserDataDir);
+  if (backupDirPaths.length === 0) {
+    return;
+  }
+  if (!(0, import_node_fs3.existsSync)(targetUserDataDir)) {
+    const [latestBackupDirPath, ...staleBackupDirPaths] = backupDirPaths;
+    await (0, import_promises4.rename)(latestBackupDirPath, targetUserDataDir);
+    await Promise.all(
+      staleBackupDirPaths.map(
+        (backupDirPath) => (0, import_promises4.rm)(backupDirPath, {
+          recursive: true,
+          force: true
+        }).catch(() => void 0)
+      )
+    );
+    return;
+  }
+  await Promise.all(
+    backupDirPaths.map(
+      (backupDirPath) => (0, import_promises4.rm)(backupDirPath, {
+        recursive: true,
+        force: true
+      }).catch(() => void 0)
+    )
+  );
+}
+async function listPersistentProfileBackupDirs(targetUserDataDir) {
+  const profilesDir = (0, import_node_path4.dirname)(targetUserDataDir);
+  let entries;
+  try {
+    entries = await (0, import_promises4.readdir)(profilesDir, {
+      encoding: "utf8",
+      withFileTypes: true
+    });
+  } catch {
+    return [];
+  }
+  const backupDirNamePrefix = buildPersistentProfileBackupDirNamePrefix(targetUserDataDir);
+  return entries.filter(
+    (entry) => entry.isDirectory() && entry.name.startsWith(backupDirNamePrefix)
+  ).map((entry) => (0, import_node_path4.join)(profilesDir, entry.name)).sort((leftPath, rightPath) => rightPath.localeCompare(leftPath));
+}
+async function readPersistentProfileMetadata(userDataDir) {
+  try {
+    const raw = await (0, import_promises4.readFile)((0, import_node_path4.join)(userDataDir, OPENSTEER_META_FILE), "utf8");
+    const parsed = JSON.parse(raw);
+    if (typeof parsed.createdAt !== "string" || typeof parsed.profileDirectory !== "string" || typeof parsed.source !== "string") {
+      return null;
+    }
+    return {
+      createdAt: parsed.createdAt,
+      profileDirectory: parsed.profileDirectory,
+      source: parsed.source
+    };
+  } catch {
+    return null;
+  }
+}
+async function requirePersistentProfileMetadata(userDataDir) {
+  const metadata = await readPersistentProfileMetadata(userDataDir);
+  if (!metadata) {
+    throw new Error(
+      `Persistent profile metadata was not found for "${userDataDir}".`
+    );
+  }
+  return metadata;
+}
+async function isHealthyPersistentProfile(userDataDir, expectedSourceUserDataDir, expectedProfileDirectory) {
+  if (!(0, import_node_fs3.existsSync)(userDataDir) || !(0, import_node_fs3.existsSync)((0, import_node_path4.join)(userDataDir, expectedProfileDirectory))) {
+    return false;
+  }
+  const metadata = await readPersistentProfileMetadata(userDataDir);
+  return metadata?.source === expectedSourceUserDataDir && metadata.profileDirectory === expectedProfileDirectory;
+}
+function wasDirPublishedByAnotherProcess2(error, targetDirPath) {
+  const code = typeof error === "object" && error !== null && "code" in error && typeof error.code === "string" ? error.code : void 0;
+  return (0, import_node_fs3.existsSync)(targetDirPath) && (code === "EEXIST" || code === "ENOTEMPTY" || code === "EPERM");
+}
+async function replaceProfileDirectory(targetUserDataDir, replacementUserDataDir) {
+  if (!(0, import_node_fs3.existsSync)(targetUserDataDir)) {
+    await (0, import_promises4.rename)(replacementUserDataDir, targetUserDataDir);
+    return;
+  }
+  const backupUserDataDir = buildPersistentProfileBackupDirPath(targetUserDataDir);
+  let targetMovedToBackup = false;
+  let replacementPublished = false;
+  try {
+    await (0, import_promises4.rename)(targetUserDataDir, backupUserDataDir);
+    targetMovedToBackup = true;
+    await (0, import_promises4.rename)(replacementUserDataDir, targetUserDataDir);
+    replacementPublished = true;
+  } catch (error) {
+    if (targetMovedToBackup && !(0, import_node_fs3.existsSync)(targetUserDataDir)) {
+      await (0, import_promises4.rename)(backupUserDataDir, targetUserDataDir).catch(() => void 0);
+    }
+    throw error;
+  } finally {
+    if (replacementPublished && targetMovedToBackup && (0, import_node_fs3.existsSync)(backupUserDataDir)) {
+      await (0, import_promises4.rm)(backupUserDataDir, {
+        recursive: true,
+        force: true
+      }).catch(() => void 0);
+    }
+  }
+}
+async function withPersistentProfileWriteAccess(targetUserDataDir, action) {
+  const releaseWriteLock = await acquirePersistentProfileWriteLock(
+    targetUserDataDir
+  );
+  try {
+    await waitForRuntimeProfileCreationsToDrain(targetUserDataDir);
+    await waitForSharedRealBrowserSessionToDrain(targetUserDataDir);
+    return await action();
+  } finally {
+    await releaseWriteLock();
+  }
+}
+function buildPersistentProfileTempDirPrefix(targetUserDataDir) {
+  return (0, import_node_path4.join)(
+    (0, import_node_path4.dirname)(targetUserDataDir),
+    `${buildPersistentProfileTempDirNamePrefix(targetUserDataDir)}${process.pid}-${CURRENT_PROCESS_OWNER.processStartedAtMs}-`
+  );
+}
+function buildPersistentProfileTempDirNamePrefix(targetUserDataDir) {
+  return `${(0, import_node_path4.basename)(targetUserDataDir)}-tmp-`;
+}
+function buildPersistentProfileBackupDirPath(targetUserDataDir) {
+  return (0, import_node_path4.join)(
+    (0, import_node_path4.dirname)(targetUserDataDir),
+    `${buildPersistentProfileBackupDirNamePrefix(targetUserDataDir)}${Date.now()}-${process.pid}-${CURRENT_PROCESS_OWNER.processStartedAtMs}-${(0, import_node_crypto3.randomUUID)()}`
+  );
+}
+function buildPersistentProfileBackupDirNamePrefix(targetUserDataDir) {
+  return `${(0, import_node_path4.basename)(targetUserDataDir)}-backup-`;
+}
+function buildRuntimeProfileCreationRegistryDirPath(persistentUserDataDir) {
+  return (0, import_node_path4.join)(
+    (0, import_node_path4.dirname)(persistentUserDataDir),
+    `${(0, import_node_path4.basename)(persistentUserDataDir)}.creating`
+  );
+}
+function buildRuntimeProfileCreationRegistrationPath(persistentUserDataDir, runtimeUserDataDir) {
+  const key = (0, import_node_crypto3.createHash)("sha256").update(runtimeUserDataDir).digest("hex").slice(0, 16);
+  return (0, import_node_path4.join)(
+    buildRuntimeProfileCreationRegistryDirPath(persistentUserDataDir),
+    `${key}.json`
+  );
+}
+function buildRuntimeProfileKey(sourceUserDataDir) {
+  const hash = (0, import_node_crypto3.createHash)("sha256").update(sourceUserDataDir).digest("hex").slice(0, 16);
+  return `${sanitizePathSegment((0, import_node_path4.basename)(sourceUserDataDir) || "profile")}-${hash}`;
+}
+function buildRuntimeProfileDirNamePrefix(sourceUserDataDir) {
+  return `${buildRuntimeProfileKey(sourceUserDataDir)}-runtime-`;
+}
+function buildRuntimeProfileDirPrefix(runtimesRootDir, sourceUserDataDir) {
+  return (0, import_node_path4.join)(
+    runtimesRootDir,
+    buildRuntimeProfileDirNamePrefix(sourceUserDataDir)
+  );
+}
+async function reserveRuntimeProfileCreation(persistentUserDataDir, runtimeRootDir, profileDirectory) {
+  while (true) {
+    let runtimeUserDataDir = null;
+    await withPersistentProfileControlLock(
+      persistentUserDataDir,
+      async () => {
+        if (await isPersistentProfileWriteLocked(persistentUserDataDir)) {
+          return;
+        }
+        if (await hasLiveSharedRealBrowserSession(persistentUserDataDir)) {
+          return;
+        }
+        const createdRuntimeUserDataDir = await (0, import_promises4.mkdtemp)(
+          buildRuntimeProfileDirPrefix(
+            runtimeRootDir,
+            persistentUserDataDir
+          )
+        );
+        runtimeUserDataDir = createdRuntimeUserDataDir;
+        const marker = {
+          creator: CURRENT_PROCESS_OWNER,
+          persistentUserDataDir,
+          profileDirectory,
+          runtimeUserDataDir: createdRuntimeUserDataDir
+        };
+        await writeRuntimeProfileCreationMarker(
+          createdRuntimeUserDataDir,
+          marker
+        );
+        await writeRuntimeProfileCreationRegistration(marker);
+      }
+    );
+    if (runtimeUserDataDir) {
+      return {
+        persistentUserDataDir,
+        userDataDir: runtimeUserDataDir
+      };
+    }
+    await sleep4(PERSISTENT_PROFILE_LOCK_RETRY_DELAY_MS);
+  }
+}
+async function clearRuntimeProfileCreationState(runtimeUserDataDir, persistentUserDataDir) {
+  await Promise.all([
+    (0, import_promises4.rm)((0, import_node_path4.join)(runtimeUserDataDir, OPENSTEER_RUNTIME_CREATING_FILE), {
+      force: true
+    }).catch(() => void 0),
+    (0, import_promises4.rm)(
+      buildRuntimeProfileCreationRegistrationPath(
+        persistentUserDataDir,
+        runtimeUserDataDir
+      ),
+      {
+        force: true
+      }
+    ).catch(() => void 0)
+  ]);
+}
+async function writeRuntimeProfileCreationRegistration(marker) {
+  const registryDirPath = buildRuntimeProfileCreationRegistryDirPath(
+    marker.persistentUserDataDir
+  );
+  await (0, import_promises4.mkdir)(registryDirPath, { recursive: true });
+  await (0, import_promises4.writeFile)(
+    buildRuntimeProfileCreationRegistrationPath(
+      marker.persistentUserDataDir,
+      marker.runtimeUserDataDir
+    ),
+    JSON.stringify(marker, null, 2)
+  );
+}
+async function listRuntimeProfileCreationRegistrations(persistentUserDataDir) {
+  const registryDirPath = buildRuntimeProfileCreationRegistryDirPath(
+    persistentUserDataDir
+  );
+  let entries;
+  try {
+    entries = await (0, import_promises4.readdir)(registryDirPath, {
+      encoding: "utf8",
+      withFileTypes: true
+    });
+  } catch {
+    return [];
+  }
+  return await Promise.all(
+    entries.filter((entry) => entry.isFile()).map(async (entry) => {
+      const filePath = (0, import_node_path4.join)(registryDirPath, entry.name);
+      return {
+        filePath,
+        marker: await readRuntimeProfileCreationRegistration(filePath)
+      };
+    })
+  );
+}
+async function readRuntimeProfileCreationRegistration(filePath) {
+  try {
+    const raw = await (0, import_promises4.readFile)(filePath, "utf8");
+    return parseRuntimeProfileCreationMarker(JSON.parse(raw));
+  } catch {
+    return null;
+  }
+}
+async function cleanOrphanedRuntimeProfileDirs(rootDir, runtimeDirNamePrefix) {
+  let entries;
+  try {
+    entries = await (0, import_promises4.readdir)(rootDir, {
+      encoding: "utf8",
+      withFileTypes: true
+    });
+  } catch {
+    return;
+  }
+  const liveProcessCommandLines = await listProcessCommandLines();
+  await Promise.all(
+    entries.map(async (entry) => {
+      if (!entry.isDirectory() || !entry.name.startsWith(runtimeDirNamePrefix)) {
+        return;
+      }
+      const runtimeDirPath = (0, import_node_path4.join)(rootDir, entry.name);
+      const creationMarker = await readRuntimeProfileCreationMarker(
+        runtimeDirPath
+      );
+      if (await isRuntimeProfileDirInUse(
+        runtimeDirPath,
+        liveProcessCommandLines
+      )) {
+        return;
+      }
+      await (0, import_promises4.rm)(runtimeDirPath, {
+        recursive: true,
+        force: true
+      }).catch(() => void 0);
+      if (creationMarker) {
+        await clearRuntimeProfileCreationState(
+          runtimeDirPath,
+          creationMarker.persistentUserDataDir
+        );
+      }
+    })
+  );
+}
+async function cleanOrphanedOwnedDirs(rootDir, ownedDirNamePrefix) {
+  let entries;
+  try {
+    entries = await (0, import_promises4.readdir)(rootDir, {
+      encoding: "utf8",
+      withFileTypes: true
+    });
+  } catch {
+    return;
+  }
+  await Promise.all(
+    entries.map(async (entry) => {
+      if (!entry.isDirectory() || !entry.name.startsWith(ownedDirNamePrefix)) {
+        return;
+      }
+      if (await isOwnedDirByLiveProcess(entry.name, ownedDirNamePrefix)) {
+        return;
+      }
+      await (0, import_promises4.rm)((0, import_node_path4.join)(rootDir, entry.name), {
         recursive: true,
         force: true
       }).catch(() => void 0);
-    }
-  }
-}
-async function buildRuntimeProfileMetadata(runtimeUserDataDir, profileDirectory) {
-  if (!profileDirectory) {
-    return {
-      baseEntries: {},
-      profileDirectory: null
-    };
-  }
-  const baseEntries = await collectPersistentSnapshotEntries(
-    runtimeUserDataDir,
-    profileDirectory
+    })
   );
-  return {
-    baseEntries: serializeSnapshotManifestEntries(baseEntries),
-    profileDirectory
-  };
 }
-async function writeRuntimeProfileMetadata(userDataDir, metadata) {
-  await (0, import_promises.writeFile)(
-    (0, import_node_path.join)(userDataDir, OPENSTEER_RUNTIME_META_FILE),
-    JSON.stringify(metadata, null, 2)
+async function isOwnedDirByLiveProcess(ownedDirName, ownedDirPrefix) {
+  const owner = parseOwnedDirOwner(ownedDirName, ownedDirPrefix);
+  return owner ? await getProcessLiveness(owner) !== "dead" : false;
+}
+async function isRuntimeProfileDirInUse(runtimeDirPath, liveProcessCommandLines) {
+  const creationMarker = await readRuntimeProfileCreationMarker(runtimeDirPath);
+  if (creationMarker && await getProcessLiveness(creationMarker.creator) !== "dead") {
+    return true;
+  }
+  const metadata = await readRuntimeProfileMetadata(runtimeDirPath);
+  if (metadata && await getProcessLiveness(metadata.creator) !== "dead") {
+    return true;
+  }
+  return liveProcessCommandLines.some(
+    (commandLine) => commandLineIncludesUserDataDir(commandLine, runtimeDirPath)
   );
 }
-async function readRuntimeProfileMetadata(userDataDir) {
-  try {
-    const raw = await (0, import_promises.readFile)(
-      (0, import_node_path.join)(userDataDir, OPENSTEER_RUNTIME_META_FILE),
-      "utf8"
-    );
-    const parsed = JSON.parse(raw);
-    const profileDirectory = parsed.profileDirectory === null ? null : typeof parsed.profileDirectory === "string" ? parsed.profileDirectory : void 0;
-    if (profileDirectory === void 0 || typeof parsed.baseEntries !== "object" || parsed.baseEntries === null || Array.isArray(parsed.baseEntries)) {
-      return null;
+async function claimRuntimeProfileForPersist(runtimeUserDataDir) {
+  while (true) {
+    await waitForRuntimeProfileProcessesToDrain(runtimeUserDataDir);
+    const claimedRuntimeUserDataDir = buildClaimedRuntimeProfileDirPath(runtimeUserDataDir);
+    try {
+      await (0, import_promises4.rename)(runtimeUserDataDir, claimedRuntimeUserDataDir);
+    } catch (error) {
+      const code = getErrorCode3(error);
+      if (code === "ENOENT") {
+        throw new Error(
+          `Runtime profile "${runtimeUserDataDir}" was not found.`
+        );
+      }
+      if (code === "EACCES" || code === "EBUSY" || code === "EPERM") {
+        await sleep4(PERSISTENT_PROFILE_LOCK_RETRY_DELAY_MS);
+        continue;
+      }
+      throw error;
     }
-    const baseEntries = deserializeSnapshotManifestEntries(
-      parsed.baseEntries
-    );
-    return {
-      baseEntries: Object.fromEntries(baseEntries),
-      profileDirectory
-    };
-  } catch {
-    return null;
+    if (!await hasLiveProcessUsingUserDataDir(runtimeUserDataDir)) {
+      return claimedRuntimeUserDataDir;
+    }
+    await (0, import_promises4.rename)(
+      claimedRuntimeUserDataDir,
+      runtimeUserDataDir
+    ).catch(() => void 0);
+    await sleep4(PERSISTENT_PROFILE_LOCK_RETRY_DELAY_MS);
   }
 }
-async function requireRuntimeProfileMetadata(userDataDir, expectedProfileDirectory) {
-  const metadata = await readRuntimeProfileMetadata(userDataDir);
-  if (!metadata) {
-    throw new Error(
-      `Runtime profile metadata was not found for "${userDataDir}".`
-    );
+async function restoreClaimedRuntimeProfile(claimedRuntimeUserDataDir, runtimeUserDataDir) {
+  if (!(0, import_node_fs3.existsSync)(claimedRuntimeUserDataDir)) {
+    return;
   }
-  if (metadata.profileDirectory !== expectedProfileDirectory) {
+  if ((0, import_node_fs3.existsSync)(runtimeUserDataDir)) {
     throw new Error(
-      `Runtime profile "${userDataDir}" was created for profile "${metadata.profileDirectory ?? "unknown"}", expected "${expectedProfileDirectory}".`
+      `Runtime profile "${runtimeUserDataDir}" was recreated before the failed persist could restore it from "${claimedRuntimeUserDataDir}".`
     );
   }
-  return metadata;
+  await (0, import_promises4.rename)(claimedRuntimeUserDataDir, runtimeUserDataDir);
 }
-async function collectPersistentSnapshotEntries(userDataDir, profileDirectory) {
-  let rootEntries;
-  try {
-    rootEntries = await (0, import_promises.readdir)(userDataDir, {
-      encoding: "utf8",
-      withFileTypes: true
-    });
-  } catch {
-    return /* @__PURE__ */ new Map();
+function buildClaimedRuntimeProfileDirPath(runtimeUserDataDir) {
+  return (0, import_node_path4.join)(
+    (0, import_node_path4.dirname)(runtimeUserDataDir),
+    `${(0, import_node_path4.basename)(runtimeUserDataDir)}-persisting-${process.pid}-${CURRENT_PROCESS_OWNER.processStartedAtMs}-${(0, import_node_crypto3.randomUUID)()}`
+  );
+}
+async function waitForRuntimeProfileProcessesToDrain(runtimeUserDataDir) {
+  while (await hasLiveProcessUsingUserDataDir(runtimeUserDataDir)) {
+    await sleep4(PERSISTENT_PROFILE_LOCK_RETRY_DELAY_MS);
   }
-  rootEntries.sort((left, right) => left.name.localeCompare(right.name));
-  const collected = /* @__PURE__ */ new Map();
-  for (const entry of rootEntries) {
-    if (!shouldIncludePersistentRootEntry(
-      userDataDir,
-      profileDirectory,
-      entry.name
-    )) {
+}
+async function hasLiveProcessUsingUserDataDir(userDataDir) {
+  const liveProcessCommandLines = await listProcessCommandLines();
+  return liveProcessCommandLines.some(
+    (commandLine) => commandLineIncludesUserDataDir(commandLine, userDataDir)
+  );
+}
+async function hasActiveRuntimeProfileCreations(persistentUserDataDir) {
+  const registrations = await listRuntimeProfileCreationRegistrations(
+    persistentUserDataDir
+  );
+  let hasLiveCreation = false;
+  for (const registration of registrations) {
+    const marker = registration.marker;
+    if (!marker || marker.persistentUserDataDir !== persistentUserDataDir) {
+      await (0, import_promises4.rm)(registration.filePath, {
+        force: true
+      }).catch(() => void 0);
       continue;
     }
-    await collectSnapshotEntry(
-      (0, import_node_path.join)(userDataDir, entry.name),
-      entry.name,
-      collected
+    const runtimeMarker = await readRuntimeProfileCreationMarker(
+      marker.runtimeUserDataDir
     );
+    if (!runtimeMarker || runtimeMarker.persistentUserDataDir !== persistentUserDataDir || runtimeMarker.runtimeUserDataDir !== marker.runtimeUserDataDir) {
+      await clearRuntimeProfileCreationState(
+        marker.runtimeUserDataDir,
+        persistentUserDataDir
+      );
+      continue;
+    }
+    if (await getProcessLiveness(runtimeMarker.creator) === "dead") {
+      await clearRuntimeProfileCreationState(
+        marker.runtimeUserDataDir,
+        persistentUserDataDir
+      );
+      await (0, import_promises4.rm)(marker.runtimeUserDataDir, {
+        recursive: true,
+        force: true
+      }).catch(() => void 0);
+      continue;
+    }
+    hasLiveCreation = true;
   }
-  return collected;
+  return hasLiveCreation;
 }
-function shouldIncludePersistentRootEntry(userDataDir, profileDirectory, entry) {
-  if (entry === profileDirectory) {
-    return true;
+async function waitForRuntimeProfileCreationsToDrain(persistentUserDataDir) {
+  while (true) {
+    if (!await hasActiveRuntimeProfileCreations(persistentUserDataDir)) {
+      return;
+    }
+    await sleep4(PERSISTENT_PROFILE_LOCK_RETRY_DELAY_MS);
   }
-  if (COPY_SKIP_ENTRIES.has(entry)) {
-    return false;
+}
+function parseRuntimeProfileCreationMarker(value) {
+  if (!value || typeof value !== "object") {
+    return null;
   }
-  if (SKIPPED_ROOT_DIRECTORIES.has(entry)) {
-    return false;
+  const parsed = value;
+  const creator = parseProcessOwner(parsed.creator);
+  const persistentUserDataDir = typeof parsed.persistentUserDataDir === "string" ? parsed.persistentUserDataDir : void 0;
+  const profileDirectory = parsed.profileDirectory === null ? null : typeof parsed.profileDirectory === "string" ? parsed.profileDirectory : void 0;
+  const runtimeUserDataDir = typeof parsed.runtimeUserDataDir === "string" ? parsed.runtimeUserDataDir : void 0;
+  if (!creator || persistentUserDataDir === void 0 || profileDirectory === void 0 || runtimeUserDataDir === void 0) {
+    return null;
   }
-  return !isProfileDirectory(userDataDir, entry);
+  return {
+    creator,
+    persistentUserDataDir,
+    profileDirectory,
+    runtimeUserDataDir
+  };
 }
-async function collectSnapshotEntry(sourcePath, relativePath, collected) {
-  let entryStat;
-  try {
-    entryStat = await (0, import_promises.stat)(sourcePath);
-  } catch {
-    return;
+function parseOwnedDirOwner(ownedDirName, ownedDirPrefix) {
+  const remainder = ownedDirName.slice(ownedDirPrefix.length);
+  const firstDashIndex = remainder.indexOf("-");
+  const secondDashIndex = firstDashIndex === -1 ? -1 : remainder.indexOf("-", firstDashIndex + 1);
+  if (firstDashIndex === -1 || secondDashIndex === -1) {
+    return null;
   }
-  if (entryStat.isDirectory()) {
-    collected.set(relativePath, {
-      kind: "directory",
-      hash: null,
-      sourcePath
-    });
-    let children;
-    try {
-      children = await (0, import_promises.readdir)(sourcePath, {
-        encoding: "utf8",
-        withFileTypes: true
-      });
-    } catch {
-      return;
-    }
-    children.sort((left, right) => left.name.localeCompare(right.name));
-    for (const child of children) {
-      await collectSnapshotEntry(
-        (0, import_node_path.join)(sourcePath, child.name),
-        (0, import_node_path.join)(relativePath, child.name),
-        collected
-      );
-    }
-    return;
+  const pid = Number.parseInt(remainder.slice(0, firstDashIndex), 10);
+  const processStartedAtMs = Number.parseInt(
+    remainder.slice(firstDashIndex + 1, secondDashIndex),
+    10
+  );
+  if (!Number.isInteger(pid) || pid <= 0) {
+    return null;
   }
-  if (entryStat.isFile()) {
-    collected.set(relativePath, {
-      kind: "file",
-      hash: await hashFile(sourcePath),
-      sourcePath
-    });
+  if (!Number.isInteger(processStartedAtMs) || processStartedAtMs <= 0) {
+    return null;
   }
+  return { pid, processStartedAtMs };
 }
-function serializeSnapshotManifestEntries(entries) {
-  return Object.fromEntries(
-    [...entries.entries()].sort(([leftPath], [rightPath]) => leftPath.localeCompare(rightPath)).map(([relativePath, entry]) => [
-      relativePath,
+async function listProcessCommandLines() {
+  if (process.platform === "win32") {
+    return await listWindowsProcessCommandLines();
+  }
+  return await listPsProcessCommandLines();
+}
+async function listPsProcessCommandLines() {
+  try {
+    const { stdout } = await execFileAsync2(
+      "ps",
+      ["-axww", "-o", "command="],
       {
-        kind: entry.kind,
-        hash: entry.hash
+        env: PS_COMMAND_ENV2,
+        maxBuffer: PROCESS_LIST_MAX_BUFFER_BYTES2
       }
-    ])
-  );
-}
-function deserializeSnapshotManifestEntries(entries) {
-  const manifestEntries = /* @__PURE__ */ new Map();
-  for (const [relativePath, entry] of Object.entries(entries)) {
-    if (!entry || entry.kind !== "directory" && entry.kind !== "file" || !(entry.hash === null || typeof entry.hash === "string")) {
-      throw new Error(
-        `Runtime profile metadata for "${relativePath}" is invalid.`
-      );
-    }
-    manifestEntries.set(relativePath, {
-      kind: entry.kind,
-      hash: entry.hash
-    });
+    );
+    return stdout.split("\n").map((line) => line.trim()).filter((line) => line.length > 0);
+  } catch {
+    return [];
   }
-  return manifestEntries;
 }
-function resolveMergedSnapshotEntries(baseEntries, currentEntries, runtimeEntries) {
-  const mergedEntries = /* @__PURE__ */ new Map();
-  const relativePaths = /* @__PURE__ */ new Set([
-    ...baseEntries.keys(),
-    ...currentEntries.keys(),
-    ...runtimeEntries.keys()
-  ]);
-  for (const relativePath of [...relativePaths].sort(compareSnapshotPaths)) {
-    mergedEntries.set(
-      relativePath,
-      resolveMergedSnapshotEntrySelection(
-        relativePath,
-        baseEntries.get(relativePath) ?? null,
-        currentEntries.get(relativePath) ?? null,
-        runtimeEntries.get(relativePath) ?? null
-      )
+async function listWindowsProcessCommandLines() {
+  const script = [
+    "$processes = Get-CimInstance Win32_Process | Select-Object CommandLine",
+    "$processes | ConvertTo-Json -Compress"
+  ].join("; ");
+  try {
+    const { stdout } = await execFileAsync2(
+      "powershell.exe",
+      ["-NoLogo", "-NoProfile", "-Command", script],
+      {
+        maxBuffer: PROCESS_LIST_MAX_BUFFER_BYTES2
+      }
     );
+    const parsed = JSON.parse(stdout);
+    const records = Array.isArray(parsed) ? parsed : [parsed];
+    return records.map((record) => record?.CommandLine?.trim() ?? "").filter((commandLine) => commandLine.length > 0);
+  } catch {
+    return [];
   }
-  return mergedEntries;
 }
-function resolveMergedSnapshotEntrySelection(relativePath, baseEntry, currentEntry, runtimeEntry) {
-  if (snapshotEntriesEqual(runtimeEntry, baseEntry)) {
-    return currentEntry ? "current" : null;
-  }
-  if (snapshotEntriesEqual(currentEntry, baseEntry)) {
-    return runtimeEntry ? "runtime" : null;
-  }
-  if (!baseEntry) {
-    if (!currentEntry) {
-      return runtimeEntry ? "runtime" : null;
-    }
-    if (!runtimeEntry) {
-      return "current";
-    }
-    if (snapshotEntriesEqual(currentEntry, runtimeEntry)) {
-      return "current";
+function commandLineIncludesUserDataDir(commandLine, userDataDir) {
+  const unquoted = `--user-data-dir=${userDataDir}`;
+  const unquotedIndex = commandLine.indexOf(unquoted);
+  if (unquotedIndex !== -1) {
+    const after = commandLine[unquotedIndex + unquoted.length];
+    if (after === void 0 || after === " " || after === "	") {
+      return true;
     }
-    throw new Error(
-      `Concurrent runtime updates changed "${relativePath}" differently; refusing to overwrite the persistent profile.`
-    );
-  }
-  if (!currentEntry && !runtimeEntry) {
-    return null;
-  }
-  if (snapshotEntriesEqual(currentEntry, runtimeEntry)) {
-    return currentEntry ? "current" : null;
   }
-  throw new Error(
-    `Concurrent runtime updates changed "${relativePath}" differently; refusing to overwrite the persistent profile.`
-  );
+  return [
+    `--user-data-dir="${userDataDir}"`,
+    `--user-data-dir='${userDataDir}'`
+  ].some((candidate) => commandLine.includes(candidate));
+}
+function getErrorCode3(error) {
+  return typeof error === "object" && error !== null && "code" in error && (typeof error.code === "string" || typeof error.code === "number") ? error.code : void 0;
+}
+async function sleep4(ms) {
+  await new Promise((resolve) => setTimeout(resolve, ms));
+}
+
+// src/browser/shared-real-browser-session.ts
+var import_node_crypto4 = require("crypto");
+var import_node_child_process3 = require("child_process");
+var import_promises5 = require("fs/promises");
+var import_node_net = require("net");
+var import_node_path5 = require("path");
+var import_playwright = require("playwright");
+var SHARED_SESSION_RETRY_DELAY_MS2 = 50;
+async function acquireSharedRealBrowserSession(options) {
+  const reservation = await reserveSharedSessionClient(options);
+  const sessionContext = await attachToSharedSession(reservation, options);
+  let closed = false;
+  return {
+    browser: sessionContext.browser,
+    context: sessionContext.context,
+    page: sessionContext.page,
+    close: async () => {
+      if (closed) {
+        return;
+      }
+      closed = true;
+      await releaseSharedSessionClient(sessionContext);
+    }
+  };
 }
-function snapshotEntriesEqual(left, right) {
-  if (!left || !right) {
-    return left === right;
+function getOwnedRealBrowserProcessPolicy(platformName = process.platform) {
+  if (platformName === "win32") {
+    return {
+      detached: false,
+      killStrategy: "taskkill",
+      shouldUnref: true
+    };
   }
-  return left.kind === right.kind && left.hash === right.hash;
+  if (platformName === "darwin") {
+    return {
+      detached: false,
+      killStrategy: "process",
+      shouldUnref: true
+    };
+  }
+  return {
+    detached: true,
+    killStrategy: "process-group",
+    shouldUnref: true
+  };
 }
-async function materializeMergedPersistentProfileSnapshot(targetUserDataDir, currentEntries, runtimeEntries, mergedEntries) {
-  const selectedEntries = [...mergedEntries.entries()].filter(([, selection]) => selection !== null).sort(
-    ([leftPath], [rightPath]) => compareSnapshotPaths(leftPath, rightPath)
-  );
-  for (const [relativePath, selection] of selectedEntries) {
-    const entry = (selection === "current" ? currentEntries.get(relativePath) : runtimeEntries.get(relativePath)) ?? null;
-    if (!entry) {
+async function reserveSharedSessionClient(options) {
+  while (true) {
+    const outcome = await withPersistentProfileControlLock(
+      options.persistentProfile.userDataDir,
+      async () => {
+        if (await isPersistentProfileWriteLocked(
+          options.persistentProfile.userDataDir
+        )) {
+          return { kind: "wait" };
+        }
+        if (await hasActiveRuntimeProfileCreations(
+          options.persistentProfile.userDataDir
+        )) {
+          return { kind: "wait" };
+        }
+        return await withSharedSessionLock(
+          options.persistentProfile.userDataDir,
+          async () => {
+            const state = await inspectSharedSessionState(options);
+            if (state.kind === "wait") {
+              return { kind: "wait" };
+            }
+            if (state.kind === "ready") {
+              return {
+                kind: "ready",
+                reservation: await registerSharedSessionClient(
+                  options.persistentProfile.userDataDir,
+                  state.metadata
+                )
+              };
+            }
+            return {
+              kind: "launch",
+              reservation: await launchSharedSession(options)
+            };
+          }
+        );
+      }
+    );
+    if (outcome.kind === "wait") {
+      await sleep5(SHARED_SESSION_RETRY_DELAY_MS2);
       continue;
     }
-    const targetPath = (0, import_node_path.join)(targetUserDataDir, relativePath);
-    if (entry.kind === "directory") {
-      await (0, import_promises.mkdir)(targetPath, { recursive: true });
-      continue;
+    if (outcome.kind === "ready") {
+      return outcome.reservation;
+    }
+    try {
+      await waitForSharedSessionReady(
+        outcome.reservation.metadata,
+        options.timeoutMs
+      );
+    } catch (error) {
+      await cleanupFailedSharedSessionLaunch(outcome.reservation);
+      throw error;
+    }
+    try {
+      return await withSharedSessionLock(
+        options.persistentProfile.userDataDir,
+        async () => {
+          const metadata = await readSharedSessionMetadata(
+            options.persistentProfile.userDataDir
+          );
+          if (!metadata || metadata.sessionId !== outcome.reservation.metadata.sessionId || !processOwnersEqual(
+            metadata.browserOwner,
+            outcome.reservation.launchedBrowserOwner
+          )) {
+            throw new Error(
+              "The shared real-browser session changed before launch finalized."
+            );
+          }
+          const readyMetadata = {
+            ...metadata,
+            state: "ready"
+          };
+          await writeSharedSessionMetadata(
+            options.persistentProfile.userDataDir,
+            readyMetadata
+          );
+          return await registerSharedSessionClient(
+            options.persistentProfile.userDataDir,
+            readyMetadata
+          );
+        }
+      );
+    } catch (error) {
+      await cleanupFailedSharedSessionLaunch(outcome.reservation);
+      throw error;
     }
-    await (0, import_promises.mkdir)((0, import_node_path.dirname)(targetPath), { recursive: true });
-    await (0, import_promises.copyFile)(entry.sourcePath, targetPath);
-  }
-}
-function compareSnapshotPaths(left, right) {
-  const leftDepth = left.split(import_node_path.sep).length;
-  const rightDepth = right.split(import_node_path.sep).length;
-  if (leftDepth !== rightDepth) {
-    return leftDepth - rightDepth;
   }
-  return left.localeCompare(right);
 }
-async function hashFile(filePath) {
-  return new Promise((resolve, reject) => {
-    const hash = (0, import_node_crypto.createHash)("sha256");
-    const stream = (0, import_node_fs.createReadStream)(filePath);
-    stream.on("data", (chunk) => {
-      hash.update(chunk);
+async function attachToSharedSession(reservation, options) {
+  let browser = null;
+  let page = null;
+  try {
+    const browserWsUrl = await resolveCdpWebSocketUrl(
+      buildSharedSessionDiscoveryUrl(reservation.metadata.debugPort),
+      options.timeoutMs
+    );
+    browser = await import_playwright.chromium.connectOverCDP(browserWsUrl, {
+      timeout: options.timeoutMs
     });
-    stream.on("error", reject);
-    stream.on("end", () => {
-      resolve(hash.digest("hex"));
+    const context = getPrimaryBrowserContext(browser);
+    page = await getSharedSessionPage(context, reservation.reuseExistingPage);
+    if (options.initialUrl) {
+      await page.goto(options.initialUrl, {
+        timeout: options.timeoutMs,
+        waitUntil: "domcontentloaded"
+      });
+    }
+    return {
+      browser,
+      clientId: reservation.client.clientId,
+      context,
+      page,
+      persistentUserDataDir: reservation.metadata.persistentUserDataDir,
+      sessionId: reservation.metadata.sessionId
+    };
+  } catch (error) {
+    if (page) {
+      await page.close().catch(() => void 0);
+    }
+    if (browser) {
+      await browser.close().catch(() => void 0);
+    }
+    await cleanupFailedSharedSessionAttach({
+      clientId: reservation.client.clientId,
+      persistentUserDataDir: reservation.metadata.persistentUserDataDir,
+      sessionId: reservation.metadata.sessionId
     });
-  });
+    throw error;
+  }
 }
-async function ensurePersistentProfileMetadata(userDataDir, metadata) {
-  if ((0, import_node_fs.existsSync)((0, import_node_path.join)(userDataDir, OPENSTEER_META_FILE))) {
+async function releaseSharedSessionClient(context) {
+  const releasePlan = await prepareSharedSessionCloseIfIdle(
+    context.persistentUserDataDir,
+    context.clientId,
+    context.sessionId
+  );
+  if (releasePlan.closeBrowser) {
+    await closeSharedSessionBrowser(
+      context.persistentUserDataDir,
+      releasePlan,
+      context.browser
+    );
     return;
   }
-  await writePersistentProfileMetadata(userDataDir, metadata);
+  await context.page.close().catch(() => void 0);
+  await context.browser.close().catch(() => void 0);
 }
-async function readPersistentProfileMetadata(userDataDir) {
-  try {
-    const raw = await (0, import_promises.readFile)((0, import_node_path.join)(userDataDir, OPENSTEER_META_FILE), "utf8");
-    const parsed = JSON.parse(raw);
-    if (typeof parsed.createdAt !== "string" || typeof parsed.profileDirectory !== "string" || typeof parsed.source !== "string") {
-      return null;
+async function inspectSharedSessionState(options) {
+  const persistentUserDataDir = options.persistentProfile.userDataDir;
+  const liveClients = await listLiveSharedSessionClients(persistentUserDataDir);
+  const metadata = await readSharedSessionMetadata(persistentUserDataDir);
+  if (!metadata) {
+    if (liveClients.length > 0) {
+      throw new Error(
+        `Shared real-browser session metadata for "${persistentUserDataDir}" is missing while clients are still attached.`
+      );
     }
+    await (0, import_promises5.rm)(buildSharedSessionDirPath(persistentUserDataDir), {
+      force: true,
+      recursive: true
+    }).catch(() => void 0);
+    return { kind: "missing" };
+  }
+  assertSharedSessionCompatibility(metadata, options);
+  const browserState = await getProcessLiveness(metadata.browserOwner);
+  if (browserState === "dead") {
+    await (0, import_promises5.rm)(buildSharedSessionDirPath(persistentUserDataDir), {
+      force: true,
+      recursive: true
+    }).catch(() => void 0);
+    return { kind: "missing" };
+  }
+  if (metadata.state === "ready") {
     return {
-      createdAt: parsed.createdAt,
-      profileDirectory: parsed.profileDirectory,
-      source: parsed.source
+      kind: "ready",
+      metadata
     };
-  } catch {
-    return null;
   }
-}
-async function requirePersistentProfileMetadata(userDataDir) {
-  const metadata = await readPersistentProfileMetadata(userDataDir);
-  if (!metadata) {
-    throw new Error(
-      `Persistent profile metadata was not found for "${userDataDir}".`
-    );
+  const stateOwnerState = await getProcessLiveness(metadata.stateOwner);
+  if (stateOwnerState === "dead") {
+    const recoveredMetadata = {
+      ...metadata,
+      state: "ready"
+    };
+    await writeSharedSessionMetadata(persistentUserDataDir, recoveredMetadata);
+    return {
+      kind: "ready",
+      metadata: recoveredMetadata
+    };
   }
-  return metadata;
-}
-function wasDirPublishedByAnotherProcess(error, targetDirPath) {
-  const code = typeof error === "object" && error !== null && "code" in error && typeof error.code === "string" ? error.code : void 0;
-  return (0, import_node_fs.existsSync)(targetDirPath) && (code === "EEXIST" || code === "ENOTEMPTY" || code === "EPERM");
-}
-async function replaceProfileDirectory(targetUserDataDir, replacementUserDataDir) {
-  if (!(0, import_node_fs.existsSync)(targetUserDataDir)) {
-    await (0, import_promises.rename)(replacementUserDataDir, targetUserDataDir);
-    return;
+  return { kind: "wait" };
+}
+async function launchSharedSession(options) {
+  const persistentUserDataDir = options.persistentProfile.userDataDir;
+  await clearPersistentProfileSingletons(persistentUserDataDir);
+  const debugPort = await reserveDebugPort();
+  const launchArgs = buildRealBrowserLaunchArgs({
+    debugPort,
+    headless: options.headless,
+    profileDirectory: options.profileDirectory,
+    userDataDir: persistentUserDataDir
+  });
+  const processPolicy = getOwnedRealBrowserProcessPolicy();
+  const processHandle = (0, import_node_child_process3.spawn)(options.executablePath, launchArgs, {
+    detached: processPolicy.detached,
+    stdio: "ignore"
+  });
+  if (processPolicy.shouldUnref) {
+    processHandle.unref();
   }
-  const backupUserDataDir = buildPersistentProfileBackupDirPath(targetUserDataDir);
-  let targetMovedToBackup = false;
-  let replacementPublished = false;
   try {
-    await (0, import_promises.rename)(targetUserDataDir, backupUserDataDir);
-    targetMovedToBackup = true;
-    await (0, import_promises.rename)(replacementUserDataDir, targetUserDataDir);
-    replacementPublished = true;
+    const browserOwner = await waitForSpawnedProcessOwner(
+      processHandle.pid,
+      options.timeoutMs
+    );
+    const metadata = {
+      browserOwner,
+      createdAt: (/* @__PURE__ */ new Date()).toISOString(),
+      debugPort,
+      executablePath: options.executablePath,
+      headless: options.headless,
+      persistentUserDataDir,
+      profileDirectory: options.profileDirectory,
+      sessionId: (0, import_node_crypto4.randomUUID)(),
+      state: "launching",
+      stateOwner: CURRENT_PROCESS_OWNER
+    };
+    await writeSharedSessionMetadata(persistentUserDataDir, metadata);
+    return {
+      launchedBrowserOwner: browserOwner,
+      metadata
+    };
   } catch (error) {
-    if (targetMovedToBackup && !(0, import_node_fs.existsSync)(targetUserDataDir)) {
-      await (0, import_promises.rename)(backupUserDataDir, targetUserDataDir).catch(() => void 0);
-    }
+    await killSpawnedBrowserProcess(processHandle);
+    await (0, import_promises5.rm)(buildSharedSessionDirPath(persistentUserDataDir), {
+      force: true,
+      recursive: true
+    }).catch(() => void 0);
     throw error;
-  } finally {
-    if (replacementPublished && targetMovedToBackup && (0, import_node_fs.existsSync)(backupUserDataDir)) {
-      await (0, import_promises.rm)(backupUserDataDir, {
-        recursive: true,
-        force: true
-      }).catch(() => void 0);
-    }
   }
 }
-async function withPersistentProfileLock(targetUserDataDir, action) {
-  const lockDirPath = buildPersistentProfileLockDirPath(targetUserDataDir);
-  await (0, import_promises.mkdir)((0, import_node_path.dirname)(lockDirPath), { recursive: true });
-  while (true) {
-    const tempLockDirPath = `${lockDirPath}-${process.pid}-${PROCESS_STARTED_AT_MS}-${(0, import_node_crypto.randomUUID)()}`;
-    try {
-      await (0, import_promises.mkdir)(tempLockDirPath);
-      await writeLockOwner(tempLockDirPath, CURRENT_PROCESS_LOCK_OWNER);
-      try {
-        await (0, import_promises.rename)(tempLockDirPath, lockDirPath);
-        break;
-      } catch (error) {
-        if (!wasDirPublishedByAnotherProcess(error, lockDirPath)) {
-          throw error;
+async function cleanupFailedSharedSessionLaunch(reservation) {
+  const shouldPreserveLiveBrowser = await withSharedSessionLock(
+    reservation.metadata.persistentUserDataDir,
+    async () => {
+      const metadata = await readSharedSessionMetadata(
+        reservation.metadata.persistentUserDataDir
+      );
+      if (metadata && metadata.sessionId === reservation.metadata.sessionId && processOwnersEqual(
+        metadata.browserOwner,
+        reservation.launchedBrowserOwner
+      )) {
+        if (await getProcessLiveness(metadata.browserOwner) !== "dead") {
+          const readyMetadata = {
+            ...metadata,
+            state: "ready"
+          };
+          await writeSharedSessionMetadata(
+            reservation.metadata.persistentUserDataDir,
+            readyMetadata
+          );
+          return true;
         }
+        await (0, import_promises5.rm)(
+          buildSharedSessionDirPath(
+            reservation.metadata.persistentUserDataDir
+          ),
+          {
+            force: true,
+            recursive: true
+          }
+        ).catch(() => void 0);
       }
-    } finally {
-      await (0, import_promises.rm)(tempLockDirPath, {
-        recursive: true,
-        force: true
-      }).catch(() => void 0);
-    }
-    const owner = await readLockOwner(lockDirPath);
-    if ((!owner || await getProcessLiveness(owner) === "dead") && await tryReclaimStaleLock(lockDirPath, owner)) {
-      continue;
+      return false;
     }
-    await sleep(PROFILE_LOCK_RETRY_DELAY_MS);
-  }
-  try {
-    return await action();
-  } finally {
-    await (0, import_promises.rm)(lockDirPath, {
-      recursive: true,
-      force: true
-    }).catch(() => void 0);
+  );
+  if (shouldPreserveLiveBrowser) {
+    return;
   }
+  await killOwnedBrowserProcess(reservation.launchedBrowserOwner);
+  await waitForProcessToExit(reservation.launchedBrowserOwner, 2e3);
 }
-async function writeLockOwner(lockDirPath, owner) {
-  await writeLockParticipant((0, import_node_path.join)(lockDirPath, LOCK_OWNER_FILE), owner);
-}
-async function readLockOwner(lockDirPath) {
-  return await readLockParticipant((0, import_node_path.join)(lockDirPath, LOCK_OWNER_FILE));
-}
-async function writeLockParticipant(filePath, owner, options) {
-  await (0, import_promises.writeFile)(filePath, JSON.stringify(owner), options);
-}
-async function readLockParticipant(filePath) {
-  return (await readLockParticipantRecord(filePath)).owner;
+async function cleanupFailedSharedSessionAttach(options) {
+  const closePlan = await prepareSharedSessionCloseIfIdle(
+    options.persistentUserDataDir,
+    options.clientId,
+    options.sessionId
+  );
+  if (!closePlan.closeBrowser) {
+    return;
+  }
+  await closeSharedSessionBrowser(options.persistentUserDataDir, closePlan);
 }
-async function readLockReclaimerRecord(lockDirPath) {
-  return await readLockParticipantRecord(
-    (0, import_node_path.join)(buildLockReclaimerDirPath(lockDirPath), LOCK_OWNER_FILE)
+async function waitForSharedSessionReady(metadata, timeoutMs) {
+  await resolveCdpWebSocketUrl(
+    buildSharedSessionDiscoveryUrl(metadata.debugPort),
+    timeoutMs
   );
 }
-async function readLockParticipantRecord(filePath) {
-  try {
-    const raw = await (0, import_promises.readFile)(filePath, "utf8");
-    const parsed = JSON.parse(raw);
-    const pid = Number(parsed.pid);
-    const processStartedAtMs = Number(parsed.processStartedAtMs);
-    if (!Number.isInteger(pid) || !Number.isInteger(processStartedAtMs)) {
-      return {
-        exists: true,
-        owner: null
-      };
-    }
-    return {
-      exists: true,
-      owner: {
-        pid,
-        processStartedAtMs
-      }
-    };
-  } catch (error) {
-    return {
-      exists: getErrorCode(error) !== "ENOENT",
-      owner: null
-    };
+function buildRealBrowserLaunchArgs(options) {
+  const args = [
+    `--user-data-dir=${options.userDataDir}`,
+    `--profile-directory=${options.profileDirectory}`,
+    `--remote-debugging-port=${options.debugPort}`,
+    "--disable-blink-features=AutomationControlled"
+  ];
+  if (options.headless) {
+    args.push("--headless=new");
   }
+  return args;
 }
-async function tryReclaimStaleLock(lockDirPath, expectedOwner) {
-  if (!await tryAcquireLockReclaimer(lockDirPath)) {
-    return false;
-  }
-  let reclaimed = false;
+async function requestBrowserShutdown(browser) {
+  let session = null;
   try {
-    const owner = await readLockOwner(lockDirPath);
-    if (!lockOwnersEqual(owner, expectedOwner)) {
-      return false;
-    }
-    if (owner && await getProcessLiveness(owner) !== "dead") {
-      return false;
-    }
-    await (0, import_promises.rm)(lockDirPath, {
-      recursive: true,
-      force: true
-    }).catch(() => void 0);
-    reclaimed = !(0, import_node_fs.existsSync)(lockDirPath);
-    return reclaimed;
+    session = await browser.newBrowserCDPSession();
+    await session.send("Browser.close");
+  } catch {
   } finally {
-    if (!reclaimed) {
-      await (0, import_promises.rm)(buildLockReclaimerDirPath(lockDirPath), {
-        recursive: true,
-        force: true
-      }).catch(() => void 0);
-    }
+    await session?.detach().catch(() => void 0);
+  }
+}
+async function killOwnedBrowserProcess(owner) {
+  if (await getProcessLiveness(owner) === "dead") {
+    return;
+  }
+  await killOwnedBrowserProcessByPid(owner.pid);
+}
+async function killSpawnedBrowserProcess(processHandle) {
+  const pid = processHandle.pid;
+  if (!pid || processHandle.exitCode !== null) {
+    return;
+  }
+  await killOwnedBrowserProcessByPid(pid);
+  await waitForPidToExit(pid, 2e3);
+}
+async function killOwnedBrowserProcessByPid(pid) {
+  const processPolicy = getOwnedRealBrowserProcessPolicy();
+  if (processPolicy.killStrategy === "taskkill") {
+    await new Promise((resolve) => {
+      const killer = (0, import_node_child_process3.spawn)(
+        "taskkill",
+        ["/pid", String(pid), "/t", "/f"],
+        {
+          stdio: "ignore"
+        }
+      );
+      killer.on("error", () => resolve());
+      killer.on("exit", () => resolve());
+    });
+    return;
   }
-}
-async function tryAcquireLockReclaimer(lockDirPath) {
-  const reclaimerDirPath = buildLockReclaimerDirPath(lockDirPath);
-  while (true) {
-    const tempReclaimerDirPath = `${reclaimerDirPath}-${process.pid}-${PROCESS_STARTED_AT_MS}-${(0, import_node_crypto.randomUUID)()}`;
+  if (processPolicy.killStrategy === "process-group") {
     try {
-      await (0, import_promises.mkdir)(tempReclaimerDirPath);
-      await writeLockOwner(tempReclaimerDirPath, CURRENT_PROCESS_LOCK_OWNER);
-      try {
-        await (0, import_promises.rename)(tempReclaimerDirPath, reclaimerDirPath);
-        return true;
-      } catch (error) {
-        if (getErrorCode(error) === "ENOENT") {
-          return false;
-        }
-        if (!wasDirPublishedByAnotherProcess(error, reclaimerDirPath)) {
-          throw error;
-        }
-      }
-    } catch (error) {
-      const code = getErrorCode(error);
-      if (code === "ENOENT") {
-        return false;
-      }
-      throw error;
-    } finally {
-      await (0, import_promises.rm)(tempReclaimerDirPath, {
-        recursive: true,
-        force: true
-      }).catch(() => void 0);
-    }
-    const reclaimerRecord = await readLockReclaimerRecord(lockDirPath);
-    if (!reclaimerRecord.exists || !reclaimerRecord.owner) {
-      return false;
+      process.kill(-pid, "SIGKILL");
+      return;
+    } catch {
     }
-    if (await getProcessLiveness(reclaimerRecord.owner) !== "dead") {
-      return false;
+  }
+  try {
+    process.kill(pid, "SIGKILL");
+  } catch {
+  }
+}
+async function waitForProcessToExit(owner, timeoutMs) {
+  const deadline = Date.now() + timeoutMs;
+  while (Date.now() < deadline) {
+    if (await getProcessLiveness(owner) === "dead") {
+      return;
     }
-    await (0, import_promises.rm)(reclaimerDirPath, {
-      recursive: true,
-      force: true
-    }).catch(() => void 0);
+    await sleep5(50);
   }
 }
-function lockOwnersEqual(left, right) {
-  if (!left || !right) {
-    return left === right;
+async function waitForPidToExit(pid, timeoutMs) {
+  const deadline = Date.now() + timeoutMs;
+  while (Date.now() < deadline) {
+    if (!isProcessRunning(pid)) {
+      return;
+    }
+    await sleep5(50);
   }
-  return left.pid === right.pid && left.processStartedAtMs === right.processStartedAtMs;
 }
-async function getProcessLiveness(owner) {
-  if (owner.pid === process.pid && hasMatchingProcessStartTime(
-    owner.processStartedAtMs,
-    PROCESS_STARTED_AT_MS
-  )) {
-    return "live";
+async function waitForSpawnedProcessOwner(pid, timeoutMs) {
+  if (!pid || pid <= 0) {
+    throw new Error("Chrome did not expose a child process id.");
   }
-  const startedAtMs = await readProcessStartedAtMs(owner.pid);
-  if (typeof startedAtMs === "number") {
-    return hasMatchingProcessStartTime(
-      owner.processStartedAtMs,
-      startedAtMs
-    ) ? "live" : "dead";
+  const deadline = Date.now() + timeoutMs;
+  while (Date.now() < deadline) {
+    const owner = await readProcessOwner(pid);
+    if (owner) {
+      return owner;
+    }
+    await sleep5(50);
   }
-  return isProcessRunning(owner.pid) ? "unknown" : "dead";
-}
-function hasMatchingProcessStartTime(expectedStartedAtMs, actualStartedAtMs) {
-  return Math.abs(expectedStartedAtMs - actualStartedAtMs) <= PROCESS_START_TIME_TOLERANCE_MS;
-}
-function buildPersistentProfileTempDirPrefix(targetUserDataDir) {
-  return (0, import_node_path.join)(
-    (0, import_node_path.dirname)(targetUserDataDir),
-    `${buildPersistentProfileTempDirNamePrefix(targetUserDataDir)}${process.pid}-${PROCESS_STARTED_AT_MS}-`
+  throw new Error(
+    `Chrome process ${pid} did not report a stable process start time.`
   );
 }
-function buildPersistentProfileTempDirNamePrefix(targetUserDataDir) {
-  return `${(0, import_node_path.basename)(targetUserDataDir)}-tmp-`;
-}
-function buildPersistentProfileBackupDirPath(targetUserDataDir) {
-  return (0, import_node_path.join)(
-    (0, import_node_path.dirname)(targetUserDataDir),
-    `${buildPersistentProfileTempDirNamePrefix(targetUserDataDir)}${process.pid}-${PROCESS_STARTED_AT_MS}-backup-${Date.now()}`
+async function withSharedSessionLock(persistentUserDataDir, action) {
+  return await withDirLock(
+    buildSharedSessionLockPath(persistentUserDataDir),
+    action
   );
 }
-function buildPersistentProfileLockDirPath(targetUserDataDir) {
-  return (0, import_node_path.join)((0, import_node_path.dirname)(targetUserDataDir), `${(0, import_node_path.basename)(targetUserDataDir)}.lock`);
-}
-function buildLockReclaimerDirPath(lockDirPath) {
-  return (0, import_node_path.join)(lockDirPath, LOCK_RECLAIMER_DIR);
-}
-function buildRuntimeProfileKey(sourceUserDataDir) {
-  const hash = (0, import_node_crypto.createHash)("sha256").update(sourceUserDataDir).digest("hex").slice(0, 16);
-  return `${sanitizePathSegment((0, import_node_path.basename)(sourceUserDataDir) || "profile")}-${hash}`;
-}
-function buildRuntimeProfileDirNamePrefix(sourceUserDataDir) {
-  return `${buildRuntimeProfileKey(sourceUserDataDir)}-runtime-`;
-}
-function buildRuntimeProfileDirPrefix(runtimesRootDir, sourceUserDataDir) {
-  return (0, import_node_path.join)(
-    runtimesRootDir,
-    `${buildRuntimeProfileDirNamePrefix(sourceUserDataDir)}${process.pid}-${PROCESS_STARTED_AT_MS}-`
+async function registerSharedSessionClient(persistentUserDataDir, metadata) {
+  const liveClients = await listLiveSharedSessionClients(persistentUserDataDir);
+  const client = buildSharedSessionClientRegistration();
+  await (0, import_promises5.mkdir)(buildSharedSessionClientsDirPath(persistentUserDataDir), {
+    recursive: true
+  });
+  await (0, import_promises5.writeFile)(
+    buildSharedSessionClientPath(persistentUserDataDir, client.clientId),
+    JSON.stringify(client, null, 2),
+    {
+      flag: "wx"
+    }
   );
+  return {
+    client,
+    metadata,
+    reuseExistingPage: liveClients.length === 0
+  };
 }
-async function cleanOrphanedOwnedDirs(rootDir, ownedDirNamePrefix) {
+async function removeSharedSessionClientRegistration(persistentUserDataDir, clientId) {
+  await (0, import_promises5.rm)(buildSharedSessionClientPath(persistentUserDataDir, clientId), {
+    force: true
+  }).catch(() => void 0);
+}
+async function listLiveSharedSessionClients(persistentUserDataDir) {
+  const clientsDirPath = buildSharedSessionClientsDirPath(persistentUserDataDir);
   let entries;
   try {
-    entries = await (0, import_promises.readdir)(rootDir, {
+    entries = await (0, import_promises5.readdir)(clientsDirPath, {
       encoding: "utf8",
       withFileTypes: true
     });
   } catch {
-    return;
+    return [];
   }
-  await Promise.all(
-    entries.map(async (entry) => {
-      if (!entry.isDirectory() || !entry.name.startsWith(ownedDirNamePrefix)) {
-        return;
-      }
-      if (await isOwnedDirByLiveProcess(entry.name, ownedDirNamePrefix)) {
-        return;
-      }
-      await (0, import_promises.rm)((0, import_node_path.join)(rootDir, entry.name), {
-        recursive: true,
-        force: true
-      }).catch(() => void 0);
-    })
-  );
-}
-async function isOwnedDirByLiveProcess(ownedDirName, ownedDirPrefix) {
-  const owner = parseOwnedDirOwner(ownedDirName, ownedDirPrefix);
-  return owner ? await getProcessLiveness(owner) !== "dead" : false;
+  const liveClients = [];
+  for (const entry of entries) {
+    if (!entry.isFile()) {
+      continue;
+    }
+    const filePath = (0, import_node_path5.join)(clientsDirPath, entry.name);
+    const registration = await readSharedSessionClientRegistration(filePath);
+    if (!registration) {
+      await (0, import_promises5.rm)(filePath, { force: true }).catch(() => void 0);
+      continue;
+    }
+    if (await getProcessLiveness(registration.owner) === "dead") {
+      await (0, import_promises5.rm)(filePath, { force: true }).catch(() => void 0);
+      continue;
+    }
+    liveClients.push(registration);
+  }
+  return liveClients;
 }
-function parseOwnedDirOwner(ownedDirName, ownedDirPrefix) {
-  const remainder = ownedDirName.slice(ownedDirPrefix.length);
-  const firstDashIndex = remainder.indexOf("-");
-  const secondDashIndex = firstDashIndex === -1 ? -1 : remainder.indexOf("-", firstDashIndex + 1);
-  if (firstDashIndex === -1 || secondDashIndex === -1) {
+async function readSharedSessionClientRegistration(filePath) {
+  try {
+    const raw = await (0, import_promises5.readFile)(filePath, "utf8");
+    return parseSharedSessionClientRegistration(JSON.parse(raw));
+  } catch {
     return null;
   }
-  const pid = Number.parseInt(remainder.slice(0, firstDashIndex), 10);
-  const processStartedAtMs = Number.parseInt(
-    remainder.slice(firstDashIndex + 1, secondDashIndex),
-    10
-  );
-  if (!Number.isInteger(pid) || pid <= 0) {
+}
+function buildSharedSessionClientRegistration() {
+  return {
+    clientId: (0, import_node_crypto4.randomUUID)(),
+    createdAt: (/* @__PURE__ */ new Date()).toISOString(),
+    owner: CURRENT_PROCESS_OWNER
+  };
+}
+function parseSharedSessionClientRegistration(value) {
+  if (!value || typeof value !== "object") {
     return null;
   }
-  if (!Number.isInteger(processStartedAtMs) || processStartedAtMs <= 0) {
+  const parsed = value;
+  const owner = parseProcessOwner(parsed.owner);
+  if (!owner || typeof parsed.clientId !== "string" || typeof parsed.createdAt !== "string") {
     return null;
   }
-  return { pid, processStartedAtMs };
+  return {
+    clientId: parsed.clientId,
+    createdAt: parsed.createdAt,
+    owner
+  };
 }
-function isProcessRunning(pid) {
-  try {
-    process.kill(pid, 0);
-    return true;
-  } catch (error) {
-    const code = typeof error === "object" && error !== null && "code" in error && typeof error.code === "string" ? error.code : void 0;
-    return code !== "ESRCH";
+function assertSharedSessionCompatibility(metadata, options) {
+  if (metadata.executablePath !== options.executablePath) {
+    throw new Error(
+      `Chrome profile "${options.profileDirectory}" is already running with executable "${metadata.executablePath}", not "${options.executablePath}".`
+    );
   }
-}
-async function readProcessStartedAtMs(pid) {
-  if (pid <= 0) {
-    return null;
+  if (metadata.headless !== options.headless) {
+    throw new Error(
+      `Chrome profile "${options.profileDirectory}" is already running with headless=${metadata.headless}, not ${options.headless}.`
+    );
   }
-  if (process.platform === "linux") {
-    return await readLinuxProcessStartedAtMs(pid);
+}
+async function prepareSharedSessionCloseIfIdle(persistentUserDataDir, clientId, sessionId) {
+  return await withSharedSessionLock(persistentUserDataDir, async () => {
+    const metadata = await readSharedSessionMetadata(persistentUserDataDir);
+    await removeSharedSessionClientRegistration(
+      persistentUserDataDir,
+      clientId
+    );
+    if (!metadata || metadata.sessionId !== sessionId) {
+      return {
+        closeBrowser: false,
+        sessionId
+      };
+    }
+    const liveClients = await listLiveSharedSessionClients(
+      persistentUserDataDir
+    );
+    if (liveClients.length > 0) {
+      return {
+        closeBrowser: false,
+        sessionId: metadata.sessionId
+      };
+    }
+    const closingMetadata = {
+      ...metadata,
+      state: "closing",
+      stateOwner: CURRENT_PROCESS_OWNER
+    };
+    await writeSharedSessionMetadata(
+      persistentUserDataDir,
+      closingMetadata
+    );
+    return {
+      browserOwner: closingMetadata.browserOwner,
+      closeBrowser: true,
+      sessionId: closingMetadata.sessionId
+    };
+  });
+}
+async function closeSharedSessionBrowser(persistentUserDataDir, closePlan, browser) {
+  if (browser) {
+    await requestBrowserShutdown(browser);
+    await waitForProcessToExit(closePlan.browserOwner, 1e3);
   }
-  if (process.platform === "win32") {
-    return await readWindowsProcessStartedAtMs(pid);
+  if (await getProcessLiveness(closePlan.browserOwner) !== "dead") {
+    await killOwnedBrowserProcess(closePlan.browserOwner);
+    await waitForProcessToExit(closePlan.browserOwner, 2e3);
   }
-  return await readPsProcessStartedAtMs(pid);
+  await finalizeSharedSessionClose(persistentUserDataDir, closePlan.sessionId);
 }
-async function readLinuxProcessStartedAtMs(pid) {
-  let statRaw;
-  try {
-    statRaw = await (0, import_promises.readFile)(`/proc/${pid}/stat`, "utf8");
-  } catch (error) {
-    return null;
-  }
-  const startTicks = parseLinuxProcessStartTicks(statRaw);
-  if (startTicks === null) {
-    return null;
+async function finalizeSharedSessionClose(persistentUserDataDir, sessionId) {
+  await withSharedSessionLock(persistentUserDataDir, async () => {
+    const metadata = await readSharedSessionMetadata(persistentUserDataDir);
+    if (!metadata || metadata.sessionId !== sessionId) {
+      return;
+    }
+    const liveClients = await listLiveSharedSessionClients(
+      persistentUserDataDir
+    );
+    if (liveClients.length > 0) {
+      const readyMetadata = {
+        ...metadata,
+        state: "ready"
+      };
+      await writeSharedSessionMetadata(
+        persistentUserDataDir,
+        readyMetadata
+      );
+      return;
+    }
+    if (await getProcessLiveness(metadata.browserOwner) !== "dead") {
+      const readyMetadata = {
+        ...metadata,
+        state: "ready"
+      };
+      await writeSharedSessionMetadata(
+        persistentUserDataDir,
+        readyMetadata
+      );
+      return;
+    }
+    await (0, import_promises5.rm)(buildSharedSessionDirPath(persistentUserDataDir), {
+      force: true,
+      recursive: true
+    }).catch(() => void 0);
+  });
+}
+function getPrimaryBrowserContext(browser) {
+  const contexts = browser.contexts();
+  if (contexts.length === 0) {
+    throw new Error(
+      "Connection succeeded but no browser contexts were exposed."
+    );
   }
-  const [bootTimeMs, clockTicksPerSecond] = await Promise.all([
-    readLinuxBootTimeMs(),
-    readLinuxClockTicksPerSecond()
-  ]);
-  if (bootTimeMs === null || clockTicksPerSecond === null) {
-    return null;
+  return contexts[0];
+}
+async function getSharedSessionPage(context, reuseExistingPage) {
+  if (reuseExistingPage) {
+    return await getExistingPageOrCreate(context);
   }
-  return Math.floor(
-    bootTimeMs + startTicks * 1e3 / clockTicksPerSecond
-  );
+  return await context.newPage();
 }
-function parseLinuxProcessStartTicks(statRaw) {
-  const closingParenIndex = statRaw.lastIndexOf(")");
-  if (closingParenIndex === -1) {
-    return null;
+async function getExistingPageOrCreate(context) {
+  const existingPage = context.pages()[0];
+  if (existingPage) {
+    return existingPage;
   }
-  const fields = statRaw.slice(closingParenIndex + 2).trim().split(/\s+/);
-  const startTicks = Number(fields[LINUX_STAT_START_TIME_FIELD_INDEX]);
-  return Number.isFinite(startTicks) && startTicks >= 0 ? startTicks : null;
+  return await context.newPage();
 }
-async function readLinuxBootTimeMs() {
-  try {
-    const statRaw = await (0, import_promises.readFile)("/proc/stat", "utf8");
-    const bootTimeLine = statRaw.split("\n").find((line) => line.startsWith("btime "));
-    if (!bootTimeLine) {
-      return null;
+function buildSharedSessionDiscoveryUrl(debugPort) {
+  return `http://127.0.0.1:${debugPort}`;
+}
+async function resolveCdpWebSocketUrl(cdpUrl, timeoutMs) {
+  if (cdpUrl.startsWith("ws://") || cdpUrl.startsWith("wss://")) {
+    return cdpUrl;
+  }
+  const versionUrl = normalizeDiscoveryUrl(cdpUrl);
+  const deadline = Date.now() + timeoutMs;
+  let lastError = "CDP discovery did not respond.";
+  while (Date.now() < deadline) {
+    const remaining = Math.max(deadline - Date.now(), 1e3);
+    try {
+      const response = await fetch(versionUrl, {
+        signal: AbortSignal.timeout(Math.min(remaining, 5e3))
+      });
+      if (!response.ok) {
+        lastError = `${response.status} ${response.statusText}`;
+      } else {
+        const payload = await response.json();
+        const wsUrl = payload && typeof payload === "object" && !Array.isArray(payload) && typeof payload.webSocketDebuggerUrl === "string" ? payload.webSocketDebuggerUrl : null;
+        if (wsUrl && wsUrl.trim()) {
+          return wsUrl;
+        }
+        lastError = "CDP discovery response did not include webSocketDebuggerUrl.";
+      }
+    } catch (error) {
+      lastError = error instanceof Error ? error.message : "Unknown error";
     }
-    const bootTimeSeconds = Number.parseInt(
-      bootTimeLine.slice("btime ".length),
-      10
-    );
-    return Number.isFinite(bootTimeSeconds) ? bootTimeSeconds * 1e3 : null;
-  } catch {
-    return null;
+    await sleep5(100);
   }
-}
-async function readLinuxClockTicksPerSecond() {
-  linuxClockTicksPerSecondPromise ??= execFileAsync(
-    "getconf",
-    ["CLK_TCK"]
-  ).then(
-    ({ stdout }) => {
-      const value = Number.parseInt(stdout.trim(), 10);
-      return Number.isFinite(value) && value > 0 ? value : null;
-    },
-    () => null
+  throw new Error(
+    `Failed to resolve a CDP websocket URL from ${versionUrl.toString()}: ${lastError}`
   );
-  return await linuxClockTicksPerSecondPromise;
 }
-async function readPsProcessStartedAtMs(pid) {
+function normalizeDiscoveryUrl(cdpUrl) {
+  let parsed;
   try {
-    const { stdout } = await execFileAsync(
-      "ps",
-      ["-p", String(pid), "-o", "lstart="],
-      { env: PS_COMMAND_ENV }
+    parsed = new URL(cdpUrl);
+  } catch {
+    throw new Error(
+      `Invalid CDP URL "${cdpUrl}". Use an http(s) or ws(s) endpoint.`
     );
-    return parsePsStartedAtMs(stdout);
-  } catch (error) {
-    return null;
   }
-}
-function parsePsStartedAtMs(stdout) {
-  const raw = stdout.trim();
-  if (!raw) {
-    return null;
+  if (parsed.protocol === "ws:" || parsed.protocol === "wss:") {
+    return parsed;
   }
-  const startedAtMs = Date.parse(raw);
-  return Number.isNaN(startedAtMs) ? null : startedAtMs;
-}
-async function readWindowsProcessStartedAtMs(pid) {
-  const script = [
-    "$process = Get-Process -Id " + String(pid) + " -ErrorAction SilentlyContinue",
-    "if ($null -eq $process) { exit 3 }",
-    '$process.StartTime.ToUniversalTime().ToString("o")'
-  ].join("; ");
-  try {
-    const { stdout } = await execFileAsync(
-      "powershell.exe",
-      ["-NoLogo", "-NoProfile", "-Command", script]
+  if (parsed.protocol !== "http:" && parsed.protocol !== "https:") {
+    throw new Error(
+      `Unsupported CDP URL protocol "${parsed.protocol}". Use http(s) or ws(s).`
     );
-    return parsePsStartedAtMs(stdout);
-  } catch (error) {
-    return null;
   }
+  const normalized = new URL(parsed.toString());
+  normalized.pathname = "/json/version";
+  normalized.search = "";
+  normalized.hash = "";
+  return normalized;
 }
-function getErrorCode(error) {
-  return typeof error === "object" && error !== null && "code" in error && (typeof error.code === "string" || typeof error.code === "number") ? error.code : void 0;
+async function reserveDebugPort() {
+  return await new Promise((resolve, reject) => {
+    const server = (0, import_node_net.createServer)();
+    server.unref();
+    server.on("error", reject);
+    server.listen(0, "127.0.0.1", () => {
+      const address = server.address();
+      if (!address || typeof address === "string") {
+        server.close();
+        reject(new Error("Failed to reserve a local debug port."));
+        return;
+      }
+      server.close((error) => {
+        if (error) {
+          reject(error);
+          return;
+        }
+        resolve(address.port);
+      });
+    });
+  });
 }
-async function sleep(ms) {
+async function sleep5(ms) {
   await new Promise((resolve) => setTimeout(resolve, ms));
 }
 
 // src/browser/pool.ts
 var BrowserPool = class {
   browser = null;
-  cdpProxy = null;
-  launchedProcess = null;
-  managedRuntimeProfile = null;
+  activeSessionClose = null;
+  closeInFlight = null;
   defaults;
   constructor(defaults = {}) {
     this.defaults = defaults;
   }
   async launch(options = {}) {
-    if (this.browser || this.cdpProxy || this.launchedProcess || this.managedRuntimeProfile) {
+    if (this.browser || this.activeSessionClose) {
       await this.close();
     }
     const mode = options.mode ?? this.defaults.mode ?? "chromium";
@@ -2131,30 +3710,26 @@ var BrowserPool = class {
     return this.launchSandbox(options);
   }
   async close() {
-    const browser = this.browser;
-    const cdpProxy = this.cdpProxy;
-    const launchedProcess = this.launchedProcess;
-    const managedRuntimeProfile = this.managedRuntimeProfile;
-    this.browser = null;
-    this.cdpProxy = null;
-    this.launchedProcess = null;
+    if (this.closeInFlight) {
+      await this.closeInFlight;
+      return;
+    }
+    const closeOperation = this.closeCurrent();
+    this.closeInFlight = closeOperation;
     try {
-      if (browser) {
-        await browser.close().catch(() => void 0);
-      }
+      await closeOperation;
+      this.browser = null;
+      this.activeSessionClose = null;
     } finally {
-      cdpProxy?.close();
-      await killProcessTree(launchedProcess);
-      if (managedRuntimeProfile) {
-        await persistIsolatedRuntimeProfile(
-          managedRuntimeProfile.userDataDir,
-          managedRuntimeProfile.persistentUserDataDir
-        );
-        if (this.managedRuntimeProfile === managedRuntimeProfile) {
-          this.managedRuntimeProfile = null;
-        }
-      }
+      this.closeInFlight = null;
+    }
+  }
+  async closeCurrent() {
+    if (this.activeSessionClose) {
+      await this.activeSessionClose();
+      return;
     }
+    await this.browser?.close().catch(() => void 0);
   }
   async connectToRunning(cdpUrl, timeout) {
     let browser = null;
@@ -2169,11 +3744,14 @@ var BrowserPool = class {
       }
       cdpProxy = new CDPProxy(browserWsUrl, targetId);
       const proxyWsUrl = await cdpProxy.start();
-      browser = await import_playwright.chromium.connectOverCDP(proxyWsUrl, {
+      browser = await import_playwright2.chromium.connectOverCDP(proxyWsUrl, {
         timeout: timeout ?? 3e4
       });
       this.browser = browser;
-      this.cdpProxy = cdpProxy;
+      this.activeSessionClose = async () => {
+        await browser?.close().catch(() => void 0);
+        cdpProxy?.close();
+      };
       const { context, page } = await pickBrowserContextAndPage(browser);
       return { browser, context, page, isExternal: true };
     } catch (error) {
@@ -2182,7 +3760,7 @@ var BrowserPool = class {
       }
       cdpProxy?.close();
       this.browser = null;
-      this.cdpProxy = null;
+      this.activeSessionClose = null;
       throw error;
     }
   }
@@ -2202,60 +3780,29 @@ var BrowserPool = class {
       sourceUserDataDir,
       profileDirectory
     );
-    const runtimeProfile = await createIsolatedRuntimeProfile(
-      persistentProfile.userDataDir
-    );
-    const debugPort = await reserveDebugPort();
-    const headless = resolveLaunchHeadless(
-      "real",
-      options.headless,
-      this.defaults.headless
-    );
-    const launchArgs = buildRealBrowserLaunchArgs({
-      userDataDir: runtimeProfile.userDataDir,
+    const sharedSession = await acquireSharedRealBrowserSession({
+      executablePath,
+      headless: resolveLaunchHeadless(
+        "real",
+        options.headless,
+        this.defaults.headless
+      ),
+      initialUrl: options.initialUrl,
+      persistentProfile,
       profileDirectory,
-      debugPort,
-      headless
+      timeoutMs: options.timeout ?? 3e4
     });
-    const processHandle = (0, import_node_child_process2.spawn)(executablePath, launchArgs, {
-      detached: process.platform !== "win32",
-      stdio: "ignore"
-    });
-    processHandle.unref();
-    let browser = null;
-    try {
-      const wsUrl = await resolveCdpWebSocketUrl(
-        `http://127.0.0.1:${debugPort}`,
-        options.timeout ?? 3e4
-      );
-      browser = await import_playwright.chromium.connectOverCDP(wsUrl, {
-        timeout: options.timeout ?? 3e4
-      });
-      const { context, page } = await createOwnedBrowserContextAndPage(
-        browser
-      );
-      if (options.initialUrl) {
-        await page.goto(options.initialUrl, {
-          waitUntil: "domcontentloaded",
-          timeout: options.timeout ?? 3e4
-        });
-      }
-      this.browser = browser;
-      this.launchedProcess = processHandle;
-      this.managedRuntimeProfile = runtimeProfile;
-      return { browser, context, page, isExternal: false };
-    } catch (error) {
-      await browser?.close().catch(() => void 0);
-      await killProcessTree(processHandle);
-      await (0, import_promises2.rm)(runtimeProfile.userDataDir, {
-        recursive: true,
-        force: true
-      }).catch(() => void 0);
-      throw error;
-    }
+    this.browser = sharedSession.browser;
+    this.activeSessionClose = sharedSession.close;
+    return {
+      browser: sharedSession.browser,
+      context: sharedSession.context,
+      page: sharedSession.page,
+      isExternal: false
+    };
   }
   async launchSandbox(options) {
-    const browser = await import_playwright.chromium.launch({
+    const browser = await import_playwright2.chromium.launch({
       headless: resolveLaunchHeadless(
         "chromium",
         options.headless,
@@ -2268,11 +3815,14 @@ var BrowserPool = class {
     const context = await browser.newContext(options.context || {});
     const page = await context.newPage();
     this.browser = browser;
+    this.activeSessionClose = async () => {
+      await browser.close().catch(() => void 0);
+    };
     return { browser, context, page, isExternal: false };
   }
 };
 async function pickBrowserContextAndPage(browser) {
-  const context = getPrimaryBrowserContext(browser);
+  const context = getPrimaryBrowserContext2(browser);
   const page = await getAttachedPageOrCreate(context);
   return { context, page };
 }
@@ -2285,11 +3835,6 @@ function resolveLaunchHeadless(mode, requestedHeadless, defaultHeadless) {
   }
   return mode === "real";
 }
-async function createOwnedBrowserContextAndPage(browser) {
-  const context = getPrimaryBrowserContext(browser);
-  const page = await getExistingPageOrCreate(context);
-  return { context, page };
-}
 async function getAttachedPageOrCreate(context) {
   const pages = context.pages();
   const inspectablePage = pages.find(
@@ -2304,14 +3849,7 @@ async function getAttachedPageOrCreate(context) {
   }
   return await context.newPage();
 }
-async function getExistingPageOrCreate(context) {
-  const existingPage = context.pages()[0];
-  if (existingPage) {
-    return existingPage;
-  }
-  return await context.newPage();
-}
-function getPrimaryBrowserContext(browser) {
+function getPrimaryBrowserContext2(browser) {
   const contexts = browser.contexts();
   if (contexts.length === 0) {
     throw new Error(
@@ -2330,125 +3868,6 @@ function safePageUrl(page) {
     return "";
   }
 }
-function normalizeDiscoveryUrl(cdpUrl) {
-  let parsed;
-  try {
-    parsed = new URL(cdpUrl);
-  } catch {
-    throw new Error(
-      `Invalid CDP URL "${cdpUrl}". Use an http(s) or ws(s) endpoint.`
-    );
-  }
-  if (parsed.protocol === "ws:" || parsed.protocol === "wss:") {
-    return parsed;
-  }
-  if (parsed.protocol !== "http:" && parsed.protocol !== "https:") {
-    throw new Error(
-      `Unsupported CDP URL protocol "${parsed.protocol}". Use http(s) or ws(s).`
-    );
-  }
-  const normalized = new URL(parsed.toString());
-  normalized.pathname = "/json/version";
-  normalized.search = "";
-  normalized.hash = "";
-  return normalized;
-}
-async function resolveCdpWebSocketUrl(cdpUrl, timeoutMs) {
-  if (cdpUrl.startsWith("ws://") || cdpUrl.startsWith("wss://")) {
-    return cdpUrl;
-  }
-  const versionUrl = normalizeDiscoveryUrl(cdpUrl);
-  const deadline = Date.now() + timeoutMs;
-  let lastError = "CDP discovery did not respond.";
-  while (Date.now() < deadline) {
-    const remaining = Math.max(deadline - Date.now(), 1e3);
-    try {
-      const response = await fetch(versionUrl, {
-        signal: AbortSignal.timeout(Math.min(remaining, 5e3))
-      });
-      if (!response.ok) {
-        lastError = `${response.status} ${response.statusText}`;
-      } else {
-        const payload = await response.json();
-        const wsUrl = payload && typeof payload === "object" && !Array.isArray(payload) && typeof payload.webSocketDebuggerUrl === "string" ? payload.webSocketDebuggerUrl : null;
-        if (wsUrl && wsUrl.trim()) {
-          return wsUrl;
-        }
-        lastError = "CDP discovery response did not include webSocketDebuggerUrl.";
-      }
-    } catch (error) {
-      lastError = error instanceof Error ? error.message : "Unknown error";
-    }
-    await sleep2(100);
-  }
-  throw new Error(
-    `Failed to resolve a CDP websocket URL from ${versionUrl.toString()}: ${lastError}`
-  );
-}
-async function reserveDebugPort() {
-  return await new Promise((resolve, reject) => {
-    const server = (0, import_node_net.createServer)();
-    server.unref();
-    server.on("error", reject);
-    server.listen(0, "127.0.0.1", () => {
-      const address = server.address();
-      if (!address || typeof address === "string") {
-        server.close();
-        reject(new Error("Failed to reserve a local debug port."));
-        return;
-      }
-      server.close((error) => {
-        if (error) {
-          reject(error);
-          return;
-        }
-        resolve(address.port);
-      });
-    });
-  });
-}
-function buildRealBrowserLaunchArgs(options) {
-  const args = [
-    `--user-data-dir=${options.userDataDir}`,
-    `--profile-directory=${options.profileDirectory}`,
-    `--remote-debugging-port=${options.debugPort}`,
-    "--disable-blink-features=AutomationControlled"
-  ];
-  if (options.headless) {
-    args.push("--headless=new");
-  }
-  return args;
-}
-async function killProcessTree(processHandle) {
-  if (!processHandle || processHandle.pid == null || processHandle.exitCode !== null) {
-    return;
-  }
-  if (process.platform === "win32") {
-    await new Promise((resolve) => {
-      const killer = (0, import_node_child_process2.spawn)(
-        "taskkill",
-        ["/pid", String(processHandle.pid), "/t", "/f"],
-        {
-          stdio: "ignore"
-        }
-      );
-      killer.on("error", () => resolve());
-      killer.on("exit", () => resolve());
-    });
-    return;
-  }
-  try {
-    process.kill(-processHandle.pid, "SIGKILL");
-  } catch {
-    try {
-      processHandle.kill("SIGKILL");
-    } catch {
-    }
-  }
-}
-async function sleep2(ms) {
-  await new Promise((resolve) => setTimeout(resolve, ms));
-}
 
 // src/config.ts
 var import_fs2 = __toESM(require("fs"), 1);
@@ -3720,7 +5139,7 @@ var StealthCdpRuntime = class _StealthCdpRuntime {
           TRANSIENT_CONTEXT_RETRY_DELAY_MS,
           Math.max(0, deadline - Date.now())
         );
-        await sleep3(retryDelay);
+        await sleep6(retryDelay);
       }
     }
   }
@@ -3753,7 +5172,7 @@ var StealthCdpRuntime = class _StealthCdpRuntime {
       () => ({ kind: "resolved" }),
       (error) => ({ kind: "rejected", error })
     );
-    const timeoutPromise = sleep3(
+    const timeoutPromise = sleep6(
       timeout + FRAME_EVALUATE_GRACE_MS
     ).then(() => ({ kind: "timeout" }));
     const result = await Promise.race([
@@ -3895,7 +5314,7 @@ function isIgnorableFrameError(error) {
   const message = error.message;
   return message.includes("Frame was detached") || message.includes("Target page, context or browser has been closed") || isTransientExecutionContextError(error) || message.includes("No frame for given id found");
 }
-function sleep3(ms) {
+function sleep6(ms) {
   return new Promise((resolve) => {
     setTimeout(resolve, ms);
   });
@@ -8156,7 +9575,7 @@ async function closeTab(context, activePage, index) {
 }
 
 // src/actions/cookies.ts
-var import_promises3 = require("fs/promises");
+var import_promises6 = require("fs/promises");
 async function getCookies(context, url) {
   return context.cookies(url ? [url] : void 0);
 }
@@ -8168,10 +9587,10 @@ async function clearCookies(context) {
 }
 async function exportCookies(context, filePath, url) {
   const cookies = await context.cookies(url ? [url] : void 0);
-  await (0, import_promises3.writeFile)(filePath, JSON.stringify(cookies, null, 2), "utf-8");
+  await (0, import_promises6.writeFile)(filePath, JSON.stringify(cookies, null, 2), "utf-8");
 }
 async function importCookies(context, filePath) {
-  const raw = await (0, import_promises3.readFile)(filePath, "utf-8");
+  const raw = await (0, import_promises6.readFile)(filePath, "utf-8");
   const cookies = JSON.parse(raw);
   await context.addCookies(cookies);
 }
@@ -8482,7 +9901,7 @@ var AdaptiveNetworkTracker = class {
         this.idleSince = 0;
       }
       const remaining = Math.max(1, options.deadline - now);
-      await sleep4(Math.min(NETWORK_POLL_MS, remaining));
+      await sleep7(Math.min(NETWORK_POLL_MS, remaining));
     }
   }
   handleRequestStarted = (request) => {
@@ -8527,7 +9946,7 @@ var AdaptiveNetworkTracker = class {
     return false;
   }
 };
-async function sleep4(ms) {
+async function sleep7(ms) {
   await new Promise((resolve) => {
     setTimeout(resolve, ms);
   });
@@ -10232,13 +11651,13 @@ function dedupeNewest(entries) {
 }
 
 // src/cloud/cdp-client.ts
-var import_playwright2 = require("playwright");
+var import_playwright3 = require("playwright");
 var CloudCdpClient = class {
   async connect(args) {
     const endpoint = withTokenQuery(args.wsUrl, args.token);
     let browser;
     try {
-      browser = await import_playwright2.chromium.connectOverCDP(endpoint);
+      browser = await import_playwright3.chromium.connectOverCDP(endpoint);
     } catch (error) {
       const message = error instanceof Error ? error.message : "Failed to connect to cloud CDP endpoint.";
       throw new OpensteerCloudError("CLOUD_TRANSPORT_ERROR", message);
@@ -12055,7 +13474,7 @@ async function executeAgentAction(page, action) {
     }
     case "wait": {
       const ms = numberOr(action.timeMs, action.time_ms, 1e3);
-      await sleep5(ms);
+      await sleep8(ms);
       return;
     }
     case "goto": {
@@ -12220,7 +13639,7 @@ async function pressKeyCombo(page, combo) {
     }
   }
 }
-function sleep5(ms) {
+function sleep8(ms) {
   return new Promise((resolve) => setTimeout(resolve, Math.max(0, ms)));
 }
 
@@ -12251,7 +13670,7 @@ var OpensteerCuaAgentHandler = class {
       if (isMutatingAgentAction(action)) {
         this.onMutatingAction?.(action);
       }
-      await sleep6(this.config.waitBetweenActionsMs);
+      await sleep9(this.config.waitBetweenActionsMs);
     });
     try {
       const result = await this.client.execute({
@@ -12313,7 +13732,7 @@ var OpensteerCuaAgentHandler = class {
     await this.cursorController.preview({ x, y }, "agent");
   }
 };
-function sleep6(ms) {
+function sleep9(ms) {
   return new Promise((resolve) => setTimeout(resolve, Math.max(0, ms)));
 }
 
@@ -12749,7 +14168,7 @@ var CursorController = class {
       for (const step of motion.points) {
         await this.renderer.move(step, this.style);
         if (motion.stepDelayMs > 0) {
-          await sleep7(motion.stepDelayMs);
+          await sleep10(motion.stepDelayMs);
         }
       }
       if (shouldPulse(intent)) {
@@ -12907,7 +14326,7 @@ function clamp2(value, min, max) {
 function shouldPulse(intent) {
   return intent === "click" || intent === "dblclick" || intent === "rightclick" || intent === "agent";
 }
-function sleep7(ms) {
+function sleep10(ms) {
   return new Promise((resolve) => setTimeout(resolve, ms));
 }
 
@@ -13381,15 +14800,19 @@ var Opensteer = class _Opensteer {
       }
       return;
     }
+    let closedOwnedBrowser = false;
     try {
       if (this.ownsBrowser) {
         await this.pool.close();
+        closedOwnedBrowser = true;
       }
     } finally {
       this.browser = null;
       this.pageRef = null;
       this.contextRef = null;
-      this.ownsBrowser = false;
+      if (!this.ownsBrowser || closedOwnedBrowser) {
+        this.ownsBrowser = false;
+      }
       if (this.cursorController) {
         await this.cursorController.dispose().catch(() => void 0);
       }
@@ -15846,7 +17269,7 @@ var CdpOverlayCursorRenderer = class {
         outlineColor: toProtocolRgba(pulseOutline)
       });
     });
-    await sleep8(PULSE_DELAY_MS);
+    await sleep11(PULSE_DELAY_MS);
     await this.move(point, style);
   }
   async clear() {
@@ -15970,7 +17393,7 @@ function clampAlpha(value) {
 function roundPointValue(value) {
   return Math.round(value * 100) / 100;
 }
-function sleep8(ms) {
+function sleep11(ms) {
   return new Promise((resolve) => setTimeout(resolve, ms));
 }
 // Annotate the CommonJS export names for ESM import in node:
@@ -16046,8 +17469,10 @@ function sleep8(ms) {
   getElementValue,
   getModelProvider,
   getOrCreatePersistentProfile,
+  getOwnedRealBrowserProcessPolicy,
   getPageHtml,
   getPageTitle,
+  hasActiveRuntimeProfileCreations,
   importCookies,
   isCloudActionMethod,
   isCloudErrorCode,