stim 1.20.2 → 1.22.0

package/dist/{device-capacity-CBUAcRyQ.mjs → device-capacity-DK5_EwRS.mjs}

@@ -1,18 +1,19 @@
-import { V as deviceSlotPlatforms, W as projectDeviceSlots, _ as loadConfig$1, d as getConfigDir, j as ownership_claim_exports, u as getConcurrencyLimits } from "./config-BYDxlMY3.mjs";
-import { g as deviceReclaimIdleMinutesSetting } from "./settings-B717odTD.mjs";
-import { w as workspaceLogsDir$1 } from "./workspace-state-DJt_MMvf.mjs";
-import { a as formatElapsed, l as phaseLine } from "./command-output-BTy8hZ0F.mjs";
-import { O as listAdbDevices } from "./android-Mz_Inn3w.mjs";
-import { T as canonicalPath, f as withIdleWorkspace } from "./workspaces-C36s2jb9.mjs";
-import { Nt as recordCapacityRefusal, Pt as recordCapacityWait } from "./budget-f7516Zk0.mjs";
-import { a as withWorkspaceProcessLock, o as workspaceProcessLockError } from "./named-ports-4WopRPg-.mjs";
-import { r as createNdjsonWriter } from "./ndjson-GOnbyvso.mjs";
-import { d as listAllIosSims, l as iosRuntimeMatches, y as parseRuntimeVersion } from "./ios-RkW4pnQf.mjs";
-import { n as dueIdleDevices, r as shutDownIdleDevices } from "./idle-shutdown-DtxhPTKe.mjs";
+import { a as workspaceProcessLockError, i as withWorkspaceProcessLock, x as ownership_claim_exports } from "./exec-DEoAhcze.mjs";
+import { m as workspaceLogsDir$1 } from "./paths-DQtTgsBf.mjs";
+import { G as projectDeviceSlots, H as deviceSlotPlatforms, _ as loadConfig$1, d as getConfigDir, u as getConcurrencyLimits } from "./config-DlrsduwG.mjs";
+import { a as formatElapsed, l as phaseLine } from "./command-output-gwpm28fu.mjs";
+import { g as deviceReclaimIdleMinutesSetting } from "./settings-C7O8A6ZI.mjs";
+import { r as createNdjsonWriter } from "./ndjson-CgE_o3Dl.mjs";
+import { K as recordCapacityRefusal, q as recordCapacityWait } from "./budget-Cvwn54qV.mjs";
+import { t as canonicalPath } from "./paths-BsJMoPP2.mjs";
+import { f as withIdleWorkspace } from "./workspaces-CpANmBlq.mjs";
+import { A as listAdbDevices, j as listAdbDevicesAsync } from "./android-C7sVmyI9.mjs";
+import { d as listAllIosSims, f as listAllIosSimsAsync, l as iosRuntimeMatches, y as parseRuntimeVersion } from "./ios-hcBpnEGk.mjs";
+import { n as dueIdleDevices, r as shutDownIdleDevices } from "./idle-shutdown-DDg3SdvY.mjs";
 import { realpathSync } from "node:fs";
 import { basename, join } from "node:path";
-import { DEVICE_RECLAIM_REASON, automaticMachineEnabled } from "@stim-cli/core/state";
 import { LOG_ROTATE_BYTES, workspaceId } from "@stim-cli/core";
+import { DEVICE_RECLAIM_REASON, automaticMachineEnabled } from "@stim-cli/core/state";
 import { setTimeout } from "node:timers/promises";
 //#region src/devices/queue-reclaim.ts
 async function reclaimIdleDevice(root, idleMs, out, now, skipped) {
@@ -203,6 +204,34 @@ function countLiveOwnedDevices(sources = {}, { exclude = [] } = {}) {
 		throw error;
 	}
 }
