stim 1.23.1 → 1.25.0

package/dist/{hosted-android-xcfgCgSF.mjs → hosted-android-Bvb2-ZxD.mjs}

@@ -1,7 +1,7 @@
-import { f as throwIfCancelled } from "./operation-exec-BW0em61G.mjs";
-import { c as call, l as connectHost } from "./hosted-client-Bt-tndxV.mjs";
-import { i as requestHostedMetro } from "./metro-gateway-CKZqKqx7.mjs";
-import { n as prepareHostedNative, r as stopHostedNative, t as placeHostedNative } from "./hosted-native-BmQC6U_x.mjs";
+import { c as throwIfCancelled } from "./exec-VFRpu1iA.mjs";
+import { c as call, l as connectHost } from "./hosted-client-rsRqysJc.mjs";
+import { i as requestHostedMetro } from "./metro-gateway-Bp9gJQAN.mjs";
+import { a as stopHostedNative, i as prepareHostedNative, r as placeHostedNative } from "./hosted-native-BxTizGU2.mjs";
 //#region src/device-host/hosted-android.ts
 async function prepareHostedAndroid(machine, selectors, recorded, mode) {
 	return await prepareHostedNative(machine, selectors, recorded, "android", false, mode);

package/dist/{hosted-client-Bt-tndxV.mjs → hosted-client-rsRqysJc.mjs}

@@ -1,7 +1,7 @@
-import { rt as resolveEndpoint } from "./config-DlrsduwG.mjs";
-import { f as throwIfCancelled, u as cancellableSleep } from "./operation-exec-BW0em61G.mjs";
-import { t as BuildConnection } from "./client-B4MMzfo_.mjs";
-import { u as configuredMachines } from "./selection-DSMbWEX2.mjs";
+import { c as throwIfCancelled, o as cancellableSleep } from "./exec-VFRpu1iA.mjs";
+import { rt as resolveEndpoint } from "./config-BZhXY15H.mjs";
+import { t as BuildConnection } from "./client-BQsmyp_-.mjs";
+import { d as configuredMachines } from "./selection-D5cxEl3t.mjs";
 import { createHash } from "node:crypto";
 import { lstatSync, readFileSync, readdirSync, readlinkSync } from "node:fs";
 import { join } from "node:path";

package/dist/{hosted-ios-y19jCYFF.mjs → hosted-ios-RtVcJH3u.mjs}

@@ -1,4 +1,4 @@
-import { n as prepareHostedNative, r as stopHostedNative, t as placeHostedNative } from "./hosted-native-BmQC6U_x.mjs";
+import { a as stopHostedNative, i as prepareHostedNative, r as placeHostedNative } from "./hosted-native-BxTizGU2.mjs";
 //#region src/device-host/hosted-ios.ts
 async function prepareHostedIos(machine, selectors, recorded, mode) {
 	return await prepareHostedNative(machine, selectors, recorded, "ios", false, mode);

package/dist/{hosted-logs-DzJKzKlj.mjs → hosted-logs-CWKGYWNX.mjs}

@@ -1,10 +1,11 @@
-import { t as getExecutor } from "./exec-DEoAhcze.mjs";
+import { t as getExecutor } from "./exec-VFRpu1iA.mjs";
 import { d as workspaceDir, m as workspaceLogsDir$1 } from "./paths-DQtTgsBf.mjs";
-import { B as deviceSlotFileKey, et as parseMachine$1, q as validateDeviceSlot } from "./config-DlrsduwG.mjs";
-import { l as phaseLine } from "./command-output-YKGWivpG.mjs";
-import { n as macosDir } from "./state-08I3hw3_.mjs";
+import { B as deviceSlotFileKey, et as parseMachine$1, q as validateDeviceSlot } from "./config-BZhXY15H.mjs";
+import { l as phaseLine } from "./command-output-BBvS1H6v.mjs";
+import { n as macosDir } from "./state-DPaM3u5K.mjs";
+import { n as androidLogGroups, r as isAndroidCrashText } from "./android-saBeB4lr.mjs";
 import { r as createNdjsonWriter } from "./ndjson-CgE_o3Dl.mjs";
-import { c as call } from "./hosted-client-Bt-tndxV.mjs";
+import { c as call } from "./hosted-client-rsRqysJc.mjs";
 import { mkdirSync, readFileSync, realpathSync, renameSync, rmSync, writeFileSync } from "node:fs";
 import { dirname, join } from "node:path";
 import { LOG_ROTATE_BYTES, ambientWrite, withDirLockAsync } from "@stim-cli/core";
@@ -150,6 +151,9 @@ function readCursor(root, session, target) {
 	} catch {}
 }
 const sameCursor = (a, b) => JSON.stringify(Object.entries(a ?? {}).toSorted()) === JSON.stringify(Object.entries(b ?? {}).toSorted());
+function androidCrashRecords(records) {
+	return new Set(androidLogGroups(records).filter((group) => isAndroidCrashText(group.map((record) => record.msg ?? "").join("\n"))).flat());
+}
 async function commitPage(root, session, before, records, cursor, target) {
 	if (!records.length && sameCursor(before, cursor)) return;
 	const directory = logsStateDir(root, target);
@@ -158,12 +162,13 @@ async function commitPage(root, session, before, records, cursor, target) {
 		if (records.length) {
 			const writer = createNdjsonWriter(hostLogFile(root, target), { maxBytes: LOG_ROTATE_BYTES });
 			try {
+				const crashes = target.platform === "android" ? androidCrashRecords(records) : /* @__PURE__ */ new Set();
 				for (const record of records) writer.write(target.platform !== "macos" ? {
 					...record,
 					src: "device",
 					platform: target.platform,
 					slot: target.slot,
-					event: "hosted_native_log"
+					event: crashes.has(record) ? "native_crash" : "hosted_native_log"
 				} : record);
 			} finally {
 				writer.close();

package/dist/{hosted-macos-BJusKvqL.mjs → hosted-macos-d0pv9Tth.mjs}

@@ -1,9 +1,9 @@
-import { a as removeAgentAccess, i as agentAccess, r as closeAgentConnection, t as pullHostedMacosLogs } from "./hosted-logs-DzJKzKlj.mjs";
-import { l as phaseLine } from "./command-output-YKGWivpG.mjs";
-import { u as cancellableSleep } from "./operation-exec-BW0em61G.mjs";
-import { n as macosDir } from "./state-08I3hw3_.mjs";
-import { d as runCancellationSignal } from "./native-run-Dv88i0aU.mjs";
-import { _ as unknownSession, a as SESSION_TIMEOUT_MS, c as call, d as hostedSession, g as stoppedSession, h as sha256, i as RESERVE_TIMEOUT_MS, l as connectHost, m as settle, o as attach, r as PREPARE_TIMEOUT_MS, s as bundleManifest, t as INSTALL_TIMEOUT_MS, u as heldNoLonger, v as upload } from "./hosted-client-Bt-tndxV.mjs";
+import { o as cancellableSleep } from "./exec-VFRpu1iA.mjs";
+import { a as removeAgentAccess, i as agentAccess, r as closeAgentConnection, t as pullHostedMacosLogs } from "./hosted-logs-CWKGYWNX.mjs";
+import { l as phaseLine } from "./command-output-BBvS1H6v.mjs";
+import { n as macosDir } from "./state-DPaM3u5K.mjs";
+import { d as runCancellationSignal } from "./native-run-D5OJsGwA.mjs";
+import { _ as unknownSession, a as SESSION_TIMEOUT_MS, c as call, d as hostedSession, g as stoppedSession, h as sha256, i as RESERVE_TIMEOUT_MS, l as connectHost, m as settle, o as attach, r as PREPARE_TIMEOUT_MS, s as bundleManifest, t as INSTALL_TIMEOUT_MS, u as heldNoLonger, v as upload } from "./hosted-client-rsRqysJc.mjs";
 import { randomUUID } from "node:crypto";
 import { join } from "node:path";
 import { ambientContext, ambientWrite } from "@stim-cli/core";
@@ -51,7 +51,7 @@ async function placeHostedMacos(host, { root, bundle, bundleId, handoff, argumen
 			setting: "hosting.agentDriver"
 		}
 	};
-	reserved(placement);
+	await reserved(placement);
 	session = await settle(host, session, ["preparing"], PREPARE_TIMEOUT_MS, "macos", runCancellationSignal(ambientContext()));
 	if (session.state === "unknown") throw unknownSession(host, session);
 	if (session.state === "stopped") throw stoppedSession(host, session);

package/dist/{hosted-native-BmQC6U_x.mjs → hosted-native-BxTizGU2.mjs}

@@ -1,11 +1,11 @@
+import { o as cancellableSleep } from "./exec-VFRpu1iA.mjs";
 import { d as workspaceDir } from "./paths-DQtTgsBf.mjs";
-import { a as removeAgentAccess, i as agentAccess, n as pullHostedNativeLogs, r as closeAgentConnection } from "./hosted-logs-DzJKzKlj.mjs";
-import { u as cancellableSleep } from "./operation-exec-BW0em61G.mjs";
-import { l as withWorkspaceStateLockAsync, r as readWorkspaceState$1 } from "./workspace-state-U08dEzhG.mjs";
-import { d as runCancellationSignal } from "./native-run-Dv88i0aU.mjs";
-import { _ as unknownSession, a as SESSION_TIMEOUT_MS, c as call, d as hostedSession, g as stoppedSession, h as sha256, i as RESERVE_TIMEOUT_MS, l as connectHost, m as settle, n as OFFER_TIMEOUT_MS, o as attach, p as requireHostedAppMode, r as PREPARE_TIMEOUT_MS, s as bundleManifest, t as INSTALL_TIMEOUT_MS, u as heldNoLonger, v as upload } from "./hosted-client-Bt-tndxV.mjs";
-import { a as requireHostedMetro, i as requestHostedMetro, n as closeHostedMetro } from "./metro-gateway-CKZqKqx7.mjs";
-import { s as writeHostedNative } from "./ios-state-Dtw5K2aI.mjs";
+import { a as removeAgentAccess, i as agentAccess, n as pullHostedNativeLogs, r as closeAgentConnection } from "./hosted-logs-CWKGYWNX.mjs";
+import { l as withWorkspaceStateLockAsync, r as readWorkspaceState$1 } from "./workspace-state-CPSp3mav.mjs";
+import { d as runCancellationSignal } from "./native-run-D5OJsGwA.mjs";
+import { _ as unknownSession, a as SESSION_TIMEOUT_MS, c as call, d as hostedSession, g as stoppedSession, h as sha256, i as RESERVE_TIMEOUT_MS, l as connectHost, m as settle, n as OFFER_TIMEOUT_MS, o as attach, p as requireHostedAppMode, r as PREPARE_TIMEOUT_MS, s as bundleManifest, t as INSTALL_TIMEOUT_MS, u as heldNoLonger, v as upload } from "./hosted-client-rsRqysJc.mjs";
+import { a as requireHostedMetro, i as requestHostedMetro, n as closeHostedMetro } from "./metro-gateway-Bp9gJQAN.mjs";
+import { s as writeHostedNative } from "./ios-state-CT9nV5SP.mjs";
 import { randomUUID } from "node:crypto";
 import { readFileSync } from "node:fs";
 import { join } from "node:path";
@@ -81,6 +81,50 @@ async function reserveHostedNative(host, target, params, platform) {
 		throw Object.assign(/* @__PURE__ */ new Error(`${error instanceof Error ? error.message : String(error)} Retry stim ${platform} --remote auto; the build already targets ${host.machine}'s architecture.`), { remedy: `Retry stim ${platform} --remote auto.` });
 	}
 }
+const HOST_PORT_WINDOW = 64;
+const devClientPortRemedy = (machine) => `Run stim stop, then stim ios --remote ${machine} without stim start, so Stim starts Metro on a port free on both Macs. If metro.port or STIM_METRO_PORT pins the port, pin one free on both Macs instead.`;
+const devClientPortBusy = (machine, port) => ({
+	code: "STIM_HOSTING_REFUSED",
+	message: `${machine}: Port ${port} is in use on ${machine}, and an Expo dev client loads its bundle from this workspace's Metro port.`,
+	remedy: devClientPortRemedy(machine)
+});
+/**
+* Answers whether a port is free for an Expo dev-client bridge on `machine`, asking the host for a window of ports at
+* a time. A host without `hosted-metro-ports`, or one that cannot answer, counts every port as free; the bridge's own
+* bind check still refuses an occupied one.
+*/
+function hostedMetroPortProbe(machine, note) {
+	let window = null;
+	let unknown = false;
+	return async (port) => {
+		if (unknown) return true;
+		if (!window || port < window.from || port >= window.from + HOST_PORT_WINDOW) {
+			const ports = Array.from({ length: Math.min(HOST_PORT_WINDOW, 65536 - port) }, (_, index) => port + index);
+			let host;
+			try {
+				host = await connectHost(machine, void 0, false, runCancellationSignal(ambientContext()));
+				if (!host.connection.supports("hosted-metro-ports")) {
+					unknown = true;
+					return true;
+				}
+				const { busy } = await call(host, "device-host.metro.ports", { ports });
+				if (!Array.isArray(busy) || busy.some((each) => !Number.isInteger(each))) throw new Error(`${machine} answered device-host.metro.ports without its busy ports.`);
+				window = {
+					from: port,
+					busy: new Set(busy)
+				};
+			} catch (error) {
+				runCancellationSignal(ambientContext())?.throwIfAborted();
+				unknown = true;
+				note(`Could not check which Metro ports are free on ${machine} (${error instanceof Error ? error.message : String(error)}); choosing one free here`);
+				return true;
+			} finally {
+				host?.connection.close();
+			}
+		}
+		return !window.busy.has(port);
+	};
+}
 async function placeHostedNative(target, { root, slot, bundle, handoff, bundleId, selectors, release, mode = release ? "release" : "development", devClientScheme, reserved, note, enterPhase = () => {}, metro = requestHostedMetro, metroPort, platform = "ios" }) {
 	let host = target.host;
 	try {
@@ -112,7 +156,7 @@ async function placeHostedNative(target, { root, slot, bundle, handoff, bundleId
 				setting: "hosting.agentDriver"
 			}
 		};
-		reserved(placement);
+		await reserved(placement);
 		session = await settle(host, session, ["preparing"], PREPARE_TIMEOUT_MS, platform, runCancellationSignal(ambientContext()));
 		if (session.state === "stopped") throw stoppedSession(host, session);
 		if (session.state !== "ready") throw unknownSession(host, session);
@@ -122,13 +166,16 @@ async function placeHostedNative(target, { root, slot, bundle, handoff, bundleId
 			...placement,
 			device
 		};
-		reserved(placement);
+		await reserved(placement);
 		if (mode === "development") {
 			const gateway = await metro(root, session.id, host.credential);
 			await call(host, "device-host.metro.open", {
 				session: session.id,
 				...gateway,
-				...platform === "android" ? { clientMetroPort: metroPort } : {}
+				...platform === "android" || devClientScheme ? { clientMetroPort: metroPort } : {}
+			}).catch((error) => {
+				if (platform === "ios" && devClientScheme && error.code === "device-busy") throw Object.assign(error, { remedy: devClientPortRemedy(host.machine) });
+				throw error;
 			});
 		} else {
 			await call(host, "device-host.metro.close", { session: session.id });
@@ -283,4 +330,4 @@ async function stopHostedNative(root, slot, signal, platform = "ios") {
 	if (failures.length) throw new Error(failures.join("\n"));
 }
 //#endregion
-export { prepareHostedNative as n, stopHostedNative as r, placeHostedNative as t };
+export { stopHostedNative as a, prepareHostedNative as i, hostedMetroPortProbe as n, placeHostedNative as r, devClientPortBusy as t };

package/dist/{idle-shutdown-CJmUOV5x.mjs → idle-shutdown-BIyfl0Zj.mjs}

@@ -1,11 +1,11 @@
-import { V as deviceSlotKey, _ as loadConfig$1 } from "./config-DlrsduwG.mjs";
-import { o as formatLongDuration } from "./command-output-YKGWivpG.mjs";
-import { o as updateWorkspaceState, r as readWorkspaceState$1 } from "./workspace-state-U08dEzhG.mjs";
-import { A as workspaceBuildInProgress, T as collectOwnedDeviceActivity } from "./budget-3ivAK99e.mjs";
+import { V as deviceSlotKey, _ as loadConfig$1 } from "./config-BZhXY15H.mjs";
+import { o as formatLongDuration } from "./command-output-BBvS1H6v.mjs";
+import { r as readWorkspaceState$1, s as updateWorkspaceStateAsync } from "./workspace-state-CPSp3mav.mjs";
+import { A as workspaceBuildInProgress, T as collectOwnedDeviceActivity } from "./budget-HyShrIpL.mjs";
 import { t as canonicalPath } from "./paths-BsJMoPP2.mjs";
-import { D as teardownOwnedAvd, k as teardownOwnedIosSim } from "./workspaces-e41xsjKr.mjs";
-import { _ as workspaceDeviceLastUseAt } from "./activity-BpWUPgUm.mjs";
-import { d as listAllIosSims } from "./ios-hcBpnEGk.mjs";
+import { A as teardownOwnedIosSim, O as teardownOwnedAvd } from "./workspaces-C9w4aeXF.mjs";
+import { _ as workspaceDeviceLastUseAt } from "./activity-BpjwrQXU.mjs";
+import { d as listAllIosSims } from "./ios-BQzvJlzw.mjs";
 import { DEVICE_IDLE_SHUTDOWN_KEY, DEVICE_RECLAIM_REASON, readDeviceIdleShutdowns } from "@stim-cli/core/state";
 //#region src/devices/idle-shutdown.ts
 const SIM_LIST_TIMEOUT_MS = 1e4;
@@ -82,7 +82,7 @@ async function shutDownIdleDevices(root, idleMs, log, now = Date.now(), { only,
 			shutDown++;
 			const idleMinutes = Math.floor(idleForMs / MINUTE_MS);
 			try {
-				updateWorkspaceState(root, (state) => ({
+				await updateWorkspaceStateAsync(root, (state) => ({
 					...state,
 					[DEVICE_IDLE_SHUTDOWN_KEY]: {
 						...readDeviceIdleShutdowns(state),
@@ -114,10 +114,10 @@ async function shutDownIdleDevices(root, idleMs, log, now = Date.now(), { only,
 	return shutDown;
 }
 /** Forgets the slot's idle shutdown once a run boots its device again. */
-function clearDeviceIdleShutdown(root, platform, slot = "default") {
+async function clearDeviceIdleShutdown(root, platform, slot = "default") {
 	const key = deviceSlotKey(platform, slot);
 	if (!(key in readDeviceIdleShutdowns(readWorkspaceState$1(root)))) return;
-	updateWorkspaceState(root, (state) => {
+	await updateWorkspaceStateAsync(root, (state) => {
 		const { [key]: _cleared, ...rest } = readDeviceIdleShutdowns(state);
 		const { [DEVICE_IDLE_SHUTDOWN_KEY]: _all, ...others } = state;
 		return Object.keys(rest).length ? {

package/dist/{ios-hcBpnEGk.mjs → ios-BQzvJlzw.mjs}

@@ -1,10 +1,10 @@
-import { r as WorkspaceProcessCleanupError, t as getExecutor } from "./exec-DEoAhcze.mjs";
-import { P as formatBytes, _ as loadConfig$1 } from "./config-DlrsduwG.mjs";
+import { l as WorkspaceProcessCleanupError, n as isTimeoutError, o as cancellableSleep, t as getExecutor } from "./exec-VFRpu1iA.mjs";
+import { P as formatBytes, _ as loadConfig$1 } from "./config-BZhXY15H.mjs";
 import { n as stripAnsi, r as waitForChild, t as createLineReader } from "./process-output-Fpl8PYi8.mjs";
-import { n as runOperationFileQuiet, t as runOperationFile } from "./operation-exec-BW0em61G.mjs";
-import { i as recordCreatedDevice, t as forgetCreatedDevice } from "./created-devices-x9rN6bhs.mjs";
-import { ut as isStimOwnedSim } from "./android-C7sVmyI9.mjs";
-import { i as stimDesktopInstalledAsync, n as settingDefault, t as STIM_DESKTOP_OPEN_OPTIONS } from "./stim-desktop-D5OGpYZM.mjs";
+import { n as runOperationFileQuiet, t as runOperationFile } from "./operation-exec-CUZifp6Z.mjs";
+import { i as stimDesktopInstalledAsync, n as settingDefault, t as STIM_DESKTOP_OPEN_OPTIONS } from "./stim-desktop-DS0mzR8U.mjs";
+import { dt as isStimOwnedSim } from "./android-Cjcj8MCw.mjs";
+import { a as recordCreatedDeviceAsync, n as forgetCreatedDeviceAsync } from "./created-devices-D2Aca-xu.mjs";
 import { createHash } from "node:crypto";
 import { closeSync, existsSync, lstatSync, mkdtempSync, openSync, readSync, readdirSync, rmSync, writeFileSync } from "node:fs";
 import { tmpdir, totalmem } from "node:os";
@@ -332,6 +332,25 @@ async function readHostMemoryPressureAsync(exec = getExecutor(), platform = proc
 function memoryCulpritsUnder(pressure, exec = getExecutor()) {
 	return pressure === "warning" || pressure === "critical" ? readMemoryCulprits(exec) : null;
 }
+const CULPRIT_REUSE_MS = 3e4;
+const recentCulprits = /* @__PURE__ */ new WeakMap();
+function memoryCulpritsUnderAsync(pressure, exec = getExecutor()) {
+	if (pressure !== "warning" && pressure !== "critical") return Promise.resolve(null);
+	const recent = recentCulprits.get(exec);
+	if (recent && Date.now() - recent.at < CULPRIT_REUSE_MS) return recent.read;
+	const read = readMemoryCulpritsAsync(exec);
+	recentCulprits.set(exec, {
+		at: Date.now(),
+		read
+	});
+	return read;
+}
+function reportMemoryCulprits(pressure, emit, exec = getExecutor()) {
+	(async () => {
+		const named = memoryCulpritAdvice(await memoryCulpritsUnderAsync(pressure, exec));
+		if (named) emit(named);
+	})().catch(() => {});
+}
 function hostMemoryPressureAdvice(pressure, culprits = null) {
 	if (pressure === null || pressure === "normal") return null;
 	const named = memoryCulpritAdvice(culprits);
@@ -438,6 +457,11 @@ const SIMCTL_LIST_ARGS = [
 	"devices",
 	"--json"
 ];
+const SIMCTL_LIST_ALL_ARGS = [
+	"simctl",
+	"list",
+	"--json"
+];
 function listAllIosSims({ timeoutMs = 3e4, includeUnavailable = false } = {}) {
 	return parseSimctlList(getExecutor().runFile("xcrun", SIMCTL_LIST_ARGS, {
 		timeoutMs,
@@ -446,21 +470,47 @@ function listAllIosSims({ timeoutMs = 3e4, includeUnavailable = false } = {}) {
 }
 function createIosSimSnapshot() {
 	let cached = null;
+	let listing = null;
+	const start = (options) => {
+		if (listing) return listing;
+		const entry = cached ??= {};
+		const run = listIosSimulatorAsync(options);
+		const pending = run.then((all) => entry.value ??= all.sims);
+		listing = run;
+		entry.pending = pending;
+		const forget = () => {
+			if (listing === run) listing = null;
+			if (entry.pending === pending) entry.pending = void 0;
+		};
+		run.catch(forget);
+		pending.catch(forget);
+		return run;
+	};
 	return {
 		read() {
 			const entry = cached ??= {};
 			entry.value ??= listAllIosSims({ includeUnavailable: true });
 			return entry.value;
 		},
-		async readAsync() {
+		async readAsync(options) {
 			const entry = cached ??= {};
 			if (entry.value) return entry.value;
-			entry.pending ??= listAllIosSimsAsync({ includeUnavailable: true }).then((value) => entry.value = value).catch((error) => {
+			if (!entry.pending && !listing) start(options);
+			entry.pending ??= listAllIosSimsAsync({
+				includeUnavailable: true,
+				...options
+			}).then((value) => entry.value = value).catch((error) => {
 				entry.pending = void 0;
 				throw error;
 			});
 			return entry.pending;
 		},
+		async runtimes(options) {
+			return (await start(options)).runtimes;
+		},
+		async deviceTypes(options) {
+			return (await start(options)).deviceTypes;
+		},
 		invalidate() {
 			cached = null;
 		}
@@ -474,6 +524,22 @@ async function listAllIosSimsAsync({ timeoutMs = 3e4, includeUnavailable = false
 		cwd: operation?.cwd
 	}), { includeUnavailable });
 }
+/** The simulators, runtimes and device types out of one unfiltered `simctl list --json`. */
+function parseSimctlListing(jsonOutput) {
+	return {
+		sims: parseSimctlList(jsonOutput, { includeUnavailable: true }),
+		runtimes: parseIosRuntimes(jsonOutput),
+		deviceTypes: parseIosDeviceTypes(jsonOutput)
+	};
+}
+async function listIosSimulatorAsync({ signal, operation } = {}) {
+	return parseSimctlListing(await runOperationFile(operation, getExecutor(), "xcrun", SIMCTL_LIST_ALL_ARGS, {
+		timeoutMs: 3e4,
+		killSignal: "SIGKILL",
+		signal,
+		cwd: operation?.cwd
+	}));
+}
 function parseRuntimeVersion(runtimeId) {
 	const m = runtimeId.match(/iOS-(\d+)(?:-(\d+))?$/);
 	if (!m) return runtimeId;
@@ -486,9 +552,41 @@ const IOS_BOOT_TIMEOUT_MS = 6e5;
 const BOOTSTATUS_ATTEMPT_MS = 24e4;
 const BOOTSTATUS_ATTEMPT_FLOOR_MS = 1e3;
 const BOOT_STATE_LIST_TIMEOUT_MS = 3e4;
-function iosSimulatorFailureAdvice(exec = getExecutor()) {
+const SPRINGBOARD_QUERY_TIMEOUT_MS = 1e4;
+const SPRINGBOARD_POLL_MS = 250;
+async function waitForSpringBoard(udid, deadline) {
+	for (;;) {
+		let output = null;
+		try {
+			output = await getExecutor().runFileAsync("xcrun", [
+				"simctl",
+				"spawn",
+				udid,
+				"notifyutil",
+				"-g",
+				"com.apple.springboard.finishedstartup"
+			], { timeoutMs: Math.max(BOOTSTATUS_ATTEMPT_FLOOR_MS, Math.min(SPRINGBOARD_QUERY_TIMEOUT_MS, deadline - Date.now())) });
+		} catch (error) {
+			if (!isTimeoutError(error)) return {
+				state: "unreadable",
+				reason: error?.message || String(error)
+			};
+		}
+		if (output !== null) {
+			const state = /^com\.apple\.springboard\.finishedstartup (\d+)$/m.exec(output);
+			if (!state) return {
+				state: "unreadable",
+				reason: `Could not read SpringBoard's startup state: ${output.trim() || "no output"}.`
+			};
+			if (Number(state[1]) > 0) return { state: "started" };
+		}
+		if (Date.now() >= deadline) return { state: "timed-out" };
+		await cancellableSleep(SPRINGBOARD_POLL_MS);
+	}
+}
+async function iosSimulatorFailureAdvice(exec = getExecutor()) {
 	const pressure = readHostMemoryPressure(exec);
-	return hostMemoryPressureAdvice(pressure, memoryCulpritsUnder(pressure, exec)) ?? "The simulator may be unresponsive. Check Activity Monitor for memory pressure and free host memory before retrying.";
+	return hostMemoryPressureAdvice(pressure, await memoryCulpritsUnderAsync(pressure, exec)) ?? "The simulator may be unresponsive. Check Activity Monitor for memory pressure and free host memory before retrying.";
 }
 function bootstatusTimeout(command) {
 	const e = /* @__PURE__ */ new Error(`${command} timed out`);
@@ -614,8 +712,10 @@ async function bootIosSim(udid, { timeoutMs = IOS_BOOT_TIMEOUT_MS, attemptMs = B
 			if (state !== "Booting" && state !== "Booted" && state !== void 0) throw new Error(`Simulator ${udid} reports "${state ?? "missing"}" after ${waited}s of boot wait.`);
 			if (deadline - Date.now() <= 0) throw new Error(`Simulator ${udid} did not finish booting within ${Math.round(timeoutMs / 1e3)}s.`);
 		}
+		phase = "waiting for SpringBoard";
+		if ((await waitForSpringBoard(udid, deadline)).state === "timed-out") throw new Error(`Simulator ${udid} did not finish booting within ${Math.round(timeoutMs / 1e3)}s.`);
 	} catch (error) {
-		const named = memoryCulpritAdvice(memoryCulpritsUnder(sample(), exec));
+		const named = memoryCulpritAdvice(await memoryCulpritsUnderAsync(sample(), exec));
 		throw new Error(`${error?.message || error} Last boot output: ${phase}. Highest observed memory pressure: ${worst ?? "unknown"}; unavailable samples: ${unknown}.${coverage()}${named ? ` ${named}` : ""} ${recovery} These observations do not establish an OOM crash.`, { cause: error });
 	} finally {
 		clearInterval(monitor);
@@ -655,7 +755,11 @@ const LIST_DEVICE_TYPES_OPTIONS = {
 	timeoutMs: 3e4,
 	killSignal: "SIGKILL"
 };
-async function listIosDeviceTypesAsync({ signal, operation } = {}) {
+async function listIosDeviceTypesAsync({ signal, operation, snapshot } = {}) {
+	if (snapshot?.deviceTypes) return snapshot.deviceTypes({
+		signal,
+		operation
+	});
 	return parseIosDeviceTypes(await runOperationFile(operation, getExecutor(), "xcrun", LIST_DEVICE_TYPES_ARGS, {
 		...LIST_DEVICE_TYPES_OPTIONS,
 		signal,
@@ -772,7 +876,7 @@ async function createOwnedIosSim(label, { deviceType, runtime, suffix = "" } = {
 		timeoutMs: SIMCTL_CREATE_TIMEOUT_MS,
 		killSignal: "SIGKILL"
 	})).trim();
-	recordCreatedDevice("ios", udid);
+	await recordCreatedDeviceAsync("ios", udid);
 	return {
 		udid,
 		name,
@@ -944,7 +1048,7 @@ async function deleteIosSim(udid, operation) {
 		...SIMCTL_OPTIONS,
 		cwd: operation?.cwd
 	});
-	forgetCreatedDevice("ios", udid);
+	await forgetCreatedDeviceAsync("ios", udid);
 }
 const PARKED_DELETE_TIMEOUT_MS = 3e4;
 async function deleteParkedIosSim(udid, operation) {
@@ -964,7 +1068,7 @@ async function deleteParkedIosSim(udid, operation) {
 		timeoutMs: PARKED_DELETE_TIMEOUT_MS,
 		cwd: operation?.cwd
 	});
-	forgetCreatedDevice("ios", udid);
+	await forgetCreatedDeviceAsync("ios", udid);
 }
 const LIST_RUNTIMES_ARGS = [
 	"simctl",
@@ -979,7 +1083,8 @@ const LIST_RUNTIMES_OPTIONS = {
 function listIosRuntimes() {
 	return parseIosRuntimes(getExecutor().runFile("xcrun", LIST_RUNTIMES_ARGS, LIST_RUNTIMES_OPTIONS));
 }
-async function listIosRuntimesAsync({ signal } = {}) {
+async function listIosRuntimesAsync({ signal, snapshot } = {}) {
+	if (snapshot?.runtimes) return snapshot.runtimes({ signal });
 	return parseIosRuntimes(await getExecutor().runFileAsync("xcrun", LIST_RUNTIMES_ARGS, {
 		...LIST_RUNTIMES_OPTIONS,
 		signal
@@ -996,4 +1101,4 @@ function parseIosRuntimes(out) {
 	}] : []);
 }
 //#endregion
-export { configuredIosSimulatorViewer as A, deviceHoldsBundle as B, resetIosKeychain as C, sanitizeDeviceLabel as D, resolveOwnedIosSim as E, readHostMemoryPressureAsync as F, memoryCulpritAdvice as I, memoryCulpritFindings as L, hostMemoryPressureAdvice as M, memoryCulpritsUnder as N, shutdownIosSim as O, readHostMemoryPressure as P, readMemoryCulpritsAsync as R, renameIosSim as S, resolveIosCreation as T, ownedSimName as _, createOwnedIosSim as a, parseSimctlList as b, eraseIosSim as c, listAllIosSims as d, listAllIosSimsAsync as f, listUserApps as g, listIosRuntimesAsync as h, createIosSimSnapshot as i, parseIosSimulatorApp as j, uninstallIosApp as k, iosRuntimeMatches as l, listIosRuntimes as m, bootIosSim as n, deleteIosSim as o, listIosDeviceTypesAsync as p, clearIosAppData as r, deleteParkedIosSim as s, IOS_BOOT_TIMEOUT_MS as t, iosSimulatorFailureAdvice as u, parkedSimName as v, resetIosPrivacy as w, pickDefaultIosCreation as x, parseRuntimeVersion as y, deviceHoldsApk as z };
+export { waitForSpringBoard as A, memoryCulpritFindings as B, resetIosKeychain as C, sanitizeDeviceLabel as D, resolveOwnedIosSim as E, memoryCulpritsUnderAsync as F, deviceHoldsApk as H, readHostMemoryPressure as I, readHostMemoryPressureAsync as L, parseIosSimulatorApp as M, hostMemoryPressureAdvice as N, shutdownIosSim as O, memoryCulpritsUnder as P, reportMemoryCulprits as R, renameIosSim as S, resolveIosCreation as T, deviceHoldsBundle as U, readMemoryCulpritsAsync as V, ownedSimName as _, createOwnedIosSim as a, parseSimctlList as b, eraseIosSim as c, listAllIosSims as d, listAllIosSimsAsync as f, listUserApps as g, listIosRuntimesAsync as h, createIosSimSnapshot as i, configuredIosSimulatorViewer as j, uninstallIosApp as k, iosRuntimeMatches as l, listIosRuntimes as m, bootIosSim as n, deleteIosSim as o, listIosDeviceTypesAsync as p, clearIosAppData as r, deleteParkedIosSim as s, IOS_BOOT_TIMEOUT_MS as t, iosSimulatorFailureAdvice as u, parkedSimName as v, resetIosPrivacy as w, pickDefaultIosCreation as x, parseRuntimeVersion as y, memoryCulpritAdvice as z };