stim 1.18.0 → 1.20.0

package/dist/{hosted-android-Bv285t_t.mjs → hosted-android-DQ-Agsd8.mjs}

@@ -1,9 +1,9 @@
-import { a as call, o as connectHost } from "./hosted-client-C-rMtppF.mjs";
-import { i as requestHostedMetro } from "./metro-gateway-CEUw9RMH.mjs";
-import { n as prepareHostedNative, r as stopHostedNative, t as placeHostedNative } from "./hosted-native-DeeOG8xZ.mjs";
+import { o as call, s as connectHost } from "./hosted-client-Io01s5By.mjs";
+import { i as requestHostedMetro } from "./metro-gateway-BBJldOdi.mjs";
+import { n as prepareHostedNative, r as stopHostedNative, t as placeHostedNative } from "./hosted-native-BdAQi21M.mjs";
 //#region src/device-host/hosted-android.ts
-async function prepareHostedAndroid(machine, selectors, recorded) {
-	return await prepareHostedNative(machine, selectors, recorded, "android");
+async function prepareHostedAndroid(machine, selectors, recorded, mode) {
+	return await prepareHostedNative(machine, selectors, recorded, "android", false, mode);
 }
 async function placeHostedAndroid(target, options) {
 	return await placeHostedNative(target, {

package/dist/{hosted-client-C-rMtppF.mjs → hosted-client-Io01s5By.mjs}

@@ -1,4 +1,5 @@
-import { C as pinnedEndpoint$1, t as BuildConnection, y as configuredMachines } from "./client-DzhapoMB.mjs";
+import { c as pinnedEndpoint$1 } from "./tailnet-CoJUb2tB.mjs";
+import { t as BuildConnection, x as configuredMachines } from "./client-BLy1Pw2V.mjs";
 import { lstatSync, readFileSync, readdirSync, readlinkSync } from "node:fs";
 import { join } from "node:path";
 import { HOSTED_APP_CHUNK_BYTES, hostedMacosAppSlot, isJsonObject, readDeviceHostMachines } from "@stim-cli/core/state";
@@ -7,6 +8,7 @@ import { createHash } from "node:crypto";
 const CONNECT_TIMEOUT_MS = 1e4;
 /** Covers 90s stop + 15s final logs + three 10s worker group-settle bounds, with 45s for polling and transport. */
 const SESSION_TIMEOUT_MS = 18e4;
+const PREPARE_TIMEOUT_MS = 355e3;
 const INSTALL_TIMEOUT_MS = 3e5;
 const sleep = (ms) => new Promise((done) => setTimeout(done, ms));
 const sha256 = (content) => createHash("sha256").update(content).digest("hex");
@@ -37,7 +39,7 @@ function hostingCredential(machine) {
 /** Connects only to the pinned node of an approved remote Mac, and only when it grants `device-host`. */
 async function connectHost(machine, timeoutMs = CONNECT_TIMEOUT_MS, strict = false) {
 	const credential = hostingCredential(machine);
-	const target = pinnedEndpoint$1(credential);
+	const target = await pinnedEndpoint$1(credential);
 	if (typeof target === "string") throw Object.assign(/* @__PURE__ */ new Error(`Stim does not connect to ${machine}: ${target}.`), { code: "STIM_HOSTING_REFUSED" });
 	const opened = await BuildConnection.open(target, credential.deviceToken, timeoutMs, "device-host").catch((error) => {
 		throw Object.assign(new Error(`${machine} is unreachable. Check stim-server and its tailnet serve route on ${machine}.`, { cause: error }), { code: strict ? "STIM_HOSTING_REFUSED" : "closed" });
@@ -52,6 +54,10 @@ async function connectHost(machine, timeoutMs = CONNECT_TIMEOUT_MS, strict = fal
 		connection: opened
 	};
 }
+function requireHostedAppMode(host, platform, mode) {
+	if (mode !== "process") return;
+	if (!host.connection.supports(platform === "ios" ? "hosted-ios-process" : "hosted-android-process")) throw credentialRefusal(`${host.machine} does not support hosted ${platform} process apps.`, `Update stim-server on ${host.machine} to a version supporting hosted ${platform} process apps, then retry.`);
+}
 const gatewaySecrets = /* @__PURE__ */ new WeakMap();
 function redactHostText(host, message) {
 	for (const secret of [host.credential.deviceToken, gatewaySecrets.get(host)]) if (secret) message = message.replaceAll(secret, "[redacted]");
@@ -193,4 +199,4 @@ async function upload(host, ids, missing, content) {
 	}
 }
 //#endregion
-export { call as a, hostedSession as c, sha256 as d, sleep as f, bundleManifest as i, probeHostedSession as l, upload as m, SESSION_TIMEOUT_MS as n, connectHost as o, unknownSession as p, attach as r, heldNoLonger as s, INSTALL_TIMEOUT_MS as t, settle as u };
+export { bundleManifest as a, heldNoLonger as c, requireHostedAppMode as d, settle as f, upload as g, unknownSession as h, attach as i, hostedSession as l, sleep as m, PREPARE_TIMEOUT_MS as n, call as o, sha256 as p, SESSION_TIMEOUT_MS as r, connectHost as s, INSTALL_TIMEOUT_MS as t, probeHostedSession as u };

package/dist/{hosted-ios-D5mNmtj4.mjs → hosted-ios-DIxFnYp-.mjs}

@@ -1,7 +1,7 @@
-import { n as prepareHostedNative, r as stopHostedNative, t as placeHostedNative } from "./hosted-native-DeeOG8xZ.mjs";
+import { n as prepareHostedNative, r as stopHostedNative, t as placeHostedNative } from "./hosted-native-BdAQi21M.mjs";
 //#region src/device-host/hosted-ios.ts
-async function prepareHostedIos(machine, selectors, recorded) {
-	return await prepareHostedNative(machine, selectors, recorded, "ios");
+async function prepareHostedIos(machine, selectors, recorded, mode) {
+	return await prepareHostedNative(machine, selectors, recorded, "ios", false, mode);
 }
 async function placeHostedIos(target, options) {
 	return await placeHostedNative(target, {

package/dist/{hosted-logs-DN8Iz4mJ.mjs → hosted-logs-DP-ABU_M.mjs}

@@ -1,11 +1,11 @@
-import { t as getExecutor } from "./exec-DWhCZDGm.mjs";
-import { l as phaseLine } from "./command-output-CBtzyIgF.mjs";
-import { L as deviceSlotFileKey, W as validateDeviceSlot } from "./config-CgYMahz7.mjs";
-import { v as workspaceDir, x as workspaceLogsDir$1 } from "./workspace-state-C59dqG-Z.mjs";
-import { t as macosDir } from "./state-xnqpx3AD.mjs";
-import { r as createNdjsonWriter } from "./ndjson-LGZAMsqa.mjs";
-import { S as parseMachine$1 } from "./client-DzhapoMB.mjs";
-import { a as call } from "./hosted-client-C-rMtppF.mjs";
+import { t as getExecutor } from "./exec-B81Qodjn.mjs";
+import { L as deviceSlotFileKey, W as validateDeviceSlot } from "./config-D0LhTY3S.mjs";
+import { w as workspaceLogsDir$1, x as workspaceDir } from "./workspace-state-CSIFuuDa.mjs";
+import { l as phaseLine } from "./command-output-BjPN99ZB.mjs";
+import { o as parseMachine$1 } from "./tailnet-CoJUb2tB.mjs";
+import { r as createNdjsonWriter } from "./ndjson-GOnbyvso.mjs";
+import { n as macosDir } from "./state-Boo0IMJq.mjs";
+import { o as call } from "./hosted-client-Io01s5By.mjs";
 import { mkdirSync, readFileSync, realpathSync, renameSync, rmSync, writeFileSync } from "node:fs";
 import { dirname, join } from "node:path";
 import { isJsonObject, parseHostedAgentGrant, parseHostedLogsCursor } from "@stim-cli/core/state";

package/dist/{hosted-macos-B-wEjlwG.mjs → hosted-macos-Aziw9T_9.mjs}

@@ -1,7 +1,7 @@
-import { l as phaseLine } from "./command-output-CBtzyIgF.mjs";
-import { t as macosDir } from "./state-xnqpx3AD.mjs";
-import { a as call, c as hostedSession, d as sha256, f as sleep, i as bundleManifest, m as upload, n as SESSION_TIMEOUT_MS, o as connectHost, p as unknownSession, r as attach, s as heldNoLonger, t as INSTALL_TIMEOUT_MS, u as settle } from "./hosted-client-C-rMtppF.mjs";
-import { i as agentAccess, r as closeAgentConnection, t as pullHostedMacosLogs } from "./hosted-logs-DN8Iz4mJ.mjs";
+import { l as phaseLine } from "./command-output-BjPN99ZB.mjs";
+import { n as macosDir } from "./state-Boo0IMJq.mjs";
+import { a as bundleManifest, c as heldNoLonger, f as settle, g as upload, h as unknownSession, i as attach, l as hostedSession, m as sleep, n as PREPARE_TIMEOUT_MS, o as call, p as sha256, r as SESSION_TIMEOUT_MS, s as connectHost, t as INSTALL_TIMEOUT_MS } from "./hosted-client-Io01s5By.mjs";
+import { i as agentAccess, r as closeAgentConnection, t as pullHostedMacosLogs } from "./hosted-logs-DP-ABU_M.mjs";
 import { rmSync } from "node:fs";
 import { join } from "node:path";
 import { hostedMacosBundleId, parseHostedMacosDevice, validHostedAppArguments } from "@stim-cli/core/state";
@@ -18,7 +18,8 @@ async function placeHostedMacos(host, { root, bundle, bundleId, handoff, argumen
 	let session = null;
 	if (recorded) {
 		try {
-			session = await settle(host, await attach(host, recorded.session), ["preparing", "stopping"], SESSION_TIMEOUT_MS);
+			session = await settle(host, await attach(host, recorded.session), ["preparing"], PREPARE_TIMEOUT_MS);
+			session = await settle(host, session, ["stopping"], SESSION_TIMEOUT_MS);
 		} catch (error) {
 			if (!heldNoLonger(error)) throw error;
 		}
@@ -49,7 +50,7 @@ async function placeHostedMacos(host, { root, bundle, bundleId, handoff, argumen
 		}
 	};
 	reserved(placement);
-	session = await settle(host, session, ["preparing"], SESSION_TIMEOUT_MS);
+	session = await settle(host, session, ["preparing"], PREPARE_TIMEOUT_MS);
 	if (session.state === "unknown") throw unknownSession(host, session);
 	if (session.state !== "ready") throw new Error(`The hosted session ${session.id} on ${host.machine} is ${session.state}.`);
 	const device = parseHostedMacosDevice(session.device);

package/dist/{hosted-native-DeeOG8xZ.mjs → hosted-native-BdAQi21M.mjs}

@@ -1,11 +1,11 @@
-import { r as readWorkspaceState$1, v as workspaceDir } from "./workspace-state-C59dqG-Z.mjs";
-import { a as call, c as hostedSession, d as sha256, f as sleep, i as bundleManifest, m as upload, n as SESSION_TIMEOUT_MS, o as connectHost, p as unknownSession, r as attach, s as heldNoLonger, t as INSTALL_TIMEOUT_MS, u as settle } from "./hosted-client-C-rMtppF.mjs";
-import { i as agentAccess, n as pullHostedNativeLogs, r as closeAgentConnection } from "./hosted-logs-DN8Iz4mJ.mjs";
-import { a as requireHostedMetro, i as requestHostedMetro, n as closeHostedMetro } from "./metro-gateway-CEUw9RMH.mjs";
-import { s as writeHostedNative } from "./ios-state-B2pES6Vs.mjs";
+import { r as readWorkspaceState$1, x as workspaceDir } from "./workspace-state-CSIFuuDa.mjs";
+import { a as bundleManifest, c as heldNoLonger, d as requireHostedAppMode, f as settle, g as upload, h as unknownSession, i as attach, l as hostedSession, m as sleep, n as PREPARE_TIMEOUT_MS, o as call, p as sha256, r as SESSION_TIMEOUT_MS, s as connectHost, t as INSTALL_TIMEOUT_MS } from "./hosted-client-Io01s5By.mjs";
+import { i as agentAccess, n as pullHostedNativeLogs, r as closeAgentConnection } from "./hosted-logs-DP-ABU_M.mjs";
+import { a as requireHostedMetro, i as requestHostedMetro, n as closeHostedMetro } from "./metro-gateway-BBJldOdi.mjs";
+import { s as writeHostedNative } from "./ios-state-CjrL2qv-.mjs";
 import { readFileSync, rmSync } from "node:fs";
 import { join } from "node:path";
-import { hostedNativeRecords, isJsonObject, parseHostedAndroidDevice, parseHostedChoice, parseHostedDevice, parseHostedNativeOffer, parseHostedNativePlacement, unreadableHostedNative } from "@stim-cli/core/state";
+import { hostedNativeRecords, isJsonObject, parseHostedAndroidDevice, parseHostedChoice, parseHostedDevice, parseHostedNativeOffer, parseHostedNativePlacement, requireAutomaticMachine, unreadableHostedNative } from "@stim-cli/core/state";
 import { randomUUID } from "node:crypto";
 //#region src/device-host/hosted-native.ts
 function hostingRefusal(machine, error) {
@@ -16,14 +16,16 @@ function hostingRefusal(machine, error) {
 }
 const androidAgentRemoteConfig = (root, slot) => join(workspaceDir(root), "hosted-android", slot, "agent-device-remote.json");
 const iosAgentRemoteConfig = (root, slot) => join(workspaceDir(root), "hosted-ios", slot, "agent-device-remote.json");
-async function prepareHostedNative(machine, selectors, recorded, platform = "ios", resumeOnly = false) {
+async function prepareHostedNative(machine, selectors, recorded, platform = "ios", resumeOnly = false, mode) {
 	let host;
 	try {
 		host = await connectHost(machine, void 0, true);
+		requireHostedAppMode(host, platform, mode);
 		if (recorded) {
 			let session = null;
 			try {
-				session = await settle(host, await attach(host, recorded.session, void 0, platform), ["preparing", "stopping"], SESSION_TIMEOUT_MS, platform);
+				session = await settle(host, await attach(host, recorded.session, void 0, platform), ["preparing"], PREPARE_TIMEOUT_MS, platform);
+				session = await settle(host, session, ["stopping"], SESSION_TIMEOUT_MS, platform);
 			} catch (error) {
 				if (!heldNoLonger(error)) throw error;
 			}
@@ -47,7 +49,7 @@ async function prepareHostedNative(machine, selectors, recorded, platform = "ios
 		const offer = await call(host, "device-host.offer", {
 			platform,
 			...selectors
-		}, 3e3);
+		}, 45e3);
 		const parsedOffer = parseHostedNativeOffer(offer);
 		const choice = platform === "ios" ? offer.platform === "ios" ? parseHostedChoice(offer.choice) : null : parsedOffer?.platform === "android" ? parsedOffer.choice : null;
 		if (typeof offer.declined === "string") throw new Error(offer.declined);
@@ -68,18 +70,21 @@ async function prepareHostedNative(machine, selectors, recorded, platform = "ios
 }
 async function reserveHostedNative(host, target, params, platform) {
 	try {
+		if (target.selection?.selected === "auto") requireAutomaticMachine("device", host.machine);
 		return hostedSession(host, await call(host, "device-host.reserve", params), platform);
 	} catch (error) {
 		if (target.selection?.selected !== "auto") throw error;
 		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.` });
 	}
 }
-async function placeHostedNative(target, { root, slot, bundle, handoff, bundleId, selectors, release, devClientScheme, reserved, note, metro = requestHostedMetro, metroPort, platform = "ios" }) {
+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 {
-		if (!release && metro === requestHostedMetro) requireHostedMetro(root);
+		if (mode === "development" && metro === requestHostedMetro) requireHostedMetro(root);
+		enterPhase("device");
 		host = await connectHost(host.machine, void 0, true);
 		target.host = host;
+		requireHostedAppMode(host, platform, mode);
 		let session = (target.session ? await attach(host, target.session.id, void 0, platform) : null) ?? await reserveHostedNative(host, target, {
 			platform,
 			workspace: root,
@@ -104,7 +109,7 @@ async function placeHostedNative(target, { root, slot, bundle, handoff, bundleId
 			}
 		};
 		reserved(placement);
-		session = await settle(host, session, ["preparing"], SESSION_TIMEOUT_MS, platform);
+		session = await settle(host, session, ["preparing"], PREPARE_TIMEOUT_MS, platform);
 		if (session.state !== "ready") throw unknownSession(host, session);
 		const device = platform === "ios" ? parseHostedDevice(session.device) : parseHostedAndroidDevice(session.device);
 		if (!device || device.architecture !== target.choice.architecture || "avdName" in device && "systemImage" in target.choice && (device.systemImage !== target.choice.systemImage || device.deviceProfile !== target.choice.deviceProfile)) throw new Error(platform === "ios" ? "The reserved simulator does not match the offered architecture." : "The reserved emulator does not match the offered architecture or selectors.");
@@ -113,7 +118,7 @@ async function placeHostedNative(target, { root, slot, bundle, handoff, bundleId
 			device
 		};
 		reserved(placement);
-		if (!release) {
+		if (mode === "development") {
 			const gateway = await metro(root, session.id, host.credential);
 			await call(host, "device-host.metro.open", {
 				session: session.id,
@@ -146,13 +151,14 @@ async function placeHostedNative(target, { root, slot, bundle, handoff, bundleId
 		const offer = {
 			...ids,
 			bundleId,
-			mode: release ? "release" : "development",
-			...!release && devClientScheme ? { devClientScheme } : {},
+			mode,
+			...mode === "development" && devClientScheme ? { devClientScheme } : {},
 			manifest: {
 				sha256: sha256(manifest),
 				size: manifest.length
 			}
 		};
+		enterPhase("install");
 		note(`Delivering ${files.length} files to ${host.machine} (${"runtime" in device ? device.runtime : device.systemImage}, ${device.architecture})`);
 		await upload(host, ids, (await call(host, "device-host.app.offer", offer)).missing, content);
 		let missing = (await call(host, "device-host.app.offer", offer)).missing;
@@ -181,6 +187,7 @@ async function placeHostedNative(target, { root, slot, bundle, handoff, bundleId
 			}
 		}
 		await upload(host, ids, missing, content);
+		enterPhase("launch");
 		note(`Launching on ${host.machine}`);
 		let delivery = await call(host, "device-host.app.launch", ids);
 		const deadline = Date.now() + INSTALL_TIMEOUT_MS;
@@ -197,7 +204,7 @@ async function placeHostedNative(target, { root, slot, bundle, handoff, bundleId
 		};
 		return {
 			placement,
-			launched: release && delivery.launched === true ? true : "unverified"
+			launched: mode !== "development" && delivery.launched === true ? true : "unverified"
 		};
 	} catch (error) {
 		throw hostingRefusal(host.machine, error);

package/dist/{idle-shutdown-jjtxAn5C.mjs → idle-shutdown-DdMqoSUB.mjs}

@@ -1,10 +1,10 @@
-import { o as formatLongDuration } from "./command-output-CBtzyIgF.mjs";
-import { R as deviceSlotKey, _ as loadConfig$1 } from "./config-CgYMahz7.mjs";
-import { a as updateWorkspaceState, r as readWorkspaceState$1 } from "./workspace-state-C59dqG-Z.mjs";
-import { E as workspaceBuildInProgress, S as collectOwnedDeviceActivity } from "./budget-DIhL2BKx.mjs";
-import { E as teardownOwnedAvd, I as canonicalPath, O as teardownOwnedIosSim } from "./workspaces-xXItD8Dj.mjs";
-import { m as workspaceDeviceLastUseAt } from "./activity-BxnkDZDi.mjs";
-import { d as listAllIosSims } from "./ios-B3SbOWdw.mjs";
+import { R as deviceSlotKey, _ as loadConfig$1 } from "./config-D0LhTY3S.mjs";
+import { a as updateWorkspaceState, r as readWorkspaceState$1 } from "./workspace-state-CSIFuuDa.mjs";
+import { o as formatLongDuration } from "./command-output-BjPN99ZB.mjs";
+import { T as canonicalPath, b as teardownOwnedIosSim, v as teardownOwnedAvd } from "./workspaces-D2xSHBDY.mjs";
+import { f as collectOwnedDeviceActivity, g as workspaceBuildInProgress } from "./budget-BONq9vXY.mjs";
+import { m as workspaceDeviceLastUseAt } from "./activity-BrGh9EAI.mjs";
+import { d as listAllIosSims } from "./ios-CXLIUxXJ.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;

package/dist/ios-BZ9dg2Fr.mjs

@@ -0,0 +1,9 @@
+import { h as shortUdid, i as formatDuration, l as phaseLine, m as shortHash } from "./command-output-BjPN99ZB.mjs";
+import { D as schemesFromInfoPlist, T as pickDevClientScheme } from "./app-install-0LgaQRT7.mjs";
+import { n as ensureWorkspaceStorageSafely } from "./native-runtime-BRmWL7ru.mjs";
+import { t as devClientScheme } from "./dev-client-ClATaJoH.mjs";
+import { f as podAction, h as resolveDeviceType, i as deviceLabel, m as resolveConfiguration, n as buildLogFile, s as iosConfigurationSetting, t as appNameFromPath, u as isReleaseConfiguration, v as resolveRuntime } from "./support-DCco5fut.mjs";
+import { a as lastBuildRecord, i as iosFacts, n as cacheDescription, s as writeLastBuild } from "./ios-project-B9drt_aY.mjs";
+import { n as registerIos, r as runIosOperation, t as iosCommand } from "./ios-CZuv6gRv.mjs";
+import { a as collectorEntry, o as replaceCollector } from "./launch-YrbqaIFj.mjs";
+export { appNameFromPath, buildLogFile, cacheDescription, collectorEntry, iosCommand as default, devClientScheme, deviceLabel, ensureWorkspaceStorageSafely, formatDuration, iosConfigurationSetting, iosFacts, isReleaseConfiguration, lastBuildRecord, phaseLine, pickDevClientScheme, podAction, registerIos, replaceCollector, resolveConfiguration, resolveDeviceType, resolveRuntime, runIosOperation, schemesFromInfoPlist, shortHash, shortUdid, writeLastBuild };

package/dist/{ios-B3SbOWdw.mjs → ios-CXLIUxXJ.mjs}

@@ -1,14 +1,14 @@
-import { t as getExecutor } from "./exec-DWhCZDGm.mjs";
+import { t as getExecutor } from "./exec-B81Qodjn.mjs";
+import { _ as loadConfig$1, j as formatBytes } from "./config-D0LhTY3S.mjs";
 import { n as stripAnsi, r as waitForChild, t as createLineReader } from "./process-output-Fpl8PYi8.mjs";
-import { _ as loadConfig$1 } from "./config-CgYMahz7.mjs";
-import { r as recordCreatedDevice, t as forgetCreatedDevice } from "./created-devices-DKbeWsiK.mjs";
-import { at as isStimOwnedSim } from "./android-DC3ZLuw0.mjs";
-import { n as settingDefault, t as STIM_DESKTOP_OPEN_OPTIONS } from "./stim-desktop-Behws_fi.mjs";
+import { n as settingDefault, t as STIM_DESKTOP_OPEN_OPTIONS } from "./stim-desktop-8GQX2OV8.mjs";
+import { it as isStimOwnedSim } from "./android-BsYNR81W.mjs";
+import { r as recordCreatedDevice, t as forgetCreatedDevice } from "./created-devices-HU_DAb_Q.mjs";
 import { closeSync, existsSync, lstatSync, mkdtempSync, openSync, readSync, readdirSync, rmSync, writeFileSync } from "node:fs";
 import { dirname, isAbsolute, join, resolve } from "node:path";
 import { IOS_SIMULATOR_APPS, settingDefinition } from "@stim-cli/core/state";
-import { tmpdir } from "node:os";
 import { createHash } from "node:crypto";
+import { tmpdir, totalmem } from "node:os";
 //#region src/engine/installed-artifact.ts
 const READ_CHUNK_BYTES = 1048576;
 const DEVICE_PATH_TIMEOUT_MS = 3e4;
@@ -139,6 +139,136 @@ function deviceHoldsBundle({ udid, bundleId, appPath }, { exec = null } = {}) {
 	return artifactsMatch(hashBundle(appPath), installed);
 }
 //#endregion
+//#region src/memory-culprits.ts
+const GIB = 1024 ** 3;
+const UNITS = {
+	B: 1,
+	K: 1024,
+	M: 1024 ** 2,
+	G: GIB,
+	T: 1024 * GIB
+};
+const GENERAL_FLOOR_BYTES = 8 * GIB;
+const GENERAL_SHARE_OF_RAM = .25;
+const TOP_ROWS = 20;
+const GRADLE_DAEMON = /\borg\.gradle\.launcher\.daemon\.bootstrap\.GradleDaemon\b/;
+const KOTLIN_DAEMON = /\bKotlinCompileDaemon\b/;
+const GRADLE_NOTE = "Stim stops only idle daemons; the next build starts a new one.";
+const RESTARTABLE = [
+	{
+		name: "fseventsd",
+		matches: ({ name }) => name === "fseventsd",
+		bytes: 2 * GIB,
+		command: "sudo killall fseventsd",
+		note: "launchd restarts it at once, and file watchers rescan their folders once."
+	},
+	{
+		name: "Watchman",
+		matches: ({ name }) => name === "watchman",
+		bytes: 2 * GIB,
+		command: "stim gc --delete --cache watchman",
+		note: "Stim stops the daemon only when no workspace uses it; the next Metro starts a fresh one."
+	},
+	{
+		name: "Gradle daemon",
+		matches: ({ name }, commandLine) => name === "java" && GRADLE_DAEMON.test(commandLine ?? ""),
+		command: "stim gc --delete --cache gradle-daemons",
+		note: GRADLE_NOTE
+	},
+	{
+		name: "Kotlin daemon",
+		matches: ({ name }, commandLine) => name === "java" && KOTLIN_DAEMON.test(commandLine ?? ""),
+		command: "stim gc --delete --cache gradle-daemons",
+		note: GRADLE_NOTE
+	}
+];
+/** Parses `top -l 1 -stats pid,mem,command` output: the rows after its `PID MEM COMMAND` header. */
+function parseTopMemory(output) {
+	const rows = [];
+	let header = false;
+	for (const line of output.split("\n")) {
+		if (!header) {
+			header = /^\s*PID\s+MEM\s+COMMAND\b/.test(line);
+			continue;
+		}
+		const match = /^\s*(\d+)\s+(\d+(?:\.\d+)?)([BKMGT])[+-]?\s+(\S.*?)\s*$/.exec(line);
+		if (match) rows.push({
+			pid: Number(match[1]),
+			bytes: Math.round(Number(match[2]) * UNITS[match[3]]),
+			name: match[4]
+		});
+	}
+	return rows;
+}
+function findMemoryCulprits(processes, totalBytes, commandLines = /* @__PURE__ */ new Map()) {
+	const general = Math.max(GENERAL_FLOOR_BYTES, totalBytes * GENERAL_SHARE_OF_RAM);
+	const culprits = [];
+	for (const row of processes) {
+		const known = RESTARTABLE.find((entry) => entry.matches(row, commandLines.get(row.pid)));
+		if (row.bytes < Math.min(general, known?.bytes ?? general)) continue;
+		culprits.push({
+			pid: row.pid,
+			name: known?.name ?? row.name,
+			bytes: row.bytes,
+			command: known?.command ?? null,
+			note: known?.note ?? null
+		});
+	}
+	return culprits.toSorted((a, b) => b.bytes - a.bytes);
+}
+function memoryCulpritAdvice(culprits) {
+	if (!culprits?.length) return null;
+	return culprits.map((culprit) => {
+		const uses = `${culprit.name} (pid ${culprit.pid}) uses ${formatBytes(culprit.bytes)} of memory`;
+		return culprit.command ? `${uses}; run \`${culprit.command}\` to free it: ${culprit.note}` : `${uses}; Stim knows no safe restart for it, so ask before quitting it.`;
+	}).join(" ");
+}
+/**
+* The abnormal processes by footprint, from the setuid `top`: unlike `proc_pid_rusage` without root, it reads
+* root-owned daemons such as fseventsd, and unlike `ps` RSS it counts compressed and swapped memory. Null off macOS
+* or when `top` fails.
+*/
+function readMemoryCulprits(exec = getExecutor(), platform = process.platform, totalBytes = totalmem()) {
+	if (platform !== "darwin") return null;
+	const output = exec.runFileQuiet("/usr/bin/top", [
+		"-l",
+		"1",
+		"-o",
+		"mem",
+		"-n",
+		String(TOP_ROWS),
+		"-stats",
+		"pid,mem,command"
+	], { timeoutMs: 1e4 });
+	if (output === null) return null;
+	const processes = parseTopMemory(output);
+	const java = processes.filter((entry) => entry.name === "java").map((entry) => entry.pid);
+	const commandLines = /* @__PURE__ */ new Map();
+	if (java.length) {
+		const listed = exec.runFileQuiet("/bin/ps", [
+			"-ww",
+			"-o",
+			"pid=,command=",
+			"-p",
+			java.join(",")
+		], { timeoutMs: 5e3 });
+		for (const line of listed?.split("\n") ?? []) {
+			const match = /^\s*(\d+)\s+(.*)$/.exec(line);
+			if (match) commandLines.set(Number(match[1]), match[2]);
+		}
+	}
+	return findMemoryCulprits(processes, totalBytes, commandLines);
+}
+function memoryCulpritFindings(culprits) {
+	return (culprits ?? []).filter((culprit) => culprit.name !== "Watchman").map((culprit) => ({
+		code: "memory-culprit",
+		level: "cost",
+		title: `${culprit.name} uses ${formatBytes(culprit.bytes)} of memory`,
+		detail: memoryCulpritAdvice([culprit]),
+		fix: culprit.command ? `Run \`${culprit.command}\`. ${culprit.note}` : "Stim knows no safe restart for this process. Ask before quitting it."
+	}));
+}
+//#endregion
 //#region src/host-memory.ts
 function readHostMemoryPressure(exec = getExecutor(), platform = process.platform) {
 	if (platform !== "darwin") return null;
@@ -153,9 +283,13 @@ function readHostMemoryPressure(exec = getExecutor(), platform = process.platfor
 		return null;
 	}
 }
-function hostMemoryPressureAdvice(pressure) {
+function memoryCulpritsUnder(pressure, exec = getExecutor()) {
+	return pressure === "warning" || pressure === "critical" ? readMemoryCulprits(exec) : null;
+}
+function hostMemoryPressureAdvice(pressure, culprits = null) {
 	if (pressure === null || pressure === "normal") return null;
-	return `macOS reports ${pressure} host memory pressure. Simulator processes can stall even when the device is Booted. Free memory before retrying: use \`stim stop\` only in workspaces you own, and ask before closing other apps or devices. For parallel iOS work, consider a reviewed SimSlim profile (\`stim guide lifecycle simslim\`). This observation does not establish an OOM crash.`;
+	const named = memoryCulpritAdvice(culprits);
+	return `macOS reports ${pressure} host memory pressure.${named ? ` ${named}` : ""} Simulator processes can stall even when the device is Booted. Free memory before retrying: use \`stim stop\` only in workspaces you own, and ask before closing other apps or devices. For parallel iOS work, consider a reviewed SimSlim profile (\`stim guide lifecycle simslim\`). This observation does not establish an OOM crash.`;
 }
 //#endregion
 //#region src/devices/ios-simulator-viewer.ts
@@ -291,7 +425,8 @@ const BOOTSTATUS_ATTEMPT_MS = 24e4;
 const BOOTSTATUS_ATTEMPT_FLOOR_MS = 1e3;
 const BOOT_STATE_LIST_TIMEOUT_MS = 3e4;
 function iosSimulatorFailureAdvice(exec = getExecutor()) {
-	return hostMemoryPressureAdvice(readHostMemoryPressure(exec)) ?? "The simulator may be unresponsive. Check Activity Monitor for memory pressure and free host memory before retrying.";
+	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.";
 }
 function bootstatusTimeout(command) {
 	const e = /* @__PURE__ */ new Error(`${command} timed out`);
@@ -418,15 +553,19 @@ async function bootIosSim(udid, { timeoutMs = IOS_BOOT_TIMEOUT_MS, attemptMs = B
 			if (deadline - Date.now() <= 0) throw new Error(`Simulator ${udid} did not finish booting within ${Math.round(timeoutMs / 1e3)}s.`);
 		}
 	} catch (error) {
-		sample();
-		throw new Error(`${error?.message || error} Last boot output: ${phase}. Highest observed memory pressure: ${worst ?? "unknown"}; unavailable samples: ${unknown}.${coverage()} ${recovery} These observations do not establish an OOM crash.`, { cause: error });
+		const named = memoryCulpritAdvice(memoryCulpritsUnder(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);
 	}
 	if (openViewer) viewer.open(udid);
 }
 function shutdownIosSim(udid) {
-	getExecutor().runQuiet(`xcrun simctl shutdown ${udid}`, SIMCTL_OPTIONS);
+	getExecutor().runFileQuiet("xcrun", [
+		"simctl",
+		"shutdown",
+		udid
+	], SIMCTL_OPTIONS);
 }
 function listIosDeviceTypes() {
 	const out = getExecutor().runFile("xcrun", [
@@ -531,7 +670,13 @@ function createOwnedIosSim(label, { deviceType, runtime, suffix = "" } = {}, cho
 		model: choice.deviceType,
 		runtime: choice.runtime
 	}, suffix);
-	const udid = getExecutor().run(`xcrun simctl create "${name}" "${choice.deviceTypeId}" "${choice.runtimeId}"`, {
+	const udid = getExecutor().runFile("xcrun", [
+		"simctl",
+		"create",
+		name,
+		choice.deviceTypeId,
+		choice.runtimeId
+	], {
 		timeoutMs: SIMCTL_CREATE_TIMEOUT_MS,
 		killSignal: "SIGKILL"
 	}).trim();
@@ -690,7 +835,11 @@ function deleteIosSim(udid) {
 	const result = resolveOwnedIosSim(udid);
 	if (result.missing) return;
 	if (result.notOwned) throw new Error(`Refusing to delete simulator "${result.notOwned}" (${udid}): not a Stim-owned sim; Stim has no record of creating it.`);
-	getExecutor().run(`xcrun simctl delete ${udid}`, SIMCTL_OPTIONS);
+	getExecutor().runFile("xcrun", [
+		"simctl",
+		"delete",
+		udid
+	], SIMCTL_OPTIONS);
 	forgetCreatedDevice("ios", udid);
 }
 const PARKED_DELETE_TIMEOUT_MS = 3e4;
@@ -708,16 +857,23 @@ function deleteParkedIosSim(udid) {
 	], { timeoutMs: PARKED_DELETE_TIMEOUT_MS });
 	forgetCreatedDevice("ios", udid);
 }
+const LIST_RUNTIMES_ARGS = [
+	"simctl",
+	"list",
+	"runtimes",
+	"--json"
+];
+const LIST_RUNTIMES_OPTIONS = {
+	timeoutMs: 3e4,
+	killSignal: "SIGKILL"
+};
 function listIosRuntimes() {
-	const out = getExecutor().runFile("xcrun", [
-		"simctl",
-		"list",
-		"runtimes",
-		"--json"
-	], {
-		timeoutMs: 3e4,
-		killSignal: "SIGKILL"
-	});
+	return parseIosRuntimes(getExecutor().runFile("xcrun", LIST_RUNTIMES_ARGS, LIST_RUNTIMES_OPTIONS));
+}
+async function listIosRuntimesAsync() {
+	return parseIosRuntimes(await getExecutor().runFileAsync("xcrun", LIST_RUNTIMES_ARGS, LIST_RUNTIMES_OPTIONS));
+}
+function parseIosRuntimes(out) {
 	return (JSON.parse(out).runtimes || []).filter((r) => r.isAvailable && r.platform === "iOS").map((r) => ({
 		identifier: r.identifier,
 		name: r.name,
@@ -729,4 +885,4 @@ function listIosRuntimes() {
 	}));
 }
 //#endregion
-export { parseIosSimulatorApp as A, resetIosPrivacy as C, shutdownIosSim as D, sanitizeDeviceLabel as E, readHostMemoryPressure as M, deviceHoldsApk as N, uninstallIosApp as O, deviceHoldsBundle as P, resetIosKeychain as S, resolveOwnedIosSim as T, parkedSimName as _, createOwnedIosSim as a, pickDefaultIosCreation as b, eraseIosSim as c, listAllIosSims as d, listAllIosSimsAsync as f, ownedSimName as g, listUserApps as h, createIosSimSnapshot as i, hostMemoryPressureAdvice as j, configuredIosSimulatorViewer as k, iosRuntimeMatches as l, listIosRuntimes as m, bootIosSim as n, deleteIosSim as o, listIosDeviceTypes as p, clearIosAppData as r, deleteParkedIosSim as s, IOS_BOOT_TIMEOUT_MS as t, iosSimulatorFailureAdvice as u, parseRuntimeVersion as v, resolveIosCreation as w, renameIosSim as x, parseSimctlList as y };
+export { configuredIosSimulatorViewer as A, resetIosKeychain as C, sanitizeDeviceLabel as D, resolveOwnedIosSim as E, memoryCulpritAdvice as F, memoryCulpritFindings as I, readMemoryCulprits as L, hostMemoryPressureAdvice as M, memoryCulpritsUnder as N, shutdownIosSim as O, readHostMemoryPressure as P, deviceHoldsApk 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, listIosDeviceTypes 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, deviceHoldsBundle as z };