+async function listedAsync(source, empty) {
+	try {
+		return await source();
+	} catch (error) {
+		if (toolAbsent(error)) return empty;
+		throw new DeviceCountUnavailable("", { cause: error });
+	}
+}
+async function countLiveOwnedDevicesAsync(operation) {
+	try {
+		operation.signal.throwIfAborted();
+		const config = loadConfig$1();
+		const booting = readBootingDevices();
+		const [sims, adb] = await Promise.all([process.platform === "darwin" ? listedAsync(() => listAllIosSimsAsync({ timeoutMs: LISTING_TIMEOUT_MS }), []) : [], recordsOwnedEmulator(config) ? listedAsync(() => listAdbDevicesAsync({ timeoutMs: LISTING_TIMEOUT_MS }), NO_ADB) : NO_ADB]);
+		operation.signal.throwIfAborted();
+		return countLiveOwnedDevices({
+			config,
+			booting,
+			sims,
+			adb
+		});
+	} catch (error) {
+		operation.signal.throwIfAborted();
+		if ((0, ownership_claim_exports.isClaimRefusal)(error)) return { unknown: error.message };
+		if (error instanceof DeviceCountUnavailable) return { unknown: uncountedRefusal(error.cause).message };
+		throw error;
+	}
+}
 function workspaceHasLiveDevice({ platform, project, slot = "default", sims = [], adbEmulators = [] } = {}) {
 	if (!platform) return false;
 	const record = deviceSlotPlatforms(project, slot)?.[platform];
@@ -586,4 +615,4 @@ function unknownAndroidDeviceProfileRefusal(requested, profiles) {
 	};
 }
 //#endregion
-export { deviceTypeMismatch as a, runtimeMismatch as c, unknownIosDeviceTypeRefusal as d, unknownIosRuntimeRefusal as f, countLiveOwnedDevices as i, unknownAndroidDeviceProfileRefusal as l, DeviceAdmissionRefusal as n, layerNote as o, withDeviceBootAdmission as p, checkDeviceCapacity as r, peekDeviceSlots as s, DEFAULT_DEVICE_SLOT_WAIT_MS as t, unknownAndroidSystemImageRefusal as u };
+export { countLiveOwnedDevicesAsync as a, peekDeviceSlots as c, unknownAndroidSystemImageRefusal as d, unknownIosDeviceTypeRefusal as f, countLiveOwnedDevices as i, runtimeMismatch as l, withDeviceBootAdmission as m, DeviceAdmissionRefusal as n, deviceTypeMismatch as o, unknownIosRuntimeRefusal as p, checkDeviceCapacity as r, layerNote as s, DEFAULT_DEVICE_SLOT_WAIT_MS as t, unknownAndroidDeviceProfileRefusal as u };

package/dist/device-host-worker.mjs

