stim 1.16.0 → 1.17.1

package/dist/{android-Ift4kVvt.mjs → android-B6rDWrTm.mjs}

@@ -2,49 +2,433 @@ import { t as getExecutor } from "./exec-CaErVv7t.mjs";
 import { C as saveConfig, D as withConfigLock$1, E as upsertProject, L as deviceSlotFileKey, R as deviceSlotKey, V as parseDeviceSlotOption, W as validateDeviceSlot, _ as loadConfig$1, j as formatBytes, p as getProject, u as getConcurrencyLimits, w as setDevice, z as deviceSlotPlatforms } from "./config-D0DbpZtM.mjs";
 import { n as ownership_claim_exports } from "./process-identity-BmRm1qV0.mjs";
 import { r as waitForChild, t as createLineReader } from "./process-output-Fpl8PYi8.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-DnJMdEY-.mjs";
-import { B as settingsLayers, F as settingFile, G as detectProviders, H as unknownSettingKeys, J as artifactCachePolicy, L as settingOriginScope, N as resolveCacheProviderConfig, P as resolveSettings, R as settingShapeErrors, S as metroPortSetting, Tt as removeTemporaryEntry, V as tunnelModeSetting, X as optimizationBuildProfile, Y as compilerCacheFallbackMessage, Z as resolveOptimizations, a as SETTING_SHAPE_REMEDY, d as cacheProviderSettingError, gt as repoRoot, it as gitCommonDir, j as remoteAndroidSetting, k as publicUrlSetting, r as REMOTE_DEVICE_BACKENDS, s as androidAvdConfigSettingError, u as androidDataPartitionSizeGbSettingError, w as metroWarmupUrlSetting, wt as makeTemporaryDirectory } from "./settings-oTSkkNrM.mjs";
-import { n as appProjectProblem, o as findProjectRoot$1, r as detectIsExpo, t as NO_PROJECT_REFUSAL, u as projectShortcut } from "./project-Du91Ilvc.mjs";
-import { l as resolveProjectMetro, o as pidExists, u as signalProcessTree } from "./metro-BeK1ZPz1.mjs";
-import { c as writeWorkspaceState, g as workspaceAgentDeviceDir, i as recordWorkspaceUse, l as emulatorLogFile, r as readWorkspaceState$1, v as workspaceDir, x as workspaceLogsDir$1 } from "./workspace-state-B8-aJ1_5.mjs";
-import { t as budgetGate } from "./budget-DjrURfQn.mjs";
-import { A as providerDownloadPath, B as captureAssetManifest, D as fingerprintProject, E as fingerprintDiffRecord, F as storedAssetManifest, H as readAssetManifest, L as untrackedMissLine, M as refingerprintAfterMutation, N as resolveBuild, O as inputsChangedDuringBuild, P as storeBuild, R as untrackedNativeFiles, S as configInputsChanged, T as filesystemBuildCapability, V as compareAssetManifests, _ as waitForBuild, b as buildCacheKey, g as releaseBuildLock, j as providerUploadOutcome, k as prepareProviderDownloadDir, m as acquireBuildLock, v as waitForSharedBuild, x as changedDuringBuildLine, z as assetDiffReason } from "./device-lease-D-hLqx1b.mjs";
-import { r as releaseBuildSlot, t as acquireBuildSlot } from "./build-slots-rUk77xqh.mjs";
-import { m as writeWorkspaceLaunch, n as MODE_EXPO, t as MODE_BARE } from "./state-DcW6vOd_.mjs";
-import { S as statsProjectKey$1, _ as tapBuildLog, g as startBuildProgress, h as recordFinishedBuild, l as NO_BUILD_PROGRESS, v as createRunRecorder, x as recordRunStats, y as readRunEstimates } from "./idle-DYVymG92.mjs";
-import { $ as trimAndroidCaches, A as listAvds, B as ownedAvdSystemImage, D as hostSystemImageArch, F as ownedAvdDeviceProfile, G as probeEmulatorSerial, I as ownedAvdDirectory, J as resolveOwnedAvdSerial, K as profileNeedsFoldFeature, O as listAdbDevices, Q as systemImageSupportsFold, T as findBuildTool, U as physicalDeviceModel, W as pickDefaultSystemImage, Y as resolvePhysicalDevice, a as androidDeviceAbi, ft as parkedMaxSetting, i as androidDataFreeBytes, j as listInstalledSystemImages, k as listAvdDeviceProfiles, q as resetAdoptedAvd, r as androidBuildToolName, rt as configuredAndroidEmulatorApp, t as DEFAULT_AVD_DEVICE_PROFILE, tt as waitForBoot, u as androidToolCwd } from "./android-B_NumVyQ.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-CDAIFD-8.mjs";
+import { B as settingsLayers, C as metroWarmupUrlSetting, F as settingFile, G as detectProviders, H as unknownSettingKeys, J as artifactCachePolicy, L as settingOriginScope, N as resolveCacheProviderConfig, P as resolveSettings, R as settingShapeErrors, T as parseIosRemote, Tt as removeTemporaryEntry, V as tunnelModeSetting, X as optimizationBuildProfile, Y as compilerCacheFallbackMessage, Z as resolveOptimizations, gt as repoRoot, i as SETTING_SHAPE_REMEDY, it as gitCommonDir, j as remoteAndroidSetting, k as publicUrlSetting, l as androidDataPartitionSizeGbSettingError, o as androidAvdConfigSettingError, u as cacheProviderSettingError, wt as makeTemporaryDirectory, x as metroPortSetting } from "./settings-Cfd-0r2d.mjs";
+import { d as projectShortcut, n as appProjectProblem, r as detectIsExpo, s as findProjectRoot$1, t as NO_PROJECT_REFUSAL } from "./project-D47Rh0ly.mjs";
+import { l as resolveProjectMetro, o as pidExists, u as signalProcessTree } from "./metro-g8NqiJp-.mjs";
+import { c as writeWorkspaceState, g as workspaceAgentDeviceDir, i as recordWorkspaceUse, l as emulatorLogFile, r as readWorkspaceState$1, v as workspaceDir, x as workspaceLogsDir$1 } from "./workspace-state-DqcCbpE7.mjs";
+import { t as budgetGate } from "./budget-CUDz870h.mjs";
+import { A as providerDownloadPath, B as captureAssetManifest, D as fingerprintProject, E as fingerprintDiffRecord, F as storedAssetManifest, H as readAssetManifest, L as untrackedMissLine, M as refingerprintAfterMutation, N as resolveBuild, O as inputsChangedDuringBuild, P as storeBuild, R as untrackedNativeFiles, S as configInputsChanged, T as filesystemBuildCapability, V as compareAssetManifests, _ as waitForBuild, b as buildCacheKey, g as releaseBuildLock, j as providerUploadOutcome, k as prepareProviderDownloadDir, m as acquireBuildLock, v as waitForSharedBuild, x as changedDuringBuildLine, z as assetDiffReason } from "./device-lease-DpoS36_u.mjs";
+import { r as releaseBuildSlot, t as acquireBuildSlot } from "./build-slots-41v_d2x9.mjs";
+import { m as writeWorkspaceLaunch, n as MODE_EXPO, t as MODE_BARE } from "./state-BKa8wNN5.mjs";
+import { $ as trimAndroidCaches, A as listAvds, B as ownedAvdSystemImage, D as hostSystemImageArch, F as ownedAvdDeviceProfile, G as probeEmulatorSerial, I as ownedAvdDirectory, J as resolveOwnedAvdSerial, K as profileNeedsFoldFeature, O as listAdbDevices, Q as systemImageSupportsFold, T as findBuildTool, U as physicalDeviceModel, W as pickDefaultSystemImage, Y as resolvePhysicalDevice, a as androidDeviceAbi, ft as parkedMaxSetting, i as androidDataFreeBytes, j as listInstalledSystemImages, k as listAvdDeviceProfiles, q as resetAdoptedAvd, r as androidBuildToolName, rt as configuredAndroidEmulatorApp, t as DEFAULT_AVD_DEVICE_PROFILE, tt as waitForBoot, u as androidToolCwd } from "./android-B_YNZy61.mjs";
 import { a as workspaceLinks, i as workspaceLinkLine } from "./stim-desktop-Cnz8CPnl.mjs";
-import { i as teardownOwnedAvd } from "./teardown-CL6vDs2Y.mjs";
+import { m as teardownOwnedAvd } from "./ownership-BMLqyBgJ.mjs";
+import { _ as statsProjectKey$1, c as recordFinishedBuild, d as createRunRecorder, f as readRunEstimates, g as recordRunStats, l as startBuildProgress, m as recordCapacityRefusal, n as NO_BUILD_PROGRESS, u as tapBuildLog } from "./build-progress-D0WkjCPd.mjs";
 import { r as createNdjsonWriter } from "./ndjson-PclOIwVY.mjs";
