stim 1.17.2 → 1.19.0

package/dist/{build-plan-BDsSi09V.mjs → miss-reason-CjQCOKqq.mjs}

@@ -1,47 +1,47 @@
-import { t as getExecutor } from "./exec-CaErVv7t.mjs";
-import { D as withConfigLock$1, H as projectDeviceSlots, _ as loadConfig$1, a as clearDevice, b as releaseAndroidConsolePort, i as clearAndroidBootPending, k as acquireAvdClaim, p as getProject, t as allConsolePortsAndSerials, w as setDevice, z as deviceSlotPlatforms } from "./config-D0DbpZtM.mjs";
-import { n as ownership_claim_exports } from "./process-identity-BmRm1qV0.mjs";
+import { n as ownership_claim_exports } from "./process-identity-Biv3arCO.mjs";
+import { t as getExecutor } from "./exec-i8GDPwq9.mjs";
 import { r as waitForChild, t as createLineReader } from "./process-output-Fpl8PYi8.mjs";
-import { i as formatDuration, l as phaseLine, m as shortHash, u as plural } from "./command-output-CDAIFD-8.mjs";
-import { Tt as removeTemporaryEntry, a as androidAvdConfigSetting, at as gitCommonDirOnDisk, c as androidDataPartitionSizeGbSetting, wt as makeTemporaryDirectory } from "./settings-Cfd-0r2d.mjs";
-import { u as ownedDeviceLabel } from "./project-D47Rh0ly.mjs";
-import { o as pidExists } from "./metro-g8NqiJp-.mjs";
-import { d as sharedBuildCache } from "./workspace-state-DqcCbpE7.mjs";
-import { o as peekBudget } from "./budget-DfcgFdQB.mjs";
-import { C as diffFingerprintSources, I as storedSources, w as entryDir, y as artifactIn } from "./device-lease-DpoS36_u.mjs";
-import { A as listAvds, B as ownedAvdSystemImage, E as getAvdNameForSerial, F as ownedAvdDeviceProfile, J as resolveOwnedAvdSerial, L as ownedAvdMatchesConfiguration, O as listAdbDevices, P as nextConsolePort, R as ownedAvdName, W as pickDefaultSystemImage, b as createOwnedAvd, f as assertOwnedAvdStopped, ft as parkedMaxSetting, g as avdPoolConfiguration, j as listInstalledSystemImages, n as OWNED_AVD_CONFIG_DEFAULTS, pt as readParked, st as adoptParked, t as DEFAULT_AVD_DEVICE_PROFILE, tt as waitForBoot, ut as isLegacyDeletionClaim, v as bootAndroidEmulator, y as configureNewOwnedAvd } from "./android-B_YNZy61.mjs";
-import { j as readHostMemoryPressure, u as listAllIosSims } from "./ios-DSfnPfse.mjs";
-import { _ as teardownParkedAvd, m as teardownOwnedAvd } from "./ownership-BMLqyBgJ.mjs";
-import { o as estimateBuild, p as readStats$1 } from "./build-progress-D0WkjCPd.mjs";
-import { b as tailLines, u as HEARTBEAT_INTERVAL_MS, y as startBuildHeartbeat } from "./toolchain-DNyR3NPq.mjs";
-import { t as cleanLine } from "./server-expo-CHTyXD0G.mjs";
-import { f as namedBuildMachine, m as resolveBuildMachine, v as hostingMachines } from "./client-SvBdgObD.mjs";
-import { a as call, o as connectHost } from "./hosted-client-Bp4knSwu.mjs";
-import { t as clearDeviceIdleShutdown } from "./idle-shutdown-IGyNV8Cr.mjs";
-import { i as countLiveOwnedDevices, n as DeviceAdmissionRefusal, p as withDeviceBootAdmission, s as peekDeviceSlots } from "./device-capacity-ZC4XSZ4R.mjs";
-import { i as staleNativeDirRefusal } from "./prebuild-D7RUMkwN.mjs";
-import { i as ensureOwnedIosDevice, r as ensureIosBooted } from "./device-ios-C2Um-XUR.mjs";
-import { r as readHostedNative, s as writeHostedNative } from "./ios-state-8L3lgum6.mjs";
-import { n as prepareHostedNative } from "./hosted-native-1Ebbig4w.mjs";
-import { a as easAuthNote } from "./remote-cache-Ci4DQYYj.mjs";
-import { t as reconcileSimSlim } from "./simslim-BWNrc3M3.mjs";
-import { randomUUID } from "node:crypto";
+import { l as phaseLine } from "./command-output-Bt8ygHE7.mjs";
+import { D as withConfigLock$1, H as projectDeviceSlots, _ as loadConfig$1, a as clearDevice, b as releaseAndroidConsolePort, i as clearAndroidBootPending, k as acquireAvdClaim, p as getProject, t as allConsolePortsAndSerials, w as setDevice, z as deviceSlotPlatforms } from "./config-DC5jEtd1.mjs";
+import { d as sharedBuildCache } from "./workspace-state-CR9X86xJ.mjs";
+import { E as readMetroTunnel, O as readRemoteSession, o as ownedDeviceLabel } from "./project-B5eQ1USs.mjs";
+import { Ct as removeTemporaryEntry, J as planMetroReach, St as makeTemporaryDirectory, a as androidAvdConfigSetting, c as androidDataPartitionSizeGbSetting, q as detectProviders, rt as gitCommonDirOnDisk } from "./settings-CxgngUZk.mjs";
+import { s as pidExists } from "./metro-DI2AjPF_.mjs";
+import { s as peekBudget } from "./budget-Dz-kyXLv.mjs";
+import { A as teardownParkedAvd, D as teardownOwnedAvd } from "./workspaces-Djb2gfi9.mjs";
+import { C as diffFingerprintSources, I as storedSources } from "./device-lease-Cu7PtQpZ.mjs";
+import { A as listAvds, B as ownedAvdSystemImage, E as getAvdNameForSerial, F as ownedAvdDeviceProfile, J as resolveOwnedAvdSerial, L as ownedAvdMatchesConfiguration, O as listAdbDevices, P as nextConsolePort, R as ownedAvdName, W as pickDefaultSystemImage, b as createOwnedAvd, f as assertOwnedAvdStopped, ft as parkedMaxSetting, g as avdPoolConfiguration, j as listInstalledSystemImages, n as OWNED_AVD_CONFIG_DEFAULTS, pt as readParked, st as adoptParked, t as DEFAULT_AVD_DEVICE_PROFILE, tt as waitForBoot, ut as isLegacyDeletionClaim, v as bootAndroidEmulator, y as configureNewOwnedAvd } from "./android-BdQC6zs1.mjs";
+import { M as readHostMemoryPressure, d as listAllIosSims } from "./ios-BWbHFZVz.mjs";
+import { E as namedBuildMachine, N as hostingMachines, k as resolveBuildMachine } from "./client-CuUo8Nvg.mjs";
+import { t as clearDeviceIdleShutdown } from "./idle-shutdown-DYiMBn34.mjs";
+import { i as countLiveOwnedDevices, n as DeviceAdmissionRefusal, p as withDeviceBootAdmission, s as peekDeviceSlots } from "./device-capacity-BoN1jQkO.mjs";
+import { E as startBuildHeartbeat, O as tailLines, h as HEARTBEAT_INTERVAL_MS } from "./toolchain-C3xSoyUl.mjs";
+import { t as cleanLine } from "./server-expo-n3tUi3Em.mjs";
+import { a as call, o as connectHost } from "./hosted-client-C5G4h_OJ.mjs";
+import { r as readHostedNative, s as writeHostedNative } from "./ios-state-By0XuLTQ.mjs";
+import { n as prepareHostedNative } from "./hosted-native-DbV2aUVw.mjs";
+import { f as resolveEasCliBin, s as isEasAuthFailureText } from "./remote-cache-N3hAEaAL.mjs";
+import { i as ensureOwnedIosDevice, r as ensureIosBooted } from "./device-ios-B2ruohE-.mjs";
+import { _ as MIN_EAS_CLI_SIMULATOR_VERSION, g as MIN_EAS_CLI_DEVICE_VERSION, s as readInstalledEasCliVersion, v as easCliSupport } from "./device-remote-B5GiUifk.mjs";
+import { t as reconcileSimSlim } from "./simslim-D9LkJxIO.mjs";
 import { existsSync, mkdirSync, readFileSync, readdirSync, realpathSync, rmSync, writeFileSync } from "node:fs";
 import { basename, dirname, join, relative } from "node:path";
