stim 1.9.0 → 1.10.1

package/dist/{android-BPGizezh.mjs → android-Bu4mbDzc.mjs}

@@ -1,33 +1,34 @@
-import { G as parseDeviceSlotOption, H as deviceSlotKey, J as validateDeviceSlot, S as setDevice, T as withConfigLock, U as deviceSlotPlatforms, V as deviceSlotFileKey, f as getProject, g as loadConfig, k as ownership_claim_exports, l as getConcurrencyLimits, w as upsertProject, x as saveConfig } from "./config-Cp9lM3wX.mjs";
-import { t as getExecutor } from "./exec-jIAlgilk.mjs";
-import { r as createNdjsonWriter } from "./ndjson-9uFNRwfe.mjs";
-import { _ as workspaceDir, b as workspaceLogsDir, c as writeWorkspaceState, i as recordWorkspaceUse, l as emulatorLogFile, r as readWorkspaceState } from "./workspace-state-DF2gCFhx.mjs";
-import { E as removeTemporaryEntry, T as makeTemporaryDirectory, _ as repoRoot, s as gitCommonDir } from "./worktree-R_cUlE7s.mjs";
-import { a as detectIsExpo, i as detectBundleId, l as projectShortcut, n as appProjectProblem, o as findProjectRoot, r as detectAndroidPackage } from "./project-DS112DYB.mjs";
-import { n as MODE_EXPO, p as writeWorkspaceLaunch, t as MODE_BARE } from "./state-NcJzMEBF.mjs";
+import { L as deviceSlotFileKey, R as deviceSlotKey, S as setDevice, T as withConfigLock, V as parseDeviceSlotOption, W as validateDeviceSlot, f as getProject, g as loadConfig, k as ownership_claim_exports, l as getConcurrencyLimits, w as upsertProject, x as saveConfig, z as deviceSlotPlatforms } from "./config-BEq0Qw_a.mjs";
+import { t as getExecutor } from "./exec-DK8KaVHK.mjs";
+import { r as createNdjsonWriter } from "./ndjson-CDY9IkVC.mjs";
+import { O as workspaceDir, b as emulatorLogFile, c as signalProcessTree, h as recordWorkspaceUse, i as pidExists, j as workspaceLogsDir, m as readWorkspaceState, s as resolveProjectMetro, y as writeWorkspaceState } from "./metro-BWLOJ_Wr.mjs";
+import { D as makeTemporaryDirectory, O as removeTemporaryEntry, s as gitCommonDir, y as repoRoot } from "./worktree-BlizKDpZ.mjs";
+import { a as detectIsExpo, i as detectBundleId, l as projectShortcut, n as appProjectProblem, o as findProjectRoot, r as detectAndroidPackage } from "./project-BXZzOABt.mjs";
+import { n as MODE_EXPO, p as writeWorkspaceLaunch, t as MODE_BARE } from "./state-WGdIbi_d.mjs";
+import { t as withWorkspaceProcessLock } from "./workspace-process-lock-BXA96myD.mjs";
 import { r as waitForChild, t as createLineReader } from "./process-output-Fpl8PYi8.mjs";