@@ -1,25 +1,27 @@
-import { D as withConfigLock$1, _ as loadConfig$1, c as ensureConfig, k as process_identity_exports } from "./config-BYDxlMY3.mjs";
-import { t as getExecutor } from "./exec-DqKo9GKJ.mjs";
-import { t as spawnEntry } from "./spawn-entry-Dcb7sDUz.mjs";
-import { c as writeWorkspaceState, p as ensureWorkspaceStorage } from "./workspace-state-DJt_MMvf.mjs";
-import { A as listAvds, B as ownedAvdSystemImage, D as hostSystemImageArch, E as getAvdNameForSerial, J as resolveOwnedAvdSerial, O as listAdbDevices, R as ownedAvdName, W as pickDefaultSystemImage, _ as avdStorageRoots, a as androidDeviceAbi, b as createOwnedAvd, d as androidToolPath, f as assertOwnedAvdStopped, h as avdPathExists, j as listInstalledSystemImages, k as listAvdDeviceProfiles, q as resetAdoptedAvd, t as DEFAULT_AVD_DEVICE_PROFILE, tt as waitForBoot, v as bootAndroidEmulator } from "./android-Mz_Inn3w.mjs";
-import { t as forgetCreatedDevice } from "./created-devices-Dzd5C2LF.mjs";
-import { b as teardownOwnedIosSim, v as teardownOwnedAvd } from "./workspaces-C36s2jb9.mjs";
-import { r as createNdjsonWriter } from "./ndjson-GOnbyvso.mjs";
-import { C as resetIosKeychain, P as readHostMemoryPressure, T as resolveIosCreation, a as createOwnedIosSim, d as listAllIosSims, g as listUserApps, k as uninstallIosApp, n as bootIosSim, w as resetIosPrivacy } from "./ios-RkW4pnQf.mjs";
-import { i as macosProcess, o as requiredMacosRecord } from "./state-CG_OFoaA.mjs";
-import { S as launchIosApp, T as writeDebugHttpHost, b as launchAndroidApp, g as installAndroidApp, s as androidAppProcess, v as installIosApp, w as reverseMetroPorts, x as launchAndroidReleaseApp, y as iosAppProcess } from "./app-install-BIKtMfPq.mjs";
-import { i as countLiveOwnedDevices } from "./device-capacity-CBUAcRyQ.mjs";
-import { _ as findAapt } from "./support-DMTqj3Hm.mjs";
-import { n as parseLogcatLine, r as parsePidof, t as androidClockOffset } from "./android-HqP1_vB_.mjs";
-import { r as stopMacosAppHeld } from "./stop-DPEhunlw.mjs";
-import { n as parseLogStreamLine } from "./ios-nOLJGVdy.mjs";
-import { chmodSync, closeSync, copyFileSync, createReadStream, existsSync, lstatSync, mkdirSync, openSync, readFileSync, readdirSync, realpathSync, renameSync, rmSync, statfsSync, symlinkSync, writeFileSync } from "node:fs";
-import { dirname, isAbsolute, join, posix, relative, sep } from "node:path";
-import { assertHostedDeviceLedger, hostedAppArea, hostedAppAttempt, hostedAppBlobs, hostedConsolePort, hostedMacosAppSlot, hostedMacosBundleId, hostedNativeLogsDir, isJsonObject, parseHostedOfferRequest, readHostedApp, readHostedAppMetadata, readHostedDevice, readHostedNativeLogsCheckpoint, readMacosRecord, readNdjsonGenerations } from "@stim-cli/core/state";
-import { LOG_ROTATE_BYTES, configDir, withDirLock } from "@stim-cli/core";
+import { t as getExecutor } from "./exec-DEoAhcze.mjs";
+import { n as ensureWorkspaceStorage } from "./paths-DQtTgsBf.mjs";
+import { O as withConfigLockAsync$1, _ as loadConfig$1, c as ensureConfig } from "./config-DlrsduwG.mjs";
+import { d as writeWorkspaceState } from "./workspace-state-U08dEzhG.mjs";
+import { i as macosProcess, o as requiredMacosRecord } from "./state-08I3hw3_.mjs";
+import { r as createNdjsonWriter } from "./ndjson-CgE_o3Dl.mjs";
+import { Cn as launchAndroidApp, Dn as reverseMetroPorts, On as writeDebugHttpHost, Sn as iosAppProcess, Tn as launchIosApp, dn as androidAppProcess, wn as launchAndroidReleaseApp, xn as installIosApp, yn as installAndroidApp } from "./budget-Cvwn54qV.mjs";
+import { D as teardownOwnedAvd, k as teardownOwnedIosSim } from "./workspaces-CpANmBlq.mjs";
+import { t as forgetCreatedDevice } from "./created-devices-x9rN6bhs.mjs";
+import { $ as resetAdoptedAvd, A as listAdbDevices, D as getAvdNameForSerial, F as listAvdsAsync, I as listInstalledSystemImages, K as ownedAvdSystemImage, M as listAvdDeviceProfiles, O as getAvdNameForSerialAsync, U as ownedAvdName, X as pickDefaultSystemImage, a as androidDeviceAbi, d as androidToolPath, et as resolveOwnedAvdSerialAsync, f as assertOwnedAvdStopped, g as avdPathExists, k as hostSystemImageArch, ot as waitForBoot, t as DEFAULT_AVD_DEVICE_PROFILE, v as avdStorageRoots, x as createOwnedAvd, y as bootAndroidEmulator } from "./android-C7sVmyI9.mjs";
+import { C as resetIosKeychain, P as readHostMemoryPressure, T as resolveIosCreation, a as createOwnedIosSim, d as listAllIosSims, g as listUserApps, k as uninstallIosApp, n as bootIosSim, w as resetIosPrivacy } from "./ios-hcBpnEGk.mjs";
+import { r as stopMacosAppHeld } from "./stop-Dky10AEJ.mjs";
+import { t as spawnEntry } from "./spawn-entry-jw19m8Nl.mjs";
+import { i as countLiveOwnedDevices } from "./device-capacity-DK5_EwRS.mjs";
+import { n as parseLogcatLine, r as parsePidof, t as androidClockOffset } from "./android-DR5lZ2Az.mjs";
+import { _ as findAapt } from "./support-yUiOjnVY.mjs";
+import { t as waitForMacosRegistration } from "./registration-BcRgF6Ox.mjs";
+import { n as parseLogStreamLine } from "./ios-xtlRHaeB.mjs";
 import { createHash, randomUUID } from "node:crypto";
+import { chmodSync, closeSync, copyFileSync, createReadStream, existsSync, lstatSync, mkdirSync, openSync, readFileSync, readdirSync, realpathSync, renameSync, rmSync, statfsSync, symlinkSync, writeFileSync } from "node:fs";
 import { availableParallelism, freemem, homedir, loadavg } from "node:os";