-import { E as ccacheActivityLine, T as CCACHE_UNAVAILABLE, b as tailLines, k as resolveCcache, n as androidToolchain, t as androidRequirements, u as HEARTBEAT_INTERVAL_MS, w as CCACHE_NOT_RUN, y as startBuildHeartbeat } from "./toolchain-DkUflduf.mjs";
-import { t as cleanLine } from "./server-expo-MC0rHlOC.mjs";
-import { a as offloadBuild, c as placementLoad, d as OffloadRefusal, f as namedBuildMachine, i as closeOffload, l as remotePhaseText, m as resolveBuildPlacement, n as buildPlacementCandidates, p as parseBuildMachineOption, r as chooseBuildMachine, s as offloadPlacement } from "./client-BTY686R6.mjs";
-import { n as verifyCollectorOwnership, r as readCollectors } from "./ownership-DiA16AsN.mjs";
-import { S as restartedAppNote, b as launchAndroidReleaseApp, c as androidDevClientUrl, g as installConflictKind, h as installAndroidApp, r as DEFAULT_METRO_PORT, s as androidAppProcess, t as ADB_INSTALL_TIMEOUT_MS, y as launchAndroidApp } from "./app-install-CKWdbXIX.mjs";
-import { t as checkDeviceCapacity } from "./device-capacity-BHwxNBlu.mjs";
-import { C as resolveSystemImage, S as resolveDeviceProfile, T as systemImageRefusal, _ as isReleaseVariant, a as PLATFORM, b as pooledAndroidDevice, c as androidSystemImageSetting, d as apkPackage, f as deviceProfileRefusal, g as foldableImageRefusal, h as findAapt, i as NO_FINGERPRINT, l as androidVariantSetting, m as dumpApkManifest, n as LAUNCH_FAILED, o as androidBuildOptions, p as displayPath, r as NO_DEVICE, s as androidDevClientScheme, t as INSTALL_FAILED, u as apkDevClientFacts, v as noDeviceDiagnostic, w as resolveVariant, x as remoteAvdFlagRefusal, y as parseXmltree } from "./support-CAP8qDUF.mjs";
+import { E as ccacheActivityLine, T as CCACHE_UNAVAILABLE, b as tailLines, k as resolveCcache, n as androidToolchain, t as androidRequirements, u as HEARTBEAT_INTERVAL_MS, w as CCACHE_NOT_RUN, y as startBuildHeartbeat } from "./toolchain-CdrxgUeA.mjs";
+import { t as cleanLine } from "./server-expo-CHTyXD0G.mjs";
+import { a as offloadBuild, c as placementLoad, d as OffloadRefusal, f as namedBuildMachine, h as resolveBuildPlacement, i as closeOffload, l as remotePhaseText, n as buildPlacementCandidates, p as parseBuildMachineOption, r as chooseBuildMachine, s as offloadPlacement } from "./client-CxNotugx.mjs";
+import { r as hostedMetroSettings } from "./metro-gateway-CHqK0p-a.mjs";
+import { n as verifyCollectorOwnership, r as readCollectors } from "./ownership-DyRQru0q.mjs";
+import { n as DeviceAdmissionRefusal, r as checkDeviceCapacity, t as DEFAULT_DEVICE_SLOT_WAIT_MS } from "./device-capacity-ZC4XSZ4R.mjs";
+import { S as restartedAppNote, b as launchAndroidReleaseApp, c as androidDevClientUrl, g as installConflictKind, h as installAndroidApp, r as DEFAULT_METRO_PORT, s as androidAppProcess, t as ADB_INSTALL_TIMEOUT_MS, y as launchAndroidApp } from "./app-install-VPkI5WEg.mjs";
+import { C as resolveSystemImage, S as resolveDeviceProfile, T as systemImageRefusal, _ as isReleaseVariant, a as PLATFORM, b as pooledAndroidDevice, c as androidSystemImageSetting, d as apkPackage, f as deviceProfileRefusal, g as foldableImageRefusal, h as findAapt, i as NO_FINGERPRINT, l as androidVariantSetting, m as dumpApkManifest, n as LAUNCH_FAILED, o as androidBuildOptions, p as displayPath, r as NO_DEVICE, s as androidDevClientScheme, t as INSTALL_FAILED, u as apkDevClientFacts, v as noDeviceDiagnostic, w as resolveVariant, x as remoteAvdFlagRefusal, y as parseXmltree } from "./support-WvD__tSV.mjs";
 import { t as spawnEntry } from "./spawn-entry-jw19m8Nl.mjs";
-import { i as staleNativeDirRefusal, n as recordPrebuild, r as runPrebuild, t as planPrebuild } from "./prebuild-D2fsca_Z.mjs";
-import { c as formatDiagnostic, i as buildAndroid, o as productFlavorRefusal, s as readProductFlavors } from "./gradle-BsO1MdsH.mjs";
-import { a as VERIFY_TIMEOUT_MS, d as verifyAndroidReleaseLaunch, f as verifyLaunch, i as RELEASE_VERIFY_WAIT_MS, l as unattributedLaunchLines, n as LAUNCH_FATAL, r as LAUNCH_UNVERIFIED, t as LAUNCH_BUNDLING, u as unverifiedLaunchLines } from "./launch-verify-2DBRizjo.mjs";
-import { a as acquireRunLease, c as lostRefusal, d as runLease, f as waitFlagConflict, l as parseDeviceWait, o as leaseExpiryText, s as lostLine, t as DEBUG_VERIFY_STEP_MS, u as releaseLeaseOnSignal } from "./device-lease-run-CqjShqWW.mjs";
-import { a as easAuthNote, c as loadProjectProvider, f as resolveEasCliBin, i as checkEasAuth, m as uploadRemote, n as UPLOAD_TIMEOUT_MS, o as exitAfterFlush, p as resolveRemote, r as cacheLevel, s as isEasAuthFailureText, t as RESOLVE_TIMEOUT_MS } from "./remote-cache-C8-V13XN.mjs";
-import { a as ensureMetroReachable, c as remoteAndroidDeps, n as binOnPath, o as ensureRemoteBootOwned, u as resolveRemoteContext, w as ownedSessionName } from "./device-remote-D5WVWqOq.mjs";
-import { d as withNativeBuildRun, r as cancelledFailure, u as runCancellation } from "./native-run-NaBrRFtQ.mjs";
-import { a as isEasBuildFailure, o as planEasDevelopmentBuild, s as resolveEasDevelopmentBuild } from "./simslim-B8-7AoTI.mjs";
-import { c as startDevServer, m as detectAppIds, p as detectAndroidPackage } from "./start-ClDfwXa4.mjs";
-import { _ as AvdRecoveryError, a as refusePlan, c as skippedMissReason, d as refreshUpdatesManifestFile, g as AvdBootError, h as ensureOwnedDevice, i as printPlan, l as UPDATES_MANIFEST_NAME, m as ensureBooted, n as planFlagRefusal, o as explainBuildMiss, p as didSetUpDevice, r as planPayload, s as fingerprintErrorMissReason, t as planCachedBuild, u as detectEntryFile, v as warmMetro } from "./build-plan-DjeSb2Xl.mjs";
-import { i as launchOutcomeRecord, n as ensureWorkspaceStorageSafely, r as isPhysicalDeviceRequest, t as ensureDevServer } from "./native-runtime-DBzRnEKS.mjs";
-import { t as selectFromPool } from "./device-pool-CUaEWMMm.mjs";
-import { n as nativeRunCommand, r as siblingPlatformSlots, t as launchSlotScope } from "./slot-launch-B8VrHxn1.mjs";
-import { a as printNativeCrashReport, r as captureNativeCrashes, t as errorDiagnostics } from "./error-diagnostics-B9L4Ae0x.mjs";
-import { n as resolveAndroidCas, r as resolveAndroidCompilerCache } from "./android-cas-8U4DPqeR.mjs";
+import { i as staleNativeDirRefusal, n as recordPrebuild, r as runPrebuild, t as planPrebuild } from "./prebuild-D7RUMkwN.mjs";
+import { c as formatDiagnostic, i as buildAndroid, o as productFlavorRefusal, s as readProductFlavors } from "./gradle-bsBRy6i9.mjs";
+import { a as VERIFY_TIMEOUT_MS, d as verifyAndroidReleaseLaunch, f as verifyLaunch, i as RELEASE_VERIFY_WAIT_MS, l as unattributedLaunchLines, n as LAUNCH_FATAL, r as LAUNCH_UNVERIFIED, t as LAUNCH_BUNDLING, u as unverifiedLaunchLines } from "./launch-verify-lTnWZikR.mjs";
+import { a as acquireRunLease, c as lostRefusal, d as runLease, f as waitFlagConflict, l as parseDeviceWait, o as leaseExpiryText, s as lostLine, t as DEBUG_VERIFY_STEP_MS, u as releaseLeaseOnSignal } from "./device-lease-run-B8YltIH_.mjs";
+import { a as writeHostedAndroid, i as writeDevicePlacement, t as readHostedAndroid } from "./ios-state-8L3lgum6.mjs";
+import { _ as AvdRecoveryError, a as refusePlan, b as devicePlacementLine, c as skippedMissReason, d as refreshUpdatesManifestFile, g as AvdBootError, h as ensureOwnedDevice, i as printPlan, l as UPDATES_MANIFEST_NAME, m as ensureBooted, n as planFlagRefusal, o as explainBuildMiss, p as didSetUpDevice, r as planPayload, s as fingerprintErrorMissReason, t as planCachedBuild, u as detectEntryFile, v as warmMetro, y as automaticDevicePlacement } from "./build-plan-BJSXzsCL.mjs";
+import { n as prepareHostedAndroid, t as placeHostedAndroid } from "./hosted-android-DgU31wY3.mjs";
+import { n as nativeRunCommand, r as siblingPlatformSlots, t as launchSlotScope } from "./slot-launch-DmjBmpQV.mjs";
+import { a as easAuthNote, c as loadProjectProvider, f as resolveEasCliBin, i as checkEasAuth, m as uploadRemote, n as UPLOAD_TIMEOUT_MS, o as exitAfterFlush, p as resolveRemote, r as cacheLevel, s as isEasAuthFailureText, t as RESOLVE_TIMEOUT_MS } from "./remote-cache-Ci4DQYYj.mjs";
+import { a as ensureMetroReachable, c as remoteAndroidDeps, n as binOnPath, o as ensureRemoteBootOwned, u as resolveRemoteContext, w as ownedSessionName } from "./device-remote-hFSkpfQu.mjs";
+import { d as runCancellationSignal, f as withNativeBuildRun, r as cancelledFailure, u as runCancellation } from "./native-run-D1Q56rAD.mjs";
+import { a as isEasBuildFailure, o as planEasDevelopmentBuild, s as resolveEasDevelopmentBuild } from "./simslim-BWNrc3M3.mjs";
+import { c as startDevServer, m as detectAppIds, p as detectAndroidPackage } from "./start-BHIersSm.mjs";
+import { i as launchOutcomeRecord, n as ensureWorkspaceStorageSafely, r as isPhysicalDeviceRequest, t as ensureDevServer } from "./native-runtime-YhaSxP4v.mjs";
+import { t as selectFromPool } from "./device-pool-3o7s5lo4.mjs";
+import { a as printNativeCrashReport, r as captureNativeCrashes, t as errorDiagnostics } from "./error-diagnostics-C-NMnhrk.mjs";
+import { n as resolveAndroidCas, r as resolveAndroidCompilerCache } from "./android-cas-ZFpjJBL_.mjs";
 import { constants, copyFileSync, existsSync, mkdirSync, openSync, readFileSync, renameSync, rmSync, statSync } from "node:fs";
 import { basename, dirname, isAbsolute, join } from "node:path";
