stim 1.2.0 → 1.3.1

package/dist/{remote-cache-DDmJ1Roq.mjs → teardown--gESs9ck.mjs}

@@ -1,12 +1,13 @@
 import { t as getExecutor } from "./exec-CyylIdq9.mjs";
-import { C as withConfigLock, g as loadConfig, s as ensureConfig, y as saveConfig } from "./config-CMtIaTk9.mjs";
-import { r as createNdjsonWriter } from "./ndjson-DcAtEx_K.mjs";
-import { D as workspaceLogsDir } from "./state-CZ-ER-8d.mjs";
-import { l as resolvePackageJson } from "./project-BBTVABUz.mjs";
+import { B as removeSlotDevice, C as withConfigLock, F as assignSlotDevice, L as deviceSlotPlatforms, g as loadConfig, s as ensureConfig, y as saveConfig, z as projectDeviceSlots } from "./config-CcefMY2Q.mjs";
+import { r as createNdjsonWriter } from "./ndjson-BZwI1NBv.mjs";
+import { D as workspaceLogsDir } from "./state-B3XA2wp2.mjs";
+import { l as resolvePackageJson } from "./project-fKmuIaMI.mjs";
 import { n as stripAnsi } from "./process-output-C7IlIzd7.mjs";
-import { C as shutdownIosSim, _ as renameIosSim, a as deleteIosSim, d as listIosDeviceTypes, g as parseRuntimeVersion, h as parkedSimName, o as deleteParkedIosSim, r as clearAppDataContainer, s as findAppDataContainer, x as resolveOwnedIosSim } from "./ios-D1h1Di39.mjs";
-import { E as ownedAvdMatchesConfiguration, F as shutdownAndroidEmulator, I as waitForAndroidEmulatorShutdown, N as resolveOwnedAvdSerial, O as ownedAvdSystemImage, S as listOrphanedAvdDirectories, T as ownedAvdDirectory, l as avdStorageRoots, o as assertOwnedAvdStopped, p as deleteAvd, s as avdPathExists } from "./android-K63_0UfF.mjs";
-import { n as expoBinFromPackage, r as expoBinPath, s as findBinUpward } from "./server-expo-C3ktAwUG.mjs";
+import { l as phaseLine } from "./command-output-8wHMEde0.mjs";
+import { E as ownedAvdMatchesConfiguration, F as shutdownAndroidEmulator, I as waitForAndroidEmulatorShutdown, N as resolveOwnedAvdSerial, O as ownedAvdSystemImage, S as listOrphanedAvdDirectories, T as ownedAvdDirectory, l as avdStorageRoots, o as assertOwnedAvdStopped, p as deleteAvd, s as avdPathExists } from "./android-hMj83VpN.mjs";
+import { n as expoBinFromPackage, r as expoBinPath, s as findBinUpward } from "./server-expo-DizT4OMk.mjs";
+import { C as shutdownIosSim, _ as renameIosSim, a as deleteIosSim, d as listIosDeviceTypes, g as parseRuntimeVersion, h as parkedSimName, o as deleteParkedIosSim, r as clearAppDataContainer, s as findAppDataContainer, x as resolveOwnedIosSim } from "./ios-Deh5js5V.mjs";
 import { createRequire } from "node:module";
 import { existsSync, lstatSync, readFileSync, renameSync, rmSync } from "node:fs";
 import { randomUUID } from "node:crypto";
@@ -14,981 +15,1078 @@ import { dirname, join } from "node:path";
 import { pathToFileURL } from "node:url";
 import { format } from "node:util";
 import { AsyncLocalStorage } from "node:async_hooks";