+import { dirname, isAbsolute, join, posix, relative, sep } from "node:path";
+import { LOG_ROTATE_BYTES, configDir, withDirLock, withDirLockAsync } from "@stim-cli/core";
+import { assertHostedDeviceLedger, hostedAppArea, hostedAppAttempt, hostedAppBlobs, hostedConsolePort, hostedMacosAppSlot, hostedMacosBundleId, hostedNativeLogsDir, isJsonObject, parseHostedOfferRequest, readHostedApp, readHostedAppMetadata, readHostedDevice, readHostedNativeLogsCheckpoint, readNdjsonGenerations } from "@stim-cli/core/state";
 //#region src/device-host/android-app.ts
 async function digest$1(path) {
 	const hash = createHash("sha256");
@@ -60,7 +62,7 @@ async function installHostedAndroidApp(home, session, attempt, device, metro) {
 	if (nativeCode !== void 0 && !nativeCode.split(/\s+/).includes(`'${device.architecture}'`)) throw new Error("The APK has no native library slice for the hosted emulator architecture.");
 	assertHostedAndroidTarget(home, device);
 	const sdkExecutor = hostedAndroidExecutor();
-	const installed = installAndroidApp({
+	const installed = await installAndroidApp({
 		serial: device.serial,
 		apkPath: apk,
 		packageName: record.bundleId
@@ -68,14 +70,14 @@ async function installHostedAndroidApp(home, session, attempt, device, metro) {
 	if (!installed.ok) throw new Error(installed.reason ?? "Hosted APK installation was not established.");
 	assertHostedAndroidTarget(home, device);
 	if (record.mode === "development" && !metro) throw new Error("Hosted Android development launch requires its Metro bridge.");
-	const launched = record.mode === "development" && metro ? launchAndroidApp({
+	const launched = record.mode === "development" && metro ? await launchAndroidApp({
 		serial: device.serial,
 		packageName: record.bundleId,
 		metroPort: metro.devicePort,
 		bridgePort: metro.bridgePort,
 		physical: true,
 		devClientScheme: record.devClientScheme
-	}, { exec: sdkExecutor }) : launchAndroidReleaseApp({
+	}, { exec: sdkExecutor }) : await launchAndroidReleaseApp({
 		serial: device.serial,
 		packageName: record.bundleId
 	}, { exec: sdkExecutor });
@@ -83,7 +85,7 @@ async function installHostedAndroidApp(home, session, attempt, device, metro) {
 	if (record.mode === "development") return "unverified";
 	for (let tries = 0; tries < 10; tries++) {
 		await new Promise((resolve) => setTimeout(resolve, 200));
-		if (androidAppProcess(device.serial, record.bundleId, { exec: sdkExecutor }).state === "running") return true;
+		if ((await androidAppProcess(device.serial, record.bundleId, { exec: sdkExecutor })).state === "running") return true;
 	}
 	return "unverified";
 }
@@ -99,24 +101,27 @@ function assertHostedAndroidTarget(home, device) {
 function hostedAndroidExecutor() {
 	const executor = getExecutor();
 	const adb = androidToolPath("adb");
+	const tool = (file) => file === "adb" ? adb : file;
 	return {
 		...executor,
-		runFile: (file, args, options) => executor.runFile(file === "adb" ? adb : file, args, options)
+		runFile: (file, args, options) => executor.runFile(tool(file), args, options),
+		runFileAsync: (file, args, options) => executor.runFileAsync(tool(file), args, options),
+		runFileQuietAsync: (file, args, options) => executor.runFileQuietAsync(tool(file), args, options)
 	};
 }
-function restoreHostedAndroidMetro(home, session, attempt, device, metro) {
+async function restoreHostedAndroidMetro(home, session, attempt, device, metro) {
 	const record = readHostedApp(session, attempt, home);
 	if (record.state !== "installed" || record.mode !== "development") throw new Error("Metro restore requires an installed development app.");
 	assertHostedAndroidTarget(home, device);
 	const exec = hostedAndroidExecutor();
-	const reversed = reverseMetroPorts({
+	const reversed = await reverseMetroPorts({
 		serial: device.serial,
 		metroPort: metro.bridgePort,
 		devicePorts: [metro.devicePort]
 	}, { exec });
 	if (reversed.failed) throw new Error(reversed.reason);
 	assertHostedAndroidTarget(home, device);
-	writeDebugHttpHost({
+	await writeDebugHttpHost({
 		serial: device.serial,
 		packageName: record.bundleId,
 		metroPort: metro.devicePort,
@@ -501,7 +506,7 @@ async function installHostedApp(home, session, attempt, device, metroPort) {
 	if (!/^\s*platform\s+IOSSIMULATOR\s*$/m.test(build) || !minimum || newer(minimum, device.runtime) || newer(plist("MinimumOSVersion"), device.runtime)) throw new Error("The executable platform or minimum OS is incompatible with the hosted simulator.");
 	assertHostedDeviceLedger(home, device.udid);
 	if (readHostedDevice(home).udid !== device.udid) throw new Error("The hosted device identity changed.");
-	const installed = installIosApp({
+	const installed = await installIosApp({
 		udid: device.udid,
 		appPath: app,
 		bundleId: record.bundleId,
@@ -511,7 +516,7 @@ async function installHostedApp(home, session, attempt, device, metroPort) {
 	if (!installed.ok) throw new Error(installed.reason ?? "Hosted app installation was not established.");
 	assertHostedDeviceLedger(home, device.udid);
 	if (readHostedDevice(home).udid !== device.udid) throw new Error("The hosted device identity changed.");
-	const launched = launchIosApp({
+	const launched = await launchIosApp({
 		udid: device.udid,
 		bundleId: record.bundleId,
 		metroPort: record.mode === "development" ? metroPort ?? null : null,
@@ -521,7 +526,7 @@ async function installHostedApp(home, session, attempt, device, metroPort) {
 	if (record.mode === "development") return "unverified";
 	for (let tries = 0; tries < 10; tries++) {
 		await new Promise((resolve) => setTimeout(resolve, 200));
-		if (iosAppProcess(device.udid, record.bundleId).state === "running") return true;
+		if ((await iosAppProcess(device.udid, record.bundleId)).state === "running") return true;
 	}
 	return "unverified";
 }
@@ -530,10 +535,10 @@ async function installHostedApp(home, session, attempt, device, metroPort) {
 function inventory() {
 	return listAllIosSims({ includeUnavailable: true });
 }
-function selectHostedIosDevice(selectors) {
+async function selectHostedIosDevice(selectors) {
 	inventory();
 	if (readHostMemoryPressure(getExecutor()) !== "normal") throw new Error("Host memory pressure is unknown or elevated.");
-	const selected = resolveIosCreation(selectors);
+	const selected = await resolveIosCreation(selectors);
 	if (!selected.deviceType || !selected.runtime) throw new Error("The installed simulator type or runtime could not be established.");
 	if (process.arch !== "arm64" && process.arch !== "x64") throw new Error("Unsupported simulator host architecture.");
 	return {
@@ -553,15 +558,15 @@ async function runHostedDevice(mode, selectors, app) {
 		if (mode === "prepare") {
 			creationStarted = existsSync(join(home, "hosted-device.json")) || existsSync(join(home, "created-devices.json"));
 			if (creationStarted) throw new Error("This hosted worker home already has a device record. Attach or stop its existing session.");
-			const selected = selectHostedIosDevice(selectors);
+			const selected = await selectHostedIosDevice(selectors);
 			creationStarted = true;
-			const created = createOwnedIosSim("hosted", {}, selected);
+			const created = await createOwnedIosSim("hosted", {}, selected);
 			device = {
 				...selected,
 				udid: created.udid,
 				name: created.name
 			};
-			withDirLock(join(home, "hosted-device.lock"), () => {
+			await withDirLockAsync(join(home, "hosted-device.lock"), () => {
 				const temporary = join(home, "hosted-device.json.tmp");
 				writeFileSync(temporary, JSON.stringify(device), { mode: 384 });
 				renameSync(temporary, join(home, "hosted-device.json"));
@@ -581,7 +586,7 @@ async function runHostedDevice(mode, selectors, app) {
 			if (!current || !current.available || !current.name.startsWith("stim-") || current.name !== device.name || current.state !== "Shutdown") throw new Error("The parked hosted simulator is missing, renamed or not Shutdown.");
 			let choice;
 			try {
-				choice = selectHostedIosDevice(selectors);
+				choice = await selectHostedIosDevice(selectors);
 			} catch (error) {
 				if (mode === "inspect") return {
 					state: "incompatible",
@@ -603,10 +608,10 @@ async function runHostedDevice(mode, selectors, app) {
 			};
 			await bootIosSim(device.udid, { openViewer: false });
 			if (inventory().find((sim) => sim.udid === device.udid)?.state !== "Booted") throw new Error("Hosted simulator boot could not be verified.");
-			resetIosPrivacy(device.udid);
-			resetIosKeychain(device.udid);
-			for (const bundleId of listUserApps(device.udid)) uninstallIosApp(device.udid, bundleId);
-			withDirLock(join(home, "hosted-device.lock"), () => {
+			await resetIosPrivacy(device.udid);
+			await resetIosKeychain(device.udid);
+			for (const bundleId of await listUserApps(device.udid)) await uninstallIosApp(device.udid, bundleId);
+			await withDirLockAsync(join(home, "hosted-device.lock"), () => {
 				const temporary = join(home, "hosted-device.json.tmp");
 				writeFileSync(temporary, JSON.stringify(device), { mode: 384 });
 				renameSync(temporary, join(home, "hosted-device.json"));
@@ -618,7 +623,7 @@ async function runHostedDevice(mode, selectors, app) {
 			};
 		}
 		if (mode === "park") {
-			const outcome = teardownOwnedIosSim(device.udid);
+			const outcome = await teardownOwnedIosSim(device.udid);
 			if (outcome.status !== "torn-down" || inventory().find((sim) => sim.udid === device.udid)?.state !== "Shutdown") throw new Error(outcome.reason ?? "Hosted simulator shutdown could not be verified.");
 			removeHostedAppData(home, { keepBlobs: true });
 			return {
@@ -643,7 +648,7 @@ async function runHostedDevice(mode, selectors, app) {
 				device
 			};
 		}
-		const outcome = teardownOwnedIosSim(device.udid, { del: true });
+		const outcome = await teardownOwnedIosSim(device.udid, { del: true });
 		if (outcome.status !== "torn-down" && outcome.status !== "missing") throw new Error(outcome.reason ?? "Hosted simulator teardown was not established.");
 		const after = inventory().find((sim) => sim.udid === device.udid);
 		if (after) throw new Error(`Hosted simulator ${device.udid} is still listed (${after.state}); deletion could not be verified. If its runtime is unavailable, delete it with xcrun simctl delete and stop the session again.`);
@@ -696,7 +701,7 @@ async function runHostedAndroidDevice(mode, request, app) {
 			} : void 0;
 			if (mode === "reverse") {
 				if (!metro) throw new Error("Hosted Android Metro restore needs its bridge and device ports.");
-				restoreHostedAndroidMetro(home, request.session, app.attempt, device, metro);
+				await restoreHostedAndroidMetro(home, request.session, app.attempt, device, metro);
 				return {
 					state: "ready",
 					device
@@ -715,7 +720,7 @@ async function runHostedAndroidDevice(mode, request, app) {
 			if (!/^[a-f0-9-]{36}$/.test(request.session) || !hostedConsolePort(request.consolePort)) throw new Error("Hosted Android prepare needs its server-selected session and console port.");
 			const choice = selectHostedAndroidDevice(request);
 			const avdName = ownedAvdName(`hosted-${request.session}`);
-			if (listAvds({ timeoutMs: 5e3 }).includes(avdName) || portIsOccupied(request.consolePort)) throw new Error("The hosted AVD name or selected console port is already in use.");
+			if ((await listAvdsAsync({ timeoutMs: 5e3 })).includes(avdName) || portIsOccupied(request.consolePort)) throw new Error("The hosted AVD name or selected console port is already in use.");
 			const selected = {
 				avdName,
 				serial: `emulator-${request.consolePort}`,
@@ -742,7 +747,7 @@ async function runHostedAndroidDevice(mode, request, app) {
 			});
 			assertHostedDeviceLedger(home, avdName, "android");
 			if (portIsOccupied(selected.consolePort)) throw new Error("The selected Android console port became occupied.");
-			bootAndroidEmulator(avdName, selected.consolePort, {
+			await bootAndroidEmulator(avdName, selected.consolePort, {
 				openViewer: false,
 				logFile: join(home, "emulator.log")
 			});
@@ -756,7 +761,7 @@ async function runHostedAndroidDevice(mode, request, app) {
 					packageManager
 				})}`);
 			}
-			if (getAvdNameForSerial(selected.serial) !== avdName || androidDeviceAbi(selected.serial) !== selected.architecture) throw new Error("Hosted Android boot could not be verified for its exact owned AVD.");
+			if (await getAvdNameForSerialAsync(selected.serial) !== avdName || androidDeviceAbi(selected.serial) !== selected.architecture) throw new Error("Hosted Android boot could not be verified for its exact owned AVD.");
 			return {
 				state: "ready",
 				device: selected
@@ -765,10 +770,10 @@ async function runHostedAndroidDevice(mode, request, app) {
 		device = readHostedDevice(home, "android");
 		const ledger = assertHostedDeviceLedger(home, device.avdName, "android", { allowEmpty: mode === "stop" });
 		if (mode === "inspect" || mode === "adopt") {
-			if (device.avdName !== ownedAvdName(`hosted-${request.session}`) || !listAvds({ timeoutMs: 5e3 }).includes(device.avdName)) throw new Error("The parked hosted AVD is missing or names another session.");
-			if (!resolveOwnedAvdSerial(device.avdName, { timeoutMs: 5e3 }).notRunning) throw new Error("The parked hosted AVD is missing, not owned or running.");
+			if (device.avdName !== ownedAvdName(`hosted-${request.session}`) || !(await listAvdsAsync({ timeoutMs: 5e3 })).includes(device.avdName)) throw new Error("The parked hosted AVD is missing or names another session.");
+			if (!(await resolveOwnedAvdSerialAsync(device.avdName, { timeoutMs: 5e3 })).notRunning) throw new Error("The parked hosted AVD is missing, not owned or running.");
 			assertOwnedAvdStopped(device.avdName);
-			if (getAvdNameForSerial(device.serial) === device.avdName) throw new Error("The parked hosted emulator is still running.");
+			if (await getAvdNameForSerialAsync(device.serial) === device.avdName) throw new Error("The parked hosted emulator is still running.");
 			if (ownedAvdSystemImage(device.avdName) !== device.systemImage) throw new Error("The parked hosted AVD system image no longer matches its device record.");
 			let choice;
 			try {
@@ -798,12 +803,12 @@ async function runHostedAndroidDevice(mode, request, app) {
 				consolePort: request.consolePort,
 				serial: `emulator-${request.consolePort}`
 			};
-			withDirLock(join(home, "hosted-device.lock"), () => {
+			await withDirLockAsync(join(home, "hosted-device.lock"), () => {
 				const temporary = join(home, "hosted-device.json.tmp");
 				writeFileSync(temporary, JSON.stringify(device), { mode: 384 });
 				renameSync(temporary, join(home, "hosted-device.json"));
 			});
-			bootAndroidEmulator(device.avdName, device.consolePort, {
+			await bootAndroidEmulator(device.avdName, device.consolePort, {
 				openViewer: false,
 				logFile: join(home, "emulator.log")
 			});
@@ -817,7 +822,7 @@ async function runHostedAndroidDevice(mode, request, app) {
 					packageManager
 				})}`);
 			}
-			if (getAvdNameForSerial(device.serial) !== device.avdName || androidDeviceAbi(device.serial) !== device.architecture) throw new Error("Hosted Android boot could not be verified for its exact owned AVD.");
+			if (await getAvdNameForSerialAsync(device.serial) !== device.avdName || androidDeviceAbi(device.serial) !== device.architecture) throw new Error("Hosted Android boot could not be verified for its exact owned AVD.");
 			await resetAdoptedAvd(device.avdName, device.serial, "");
 			removeHostedAppData(home, { keepBlobs: true });
 			return {
@@ -826,10 +831,10 @@ async function runHostedAndroidDevice(mode, request, app) {
 			};
 		}
 		if (mode === "park") {
-			const outcome = teardownOwnedAvd(device.avdName, {});
+			const outcome = await teardownOwnedAvd(device.avdName, {});
 			if (outcome.status !== "torn-down") throw new Error(outcome.reason ?? "Hosted Android shutdown was not established.");
 			assertOwnedAvdStopped(device.avdName);
-			if (getAvdNameForSerial(device.serial) === device.avdName) throw new Error("The hosted Android emulator is still running.");
+			if (await getAvdNameForSerialAsync(device.serial) === device.avdName) throw new Error("The hosted Android emulator is still running.");
 			removeHostedAppData(home, { keepBlobs: true });
 			return {
 				state: "parked",
@@ -837,15 +842,15 @@ async function runHostedAndroidDevice(mode, request, app) {
 			};
 		}
 		if (ledger === "listed") {
-			withConfigLock$1(() => {
+			await withConfigLockAsync$1(() => {
 				if (!loadConfig$1()) ensureConfig();
 			});
-			const outcome = teardownOwnedAvd(device.avdName, { del: true });
+			const outcome = await teardownOwnedAvd(device.avdName, { del: true });
 			if (outcome.status !== "torn-down" && outcome.status !== "missing") throw new Error(outcome.reason ?? "Hosted Android deletion was not established.");
 		}
 		const name = device.avdName;
-		if (listAvds({ timeoutMs: 5e3 }).includes(name) || avdStorageRoots().some((root) => avdPathExists(join(root, `${name}.ini`)) || avdPathExists(join(root, `${name}.avd`)))) throw new Error("The hosted AVD or its data still exists; deletion could not be verified.");
-		if (getAvdNameForSerial(device.serial) === device.avdName) throw new Error("The hosted Android emulator is still running.");
+		if ((await listAvdsAsync({ timeoutMs: 5e3 })).includes(name) || avdStorageRoots().some((root) => avdPathExists(join(root, `${name}.ini`)) || avdPathExists(join(root, `${name}.avd`)))) throw new Error("The hosted AVD or its data still exists; deletion could not be verified.");
+		if (await getAvdNameForSerialAsync(device.serial) === device.avdName) throw new Error("The hosted Android emulator is still running.");
 		if (ledger === "listed") forgetCreatedDevice("android", device.avdName);
 		removeHostedAppData(home);
 		return {
@@ -1067,7 +1072,6 @@ async function runHostedMacosApp(mode, request, app) {
 		});
 		const fd = openSync(join(home, "macos-supervisor.log"), "a", 384);
 		let child;
-		let spawnError;
 		const env = {};
 		for (const key of [
 			"PATH",
@@ -1095,31 +1099,24 @@ async function runHostedMacosApp(mode, request, app) {
 				stdio: [
 					"ignore",
 					fd,
-					fd
+					fd,
+					"ipc"
 				],
 				cwd: canonicalRunRoot,
 				env
 			});
-			child.once("error", (error) => {
-				spawnError = error;
-			});
 			child.unref();
 		} finally {
 			closeSync(fd);
 		}
 		const deadline = Date.now() + 2e4;
-		while (Date.now() < deadline) {
-			if (spawnError) throw spawnError;
-			const current = readMacosRecord(canonicalRunRoot);
-			if (current?.launchId === launch.launchId && current.app && current.supervisor && (0, process_identity_exports.inspectProcessIdentity)(current.app) === "same" && (0, process_identity_exports.inspectProcessIdentity)(current.supervisor) === "same") return {
-				state: "installed",
-				device,
-				launched: true,
-				pid: current.app.pid
-			};
-			if (child.exitCode !== null || child.signalCode !== null) break;
-			await new Promise((resolve) => setTimeout(resolve, 100));
-		}
+		const current = await waitForMacosRegistration(canonicalRunRoot, launch.launchId, child, deadline);
+		if (current?.app) return {
+			state: "installed",
+			device,
+			launched: true,
+			pid: current.app.pid
+		};
 		throw new Error("The hosted macOS app did not register. See macos-supervisor.log in the worker home.");
 	} catch (error) {
 		return {
@@ -1131,7 +1128,7 @@ async function runHostedMacosApp(mode, request, app) {
 }
 //#endregion
 //#region src/device-host/offer.ts
-function inspectHostedDevice(request, options) {
+async function inspectHostedDevice(request, options) {
 	const cpus = availableParallelism();
 	let workerDiskFreeBytes = null;
 	try {
@@ -1156,7 +1153,7 @@ function inspectHostedDevice(request, options) {
 			declined: null
 		} : request.platform === "ios" ? {
 			platform: "ios",
-			choice: selectHostedIosDevice(request),
+			choice: await selectHostedIosDevice(request),
 			resources,
 			declined: null
 		} : {
@@ -1209,7 +1206,7 @@ async function main() {
 	if (input.mode === "offer") {
 		const request = parseHostedOfferRequest(input);
 		if (!request) throw new Error("Invalid hosted offer selectors.");
-		process.stdout.write(`${JSON.stringify(inspectHostedDevice(request, exclude ? { exclude } : void 0))}\n`);
+		process.stdout.write(`${JSON.stringify(await inspectHostedDevice(request, exclude ? { exclude } : void 0))}\n`);
 		return;
 	}
 	if (process.platform !== "darwin") {