+import { workspaceId } from "@stim-cli/core";
 import { InvalidArgumentError } from "commander";
-import { buildDiagnostics, machineCapacity, parseMachine } from "@stim-cli/core/state";
+import { buildDiagnostics, hostedAndroidStatus, machineCapacity, parseMachine } from "@stim-cli/core/state";
 import chalk from "chalk";
 import { createWarnOnce, loadCacheProvider, resolveTieredBuild, storeTieredBuild } from "@stim-cli/cache";
+//#region src/commands/android/remote.ts
+async function connectAndroidHosting({ root, slot, machine, release, metroCheck, selectors, read = readHostedAndroid, resolveSerial = resolveOwnedAvdSerial, prepare = prepareHostedAndroid }) {
+	let recorded;
+	try {
+		recorded = read(root, slot)[slot];
+	} catch (error) {
+		return { failure: {
+			code: "STIM_HOSTING_REFUSED",
+			message: error.message,
+			remedy: `Restore that slot's recorded machine and session from the host, then run stim stop${slot === "default" ? "" : ` --slot ${slot}`} to reconcile it.`
+		} };
+	}
+	if (recorded && recorded.machine !== machine) return { failure: {
+		code: "STIM_BAD_ARG",
+		message: `This workspace's Android emulator runs on ${recorded.machine}; run stim stop first.`
+	} };
+	if (!machine) return { target: null };
+	if (!release && !metroCheck) return { failure: {
+		code: "STIM_BAD_ARG",
+		message: "Hosted Debug runs require the local Metro supervisor; --no-metro-check cannot be used.",
+		remedy: "Run stim stop; stim start, then retry without --no-metro-check."
+	} };
+	const local = deviceSlotPlatforms(getProject(root), slot)?.android;
+	if (local?.owned && local.avdName) {
+		let running = true;
+		try {
+			const resolved = resolveSerial(local.avdName, { timeoutMs: 5e3 });
+			running = Boolean(resolved.serial) || !resolved.notRunning && !resolved.missing;
+		} catch {}
+		if (running) return { failure: {
+			code: "STIM_BAD_ARG",
+			message: `This workspace's Android emulator for slot ${slot} runs on this Mac; run stim stop first.`
+		} };
+	}
+	try {
+		return { target: await prepare(machine, selectors, recorded) };
+	} catch (error) {
+		return { failure: {
+			code: error.code ?? "STIM_HOSTING_REFUSED",
+			message: error.message,
+			...error instanceof Error && "remedy" in error && typeof error.remedy === "string" ? { remedy: error.remedy } : {}
+		} };
+	}
+}
+async function selectAndroidPlacement({ target: selected, automatic = automaticDevicePlacement, checkBudget = budgetGate, note, phase, noWait, buildMachine, localSelectors, ...args }) {
+	const selectors = selected.kind === "hosted" ? {
+		...selected.systemImage ? { systemImage: selected.systemImage } : {},
+		...selected.deviceProfile ? { deviceProfile: selected.deviceProfile } : {}
+	} : {};
+	if (selected.kind !== "hosted" || selected.machine !== "auto") {
+		const connected = await connectAndroidHosting({
+			...args,
+			selectors,
+			machine: selected.kind === "hosted" ? selected.machine : null
+		});
+		if ("failure" in connected) return connected;
+		return {
+			target: selected,
+			hostedTarget: connected.target,
+			selectors,
+			budget: connected.target ? {
+				reclaimed: [],
+				refusal: null
+			} : await checkBudget({
+				root: args.root,
+				note
+			})
+		};
+	}
+	const refusal = localSelectors(selected);
+	if (refusal) return { failure: refusal };
+	try {
+		const placed = await automatic({
+			root: args.root,
+			slot: args.slot,
+			platform: "android",
+			selectors,
+			buildMachine,
+			noWait
+		});
+		phase("placement:", devicePlacementLine(placed.placement, placed.skipped));
+		if (placed.target && !args.release && !args.metroCheck) return { failure: {
+			code: "STIM_BAD_ARG",
+			message: "Hosted Debug runs require the local Metro supervisor; --no-metro-check cannot be used.",
+			remedy: "Run stim stop; stim start, then retry without --no-metro-check."
+		} };
+		return {
+			target: placed.target ? {
+				...selected,
+				machine: placed.target.host.machine
+			} : {
+				kind: "emulator",
+				systemImage: selected.systemImage,
+				deviceProfile: selected.deviceProfile
+			},
+			hostedTarget: placed.target,
+			selectors,
+			budget: placed.target ? {
+				reclaimed: [],
+				refusal: null
+			} : await checkBudget({
+				root: args.root,
+				note
+			}),
+			devicePlacement: placed.placement
+		};
+	} catch (error) {
+		return { failure: {
+			code: error.code ?? "STIM_HOSTING_REFUSED",
+			message: error.message,
+			...error instanceof Error && "remedy" in error && typeof error.remedy === "string" ? { remedy: error.remedy } : {}
+		} };
+	}
+}
+//#endregion
+//#region src/commands/android/result.ts
+function androidFacts({ root, slot, serial, avdName = null, deviceName = null, systemImage = null, deviceProfile = 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, buildMachine = "auto", builtOn, offloadedTo = null, offloadFallback = null, host }) {
+	return {
+		platform: PLATFORM,
+		...host ? { host } : {},
+		...slot && slot !== "default" ? { slot } : {},
+		serial: serial ?? null,
+		avdName: avdName ?? null,
+		deviceName: deviceName ?? avdName ?? null,
+		systemImage: systemImage ?? null,
+		deviceProfile: deviceProfile ?? null,
+		fingerprint: fingerprint ?? null,
+		cacheKey: cacheKey ?? null,
+		variant: variant ?? null,
+		metroPort: metroPort ?? null,
+		cacheHit: cacheLevel(cacheHit),
+		cacheSkipped: Boolean(cacheSkipped),
+		buildMachine,
+		...builtOn ? { builtOn } : {},
+		...offloadedTo ? { offloadedTo } : {},
+		...offloadFallback ? { offloadFallback } : {},
+		waitedForBuild: waitedForBuild ? {
+			pid: waitedForBuild.pid ?? null,
+			ms: waitedForBuild.ms ?? 0
+		} : null,
+		appPath: appPath ?? null,
+		bundleId: bundleId ?? null,
+		installSkipped: Boolean(installSkipped),
+		launched: launched === "unverified" || launched === "bundling" ? launched : Boolean(launched),
+		ccache,
+		debugHttpHost: debugHttpHost ?? null,
+		debugHttpHostNote: debugHttpHostNote ?? null,
+		devClientUrl: devClientUrl ?? null,
+		logs: logs ?? null,
+		...root && !host ? { agentDevice: { stateDir: workspaceAgentDeviceDir(root) } } : {},
+		durationMs: typeof durationMs === "number" && Number.isFinite(durationMs) ? durationMs : null,
+		...lease === void 0 ? {} : { lease },
+		...devServer ? { devServer } : {}
+	};
+}
+function lastBuildRecord({ devicePlacement, fingerprint, cacheKey, cacheHit, cacheSkipped = false, durationMs, appPath, bundleId, startedAt, status, errorCode = null, avdName = null, deviceName = null, missReason = null, diagnostics = null, configuration = null, buildMachine = "auto", builtOn, offloadedTo = null, offloadFallback = null }) {
+	const record = {
+		platform: PLATFORM,
+		avdName: avdName ?? null,
+		deviceName: deviceName ?? avdName ?? null,
+		fingerprint: fingerprint ?? null,
+		cacheKey: cacheKey ?? null,
+		cacheHit: cacheLevel(cacheHit),
+		cacheSkipped: Boolean(cacheSkipped),
+		durationMs: Number.isFinite(durationMs) ? durationMs : null,
+		appPath: appPath ?? null,
+		bundleId: bundleId ?? null,
+		startedAt,
+		status,
+		configuration: configuration ?? null
+	};
+	if (errorCode) record.errorCode = errorCode;
+	if (devicePlacement) record.devicePlacement = devicePlacement;
+	record.buildMachine = buildMachine;
+	if (builtOn) record.builtOn = builtOn;
+	if (offloadedTo) record.offloadedTo = offloadedTo;
+	if (offloadFallback) record.offloadFallback = offloadFallback;
+	if (missReason && !cacheLevel(cacheHit)) record.missReason = missReason;
+	const recorded = status === "failed" ? buildDiagnostics(diagnostics) : [];
+	if (recorded.length) record.diagnostics = recorded;
+	return record;
+}
+async function finishAndroidUpload(uploadPending, remote, phase) {
+	if (!uploadPending) return false;
+	const upload = await uploadPending;
+	if (upload?.uploaded) phase("cache", `uploaded (${remote?.name})`);
+	else if (upload?.timedOut) {
+		phase("cache", chalk.yellow(`${remote?.name} upload still running after ${formatDuration(UPLOAD_TIMEOUT_MS)}; not waiting`));
+		return true;
+	} else if (upload?.failed) {
+		const authNote = remote?.name === "eas" && isEasAuthFailureText(upload.failed) ? easAuthNote({
+			code: "logged-out",
+			reason: upload.failed,
+			phase: "upload"
+		}) : null;
+		phase("cache", chalk.yellow(authNote || `${remote?.name} upload failed: ${upload.failed}`));
+	}
+	return false;
+}
+function reportAndroidResult({ host, root, 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, links }) {
+	const offloadedTo = record.offloadedTo ?? null;
+	recordRun({
+		failed: false,
+		cacheHit: cacheLevel(record.cacheHit),
+		waited: waitedForBuild,
+		durationMs,
+		offloadedTo
+	});
+	const facts = androidFacts({
+		host,
+		root,
+		slot,
+		serial,
+		avdName: record.avdName,
+		deviceName: record.deviceName,
+		systemImage: record.systemImage,
+		deviceProfile: record.deviceProfile,
+		debugHttpHost: launched.debugHttpHost ?? null,
+		debugHttpHostNote: launched.debugHttpHostNote ?? null,
+		devClientUrl: launched.devClientUrl ?? null,
+		fingerprint: record.fingerprint,
+		cacheKey: record.cacheKey,
+		variant,
+		metroPort,
+		cacheHit: record.cacheHit,
+		cacheSkipped: !useBuildCache,
+		waitedForBuild,
+		appPath: apkPath,
+		bundleId: androidPackage,
+		installSkipped,
+		launched: launchState,
+		ccache,
+		logs: logsDir,
+		durationMs,
+		lease,
+		devServer,
+		buildMachine: record.buildMachine,
+		builtOn: record.builtOn ?? void 0,
+		offloadedTo,
+		offloadFallback: record.offloadFallback ?? null
+	});
+	writer.close();
+	if (record.devicePlacement) facts.devicePlacement = record.devicePlacement;
+	if (json) emit(JSON.stringify({
+		...facts,
+		...links ? { links } : {},
+		...reclaimed.length ? { reclaimed } : {}
+	}));
+	else {
+		const summary = `${launchWarning ? "WARNING" : "OK"}: ${androidPackage} launched on ${host ? `${host.device?.name ?? "Android emulator"} on ${host.machine}` : serial}, ${release ? `${variant} (embedded JS, no Metro)` : `Metro port ${metroPort}`} (${cacheOutcome(record.cacheHit, remote?.name ?? providerName, offloadedTo)})`;
+		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, offloadedTo) : `bypassed; ${cacheOutcome(false, null, offloadedTo)}`;
+		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", host ? `${deviceName} on ${host.machine}` : `${deviceName} (${serial})`),
+			phaseLine("app", androidPackage),
+			phaseLine("metro", metroResult),
+			phaseLine("cache", cacheResult),
+			...ccache.status === "not-run" ? [phaseLine("compilation cache", ccacheActivityLine(ccache))] : [],
+			phaseLine("logs", logsDir || "unavailable (remote device)"),
+			...!host ? [phaseLine("agent-device", `AGENT_DEVICE_STATE_DIR=${workspaceAgentDeviceDir(root)}`)] : []
+		].join("\n"));
+		if (links) console.error(chalk.dim(workspaceLinkLine(links)));
+	}
+	return facts;
+}
+function cacheOutcome(cacheHit, providerName = null, offloadedTo = null) {
+	if (cacheHit === "remote") return `cache hit from ${providerName || "the remote cache"}`;
+	if (cacheHit === "local") return "cache hit";
+	return offloadedTo ? `built on ${offloadedTo}` : "built";
+}
+function persistLastBuild({ recordBuild = recordFinishedBuild, root, record, startedAt, durationMs, status, errorCode = null, diagnostics = null, out }) {
+	const lastBuild = lastBuildRecord({
+		...record,
+		startedAt,
+		durationMs,
+		status,
+		errorCode,
+		diagnostics
+	});
+	try {
+		recordBuild(root, lastBuild);
+	} catch (err) {
+		out(phaseLine("state", chalk.yellow(`could not record lastBuild: ${err?.message || err}`)));
+	}
+	return lastBuild;
+}
+//#endregion
+//#region src/commands/android/hosted.ts
+async function finishHostedAndroidRun({ target, artifact, root, slot = "default", release, isExpo, metroPort, logsDir, selectors, place, writePlacement, verifyLaunch: verify, writeLaunch, readApkPackage, resolveDevClientScheme, now, started, startedAt, fail, phase, out, recordBuild, ...report }) {
+	const packageName = artifact.androidPackage ?? readApkPackage(artifact.apkPath);
+	if (!artifact.apkPath || !packageName) return fail("STIM_INSTALL_FAILED", "The built APK has no package identity.");
+	const launchedAt = now();
+	try {
+		const run = await place(target, {
+			root,
+			slot,
+			bundle: artifact.apkPath,
+			handoff: artifact.handoff,
+			bundleId: packageName,
+			release,
+			metroPort,
+			selectors,
+			...!release && isExpo ? { devClientScheme: resolveDevClientScheme(root, artifact.apkPath) ?? void 0 } : {},
+			reserved: (placement) => writePlacement(root, slot, placement),
+			note: out
+		});
+		writePlacement(root, slot, run.placement);
+		writeLaunch(root, "android", {
+			appId: packageName,
+			deviceId: run.placement.session,
+			metroPort,
+			release,
+			launchedAt: new Date(launchedAt).toISOString()
+		});
+		let launched = run.launched;
+		if (!release) {
+			const evidence = await verify({
+				requireBundleResponse: true,
+				platform: "android",
+				logsDir: logsDir ?? void 0,
+				since: launchedAt,
+				metroPort,
+				mode: isExpo ? MODE_EXPO : MODE_BARE,
+				slot: launchSlotScope(root, slot),
+				platformShared: siblingPlatformSlots(root, "android", slot).length > 0
+			});
+			if (evidence.fatal) return fail("STIM_LAUNCH_FAILED", "Metro could not deliver the hosted app bundle.", "Run stim logs --errors and fix the bundle error.");
+			launched = evidence.verified ? true : evidence.requested ? "bundling" : "unverified";
+		}
+		if (launched === "unverified") out(`Launch on ${target.host.machine} is unverified; check the hosted app, then retry stim android --remote ${target.host.machine}.`);
+		const host = hostedAndroidStatus(run.placement);
+		report.record.deviceName = host.device?.name ?? null;
+		report.record.bundleId = packageName;
+		persistLastBuild({
+			recordBuild,
+			root,
+			record: report.record,
+			startedAt,
+			durationMs: now() - started,
+			status: "success",
+			out
+		});
+		await finishAndroidUpload(artifact.uploadPending, artifact.remote, phase);
+		await artifact.providerUpload;
+		return {
+			ok: true,
+			facts: reportAndroidResult({
+				...report,
+				root,
+				slot,
+				release,
+				metroPort,
+				logsDir,
+				host,
+				serial: null,
+				apkPath: artifact.apkPath,
+				androidPackage: packageName,
+				installSkipped: false,
+				waitedForBuild: artifact.waitedForBuild,
+				remote: artifact.remote,
+				providerName: artifact.providerName,
+				launchState: launched,
+				launched: {},
+				ccache: artifact.ccache,
+				durationMs: now() - started
+			})
+		};
+	} catch (error) {
+		return fail(error.code ?? "STIM_HOSTING_REFUSED", error.message, `Retry stim android --remote ${target.host.machine}, or run stim stop to reconcile the recorded placement.`);
+	} finally {
+		if (artifact.swapDir) rmSync(artifact.swapDir, {
+			recursive: true,
+			force: true
+		});
+	}
+}
+//#endregion
 //#region src/engine/apk-swap.ts
 const ANDROID_BUNDLE_NAME = "index.android.bundle";
 const LAST_LINES = 5;