-import { LAST_BUILD_KEYS, isJsonObject, loadConfig, machineCapacity, parseHostedChoice, parseHostedNativeOffer, readWorkspaceState } from "@stim-cli/core/state";
-import { claimRemoveCommand, clearClaimChild, markClaimChildPending, processGroupAlive, releaseClaim, setClaimChild } from "@stim-cli/core/ownership-claim";
-import { captureProcessIdentity } from "@stim-cli/core/process-identity";
+import { LAST_BUILD_KEYS, automaticMachineEnabled, isJsonObject, loadConfig, machineCapacity, parseHostedChoice, parseHostedNativeOffer, readWorkspaceState } from "@stim-cli/core/state";
 import chalk from "chalk";
 import { isDeepStrictEqual } from "node:util";
+import { claimRemoveCommand, clearClaimChild, markClaimChildPending, processGroupAlive, releaseClaim, setClaimChild } from "@stim-cli/core/ownership-claim";
+import { captureProcessIdentity } from "@stim-cli/core/process-identity";
+import { randomUUID } from "node:crypto";
 import * as expoFingerprint from "@expo/fingerprint";
-import { resolveTieredBuild } from "@stim-cli/cache";
 import { request } from "node:http";
 //#region src/device-host/placement.ts
-function local$1(reason, skipped = []) {
+function local$1(code, reason, skipped = [], atCapacity = false) {
 	return {
 		kind: "local",
+		code,
 		reason,
-		skipped
+		skipped,
+		...atCapacity ? { atCapacity: true } : {}
 	};
 }
 function decideDevicePlacement(inputs) {
@@ -50,6 +50,7 @@ function decideDevicePlacement(inputs) {
 			const reason = `recorded session on ${inputs.sticky.machine}`;
 			return {
 				kind: "host",
+				code: "sticky",
 				reason,
 				machines: [{
 					machine: inputs.sticky.machine,
@@ -60,30 +61,62 @@ function decideDevicePlacement(inputs) {
 		}
 		return {
 			kind: "local",
+			code: "sticky",
 			reason: "this workspace's device runs here",
 			skipped: []
 		};
 	}
-	const { platform, here, offers, buildMachine, noWait } = inputs;
+	const { platform, here, offers, buildMachine, noWait, eas } = inputs;
 	const { count, max, queued } = here.devices;
-	const cannotTake = !(max === 0 || count !== null && count < max) || queued > 0;
+	const room = max === 0 || count !== null && count < max;
+	const localEnabled = here.localEnabled !== false;
+	const cannotTake = !localEnabled || !room || queued > 0;
+	const atCapacity = count !== null && (!room || queued > 0);
 	const usage = max > 0 ? `${count} of ${max} devices in use` : `${count} devices in use, no device cap`;
-	const localReason = count === null ? "cannot tell how many devices run here; local boot admission decides" : cannotTake ? `${usage}${queued ? `, ${queued} runs queued ahead` : ""}` : here.budgetRefusal ?? (here.memoryPressure !== "normal" ? `host memory pressure ${here.memoryPressure ?? "unknown"} here` : `load ${here.loadPerCore.toFixed(1)}/core here, ${usage}`);
-	if (!offers.length) return local$1("no remote Macs configured; " + localReason);
-	if (count === null) return local$1(localReason);
-	if (!cannotTake && here.memoryPressure === "normal" && !here.budgetRefusal && here.loadPerCore < here.maxLoadPerCore) return local$1(localReason);
+	const localReason = !localEnabled ? "local is disabled in remote.devicePoolDisabled" : count === null ? "cannot tell how many devices run here; local boot admission decides" : cannotTake ? `${usage}${queued ? `, ${queued} runs queued ahead` : ""}` : here.budgetRefusal ?? (here.memoryPressure !== "normal" ? `host memory pressure ${here.memoryPressure ?? "unknown"} here` : `load ${here.loadPerCore.toFixed(1)}/core here, ${usage}`);
+	const nowhere = (code, reason, skipped = [], waiting = "") => {
+		if (!localEnabled && !atCapacity) return {
+			kind: "refused",
+			code: "pool-unavailable",
+			reason,
+			skipped
+		};
+		if (!cannotTake || count === null) return local$1(code, reason + waiting, skipped);
+		if (eas?.usable) return {
+			kind: "eas",
+			code: "eas-fallback",
+			reason: `${reason}; EAS Simulator (remote.easFallback)`,
+			skipped
+		};
+		const why = eas ? [...skipped, {
+			machine: "eas",
+			code: eas.code,
+			reason: eas.reason
+		}] : skipped;
+		return localEnabled ? local$1(code, reason + waiting, why, true) : {
+			kind: "refused",
+			code: "pool-unavailable",
+			reason,
+			skipped: why,
+			atCapacity: true
+		};
+	};
+	if (!offers.length) return nowhere("no-remote-mac", "no remote Macs configured; " + localReason);
+	if (localEnabled && count === null) return local$1("device-count-unknown", localReason);
+	if (!cannotTake && here.memoryPressure === "normal" && !here.budgetRefusal && here.loadPerCore < here.maxLoadPerCore) return local$1("this-mac-free", localReason);
 	const skipped = [];
 	const admitted = [];
 	offers.forEach((probe, index) => {
 		let reason = null;
+		let code = "unreachable";
 		if ("failure" in probe) reason = probe.failure;
 		else {
 			const { offer } = probe;
-			if (offer.declined !== null) reason = `declined: ${offer.declined}`;
-			else if (offer.platform !== platform || !offer.choice) reason = `no matching ${platform} device choice`;
-			else if (offer.resources.memoryPressure !== "normal") reason = "host memory pressure unknown or elevated";
-			else if (offer.capacity.available === 0) reason = "no hosted device capacity available";
-			else if (!cannotTake && (offer.resources.loadPerCore === null || offer.resources.loadPerCore >= here.loadPerCore)) reason = offer.resources.loadPerCore === null ? "host load unknown while this Mac has room" : "host is not less loaded than this Mac";
+			if (offer.declined !== null) [code, reason] = ["declined", `declined: ${offer.declined}`];
+			else if (offer.platform !== platform || !offer.choice) [code, reason] = ["no-matching-device", `no matching ${platform} device choice`];
+			else if (offer.resources.memoryPressure !== "normal") [code, reason] = ["memory", "host memory pressure unknown or elevated"];
+			else if (offer.capacity.available === 0) [code, reason] = ["no-capacity", "no hosted device capacity available"];
+			else if (!cannotTake && (offer.resources.loadPerCore === null || offer.resources.loadPerCore >= here.loadPerCore)) [code, reason] = ["load", offer.resources.loadPerCore === null ? "host load unknown while this Mac has room" : "host is not less loaded than this Mac"];
 			else admitted.push({
 				machine: probe.machine,
 				offer,
@@ -92,17 +125,19 @@ function decideDevicePlacement(inputs) {
 		}
 		if (reason) skipped.push({
 			machine: probe.machine,
+			code,
 			reason
 		});
 	});
 	admitted.sort((a, b) => Number(b.machine === buildMachine) - Number(a.machine === buildMachine) || (a.offer.resources.loadPerCore ?? Infinity) - (b.offer.resources.loadPerCore ?? Infinity) || b.offer.resources.memoryFreeBytes - a.offer.resources.memoryFreeBytes || a.index - b.index);
-	if (!admitted.length) return local$1(`${localReason}; no host admits${cannotTake && !noWait ? "; waiting locally if needed" : ""}`, skipped);
+	if (!admitted.length) return nowhere("no-host-admits", `${localReason}; no host admits`, skipped, localEnabled && cannotTake && !noWait ? "; waiting locally if needed" : "");
 	const machines = admitted.map(({ machine, offer }) => ({
 		machine,
 		reason: `${localReason}; ${machine}${machine === buildMachine ? " is the explicit remote Mac," : ""} load ${offer.resources.loadPerCore === null ? "unknown" : offer.resources.loadPerCore.toFixed(1) + "/core"}`
 	}));
 	return {
 		kind: "host",
+		code: "placed",
 		machines,
 		reason: machines[0].reason,
 		skipped
@@ -160,7 +195,7 @@ async function probeHost(machine, platform, selectors) {
 		host?.connection.close();
 	}
 }
-function hosted(target, reason, skipped = []) {
+function hosted(target, code, reason, skipped = []) {
 	target.selection = {
 		selected: "auto",
 		reason
@@ -172,20 +207,34 @@ function hosted(target, reason, skipped = []) {
 			machine: target.host.machine,
 			reason
 		},
+		code,
 		skipped
 	};
 }
-function local(reason, skipped = []) {
+function local(code, reason, skipped = []) {
 	return {
 		target: null,
 		placement: {
 			decision: "local",
 			reason
 		},
+		code,
 		skipped
 	};
 }
-async function automaticDevicePlacement({ root, slot, platform, selectors, buildMachine, noWait }, { machines = hostingMachines, read = readHostedNative, write = writeHostedNative, resume = prepareHostedNative, peek = () => peekDeviceSlots({
+function viaEas(code, reason, skipped) {
+	return {
+		target: null,
+		placement: {
+			decision: "eas",
+			machine: "eas",
+			reason
+		},
+		code,
+		skipped
+	};
+}
+async function automaticDevicePlacement({ root, slot, platform, selectors, buildMachine, noWait, eas }, { machines = hostingMachines, read = readHostedNative, write = writeHostedNative, resume = prepareHostedNative, peek = () => peekDeviceSlots({
 	platform,
 	project: getProject(root),
 	slot
@@ -200,6 +249,7 @@ async function automaticDevicePlacement({ root, slot, platform, selectors, build
 				machine: recorded.machine,
 				reason: recorded.reason ?? decideDevicePlacement({ sticky: { machine: recorded.machine } }).reason
 			},
+			code: "sticky",
 			skipped: [],
 			sticky: true
 		};
@@ -207,48 +257,134 @@ async function automaticDevicePlacement({ root, slot, platform, selectors, build
 	}
 	const devices = peek();
 	if (devices.localLive) return {
-		...local(decideDevicePlacement({ sticky: { local: true } }).reason),
+		...local("sticky", decideDevicePlacement({ sticky: { local: true } }).reason),
 		sticky: true
 	};
-	const entries = machines();
-	if (entries === null) throw Object.assign(/* @__PURE__ */ new Error("remote.machines is invalid. Run stim guide settings and correct it."), { code: "STIM_HOSTING_REFUSED" });
-	const preference = resolveBuildMachine(buildMachine, process.env.STIM_REMOTE_BUILD, loadConfig$1()?.remote?.build);
+	const configured = machines();
+	if (configured === null) throw Object.assign(/* @__PURE__ */ new Error("remote.machines is invalid. Run stim guide settings and correct it."), { code: "STIM_HOSTING_REFUSED" });
+	const config = loadConfig$1();
+	const entries = configured.filter((machine) => automaticMachineEnabled("device", machine, config));
+	const preference = resolveBuildMachine(buildMachine, process.env.STIM_REMOTE_BUILD, config?.remote?.build);
 	buildMachine = namedBuildMachine(preference) ? preference : void 0;
 	const load = capacity();
 	const here = {
+		localEnabled: automaticMachineEnabled("device", "local", config),
 		loadPerCore: load.loadPerCore,
 		maxLoadPerCore: load.maxLoadPerCore,
 		memoryPressure: memory(),
 		devices,
 		budgetRefusal: await budget(root)
 	};
-	const early = decideDevicePlacement({
+	const inputs = (offers) => ({
 		platform,
 		here,
-		offers: entries.map((machine) => ({
-			machine,
-			failure: "not probed"
-		})),
+		offers,
 		buildMachine,
 		noWait
 	});
-	if (early.kind === "local" && early.skipped.length === 0) return local(early.reason);
-	const probes = await Promise.all(entries.map((machine) => probe(machine, platform, selectors)));
-	const decision = decideDevicePlacement({
-		platform,
-		here,
-		offers: probes.map((each) => each.probe),
-		buildMachine,
-		noWait
+	const notProbed = entries.map((machine) => ({
+		machine,
+		failure: "not probed"
+	}));
+	const early = decideDevicePlacement(inputs(notProbed));
+	const probes = early.kind === "local" && early.skipped.length === 0 ? [] : await Promise.all(entries.map((machine) => probe(machine, platform, selectors)));
+	const offers = probes.length ? probes.map((each) => each.probe) : notProbed;
+	let decision = decideDevicePlacement(inputs(offers));
+	if ((decision.kind === "local" || decision.kind === "refused") && decision.atCapacity && eas) decision = decideDevicePlacement({
+		...inputs(offers),
+		eas: await eas()
 	});
-	if (decision.kind === "local") return local(decision.reason, decision.skipped);
+	if (decision.kind === "refused") throw Object.assign(new Error(devicePlacementLine({
+		decision: "local",
+		reason: decision.reason
+	}, decision.skipped)), {
+		code: "STIM_HOSTING_REFUSED",
+		remedy: "Enable an available member in remote.devicePoolDisabled or select a machine explicitly."
+	});
+	if (decision.kind === "eas") return viaEas(decision.code, decision.reason, decision.skipped);
+	if (decision.kind === "local") return local(decision.code, decision.reason, decision.skipped);
 	const target = probes.find((each) => each.probe.machine === decision.machines[0].machine).target;
-	return hosted(target, decision.reason, decision.skipped);
+	return hosted(target, decision.code, decision.reason, decision.skipped);
 }
 function devicePlacementLine(placement, skipped) {
 	return `${placement.machine ?? "local"}, ${placement.reason}${placement.decision !== "hosted" && skipped.length ? "; " + skipped.map((each) => `${each.machine}: ${each.reason}`).join("; ") : ""}`;
 }
 //#endregion
+//#region src/engine/eas-fallback.ts
+const AVAILABILITY_TIMEOUT_MS = 3e4;
+function unusable(code, reason) {
+	return {
+		usable: false,
+		code,
+		reason
+	};
+}
+/** Reads `eas simulator:availability --json`: `{"available": true, ...}` on stdout, or a failure on stderr. */
+function parseSimulatorAvailability(outcome) {
+	if ("failure" in outcome) {
+		if (outcome.timedOut) return unusable("eas-unavailable", "eas simulator:availability timed out");
+		const detail = outcome.failure.split("\n").map((line) => line.trim()).find((line) => line && !/is now available\.$|^(To upgrade|npm install|Proceeding with|\(node:|\(Use `node)/.test(line));
+		if (isEasAuthFailureText(outcome.failure)) return unusable("eas-logged-out", "eas-cli is not logged in (run eas login or set EXPO_TOKEN)");
+		return unusable("eas-unavailable", `eas simulator:availability failed${detail ? `: ${detail}` : ""}`);
+	}
+	let data = null;
+	try {
+		data = JSON.parse(outcome.stdout.slice(outcome.stdout.indexOf("{")));
+	} catch {}
+	if (typeof data !== "object" || data === null || typeof data.available !== "boolean") return unusable("eas-unavailable", "eas simulator:availability printed no availability");
+	return data.available ? { usable: true } : unusable("eas-not-enabled", "EAS Simulator is not enabled for this EAS account");
+}
+/**
+* Whether this run could use an EAS Simulator the way `--remote eas` does, without starting a session or a build.
+* Each refusal names what `--remote eas` would refuse later, so automatic placement falls through instead.
+*/
+async function checkEasFallback({ root, platform, slot, release, isExpo, tunnelMode, publicUrl, deviceTypeFlag, localOnlyFlags, env = process.env, resolveBin = resolveEasCliBin, readVersion = readInstalledEasCliVersion, onPath = (bin) => getExecutor().findExecutable(bin) !== null, readTunnel = readMetroTunnel, readSession = readRemoteSession, metroPort = () => getProject(root)?.metroPort ?? null, availability = async (bin) => {
+	try {
+		return { stdout: await getExecutor().runFileAsync(bin, [
+			"simulator:availability",
+			"--json",
+			"--non-interactive"
+		], {
+			cwd: root,
+			timeoutMs: AVAILABILITY_TIMEOUT_MS
+		}) };
+	} catch (error) {
+		const err = error;
+		return {
+			failure: String(err.stderr || err.message || error),
+			timedOut: err.code === "ETIMEDOUT"
+		};
+	}
+} }) {
+	if (slot !== "default") return unusable("eas-named-slot", `an EAS Simulator takes only the default slot, not ${slot}`);
+	if (localOnlyFlags.length) return unusable("eas-local-flags", `${localOnlyFlags.join(" and ")} applies only to a ${platform} device on a Mac`);
+	const session = readSession(root);
+	if (session && session.platform !== platform) return unusable("eas-session-busy", `this workspace's EAS Simulator session ${session.sessionId} runs ${session.platform ?? "another platform"}`);
+	if (session && deviceTypeFlag?.trim() && session.deviceType !== deviceTypeFlag.trim()) return unusable("eas-session-busy", `this workspace's EAS Simulator session ${session.sessionId} runs ${session.deviceType ?? "the model EAS chose"}, not ${deviceTypeFlag.trim()}`);
+	if (!onPath("agent-device")) return unusable("eas-no-agent-device", "agent-device is not on PATH");
+	const bin = resolveBin(root);
+	if (!bin) return unusable("eas-no-cli", "eas-cli is not installed for this project or on PATH");
+	const versionOutput = readVersion(bin.file, root);
+	const minimum = platform === "ios" && deviceTypeFlag?.trim() ? MIN_EAS_CLI_DEVICE_VERSION : MIN_EAS_CLI_SIMULATOR_VERSION;
+	const { supported, version } = easCliSupport(versionOutput, minimum);
+	if (!supported) return unusable("eas-cli-too-old", `eas-cli ${version ?? "(unknown version)"} is older than ${minimum}`);
+	if (!release) {
+		const mode = tunnelMode ?? "auto";
+		if (mode === "off") return unusable("eas-metro-unreachable", "metro.tunnel is off, so an EAS Simulator cannot reach Metro");
+		const plan = planMetroReach({
+			mode,
+			metroPort: metroPort() ?? "unknown",
+			publicUrl: env["STIM_METRO_PUBLIC_URL"]?.trim() || publicUrl,
+			isExpo,
+			available: detectProviders(onPath, mode)
+		});
+		if ("failed" in plan) return unusable("eas-metro-unreachable", plan.failed);
+		if ("start" in plan && plan.start === "tailscale") return unusable("eas-metro-unreachable", "metro.tunnel is tailscale, which an EAS Simulator cannot reach");
+		if ("expoTunnel" in plan && readTunnel(root)?.kind !== "expo") return unusable("eas-metro-unreachable", "Metro has no Expo tunnel; run stim start --remote first");
+	}
+	return parseSimulatorAvailability(await availability(bin.file));
+}
+//#endregion
 //#region src/engine/metro-warmup.ts
 const WARMUP_TIMEOUT_MS = 6e4;
 async function requestLocal(url, platform, prefetch) {
@@ -891,7 +1027,7 @@ async function ensureAndroidBooted({ device, deviceSlotWait, projectPath, slot,
 function didSetUpDevice(device, remote) {
 	return remote ? void 0 : Boolean(device.setup || device.booting);
 }
-async function ensureOwnedDevice({ platform, project, projectPath, slot, settingsRoot = projectPath, label = ownedDeviceLabel(projectPath), settings, flags = {}, note = () => {}, out = () => {}, logFile = null, alive = pidExists, configureAvd = configureNewOwnedAvd, teardownAvd = teardownOwnedAvd, reconcileIosSimulator = reconcileSimSlim }) {
+async function ensureOwnedDevice({ platform, project, projectPath, slot, settingsRoot = projectPath, label = ownedDeviceLabel(projectPath), settings, flags = {}, note = () => {}, out = () => {}, logFile = null, alive = pidExists, configureAvd = configureNewOwnedAvd, teardownAvd = teardownOwnedAvd, reconcileIosSimulator = reconcileSimSlim, simSnapshot }) {
 	clearDeviceIdleShutdown(projectPath, platform, slot);
 	if (slot && slot !== "default") label = `${label}-${slot}`;
 	const record = deviceSlotPlatforms(project, slot)?.[platform] ?? null;
@@ -905,7 +1041,8 @@ async function ensureOwnedDevice({ platform, project, projectPath, slot, setting
 		flags,
 		note,
 		out,
-		reconcileIosSimulator
+		reconcileIosSimulator,
+		simSnapshot
 	});
 	return ensureOwnedAndroidDevice({
 		record,
@@ -1603,183 +1740,4 @@ function fingerprintErrorMissReason(message) {
 	};
 }
 //#endregion
-//#region src/commands/build-plan.ts
-const DISCARD = {
-	file: "",
-	written: 0,
-	dropped: 0,
-	lastError: null,
-	write: () => true,
-	close: () => ({
-		file: "",
-		written: 0,
-		dropped: 0,
-		lastError: null
-	})
-};
-async function providerHit({ root, platform, cacheKey, providerConfig }, deps) {
-	if (!providerConfig) return null;
-	let destinationDir;
-	try {
-		destinationDir = makeTemporaryDirectory(root, "stim-plan-");
-	} catch (error) {
-		deps.note(chalk.yellow(phaseLine("cache", `provider not checked: ${error?.message || error}`)));
-		return null;
-	}
-	try {
-		const found = await resolveTieredBuild({
-			local: {
-				resolve: () => null,
-				store: () => null
-			},
-			loadProvider: () => deps.loadCacheProvider({
-				projectRoot: root,
-				config: providerConfig
-			}),
-			target: {
-				projectRoot: root,
-				platform,
-				key: cacheKey
-			},
-			destinationDir,
-			warn: (_code, message) => deps.note(chalk.yellow(phaseLine("cache", message)))
-		});
-		return found ? found.providerName ?? "the cache provider" : null;
-	} finally {
-		removeTemporaryEntry(destinationDir);
-	}
-}
-async function expoRemoteHit(lookup, deps) {
-	if (!lookup.expoRemote) return null;
-	const { root, platform, isExpo, fingerprint } = lookup;
-	const loaded = await deps.loadProjectProvider(root, { isExpo });
-	if (loaded?.unavailable) {
-		deps.note(chalk.yellow(phaseLine("cache", `provider not usable: ${loaded.unavailable}`)));
-		return null;
-	}
-	if (!loaded?.provider) return null;
-	const name = loaded.name ?? "the build cache provider";
-	if (name === "eas") {
-		const auth = deps.checkEasAuth({
-			projectRoot: root,
-			owner: loaded.owner || null
-		});
-		const authNote = easAuthNote(auth);
-		if (authNote) deps.note(chalk.yellow(phaseLine("cache", authNote)));
-		if (auth?.code === "logged-out") return null;
-	}
-	const hit = await deps.resolveRemote({
-		provider: loaded.provider,
-		platform,
-		projectRoot: root,
-		fingerprintHash: fingerprint,
-		runOptions: lookup.expoRemote.runOptions,
-		logWriter: DISCARD
-	});
-	if (hit?.timedOut) deps.note(chalk.yellow(phaseLine("cache", `${name} did not answer; counted as a miss`)));
-	else if (hit?.failed) deps.note(chalk.yellow(phaseLine("cache", `${name} could not be used: ${hit.failed}`)));
-	return hit?.appPath ? name : null;
-}
-async function planCachedBuild(lookup, deps) {
-	const { root, platform, isExpo, fingerprint, sources, cacheKey, cachePolicy } = lookup;
-	let cacheHit = false;
-	let provider = null;
-	if (cachePolicy.read) {
-		if (artifactIn(entryDir(platform, cacheKey))) cacheHit = "local";
-		else {
-			provider = (cachePolicy.remote ? await providerHit(lookup, deps) : null) ?? await expoRemoteHit(lookup, deps);
-			if (provider) cacheHit = "remote";
-		}
-	}
-	let prebuild = null;
-	let refusal = null;
-	let missReason;
-	if (!cacheHit) {
-		prebuild = deps.planPrebuild(root, platform, {
-			isExpo,
-			fingerprint,
-			sources
-		});
-		if (prebuild === "refuse") refusal = staleNativeDirRefusal(platform);
-		else if (cachePolicy.read) missReason = predictBuildMiss({
-			root,
-			platform,
-			current: {
-				hash: fingerprint,
-				sources
-			},
-			prebuild: prebuild === "generate" || prebuild === "regenerate" ? prebuild : null
-		});
-	}
-	return planPayload(lookup, {
-		fingerprint,
-		cacheKey,
-		cacheHit,
-		provider,
-		cacheSkipped: !cachePolicy.read,
-		prebuild,
-		...missReason ? { missReason } : {},
-		refusal
-	});
-}
-function planPayload({ platform, slot, projectKey }, found) {
-	const { refusal, missReason, ...rest } = found;
-	const outcome = refusal ? null : found.cacheHit ? "hit" : "cold";
-	const estimate = outcome ? estimateBuild(readStats$1().record?.history?.[projectKey], platform, outcome) : {
-		expectedMs: null,
-		basis: 0
-	};
-	return {
-		platform,
-		...slot === "default" ? {} : { slot },
-		...rest,
-		outcome,
-		expectedMs: estimate.expectedMs,
-		basis: estimate.basis,
-		...missReason ? { missReason } : {},
-		...refusal ? { refusal } : {}
-	};
-}
-function cacheLine(plan) {
-	if (plan.refusal) return `the build would refuse with ${plan.refusal.code}`;
-	if (plan.cacheHit === "local") return "local cache hit";
-	if (plan.cacheHit === "remote") return `remote cache hit (${plan.provider})`;
-	return `${plan.cacheSkipped ? "cache reads are off" : "cache miss"}: compiles${plan.prebuild === "generate" || plan.prebuild === "regenerate" ? `, ${plan.prebuild}s the native dir` : ""}`;
-}
-function printPlan(plan, json) {
-	if (json) {
-		console.log(JSON.stringify(plan));
-		return;
-	}
-	const slot = plan.slot ? ` [${plan.slot}]` : "";
-	console.log(phaseLine("plan", `${plan.platform}${slot} ${shortHash(plan.fingerprint)} -> ${cacheLine(plan)}`));
-	if (plan.missReason) console.log(phaseLine("cache", `miss: ${plan.missReason.summary}`));
-	if (plan.refusal) {
-		console.log(phaseLine("error", plan.refusal.message));
-		console.log(phaseLine("remedy", plan.refusal.remedy));
-		return;
-	}
-	console.log(phaseLine("expect", plan.expectedMs === null ? `unknown: no ${plan.outcome} run of this project is recorded yet` : `~${formatDuration(plan.expectedMs)} (median of ${plural(plan.basis, `${plan.outcome} run`)})`));
-}
-function refusePlan({ code, message, remedy }, json, lines = []) {
-	console.error(chalk.red(phaseLine("error", message)));
-	for (const line of lines) console.error(chalk.dim(phaseLine("", line)));
-	console.error(chalk.dim(phaseLine("remedy", remedy)));
-	console.error(chalk.red(phaseLine("failed", code)));
-	if (json) console.log(JSON.stringify({
-		code,
-		message,
-		remedy
-	}));
-	process.exitCode = 1;
-}
-const PLAN_ONLY_REMEDY = "Drop the flag to plan the owned simulator or emulator build, or run the command without --plan.";
-function planFlagRefusal(flag) {
-	return {
-		code: "STIM_BAD_ARG",
-		message: `${flag} does not apply to --plan, which predicts the next local build without choosing a device.`,
-		remedy: PLAN_ONLY_REMEDY
-	};
-}
-//#endregion
-export { AvdRecoveryError as _, refusePlan as a, devicePlacementLine as b, skippedMissReason as c, refreshUpdatesManifestFile as d, swapJsBundle as f, AvdBootError as g, ensureOwnedDevice as h, printPlan as i, UPDATES_MANIFEST_NAME as l, ensureBooted as m, planFlagRefusal as n, explainBuildMiss as o, didSetUpDevice as p, planPayload as r, fingerprintErrorMissReason as s, planCachedBuild as t, detectEntryFile as u, warmMetro as v, automaticDevicePlacement as y };
+export { devicePlacementLine as _, UPDATES_MANIFEST_NAME as a, swapJsBundle as c, ensureOwnedDevice as d, AvdBootError as f, automaticDevicePlacement as g, checkEasFallback as h, skippedMissReason as i, didSetUpDevice as l, warmMetro as m, fingerprintErrorMissReason as n, detectEntryFile as o, AvdRecoveryError as p, predictBuildMiss as r, refreshUpdatesManifestFile as s, explainBuildMiss as t, ensureBooted as u, probeHost as v };