sootsim 0.1.227 → 0.1.228

package/dist-lib/skills.cjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.227 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.228 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __create = Object.create;
@@ -32,6 +32,389 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 ));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
+// ../../scripts/lib/reap-browser.ts
+function currentRuntime() {
+  return { platform: process.platform, env: process.env };
+}
+function softwareChromeAllowed(runtime = currentRuntime()) {
+  return runtime.platform === "linux" && runtime.env.GITHUB_ACTIONS === "true" && runtime.env.RUNNER_OS === "Linux";
+}
+function isSoftwareRendererArgument(value) {
+  const arg = String(value);
+  return /^--disable-gpu(?:=.*)?$/i.test(arg) || /^--enable-unsafe-swiftshader(?:=.*)?$/i.test(arg) || /^--use-angle=(?:swiftshader|swiftshader-webgl)$/i.test(arg) || /^--use-gl=swiftshader$/i.test(arg);
+}
+function softwareRendererArgumentInText(command) {
+  const unsafe = command.match(
+    /(?:^|\s)(--disable-gpu(?:=[^\s]+)?|--enable-unsafe-swiftshader(?:=[^\s]+)?|--use-angle=(?:swiftshader|swiftshader-webgl)|--use-gl=swiftshader)(?=\s|$)/i
+  );
+  return unsafe?.[1] ?? null;
+}
+function expectedAngle(platform) {
+  if (platform === "darwin") return "metal";
+  if (platform === "linux") return "vulkan";
+  return "default";
+}
+function assertGpuBrowserCommand(command, runtime = currentRuntime()) {
+  if (softwareChromeAllowed(runtime)) return;
+  const unsafe = softwareRendererArgumentInText(command);
+  if (unsafe) {
+    throw new Error(
+      `[reap-browser] refused software-rendering Chrome process argument ${unsafe}`
+    );
+  }
+  const angle = expectedAngle(runtime.platform);
+  const args = command.split(/\s+/);
+  if (!args.includes(`--use-angle=${angle}`) || !args.includes("--enable-gpu")) {
+    throw new Error(
+      `[reap-browser] Chrome process did not retain the required ${angle} GPU arguments`
+    );
+  }
+  if (runtime.platform === "darwin" && command.includes("/Applications/Google Chrome.app/")) {
+    throw new Error(
+      "[reap-browser] refused the user's installed Google Chrome; use Playwright channel chromium"
+    );
+  }
+}
+function collectGpuRendererStrings(info) {
+  if (!info || typeof info !== "object") return [];
+  const record = info;
+  const gpu = record.gpu;
+  if (!gpu || typeof gpu !== "object") return [];
+  const gpuRecord = gpu;
+  const values = [];
+  const aux = gpuRecord.auxAttributes;
+  if (aux && typeof aux === "object") {
+    for (const value of Object.values(aux)) {
+      if (typeof value === "string") values.push(value);
+    }
+  }
+  const devices2 = gpuRecord.devices;
+  if (Array.isArray(devices2)) {
+    for (const device of devices2) {
+      if (!device || typeof device !== "object") continue;
+      for (const value of Object.values(device)) {
+        if (typeof value === "string") values.push(value);
+      }
+    }
+  }
+  return values;
+}
+function browserProcessPid(info) {
+  if (!info || typeof info !== "object") return null;
+  const record = info;
+  if (!Array.isArray(record.processInfo)) return null;
+  for (const entry of record.processInfo) {
+    if (!entry || typeof entry !== "object") continue;
+    const processInfo = entry;
+    if (processInfo.type === "browser" && typeof processInfo.id === "number" && Number.isInteger(processInfo.id) && processInfo.id > 0) {
+      return processInfo.id;
+    }
+  }
+  return null;
+}
+function assertGpuRendererInfo(info, runtime = currentRuntime()) {
+  if (softwareChromeAllowed(runtime)) return;
+  const renderers = collectGpuRendererStrings(info);
+  const summary = renderers.join(" | ");
+  if (!summary || /swiftshader|llvmpipe|software rasterizer/i.test(summary)) {
+    throw new Error(
+      `[reap-browser] Chrome reported a software renderer${summary ? `: ${summary}` : ""}`
+    );
+  }
+  if (runtime.platform === "darwin" && !/metal/i.test(summary)) {
+    throw new Error(
+      `[reap-browser] Chrome did not report an ANGLE Metal renderer: ${summary}`
+    );
+  }
+}
+function rootChromePid(b) {
+  if (b && typeof b === "object") {
+    const discovered = discoveredChromePids.get(b);
+    if (discovered !== void 0) return discovered;
+  }
+  const w = b;
+  if (w && typeof w.process === "function") {
+    try {
+      const p = w.process();
+      if (p && typeof p.pid === "number" && p.pid > 0) return p.pid;
+    } catch {
+    }
+  }
+  if (w && typeof w.browser === "function") {
+    try {
+      const child = w.browser();
+      if (child) return rootChromePid(child);
+    } catch {
+    }
+  }
+  return null;
+}
+function killTree(pid) {
+  let kids = [];
+  try {
+    kids = (0, import_node_child_process.execSync)(`pgrep -P ${pid} || true`).toString().split("\n").filter(Boolean);
+  } catch {
+  }
+  for (const k of kids) killTree(Number(k));
+  try {
+    process.kill(pid, "SIGKILL");
+  } catch {
+  }
+}
+function browserControl(b) {
+  const candidate = b;
+  if (!candidate || typeof candidate !== "object") return null;
+  if (typeof candidate.newBrowserCDPSession === "function" || typeof candidate.process === "function") {
+    return candidate;
+  }
+  if (typeof candidate.browser !== "function") return null;
+  try {
+    const browser = candidate.browser();
+    return browser ? browserControl(browser) : null;
+  } catch {
+    return null;
+  }
+}
+function registerChromePid(browser, control, pid) {
+  if (browser && typeof browser === "object") discoveredChromePids.set(browser, pid);
+  discoveredChromePids.set(control, pid);
+  reapPids.add(pid);
+  installReaper();
+}
+async function discoverChromePid(browser) {
+  const known = rootChromePid(browser);
+  if (known !== null) return known;
+  const control = browserControl(browser);
+  if (!control || typeof control.newBrowserCDPSession !== "function") return null;
+  const session = await control.newBrowserCDPSession();
+  try {
+    const pid = browserProcessPid(await session.send("SystemInfo.getProcessInfo"));
+    if (pid === null) return null;
+    registerChromePid(browser, control, pid);
+    return pid;
+  } finally {
+    await session.detach?.();
+  }
+}
+async function rejectLaunchedBrowser(browser) {
+  const root = rootChromePid(browser);
+  if (root !== null) {
+    reapPids.delete(root);
+    killTree(root);
+    return;
+  }
+  const candidate = browser;
+  if (candidate && typeof candidate.close === "function") {
+    try {
+      await candidate.close();
+    } catch {
+    }
+  }
+}
+async function validateLaunchedGpuBrowser(browser, runtime, rendererTarget) {
+  if (softwareChromeAllowed(runtime)) return;
+  const root = rootChromePid(browser);
+  const launchedControl = browserControl(browser);
+  if (root !== null && launchedControl) {
+    registerChromePid(browser, launchedControl, root);
+  }
+  if (root !== null && (runtime.platform === "darwin" || runtime.platform === "linux")) {
+    const command = (0, import_node_child_process.execFileSync)("ps", ["-p", String(root), "-o", "command="], {
+      encoding: "utf8"
+    }).trim();
+    assertGpuBrowserCommand(command, runtime);
+  }
+  const rendererBrowser = rendererTarget ? await rendererTarget(browser) : browser;
+  const control = browserControl(rendererBrowser);
+  if (control && typeof control.newBrowserCDPSession === "function") {
+    const session = await control.newBrowserCDPSession();
+    try {
+      const pid = browserProcessPid(await session.send("SystemInfo.getProcessInfo"));
+      if (pid === null) {
+        throw new Error("[reap-browser] Chrome did not report its browser process id");
+      }
+      registerChromePid(browser, control, pid);
+      if (rendererBrowser && typeof rendererBrowser === "object") {
+        discoveredChromePids.set(rendererBrowser, pid);
+      }
+      if (runtime.platform === "darwin" || runtime.platform === "linux") {
+        const command = (0, import_node_child_process.execFileSync)("ps", ["-p", String(pid), "-o", "command="], {
+          encoding: "utf8"
+        }).trim();
+        assertGpuBrowserCommand(command, runtime);
+      }
+      assertGpuRendererInfo(await session.send("SystemInfo.getInfo"), runtime);
+      return;
+    } finally {
+      await session.detach?.();
+    }
+  }
+  throw new Error("[reap-browser] could not validate the launched Chrome GPU renderer");
+}
+function installReaper() {
+  if (installed) return;
+  installed = true;
+  const reap = () => {
+    for (const pid of reapPids) killTree(pid);
+  };
+  process.on("SIGTERM", () => {
+    reap();
+    process.exit(0);
+  });
+  process.on("SIGINT", () => {
+    reap();
+    process.exit(0);
+  });
+  process.on("exit", reap);
+}
+async function launchReapedScoped(launch) {
+  const browser = await launch();
+  let root = rootChromePid(browser);
+  if (root === null) {
+    try {
+      root = await discoverChromePid(browser);
+    } catch {
+      root = null;
+    }
+  }
+  const mine = /* @__PURE__ */ new Set();
+  if (root != null) {
+    mine.add(root);
+    reapPids.add(root);
+    installReaper();
+  }
+  const evented = browserControl(browser) ?? browser;
+  if (typeof evented.on === "function") {
+    const disconnectEvent = typeof evented.newBrowserCDPSession === "function" ? "disconnected" : "close";
+    evented.on(disconnectEvent, () => {
+      for (const pid of mine) reapPids.delete(pid);
+    });
+  }
+  const reapNow = () => {
+    for (const pid of mine) {
+      killTree(pid);
+      reapPids.delete(pid);
+    }
+    mine.clear();
+  };
+  return { browser, reapNow };
+}
+async function launchReaped(launch) {
+  const { browser } = await launchReapedScoped(launch);
+  return browser;
+}
+function gpuChromeArgs(platform = process.platform) {
+  const angle = expectedAngle(platform);
+  return [
+    `--use-angle=${angle}`,
+    "--enable-gpu",
+    "--enable-gpu-rasterization",
+    "--enable-zero-copy",
+    "--ignore-gpu-blocklist"
+  ];
+}
+function gpuChromeLaunchOptions(opts = {}, runtime = currentRuntime()) {
+  const callerArgs = Array.isArray(opts.args) ? opts.args : [];
+  const unsafe = callerArgs.find(isSoftwareRendererArgument);
+  if (unsafe !== void 0) {
+    throw new Error(
+      `[reap-browser] refused software-rendering Chrome launch argument ${String(unsafe)}`
+    );
+  }
+  if (opts.executablePath !== void 0) {
+    throw new Error(
+      "[reap-browser] executablePath bypasses Playwright Chrome for Testing and is not allowed"
+    );
+  }
+  if (opts.ignoreDefaultArgs === true) {
+    throw new Error(
+      "[reap-browser] ignoreDefaultArgs=true bypasses required Chrome launch defaults"
+    );
+  }
+  const managedGpuArgs = /* @__PURE__ */ new Set([
+    "--enable-gpu",
+    "--enable-gpu-rasterization",
+    "--enable-zero-copy",
+    "--ignore-gpu-blocklist"
+  ]);
+  const unmanagedCallerArgs = callerArgs.filter((arg) => {
+    const value = String(arg);
+    return !managedGpuArgs.has(value) && !value.startsWith("--use-angle=");
+  });
+  const callerIgnored = Array.isArray(opts.ignoreDefaultArgs) ? opts.ignoreDefaultArgs : [];
+  const ignoredDefaults = [
+    .../* @__PURE__ */ new Set([...callerIgnored, "--disable-gpu", "--enable-unsafe-swiftshader"])
+  ];
+  return {
+    ...opts,
+    // playwright's `chromium` channel is the full Google Chrome for Testing
+    // app, not chromium_headless_shell. on macOS it has bundle id
+    // com.google.chrome.for.testing, so automation cannot become the target of
+    // Dock open/quit events intended for the user's com.google.Chrome browser.
+    channel: "chromium",
+    args: [...unmanagedCallerArgs, ...gpuChromeArgs(runtime.platform)],
+    ignoreDefaultArgs: ignoredDefaults
+  };
+}
+function preferGpuChrome(launch, opts, rendererTarget) {
+  return async () => {
+    const runtime = currentRuntime();
+    const allowSoftwareFallback = softwareChromeAllowed(runtime);
+    const gpuOptions = gpuChromeLaunchOptions(opts, runtime);
+    if (!gpuChromeMissing) {
+      let browser;
+      try {
+        browser = await launch(gpuOptions);
+      } catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        const missing = /not found at|not installed|Chromium distribution|Executable doesn't exist|No such file/i.test(
+          msg
+        );
+        if (!missing) throw err;
+        if (!allowSoftwareFallback) {
+          throw new Error(
+            "[reap-browser] Playwright Chrome for Testing is required for local GPU browser work; chromium_headless_shell fallback is disabled. Run `bunx playwright install chromium`.",
+            { cause: err }
+          );
+        }
+        gpuChromeMissing = true;
+        console.warn(
+          "[reap-browser] GitHub Actions Linux Chrome for Testing not found, falling back to chromium_headless_shell software rendering."
+        );
+        return launch(softwareFallbackChromeLaunchOptions(opts));
+      }
+      try {
+        await validateLaunchedGpuBrowser(browser, runtime, rendererTarget);
+      } catch (err) {
+        await rejectLaunchedBrowser(browser);
+        throw err;
+      }
+      return browser;
+    }
+    return launch(softwareFallbackChromeLaunchOptions(opts));
+  };
+}
+function softwareFallbackChromeLaunchOptions(opts) {
+  const fallback = { ...opts };
+  delete fallback.channel;
+  delete fallback.executablePath;
+  return fallback;
+}
+async function launchReapedChrome(launch, opts = {}, rendererTarget) {
+  return launchReaped(preferGpuChrome(launch, opts, rendererTarget));
+}
+var import_node_child_process, discoveredChromePids, reapPids, installed, gpuChromeMissing;
+var init_reap_browser = __esm({
+  "../../scripts/lib/reap-browser.ts"() {
+    "use strict";
+    import_node_child_process = require("node:child_process");
+    discoveredChromePids = /* @__PURE__ */ new WeakMap();
+    reapPids = /* @__PURE__ */ new Set();
+    installed = false;
+    gpuChromeMissing = false;
+  }
+});
+
 // ../compat/src/unsupported-packages.ts
 var UNSUPPORTABLE;
 var init_unsupported_packages = __esm({
@@ -9980,7 +10363,7 @@ function resolveSootsimBridgePortForRuntimeLocation(input = {}) {
   if (hrefUrl?.pathname.startsWith("/sootsim") && (hrefUrl.searchParams.has("embed") || hrefUrl.searchParams.has("nativePreview"))) {
     return resolveSootsimBridgePortForHttpPort({
       httpPort,
-      baseHttpPort: SOOTBEAN_DEV_HTTP_BASE_PORT
+      baseHttpPort: CONTRAST_DEV_HTTP_BASE_PORT
     });
   }
   if (hrefUrl?.pathname.startsWith("/sootsim") && httpPort >= SOOTSIM_SITE_DEV_HTTP_BASE_PORT && httpPort <= SOOTSIM_SITE_DEV_HTTP_BASE_PORT + MAX_LOCAL_DEV_PORT_OFFSET) {
@@ -9993,16 +10376,16 @@ function resolveSootsimBridgePortForRuntimeLocation(input = {}) {
   if (baseHttpPort === null) return DEFAULT_SOOTSIM_BRIDGE_PORT;
   return resolveSootsimBridgePortForHttpPort({ httpPort, baseHttpPort });
 }
-var DEFAULT_SOOTSIM_BRIDGE_PORT, SOOTBEAN_DEV_HTTP_BASE_PORT, SOOTSIM_SITE_DEV_HTTP_BASE_PORT, SOOTSIM_SHELL_DEV_HTTP_BASE_PORT, LOCAL_DEV_HTTP_BASE_PORTS, MAX_LOCAL_DEV_PORT_OFFSET, SOOTSIM_BRIDGE_SIM_CLOSE_CODE, SOOTSIM_BRIDGE_SIM_CLOSE_REASON;
+var DEFAULT_SOOTSIM_BRIDGE_PORT, CONTRAST_DEV_HTTP_BASE_PORT, SOOTSIM_SITE_DEV_HTTP_BASE_PORT, SOOTSIM_SHELL_DEV_HTTP_BASE_PORT, LOCAL_DEV_HTTP_BASE_PORTS, MAX_LOCAL_DEV_PORT_OFFSET, SOOTSIM_BRIDGE_SIM_CLOSE_CODE, SOOTSIM_BRIDGE_SIM_CLOSE_REASON;
 var init_bridge_constants = __esm({
   "src/bridge-constants.ts"() {
     "use strict";
     DEFAULT_SOOTSIM_BRIDGE_PORT = 7668;
-    SOOTBEAN_DEV_HTTP_BASE_PORT = 3e3;
+    CONTRAST_DEV_HTTP_BASE_PORT = 3e3;
     SOOTSIM_SITE_DEV_HTTP_BASE_PORT = 3001;
     SOOTSIM_SHELL_DEV_HTTP_BASE_PORT = 5173;
     LOCAL_DEV_HTTP_BASE_PORTS = [
-      SOOTBEAN_DEV_HTTP_BASE_PORT,
+      CONTRAST_DEV_HTTP_BASE_PORT,
       SOOTSIM_SHELL_DEV_HTTP_BASE_PORT
     ];
     MAX_LOCAL_DEV_PORT_OFFSET = 2e3;
@@ -10052,7 +10435,7 @@ function applyPreviewProdBundle(parsed) {
 function normalizeNativeDevBundleUrl(bundleUrl) {
   try {
     const isAbsolute2 = isAbsoluteHttpUrl(bundleUrl);
-    const parsed = new URL(bundleUrl, "http://soot.local");
+    const parsed = new URL(bundleUrl, "http://sootsim.local");
     parsed.pathname = parsed.pathname.replace(/\.\.bundle$/, ".bundle");
     if (!isNativeDevBundlePath(parsed.pathname)) return bundleUrl;
     parsed.searchParams.delete("transform.bytecode");
@@ -10419,7 +10802,7 @@ async function probePort(port, buildIconProxyUrl) {
   knownNonPatched.add(port);
   return null;
 }
-function isSootSelfServer(server) {
+function isSootSimSelfServer(server) {
   const bundleId = server.bundleId?.trim().toLowerCase();
   if (bundleId?.startsWith("dev.sootsim.")) return true;
   return false;
@@ -10503,7 +10886,7 @@ async function scanDevServers(opts = {}) {
   for (const pid of [...cwdByPid.keys()]) {
     if (!livePids.has(pid)) cwdByPid.delete(pid);
   }
-  return results.filter((r) => !isSootSelfServer(r));
+  return results.filter((r) => !isSootSimSelfServer(r));
 }
 var import_child_process, import_http, import_net, import_util, execP, TIMEOUT_MS, MANIFEST_TIMEOUT_MS, TCP_GATE_MS, FALLBACK_PORTS, cwdByPid, ENRICH_TIMEOUT_MS, enrichmentCache, enrichmentInFlight, knownNonPatched, knownNonExpo, knownOne, portCache, NEGATIVE_CACHE_TTL_MS, WEAK_RESULT_CACHE_TTL_MS;
 var init_dev_server_scanner = __esm({
@@ -10981,7 +11364,12 @@ async function updateRuntimeToLatest(opts = {}) {
         latestVersion: pin
       };
     }
-    const install2 = await installRuntime({ version: pin, channel, cdnOrigin, setActive: false });
+    const install2 = await installRuntime({
+      version: pin,
+      channel,
+      cdnOrigin,
+      setActive: false
+    });
     return {
       checked: true,
       updated: true,
@@ -11091,7 +11479,7 @@ var init_runtime_delivery = __esm({
     import_stream = require("stream");
     import_promises = require("stream/promises");
     init_home_paths();
-    DEFAULT_RUNTIME_CDN_ORIGIN = "https://sootbean.com";
+    DEFAULT_RUNTIME_CDN_ORIGIN = "https://contrast.dev";
     RUNTIME_CDN_ORIGIN_ENV = "SOOTSIM_CDN_ORIGIN";
     RUNTIME_CHANNEL_ENV = "SOOTSIM_RUNTIME_CHANNEL";
     RUNTIME_PIN_ENV = "SOOTSIM_RUNTIME_VERSION";
@@ -13046,7 +13434,7 @@ function shouldAcquireLease(msg) {
   if (msg.readOnly === true) return false;
   return WRITE_COMMAND_TYPES.has(msg.type);
 }
-function injectSharedConfigIntoHtml(data, bridgePort, sootbeanOrigin) {
+function injectSharedConfigIntoHtml(data, bridgePort, contrastOrigin) {
   let payload;
   try {
     const cfg = readSharedConfig();
@@ -13055,8 +13443,8 @@ function injectSharedConfigIntoHtml(data, bridgePort, sootbeanOrigin) {
     payload = "{}";
   }
   const bridgePortTag = bridgePort > 0 ? `window.__sootsimBridgePort=${bridgePort};` : "";
-  const sootbeanOriginTag = sootbeanOrigin ? `window.__sootsimSootbeanOrigin=${JSON.stringify(sootbeanOrigin)};` : "";
-  const tag = `<script>window.__sootsimSharedConfig=${payload};` + bridgePortTag + sootbeanOriginTag + `window.__sootsimCliVersion=${JSON.stringify(getCliVersion())};</script>`;
+  const contrastOriginTag = contrastOrigin ? `window.__sootsimContrastOrigin=${JSON.stringify(contrastOrigin)};` : "";
+  const tag = `<script>window.__sootsimSharedConfig=${payload};` + bridgePortTag + contrastOriginTag + `window.__sootsimCliVersion=${JSON.stringify(getCliVersion())};</script>`;
   const html = data.toString("utf8");
   if (html.includes("<head>")) return html.replace("<head>", `<head>${tag}`);
   if (html.includes("</head>")) return html.replace("</head>", tag + "</head>");
@@ -13176,7 +13564,7 @@ var init_bridge_host = __esm({
       shouldWriteLockfile;
       shouldWriteDevLockfile;
       getShellPort;
-      sootbeanOrigin = null;
+      contrastOrigin = null;
       effectivePort = 0;
       startedAt = 0;
       heartbeatTimer = null;
@@ -13223,7 +13611,7 @@ var init_bridge_host = __esm({
             } : null;
           }
         });
-        this.sootbeanOrigin = opts.sootbeanOrigin?.replace(/\/$/, "") || null;
+        this.contrastOrigin = opts.contrastOrigin?.replace(/\/$/, "") || null;
         this.simIdleReapTtlMs = opts.simIdleReapTtlMs ?? _SootSimBridgeHost.SIM_IDLE_REAP_TTL_MS;
         this.automationSimIdleReapTtlMs = opts.automationSimIdleReapTtlMs ?? _SootSimBridgeHost.AUTOMATION_SIM_IDLE_REAP_TTL_MS;
         this.maxConcurrentAutomationSims = opts.maxConcurrentAutomationSims ?? _SootSimBridgeHost.MAX_CONCURRENT_AUTOMATION_SIMS;
@@ -14201,7 +14589,7 @@ var init_bridge_host = __esm({
                   return;
                 }
                 res.end(
-                  injectSharedConfigIntoHtml(data, this.effectivePort, this.sootbeanOrigin)
+                  injectSharedConfigIntoHtml(data, this.effectivePort, this.contrastOrigin)
                 );
               });
               return;
@@ -14226,7 +14614,7 @@ var init_bridge_host = __esm({
                   return;
                 }
                 res.end(
-                  injectSharedConfigIntoHtml(data, this.effectivePort, this.sootbeanOrigin)
+                  injectSharedConfigIntoHtml(data, this.effectivePort, this.contrastOrigin)
                 );
               });
               return;
@@ -15469,14 +15857,15 @@ function createBridge(wsPort, opts = {}) {
           ws.send(JSON.stringify(payload));
         });
       };
+      const sentSimId = opts.simIdSource === "flag" ? opts.simId : readCurrentSimId() ?? opts.simId;
       try {
-        return await sendOnce(opts.simId);
+        return await sendOnce(sentSimId);
       } catch (error) {
         const message = error instanceof Error ? error.message : String(error);
-        if (opts.simIdSource === "saved" && opts.simId && cmd.simId === void 0 && message === `no sim connected with id ${opts.simId}`) {
+        if (opts.simIdSource !== "flag" && sentSimId && cmd.simId === void 0 && message === `no sim connected with id ${sentSimId}`) {
           clearCurrentSimId();
           throw new Error(
-            `saved sim ${opts.simId} is gone; run \`sootsim list\` and \`sootsim use <sim>\`, or open a fresh sim`
+            `saved sim ${sentSimId} is gone; run \`sootsim list\` and \`sootsim use <sim>\`, or open a fresh sim`
           );
         }
         throw error;
@@ -15872,7 +16261,9 @@ function renderFrameHtml(layout, rawImageDataUrl) {
 }
 async function composeFramedScreenshot(rawPng, model) {
   const { chromium } = await import("playwright");
-  const browser = await chromium.launch({ headless: true });
+  const browser = await launchReapedChrome((options) => chromium.launch(options), {
+    headless: true
+  });
   try {
     const composer = await createFramedScreenshotComposer(browser);
     try {
@@ -15932,6 +16323,7 @@ var init_frame_compose = __esm({
     "use strict";
     import_chrome_metrics = require("sootsim-engine/ios/chrome-metrics");
     import_settings = require("sootsim-engine/settings");
+    init_reap_browser();
     METALLIC_RING_SHADOW = "inset 0 0 0 0.5px #000, inset 0 0 0 2px #757575, inset 0 0 0 5px #212121";
     FRAME_OUTLINE_BLEED = 1;
   }
@@ -16712,7 +17104,7 @@ var init_shared_session = __esm({
     init_home_paths();
     SESSION_VERSION = 1;
     SESSION_FILE_ENV = "SOOTSIM_SHARED_AUTH_FILE";
-    DEFAULT_ORIGIN = "https://sootbean.com";
+    DEFAULT_ORIGIN = "https://contrast.dev";
   }
 });
 
@@ -16723,15 +17115,15 @@ function looksLikeGitHubToken(token) {
   );
 }
 function resolveGitHubActionsAuth() {
-  const sootRunnerToken = process.env.SOOT_INSTALLATION_TOKEN?.trim();
+  const contrastRunnerToken = process.env.CONTRAST_INSTALLATION_TOKEN?.trim();
   const githubActionsToken = process.env.GITHUB_TOKEN?.trim();
-  const token = sootRunnerToken || githubActionsToken;
+  const token = contrastRunnerToken || githubActionsToken;
   if (!looksLikeGitHubToken(token)) return null;
-  const repoSlug = (process.env.SOOT_REPO || process.env.GITHUB_REPOSITORY || "").trim();
+  const repoSlug = (process.env.CONTRAST_REPO || process.env.GITHUB_REPOSITORY || "").trim();
   if (!repoSlug) return null;
   const [owner, repo] = repoSlug.includes("/") ? repoSlug.split("/", 2) : [null, null];
-  const repositoryId = (process.env.SOOT_REPO_ID || process.env.GITHUB_REPOSITORY_ID || "").trim();
-  const installationId = (process.env.SOOT_INSTALLATION_ID || process.env.GITHUB_APP_INSTALLATION_ID || "").trim();
+  const repositoryId = (process.env.CONTRAST_REPO_ID || process.env.GITHUB_REPOSITORY_ID || "").trim();
+  const installationId = (process.env.CONTRAST_INSTALLATION_ID || process.env.GITHUB_APP_INSTALLATION_ID || "").trim();
   return {
     kind: "github",
     token,
@@ -16740,7 +17132,7 @@ function resolveGitHubActionsAuth() {
     owner: owner || null,
     repo: repo || null,
     installationId: installationId || null,
-    source: sootRunnerToken ? "soot-runner" : "github-actions"
+    source: contrastRunnerToken ? "contrast-runner" : "github-actions"
   };
 }
 function resolveCliAuth() {
@@ -16838,7 +17230,7 @@ var init_upload = __esm({
     init_open_url2();
     init_telemetry();
     init_ws_bridge();
-    REMOTE_DEFAULT_ORIGIN = process.env.SOOTSIM_UPLOAD_ORIGIN || "https://sootbean.com";
+    REMOTE_DEFAULT_ORIGIN = process.env.SOOTSIM_UPLOAD_ORIGIN || "https://contrast.dev";
     REMOTE_DEFAULT_PUBLIC_PREVIEW_ORIGIN = process.env.SOOTSIM_PREVIEW_ORIGIN || "https://sootsim.com";
     LOCAL_DEFAULT_ORIGIN = "http://localhost:3000";
     LOCAL_UPLOAD_PROBE_TIMEOUT_MS = 2e3;
@@ -18869,147 +19261,8 @@ module.exports = __toCommonJS(registry_exports);
 var fs10 = __toESM(require("fs"), 1);
 var path10 = __toESM(require("path"), 1);
 
-// ../../scripts/lib/reap-browser.ts
-var import_node_child_process = require("node:child_process");
-function rootChromePid(b) {
-  const w = b;
-  if (w && typeof w.process === "function") {
-    try {
-      const p = w.process();
-      if (p && typeof p.pid === "number" && p.pid > 0) return p.pid;
-    } catch {
-    }
-  }
-  if (w && typeof w.browser === "function") {
-    try {
-      const child = w.browser();
-      if (child) return rootChromePid(child);
-    } catch {
-    }
-  }
-  return null;
-}
-function killTree(pid) {
-  let kids = [];
-  try {
-    kids = (0, import_node_child_process.execSync)(`pgrep -P ${pid} || true`).toString().split("\n").filter(Boolean);
-  } catch {
-  }
-  for (const k of kids) killTree(Number(k));
-  try {
-    process.kill(pid, "SIGKILL");
-  } catch {
-  }
-}
-var reapPids = /* @__PURE__ */ new Set();
-var installed = false;
-function installReaper() {
-  if (installed) return;
-  installed = true;
-  const reap = () => {
-    for (const pid of reapPids) killTree(pid);
-  };
-  process.on("SIGTERM", () => {
-    reap();
-    process.exit(0);
-  });
-  process.on("SIGINT", () => {
-    reap();
-    process.exit(0);
-  });
-  process.on("exit", reap);
-}
-async function launchReapedScoped(launch) {
-  const browser = await launch();
-  const root = rootChromePid(browser);
-  const mine = /* @__PURE__ */ new Set();
-  if (root != null) {
-    mine.add(root);
-    reapPids.add(root);
-    installReaper();
-  }
-  const evented = browser;
-  if (typeof evented.on === "function") {
-    evented.on("disconnected", () => {
-      for (const pid of mine) reapPids.delete(pid);
-    });
-  }
-  const reapNow = () => {
-    for (const pid of mine) {
-      killTree(pid);
-      reapPids.delete(pid);
-    }
-    mine.clear();
-  };
-  return { browser, reapNow };
-}
-async function launchReaped(launch) {
-  const { browser } = await launchReapedScoped(launch);
-  return browser;
-}
-var gpuChromeMissing = false;
-function gpuChromeArgs() {
-  const angle = process.platform === "darwin" ? "metal" : process.platform === "linux" ? "vulkan" : "default";
-  return [
-    `--use-angle=${angle}`,
-    "--enable-gpu",
-    "--enable-gpu-rasterization",
-    "--enable-zero-copy",
-    "--ignore-gpu-blocklist"
-  ];
-}
-function gpuChromeLaunchOptions(opts = {}) {
-  const callerArgs = Array.isArray(opts.args) ? opts.args : [];
-  const callerIgnored = Array.isArray(opts.ignoreDefaultArgs) ? opts.ignoreDefaultArgs : [];
-  return {
-    ...opts,
-    // playwright's `chromium` channel is the full Google Chrome for Testing
-    // app, not chromium_headless_shell. on macOS it has bundle id
-    // com.google.chrome.for.testing, so automation cannot become the target of
-    // Dock open/quit events intended for the user's com.google.Chrome browser.
-    channel: "chromium",
-    args: [...gpuChromeArgs(), ...callerArgs],
-    ignoreDefaultArgs: [...callerIgnored, "--enable-unsafe-swiftshader"]
-  };
-}
-function preferGpuChrome(launch, opts) {
-  return async () => {
-    const allowSoftwareFallback = process.env.CI === "true" || process.env.CI === "1" || process.env.GITHUB_ACTIONS === "true";
-    if (!gpuChromeMissing) {
-      try {
-        const callerArgs = Array.isArray(opts.args) ? opts.args : [];
-        if (!allowSoftwareFallback && callerArgs.some(
-          (arg) => arg === "--enable-unsafe-swiftshader" || /^--use-angle=(?:swiftshader|swiftshader-webgl)$/i.test(String(arg))
-        )) {
-          throw new Error("[reap-browser] refused local SwiftShader launch arguments");
-        }
-        return await launch(gpuChromeLaunchOptions(opts));
-      } catch (err) {
-        const msg = err instanceof Error ? err.message : String(err);
-        const missing = /not found at|not installed|Chromium distribution|Executable doesn't exist|No such file/i.test(
-          msg
-        );
-        if (!missing) throw err;
-        if (!allowSoftwareFallback) {
-          throw new Error(
-            "[reap-browser] Playwright Chrome for Testing is required for local GPU browser work; chromium_headless_shell fallback is disabled. Run `bunx playwright install chromium`.",
-            { cause: err }
-          );
-        }
-        gpuChromeMissing = true;
-        console.warn(
-          "[reap-browser] CI Chrome for Testing not found, falling back to chromium_headless_shell software rendering."
-        );
-      }
-    }
-    return launch(opts);
-  };
-}
-async function launchReapedChrome(launch, opts = {}) {
-  return launchReaped(preferGpuChrome(launch, opts));
-}
-
 // src/skills/builtin/a11y-review.ts
+init_reap_browser();
 var skill = {
   name: "a11y-review",
   description: "Check the app for accessibility issues",
@@ -19283,6 +19536,7 @@ var skill3 = {
 };
 
 // src/skills/builtin/perf-profile.ts
+init_reap_browser();
 var skill4 = {
   name: "perf-profile",
   description: "Profile render performance of the app",
@@ -19350,6 +19604,7 @@ var skill4 = {
 };
 
 // src/skills/builtin/screenshot-all.ts
+init_reap_browser();
 var skill5 = {
   name: "screenshot-all",
   description: "Capture screenshots of all screens in the app",
@@ -19392,6 +19647,7 @@ var skill5 = {
 };
 
 // src/skills/builtin/visual-diff.ts
+init_reap_browser();
 var skill6 = {
   name: "visual-diff",
   description: "Compare current rendering against baseline screenshots",