@@ -419,10 +803,10 @@ function fail$1(code, message, remedy, extra = {}) {
 		extra
 	};
 }
-async function acquireAndroidArtifact({ root, buildLog, writer, settings, isExpo, device, physical, remote: remoteTarget, 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, miss, hit: lateHit, place, waitingOn } = progress;
+async function acquireAndroidArtifact({ root, buildLog, writer, settings, isExpo, device, physical, hostedAbi, remote: remoteTarget, 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, miss, hit: lateHit, place, waitingOn, waitingFor } = progress;
 	let fallbackMachine = null;
-	let hereReason = "no build machine is paired";
+	let hereReason = "no remote Mac is paired";
 	let slotWaitMs;
 	const buildMachine = record.buildMachine ?? "auto";
 	const fallBack = (reason, line = reason) => {
@@ -470,7 +854,8 @@ async function acquireAndroidArtifact({ root, buildLog, writer, settings, isExpo
 		deviceAbi,
 		compiler: cas?.id,
 		buildProfile,
-		targetAbiOnly: buildPlan.targetAbiOnly
+		targetAbiOnly: buildPlan.targetAbiOnly,
+		hostedAbi
 	});
 	let hash = "";
 	let providerUpload = null;
@@ -487,6 +872,7 @@ async function acquireAndroidArtifact({ root, buildLog, writer, settings, isExpo
 	let storeKey = "";
 	let storeSources = [];
 	let apkPath = null;
+	let handoff = null;
 	let swapFellBack = false;
 	async function resolveInitialFingerprint() {
 		if (easBuild?.ok) {
@@ -501,7 +887,7 @@ async function acquireAndroidArtifact({ root, buildLog, writer, settings, isExpo
 			stats.setCacheKey(cacheKey);
 			return true;
 		}
-		step("cache-lookup");
+		if (useBuildCache) step("cache-lookup");
 		const fingerprintTimer = stepTimer(now);
 		try {
 			const computed = await fingerprint(root, { platform: PLATFORM });
@@ -727,7 +1113,8 @@ async function acquireAndroidArtifact({ root, buildLog, writer, settings, isExpo
 				max: maxBuilds,
 				root,
 				logFile: buildLog,
-				out
+				out,
+				waitingFor: (info) => waitingFor?.(info, "build-slot")
 			});
 			slotWaitMs = buildSlot.slotWaitMs;
 		} catch (err) {
@@ -870,6 +1257,7 @@ async function acquireAndroidArtifact({ root, buildLog, writer, settings, isExpo
 		}
 		const { timings } = outcome;
 		apkPath = stored;
+		handoff = outcome.handoff ?? null;
 		record.builtOn = outcome.machine;
 		record.offloadedTo = outcome.machine;
 		stats.setPlacement({
@@ -977,13 +1365,15 @@ async function acquireAndroidArtifact({ root, buildLog, writer, settings, isExpo
 				if (offload) stats.setPlacement({
 					decision: "fell-back",
 					slotWaitMs,
+					deviceSlotWaitMs: stats.deviceSlotWaitMs(),
 					reason: record.offloadFallback ?? "offload failed",
 					...fallbackMachine ? { machine: fallbackMachine } : {}
 				});
 				else stats.setPlacement({
 					decision: "here",
 					reason: hereReason,
-					slotWaitMs
+					slotWaitMs,
+					deviceSlotWaitMs: stats.deviceSlotWaitMs()
 				});
 				record.builtOn = "here";
 				phase("build", `compiling ${variant || "debug"} with Gradle`);
@@ -1083,223 +1473,53 @@ async function acquireAndroidArtifact({ root, buildLog, writer, settings, isExpo
 						}
 					}
 					if (remote) uploadPending = uploadRemoteBuild({
-						logWriter: writer,
-						provider: remote.provider,
-						platform: PLATFORM,
-						projectRoot: root,
-						fingerprintHash: storeHash,
-						buildPath: apkPath,
-						runOptions: remoteRunOptions
-					});
-				}
-			}
-		} catch (error) {
-			if (!(error instanceof OffloadRefusal)) throw error;
-			const refusal = error;
-			phaseFailure = fail$1(refusal.code, refusal.message, refusal.remedy, { lastBuildStatus: true });
-			return false;
-		} finally {
-			if (openOffload.choice) closeOffload(openOffload.choice);
-			releaseHeldLock();
-			releaseHeldSlot();
-		}
-		return true;
-	}
-	if (!easBuild) {
-		await prepareCachedArtifact();
-		if (apkPath) lateHit();
-		else if (swapFellBack) miss(reasonForMiss([]).reason);
-		if (!await buildArtifact()) return refused();
-	}
-	return {
-		ok: true,
-		artifact: {
-			apkPath,
-			androidPackage,
-			swapDir,
-			waitedForBuild,
-			ccache: ccacheActivity,
-			uploadPending,
-			providerUpload,
-			providerName,
-			remote,
-			abandonedRemote
-		}
-	};
-}
-function tail(lines, n = FALLBACK_LINES) {
-	return (Array.isArray(lines) ? lines : []).slice(-n);
-}
-//#endregion
-//#region src/commands/android/result.ts
-function androidFacts({ root, slot, serial, avdName = null, deviceName = null, systemImage = null, deviceProfile = 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, buildMachine = "auto", builtOn, offloadedTo = null, offloadFallback = null }) {
-	return {
-		platform: PLATFORM,
-		...slot && slot !== "default" ? { slot } : {},
-		serial: serial ?? null,
-		avdName: avdName ?? null,
-		deviceName: deviceName ?? avdName ?? null,
-		systemImage: systemImage ?? null,
-		deviceProfile: deviceProfile ?? null,
-		fingerprint: fingerprint ?? null,
-		cacheKey: cacheKey ?? null,
-		variant: variant ?? null,
-		metroPort: metroPort ?? null,
-		cacheHit: cacheLevel(cacheHit),
-		cacheSkipped: Boolean(cacheSkipped),
-		buildMachine,
-		...builtOn ? { builtOn } : {},
-		...offloadedTo ? { offloadedTo } : {},
-		...offloadFallback ? { offloadFallback } : {},
-		waitedForBuild: waitedForBuild ? {
-			pid: waitedForBuild.pid ?? null,
-			ms: waitedForBuild.ms ?? 0
-		} : null,
-		appPath: appPath ?? null,
-		bundleId: bundleId ?? null,
-		installSkipped: Boolean(installSkipped),
-		launched: launched === "unverified" || launched === "bundling" ? launched : Boolean(launched),
-		ccache,
-		debugHttpHost: debugHttpHost ?? null,
-		debugHttpHostNote: debugHttpHostNote ?? null,
-		devClientUrl: devClientUrl ?? null,
-		logs: logs ?? null,
-		...root ? { agentDevice: { stateDir: workspaceAgentDeviceDir(root) } } : {},
-		durationMs: typeof durationMs === "number" && Number.isFinite(durationMs) ? durationMs : null,
-		...lease === void 0 ? {} : { lease },
-		...devServer ? { devServer } : {}
-	};
-}
-function lastBuildRecord({ fingerprint, cacheKey, cacheHit, cacheSkipped = false, durationMs, appPath, bundleId, startedAt, status, errorCode = null, avdName = null, deviceName = null, missReason = null, diagnostics = null, configuration = null, buildMachine = "auto", builtOn, offloadedTo = null, offloadFallback = null }) {
-	const record = {
-		platform: PLATFORM,
-		avdName: avdName ?? null,
-		deviceName: deviceName ?? avdName ?? null,
-		fingerprint: fingerprint ?? null,
-		cacheKey: cacheKey ?? null,
-		cacheHit: cacheLevel(cacheHit),
-		cacheSkipped: Boolean(cacheSkipped),
-		durationMs: Number.isFinite(durationMs) ? durationMs : null,
-		appPath: appPath ?? null,
-		bundleId: bundleId ?? null,
-		startedAt,
-		status,
-		configuration: configuration ?? null
-	};
-	if (errorCode) record.errorCode = errorCode;
-	record.buildMachine = buildMachine;
-	if (builtOn) record.builtOn = builtOn;
-	if (offloadedTo) record.offloadedTo = offloadedTo;
-	if (offloadFallback) record.offloadFallback = offloadFallback;
-	if (missReason && !cacheLevel(cacheHit)) record.missReason = missReason;
-	const recorded = status === "failed" ? buildDiagnostics(diagnostics) : [];
-	if (recorded.length) record.diagnostics = recorded;
-	return record;
-}
-async function finishAndroidUpload(uploadPending, remote, phase) {
-	if (!uploadPending) return false;
-	const upload = await uploadPending;
-	if (upload?.uploaded) phase("cache", `uploaded (${remote?.name})`);
-	else if (upload?.timedOut) {
-		phase("cache", chalk.yellow(`${remote?.name} upload still running after ${formatDuration(UPLOAD_TIMEOUT_MS)}; not waiting`));
+						logWriter: writer,
+						provider: remote.provider,
+						platform: PLATFORM,
+						projectRoot: root,
+						fingerprintHash: storeHash,
+						buildPath: apkPath,
+						runOptions: remoteRunOptions
+					});
+				}
+			}
+		} catch (error) {
+			if (!(error instanceof OffloadRefusal)) throw error;
+			const refusal = error;
+			phaseFailure = fail$1(refusal.code, refusal.message, refusal.remedy, { lastBuildStatus: true });
+			return false;
+		} finally {
+			if (openOffload.choice) closeOffload(openOffload.choice);
+			releaseHeldLock();
+			releaseHeldSlot();
+		}
 		return true;
-	} else if (upload?.failed) {
-		const authNote = remote?.name === "eas" && isEasAuthFailureText(upload.failed) ? easAuthNote({
-			code: "logged-out",
-			reason: upload.failed,
-			phase: "upload"
-		}) : null;
-		phase("cache", chalk.yellow(authNote || `${remote?.name} upload failed: ${upload.failed}`));
 	}
-	return false;
-}
-function reportAndroidResult({ root, 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, links }) {
-	const offloadedTo = record.offloadedTo ?? null;
-	recordRun({
-		failed: false,
-		cacheHit: cacheLevel(record.cacheHit),
-		waited: waitedForBuild,
-		durationMs,
-		offloadedTo
-	});
-	const facts = androidFacts({
-		root,
-		slot,
-		serial,
-		avdName: record.avdName,
-		deviceName: record.deviceName,
-		systemImage: record.systemImage,
-		deviceProfile: record.deviceProfile,
-		debugHttpHost: launched.debugHttpHost ?? null,
-		debugHttpHostNote: launched.debugHttpHostNote ?? null,
-		devClientUrl: launched.devClientUrl ?? null,
-		fingerprint: record.fingerprint,
-		cacheKey: record.cacheKey,
-		variant,
-		metroPort,
-		cacheHit: record.cacheHit,
-		cacheSkipped: !useBuildCache,
-		waitedForBuild,
-		appPath: apkPath,
-		bundleId: androidPackage,
-		installSkipped,
-		launched: launchState,
-		ccache,
-		logs: logsDir,
-		durationMs,
-		lease,
-		devServer,
-		buildMachine: record.buildMachine,
-		builtOn: record.builtOn ?? void 0,
-		offloadedTo,
-		offloadFallback: record.offloadFallback ?? null
-	});
-	writer.close();
-	if (json) emit(JSON.stringify({
-		...facts,
-		...links ? { links } : {},
-		...reclaimed.length ? { reclaimed } : {}
-	}));
-	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, offloadedTo)})`;
-		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, offloadedTo) : `bypassed; ${cacheOutcome(false, null, offloadedTo)}`;
-		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})`),
-			phaseLine("app", androidPackage),
-			phaseLine("metro", metroResult),
-			phaseLine("cache", cacheResult),
-			...ccache.status === "not-run" ? [phaseLine("compilation cache", ccacheActivityLine(ccache))] : [],
-			phaseLine("logs", logsDir || "unavailable (remote device)"),
-			phaseLine("agent-device", `AGENT_DEVICE_STATE_DIR=${workspaceAgentDeviceDir(root)}`)
-		].join("\n"));
-		if (links) console.error(chalk.dim(workspaceLinkLine(links)));
+	if (!easBuild) {
+		await prepareCachedArtifact();
+		if (apkPath) lateHit();
+		else if (swapFellBack) miss(reasonForMiss([]).reason);
+		if (!await buildArtifact()) return refused();
 	}
