@swmansion/argent 0.30.2-next.17 → 0.30.2-next.19

package/dist/cli-cmds.mjs

@@ -35594,7 +35594,7 @@ var _CI_VENDOR_COUNT_FOR_TEST = vendors_default.length;
 var SESSION_ID2 = randomUUID5();
 function readCliVersion() {
   if (true) {
-    return "0.30.2-next.17";
+    return "0.30.2-next.19";
   }
   return "0.0.0";
 }

package/dist/installer.mjs

@@ -16900,7 +16900,7 @@ var _CI_VENDOR_COUNT_FOR_TEST = vendors_default.length;
 var SESSION_ID = randomUUID4();
 function readCliVersion() {
   if (true) {
-    return "0.30.2-next.17";
+    return "0.30.2-next.19";
   }
   return "0.0.0";
 }

package/dist/tool-args.generated.d.ts

@@ -53,6 +53,8 @@ export interface ArgentToolArgs {
         force?: boolean;
         /** Android only: boot the emulator with audio output enabled. Defaults to false: argent boots emulators MUTED so several agent-driven devices don't all play sound on the host machine; pass `true` when the task involves playing, hearing, or testing audio. Takes effect at boot: if the emulator is already running muted, add `force: true` to reboot it with sound. A boot snapshot saved in the other audio mode can't be reused, so the first boot after toggling is a slower cold boot. The `boot-sound` argent flag flips this default to true. Ignored on iOS/Vega/HarmonyOS/Electron, which argent never mutes. */
         sound?: boolean;
+        /** Android on a macOS host only: boot the emulator with guest Vulkan. Defaults to false: guest Vulkan crashes Chrome's GPU process, which breaks Chrome and Custom Tab sign-in flows. Without it apps find no Vulkan device, although the guest still lists the Vulkan features, so a Vulkan-only renderer such as WebGPU (react-native-wgpu) draws nothing; pass `true` to test one. Takes effect at boot: an emulator already running in the other mode is reused with a `note`, and `force: true` reboots it. A boot snapshot saved in the other mode can't be reused, so the first boot after toggling is a slower cold boot. The `ARGENT_EMULATOR_GUEST_VULKAN` env var flips this default to true. Ignored on other hosts and platforms. */
+        guestVulkan?: boolean;
         /** iOS only: boot the simulator core WITHOUT opening its GUI window (Simulator.app, or Device Hub on Xcode 27+). The device still streams via simulator-server; used by Argent Lens. Set the `ARGENT_SIMULATOR_NO_WINDOW` env var (1/true/yes) to force this host-wide without passing the flag per call (the iOS analog of `ARGENT_EMULATOR_NO_WINDOW`). Ignored on Android/Vega/HarmonyOS/Electron, which have no equivalent GUI step. */
         headless?: boolean;
         /** Electron: path to the Electron app to launch. Either a packaged .app bundle / executable, or a project directory whose package.json points the Electron binary at the entry script. Provide exactly one of `udid`, `avdName`, `vvdImage`, `harmonyInstance`, or `electronAppPath`. */

package/dist/tool-server.cjs

@@ -100945,7 +100945,7 @@ var _CI_VENDOR_COUNT_FOR_TEST = vendors_default.length;
 var SESSION_ID = (0, import_node_crypto3.randomUUID)();
 function readCliVersion() {
   if (true) {
-    return "0.30.2-next.17";
+    return "0.30.2-next.19";
   }
   return "0.0.0";
 }
@@ -137046,6 +137046,9 @@ function iosHeadlessFromEnv() {
 function androidHeadlessFromEnv() {
   return truthyEnv("ARGENT_EMULATOR_NO_WINDOW");
 }
+function androidGuestVulkanFromEnv() {
+  return truthyEnv("ARGENT_EMULATOR_GUEST_VULKAN");
+}
 
 // ../tool-server/src/tools/devices/boot-device.ts
 init_device_info();
@@ -137798,6 +137801,9 @@ var zodSchema9 = external_exports.object({
   sound: external_exports.boolean().optional().describe(
     "Android only: boot the emulator with audio output enabled. Defaults to false: argent boots emulators MUTED so several agent-driven devices don't all play sound on the host machine; pass `true` when the task involves playing, hearing, or testing audio. Takes effect at boot: if the emulator is already running muted, add `force: true` to reboot it with sound. A boot snapshot saved in the other audio mode can't be reused, so the first boot after toggling is a slower cold boot. The `boot-sound` argent flag flips this default to true. Ignored on iOS/Vega<flag:harmonyos>/HarmonyOS</flag:harmonyos>/Electron, which argent never mutes."
   ),
+  guestVulkan: external_exports.boolean().optional().describe(
+    "Android on a macOS host only: boot the emulator with guest Vulkan. Defaults to false: guest Vulkan crashes Chrome's GPU process, which breaks Chrome and Custom Tab sign-in flows. Without it apps find no Vulkan device, although the guest still lists the Vulkan features, so a Vulkan-only renderer such as WebGPU (react-native-wgpu) draws nothing; pass `true` to test one. Takes effect at boot: an emulator already running in the other mode is reused with a `note`, and `force: true` reboots it. A boot snapshot saved in the other mode can't be reused, so the first boot after toggling is a slower cold boot. The `ARGENT_EMULATOR_GUEST_VULKAN` env var flips this default to true. Ignored on other hosts and platforms."
+  ),
   headless: external_exports.boolean().optional().describe(
     "iOS only: boot the simulator core WITHOUT opening its GUI window (Simulator.app, or Device Hub on Xcode 27+). The device still streams via simulator-server; used by Argent Lens. Set the `ARGENT_SIMULATOR_NO_WINDOW` env var (1/true/yes) to force this host-wide without passing the flag per call (the iOS analog of `ARGENT_EMULATOR_NO_WINDOW`). Ignored on Android/Vega<flag:harmonyos>/HarmonyOS</flag:harmonyos>/Electron, which have no equivalent GUI step."
   ),
@@ -137865,14 +137871,27 @@ function selectGpuMode() {
   }
   return process.platform === "linux" ? "swiftshader" : "auto";
 }
+function guestVulkanArgs(guestVulkan) {
+  if (process.platform !== "darwin") return [];
+  return ["-feature", guestVulkan ? "Vulkan" : "-Vulkan"];
+}
+async function runningGuestVulkanNote(serial, guestVulkan) {
+  if (process.platform !== "darwin") return void 0;
+  const prop = await adbShell(serial, "getprop ro.boot.hardware.vulkan", { timeoutMs: 5e3 }).then((out) => out.trim()).catch(() => null);
+  if (prop === null || prop !== "" === guestVulkan) return void 0;
+  return guestVulkan ? "This emulator was already running without guest Vulkan, so apps find no Vulkan device. Pass `force: true` to reboot it with guest Vulkan." : "This emulator was already running with guest Vulkan, which can crash Chrome's GPU process. Pass `force: true` to reboot it without guest Vulkan.";
+}
 var BOOT_POLL_INTERVALS_MS = {
   serialByAvd: 1500,
   // findSerialByAvdName: re-scan when >1 new emulator appeared
   adbRegister: 1e3,
   // attemptBoot stage 2: re-scan adb devices for the new serial
-  earlyExit: 500
+  earlyExit: 500,
   // createEarlyExitRacer: re-check the crash latch during a blocking adb call
+  serialGone: 500
+  // awaitEmulatorsGone: re-scan adb devices for a killed emulator
 };
+var EMULATOR_GONE_BUDGET_MS = 3e4;
 var FRAME_PROBE = "screencap -p 2>/dev/null | wc -c | awk '$1>20000{print 1;exit} {print 0}'";
 async function killEmulatorQuietly(serial, child) {
   if (serial) {
@@ -137952,18 +137971,28 @@ async function findSerialByAvdName(avdName, deadline) {
   }
   return null;
 }
-async function listNewEmulatorSerials(before) {
+async function listEmulatorSerials() {
   const { stdout } = await runAdb(["devices"], { timeoutMs: 3e3 }).catch(() => ({
     stdout: "",
     stderr: ""
   }));
-  const lines = stdout.split("\n");
   const now = [];
-  for (const line of lines) {
+  for (const line of stdout.split("\n")) {
     const m = line.match(/^(emulator-\d+)\s+/);
     if (m) now.push(m[1]);
   }
-  return now.filter((s) => !before.has(s));
+  return now;
+}
+async function listNewEmulatorSerials(before) {
+  return (await listEmulatorSerials()).filter((s) => !before.has(s));
+}
+async function awaitEmulatorsGone(serials) {
+  const deadline = Date.now() + EMULATOR_GONE_BUDGET_MS;
+  while (serials.length > 0 && Date.now() < deadline) {
+    const listed = await listEmulatorSerials();
+    if (!serials.some((s) => listed.includes(s))) return;
+    await new Promise((r) => setTimeout(r, BOOT_POLL_INTERVALS_MS.serialGone));
+  }
 }
 async function bootIos(udid, registry2, force, headless) {
   if (process.platform !== "darwin") {
@@ -138263,7 +138292,10 @@ async function bootAndroidImpl(params) {
   await ensureDep("adb");
   await ensureDep("emulator");
   const gpuMode = selectGpuMode();
-  const extraEmulatorArgs = androidHeadlessFromEnv() ? ["-no-window"] : [];
+  const extraEmulatorArgs = [
+    ...androidHeadlessFromEnv() ? ["-no-window"] : [],
+    ...guestVulkanArgs(params.guestVulkan)
+  ];
   const hardeningArgs = launchHardeningArgs(params.sound);
   for (const msg of linuxBootDiagnostics(params.avdName) ?? []) {
     console.warn(`[boot-device:linux] ${msg}`);
@@ -138312,26 +138344,31 @@ async function bootAndroidImpl(params) {
   });
   const existingDevices = await listAndroidDevices().catch(() => []);
   let hotBootFailureReason;
+  const dropKilledEmulator = async (serial) => {
+    await awaitEmulatorsGone([serial]);
+    const refreshed = await listAndroidDevices().catch(() => existingDevices);
+    existingDevices.splice(0, existingDevices.length, ...refreshed);
+  };
   const alreadyRunning = existingDevices.find(
     (d) => d.isEmulator && d.avdName === params.avdName && d.state === "device"
   );
   if (alreadyRunning) {
     if (params.force) {
       await killEmulatorQuietly(alreadyRunning.serial);
-      const refreshed = await listAndroidDevices().catch(() => existingDevices);
-      existingDevices.splice(0, existingDevices.length, ...refreshed);
+      await dropKilledEmulator(alreadyRunning.serial);
     } else {
       try {
         await assertScreencapAlive(alreadyRunning.serial);
+        const note = await runningGuestVulkanNote(alreadyRunning.serial, params.guestVulkan);
         return {
           platform: "android",
           serial: alreadyRunning.serial,
           avdName: params.avdName,
-          booted: true
+          booted: true,
+          ...note ? { note } : {}
         };
       } catch (_err) {
-        const refreshed = await listAndroidDevices().catch(() => existingDevices);
-        existingDevices.splice(0, existingDevices.length, ...refreshed);
+        await dropKilledEmulator(alreadyRunning.serial);
       }
     }
   }
@@ -138384,6 +138421,7 @@ async function bootAndroidImpl(params) {
         };
       } catch (err) {
         hotBootFailureReason = err instanceof Error ? err.message : String(err);
+        await awaitEmulatorsGone(await listNewEmulatorSerials(serialsBefore));
         const refreshed = new Set(
           (await listAndroidDevices().catch(() => [])).map((d) => d.serial)
         );
@@ -138949,7 +138987,7 @@ function createBootDeviceTool(registry2) {
     description: `Start an iOS simulator, launch an Android emulator, start a Vega (Fire TV) Virtual Device, <flag:harmonyos>start a HarmonyOS emulator, </flag:harmonyos>or spawn an Electron app and wait until it is ready to accept interactions.
 Pick the platform by which argument you pass: 'udid' for an iOS simulator from list-devices, 'avdName' for an Android AVD (a serial is assigned automatically), 'vvdImage' for a Vega VVD (the 'vvdImage' of a vega device from list-devices, e.g. 'tv'), <flag:harmonyos>'harmonyInstance' for a HarmonyOS emulator instance (the 'name' of a harmony device from list-devices), </flag:harmonyos>or 'electronAppPath' for an Electron app (a CDP remote-debugging port is picked automatically, or pass 'electronPort' to fix one).
 Use at the start of a session once you have picked a target.
-Returns a tagged payload: { platform: 'ios', udid, booted } or { platform: 'android', serial, avdName, booted } or { platform: 'vega', serial, vvdImage, booted } or <flag:harmonyos>{ platform: 'harmony', udid, instanceName, booted, note? } or </flag:harmonyos>{ platform: 'chromium', id, port, pid, booted } (an Electron app boots as a Chromium/CDP device).
+Returns a tagged payload: { platform: 'ios', udid, booted } or { platform: 'android', serial, avdName, booted, note? } or { platform: 'vega', serial, vvdImage, booted } or <flag:harmonyos>{ platform: 'harmony', udid, instanceName, booted, note? } or </flag:harmonyos>{ platform: 'chromium', id, port, pid, booted } (an Electron app boots as a Chromium/CDP device).
 Android boots take 2\u201310 minutes depending on machine and cold/warm state; the tool transparently hot-boots from the AVD's default_boot snapshot when usable and falls back to cold boot otherwise. Vega starts the single SDK-managed VVD via the vega CLI (~10s) and returns once it reports running. If an Android/Electron boot stage fails, the tool terminates the device it spawned so the next retry starts clean.<flag:harmonyos>
 HarmonyOS hands the instance to DevEco Studio's Emulator manager, then waits for it to register with 'hdc' and returns its connect key as 'udid', the id the interaction tools drive. The manager itself reports no readiness signal and never names a port, so an instance that is already running is left alone unless you pass 'force: true'; when the key could not be resolved the payload names the instance instead, and a 'note' is present whenever the boot left something unproven: no key and why, or a key that is not yet answering or could not be checked against the instance. Huawei serves the emulator images only within mainland China, so a host outside it usually has no instance to start; one that already has an image is started like any other.</flag:harmonyos>`,
     alwaysLoad: true,
@@ -139012,7 +139050,8 @@ HarmonyOS hands the instance to DevEco Studio's Emulator manager, then waits for
           // An explicit argument always wins; the `boot-sound` flag only moves
           // the default when the caller left `sound` unset. Read live per call
           // so `argent enable/disable boot-sound` applies without a restart.
-          sound: params.sound ?? isFlagEnabled("boot-sound")
+          sound: params.sound ?? isFlagEnabled("boot-sound"),
+          guestVulkan: params.guestVulkan ?? androidGuestVulkanFromEnv()
         });
       }
       if (hasVega) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@swmansion/argent",
-  "version": "0.30.2-next.17",
+  "version": "0.30.2-next.19",
   "mcpName": "io.github.software-mansion/argent",
   "description": "MCP server for iOS Simulator and Android Emulator control",
   "license": "Apache-2.0",