-import { a as pidExists, c as resolveProjectMetro, l as signalProcessTree } from "./metro-DrLHaMn2.mjs";
-import { n as verifyCollectorOwnership, r as readCollectors } from "./ownership-D15Op8vN.mjs";
-import { A as settingFile, E as remoteAndroidSetting, F as unknownSettingKeys, J as optimizationBuildProfile, K as artifactCachePolicy, L as REMOTE_DEVICE_BACKENDS, M as settingShapeErrors, O as resolveCacheProviderConfig, P as tunnelModeSetting, W as detectProviders, Y as resolveOptimizations, b as metroWarmupUrlSetting, i as SETTING_SHAPE_REMEDY, k as resolveSettings, l as androidDataPartitionSizeGbSettingError, o as androidAvdConfigSettingError, q as compilerCacheFallbackMessage, u as cacheProviderSettingError, w as publicUrlSetting } from "./settings-D030k0t4.mjs";
-import { C as listAdbDevices, D as memoizeEmulatorProbe, H as waitForBoot, I as probeEmulatorSerial, L as resetAdoptedAvd, P as physicalDeviceModel, R as resolveOwnedAvdSerial, T as listInstalledSystemImages, _ as emulatorDiskSpaceRemedy, a as androidPoolNoCandidatesRefusal, b as findBuildTool, i as androidPoolCandidates, n as androidDeviceAbi, o as androidSystemImageAbi, r as androidHome, s as androidToolCwd, t as androidBuildToolName, v as emulatorFailureRemedy, y as extractEmulatorFailure, z as resolvePhysicalDevice } from "./android-_y4Ohi5z.mjs";
-import { _ as stepTimer, c as launchErrorReport, f as refuseNoProject, g as stepClock, i as formatDuration, l as phaseLine, m as shortHash, n as appReadinessMessage, v as launchErrorPreview } from "./command-output-gByVmIjy.mjs";
-import { C as assetDiffReason, E as readAssetManifest, S as untrackedNativeFiles, T as compareAssetManifests, _ as refingerprintAfterMutation, a as waitForBuild, b as storedAssetManifest, c as describeFingerprintMiss, d as fingerprintDiffRecord, f as fingerprintDiffSuffix, g as providerUploadOutcome, h as providerDownloadPath, m as prepareProviderDownloadDir, o as waitForSharedBuild, p as fingerprintProject, r as releaseBuildLock, s as buildCacheKey, t as acquireBuildLock, u as filesystemBuildCapability, v as resolveBuild, w as captureAssetManifest, x as untrackedMissLine, y as storeBuild } from "./build-lock-DPXPLgTc.mjs";
-import { t as cleanLine } from "./server-expo-B_lctBR3.mjs";
-import { S as uploadRemote, _ as loadProjectProvider, b as resolveEasCliBin, d as UPLOAD_TIMEOUT_MS, f as cacheLevel, g as isEasAuthFailureText, h as exitAfterFlush, m as easAuthNote, o as parkedMaxSetting, p as checkEasAuth, u as RESOLVE_TIMEOUT_MS, x as resolveRemote } from "./sim-pool-KaIsp2Ft.mjs";
-import { C as isEasBuildFailure, _ as noMetroMessage, c as ensureBooted, d as AvdRecoveryError, g as launchOutcomeRecord, h as isPhysicalDeviceRequest, i as detectEntryFile, l as ensureOwnedDevice, n as pickDevClientScheme, o as needsPrebuild, p as ensureWorkspaceStorageSafely, s as runPrebuild, t as devClientScheme, u as AvdBootError, v as noMetroRemedy, w as resolveEasDevelopmentBuild, x as warmMetro, y as resolveMetroWithRetry } from "./dev-client-HyqISM0h.mjs";
-import { t as withWorkspaceProcessLock } from "./workspace-process-lock-DWaiRD0e.mjs";
-import { n as NO_BUILD_PROGRESS, s as startBuildProgress } from "./build-progress-CVqkfPC6.mjs";
-import { a as VERIFY_TIMEOUT_MS, d as verifyLaunch, i as RELEASE_VERIFY_WAIT_MS, l as unverifiedLaunchLines, n as LAUNCH_FATAL, r as LAUNCH_UNVERIFIED, t as LAUNCH_BUNDLING, u as verifyAndroidReleaseLaunch } from "./launch-verify-Q_OtW1Rf.mjs";
-import { _ as launchAndroidReleaseApp, d as deviceShellArg, f as installAndroidApp, g as launchAndroidApp, o as androidAppProcess, p as installConflictKind, r as DEFAULT_METRO_PORT, s as androidDevClientUrl, t as ADB_INSTALL_TIMEOUT_MS } from "./app-install-Uf3a83Tv.mjs";
-import { a as lostLine, c as releaseLeaseOnSignal, i as leaseExpiryText, l as runLease, n as DEBUG_VERIFY_STEP_MS, o as lostRefusal, r as acquireRunLease, s as parseDeviceWait, t as selectFromPool, u as waitFlagConflict } from "./device-pool-CnTAz8X1.mjs";
-import { d as startBuildHeartbeat, f as tailLines, g as acquireBuildSlot, n as HEARTBEAT_INTERVAL_MS, v as releaseBuildSlot } from "./xcode-BZqyxh3e.mjs";
-import { a as statsProjectKey, i as recordRunStats, n as readRunEstimates, t as createRunRecorder } from "./stats-DG9e66Rz.mjs";
-import { o as unknownAndroidSystemImageRefusal, r as checkDeviceCapacity } from "./simslim-B_LsGLuJ.mjs";
-import { a as ensureMetroReachable, b as ownedSessionName, l as resolveRemoteContext, n as binOnPath, o as ensureRemoteBootOwned, s as remoteAndroidDeps } from "./device-remote-AQ5rQPqr.mjs";
-import { a as buildAndroid, c as CCACHE_NOT_RUN, f as resolveCcache, l as CCACHE_UNAVAILABLE, n as resolveAndroidCas, o as productFlavorRefusal, p as formatDiagnostic, r as resolveAndroidCompilerCache, s as readProductFlavors, u as ccacheActivityLine } from "./android-cas-eiExNLf7.mjs";
-import { n as nativeRunCommand, t as launchSlotScope } from "./slot-launch-DU9A-gYw.mjs";
-import { t as spawnEntry } from "./spawn-entry-nCE6m770.mjs";
-import { a as printNativeCrashReport, r as captureNativeCrashes, t as errorDiagnostics } from "./error-diagnostics-Vfz83GCF.mjs";
+import { _ as stepTimer, c as launchErrorReport, f as refuseNoProject, g as stepClock, i as formatDuration, l as phaseLine, m as shortHash, n as appReadinessMessage, v as launchErrorPreview } from "./command-output-D5z2_bcF.mjs";
+import { A as resolveBuild, C as fingerprintDiffRecord, D as providerDownloadPath, E as prepareProviderDownloadDir, F as assetDiffReason, I as captureAssetManifest, L as compareAssetManifests, M as storedAssetManifest, N as untrackedMissLine, O as providerUploadOutcome, P as untrackedNativeFiles, R as readAssetManifest, S as filesystemBuildCapability, T as fingerprintProject, _ as waitForBuild, b as describeFingerprintMiss, g as releaseBuildLock, j as storeBuild, k as refingerprintAfterMutation, m as acquireBuildLock, v as waitForSharedBuild, w as fingerprintDiffSuffix, y as buildCacheKey } from "./device-lease-CbEaIk7b.mjs";
+import { n as NO_BUILD_PROGRESS, s as startBuildProgress } from "./build-progress-BXx-ZBe4.mjs";
+import { B as resolvePhysicalDevice, E as listInstalledSystemImages, F as physicalDeviceModel, L as probeEmulatorSerial, O as memoizeEmulatorProbe, R as resetAdoptedAvd, W as waitForBoot, _ as emulatorDiskSpaceRemedy, a as androidPoolNoCandidatesRefusal, b as findBuildTool, i as androidPoolCandidates, n as androidDeviceAbi, o as androidSystemImageAbi, r as androidHome, s as androidToolCwd, t as androidBuildToolName, v as emulatorFailureRemedy, w as listAdbDevices, y as extractEmulatorFailure, z as resolveOwnedAvdSerial } from "./android-787HhP5w.mjs";
+import { A as resolveCacheProviderConfig, E as publicUrlSetting, H as compilerCacheFallbackMessage, I as tunnelModeSetting, L as unknownSettingKeys, M as settingFile, O as remoteAndroidSetting, P as settingShapeErrors, S as metroWarmupUrlSetting, U as optimizationBuildProfile, V as artifactCachePolicy, W as resolveOptimizations, a as SETTING_SHAPE_REMEDY, d as cacheProviderSettingError, j as resolveSettings, r as REMOTE_DEVICE_BACKENDS, s as androidAvdConfigSettingError, u as androidDataPartitionSizeGbSettingError, z as detectProviders } from "./settings-DOugPlPz.mjs";
+import { y as parkedMaxSetting } from "./ownership-BfPNRf3-.mjs";
+import { a as acquireBuildSlot, s as releaseBuildSlot } from "./in-use-CNIWU-r-.mjs";
+import { n as verifyCollectorOwnership, r as readCollectors } from "./ownership-D2xbLVoz.mjs";
+import { t as cleanLine } from "./server-expo-BvOCeakp.mjs";
+import { A as UPLOAD_TIMEOUT_MS, B as resolveRemote, F as isEasAuthFailureText, I as loadProjectProvider, M as checkEasAuth, N as easAuthNote, P as exitAfterFlush, V as uploadRemote, a as ensureMetroReachable, c as remoteAndroidDeps, j as cacheLevel, k as RESOLVE_TIMEOUT_MS, n as binOnPath, o as ensureRemoteBootOwned, u as resolveRemoteContext, w as ownedSessionName, z as resolveEasCliBin } from "./device-remote-powUHdbK.mjs";
+import { _ as launchAndroidReleaseApp, d as deviceShellArg, f as installAndroidApp, g as launchAndroidApp, o as androidAppProcess, p as installConflictKind, r as DEFAULT_METRO_PORT, s as androidDevClientUrl, t as ADB_INSTALL_TIMEOUT_MS } from "./app-install-Cfmqr3TQ.mjs";
+import { a as VERIFY_TIMEOUT_MS, d as verifyLaunch, i as RELEASE_VERIFY_WAIT_MS, l as unverifiedLaunchLines, n as LAUNCH_FATAL, r as LAUNCH_UNVERIFIED, t as LAUNCH_BUNDLING, u as verifyAndroidReleaseLaunch } from "./launch-verify-BhgkYAws.mjs";
+import { d as isEasBuildFailure, f as resolveEasDevelopmentBuild, o as unknownAndroidSystemImageRefusal, r as checkDeviceCapacity } from "./simslim-DZUxzsjq.mjs";
+import { a as lostLine, c as releaseLeaseOnSignal, i as leaseExpiryText, l as runLease, n as DEBUG_VERIFY_STEP_MS, o as lostRefusal, r as acquireRunLease, s as parseDeviceWait, t as selectFromPool, u as waitFlagConflict } from "./device-pool-BBWLAr55.mjs";
+import { _ as isPhysicalDeviceRequest, b as warmMetro, c as runPrebuild, d as ensureOwnedDevice, f as AvdBootError, g as ensureWorkspaceStorageSafely, h as ensureDevServer, i as detectEntryFile, l as staleNativeDirRefusal, n as pickDevClientScheme, o as planPrebuild, p as AvdRecoveryError, s as recordPrebuild, t as devClientScheme, u as ensureBooted, v as launchOutcomeRecord } from "./dev-client-DExzPiOa.mjs";
+import { t as budgetGate } from "./budget-nDCEwtJv.mjs";
+import { f as spawnEntry, s as startDevServer } from "./start-RbmFPeZ7.mjs";
+import { a as statsProjectKey, i as recordRunStats, n as readRunEstimates, t as createRunRecorder } from "./stats-BAgJaLA4.mjs";
+import { a as buildAndroid, c as CCACHE_NOT_RUN, f as resolveCcache, l as CCACHE_UNAVAILABLE, n as resolveAndroidCas, o as productFlavorRefusal, p as formatDiagnostic, r as resolveAndroidCompilerCache, s as readProductFlavors, u as ccacheActivityLine } from "./android-cas-CITmIeWY.mjs";
+import { d as startBuildHeartbeat, f as tailLines, n as HEARTBEAT_INTERVAL_MS } from "./xcode-B2tBkf0m.mjs";
+import { n as nativeRunCommand, t as launchSlotScope } from "./slot-launch-Dk4oTREM.mjs";
+import { a as printNativeCrashReport, r as captureNativeCrashes, t as errorDiagnostics } from "./error-diagnostics-xxWKNO3-.mjs";
 import { constants, copyFileSync, existsSync, mkdirSync, openSync, readFileSync, readdirSync, renameSync, rmSync } from "node:fs";
 import { InvalidArgumentError } from "commander";
 import { basename, dirname, isAbsolute, join, relative } from "node:path";