-	return facts;
-}
-function cacheOutcome(cacheHit, providerName = null, offloadedTo = null) {
-	if (cacheHit === "remote") return `cache hit from ${providerName || "the remote cache"}`;
-	if (cacheHit === "local") return "cache hit";
-	return offloadedTo ? `built on ${offloadedTo}` : "built";
+	return {
+		ok: true,
+		artifact: {
+			apkPath,
+			handoff,
+			androidPackage,
+			swapDir,
+			waitedForBuild,
+			ccache: ccacheActivity,
+			uploadPending,
+			providerUpload,
+			providerName,
+			remote,
+			abandonedRemote
+		}
+	};
 }
-function persistLastBuild({ recordBuild = recordFinishedBuild, root, record, startedAt, durationMs, status, errorCode = null, diagnostics = null, out }) {
-	const lastBuild = lastBuildRecord({
-		...record,
-		startedAt,
-		durationMs,
-		status,
-		errorCode,
-		diagnostics
-	});
-	try {
-		recordBuild(root, lastBuild);
-	} catch (err) {
-		out(phaseLine("state", chalk.yellow(`could not record lastBuild: ${err?.message || err}`)));
-	}
-	return lastBuild;
+function tail(lines, n = FALLBACK_LINES) {
+	return (Array.isArray(lines) ? lines : []).slice(-n);
 }
 //#endregion
 //#region src/commands/android/collector.ts
@@ -1618,7 +1838,7 @@ async function finishAndroidRun({ lease, releaseLease, root, slot, json, metroCh
 	});
 	if (booted.failed) {
 		const diag = diagnoseBootFailure(booted, emuLog, runCommand, physical);
-		return fail(NO_DEVICE, diag.message, diag.remedy, {
+		return fail(diag.code, diag.message, diag.remedy, {
 			lines: diag.lines,
 			logPath: diag.logPath ? displayPath(root, diag.logPath) : null
 		});
@@ -1951,12 +2171,23 @@ function reportMetroRoute({ launched, remote, metroPort, androidPackage, serial,
 	});
 }
 function diagnoseBootFailure(booted, logFile, runCommand, physical) {
-	return noDeviceDiagnostic({
+	if (booted.code) return {
+		code: booted.code,
+		message: booted.reason ?? "The emulator did not boot.",
+		remedy: booted.remedy ?? null,
+		lines: [],
+		logPath: null
+	};
+	const diag = noDeviceDiagnostic({
 		reason: booted.reason ?? "The emulator did not boot.",
 		logFile,
 		remedy: booted.remedy ?? `Run \`stim status\` to see what Stim thinks it owns; re-running \`${runCommand}\` creates a fresh owned AVD.`,
 		localEmulator: !physical
 	});
+	return {
+		code: NO_DEVICE,
+		...diag
+	};
 }
 //#endregion
 //#region src/commands/android/plan.ts
@@ -2045,13 +2276,78 @@ function resolveAndroidRunPlan({ settings, settingsContext, slot, easProfile, va
 	if (physical && deviceFlag === "") return fail("STIM_BAD_ARG", "--device was given an empty serial.", "Pass `--device` on its own to take the first connected device this workspace can lease, or `--device <serial>` to name one.");
 	if (physical && commandRemoteBackend) return fail("STIM_BAD_ARG", "--device installs on a device connected to this machine, and --remote installs on a remote one.", "Pass only one of --device and --remote.");
 	const noWait = waitFlag === false;
-	const waitFlagged = waitFlag !== void 0;
-	if (waitConflict) return fail("STIM_BAD_ARG", "--wait and --no-wait ask for opposite things.", "Pass `--wait <seconds>` to wait for the lease, or `--no-wait` to install without one.");
-	if (waitFlagged && !physical) return fail("STIM_BAD_ARG", "--wait and --no-wait only apply to a `--device` run.", "This workspace owns its emulator, so nothing contends for it. Drop the flag, or pass `--device`.");
+	if (waitConflict) return fail("STIM_BAD_ARG", "--wait and --no-wait ask for opposite things.", "Pass only one of `--wait <seconds>` and `--no-wait`.");
 	const waitParsed = parseDeviceWait(noWait ? void 0 : waitFlag);
-	if ("error" in waitParsed) return fail("STIM_BAD_ARG", waitParsed.error, "Pass a whole number of seconds, e.g. --wait 90. `--wait 0` refuses a leased device at once.");
+	if ("error" in waitParsed) return fail("STIM_BAD_ARG", waitParsed.error, "Pass a whole number of seconds, e.g. --wait 90. `--wait 0` refuses a busy lease or device slot at once.");
 	const waitSeconds = waitParsed.seconds;
-	const remoteBackend = physical ? null : commandRemoteBackend ?? remoteAndroidSetting(settings);
+	const remoteTarget = commandRemoteBackend !== null ? parseIosRemote(commandRemoteBackend) : remoteAndroidSetting(settings);
+	if (physical && remoteTarget?.kind === "machine") return fail("STIM_BAD_ARG", "--device installs on a phone connected to this machine, and --remote installs on a remote one.", "Pass only one of --device and --remote; unset android.remote for a local phone.");
+	const machine = remoteTarget?.kind === "machine" ? remoteTarget.machine : null;
+	const remoteBackend = !physical && remoteTarget?.kind === "backend" ? remoteTarget.backend : null;
+	if (!machine) {
+		const refusal = androidDeviceSelectorRefusal({
+			settingsContext,
+			slot,
+			systemImageFlag,
+			deviceProfileFlag,
+			systemImage,
+			deviceProfile,
+			physical,
+			remoteBackend
+		}, {
+			listSystemImages,
+			listDeviceProfiles,
+			supportsFold,
+			ownedAvd
+		});
+		if (refusal) return refusal;
+	}
+	const target = physical ? {
+		kind: "physical",
+		serial: typeof deviceFlag === "string" ? deviceFlag : null,
+		lease: {
+			waitSeconds,
+			noWait
+		}
+	} : machine ? {
+		kind: "hosted",
+		machine,
+		systemImage,
+		deviceProfile
+	} : remoteBackend ? {
+		kind: "remote",
+		backend: remoteBackend,
+		systemImage,
+		deviceProfile
+	} : {
+		kind: "emulator",
+		systemImage,
+		deviceProfile
+	};
+	return {
+		ok: true,
+		plan: {
+			build: {
+				variant,
+				release,
+				profile: buildProfile,
+				cas,
+				cache: cachePolicy,
+				compilerCache: optimizations.android.compilerCache,
+				gradleBuildCache: optimizations.android.gradleBuildCache,
+				pch: optimizations.android.pch,
+				targetAbiOnly: optimizations.android.targetAbiOnly
+			},
+			target,
+			deviceSlotWaitMs: noWait ? 0 : waitFlag === void 0 && !physical ? DEFAULT_DEVICE_SLOT_WAIT_MS : waitSeconds * 1e3,
+			isExpo,
+			metroWarmup: optimizations.metroWarmup,
+			cacheProviderConfig
+		}
+	};
+}
+function androidDeviceSelectorRefusal({ settingsContext, slot, systemImageFlag, deviceProfileFlag, systemImage, deviceProfile, physical, remoteBackend }, { listSystemImages = listInstalledSystemImages, listDeviceProfiles = listAvdDeviceProfiles, supportsFold = systemImageSupportsFold, ownedAvd = slotOwnedAvd } = {}) {
+	const root = settingsContext.projectPath;
 	const settingsLayersForOrigin = settingsLayers(settingsContext);
 	const imageRefusal = systemImageRefusal({
 		slot,
@@ -2093,43 +2389,7 @@ function resolveAndroidRunPlan({ settings, settingsContext, slot, easProfile, va
 		});
 		if (foldRefusal) return fail(foldRefusal.code, foldRefusal.message, foldRefusal.remedy);
 	}
-	const target = physical ? {
-		kind: "physical",
-		serial: typeof deviceFlag === "string" ? deviceFlag : null,
-		lease: {
-			waitSeconds,
-			noWait
-		}
-	} : remoteBackend ? {
-		kind: "remote",
-		backend: remoteBackend,
-		systemImage,
-		deviceProfile
-	} : {
-		kind: "emulator",
-		systemImage,
-		deviceProfile
-	};
-	return {
-		ok: true,
-		plan: {
-			build: {
-				variant,
-				release,
-				profile: buildProfile,
-				cas,
-				cache: cachePolicy,
-				compilerCache: optimizations.android.compilerCache,
-				gradleBuildCache: optimizations.android.gradleBuildCache,
-				pch: optimizations.android.pch,
-				targetAbiOnly: optimizations.android.targetAbiOnly
-			},
-			target,
-			isExpo,
-			metroWarmup: optimizations.metroWarmup,
-			cacheProviderConfig
-		}
-	};
+	return null;
 }
 //#endregion
 //#region src/commands/android/next-build.ts
@@ -2268,7 +2528,7 @@ async function planAndroid(opts, overrides = {}) {
 		if (target.kind === "physical") return refuse(planFlagRefusal("--device"));
 		return refuse({
 			code: "STIM_BAD_ARG",
-			message: `android.remote routes this workspace's runs to a ${target.backend} device, whose ABI --plan cannot read without a session.`,
+			message: `android.remote routes this workspace's runs to a ${target.kind === "hosted" ? target.machine : target.backend} device, whose ABI --plan cannot read without a session.`,
 			remedy: "Run `stim android` to build for the remote device, or unset android.remote to plan the owned emulator."
 		});
 	}
@@ -2324,11 +2584,10 @@ 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. 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("--build-machine <value>", "Build on auto, local, or one named machine; a name refuses without fallback", parseBuildMachineOption).option("--json", "Emit the facts as a single JSON line on stdout; every other line goes to stderr").option("--plan", "Predict the next build without building, booting or installing: resolve the fingerprint, check the local then remote cache, and print the expected cache result and duration. Writes no Stim state.").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-profile <id>", "Hardware profile to create this workspace's owned AVD with, as an `avdmanager list device -c` id (e.g. \"pixel_fold\", \"pixel_tablet\"). Overrides the android.deviceProfile setting for this invocation. An unknown id refuses with STIM_BAD_ARG and prints the available ids.").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;
-		if (!parseMachine(value)) throw new InvalidArgumentError(`expected one of: ${REMOTE_DEVICE_BACKENDS.join(", ")}`);
-		throw new InvalidArgumentError("STIM_BAD_ARG: Android on a paired Mac is not available yet. Use eas or proxy, or run Android locally.");
-	}).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) => {
+	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("--remote-build <value>", "Build on auto, local, or one named machine; a name refuses without fallback", parseBuildMachineOption).option("--json", "Emit the facts as a single JSON line on stdout; every other line goes to stderr").option("--plan", "Predict the next build without building, booting or installing: resolve the fingerprint, check the local then remote cache, and print the expected cache result and duration. Writes no Stim state.").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-profile <id>", "Hardware profile to create this workspace's owned AVD with, as an `avdmanager list device -c` id (e.g. \"pixel_fold\", \"pixel_tablet\"). Overrides the android.deviceProfile setting for this invocation. An unknown id refuses with STIM_BAD_ARG and prints the available ids.").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 <target>", "Run on eas, proxy, or a named approved Mac from remote.machines; auto places on an approved Mac when this Mac is full or busy", (value) => {
+		if (!parseMachine(value)) throw new InvalidArgumentError("expected eas, proxy, auto, or a tailnet machine name");
+		return value;
+	}).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). Without --device, wait for an owned-device slot (default 600 seconds; --no-wait refuses immediately).").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. Without --device, refuse a full device cap or existing slot queue immediately.").action(async (opts) => {
 		if (opts.plan) return planAndroid(opts);
 		const root = findProjectRoot$1(process.cwd());
 		if (!root) {
@@ -2351,7 +2610,7 @@ function registerAndroid(program) {
 			try {
 				return await runAndroid({
 					root,
-					buildMachine: opts.buildMachine,
+					buildMachine: opts.remoteBuild,
 					slot: opts.slot,
 					easProfile: opts.easProfile,
 					json: Boolean(opts.json),
@@ -2372,7 +2631,7 @@ function registerAndroid(program) {
 		}, { write: (line) => console.error(chalk.dim(phaseLine("lock", line))) })).ok) process.exit(runCancellation() ? 130 : 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, deviceProfile: deviceProfileFlag, 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, listDeviceProfiles, ensureDeviceBooted = ensureBooted, resolveAvdSerial = resolveOwnedAvdSerial, waitForDeviceBoot = waitForBoot, dataFreeBytes, trimCaches, wipeDevice, resolveMetro = resolveProjectMetro, warmMetro: prewarmMetro = warmMetro, startServer = startDevServer, readState = readWorkspaceState$1, 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, recordBuild, 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, deviceProfile: deviceProfileFlag, 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, listDeviceProfiles, ensureDeviceBooted = ensureBooted, resolveAvdSerial = resolveOwnedAvdSerial, waitForDeviceBoot = waitForBoot, dataFreeBytes, trimCaches, wipeDevice, resolveMetro = resolveProjectMetro, warmMetro: prewarmMetro = warmMetro, startServer = startDevServer, readState = readWorkspaceState$1, 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, recordBuild, recordStats = recordRunStats, recordCapacityRefusal: recordRefusal, readEstimates = readRunEstimates, now = Date.now, out = (line) => console.error(line), emit = (line) => console.log(line) } = {}) {
 	return {
 		root,
 		json,
@@ -2456,6 +2715,7 @@ function resolveRunAndroidOptions({ root, json = false, remoteDevice: commandRem
 		writeState,
 		recordBuild,
 		recordStats,
+		recordCapacityRefusal: recordRefusal,
 		readEstimates,
 		now,
 		out,
@@ -2498,6 +2758,11 @@ function androidSlotOptions(options) {
 function avdSetupFailure(error, root, logFile) {
 	const refusal = (0, ownership_claim_exports.claimFailure)(error, "stim android");
 	if (refusal) return refusal;
+	if (error instanceof DeviceAdmissionRefusal) return {
+		code: error.code,
+		message: error.message,
+		remedy: error.remedy
+	};
 	const diag = noDeviceDiagnostic({
 		reason: `Could not ensure an owned Android emulator: ${error?.message || error}`,
 		logFile,
@@ -2515,7 +2780,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, deviceProfileFlag, deviceFlag, waitFlag, waitConflict, acquireLease, makeRunLease, selectPool, onLeaseSignal, listDevices, deviceModel, deviceAbi, isEmulatorDevice, readApkPackage, getLimits, checkCapacity, acquireSlot, releaseSlot, ensureDevice, listSystemImages, listDeviceProfiles, ensureDeviceBooted, resolveAvdSerial, waitForDeviceBoot, dataFreeBytes, trimCaches, wipeDevice, 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, recordBuild, 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, deviceProfileFlag, deviceFlag, waitFlag, waitConflict, acquireLease, makeRunLease, selectPool, onLeaseSignal, listDevices, deviceModel, deviceAbi, isEmulatorDevice, readApkPackage, getLimits, checkCapacity, acquireSlot, releaseSlot, ensureDevice, listSystemImages, listDeviceProfiles, ensureDeviceBooted, resolveAvdSerial, waitForDeviceBoot, dataFreeBytes, trimCaches, wipeDevice, 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, recordBuild, recordStats, recordCapacityRefusal: recordRefusal = recordCapacityRefusal, readEstimates, now, out, emit } = androidSlotOptions(options);
 	const progress = options.progress ?? NO_BUILD_PROGRESS;
 	const slot = validateDeviceSlot(options.slot);
 	const started = now();
@@ -2621,6 +2886,7 @@ async function runAndroid(options = {}) {
 			code,
 			message,
 			remedy: remedy ?? null,
+			...record.devicePlacement ? { devicePlacement: record.devicePlacement } : {},
 			...ccacheActivity.status === "not-run" ? {} : { ccache: ccacheActivity },
 			...lease === void 0 ? {} : { lease },
 			...reclaimed.length ? { reclaimed } : {}
@@ -2682,16 +2948,59 @@ async function runAndroid(options = {}) {
 	});
 	if (!planned.ok) return fail(planned.code, planned.message, planned.remedy, { lines: planned.lines });
 	const { plan } = planned;
-	const { build: buildPlan, target, isExpo, cacheProviderConfig } = plan;
+	const deviceSlotWait = {
+		signal: runCancellationSignal(),
+		waitMs: plan.deviceSlotWaitMs,
+		displayName: basename(root),
+		waitingFor: (info) => progress.waitingFor(info, "device-slot"),
+		onWait: (ms) => {
+			stats.addDeviceSlotWaitMs(ms);
+			if (record.devicePlacement?.decision === "local" && ms > 0) record.devicePlacement.decision = "waited-locally";
+		}
+	};
+	const { build: buildPlan, isExpo, cacheProviderConfig } = plan;
 	const { variant, release, cache: cachePolicy } = buildPlan;
 	record.configuration = variant ?? "debug";
 	const useBuildCache = cachePolicy.read;
-	const physical = target.kind === "physical";
-	const remoteBackend = target.kind === "remote" ? target.backend : null;
-	const budget = await (options.checkBudget ?? budgetGate)({
+	const hosting = await selectAndroidPlacement({
 		root,
-		note: out
+		slot,
+		target: plan.target,
+		release,
+		metroCheck,
+		noWait: plan.deviceSlotWaitMs === 0,
+		buildMachine: options.buildMachine,
+		read: options.readHostedAndroid,
+		resolveSerial: resolveAvdSerial,
+		prepare: options.prepareHostedAndroid,
+		automatic: options.automaticDevicePlacement,
+		localSelectors: (target) => androidDeviceSelectorRefusal({
+			settingsContext,
+			slot,
+			systemImageFlag,
+			deviceProfileFlag,
+			systemImage: target.systemImage,
+			deviceProfile: target.deviceProfile,
+			physical: false,
+			remoteBackend: null
+		}, {
+			listSystemImages,
+			listDeviceProfiles
+		}),
+		checkBudget: options.checkBudget,
+		note: out,
+		phase
 	});
+	if ("failure" in hosting) return fail(hosting.failure.code, hosting.failure.message, hosting.failure.remedy);
+	const { target, hostedTarget, budget, selectors } = hosting;
+	record.devicePlacement = hosting.devicePlacement;
+	writeDevicePlacement(root, slot, PLATFORM, record.devicePlacement);
+	const physical = target.kind === "physical";
+	const remoteBackend = target.kind === "remote" ? target.backend : null;
+	if (hostedTarget) {
+		if (settings.androidEmulatorApp !== void 0) phase("device", "androidEmulatorApp is ignored on a hosting Mac; the emulator boots headless.");
+		if (publicUrlSetting(settings) || tunnelModeSetting(settings)) phase("metro", "metro.publicUrl and metro.tunnel are ignored on a hosting Mac; Metro uses the private tailnet bridge.");
+	}
 	reclaimed = budget.reclaimed;
 	if (budget.refusal) return fail(budget.refusal.code, budget.refusal.message, budget.refusal.remedy);
 	const remoteContext = remoteBackend ? await resolveRemoteDeviceContext({
@@ -2734,7 +3043,7 @@ async function runAndroid(options = {}) {
 			const gate = await ensureDevServer({
 				root,
 				port: reservedPort,
-				settings,
+				settings: hostedMetroSettings(settings, Boolean(hostedTarget)),
 				remote: remoteContext !== null,
 				note: out,
 				resolve: resolveMetro,
@@ -2788,7 +3097,14 @@ async function runAndroid(options = {}) {
 	let bootDuration = "";
 	let bootPromise;
 	let startRemoteBoot = null;
-	if (target.kind === "physical" && !target.serial) {
+	if (hostedTarget) {
+		device = {
+			owned: false,
+			systemImage: hostedTarget.choice.systemImage,
+			deviceProfile: hostedTarget.choice.deviceProfile
+		};
+		bootPromise = Promise.resolve({ ok: true });
+	} else if (target.kind === "physical" && !target.serial) {
 		const pooled = await pooledAndroidDevice({
 			root,
 			selectPool,
@@ -2824,12 +3140,19 @@ async function runAndroid(options = {}) {
 		} catch (err) {
 			return fail("STIM_BAD_ARG", err.message, "Run `stim settings set androidEmulatorApp emulator` or `stim settings set androidEmulatorApp stim-desktop`.");
 		}
-		const capacity = checkCapacity({
+		const capacity = plan.deviceSlotWaitMs === 0 ? checkCapacity({
 			platform: PLATFORM,
 			project,
 			max: limits.maxDevices
-		});
-		if (capacity) return fail(capacity.code, capacity.message, capacity.remedy);
+		}) : null;
+		if (capacity) {
+			if (capacity.code === "STIM_AT_CAPACITY") recordRefusal({
+				platform: PLATFORM,
+				max: limits.maxDevices,
+				workspace: workspaceId(root)
+			}, now());
+			return fail(capacity.code, capacity.message, capacity.remedy);
+		}
 		const prepare = stepClock(now);
 		try {
 			device = await ensureDevice({
@@ -2839,6 +3162,7 @@ async function runAndroid(options = {}) {
 				settingsRoot,
 				settings,
 				flags: {
+					deviceSlotWait,
 					systemImage: target.systemImage,
 					systemImageFlag: systemImageFlag?.trim() || null,
 					deviceProfile: target.deviceProfile
@@ -2858,6 +3182,7 @@ async function runAndroid(options = {}) {
 			platform: PLATFORM,
 			device,
 			projectPath: root,
+			deviceSlotWait,
 			out,
 			logFile: emuLog
 		})).catch((e) => ({
@@ -2907,6 +3232,7 @@ async function runAndroid(options = {}) {
 			isExpo,
 			device,
 			physical,
+			hostedAbi: hostedTarget?.choice.architecture,
 			remote: Boolean(remoteDevice),
 			buildPlan,
 			cacheProviderConfig,
@@ -2924,7 +3250,8 @@ async function runAndroid(options = {}) {
 				miss: progress.miss,
 				hit: progress.hit,
 				place: progress.place,
-				waitingOn: progress.waitingOn
+				waitingOn: progress.waitingOn,
+				waitingFor: progress.waitingFor
 			}
 		}, {
 			deviceAbi,
@@ -2963,6 +3290,40 @@ async function runAndroid(options = {}) {
 		androidPackage = artifact.androidPackage;
 		record.appPath = apkPath;
 		if (runCancellation()) return fail("STIM_CANCELLED", "before install");
+		if (hostedTarget) return finishHostedAndroidRun({
+			target: hostedTarget,
+			artifact,
+			root,
+			slot,
+			release,
+			isExpo,
+			metroPort,
+			logsDir,
+			selectors,
+			place: options.placeHostedAndroid ?? placeHostedAndroid,
+			writePlacement: options.writeHostedAndroid ?? writeHostedAndroid,
+			verifyLaunch: verifyLaunched,
+			writeLaunch,
+			readApkPackage,
+			resolveDevClientScheme,
+			now,
+			started,
+			startedAt,
+			record,
+			fail,
+			phase,
+			out,
+			json,
+			useBuildCache,
+			variant,
+			metroCheck,
+			writer,
+			emit,
+			recordRun,
+			reclaimed,
+			devServer,
+			recordBuild
+		});
 		if (startRemoteBoot) {
 			progress.step("device");
 			bootPromise = startRemoteBoot();
@@ -3091,6 +3452,7 @@ async function runAndroid(options = {}) {
 						serial: void 0
 					},
 					projectPath: root,
+					deviceSlotWait,
 					out,
 					logFile: emuLog
 				})).catch((e) => ({