-const POOL_SETTING_REMEDY = "Run `stim guide settings` for the device pool bounds and where it can be set.";
-const MAX_SETTING = {
-	ios: {
-		key: "iosParkedMax",
-		env: "STIM_POOL_IOS_PARKED_MAX"
-	},
-	android: {
-		key: "androidParkedMax",
-		env: "STIM_POOL_ANDROID_PARKED_MAX"
-	}
-};
-function parseMax(raw, strings) {
-	const value = strings && typeof raw === "string" ? /^\d+$/.test(raw.trim()) ? Number(raw.trim()) : NaN : raw;
-	if (typeof value !== "number" || !Number.isSafeInteger(value) || value < 0) return null;
-	return value;
+//#region src/engine/remote-cache.ts
+const EAS_PROVIDER_PACKAGE = "eas-build-cache-provider";
+const RESOLVE_TIMEOUT_MS = 3e4;
+const UPLOAD_TIMEOUT_MS = 6e4;
+const CONFIG_TIMEOUT_MS = 3e4;
+const DYNAMIC_CONFIG_FILES = [
+	"app.config.ts",
+	"app.config.js",
+	"app.config.mjs",
+	"app.config.cjs"
+];
+const TIMED_OUT = Symbol("timed-out");
+function dynamicConfigFile(root) {
+	for (const name of DYNAMIC_CONFIG_FILES) if (existsSync(join(root, name))) return name;
+	return null;
 }
-function parkedMaxSetting(platform, { config, env = process.env } = {}) {
-	const { key, env: envKey } = MAX_SETTING[platform];
-	const fromEnv = env[envKey];
-	const explicit = fromEnv !== void 0 && fromEnv !== "";
-	const pool = (config === void 0 ? loadConfig() : config)?.pool;
-	if (!explicit && pool !== void 0 && (pool === null || typeof pool !== "object" || Array.isArray(pool))) return {
-		max: 0,
-		error: "Invalid pool value. Expected an object with simulator and emulator bounds."
-	};
-	const fromConfig = pool !== null && typeof pool === "object" && !Array.isArray(pool) ? pool[key] : void 0;
-	const raw = explicit ? fromEnv : fromConfig;
-	if (raw === void 0) return {
-		max: env.STIM_HOME ? 0 : 3,
-		error: null
-	};
-	const parsed = parseMax(raw, explicit);
-	if (parsed === null) return {
-		max: 0,
-		error: `Invalid ${explicit ? envKey : `pool.${key}`} value ${JSON.stringify(raw)}. Expected a whole number of parked ${platform === "ios" ? "simulators" : "emulators"}, 0 or more.`
-	};
-	return {
-		max: explicit ? parsed : env.STIM_HOME ? 0 : parsed,
-		error: null
-	};
+function providerFromConfig(config) {
+	if (!config || typeof config !== "object") return null;
+	const expoField = config.expo;
+	const exp = expoField && typeof expoField === "object" ? expoField : config;
+	return exp.buildCacheProvider ?? exp.experiments?.buildCacheProvider ?? null;
 }
-function isParkedRecord(value, platform) {
-	if (value === null || typeof value !== "object" || Array.isArray(value)) return false;
-	const record = value;
-	return typeof record.udid === "string" && typeof record.name === "string" && record.name.startsWith("stim-") && typeof record.parkedAt === "string" && (platform === "android" ? record.udid === record.name && /^stim-[A-Za-z0-9._-]+$/.test(record.name) && typeof record.systemImage === "string" && typeof record.configuration === "string" : typeof record.deviceTypeIdentifier === "string" && typeof record.runtimeIdentifier === "string" && typeof record.simslimManaged === "boolean" && (record.bundleId === void 0 || typeof record.bundleId === "string") && (record.cacheKey === void 0 || typeof record.cacheKey === "string"));
+function ownerFromConfig(config) {
+	if (!config || typeof config !== "object") return null;
+	const expoField = config.expo;
+	const owner = (expoField && typeof expoField === "object" ? expoField : config).owner;
+	return typeof owner === "string" && owner.trim() !== "" ? owner.trim() : null;
 }
-function poolBlock(config) {
-	const raw = config?.parked;
-	const block = raw !== null && typeof raw === "object" && !Array.isArray(raw) ? raw : {};
-	const read = (platform) => {
-		const list = block[platform];
-		return Array.isArray(list) ? list.filter((record) => isParkedRecord(record, platform)) : [];
-	};
-	return {
-		ios: read("ios"),
-		android: read("android")
+function normalizeProvider(raw) {
+	if (raw === null || raw === void 0 || raw === "") return null;
+	if (raw === "eas") return {
+		name: "eas",
+		reference: EAS_PROVIDER_PACKAGE,
+		options: {}
 	};
+	if (typeof raw === "object") {
+		const obj = raw;
+		if (typeof obj.plugin === "string" && obj.plugin.trim() !== "") {
+			const reference = obj.plugin.trim();
+			return {
+				name: reference,
+				reference,
+				options: obj.options && typeof obj.options === "object" ? obj.options : {}
+			};
+		}
+	}
+	return { invalid: typeof raw === "string" ? `"${raw}"` : JSON.stringify(raw) };
 }
-function readParked(platform, { config } = {}) {
-	return poolBlock(config === void 0 ? loadConfig() : config)[platform];
-}
-function writeParked(config, platform, records) {
-	config.parked = {
-		...poolBlock(config),
-		[platform]: records
-	};
+function runOptionsFor(platform) {
+	return platform === "android" ? { variant: "debug" } : { configuration: "Debug" };
 }
-function oldestFirst(records) {
-	return records.toSorted((a, b) => String(a.parkedAt).localeCompare(String(b.parkedAt)));
+function isProviderPlugin(plugin) {
+	if (!plugin || typeof plugin !== "object") return false;
+	const p = plugin;
+	const resolves = typeof p.resolveBuildCache === "function" || typeof p.resolveRemoteBuildCache === "function";
+	const uploads = typeof p.uploadBuildCache === "function" || typeof p.uploadRemoteBuildCache === "function";
+	return resolves && uploads;
 }
-function selectParked(records, { deviceTypeIdentifier, runtimeIdentifier }) {
-	return oldestFirst(records.filter((r) => r.deletionClaim === void 0 && r.deviceTypeIdentifier === deviceTypeIdentifier && r.runtimeIdentifier === runtimeIdentifier));
+function cacheLevel(value) {
+	return value === "local" || value === "remote" ? value : false;
 }
-function evictOverflow(records, max) {
-	if (records.length <= max) return {
-		keep: [...records],
-		evicted: []
-	};
-	const ordered = oldestFirst(records);
-	const evicted = ordered.slice(0, ordered.length - max);
-	const dropped = new Set(evicted.map((r) => r.udid));
-	return {
-		keep: records.filter((r) => !dropped.has(r.udid)),
-		evicted
-	};
+function exitAfterFlush(code = 0, { exit = (c) => process.exit(c), stream = process.stdout } = {}) {
+	try {
+		stream.write("", () => exit(code));
+	} catch {
+		exit(code);
+	}
 }
-function parkSim({ platform, projectPath, record, max }) {
-	return withConfigLock(() => {
-		const cfg = ensureConfig();
-		if (platform === "android") {
-			const current = cfg.projects[projectPath]?.platforms?.android;
-			if (!current?.owned || current.avdName !== record.udid) throw new Error("The emulator assignment changed before parking.");
+function readProjectConfig(root, { run = null, timeoutMs = CONFIG_TIMEOUT_MS } = {}) {
+	const dynamic = dynamicConfigFile(root);
+	if (!dynamic) {
+		const file = join(root, "app.json");
+		if (!existsSync(file)) return {
+			config: null,
+			source: null
+		};
+		try {
+			return {
+				config: JSON.parse(readFileSync(file, "utf-8")),
+				source: "app.json"
+			};
+		} catch (err) {
+			return { unavailable: `app.json could not be parsed: ${firstLine(err)}` };
 		}
-		const { keep, evicted } = evictOverflow([...readParked(platform, { config: cfg }).filter((r) => r.udid !== record.udid), record], max);
-		writeParked(cfg, platform, [...keep, ...evicted]);
-		const platforms = cfg.projects?.[projectPath]?.platforms;
-		if (platforms) delete platforms[platform];
-		saveConfig(cfg);
-		return evicted;
-	});
-}
-function adoptParked({ platform, projectPath, udid, device }) {
-	return withConfigLock(() => {
-		const cfg = ensureConfig();
-		const records = readParked(platform, { config: cfg });
-		const taken = records.find((r) => r.udid === udid);
-		if (!taken || taken.deletionClaim !== void 0) return null;
-		if (platform === "android" && cfg.projects[projectPath]?.platforms?.android) return null;
-		writeParked(cfg, platform, records.filter((r) => r.udid !== udid));
-		const project = cfg.projects[projectPath];
-		if (!project) throw new Error(`Project not registered: ${projectPath}`);
-		project.platforms = project.platforms || {};
-		project.platforms[platform] = device;
-		saveConfig(cfg);
-		return taken;
-	});
+	}
+	const bin = expoBinPath(root);
+	if (!bin) return { unavailable: `${dynamic} is code, so it has to be evaluated to read its buildCacheProvider, and the \`expo\` package is not resolvable from this project (no expo/package.json to read a bin from, and no node_modules/.bin/expo here or in any parent)` };
+	const exec = run || ((file, args, opts) => getExecutor().runFile(file, args, opts));
+	let stdout;
+	try {
+		stdout = exec(bin, [
+			"config",
+			"--json",
+			root
+		], { timeoutMs });
+	} catch (err) {
+		return { unavailable: `\`expo config --json\` failed: ${firstLine(err)}` };
+	}
+	try {
+		return {
+			config: JSON.parse(String(stdout)),
+			source: dynamic
+		};
+	} catch (err) {
+		return { unavailable: `\`expo config --json\` did not print JSON: ${firstLine(err)}` };
+	}
 }
-function isProcessAlive(pid) {
+async function loadPlugin(projectRoot, reference, { requireFrom = null } = {}) {
+	const localRequire = requireFrom ? requireFrom(projectRoot) : createRequire(join(projectRoot, "package.json"));
+	const file = localRequire.resolve(reference);
+	let mod;
 	try {
-		process.kill(pid, 0);
-		return true;
-	} catch (error) {
-		return error.code === "EPERM";
+		mod = localRequire(file);
+	} catch (err) {
+		if (err?.code !== "ERR_REQUIRE_ESM") throw err;
+		mod = await import(pathToFileURL(file).href);
 	}
+	const plugin = mod?.default ?? mod;
+	if (!isProviderPlugin(plugin)) throw new Error(`"${reference}" does not export resolveBuildCache and uploadBuildCache functions`);
+	return plugin;
 }
-function parseDeletionClaim(value) {
-	if (value === null || typeof value !== "object" || Array.isArray(value)) return null;
-	const claim = value;
-	if (!Number.isSafeInteger(claim.pid) || claim.pid <= 0) return null;
-	if (typeof claim.token !== "string" || claim.token.length === 0) return null;
+async function loadProjectProvider(projectRoot, { isExpo = true, run = null, requireFrom = null, timeoutMs = CONFIG_TIMEOUT_MS } = {}) {
+	if (!isExpo) return { none: true };
+	const read = readProjectConfig(projectRoot, {
+		run,
+		timeoutMs
+	});
+	if (read.unavailable) return { unavailable: read.unavailable };
+	const normalized = normalizeProvider(providerFromConfig(read.config));
+	if (!normalized) return { none: true };
+	if (normalized.invalid) return { unavailable: `buildCacheProvider is ${normalized.invalid}, which is not "eas" or { plugin: <module> }` };
+	if (normalized.reference === "@stim-cli/expo-build-cache") return { none: true };
+	let plugin;
+	try {
+		plugin = await loadPlugin(projectRoot, normalized.reference, { requireFrom });
+	} catch (err) {
+		const missing = err?.code === "MODULE_NOT_FOUND";
+		return { unavailable: normalized.name === "eas" && missing ? `the EAS build cache needs the \`${EAS_PROVIDER_PACKAGE}\` package, which is not installed in this project` : `${normalized.name} could not be loaded: ${firstLine(err)}` };
+	}
 	return {
-		pid: claim.pid,
-		token: claim.token
+		provider: {
+			plugin,
+			options: normalized.options ?? {}
+		},
+		name: normalized.name,
+		owner: ownerFromConfig(read.config)
 	};
 }
-function claimParkedRemoval(platform, udid) {
-	return withConfigLock(() => {
-		const cfg = loadConfig();
-		if (!cfg) return null;
-		const records = readParked(platform, { config: cfg });
-		const record = records.find((candidate) => candidate.udid === udid);
-		if (!record) return null;
-		const existingClaim = parseDeletionClaim(record.deletionClaim);
-		if (record.deletionClaim !== void 0 && (!existingClaim || isProcessAlive(existingClaim.pid))) return null;
-		const token = randomUUID();
-		const claimedRecord = {
-			...record,
-			deletionClaim: {
-				pid: process.pid,
-				token
-			}
-		};
-		writeParked(cfg, platform, records.map((candidate) => candidate.udid === udid ? claimedRecord : candidate));
-		saveConfig(cfg);
-		const claimed = { ...record };
-		delete claimed.deletionClaim;
-		return {
-			record: claimed,
-			token
-		};
-	});
+const WHOAMI_TIMEOUT_MS = 15e3;
+const EAS_CLI_PACKAGE = "eas-cli";
+const EAS_CLI_BIN = "eas";
+function parseWhoami({ stdout = "", stderr = "", exitCode = 0 } = {}) {
+	const out = stripAnsi(stdout);
+	const combined = `${out}\n${stripAnsi(stderr)}`;
+	if (/^\s*Not logged in\s*$/m.test(combined)) return { loggedOut: true };
+	if (exitCode !== 0) return { unknown: firstLine(combined.trim() || `eas whoami exited ${exitCode}`) };
+	const lines = out.split("\n").map((line) => line.trim()).filter((line) => line !== "");
+	if (lines.length === 0) return { unknown: "eas whoami printed nothing" };
+	const raw = lines[0];
+	if (raw === void 0) return { unknown: "eas whoami printed nothing" };
+	const viaToken = /\(authenticated using EXPO_TOKEN\)\s*$/.test(raw);
+	const display = raw.replace(/\s*\(authenticated using EXPO_TOKEN\)\s*$/, "").trim();
+	const accounts = [];
+	for (const line of lines) {
+		const name = /^\u2022\s*(\S+)\s*\(Role:/.exec(line)?.[1];
+		if (name !== void 0) accounts.push(name);
+	}
+	if (accounts.length === 0 && !display.endsWith("(robot)") && display !== "robot") accounts.push(display);
+	return {
+		loggedIn: true,
+		account: display,
+		accounts: accounts.length ? accounts : null,
+		viaToken
+	};
 }
-function clearParkedRemovalClaim(platform, udid, token) {
-	withConfigLock(() => {
-		const cfg = loadConfig();
-		if (!cfg) return;
-		const records = readParked(platform, { config: cfg });
-		const record = records.find((candidate) => candidate.udid === udid);
-		if (!record || parseDeletionClaim(record.deletionClaim)?.token !== token) return;
-		const restored = { ...record };
-		delete restored.deletionClaim;
-		writeParked(cfg, platform, records.map((candidate) => candidate.udid === udid ? restored : candidate));
-		saveConfig(cfg);
+function isEasAuthFailureText(text) {
+	const t = stripAnsi(text || "");
+	if (t.trim() === "") return false;
+	return /not logged in/i.test(t) || /\beas login\b/i.test(t) || /EXPO_TOKEN/.test(t) || /unauthorized/i.test(t) || /not authorized/i.test(t) || /authentication (failed|required)/i.test(t);
+}
+function easAuthNote(status) {
+	const { code, account, owner, reason, phase = "resolve" } = status || {};
+	const because = reason ? ` (${reason})` : "";
+	if (code === "logged-out") return `eas is not authenticated${because} -- run \`eas login\` (or set EXPO_TOKEN); ` + (phase === "upload" ? "this build stayed in the local cache" : "building with the local cache only");
+	if (code === "wrong-account") return `eas is authenticated as ${account}, and this project's owner is ${owner} -- run \`eas login\` as a member of ${owner} (or set EXPO_TOKEN); consulting the EAS cache anyway`;
+	return null;
+}
+function resolveEasCliBin(projectRoot, { lookupPath = null, timeoutMs = 5e3 } = {}) {
+	const fromPackage = expoBinFromPackage(resolvePackageJson(projectRoot, EAS_CLI_PACKAGE), EAS_CLI_BIN);
+	if (fromPackage) return {
+		file: fromPackage,
+		source: "project"
+	};
+	const shim = findBinUpward(projectRoot, EAS_CLI_BIN);
+	if (shim) return {
+		file: shim,
+		source: "project"
+	};
+	const onPath = lookupPath ? lookupPath() : getExecutor().runQuiet(`command -v ${EAS_CLI_BIN}`, { timeoutMs });
+	const file = (String(onPath || "").split("\n")[0] ?? "").trim();
+	return file ? {
+		file,
+		source: "path"
+	} : null;
+}
+const easAuthCache = /* @__PURE__ */ new Map();
+function checkEasAuth({ projectRoot, owner = null, run = null, resolveBin = null, timeoutMs = WHOAMI_TIMEOUT_MS, cache = easAuthCache }) {
+	const key = `${projectRoot}::${owner || ""}`;
+	if (cache?.has(key)) return cache.get(key);
+	const answer = probeEasAuth({
+		projectRoot,
+		owner,
+		run,
+		resolveBin,
+		timeoutMs
 	});
+	cache?.set(key, answer);
+	return answer;
 }
-function removeParkedAfter(platform, udid, beforeRemove) {
-	const claim = claimParkedRemoval(platform, udid);
-	if (!claim) return null;
+function probeEasAuth({ projectRoot, owner, run, resolveBin, timeoutMs }) {
+	const bin = (resolveBin || resolveEasCliBin)(projectRoot);
+	if (!bin) return {
+		failed: true,
+		code: "no-cli",
+		reason: "no `eas` executable is resolvable from this project or on PATH",
+		remedy: "Install eas-cli (`npm i -g eas-cli`, or as a project devDependency), then run `eas login`."
+	};
+	const exec = run || ((file, args, opts) => getExecutor().runFile(file, args, opts));
+	let result;
 	try {
-		beforeRemove(claim.record);
-	} catch (error) {
-		try {
-			clearParkedRemovalClaim(platform, udid, claim.token);
-		} catch {}
-		throw error;
+		result = {
+			stdout: String(exec(bin.file, ["whoami"], { timeoutMs }) ?? ""),
+			exitCode: 0
+		};
+	} catch (e) {
+		const err = e;
+		if (err?.code === "ETIMEDOUT" || err?.signal === "SIGTERM" || err?.killed) return { unknown: `eas whoami timed out after ${timeoutMs}ms` };
+		result = {
+			stdout: String(err?.stdout ?? ""),
+			stderr: String(err?.stderr ?? err?.message ?? ""),
+			exitCode: typeof err?.status === "number" ? err.status : 1
+		};
 	}
-	return withConfigLock(() => {
-		const cfg = loadConfig();
-		if (!cfg) return null;
-		const records = readParked(platform, { config: cfg });
-		if (parseDeletionClaim(records.find((candidate) => candidate.udid === udid)?.deletionClaim)?.token !== claim.token) return null;
-		writeParked(cfg, platform, records.filter((candidate) => candidate.udid !== udid));
-		saveConfig(cfg);
-		return claim.record;
+	const parsed = parseWhoami(result);
+	if (parsed.loggedOut) return {
+		failed: true,
+		code: "logged-out",
+		reason: "eas whoami says \"Not logged in\"",
+		remedy: "Run `eas login` (or set EXPO_TOKEN)."
+	};
+	if (parsed.unknown) return { unknown: parsed.unknown };
+	if (owner && Array.isArray(parsed.accounts) && !parsed.accounts.includes(owner)) return {
+		failed: true,
+		code: "wrong-account",
+		account: parsed.account,
+		accounts: parsed.accounts,
+		owner,
+		reason: `eas is authenticated as ${parsed.account} (accounts: ${parsed.accounts.join(", ")}), which does not include this project's owner ${owner}`,
+		remedy: `Run \`eas login\` as a member of ${owner}, or set EXPO_TOKEN to a token for it.`
+	};
+	return {
+		ok: true,
+		account: parsed.account,
+		accounts: parsed.accounts,
+		viaToken: parsed.viaToken,
+		source: bin.source
+	};
+}
+const capturing = [];
+const abandoned = /* @__PURE__ */ new Set();
+let patched = null;
+const PROVIDER_CONTEXT = new AsyncLocalStorage();
+function uploadDestination(lines) {
+	const text = (lines || []).map(stripAnsi);
+	for (const line of text) {
+		const url = /(https?:\/\/[^\s'"]+)/.exec(line)?.[1];
+		if (url !== void 0) return url.replace(/[.,)\]]+$/, "");
+	}
+	for (const line of text) {
+		const slug = /\bto\s+(@?[\w.-]+\/[\w.-]+)/i.exec(line)?.[1];
+		if (slug !== void 0) return slug.replace(/[.,)\]]+$/, "");
+	}
+	return null;
+}
+function providerNote(text) {
+	return `${"cache".padEnd(11)} ${text}`;
+}
+function currentFrame() {
+	const store = PROVIDER_CONTEXT.getStore();
+	return store && (capturing.includes(store) || abandoned.has(store)) ? store : null;
+}
+function install() {
+	if (patched && process.stdout.write === patched.patchedWrite) return;
+	const stdout = process.stdout;
+	const write = stdout.write.bind(stdout);
+	const log = console.log;
+	const passthrough = write;
+	const patchedWrite = ((chunk, encoding, callback) => {
+		const frame = currentFrame();
+		if (!frame) return passthrough(chunk, encoding, callback);
+		const cb = typeof encoding === "function" ? encoding : callback;
+		absorb(frame, typeof chunk === "string" ? chunk : String(chunk));
+		if (typeof cb === "function") cb();
+		return true;
 	});
+	const patchedLog = (...args) => {
+		const frame = currentFrame();
+		if (!frame) return log(...args);
+		absorb(frame, `${format(...args)}\n`);
+	};
+	stdout.write = patchedWrite;
+	console.log = patchedLog;
+	patched = {
+		stdout,
+		write,
+		log,
+		patchedWrite,
+		patchedLog
+	};
 }
-function dropParked(platform, udid) {
-	return removeParkedAfter(platform, udid, () => {}) !== null;
+function uninstall() {
+	if (!patched || capturing.length || abandoned.size) return;
+	if (patched.stdout.write === patched.patchedWrite) patched.stdout.write = patched.write;
+	if (console.log === patched.patchedLog) console.log = patched.log;
+	patched = null;
 }
-//#endregion
-//#region src/teardown.ts
-function teardownParkedAvd(avdName) {
+function absorb(frame, chunk) {
 	try {
-		return removeParkedAfter("android", avdName, () => {
-			const result = teardownOwnedAvd(avdName, {
-				del: true,
-				owner: { pool: true }
-			});
-			if (result.status !== "torn-down" && result.status !== "missing") throw new Error(result.reason);
-		}) ? {
-			status: "torn-down",
-			label: avdName
-		} : {
-			status: "skipped",
-			kind: "not-parked",
-			reason: "emulator is no longer parked"
-		};
-	} catch (error) {
-		return {
-			status: "failed",
-			reason: String(error?.message || error)
-		};
+		process.stderr.write(chunk);
+	} catch {}
+	frame.pending += chunk;
+	let index = frame.pending.indexOf("\n");
+	while (index !== -1) {
+		emitLine(frame, frame.pending.slice(0, index));
+		frame.pending = frame.pending.slice(index + 1);
+		index = frame.pending.indexOf("\n");
 	}
 }
-function teardownParkedIosSim(udid, { label, deleteSim = deleteParkedIosSim } = {}) {
+function emitLine(frame, raw) {
+	const line = stripAnsi(raw).trim();
+	if (line === "") return;
+	frame.lines.push(line);
+	const writer = frame.writer();
 	try {
-		const removed = removeParkedAfter("ios", udid, () => deleteSim(udid));
-		if (!removed) return {
-			status: "skipped",
-			kind: "not-parked",
-			reason: "simulator is no longer parked"
-		};
-		return {
-			status: "torn-down",
-			label: label ?? removed.name
-		};
-	} catch (error) {
-		return {
-			status: "failed",
-			reason: String(error?.message || error)
-		};
-	}
+		writer?.write({
+			src: "build",
+			level: "debug",
+			event: "provider",
+			msg: line
+		});
+	} catch {}
+	frame.onLine?.(line);
 }
-function parkOwnedIosSim(udid, park) {
-	const resolved = resolveOwnedIosSim(udid);
-	if (resolved.missing) throw new Error(`simulator ${udid} disappeared after shutdown`);
-	if (resolved.notOwned) throw new Error(`simulator ${udid} is now named ${JSON.stringify(resolved.notOwned)}`);
-	const sim = resolved.sim;
-	if (sim.state !== "Shutdown") throw new Error(`simulator ${udid} is still ${sim.state} after shutdown`);
-	const model = listIosDeviceTypes().find((d) => d.identifier === sim.deviceTypeIdentifier)?.name ?? null;
-	const runtime = parseRuntimeVersion(sim.runtime);
-	if (park.bundleId) {
-		if (!sim.dataPath) throw new Error(`simulator ${udid} did not report a data path for app cleanup`);
-		const container = findAppDataContainer(sim.dataPath, park.bundleId);
-		if (container) clearAppDataContainer(container);
+function beginCapture({ logWriter = null, projectRoot = null, platform = null, onLine = null } = {}) {
+	let own = null;
+	const frame = {
+		lines: [],
+		pending: "",
+		onLine,
+		writer: () => {
+			if (logWriter) return logWriter;
+			if (own) return own;
+			if (!projectRoot || !platform) return null;
+			own = createNdjsonWriter(join(workspaceLogsDir(projectRoot), `build-${platform}.ndjson`));
+			return own;
+		},
+		close: () => {
+			own?.close?.();
+			own = null;
+		}
+	};
+	capturing.push(frame);
+	install();
+	return frame;
+}
+function endCapture(frame) {
+	if (!frame) return;
+	const at = capturing.lastIndexOf(frame);
+	if (at !== -1) capturing.splice(at, 1);
+	abandoned.delete(frame);
+	if (frame.pending !== "") {
+		const rest = frame.pending;
+		frame.pending = "";
+		emitLine(frame, rest);
 	}
-	const name = parkedSimName(sim.udid, {
-		model,
-		runtime
+	frame.close();
+	uninstall();
+}
+function abandonCapture(frame, work) {
+	if (!frame) return;
+	const at = capturing.lastIndexOf(frame);
+	if (at !== -1) capturing.splice(at, 1);
+	abandoned.add(frame);
+	Promise.resolve(work).then(() => endCapture(frame), () => endCapture(frame));
+}
+async function resolveRemote({ provider, platform, projectRoot, fingerprintHash, runOptions = null, timeoutMs = RESOLVE_TIMEOUT_MS, logWriter = null } = {}) {
+	if (!provider?.plugin || !fingerprintHash) return null;
+	const opts = runOptions || runOptionsFor(platform);
+	const outcome = await withBudget(async () => {
+		const props = {
+			fingerprintHash: await providerFingerprint({
+				provider,
+				platform,
+				projectRoot,
+				runOptions: opts
+			}) ?? fingerprintHash,
+			platform,
+			runOptions: opts,
+			projectRoot
+		};
+		return typeof provider.plugin.resolveBuildCache === "function" ? provider.plugin.resolveBuildCache(props, provider.options) : provider.plugin.resolveRemoteBuildCache(props, provider.options);
+	}, timeoutMs, {
+		logWriter,
+		projectRoot,
+		platform
 	});
-	renameIosSim(sim.udid, name);
-	const record = {
-		udid: sim.udid,
-		name,
-		deviceTypeIdentifier: sim.deviceTypeIdentifier,
-		runtimeIdentifier: sim.runtime,
-		parkedAt: (/* @__PURE__ */ new Date()).toISOString(),
-		simslimManaged: Boolean(park.simslimManaged),
-		...park.bundleId ? { bundleId: park.bundleId } : {},
-		...park.cacheKey ? { cacheKey: park.cacheKey } : {}
-	};
-	return {
-		record,
-		evicted: parkSim({
-			platform: "ios",
-			projectPath: park.projectPath,
-			record,
-			max: park.max
-		})
+	if (outcome.timedOut) return { timedOut: true };
+	if (outcome.error) return { failed: firstLine(outcome.error) };
+	const appPath = typeof outcome.value === "string" ? outcome.value.trim() : "";
+	if (!appPath) return null;
+	if (!existsSync(appPath)) return { failed: `returned ${appPath}, which does not exist` };
+	return { appPath };
+}
+async function uploadRemote({ provider, platform, projectRoot, fingerprintHash, buildPath, runOptions = null, timeoutMs = UPLOAD_TIMEOUT_MS, logWriter = null, note = (line) => console.error(line) } = {}) {
+	if (!provider?.plugin || !fingerprintHash || !buildPath) return { skipped: true };
+	const opts = runOptions || runOptionsFor(platform);
+	let announced = false;
+	const onLine = (line) => {
+		if (announced) return;
+		const dest = uploadDestination([line]);
+		if (!dest) return;
+		announced = true;
+		note(providerNote(`uploading to ${dest}`));
 	};
+	const outcome = await withBudget(async () => {
+		const props = {
+			projectRoot,
+			platform,
+			fingerprintHash: await providerFingerprint({
+				provider,
+				platform,
+				projectRoot,
+				runOptions: opts
+			}) ?? fingerprintHash,
+			buildPath,
+			runOptions: opts
+		};
+		return typeof provider.plugin.uploadBuildCache === "function" ? provider.plugin.uploadBuildCache(props, provider.options) : provider.plugin.uploadRemoteBuildCache(props, provider.options);
+	}, timeoutMs, {
+		logWriter,
+		projectRoot,
+		platform,
+		onLine
+	});
+	if (outcome.timedOut) return { timedOut: true };
+	if (outcome.error) return { failed: firstLine(outcome.error) };
+	const destination = uploadDestination(outcome.lines);
+	return destination ? {
+		uploaded: true,
+		destination
+	} : { uploaded: true };
 }
-function teardownOwnedIosSim(udid, { del = false, label, park } = {}) {
-	let parkFallback;
+async function providerFingerprint({ provider, platform, projectRoot, runOptions }) {
+	if (typeof provider.plugin.calculateFingerprintHash !== "function") return null;
 	try {
-		const resolved = resolveOwnedIosSim(udid);
-		if (resolved.notOwned) return {
-			status: "skipped",
-			kind: "not-owned",
-			reason: `sim is now named "${resolved.notOwned}", not Stim-owned by name`
-		};
-		if (resolved.missing) return { status: "missing" };
-		shutdownIosSim(udid);
-		const sim = resolved.sim;
-		if (del && park && park.max > 0) try {
-			const { record, evicted } = parkOwnedIosSim(udid, park);
-			const removed = [];
-			const failures = [];
-			for (const entry of evicted) {
-				const result = teardownParkedIosSim(entry.udid, { label: entry.name });
-				if (result.status === "torn-down") removed.push({
-					udid: entry.udid,
-					name: entry.name
-				});
-				else if (result.status === "failed") failures.push(`could not delete evicted ${entry.name} (${entry.udid}): ${result.reason}`);
-			}
-			return {
-				status: "torn-down",
-				label: label ?? sim.name ?? udid,
-				parked: {
-					udid: record.udid,
-					name: record.name
-				},
-				evicted: removed,
-				...failures.length ? { evictionFailures: failures } : {}
+		const hash = await provider.plugin.calculateFingerprintHash({
+			projectRoot,
+			platform,
+			runOptions
+		}, provider.options);
+		return typeof hash === "string" && hash.trim() !== "" ? hash.trim() : null;
+	} catch {
+		return null;
+	}
+}
+async function withBudget(factory, ms, capture) {
+	let timer = null;
+	const timeout = new Promise((resolve) => {
+		timer = setTimeout(() => resolve(TIMED_OUT), ms);
+		timer?.unref?.();
+	});
+	const frame = beginCapture(capture || {});
+	const work = Promise.resolve().then(() => PROVIDER_CONTEXT.run(frame, factory)).then((value) => ({ value }), (error) => ({ error }));
+	try {
+		const settled = await Promise.race([work, timeout]);
+		if (settled === TIMED_OUT) {
+			abandonCapture(frame, work);
+			return {
+				timedOut: true,
+				lines: frame.lines
 			};
-		} catch (e) {
-			parkFallback = String(e?.message || e);
 		}
-		if (del) deleteIosSim(udid);
-		return {
-			status: "torn-down",
-			label: label ?? sim.name ?? udid,
-			...parkFallback ? { parkFallback } : {}
-		};
-	} catch (e) {
+		endCapture(frame);
 		return {
-			status: "failed",
-			reason: String(e?.message || e),
-			...parkFallback ? { parkFallback } : {}
+			...settled,
+			lines: frame.lines
 		};
+	} catch (err) {
+		endCapture(frame);
+		throw err;
+	} finally {
+		if (timer) clearTimeout(timer);
 	}
 }
-function removeOrphanedAvdDirectory(candidate, owner) {
-	const detached = withConfigLock(() => {
-		const current = listOrphanedAvdDirectories(candidate.name).find((entry) => entry.directory === candidate.directory);
-		if (!current || current.name !== candidate.name || current.dev !== candidate.dev || current.ino !== candidate.ino) throw new Error(`AVD data at ${candidate.directory} changed or is registered; it was kept.`);
-		const config = loadConfig();
-		if (!config) throw new Error("Cannot verify AVD references without a Stim config; the data was kept.");
-		for (const [projectPath, project] of Object.entries(config.projects)) {
-			if (project.platforms?.android?.avdName !== candidate.name) continue;
-			if (!owner || !("projectPath" in owner) || owner.projectPath !== projectPath || !project.platforms.android.owned) throw new Error(`AVD ${candidate.name} is referenced by ${projectPath}; its data was kept.`);
-		}
-		if (readParked("android", { config }).some((entry) => entry.name === candidate.name) && !(owner && "pool" in owner)) throw new Error(`AVD ${candidate.name} is in the emulator pool; its data was kept.`);
-		assertOwnedAvdStopped(candidate.name, { resolveDirectory: () => candidate.directory });
-		const destination = join(dirname(candidate.directory), `stim-gc-${randomUUID()}.avd`);
-		renameSync(candidate.directory, destination);
-		return destination;
-	});
-	const current = lstatSync(detached);
-	if (!current.isDirectory() || current.dev !== candidate.dev || current.ino !== candidate.ino) throw new Error(`Detached AVD data changed at ${detached}; it was kept.`);
-	try {
-		rmSync(detached, { recursive: true });
-	} catch (error) {
-		throw new Error(`Could not remove AVD data at ${detached}; retry gc --delete: ${error.message}`, { cause: error });
-	}
+function firstLine(err) {
+	const line = (String(err?.message || err || "unknown error").trim().split("\n")[0] ?? "").trim();
+	return line.length > 200 ? `${line.slice(0, 197)}...` : line;
 }
-function teardownUnregisteredAvd(avdName, del, owner, surveyed) {
-	const candidates = surveyed ? [surveyed] : listOrphanedAvdDirectories(avdName);
-	if (candidates.length === 0) {
-		if (avdStorageRoots().some((root) => avdPathExists(join(root, `${avdName}.ini`)) || avdPathExists(join(root, `${avdName}.avd`)))) throw new Error(`AVD ${avdName} is not listed but its storage remains; it was kept.`);
-		return { status: "missing" };
+const POOL_SETTING_REMEDY = "Run `stim guide settings` for the device pool bounds and where it can be set.";
+const MAX_SETTING = {
+	ios: {
+		key: "iosParkedMax",
+		env: "STIM_POOL_IOS_PARKED_MAX"
+	},
+	android: {
+		key: "androidParkedMax",
+		env: "STIM_POOL_ANDROID_PARKED_MAX"
 	}
-	if (!del) return {
-		status: "skipped",
-		reason: "AVD registration is missing; its data was kept."
+};
+function parseMax(raw, strings) {
+	const value = strings && typeof raw === "string" ? /^\d+$/.test(raw.trim()) ? Number(raw.trim()) : NaN : raw;
+	if (typeof value !== "number" || !Number.isSafeInteger(value) || value < 0) return null;
+	return value;
+}
+function parkedMaxSetting(platform, { config, env = process.env } = {}) {
+	const { key, env: envKey } = MAX_SETTING[platform];
+	const fromEnv = env[envKey];
+	const explicit = fromEnv !== void 0 && fromEnv !== "";
+	const pool = (config === void 0 ? loadConfig() : config)?.pool;
+	if (!explicit && pool !== void 0 && (pool === null || typeof pool !== "object" || Array.isArray(pool))) return {
+		max: 0,
+		error: "Invalid pool value. Expected an object with simulator and emulator bounds."
+	};
+	const fromConfig = pool !== null && typeof pool === "object" && !Array.isArray(pool) ? pool[key] : void 0;
+	const raw = explicit ? fromEnv : fromConfig;
+	if (raw === void 0) return {
+		max: env.STIM_HOME ? 0 : 3,
+		error: null
+	};
+	const parsed = parseMax(raw, explicit);
+	if (parsed === null) return {
+		max: 0,
+		error: `Invalid ${explicit ? envKey : `pool.${key}`} value ${JSON.stringify(raw)}. Expected a whole number of parked ${platform === "ios" ? "simulators" : "emulators"}, 0 or more.`
 	};
-	for (const candidate of candidates) {
-		if (candidate.name !== avdName) throw new Error(`AVD data does not match ${avdName}; it was kept.`);
-		removeOrphanedAvdDirectory(candidate, owner);
-	}
 	return {
-		status: "torn-down",
-		label: avdName
+		max: explicit ? parsed : env.STIM_HOME ? 0 : parsed,
+		error: null
 	};
 }
-function teardownOwnedAvd(avdName, { del = false, park, owner, orphanedDirectory, waitForShutdown = waitForAndroidEmulatorShutdown, assertStopped = assertOwnedAvdStopped, resolveAvd = resolveOwnedAvdSerial } = {}) {
-	let parkFallback;
-	try {
-		if (!/^stim-[A-Za-z0-9._-]+$/.test(avdName)) return {
-			status: "skipped",
-			kind: "not-owned",
-			reason: `AVD ${avdName} is not Stim-owned by name`
-		};
-		const resolved = resolveAvd(avdName);
-		if (resolved.notOwned) return {
-			status: "skipped",
-			kind: "not-owned",
-			reason: `AVD ${avdName} is not Stim-owned by name`
-		};
-		if (resolved.missing) return teardownUnregisteredAvd(avdName, del, owner, orphanedDirectory);
-		if (orphanedDirectory) return {
-			status: "skipped",
-			reason: "AVD registration appeared; its data was kept."
-		};
-		const serial = resolved.serial;
-		if (serial) waitForShutdown(avdName, (timeoutMs) => shutdownAndroidEmulator(serial, timeoutMs));
-		else assertStopped(avdName);
-		if (del) {
-			const current = resolveAvd(avdName);
-			if (current.notOwned) return {
-				status: "skipped",
-				kind: "not-owned",
-				reason: `AVD ${avdName} is not Stim-owned by name`
-			};
-			if (current.missing) return teardownUnregisteredAvd(avdName, del, owner);
-			if (current.serial) throw new Error(`Owned AVD ${avdName} started again before deletion.`);
-			assertStopped(avdName);
-			if (park && park.max > 0) try {
-				const systemImage = ownedAvdSystemImage(avdName);
-				if (!systemImage || !park.configuration || !ownedAvdMatchesConfiguration(avdName, park.configuration)) throw new Error("the AVD has no verified creation configuration");
-				const evicted = parkSim({
-					platform: "android",
-					projectPath: park.projectPath,
-					max: park.max,
-					record: {
-						udid: avdName,
-						name: avdName,
-						systemImage,
-						configuration: park.configuration,
-						parkedAt: (/* @__PURE__ */ new Date()).toISOString()
-					}
-				});
-				const removed = [];
-				const failures = [];
-				for (const entry of evicted) {
-					const result = teardownParkedAvd(entry.name);
-					if (result.status === "torn-down") removed.push({
-						udid: entry.name,
-						name: entry.name,
-						platform: "android"
-					});
-					else if (result.status === "failed") failures.push(`could not delete evicted ${entry.name}: ${result.reason}`);
-				}
-				return {
-					status: "torn-down",
-					label: avdName,
-					parked: {
-						udid: avdName,
-						name: avdName,
-						platform: "android"
-					},
-					evicted: removed,
-					...failures.length ? { evictionFailures: failures } : {}
-				};
-			} catch (error) {
-				parkFallback = String(error?.message || error);
-			}
-			const directory = ownedAvdDirectory(avdName);
-			const paths = avdStorageRoots().map((root) => join(root, `${avdName}.ini`));
-			if (directory) paths.push(directory);
-			deleteAvd(avdName);
-			const remaining = paths.filter(avdPathExists);
-			if (remaining.length) throw new Error(`AVD ${avdName} was only partially deleted; data remains at ${remaining.join(", ")}.`);
-		}
-		return {
-			status: "torn-down",
-			label: avdName,
-			serial: resolved.serial ?? null,
-			...parkFallback ? { parkFallback } : {}
-		};
-	} catch (e) {
-		return {
-			status: "failed",
-			reason: String(e?.message || e)
-		};
-	}
-}
-//#endregion
-//#region src/engine/remote-cache.ts
-const EAS_PROVIDER_PACKAGE = "eas-build-cache-provider";
-const RESOLVE_TIMEOUT_MS = 3e4;
-const UPLOAD_TIMEOUT_MS = 6e4;
-const CONFIG_TIMEOUT_MS = 3e4;
-const DYNAMIC_CONFIG_FILES = [
-	"app.config.ts",
-	"app.config.js",
-	"app.config.mjs",
-	"app.config.cjs"
-];
-const TIMED_OUT = Symbol("timed-out");
-function dynamicConfigFile(root) {
-	for (const name of DYNAMIC_CONFIG_FILES) if (existsSync(join(root, name))) return name;
-	return null;
+function isParkedRecord(value, platform) {
+	if (value === null || typeof value !== "object" || Array.isArray(value)) return false;
+	const record = value;
+	return typeof record.udid === "string" && typeof record.name === "string" && record.name.startsWith("stim-") && typeof record.parkedAt === "string" && (platform === "android" ? record.udid === record.name && /^stim-[A-Za-z0-9._-]+$/.test(record.name) && typeof record.systemImage === "string" && typeof record.configuration === "string" : typeof record.deviceTypeIdentifier === "string" && typeof record.runtimeIdentifier === "string" && typeof record.simslimManaged === "boolean" && (record.bundleId === void 0 || typeof record.bundleId === "string") && (record.cacheKey === void 0 || typeof record.cacheKey === "string"));
 }
-function providerFromConfig(config) {
-	if (!config || typeof config !== "object") return null;
-	const expoField = config.expo;
-	const exp = expoField && typeof expoField === "object" ? expoField : config;
-	return exp.buildCacheProvider ?? exp.experiments?.buildCacheProvider ?? null;
+function poolBlock(config) {
+	const raw = config?.parked;
+	const block = raw !== null && typeof raw === "object" && !Array.isArray(raw) ? raw : {};
+	const read = (platform) => {
+		const list = block[platform];
+		return Array.isArray(list) ? list.filter((record) => isParkedRecord(record, platform)) : [];
+	};
+	return {
+		ios: read("ios"),
+		android: read("android")
+	};
 }
-function ownerFromConfig(config) {
-	if (!config || typeof config !== "object") return null;
-	const expoField = config.expo;
-	const owner = (expoField && typeof expoField === "object" ? expoField : config).owner;
-	return typeof owner === "string" && owner.trim() !== "" ? owner.trim() : null;
+function readParked(platform, { config } = {}) {
+	return poolBlock(config === void 0 ? loadConfig() : config)[platform];
 }
-function normalizeProvider(raw) {
-	if (raw === null || raw === void 0 || raw === "") return null;
-	if (raw === "eas") return {
-		name: "eas",
-		reference: EAS_PROVIDER_PACKAGE,
-		options: {}
+function writeParked(config, platform, records) {
+	config.parked = {
+		...poolBlock(config),
+		[platform]: records
 	};
-	if (typeof raw === "object") {
-		const obj = raw;
-		if (typeof obj.plugin === "string" && obj.plugin.trim() !== "") {
-			const reference = obj.plugin.trim();
-			return {
-				name: reference,
-				reference,
-				options: obj.options && typeof obj.options === "object" ? obj.options : {}
-			};
-		}
-	}
-	return { invalid: typeof raw === "string" ? `"${raw}"` : JSON.stringify(raw) };
 }
-function runOptionsFor(platform) {
-	return platform === "android" ? { variant: "debug" } : { configuration: "Debug" };
+function oldestFirst(records) {
+	return records.toSorted((a, b) => String(a.parkedAt).localeCompare(String(b.parkedAt)));
+}
+function selectParked(records, { deviceTypeIdentifier, runtimeIdentifier }) {
+	return oldestFirst(records.filter((r) => r.deletionClaim === void 0 && r.deviceTypeIdentifier === deviceTypeIdentifier && r.runtimeIdentifier === runtimeIdentifier));
+}
+function evictOverflow(records, max) {
+	if (records.length <= max) return {
+		keep: [...records],
+		evicted: []
+	};
+	const ordered = oldestFirst(records);
+	const evicted = ordered.slice(0, ordered.length - max);
+	const dropped = new Set(evicted.map((r) => r.udid));
+	return {
+		keep: records.filter((r) => !dropped.has(r.udid)),
+		evicted
+	};
 }
-function isProviderPlugin(plugin) {
-	if (!plugin || typeof plugin !== "object") return false;
-	const p = plugin;
-	const resolves = typeof p.resolveBuildCache === "function" || typeof p.resolveRemoteBuildCache === "function";
-	const uploads = typeof p.uploadBuildCache === "function" || typeof p.uploadRemoteBuildCache === "function";
-	return resolves && uploads;
+function parkSim({ platform, projectPath, slot = "default", record, max }) {
+	return withConfigLock(() => {
+		const cfg = ensureConfig();
+		const current = deviceSlotPlatforms(cfg.projects[projectPath], slot)?.[platform];
+		const currentId = platform === "ios" ? current?.deviceUdid : current?.avdName;
+		if (!current?.owned || currentId !== record.udid) throw new Error(`The ${platform === "ios" ? "simulator" : "emulator"} assignment changed before parking.`);
+		const { keep, evicted } = evictOverflow([...readParked(platform, { config: cfg }).filter((r) => r.udid !== record.udid), record], max);
+		writeParked(cfg, platform, [...keep, ...evicted]);
+		const project = cfg.projects[projectPath];
+		if (project) removeSlotDevice(project, platform, slot);
+		saveConfig(cfg);
+		return evicted;
+	});
 }
-function cacheLevel(value) {
-	return value === "local" || value === "remote" ? value : false;
+function adoptParked({ platform, projectPath, slot = "default", udid, device }) {
+	return withConfigLock(() => {
+		const cfg = ensureConfig();
+		const records = readParked(platform, { config: cfg });
+		const taken = records.find((r) => r.udid === udid);
+		if (!taken || taken.deletionClaim !== void 0) return null;
+		if (deviceSlotPlatforms(cfg.projects[projectPath], slot)?.[platform]) return null;
+		writeParked(cfg, platform, records.filter((r) => r.udid !== udid));
+		const project = cfg.projects[projectPath];
+		if (!project) throw new Error(`Project not registered: ${projectPath}`);
+		assignSlotDevice(project, platform, device, slot);
+		saveConfig(cfg);
+		return taken;
+	});
 }
-function exitAfterFlush(code = 0, { exit = (c) => process.exit(c), stream = process.stdout } = {}) {
+function isProcessAlive(pid) {
 	try {
-		stream.write("", () => exit(code));
-	} catch {
-		exit(code);
+		process.kill(pid, 0);
+		return true;
+	} catch (error) {
+		return error.code === "EPERM";
 	}
 }
-function readProjectConfig(root, { run = null, timeoutMs = CONFIG_TIMEOUT_MS } = {}) {
-	const dynamic = dynamicConfigFile(root);
-	if (!dynamic) {
-		const file = join(root, "app.json");
-		if (!existsSync(file)) return {
-			config: null,
-			source: null
+function parseDeletionClaim(value) {
+	if (value === null || typeof value !== "object" || Array.isArray(value)) return null;
+	const claim = value;
+	if (!Number.isSafeInteger(claim.pid) || claim.pid <= 0) return null;
+	if (typeof claim.token !== "string" || claim.token.length === 0) return null;
+	return {
+		pid: claim.pid,
+		token: claim.token
+	};
+}
+function claimParkedRemoval(platform, udid) {
+	return withConfigLock(() => {
+		const cfg = loadConfig();
+		if (!cfg) return null;
+		const records = readParked(platform, { config: cfg });
+		const record = records.find((candidate) => candidate.udid === udid);
+		if (!record) return null;
+		const existingClaim = parseDeletionClaim(record.deletionClaim);
+		if (record.deletionClaim !== void 0 && (!existingClaim || isProcessAlive(existingClaim.pid))) return null;
+		const token = randomUUID();
+		const claimedRecord = {
+			...record,
+			deletionClaim: {
+				pid: process.pid,
+				token
+			}
 		};
-		try {
-			return {
-				config: JSON.parse(readFileSync(file, "utf-8")),
-				source: "app.json"
-			};
-		} catch (err) {
-			return { unavailable: `app.json could not be parsed: ${firstLine(err)}` };
-		}
-	}
-	const bin = expoBinPath(root);
-	if (!bin) return { unavailable: `${dynamic} is code, so it has to be evaluated to read its buildCacheProvider, and the \`expo\` package is not resolvable from this project (no expo/package.json to read a bin from, and no node_modules/.bin/expo here or in any parent)` };
-	const exec = run || ((file, args, opts) => getExecutor().runFile(file, args, opts));
-	let stdout;
-	try {
-		stdout = exec(bin, [
-			"config",
-			"--json",
-			root
-		], { timeoutMs });
-	} catch (err) {
-		return { unavailable: `\`expo config --json\` failed: ${firstLine(err)}` };
-	}
-	try {
+		writeParked(cfg, platform, records.map((candidate) => candidate.udid === udid ? claimedRecord : candidate));
+		saveConfig(cfg);
+		const claimed = { ...record };
+		delete claimed.deletionClaim;
 		return {
-			config: JSON.parse(String(stdout)),
-			source: dynamic
+			record: claimed,
+			token
 		};
-	} catch (err) {
-		return { unavailable: `\`expo config --json\` did not print JSON: ${firstLine(err)}` };
-	}
-}
-async function loadPlugin(projectRoot, reference, { requireFrom = null } = {}) {
-	const localRequire = requireFrom ? requireFrom(projectRoot) : createRequire(join(projectRoot, "package.json"));
-	const file = localRequire.resolve(reference);
-	let mod;
-	try {
-		mod = localRequire(file);
-	} catch (err) {
-		if (err?.code !== "ERR_REQUIRE_ESM") throw err;
-		mod = await import(pathToFileURL(file).href);
-	}
-	const plugin = mod?.default ?? mod;
-	if (!isProviderPlugin(plugin)) throw new Error(`"${reference}" does not export resolveBuildCache and uploadBuildCache functions`);
-	return plugin;
+	});
 }
-async function loadProjectProvider(projectRoot, { isExpo = true, run = null, requireFrom = null, timeoutMs = CONFIG_TIMEOUT_MS } = {}) {
-	if (!isExpo) return { none: true };
-	const read = readProjectConfig(projectRoot, {
-		run,
-		timeoutMs
+function clearParkedRemovalClaim(platform, udid, token) {
+	withConfigLock(() => {
+		const cfg = loadConfig();
+		if (!cfg) return;
+		const records = readParked(platform, { config: cfg });
+		const record = records.find((candidate) => candidate.udid === udid);
+		if (!record || parseDeletionClaim(record.deletionClaim)?.token !== token) return;
+		const restored = { ...record };
+		delete restored.deletionClaim;
+		writeParked(cfg, platform, records.map((candidate) => candidate.udid === udid ? restored : candidate));
+		saveConfig(cfg);
 	});
-	if (read.unavailable) return { unavailable: read.unavailable };
-	const normalized = normalizeProvider(providerFromConfig(read.config));
-	if (!normalized) return { none: true };
-	if (normalized.invalid) return { unavailable: `buildCacheProvider is ${normalized.invalid}, which is not "eas" or { plugin: <module> }` };
-	if (normalized.reference === "@stim-cli/expo-build-cache") return { none: true };
-	let plugin;
-	try {
-		plugin = await loadPlugin(projectRoot, normalized.reference, { requireFrom });
-	} catch (err) {
-		const missing = err?.code === "MODULE_NOT_FOUND";
-		return { unavailable: normalized.name === "eas" && missing ? `the EAS build cache needs the \`${EAS_PROVIDER_PACKAGE}\` package, which is not installed in this project` : `${normalized.name} could not be loaded: ${firstLine(err)}` };
-	}
-	return {
-		provider: {
-			plugin,
-			options: normalized.options ?? {}
-		},
-		name: normalized.name,
-		owner: ownerFromConfig(read.config)
-	};
 }
-const WHOAMI_TIMEOUT_MS = 15e3;
-const EAS_CLI_PACKAGE = "eas-cli";
-const EAS_CLI_BIN = "eas";
-function parseWhoami({ stdout = "", stderr = "", exitCode = 0 } = {}) {
-	const out = stripAnsi(stdout);
-	const combined = `${out}\n${stripAnsi(stderr)}`;
-	if (/^\s*Not logged in\s*$/m.test(combined)) return { loggedOut: true };
-	if (exitCode !== 0) return { unknown: firstLine(combined.trim() || `eas whoami exited ${exitCode}`) };
-	const lines = out.split("\n").map((line) => line.trim()).filter((line) => line !== "");
-	if (lines.length === 0) return { unknown: "eas whoami printed nothing" };
-	const raw = lines[0];
-	if (raw === void 0) return { unknown: "eas whoami printed nothing" };
-	const viaToken = /\(authenticated using EXPO_TOKEN\)\s*$/.test(raw);
-	const display = raw.replace(/\s*\(authenticated using EXPO_TOKEN\)\s*$/, "").trim();
-	const accounts = [];
-	for (const line of lines) {
-		const name = /^\u2022\s*(\S+)\s*\(Role:/.exec(line)?.[1];
-		if (name !== void 0) accounts.push(name);
+function removeParkedAfter(platform, udid, beforeRemove) {
+	const claim = claimParkedRemoval(platform, udid);
+	if (!claim) return null;
+	try {
+		beforeRemove(claim.record);
+	} catch (error) {
+		try {
+			clearParkedRemovalClaim(platform, udid, claim.token);
+		} catch {}
+		throw error;
 	}
-	if (accounts.length === 0 && !display.endsWith("(robot)") && display !== "robot") accounts.push(display);
-	return {
-		loggedIn: true,
-		account: display,
-		accounts: accounts.length ? accounts : null,
-		viaToken
-	};
-}
-function isEasAuthFailureText(text) {
-	const t = stripAnsi(text || "");
-	if (t.trim() === "") return false;
-	return /not logged in/i.test(t) || /\beas login\b/i.test(t) || /EXPO_TOKEN/.test(t) || /unauthorized/i.test(t) || /not authorized/i.test(t) || /authentication (failed|required)/i.test(t);
-}
-function easAuthNote(status) {
-	const { code, account, owner, reason, phase = "resolve" } = status || {};
-	const because = reason ? ` (${reason})` : "";
-	if (code === "logged-out") return `eas is not authenticated${because} -- run \`eas login\` (or set EXPO_TOKEN); ` + (phase === "upload" ? "this build stayed in the local cache" : "building with the local cache only");
-	if (code === "wrong-account") return `eas is authenticated as ${account}, and this project's owner is ${owner} -- run \`eas login\` as a member of ${owner} (or set EXPO_TOKEN); consulting the EAS cache anyway`;
-	return null;
+	return withConfigLock(() => {
+		const cfg = loadConfig();
+		if (!cfg) return null;
+		const records = readParked(platform, { config: cfg });
+		if (parseDeletionClaim(records.find((candidate) => candidate.udid === udid)?.deletionClaim)?.token !== claim.token) return null;
+		writeParked(cfg, platform, records.filter((candidate) => candidate.udid !== udid));
+		saveConfig(cfg);
+		return claim.record;
+	});
 }
-function resolveEasCliBin(projectRoot, { lookupPath = null, timeoutMs = 5e3 } = {}) {
-	const fromPackage = expoBinFromPackage(resolvePackageJson(projectRoot, EAS_CLI_PACKAGE), EAS_CLI_BIN);
-	if (fromPackage) return {
-		file: fromPackage,
-		source: "project"
-	};
-	const shim = findBinUpward(projectRoot, EAS_CLI_BIN);
-	if (shim) return {
-		file: shim,
-		source: "project"
-	};
-	const onPath = lookupPath ? lookupPath() : getExecutor().runQuiet(`command -v ${EAS_CLI_BIN}`, { timeoutMs });
-	const file = (String(onPath || "").split("\n")[0] ?? "").trim();
-	return file ? {
-		file,
-		source: "path"
-	} : null;
+function dropParked(platform, udid) {
+	return removeParkedAfter(platform, udid, () => {}) !== null;
 }
-const easAuthCache = /* @__PURE__ */ new Map();
-function checkEasAuth({ projectRoot, owner = null, run = null, resolveBin = null, timeoutMs = WHOAMI_TIMEOUT_MS, cache = easAuthCache }) {
-	const key = `${projectRoot}::${owner || ""}`;
-	if (cache?.has(key)) return cache.get(key);
-	const answer = probeEasAuth({
-		projectRoot,
-		owner,
-		run,
-		resolveBin,
-		timeoutMs
+//#endregion
+//#region src/agent-device-cleanup.ts
+function parseAgentDeviceSessions(output) {
+	const result = JSON.parse(output);
+	if (result?.success !== true || !Array.isArray(result.data?.sessions)) throw new Error("agent-device did not return a successful session list");
+	return result.data.sessions.flatMap((entry) => {
+		if (!entry || typeof entry !== "object") return [];
+		const row = entry;
+		const id = row.platform === "ios" ? row.device_udid : row.id;
+		if (row.platform !== "ios" && row.platform !== "android" || typeof row.name !== "string" || !row.name.trim() || typeof id !== "string" || !id || typeof row.createdAt !== "number" || !Number.isFinite(row.createdAt) || row.platform === "ios" && row.id !== void 0 && row.id !== id) return [];
+		return [{
+			name: row.name,
+			platform: row.platform,
+			id,
+			createdAt: row.createdAt
+		}];
 	});
-	cache?.set(key, answer);
-	return answer;
 }
-function probeEasAuth({ projectRoot, owner, run, resolveBin, timeoutMs }) {
-	const bin = (resolveBin || resolveEasCliBin)(projectRoot);
-	if (!bin) return {
-		failed: true,
-		code: "no-cli",
-		reason: "no `eas` executable is resolvable from this project or on PATH",
-		remedy: "Install eas-cli (`npm i -g eas-cli`, or as a project devDependency), then run `eas login`."
+function report(message) {
+	process.stderr.write(`${phaseLine("device", message)}\n`);
+}
+function closeOwnedDeviceSessions(device, stillOwned) {
+	const exec = getExecutor();
+	const deadline = Date.now() + 15e3;
+	const run = (args) => {
+		const remaining = deadline - Date.now();
+		if (remaining <= 0) throw new Error("agent-device cleanup timed out");
+		return exec.runFile("agent-device", [
+			...args,
+			"--json",
+			"--daemon-transport",
+			"socket"
+		], {
+			timeoutMs: Math.min(5e3, remaining),
+			killSignal: "SIGKILL"
+		});
 	};
-	const exec = run || ((file, args, opts) => getExecutor().runFile(file, args, opts));
-	let result;
+	const list = () => parseAgentDeviceSessions(run([
+		"session",
+		"list",
+		"--session",
+		"stim-teardown-inventory"
+	]));
 	try {
-		result = {
-			stdout: String(exec(bin.file, ["whoami"], { timeoutMs }) ?? ""),
-			exitCode: 0
+		if (!exec.runQuiet("command -v agent-device", {
+			timeoutMs: 2e3,
+			killSignal: "SIGKILL"
+		})) return;
+		const sessions = list().filter((session) => session.platform === device.platform && session.id === device.id);
+		for (const session of sessions) try {
+			if (!list().some((current) => current.name === session.name && current.platform === session.platform && current.id === session.id && current.createdAt === session.createdAt)) continue;
+			if (!stillOwned()) return;
+			if (JSON.parse(run([
+				"close",
+				"--session",
+				session.name,
+				"--session-lock",
+				"reject",
+				"--platform",
+				device.platform,
+				device.platform === "ios" ? "--udid" : "--serial",
+				device.id
+			]))?.success !== true) throw new Error("agent-device did not confirm session close");
+			report(`closed agent-device session ${session.name} on ${device.id}`);
+		} catch (error) {
+			report(`could not close agent-device session ${session.name} on ${device.id}: ${error.message}`);
+		}
+	} catch (error) {
+		report(`could not list agent-device sessions for ${device.id}: ${error.message}`);
+	}
+}
+//#endregion
+//#region src/teardown.ts
+function teardownParkedAvd(avdName) {
+	try {
+		return removeParkedAfter("android", avdName, () => {
+			const result = teardownOwnedAvd(avdName, {
+				del: true,
+				owner: { pool: true }
+			});
+			if (result.status !== "torn-down" && result.status !== "missing") throw new Error(result.reason);
+		}) ? {
+			status: "torn-down",
+			label: avdName
+		} : {
+			status: "skipped",
+			kind: "not-parked",
+			reason: "emulator is no longer parked"
 		};
-	} catch (e) {
-		const err = e;
-		if (err?.code === "ETIMEDOUT" || err?.signal === "SIGTERM" || err?.killed) return { unknown: `eas whoami timed out after ${timeoutMs}ms` };
-		result = {
-			stdout: String(err?.stdout ?? ""),
-			stderr: String(err?.stderr ?? err?.message ?? ""),
-			exitCode: typeof err?.status === "number" ? err.status : 1
+	} catch (error) {
+		return {
+			status: "failed",
+			reason: String(error?.message || error)
 		};
 	}
-	const parsed = parseWhoami(result);
-	if (parsed.loggedOut) return {
-		failed: true,
-		code: "logged-out",
-		reason: "eas whoami says \"Not logged in\"",
-		remedy: "Run `eas login` (or set EXPO_TOKEN)."
-	};
-	if (parsed.unknown) return { unknown: parsed.unknown };
-	if (owner && Array.isArray(parsed.accounts) && !parsed.accounts.includes(owner)) return {
-		failed: true,
-		code: "wrong-account",
-		account: parsed.account,
-		accounts: parsed.accounts,
-		owner,
-		reason: `eas is authenticated as ${parsed.account} (accounts: ${parsed.accounts.join(", ")}), which does not include this project's owner ${owner}`,
-		remedy: `Run \`eas login\` as a member of ${owner}, or set EXPO_TOKEN to a token for it.`
-	};
-	return {
-		ok: true,
-		account: parsed.account,
-		accounts: parsed.accounts,
-		viaToken: parsed.viaToken,
-		source: bin.source
-	};
 }
-const capturing = [];
-const abandoned = /* @__PURE__ */ new Set();
-let patched = null;
-const PROVIDER_CONTEXT = new AsyncLocalStorage();
-function uploadDestination(lines) {
-	const text = (lines || []).map(stripAnsi);
-	for (const line of text) {
-		const url = /(https?:\/\/[^\s'"]+)/.exec(line)?.[1];
-		if (url !== void 0) return url.replace(/[.,)\]]+$/, "");
-	}
-	for (const line of text) {
-		const slug = /\bto\s+(@?[\w.-]+\/[\w.-]+)/i.exec(line)?.[1];
-		if (slug !== void 0) return slug.replace(/[.,)\]]+$/, "");
+function teardownParkedIosSim(udid, { label, deleteSim = deleteParkedIosSim } = {}) {
+	try {
+		const removed = removeParkedAfter("ios", udid, () => {
+			closeOwnedDeviceSessions({
+				platform: "ios",
+				id: udid
+			}, () => Boolean(resolveOwnedIosSim(udid).sim));
+			deleteSim(udid);
+		});
+		if (!removed) return {
+			status: "skipped",
+			kind: "not-parked",
+			reason: "simulator is no longer parked"
+		};
+		return {
+			status: "torn-down",
+			label: label ?? removed.name
+		};
+	} catch (error) {
+		return {
+			status: "failed",
+			reason: String(error?.message || error)
+		};
 	}
-	return null;
 }
-function providerNote(text) {
-	return `${"cache".padEnd(11)} ${text}`;
-}
-function currentFrame() {
-	const store = PROVIDER_CONTEXT.getStore();
-	return store && (capturing.includes(store) || abandoned.has(store)) ? store : null;
-}
-function install() {
-	if (patched && process.stdout.write === patched.patchedWrite) return;
-	const stdout = process.stdout;
-	const write = stdout.write.bind(stdout);
-	const log = console.log;
-	const passthrough = write;
-	const patchedWrite = ((chunk, encoding, callback) => {
-		const frame = currentFrame();
-		if (!frame) return passthrough(chunk, encoding, callback);
-		const cb = typeof encoding === "function" ? encoding : callback;
-		absorb(frame, typeof chunk === "string" ? chunk : String(chunk));
-		if (typeof cb === "function") cb();
-		return true;
+function parkOwnedIosSim(udid, park) {
+	const resolved = resolveOwnedIosSim(udid);
+	if (resolved.missing) throw new Error(`simulator ${udid} disappeared after shutdown`);
+	if (resolved.notOwned) throw new Error(`simulator ${udid} is now named ${JSON.stringify(resolved.notOwned)}`);
+	const sim = resolved.sim;
+	if (sim.state !== "Shutdown") throw new Error(`simulator ${udid} is still ${sim.state} after shutdown`);
+	const model = listIosDeviceTypes().find((d) => d.identifier === sim.deviceTypeIdentifier)?.name ?? null;
+	const runtime = parseRuntimeVersion(sim.runtime);
+	if (park.bundleId) {
+		if (!sim.dataPath) throw new Error(`simulator ${udid} did not report a data path for app cleanup`);
+		const container = findAppDataContainer(sim.dataPath, park.bundleId);
+		if (container) clearAppDataContainer(container);
+	}
+	const name = parkedSimName(sim.udid, {
+		model,
+		runtime
 	});
-	const patchedLog = (...args) => {
-		const frame = currentFrame();
-		if (!frame) return log(...args);
-		absorb(frame, `${format(...args)}\n`);
+	renameIosSim(sim.udid, name);
+	const record = {
+		udid: sim.udid,
+		name,
+		deviceTypeIdentifier: sim.deviceTypeIdentifier,
+		runtimeIdentifier: sim.runtime,
+		parkedAt: (/* @__PURE__ */ new Date()).toISOString(),
+		simslimManaged: Boolean(park.simslimManaged),
+		...park.bundleId ? { bundleId: park.bundleId } : {},
+		...park.cacheKey ? { cacheKey: park.cacheKey } : {}
 	};
-	stdout.write = patchedWrite;
-	console.log = patchedLog;
-	patched = {
-		stdout,
-		write,
-		log,
-		patchedWrite,
-		patchedLog
+	return {
+		record,
+		evicted: parkSim({
+			platform: "ios",
+			projectPath: park.projectPath,
+			slot: park.slot,
+			record,
+			max: park.max
+		})
 	};
 }
-function uninstall() {
-	if (!patched || capturing.length || abandoned.size) return;
-	if (patched.stdout.write === patched.patchedWrite) patched.stdout.write = patched.write;
-	if (console.log === patched.patchedLog) console.log = patched.log;
-	patched = null;
-}
-function absorb(frame, chunk) {
-	try {
-		process.stderr.write(chunk);
-	} catch {}
-	frame.pending += chunk;
-	let index = frame.pending.indexOf("\n");
-	while (index !== -1) {
-		emitLine(frame, frame.pending.slice(0, index));
-		frame.pending = frame.pending.slice(index + 1);
-		index = frame.pending.indexOf("\n");
-	}
-}
-function emitLine(frame, raw) {
-	const line = stripAnsi(raw).trim();
-	if (line === "") return;
-	frame.lines.push(line);
-	const writer = frame.writer();
+function teardownOwnedIosSim(udid, { del = false, label, park } = {}) {
+	let parkFallback;
 	try {
-		writer?.write({
-			src: "build",
-			level: "debug",
-			event: "provider",
-			msg: line
-		});
-	} catch {}
-	frame.onLine?.(line);
-}
-function beginCapture({ logWriter = null, projectRoot = null, platform = null, onLine = null } = {}) {
-	let own = null;
-	const frame = {
-		lines: [],
-		pending: "",
-		onLine,
-		writer: () => {
-			if (logWriter) return logWriter;
-			if (own) return own;
-			if (!projectRoot || !platform) return null;
-			own = createNdjsonWriter(join(workspaceLogsDir(projectRoot), `build-${platform}.ndjson`));
-			return own;
-		},
-		close: () => {
-			own?.close?.();
-			own = null;
+		const resolved = resolveOwnedIosSim(udid);
+		if (resolved.notOwned) return {
+			status: "skipped",
+			kind: "not-owned",
+			reason: `sim is now named "${resolved.notOwned}", not Stim-owned by name`
+		};
+		if (resolved.missing) return { status: "missing" };
+		closeOwnedDeviceSessions({
+			platform: "ios",
+			id: udid
+		}, () => Boolean(resolveOwnedIosSim(udid).sim));
+		const current = resolveOwnedIosSim(udid);
+		if (current.missing) return { status: "missing" };
+		if (current.notOwned) return {
+			status: "skipped",
+			kind: "not-owned",
+			reason: "simulator ownership changed before shutdown"
+		};
+		shutdownIosSim(udid);
+		const sim = resolved.sim;
+		if (del && park && park.max > 0) try {
+			const { record, evicted } = parkOwnedIosSim(udid, park);
+			const removed = [];
+			const failures = [];
+			for (const entry of evicted) {
+				const result = teardownParkedIosSim(entry.udid, { label: entry.name });
+				if (result.status === "torn-down") removed.push({
+					udid: entry.udid,
+					name: entry.name
+				});
+				else if (result.status === "failed") failures.push(`could not delete evicted ${entry.name} (${entry.udid}): ${result.reason}`);
+			}
+			return {
+				status: "torn-down",
+				label: label ?? sim.name ?? udid,
+				parked: {
+					udid: record.udid,
+					name: record.name
+				},
+				evicted: removed,
+				...failures.length ? { evictionFailures: failures } : {}
+			};
+		} catch (e) {
+			parkFallback = String(e?.message || e);
 		}
-	};
-	capturing.push(frame);
-	install();
-	return frame;
-}
-function endCapture(frame) {
-	if (!frame) return;
-	const at = capturing.lastIndexOf(frame);
-	if (at !== -1) capturing.splice(at, 1);
-	abandoned.delete(frame);
-	if (frame.pending !== "") {
-		const rest = frame.pending;
-		frame.pending = "";
-		emitLine(frame, rest);
+		if (del) deleteIosSim(udid);
+		return {
+			status: "torn-down",
+			label: label ?? sim.name ?? udid,
+			...parkFallback ? { parkFallback } : {}
+		};
+	} catch (e) {
+		return {
+			status: "failed",
+			reason: String(e?.message || e),
+			...parkFallback ? { parkFallback } : {}
+		};
 	}
-	frame.close();
-	uninstall();
-}
-function abandonCapture(frame, work) {
-	if (!frame) return;
-	const at = capturing.lastIndexOf(frame);
-	if (at !== -1) capturing.splice(at, 1);
-	abandoned.add(frame);
-	Promise.resolve(work).then(() => endCapture(frame), () => endCapture(frame));
 }
-async function resolveRemote({ provider, platform, projectRoot, fingerprintHash, runOptions = null, timeoutMs = RESOLVE_TIMEOUT_MS, logWriter = null } = {}) {
-	if (!provider?.plugin || !fingerprintHash) return null;
-	const opts = runOptions || runOptionsFor(platform);
-	const outcome = await withBudget(async () => {
-		const props = {
-			fingerprintHash: await providerFingerprint({
-				provider,
-				platform,
-				projectRoot,
-				runOptions: opts
-			}) ?? fingerprintHash,
-			platform,
-			runOptions: opts,
-			projectRoot
-		};
-		return typeof provider.plugin.resolveBuildCache === "function" ? provider.plugin.resolveBuildCache(props, provider.options) : provider.plugin.resolveRemoteBuildCache(props, provider.options);
-	}, timeoutMs, {
-		logWriter,
-		projectRoot,
-		platform
+function removeOrphanedAvdDirectory(candidate, owner) {
+	const detached = withConfigLock(() => {
+		const current = listOrphanedAvdDirectories(candidate.name).find((entry) => entry.directory === candidate.directory);
+		if (!current || current.name !== candidate.name || current.dev !== candidate.dev || current.ino !== candidate.ino) throw new Error(`AVD data at ${candidate.directory} changed or is registered; it was kept.`);
+		const config = loadConfig();
+		if (!config) throw new Error("Cannot verify AVD references without a Stim config; the data was kept.");
+		for (const [projectPath, project] of Object.entries(config.projects)) for (const { platforms } of projectDeviceSlots(project)) {
+			if (platforms.android?.avdName !== candidate.name) continue;
+			if (!owner || !("projectPath" in owner) || owner.projectPath !== projectPath || !platforms.android.owned) throw new Error(`AVD ${candidate.name} is referenced by ${projectPath}; its data was kept.`);
+		}
+		if (readParked("android", { config }).some((entry) => entry.name === candidate.name) && !(owner && "pool" in owner)) throw new Error(`AVD ${candidate.name} is in the emulator pool; its data was kept.`);
+		assertOwnedAvdStopped(candidate.name, { resolveDirectory: () => candidate.directory });
+		const destination = join(dirname(candidate.directory), `stim-gc-${randomUUID()}.avd`);
+		renameSync(candidate.directory, destination);
+		return destination;
 	});
-	if (outcome.timedOut) return { timedOut: true };
-	if (outcome.error) return { failed: firstLine(outcome.error) };
-	const appPath = typeof outcome.value === "string" ? outcome.value.trim() : "";
-	if (!appPath) return null;
-	if (!existsSync(appPath)) return { failed: `returned ${appPath}, which does not exist` };
-	return { appPath };
+	const current = lstatSync(detached);
+	if (!current.isDirectory() || current.dev !== candidate.dev || current.ino !== candidate.ino) throw new Error(`Detached AVD data changed at ${detached}; it was kept.`);
+	try {
+		rmSync(detached, { recursive: true });
+	} catch (error) {
+		throw new Error(`Could not remove AVD data at ${detached}; retry gc --delete: ${error.message}`, { cause: error });
+	}
 }
-async function uploadRemote({ provider, platform, projectRoot, fingerprintHash, buildPath, runOptions = null, timeoutMs = UPLOAD_TIMEOUT_MS, logWriter = null, note = (line) => console.error(line) } = {}) {
-	if (!provider?.plugin || !fingerprintHash || !buildPath) return { skipped: true };
-	const opts = runOptions || runOptionsFor(platform);
-	let announced = false;
-	const onLine = (line) => {
-		if (announced) return;
-		const dest = uploadDestination([line]);
-		if (!dest) return;
-		announced = true;
-		note(providerNote(`uploading to ${dest}`));
+function teardownUnregisteredAvd(avdName, del, owner, surveyed) {
+	const candidates = surveyed ? [surveyed] : listOrphanedAvdDirectories(avdName);
+	if (candidates.length === 0) {
+		if (avdStorageRoots().some((root) => avdPathExists(join(root, `${avdName}.ini`)) || avdPathExists(join(root, `${avdName}.avd`)))) throw new Error(`AVD ${avdName} is not listed but its storage remains; it was kept.`);
+		return { status: "missing" };
+	}
+	if (!del) return {
+		status: "skipped",
+		reason: "AVD registration is missing; its data was kept."
 	};
-	const outcome = await withBudget(async () => {
-		const props = {
-			projectRoot,
-			platform,
-			fingerprintHash: await providerFingerprint({
-				provider,
-				platform,
-				projectRoot,
-				runOptions: opts
-			}) ?? fingerprintHash,
-			buildPath,
-			runOptions: opts
-		};
-		return typeof provider.plugin.uploadBuildCache === "function" ? provider.plugin.uploadBuildCache(props, provider.options) : provider.plugin.uploadRemoteBuildCache(props, provider.options);
-	}, timeoutMs, {
-		logWriter,
-		projectRoot,
-		platform,
-		onLine
-	});
-	if (outcome.timedOut) return { timedOut: true };
-	if (outcome.error) return { failed: firstLine(outcome.error) };
-	const destination = uploadDestination(outcome.lines);
-	return destination ? {
-		uploaded: true,
-		destination
-	} : { uploaded: true };
-}
-async function providerFingerprint({ provider, platform, projectRoot, runOptions }) {
-	if (typeof provider.plugin.calculateFingerprintHash !== "function") return null;
-	try {
-		const hash = await provider.plugin.calculateFingerprintHash({
-			projectRoot,
-			platform,
-			runOptions
-		}, provider.options);
-		return typeof hash === "string" && hash.trim() !== "" ? hash.trim() : null;
-	} catch {
-		return null;
+	for (const candidate of candidates) {
+		if (candidate.name !== avdName) throw new Error(`AVD data does not match ${avdName}; it was kept.`);
+		removeOrphanedAvdDirectory(candidate, owner);
 	}
+	return {
+		status: "torn-down",
+		label: avdName
+	};
 }
-async function withBudget(factory, ms, capture) {
-	let timer = null;
-	const timeout = new Promise((resolve) => {
-		timer = setTimeout(() => resolve(TIMED_OUT), ms);
-		timer?.unref?.();
-	});
-	const frame = beginCapture(capture || {});
-	const work = Promise.resolve().then(() => PROVIDER_CONTEXT.run(frame, factory)).then((value) => ({ value }), (error) => ({ error }));
+function teardownOwnedAvd(avdName, { del = false, park, owner, orphanedDirectory, waitForShutdown = waitForAndroidEmulatorShutdown, assertStopped = assertOwnedAvdStopped, resolveAvd = resolveOwnedAvdSerial } = {}) {
+	let parkFallback;
 	try {
-		const settled = await Promise.race([work, timeout]);
-		if (settled === TIMED_OUT) {
-			abandonCapture(frame, work);
-			return {
-				timedOut: true,
-				lines: frame.lines
+		if (!/^stim-[A-Za-z0-9._-]+$/.test(avdName)) return {
+			status: "skipped",
+			kind: "not-owned",
+			reason: `AVD ${avdName} is not Stim-owned by name`
+		};
+		const resolved = resolveAvd(avdName);
+		if (resolved.notOwned) return {
+			status: "skipped",
+			kind: "not-owned",
+			reason: `AVD ${avdName} is not Stim-owned by name`
+		};
+		if (resolved.missing) return teardownUnregisteredAvd(avdName, del, owner, orphanedDirectory);
+		if (orphanedDirectory) return {
+			status: "skipped",
+			reason: "AVD registration appeared; its data was kept."
+		};
+		const serial = resolved.serial;
+		if (serial) {
+			const stillOwned = () => {
+				const current = resolveAvd(avdName);
+				return !current.notOwned && !current.missing && current.serial === serial;
+			};
+			closeOwnedDeviceSessions({
+				platform: "android",
+				id: serial
+			}, stillOwned);
+			if (!stillOwned()) throw new Error(`Owned AVD ${avdName} changed before shutdown; it was kept.`);
+			waitForShutdown(avdName, (timeoutMs) => shutdownAndroidEmulator(serial, timeoutMs));
+		} else assertStopped(avdName);
+		if (del) {
+			const current = resolveAvd(avdName);
+			if (current.notOwned) return {
+				status: "skipped",
+				kind: "not-owned",
+				reason: `AVD ${avdName} is not Stim-owned by name`
 			};
+			if (current.missing) return teardownUnregisteredAvd(avdName, del, owner);
+			if (current.serial) throw new Error(`Owned AVD ${avdName} started again before deletion.`);
+			assertStopped(avdName);
+			if (park && park.max > 0) try {
+				const systemImage = ownedAvdSystemImage(avdName);
+				if (!systemImage || !park.configuration || !ownedAvdMatchesConfiguration(avdName, park.configuration)) throw new Error("the AVD has no verified creation configuration");
+				const evicted = parkSim({
+					platform: "android",
+					projectPath: park.projectPath,
+					slot: park.slot,
+					max: park.max,
+					record: {
+						udid: avdName,
+						name: avdName,
+						systemImage,
+						configuration: park.configuration,
+						parkedAt: (/* @__PURE__ */ new Date()).toISOString()
+					}
+				});
+				const removed = [];
+				const failures = [];
+				for (const entry of evicted) {
+					const result = teardownParkedAvd(entry.name);
+					if (result.status === "torn-down") removed.push({
+						udid: entry.name,
+						name: entry.name,
+						platform: "android"
+					});
+					else if (result.status === "failed") failures.push(`could not delete evicted ${entry.name}: ${result.reason}`);
+				}
+				return {
+					status: "torn-down",
+					label: avdName,
+					parked: {
+						udid: avdName,
+						name: avdName,
+						platform: "android"
+					},
+					evicted: removed,
+					...failures.length ? { evictionFailures: failures } : {}
+				};
+			} catch (error) {
+				parkFallback = String(error?.message || error);
+			}
+			const directory = ownedAvdDirectory(avdName);
+			const paths = avdStorageRoots().map((root) => join(root, `${avdName}.ini`));
+			if (directory) paths.push(directory);
+			deleteAvd(avdName);
+			const remaining = paths.filter(avdPathExists);
+			if (remaining.length) throw new Error(`AVD ${avdName} was only partially deleted; data remains at ${remaining.join(", ")}.`);
 		}
-		endCapture(frame);
 		return {
-			...settled,
-			lines: frame.lines
+			status: "torn-down",
+			label: avdName,
+			serial: resolved.serial ?? null,
+			...parkFallback ? { parkFallback } : {}
+		};
+	} catch (e) {
+		return {
+			status: "failed",
+			reason: String(e?.message || e)
 		};
-	} catch (err) {
-		endCapture(frame);
-		throw err;
-	} finally {
-		if (timer) clearTimeout(timer);
 	}
 }
-function firstLine(err) {
-	const line = (String(err?.message || err || "unknown error").trim().split("\n")[0] ?? "").trim();
-	return line.length > 200 ? `${line.slice(0, 197)}...` : line;
-}
 //#endregion
-export { selectParked as C, readParked as S, teardownParkedIosSim as _, easAuthNote as a, dropParked as b, loadProjectProvider as c, resolveEasCliBin as d, resolveRemote as f, teardownParkedAvd as g, teardownOwnedIosSim as h, checkEasAuth as i, ownerFromConfig as l, teardownOwnedAvd as m, UPLOAD_TIMEOUT_MS as n, exitAfterFlush as o, uploadRemote as p, cacheLevel as r, isEasAuthFailureText as s, RESOLVE_TIMEOUT_MS as t, providerFromConfig as u, POOL_SETTING_REMEDY as v, parkedMaxSetting as x, adoptParked as y };
+export { uploadRemote as C, resolveRemote as S, isEasAuthFailureText as _, POOL_SETTING_REMEDY as a, providerFromConfig as b, parkedMaxSetting as c, RESOLVE_TIMEOUT_MS as d, UPLOAD_TIMEOUT_MS as f, exitAfterFlush as g, easAuthNote as h, teardownParkedIosSim as i, readParked as l, checkEasAuth as m, teardownOwnedIosSim as n, adoptParked as o, cacheLevel as p, teardownParkedAvd as r, dropParked as s, teardownOwnedAvd as t, selectParked as u, loadProjectProvider as v, resolveEasCliBin as x, ownerFromConfig as y };