@@ -438,7 +439,6 @@ function systemImageRefusal({ slot, flag, resolved, physical, remoteBackend, lis
 function isReleaseVariant(variant) {
 	return typeof variant === "string" && /release$/i.test(variant.trim());
 }
-const NO_METRO = "STIM_NO_METRO";
 const NO_FINGERPRINT = "STIM_NO_FINGERPRINT";
 const NO_DEVICE = "STIM_NO_DEVICE";
 const LAUNCH_FAILED = "STIM_LAUNCH_FAILED";
@@ -644,7 +644,7 @@ function fail$1(code, message, remedy, extra = {}) {
 		extra
 	};
 }
-async function acquireAndroidArtifact({ root, buildLog, writer, settings, isExpo, device, physical, buildPlan, cacheProviderConfig, requestedBuildCache, easBuild, androidPackage: initialPackage, record, maxBuilds, progress }, { deviceAbi, fingerprint, untracked, resolveCached, storeCached, storedAssets, captureAssets, acquireLock, releaseLock, waitForBuild, loadProvider, easAuth, resolveRemoteBuild, uploadRemoteBuild, loadCacheProviderModule, acquireSlot, releaseSlot, needsPrebuildFor, prebuild, build, ccacheFor, swapApk, readState, now }) {
+async function acquireAndroidArtifact({ root, buildLog, writer, settings, isExpo, device, physical, buildPlan, cacheProviderConfig, requestedBuildCache, easBuild, androidPackage: initialPackage, record, maxBuilds, progress }, { deviceAbi, fingerprint, untracked, resolveCached, storeCached, storedAssets, captureAssets, acquireLock, releaseLock, waitForBuild, loadProvider, easAuth, resolveRemoteBuild, uploadRemoteBuild, loadCacheProviderModule, acquireSlot, releaseSlot, planPrebuildFor, prebuild, build, ccacheFor, swapApk, readState, now }) {
 	const { phase, out, estimates, stats, step } = progress;
 	const { variant, release, profile: buildProfile, cas, cache: cachePolicy } = buildPlan;
 	const useBuildCache = cachePolicy.read;
@@ -926,9 +926,23 @@ async function acquireAndroidArtifact({ root, buildLog, writer, settings, isExpo
 				}
 				phase("build", chalk.yellow(`could not take a build slot: ${err?.message || err}; building anyway`));
 			}
-			if (needsPrebuildFor(root, "android", isExpo)) {
+			const prebuildPlan = planPrebuildFor(root, PLATFORM, {
+				isExpo,
+				fingerprint: hash,
+				sources: fingerprintSources
+			});
+			if (prebuildPlan === "refuse") {
+				const refusal = staleNativeDirRefusal(PLATFORM);
+				phaseFailure = fail$1(refusal.code, refusal.message, refusal.remedy, { lastBuildStatus: true });
+				return false;
+			}
+			if (prebuildPlan === "generate" || prebuildPlan === "regenerate") {
 				step("prebuild");
-				const pre = await prebuild(root, PLATFORM, writer, { isExpo });
+				recordPrebuild(root, PLATFORM, null);
+				const pre = await prebuild(root, PLATFORM, writer, {
+					isExpo,
+					clean: prebuildPlan === "regenerate"
+				});
 				if (pre.failed) {
 					phaseFailure = fail$1(pre.code, pre.reason, pre.remedy, {
 						lastBuildStatus: true,
@@ -937,8 +951,8 @@ async function acquireAndroidArtifact({ root, buildLog, writer, settings, isExpo
 					});
 					return false;
 				}
-				phase("prebuild", `android/ generated (${formatDuration(pre.durationMs)})`);
-				androidPackage = androidPackage || detectAndroidPackage(root);
+				phase("prebuild", `${prebuildPlan === "generate" ? "android/ generated" : "android/ not generated from this fingerprint -> regenerated with --clean"} (${formatDuration(pre.durationMs)})`);
+				androidPackage = detectAndroidPackage(root) || androidPackage;
 				record.bundleId = androidPackage;
 				const after = await refingerprintAfterMutation({
 					projectRoot: root,
@@ -946,6 +960,7 @@ async function acquireAndroidArtifact({ root, buildLog, writer, settings, isExpo
 					previousHash: hash,
 					fingerprint
 				});
+				if (after) recordPrebuild(root, PLATFORM, after.hash);
 				if (after?.moved) {
 					storeHash = after.hash;
 					storeSources = after.sources;
@@ -1100,7 +1115,7 @@ function tail(lines, n = FALLBACK_LINES) {
 }
 //#endregion
 //#region src/commands/android/result.ts
-function androidFacts({ slot, serial, avdName = null, deviceName = null, systemImage = null, fingerprint, cacheKey = null, variant = null, metroPort = null, cacheHit, cacheSkipped = false, waitedForBuild = null, appPath, bundleId, installSkipped = false, launched, ccache = CCACHE_UNAVAILABLE, logs, debugHttpHost = null, debugHttpHostNote = null, devClientUrl = null, durationMs, lease }) {
+function androidFacts({ slot, serial, avdName = null, deviceName = null, systemImage = null, fingerprint, cacheKey = null, variant = null, metroPort = null, cacheHit, cacheSkipped = false, waitedForBuild = null, appPath, bundleId, installSkipped = false, launched, ccache = CCACHE_UNAVAILABLE, logs, debugHttpHost = null, debugHttpHostNote = null, devClientUrl = null, durationMs, lease, devServer = null }) {
 	return {
 		platform: PLATFORM,
 		...slot && slot !== "default" ? { slot } : {},
@@ -1128,7 +1143,8 @@ function androidFacts({ slot, serial, avdName = null, deviceName = null, systemI
 		devClientUrl: devClientUrl ?? null,
 		logs: logs ?? null,
 		durationMs: typeof durationMs === "number" && Number.isFinite(durationMs) ? durationMs : null,
-		...lease === void 0 ? {} : { lease }
+		...lease === void 0 ? {} : { lease },
+		...devServer ? { devServer } : {}
 	};
 }
 function lastBuildRecord({ fingerprint, cacheKey, cacheHit, cacheSkipped = false, durationMs, appPath, bundleId, startedAt, status, errorCode = null, avdName = null, deviceName = null }) {
@@ -1166,7 +1182,7 @@ async function finishAndroidUpload(uploadPending, remote, phase) {
 	}
 	return false;
 }
-function reportAndroidResult({ slot, json, useBuildCache, variant, release, metroCheck, metroPort, logsDir, serial, apkPath, androidPackage, installSkipped, record, waitedForBuild, remote, providerName, launchState, launchWarning, launched, ccache, durationMs, writer, emit, lease, recordRun }) {
+function reportAndroidResult({ slot, json, useBuildCache, variant, release, metroCheck, metroPort, logsDir, serial, apkPath, androidPackage, installSkipped, record, waitedForBuild, remote, providerName, launchState, launchWarning, launched, ccache, durationMs, writer, emit, lease, recordRun, reclaimed = [], devServer = null }) {
 	recordRun({
 		failed: false,
 		cacheHit: cacheLevel(record.cacheHit),
@@ -1196,16 +1212,20 @@ function reportAndroidResult({ slot, json, useBuildCache, variant, release, metr
 		ccache,
 		logs: logsDir,
 		durationMs,
-		lease
+		lease,
+		devServer
 	});
 	writer.close();
-	if (json) emit(JSON.stringify(facts));
+	if (json) emit(JSON.stringify(reclaimed.length ? {
+		...facts,
+		reclaimed
+	} : facts));
 	else {
 		const summary = `${launchWarning ? "WARNING" : "OK"}: ${androidPackage} launched on ${serial}, ${release ? `${variant} (embedded JS, no Metro)` : `Metro port ${metroPort}`} (${cacheOutcome(record.cacheHit, remote?.name ?? providerName)})`;
 		const outcome = launchWarning ? chalk.yellow(`${summary} -- ${launchWarning}`) : launchState === "unverified" ? chalk.yellow(`${summary} -- launch UNVERIFIED`) : launchState === "bundling" ? chalk.green(`${summary} -- bundle requested, still building`) : chalk.green(summary);
 		const deviceName = record.avdName || record.deviceName || serial;
 		const cacheResult = useBuildCache ? cacheOutcome(record.cacheHit, remote?.name ?? providerName) : "bypassed; built";
-		const metroResult = release ? `embedded (${variant})` : !metroCheck ? `check skipped on port ${metroPort}` : launchState === "unverified" ? `state unverified on port ${metroPort}` : `running on port ${metroPort}`;
+		const metroResult = release ? `embedded (${variant})` : !metroCheck ? `check skipped on port ${metroPort}` : launchState === "unverified" ? `state unverified on port ${metroPort}` : `running on port ${metroPort}${devServer ? ` (started: ${devServer.reason})` : ""}`;
 		emit([
 			outcome,
 			phaseLine("device", `${deviceName} (${serial})`),
@@ -1461,7 +1481,7 @@ async function resolveInstallSerial({ root, slot, device, physical, remoteDevice
 	});
 	return resolved.serial;
 }
-async function finishAndroidRun({ lease, releaseLease, root, slot, json, metroCheck, useBuildCache, variant, release, isExpo, metroPort, logsDir, emuLog, device, physical, remoteDevice, bootPromise, resolveAvdSerial, waitForDeviceBoot, bootDuration, apkPath, androidPackage: initialPackage, swapDir, record, waitedForBuild, ccache, uploadPending, providerUpload, providerName, remote, abandonedRemote: remoteWasAbandoned, started, startedAt, writer, phase, fail, readApkPackage, install, launch, launchRelease, resolveDevClientScheme, verifyLaunched, verifyReleaseLaunched, spawn, kill, pidAlive, verifyCollector, writeLaunch, writeState, now, out, emit, recordRun, enterPhase }) {
+async function finishAndroidRun({ lease, releaseLease, root, slot, json, metroCheck, useBuildCache, variant, release, isExpo, metroPort, logsDir, emuLog, device, physical, remoteDevice, bootPromise, resolveAvdSerial, waitForDeviceBoot, bootDuration, apkPath, androidPackage: initialPackage, swapDir, record, waitedForBuild, ccache, uploadPending, providerUpload, providerName, remote, abandonedRemote: remoteWasAbandoned, started, startedAt, writer, phase, fail, readApkPackage, install, launch, launchRelease, resolveDevClientScheme, verifyLaunched, verifyReleaseLaunched, spawn, kill, pidAlive, verifyCollector, writeLaunch, writeState, now, out, emit, recordRun, reclaimed, devServer, enterPhase }) {
 	let androidPackage = initialPackage;
 	let leaseWarned = false;
 	const raiseLeaseFor = (boundMs, beforeInstall) => {
@@ -1529,9 +1549,12 @@ async function finishAndroidRun({ lease, releaseLease, root, slot, json, metroCh
 		allowUninstall: release || adopting
 	});
 	if (installed.failed) {
-		const conflict = installConflictKind(installed.reason);
-		const rerun = useBuildCache ? " Then run this command again; it installs the APK from cache without building it again." : " Then run this command again.";
-		const installRemedy = conflict ? `${androidPackage} is already installed on ${serial} ` + (conflict === "signature" ? "with a different signer" : "at a higher versionCode") + `. Uninstall it first (\`adb -s ${serial} uninstall ${androidPackage}\`); its data goes with it.` + rerun : `Check that ${serial} is still connected (\`adb devices\`) and has room for the APK.`;
+		const installRemedy = remoteDevice?.failureRemedy() ?? localInstallRemedy({
+			reason: installed.reason,
+			packageName: androidPackage,
+			serial,
+			useBuildCache
+		});
 		return fail(installed.code || "STIM_INSTALL_FAILED", installed.reason, installRemedy, { lastBuildStatus: true });
 	}
 	if (adopting) try {
@@ -1606,7 +1629,7 @@ async function finishAndroidRun({ lease, releaseLease, root, slot, json, metroCh
 			appId: androidPackage,
 			since: launchedAt
 		}, logsDir, (line) => phase("launch", chalk.red(line)), Boolean(remoteDevice));
-		return fail(launched.code || "STIM_LAUNCH_FAILED", launched.reason, `Check the app installed correctly (\`adb -s ${serial} shell pm list packages ${androidPackage}\`).`, { lastBuildStatus: true });
+		return fail(launched.code || "STIM_LAUNCH_FAILED", launched.reason, launchRemedy(remoteDevice, serial, androidPackage), { lastBuildStatus: true });
 	}
 	writer.write({
 		src: "build",
@@ -1626,17 +1649,15 @@ async function finishAndroidRun({ lease, releaseLease, root, slot, json, metroCh
 	} catch (error) {
 		out(phaseLine("state", chalk.yellow(`could not record Android launch: ${error?.message || error}`)));
 	}
-	const reversedSummary = (launched.reversed ?? []).join(", ") || `tcp:${metroPort}->tcp:${metroPort}`;
-	if (!release && launched.debugHttpHost) phase("metro", `debug_http_host ${launched.debugHttpHost} + adb reverse ${reversedSummary}`);
-	else if (!release) {
-		phase("metro", chalk.yellow(`adb reverse ${reversedSummary}; ${launched.debugHttpHostNote || "debug_http_host not written"}`));
-		writer.write({
-			src: "build",
-			level: "warn",
-			event: "debug_http_host_failed",
-			msg: `debug_http_host was not written for ${androidPackage} on ${serial}: ${launched.debugHttpHostNote || "unknown reason"}`
-		});
-	}
+	if (!release) reportMetroRoute({
+		launched,
+		remote: Boolean(remoteDevice),
+		metroPort,
+		androidPackage,
+		serial,
+		phase,
+		writer
+	});
 	if (launched.devClientNote) {
 		phase("metro", chalk.yellow(launched.devClientNote));
 		writer.write({
@@ -1659,7 +1680,21 @@ async function finishAndroidRun({ lease, releaseLease, root, slot, json, metroCh
 		out
 	});
 	const remoteRelease = Boolean(remoteDevice && release);
-	if (!remoteRelease) {
+	if (remoteDevice) {
+		killPreviousCollector(root, {
+			slot,
+			kill,
+			isAlive: pidAlive,
+			verify: verifyCollector,
+			note: (line) => out(phaseLine("logs", line))
+		});
+		writer.write({
+			src: "build",
+			level: "info",
+			event: "collector_skipped",
+			msg: `remote session ${serial}: device logs come from agent-device/EAS, so no adb logcat collector is attached`
+		});
+	} else {
 		if (physical) raiseLeaseFor(0, false);
 		const collectorPid = await startCollector({
 			root,
@@ -1735,7 +1770,9 @@ async function finishAndroidRun({ lease, releaseLease, root, slot, json, metroCh
 		writer,
 		emit,
 		lease: physical ? leaseFacts : void 0,
-		recordRun
+		recordRun,
+		reclaimed,
+		devServer
 	});
 	if (remoteWasAbandoned || uploadWasAbandoned) exitAfterFlush(0);
 	return {
@@ -1743,6 +1780,33 @@ async function finishAndroidRun({ lease, releaseLease, root, slot, json, metroCh
 		facts
 	};
 }
+function localInstallRemedy({ reason, packageName, serial, useBuildCache }) {
+	const conflict = installConflictKind(reason);
+	if (!conflict) return `Check that ${serial} is still connected (\`adb devices\`) and has room for the APK.`;
+	const rerun = useBuildCache ? " Then run this command again; it installs the APK from cache without building it again." : " Then run this command again.";
+	return `${packageName} is already installed on ${serial} ` + (conflict === "signature" ? "with a different signer" : "at a higher versionCode") + `. Uninstall it first (\`adb -s ${serial} uninstall ${packageName}\`); its data goes with it.` + rerun;
+}
+function launchRemedy(remoteDevice, serial, packageName) {
+	return remoteDevice?.failureRemedy() ?? `Check the app installed correctly (\`adb -s ${serial} shell pm list packages ${packageName}\`).`;
+}
+function reportMetroRoute({ launched, remote, metroPort, androidPackage, serial, phase, writer }) {
+	if (remote) {
+		phase("metro", `public origin ${launched.jsLocation}`);
+		return;
+	}
+	const reversedSummary = (launched.reversed ?? []).join(", ") || `tcp:${metroPort}->tcp:${metroPort}`;
+	if (launched.debugHttpHost) {
+		phase("metro", `debug_http_host ${launched.debugHttpHost} + adb reverse ${reversedSummary}`);
+		return;
+	}
+	phase("metro", chalk.yellow(`adb reverse ${reversedSummary}; ${launched.debugHttpHostNote || "debug_http_host not written"}`));
+	writer.write({
+		src: "build",
+		level: "warn",
+		event: "debug_http_host_failed",
+		msg: `debug_http_host was not written for ${androidPackage} on ${serial}: ${launched.debugHttpHostNote || "unknown reason"}`
+	});
+}
 function diagnoseBootFailure(booted, logFile, runCommand, physical) {
 	return noDeviceDiagnostic({
 		reason: booted.reason ?? "The emulator did not boot.",
@@ -1885,7 +1949,7 @@ function androidCommand(program) {
 	registerAndroid(program);
 }
 function registerAndroid(program) {
-	program.command("android").description("Build (or install from the shared cache), install and launch this workspace's Android app on its owned emulator, wired to the reserved Metro port. Never starts the bundler -- run `stim start` first.").option("--eas-profile <name>", "Download a matching EAS development build; on a miss, print the build command without running it").option("--slot <name>", "Reusable device slot within this workspace (default: default)", parseDeviceSlotOption).option("--json", "Emit the facts as a single JSON line on stdout; every other line goes to stderr").option("--no-metro-check", "Skip the reserved-port Metro health check (the app will load no bundle unless something else serves it)").option("--no-build-cache", "Build fresh, ignoring cached artifacts (local and the project's build-cache provider); the fresh build still replaces the cache entry").option("--variant <name>", "Gradle variant to assemble and install (e.g. productionDebug on a flavored project); overrides the android.variant setting. A variant ending in Release embeds the JS bundle and skips Metro entirely. Default: debug").option("--system-image <id>", "Android system image to create this workspace's owned AVD from, as the sdkmanager package id (e.g. \"system-images;android-36;google_apis;arm64-v8a\"). Overrides the android.systemImage setting for this invocation. An unknown id refuses with STIM_BAD_ARG and prints the installed images.").option("--device [serial]", "Install and launch on a connected physical device instead of this workspace's owned emulator. With no serial, the first connected device this workspace can lease is used. Stim never creates, boots, or deletes a physical device.").option("--remote <backend>", "Install and launch on a remote device with proxy or EAS. Builds are local unless --eas-profile selects an existing EAS build.", (value) => {
+	program.command("android").description("Build (or install from the shared cache), install and launch this workspace's Android app on its owned emulator, wired to the reserved Metro port. A Debug run starts the dev server when it is not running.").option("--eas-profile <name>", "Download a matching EAS development build; on a miss, print the build command without running it").option("--slot <name>", "Reusable device slot within this workspace (default: default)", parseDeviceSlotOption).option("--json", "Emit the facts as a single JSON line on stdout; every other line goes to stderr").option("--no-metro-check", "Skip the reserved-port Metro health check and do not start it (the app will load no bundle unless something else serves it)").option("--no-build-cache", "Build fresh, ignoring cached artifacts (local and the project's build-cache provider); the fresh build still replaces the cache entry").option("--variant <name>", "Gradle variant to assemble and install (e.g. productionDebug on a flavored project); overrides the android.variant setting. A variant ending in Release embeds the JS bundle and skips Metro entirely. Default: debug").option("--system-image <id>", "Android system image to create this workspace's owned AVD from, as the sdkmanager package id (e.g. \"system-images;android-36;google_apis;arm64-v8a\"). Overrides the android.systemImage setting for this invocation. An unknown id refuses with STIM_BAD_ARG and prints the installed images.").option("--device [serial]", "Install and launch on a connected physical device instead of this workspace's owned emulator. With no serial, the first connected device this workspace can lease is used. Stim never creates, boots, or deletes a physical device.").option("--remote <backend>", "Install and launch on a remote device with proxy or EAS. Builds are local unless --eas-profile selects an existing EAS build.", (value) => {
 		if (REMOTE_DEVICE_BACKENDS.includes(value)) return value;
 		throw new InvalidArgumentError(`expected one of: ${REMOTE_DEVICE_BACKENDS.join(", ")}`);
 	}).option("--wait <seconds>", "How long to wait for another workspace to release the device it leases, before refusing with STIM_DEVICE_BUSY (default 60, 0 refuses at once). Only with --device.").option("--no-wait", "Install on a device another workspace leases instead of waiting: this run takes no lease and, when both workspaces build the same app id, the install terminates the holder's running app. Only with --device.").action(async (opts) => {
@@ -1929,7 +1993,7 @@ function registerAndroid(program) {
 		})).ok) process.exit(1);
 	});
 }
-function resolveRunAndroidOptions({ root, json = false, remoteDevice: commandRemoteBackend = null, resolveSettingsFor = resolveSettings, resolveRemoteDeviceContext = resolveRemoteContext, remoteDeviceDeps: makeRemoteDeviceDeps = remoteAndroidDeps, resolveEasBin = resolveEasCliBin, ensureMetroReachable: ensureRemoteMetro = ensureMetroReachable, ensureRemoteBootOwned: ensureRemoteOwned = ensureRemoteBootOwned, detectRemoteProviders = detectProviders, metroCheck = true, useBuildCache = true, easProfile, resolveEasDevelopmentBuild: resolveEasBuild = resolveEasDevelopmentBuild, variant: variantFlag = null, systemImage: systemImageFlag = null, device: deviceFlag = null, wait: waitFlag = void 0, waitConflict = false, acquireLease = acquireRunLease, makeRunLease = runLease, selectPool = selectFromPool, onLeaseSignal = releaseLeaseOnSignal, listDevices = listAdbDevices, deviceModel = physicalDeviceModel, deviceAbi = androidDeviceAbi, isEmulatorDevice = probeEmulatorSerial, readApkPackage = (apkPath) => apkPackage(dumpApkManifest(apkPath)), getLimits = getConcurrencyLimits, checkCapacity = checkDeviceCapacity, acquireSlot = acquireBuildSlot, releaseSlot = releaseBuildSlot, ensureDevice = ensureOwnedDevice, listSystemImages = listInstalledSystemImages, ensureDeviceBooted = ensureBooted, resolveAvdSerial = resolveOwnedAvdSerial, waitForDeviceBoot = waitForBoot, resolveMetro = resolveProjectMetro, warmMetro: prewarmMetro = warmMetro, resolveMetroRetrying = resolveMetroWithRetry, readState = readWorkspaceState, pidAlive = pidExists, verifyCollector = verifyCollectorOwnership, verifyLaunched = verifyLaunch, ensureStorage = ensureWorkspaceStorageSafely, fingerprint = fingerprintProject, untracked = untrackedNativeFiles, resolveCached = resolveBuild, storeCached = storeBuild, storedAssets = storedAssetManifest, captureAssets = captureAssetManifest, acquireLock = acquireBuildLock, releaseLock = releaseBuildLock, waitForBuild: waitForBuild$1 = waitForBuild, loadProvider = loadProjectProvider, easAuth = checkEasAuth, resolveRemoteBuild = resolveRemote, uploadRemoteBuild = uploadRemote, resolveCacheProvider = resolveCacheProviderConfig, loadCacheProviderModule = loadCacheProvider, needsPrebuildFor = needsPrebuild, prebuild = runPrebuild, build = buildAndroid, ccacheFor = resolveCcache, install = installAndroidApp, launch = launchAndroidApp, launchRelease = launchAndroidReleaseApp, verifyReleaseLaunched = verifyAndroidReleaseLaunch, swapApk = swapApkBundle, resolveDevClientScheme = androidDevClientScheme, spawn = (cmd, args, opts) => getExecutor().spawn(cmd, args, opts), kill = (pid, signal) => process.kill(pid, signal), createWriter = createNdjsonWriter, writeLaunch = writeWorkspaceLaunch, writeState = writeWorkspaceState, recordStats = recordRunStats, readEstimates = readRunEstimates, now = Date.now, out = (line) => console.error(line), emit = (line) => console.log(line) } = {}) {
+function resolveRunAndroidOptions({ root, json = false, remoteDevice: commandRemoteBackend = null, resolveSettingsFor = resolveSettings, resolveRemoteDeviceContext = resolveRemoteContext, remoteDeviceDeps: makeRemoteDeviceDeps = remoteAndroidDeps, resolveEasBin = resolveEasCliBin, ensureMetroReachable: ensureRemoteMetro = ensureMetroReachable, ensureRemoteBootOwned: ensureRemoteOwned = ensureRemoteBootOwned, detectRemoteProviders = detectProviders, metroCheck = true, useBuildCache = true, easProfile, resolveEasDevelopmentBuild: resolveEasBuild = resolveEasDevelopmentBuild, variant: variantFlag = null, systemImage: systemImageFlag = null, device: deviceFlag = null, wait: waitFlag = void 0, waitConflict = false, acquireLease = acquireRunLease, makeRunLease = runLease, selectPool = selectFromPool, onLeaseSignal = releaseLeaseOnSignal, listDevices = listAdbDevices, deviceModel = physicalDeviceModel, deviceAbi = androidDeviceAbi, isEmulatorDevice = probeEmulatorSerial, readApkPackage = (apkPath) => apkPackage(dumpApkManifest(apkPath)), getLimits = getConcurrencyLimits, checkCapacity = checkDeviceCapacity, acquireSlot = acquireBuildSlot, releaseSlot = releaseBuildSlot, ensureDevice = ensureOwnedDevice, listSystemImages = listInstalledSystemImages, ensureDeviceBooted = ensureBooted, resolveAvdSerial = resolveOwnedAvdSerial, waitForDeviceBoot = waitForBoot, resolveMetro = resolveProjectMetro, warmMetro: prewarmMetro = warmMetro, startServer = startDevServer, readState = readWorkspaceState, pidAlive = pidExists, verifyCollector = verifyCollectorOwnership, verifyLaunched = verifyLaunch, ensureStorage = ensureWorkspaceStorageSafely, fingerprint = fingerprintProject, untracked = untrackedNativeFiles, resolveCached = resolveBuild, storeCached = storeBuild, storedAssets = storedAssetManifest, captureAssets = captureAssetManifest, acquireLock = acquireBuildLock, releaseLock = releaseBuildLock, waitForBuild: waitForBuild$1 = waitForBuild, loadProvider = loadProjectProvider, easAuth = checkEasAuth, resolveRemoteBuild = resolveRemote, uploadRemoteBuild = uploadRemote, resolveCacheProvider = resolveCacheProviderConfig, loadCacheProviderModule = loadCacheProvider, planPrebuildFor = planPrebuild, prebuild = runPrebuild, build = buildAndroid, ccacheFor = resolveCcache, install = installAndroidApp, launch = launchAndroidApp, launchRelease = launchAndroidReleaseApp, verifyReleaseLaunched = verifyAndroidReleaseLaunch, swapApk = swapApkBundle, resolveDevClientScheme = androidDevClientScheme, spawn = (cmd, args, opts) => getExecutor().spawn(cmd, args, opts), kill = (pid, signal) => process.kill(pid, signal), createWriter = createNdjsonWriter, writeLaunch = writeWorkspaceLaunch, writeState = writeWorkspaceState, recordStats = recordRunStats, readEstimates = readRunEstimates, now = Date.now, out = (line) => console.error(line), emit = (line) => console.log(line) } = {}) {
 	return {
 		root,
 		json,
@@ -1970,7 +2034,7 @@ function resolveRunAndroidOptions({ root, json = false, remoteDevice: commandRem
 		waitForDeviceBoot,
 		resolveMetro,
 		prewarmMetro,
-		resolveMetroRetrying,
+		startServer,
 		readState,
 		pidAlive,
 		verifyCollector,
@@ -1991,7 +2055,7 @@ function resolveRunAndroidOptions({ root, json = false, remoteDevice: commandRem
 		uploadRemoteBuild,
 		resolveCacheProvider,
 		loadCacheProviderModule,
-		needsPrebuildFor,
+		planPrebuildFor,
 		prebuild,
 		build,
 		ccacheFor,
@@ -2066,7 +2130,7 @@ function avdSetupFailure(error, root, logFile) {
 	};
 }
 async function runAndroid(options = {}) {
-	let { root, json, commandRemoteBackend, resolveSettingsFor, resolveRemoteDeviceContext, makeRemoteDeviceDeps, resolveEasBin, ensureRemoteMetro, ensureRemoteOwned, detectRemoteProviders, metroCheck, useBuildCache: requestedBuildCache, easProfile, resolveEasBuild, variantFlag, systemImageFlag, deviceFlag, waitFlag, waitConflict, acquireLease, makeRunLease, selectPool, onLeaseSignal, listDevices, deviceModel, deviceAbi, isEmulatorDevice, readApkPackage, getLimits, checkCapacity, acquireSlot, releaseSlot, ensureDevice, listSystemImages, ensureDeviceBooted, resolveAvdSerial, waitForDeviceBoot, resolveMetro, prewarmMetro, resolveMetroRetrying, readState, pidAlive, verifyCollector, verifyLaunched, ensureStorage, fingerprint, untracked, resolveCached, storeCached, storedAssets, captureAssets, acquireLock, releaseLock, waitForBuild, loadProvider, easAuth, resolveRemoteBuild, uploadRemoteBuild, resolveCacheProvider, loadCacheProviderModule, needsPrebuildFor, prebuild, build, ccacheFor, install, launch, launchRelease, verifyReleaseLaunched, swapApk, resolveDevClientScheme, spawn, kill, createWriter, writeLaunch, writeState, recordStats, readEstimates, now, out, emit } = androidSlotOptions(options);
+	let { root, json, commandRemoteBackend, resolveSettingsFor, resolveRemoteDeviceContext, makeRemoteDeviceDeps, resolveEasBin, ensureRemoteMetro, ensureRemoteOwned, detectRemoteProviders, metroCheck, useBuildCache: requestedBuildCache, easProfile, resolveEasBuild, variantFlag, systemImageFlag, deviceFlag, waitFlag, waitConflict, acquireLease, makeRunLease, selectPool, onLeaseSignal, listDevices, deviceModel, deviceAbi, isEmulatorDevice, readApkPackage, getLimits, checkCapacity, acquireSlot, releaseSlot, ensureDevice, listSystemImages, ensureDeviceBooted, resolveAvdSerial, waitForDeviceBoot, resolveMetro, prewarmMetro, startServer, readState, pidAlive, verifyCollector, verifyLaunched, ensureStorage, fingerprint, untracked, resolveCached, storeCached, storedAssets, captureAssets, acquireLock, releaseLock, waitForBuild, loadProvider, easAuth, resolveRemoteBuild, uploadRemoteBuild, resolveCacheProvider, loadCacheProviderModule, planPrebuildFor, prebuild, build, ccacheFor, install, launch, launchRelease, verifyReleaseLaunched, swapApk, resolveDevClientScheme, spawn, kill, createWriter, writeLaunch, writeState, recordStats, readEstimates, now, out, emit } = androidSlotOptions(options);
 	const progress = options.progress ?? NO_BUILD_PROGRESS;
 	const slot = validateDeviceSlot(options.slot);
 	const started = now();
@@ -2137,6 +2201,7 @@ async function runAndroid(options = {}) {
 	});
 	const recordRun = stats.record;
 	let ccacheActivity = CCACHE_NOT_RUN;
+	let reclaimed = [];
 	const fail = (code, message, remedy, { lastBuildStatus = false, diagnostics = [], lines = [], logPath = null, lease } = {}) => {
 		if (lastBuildStatus) persistLastBuild({
 			writeState,
@@ -2162,7 +2227,8 @@ async function runAndroid(options = {}) {
 			message,
 			remedy: remedy ?? null,
 			...ccacheActivity.status === "not-run" ? {} : { ccache: ccacheActivity },
-			...lease === void 0 ? {} : { lease }
+			...lease === void 0 ? {} : { lease },
+			...reclaimed.length ? { reclaimed } : {}
 		}));
 		writer.close();
 		return {
@@ -2217,6 +2283,19 @@ async function runAndroid(options = {}) {
 	const useBuildCache = cachePolicy.read;
 	const physical = target.kind === "physical";
 	const remoteBackend = target.kind === "remote" ? target.backend : null;
+	const budget = await (options.checkBudget ?? budgetGate)({
+		root,
+		note: out
+	});
+	reclaimed = budget.reclaimed;
+	if (budget.refusal) return fail(budget.refusal.code, budget.refusal.message, budget.refusal.remedy);
+	const remoteContext = remoteBackend ? await resolveRemoteDeviceContext({
+		root,
+		platform: PLATFORM,
+		backend: remoteBackend,
+		easBin: resolveEasBin(root)?.file ?? null
+	}) : null;
+	if (remoteContext && "failed" in remoteContext) return fail(remoteContext.code ?? "STIM_NO_REMOTE_SESSION", remoteContext.failed, remoteContext.remedy);
 	const easBuild = await resolveEasBuild({
 		root,
 		platform: PLATFORM,
@@ -2241,45 +2320,37 @@ async function runAndroid(options = {}) {
 	let remoteDevice = null;
 	const reservedPort = project?.metroPort ?? null;
 	let metroPort = null;
+	let devServer = null;
 	let phaseFailure = null;
 	async function resolveMetroPort() {
 		if (release) phase("metro", `skipped (${variant}: the JS bundle is embedded, no dev server is used)`);
 		else if (metroCheck) {
-			if (!reservedPort) {
-				phaseFailure = fail(NO_METRO, "No Metro port is reserved for this workspace.", "Run `stim start` first, or pass --no-metro-check.");
-				return false;
-			}
-			const held = await resolveMetroRetrying(resolveMetro, reservedPort, root, { onRetry: ({ delayMs }) => phase("metro", `port ${reservedPort} did not verify yet; retrying in ${Math.round(delayMs / 1e3)}s (Metro may still be indexing)`) });
-			if (!held.metro) {
-				const supervisor = readState(root)?.supervisor ?? null;
-				const supervisorAlive = Boolean(supervisor?.pid && pidAlive(supervisor.pid));
-				phaseFailure = fail(NO_METRO, noMetroMessage({
-					port: reservedPort,
-					resolution: held,
-					supervisor,
-					supervisorAlive
-				}), noMetroRemedy({
-					port: reservedPort,
-					supervisor,
-					supervisorAlive
-				}));
+			const gate = await ensureDevServer({
+				root,
+				port: reservedPort,
+				settings,
+				remote: remoteContext !== null,
+				note: out,
+				resolve: resolveMetro,
+				start: startServer,
+				readState
+			});
+			reclaimed = [...reclaimed, ...gate.reclaimed];
+			if (!gate.ok) {
+				phaseFailure = fail(gate.code, gate.message, gate.remedy, { lines: gate.lines });
 				return false;
 			}
-			phase("metro", `port ${reservedPort} (pid ${held.metro?.pid})`);
+			metroPort = gate.port;
+			devServer = gate.devServer;
+			phase("metro", `port ${metroPort} (${devServer ? `started: ${devServer.reason}` : `pid ${gate.pid ?? "unknown, started outside Stim"}`})`);
+			return true;
 		} else phase("metro", reservedPort ? `port ${reservedPort} (not checked)` : `no reservation; using ${DEFAULT_METRO_PORT} (not checked)`);
 		metroPort = release ? null : reservedPort ?? 8081;
 		return true;
 	}
 	if (!await resolveMetroPort()) return phaseFailure;
-	if (remoteBackend) {
-		const resolved = await resolveRemoteDeviceContext({
-			root,
-			platform: PLATFORM,
-			backend: remoteBackend,
-			easBin: resolveEasBin(root)?.file ?? null
-		});
-		if ("failed" in resolved) return fail(resolved.code ?? "STIM_NO_REMOTE_SESSION", resolved.failed, resolved.remedy);
-		remoteDevice = makeRemoteDeviceDeps(resolved.ctx);
+	if (remoteContext) {
+		remoteDevice = makeRemoteDeviceDeps(remoteContext.ctx);
 		if (metroPort !== null) {
 			const reachable = await ensureRemoteMetro({
 				ctx: remoteDevice.ctx,
@@ -2453,7 +2524,7 @@ async function runAndroid(options = {}) {
 			loadCacheProviderModule,
 			acquireSlot,
 			releaseSlot,
-			needsPrebuildFor,
+			planPrebuildFor,
 			prebuild,
 			build,
 			ccacheFor,
@@ -2567,6 +2638,8 @@ async function runAndroid(options = {}) {
 				out,
 				emit,
 				recordRun,
+				reclaimed,
+				devServer,
 				enterPhase: progress.step
 			});
 		} finally {
@@ -2584,4 +2657,4 @@ async function runAndroid(options = {}) {
 	}
 }
 //#endregion
-export { NO_DEVICE, NO_FINGERPRINT, NO_METRO, androidDevClientScheme, androidFacts, androidSystemImageSetting, androidVariantSetting, apkDevClientFacts, apkPackage, collectorLogFile, androidCommand as default, displayPath, dumpApkManifest, findAapt, formatDuration, isReleaseVariant, killPreviousCollector, lastBuildRecord, noDeviceDiagnostic, parseXmltree, phaseLine, registerAndroid, resolveSystemImage, resolveVariant, runAndroid, shortHash, startCollector };
+export { NO_DEVICE, NO_FINGERPRINT, androidDevClientScheme, androidFacts, androidSystemImageSetting, androidVariantSetting, apkDevClientFacts, apkPackage, collectorLogFile, androidCommand as default, displayPath, dumpApkManifest, findAapt, formatDuration, isReleaseVariant, killPreviousCollector, lastBuildRecord, noDeviceDiagnostic, parseXmltree, phaseLine, registerAndroid, resolveSystemImage, resolveVariant, runAndroid, shortHash, startCollector };

package/dist/{android-DEgo4oCo.mjs → android-DPov-fv2.mjs}

@@ -1,5 +1,5 @@
-import { t as getExecutor } from "./exec-jIAlgilk.mjs";
-import { s as androidToolCwd } from "./android-_y4Ohi5z.mjs";
+import { t as getExecutor } from "./exec-DK8KaVHK.mjs";
+import { s as androidToolCwd } from "./android-787HhP5w.mjs";
 //#region src/collector/android.ts
 const LEVEL_BY_LETTER = {
 	V: "debug",

package/dist/{android-cas-eiExNLf7.mjs → android-cas-CITmIeWY.mjs}

@@ -1,13 +1,14 @@
-import { A as withDirLock, M as readJsonFile, j as isJsonObject, u as getConfigDir } from "./config-Cp9lM3wX.mjs";
-import { t as getExecutor } from "./exec-jIAlgilk.mjs";
-import { r as register } from "./cache-manifest-Dg7OnMrp.mjs";
-import { b as workspaceLogsDir, f as sharedCcache, u as ensureWorkspaceStorage } from "./workspace-state-DF2gCFhx.mjs";
+import { u as getConfigDir } from "./config-BEq0Qw_a.mjs";
+import { t as getExecutor } from "./exec-DK8KaVHK.mjs";
+import { r as register } from "./cache-manifest-Pubfp8wV.mjs";
+import { C as sharedCcache, P as withDirLock, j as workspaceLogsDir, x as ensureWorkspaceStorage } from "./metro-BWLOJ_Wr.mjs";
+import { n as spawnDeclared } from "./spawn-claims-CUleC2cM.mjs";
 import { n as stripAnsi, r as waitForChild, t as createLineReader } from "./process-output-Fpl8PYi8.mjs";
-import { r as androidHome } from "./android-_y4Ohi5z.mjs";
-import { l as phaseLine } from "./command-output-gByVmIjy.mjs";
-import { n as spawnDeclared } from "./spawn-claims-Dn3C_N6w.mjs";
-import { d as startBuildHeartbeat, n as HEARTBEAT_INTERVAL_MS } from "./xcode-BZqyxh3e.mjs";
+import { l as phaseLine } from "./command-output-D5z2_bcF.mjs";
+import { r as androidHome } from "./android-787HhP5w.mjs";
+import { d as startBuildHeartbeat, n as HEARTBEAT_INTERVAL_MS } from "./xcode-B2tBkf0m.mjs";
 import { accessSync, constants, existsSync, mkdirSync, readFileSync, readdirSync, realpathSync, renameSync, rmSync, statSync, symlinkSync, writeFileSync } from "node:fs";
+import { isJsonObject, readJsonFile } from "@stim-cli/core/state";
 import { dirname, isAbsolute, join, relative, sep } from "node:path";
 import { createHash, randomUUID } from "node:crypto";
 import { fileURLToPath } from "node:url";

package/dist/android-cas-compiler.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { t as getExecutor } from "./exec-jIAlgilk.mjs";
+import { t as getExecutor } from "./exec-DK8KaVHK.mjs";
 import { appendFileSync, existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
 import { join } from "node:path";
 import { createHash, randomUUID } from "node:crypto";

package/dist/{app-install-Uf3a83Tv.mjs → app-install-Cfmqr3TQ.mjs}

@@ -1,5 +1,5 @@
-import { t as getExecutor } from "./exec-jIAlgilk.mjs";
-import { E as uninstallIosApp, l as iosSimulatorFailureAdvice, m as listUserApps } from "./ios-BL2NFckr.mjs";
+import { t as getExecutor } from "./exec-DK8KaVHK.mjs";
+import { T as uninstallIosApp, c as iosSimulatorFailureAdvice, p as listUserApps } from "./ios-COGcGEcN.mjs";
 import { closeSync, lstatSync, openSync, readSync, readdirSync } from "node:fs";
 import { isAbsolute, join } from "node:path";
 import { createHash } from "node:crypto";