stim 1.20.1 → 1.20.2

package/dist/{gc-D5cz5G0k.mjs → gc-qWOMdnER.mjs}

@@ -1,24 +1,23 @@
-import { n as ownership_claim_exports, t as process_identity_exports } from "./process-identity-Biv3arCO.mjs";
-import { t as getExecutor } from "./exec-B81Qodjn.mjs";
-import { A as directorySize, D as withConfigLock$1, F as volumeRootFor, H as projectDeviceSlots, M as isOnMountedVolume, N as listMountedVolumes, S as removeProject, _ as loadConfig$1, j as formatBytes, k as acquireAvdClaim } from "./config-D0LhTY3S.mjs";
-import { d as removeExpiredLease, h as listBuildLocks } from "./device-lease-C309csaB.mjs";
-import { D as withDirLock$1, E as workspaceStateFile, s as workspaceLastUsed, x as workspaceDir } from "./workspace-state-CvgTFe-h.mjs";
-import { h as shortUdid, o as formatLongDuration, u as plural } from "./command-output-CPDq_90S.mjs";
-import { _ as detectIsExpo, r as findProjectRoot } from "./project-DX8fXyw_.mjs";
-import { A as listAvds, H as parseAvdSystemImage, I as ownedAvdDirectory, M as listOrphanedAvdDirectories, V as parseAvdDeviceProfile, _ as avdStorageRoots, at as POOL_SETTING_REMEDY, d as androidToolPath, dt as parkedMaxSetting, ft as readParked, it as isStimOwnedSim, j as listInstalledSystemImages, m as avdNameAbsent, o as androidHome, p as avdIniPaths, rt as isStimOwnedAvd } from "./android-DE8-JfGW.mjs";
-import { n as readCreatedDevices$1, t as forgetCreatedDevice } from "./created-devices-CXBMtoj5.mjs";
-import { C as recordGcResult, I as listBuildSlots, T as canonicalPath, a as collectWorkspaceOutputs, c as listWorkspaceDirs, f as withIdleWorkspace, i as collectOrphanedWorkspaces, l as rootPresence, n as WORKSPACE_OUTPUT_DIRS, o as deleteOrphanedWorkspaces, p as workspaceInUse, r as clearWorkspaceOutputs, s as isInsideWorkspaces, t as REBUILD_COST, u as sizeText, w as takeGcResults } from "./workspaces-C4kqIOlx.mjs";
-import { $ as memoryWorkPending, A as findStaleProjectDevices, B as previewScopedEmptying, C as deleteProjectDevices, D as eraseParkedDevices, E as deviceSweepIsScoped, F as includesParkedDevices, H as selectsBeyondCaches, I as includesRecordings, L as includesWorkspaceOutputs, M as withAndroidAvdSizes, N as emptyCaches, O as findOrphanedDevices, P as includesArchives, Q as memorySweepIsScoped, R as isWorkspacesScope, S as deleteParkedSims, T as describeUnverifiableDevices, U as trimCaches, V as selectCaches, W as parseArchiveSelector, X as memoryLines, Y as memoryCacheKind, Z as memoryScope, _ as DEVICE_LIST_TIMEOUT_MS, at as discoverCaches, b as collectParkedSims, d as collectIdleDevices, et as reclaimMemory, h as shutDownIdleDevices, j as unverifiedDeviceCommand, k as findStaleDeviceRecords, m as parseIdleDuration, nt as phase, p as idleDeviceLines, q as collectMemoryReport, st as sizeCaches, tt as scopedMemoryReport, v as collectDeviceLeases, w as describeParkedSims, x as deleteParkedAvds, y as collectParkedAvds, z as planCacheEmptying } from "./budget-RFbwFpG5.mjs";
-import { f as resolveEasCliBin } from "./remote-cache-fxcl5C-L.mjs";
-import { d as listAllIosSims } from "./ios-o896T9PE.mjs";
-import { C as parseSessionListPage, T as verifyStoppedSession, _ as findOrphanedOwnedSessions, b as isDefinitiveMissingSessionError, d as withRemoteSessionLock, f as withEasProjectLock, v as getSessionArgs, w as stopSessionArgs, x as listOwnedSessionsArgs, y as inspectSessionForTeardown } from "./device-remote-DjsNw8DD.mjs";
-import { a as removeEasSessionClaim, n as easMachineStateRoot$1, r as readEasSessionLedger$1 } from "./eas-session-ledger-DJDeL4Uq.mjs";
-import { r as readCollectors } from "./ownership-BrjepDiv.mjs";
-import { c as removeWorktrees, l as worktreePullRequestNote, n as previewMaintenance, s as collectWorktreeSweep, u as worktreeRemovalReason } from "./preview-BRLFRhTz.mjs";
-import { _ as reclaimProject, g as describeDereferenced, v as deleteSelectedArchives, y as sweepArchiveStaging } from "./worktree-DtRsh6go.mjs";
-import { i as getSwiftpmCacheUsage, n as swiftpmCacheLines, r as getAgentDeviceUsage, t as agentDeviceLines } from "./agent-device-usage-output-VPaOgGaF.mjs";
+import { A as acquireAvdClaim, D as withConfigLock$1, F as listMountedVolumes, L as volumeRootFor, M as directorySize, N as formatBytes, P as isOnMountedVolume, S as removeProject, W as projectDeviceSlots, _ as loadConfig$1, j as ownership_claim_exports, k as process_identity_exports } from "./config-BYDxlMY3.mjs";
+import { t as getExecutor } from "./exec-DqKo9GKJ.mjs";
+import { d as removeExpiredLease, h as listBuildLocks } from "./device-lease-BX1sJQ2E.mjs";
+import { D as withDirLock$1, E as workspaceStateFile, s as workspaceLastUsed, x as workspaceDir } from "./workspace-state-DJt_MMvf.mjs";
+import { h as shortUdid, o as formatLongDuration, u as plural } from "./command-output-BTy8hZ0F.mjs";
+import { _ as detectIsExpo, r as findProjectRoot } from "./project-_phNIJfs.mjs";
+import { A as listAvds, H as parseAvdSystemImage, I as ownedAvdDirectory, M as listOrphanedAvdDirectories, V as parseAvdDeviceProfile, _ as avdStorageRoots, at as POOL_SETTING_REMEDY, d as androidToolPath, dt as parkedMaxSetting, ft as readParked, it as isStimOwnedSim, j as listInstalledSystemImages, m as avdNameAbsent, o as androidHome, p as avdIniPaths, rt as isStimOwnedAvd } from "./android-Mz_Inn3w.mjs";
+import { n as readCreatedDevices$1, t as forgetCreatedDevice } from "./created-devices-Dzd5C2LF.mjs";
+import { C as recordGcResult, I as listBuildSlots, T as canonicalPath, a as collectWorkspaceOutputs, c as listWorkspaceDirs, f as withIdleWorkspace, i as collectOrphanedWorkspaces, l as rootPresence, n as WORKSPACE_OUTPUT_DIRS, o as deleteOrphanedWorkspaces, p as workspaceInUse, r as clearWorkspaceOutputs, s as isInsideWorkspaces, t as REBUILD_COST, u as sizeText, w as takeGcResults } from "./workspaces-C36s2jb9.mjs";
+import { $ as memoryWorkPending, A as findStaleProjectDevices, B as previewScopedEmptying, C as deleteProjectDevices, D as eraseParkedDevices, E as deviceSweepIsScoped, F as includesParkedDevices, H as selectsBeyondCaches, I as includesRecordings, L as includesWorkspaceOutputs, M as withAndroidAvdSizes, N as emptyCaches, O as findOrphanedDevices, P as includesArchives, Q as memorySweepIsScoped, R as isWorkspacesScope, S as deleteParkedSims, T as describeUnverifiableDevices, U as trimCaches, V as selectCaches, W as parseArchiveSelector, X as memoryLines, Y as memoryCacheKind, Z as memoryScope, _ as DEVICE_LIST_TIMEOUT_MS, at as discoverCaches, b as collectParkedSims, d as collectIdleDevices, et as reclaimMemory, h as shutDownIdleDevices, j as unverifiedDeviceCommand, k as findStaleDeviceRecords, m as parseIdleDuration, nt as phase, p as idleDeviceLines, q as collectMemoryReport, st as sizeCaches, tt as scopedMemoryReport, v as collectDeviceLeases, w as describeParkedSims, x as deleteParkedAvds, y as collectParkedAvds, z as planCacheEmptying } from "./budget-f7516Zk0.mjs";
+import { f as resolveEasCliBin } from "./remote-cache-OyOyVIS3.mjs";
+import { d as listAllIosSims } from "./ios-RkW4pnQf.mjs";
+import { C as parseSessionListPage, T as verifyStoppedSession, _ as findOrphanedOwnedSessions, b as isDefinitiveMissingSessionError, d as withRemoteSessionLock, f as withEasProjectLock, v as getSessionArgs, w as stopSessionArgs, x as listOwnedSessionsArgs, y as inspectSessionForTeardown } from "./device-remote-xRT0Vmo9.mjs";
+import { a as removeEasSessionClaim, n as easMachineStateRoot$1, r as readEasSessionLedger$1 } from "./eas-session-ledger-Cm0Gwq2F.mjs";
+import { r as readCollectors } from "./ownership-DCtw_2IA.mjs";
+import { c as removeWorktrees, l as worktreePullRequestNote, n as previewMaintenance, s as collectWorktreeSweep, u as worktreeRemovalReason } from "./preview-78a9kR_-.mjs";
+import { _ as reclaimProject, g as describeDereferenced, v as deleteSelectedArchives, y as sweepArchiveStaging } from "./worktree-CgvJYJ-Q.mjs";
+import { i as getSwiftpmCacheUsage, n as swiftpmCacheLines, r as getAgentDeviceUsage, t as agentDeviceLines } from "./agent-device-usage-output-Dzgv6lgR.mjs";
 import { existsSync, lstatSync, readFileSync, readdirSync, rmSync, statSync } from "node:fs";
-import { basename, dirname, join } from "node:path";
+import { basename, dirname, isAbsolute, join } from "node:path";
 import { basename as basename$1, dirname as dirname$1, isAbsolute as isAbsolute$1, join as join$1 } from "path";
 import { assertHostedDeviceLedger, deviceHostArea, deviceHostRoot, hostedDeviceId, isJsonObject, listRecordedDevices, listStatusCacheEntries, maintenanceRunClaims, parseHostedPlatformDevice, readArchives, readHostedDevice, readHostedDeviceLedger, readHostedSessions, recordedBytes } from "@stim-cli/core/state";
 import { fileURLToPath } from "node:url";
@@ -529,6 +528,40 @@ async function deleteEasSessions(easSessionSweep, deps) {
 	return deleteFailures;
 }
 //#endregion
+//#region src/commands/gc/eas-ledger.ts
+const UUID = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+/**
+* An entry is dropped only when its id cannot be an EAS session id and its workspace root is provably gone:
+* absolute, missing, and on a mounted volume, the same proof gc uses for dead project entries.
+*/
+function isStaleEasLedgerEntry(claim, mountedVolumes, exists = existsSync) {
+	if (UUID.test(claim.sessionId)) return false;
+	const root = claim.workspaceRoot;
+	if (!isAbsolute(root) || exists(root)) return false;
+	return isOnMountedVolume(root, mountedVolumes);
+}
+function findStaleEasLedgerEntries(mountedVolumes, deps = {}) {
+	const ledger = readEasSessionLedger$1(deps.easLedgerRoot ?? easMachineStateRoot$1());
+	if (!ledger.safe) return [];
+	return [...ledger.claims.values()].filter((claim) => isStaleEasLedgerEntry(claim, mountedVolumes)).map(({ sessionId, workspaceRoot }) => ({
+		id: sessionId,
+		workspaceRoot
+	}));
+}
+function forgetStaleEasLedgerEntries(entries, mountedVolumes, deps = {}) {
+	let failures = 0;
+	const root = deps.easLedgerRoot ?? easMachineStateRoot$1();
+	const remove = deps.removeEasSessionClaim ?? removeEasSessionClaim;
+	for (const entry of entries) try {
+		if (remove(entry.id, root, (claim) => isStaleEasLedgerEntry(claim, mountedVolumes))) console.log(chalk.green(`Forgot the EAS ledger entry ${entry.id} (invalid id, ${entry.workspaceRoot} is gone)`));
+		else console.log(chalk.dim(`Kept the EAS ledger entry ${entry.id}: it changed since the report.`));
+	} catch (error) {
+		failures++;
+		console.log(chalk.red(`Could not forget the EAS ledger entry ${entry.id}: ${describeError(error)}`));
+	}
+	return failures;
+}
+//#endregion
 //#region src/commands/gc/status-caches.ts
 const KINDS = ["disk-usage", "pull-request"];
 const KEPT_REASON = {
@@ -809,7 +842,15 @@ function maintenanceReportLines(maintenance) {
 	}
 	return lines;
 }
-function formatGcReport({ maintenance, archives, skipped = [], deadProjects = [], orphanedPorts, invalidProjects = [], orphanedWorkspaces = [], parkedSims = [], parkedAvds = [], parkedHostedDevices, orphanedDevices = [], unverifiedDevices = [], staleDevices = [], staleDeviceRecords = [], staleLedgerEntries = [], staleStatusCaches = [], buildLocks = {
+function staleEasLedgerLines(entries = []) {
+	if (!entries.length) return [];
+	return [
+		`Stale EAS ledger entries (${entries.length}) - the id is not a valid EAS session id and the workspace is gone:`,
+		...entries.map((entry) => `  ${entry.id} (workspace ${entry.workspaceRoot})`),
+		"              --delete forgets the LEDGER ENTRY only; no EAS session is contacted."
+	];
+}
+function formatGcReport({ maintenance, archives, skipped = [], deadProjects = [], orphanedPorts, invalidProjects = [], orphanedWorkspaces = [], parkedSims = [], parkedAvds = [], parkedHostedDevices, orphanedDevices = [], unverifiedDevices = [], staleDevices = [], staleDeviceRecords = [], staleLedgerEntries = [], staleEasLedgerEntries, staleStatusCaches = [], buildLocks = {
 	stale: [],
 	live: [],
 	unresolved: []
@@ -828,6 +869,7 @@ function formatGcReport({ maintenance, archives, skipped = [], deadProjects = []
 }, agentDeviceUsage = null, swiftpmCacheUsage, caches = [], workspaceOutputs = null, workspaceLogs = [], recordings = [], worktreeSweep = null, memory, cacheScope = null, olderThan = null }, { now = Date.now() } = {}) {
 	const lines = archiveLines(archives);
 	const parkedHostedLines = formatParkedHostedDeviceReport(parkedHostedDevices, now);
+	const easLedgerLines = staleEasLedgerLines(staleEasLedgerEntries);
 	const staleLocks = buildLocks?.stale ?? [];
 	const liveLocks = buildLocks?.live ?? [];
 	const staleSlots = buildSlots?.stale ?? [];
@@ -844,6 +886,7 @@ function formatGcReport({ maintenance, archives, skipped = [], deadProjects = []
 		staleDevices,
 		staleDeviceRecords,
 		staleLedgerEntries,
+		easLedgerLines,
 		staleStatusCaches,
 		staleLocks,
 		staleSlots,
@@ -901,6 +944,7 @@ function formatGcReport({ maintenance, archives, skipped = [], deadProjects = []
 		for (const entry of staleLedgerEntries) lines.push(`  ${entry.kind} ${entry.id} is not on this machine`);
 		lines.push("              --delete forgets the LEDGER ENTRY only; there is no device left to touch.");
 	}
+	lines.push(...easLedgerLines);
 	lines.push(...statusCacheLines(staleStatusCaches));
 	if (easSessionSweep.orphaned.length) {
 		lines.push(`Orphaned EAS sessions (${easSessionSweep.orphaned.length}) - current EAS project only:`);
@@ -1083,7 +1127,7 @@ function jsonPullRequest(lookup) {
 		containsHead: pr.containsHead
 	} : null;
 }
-function gcReportSections({ archives, skipped = [], deadProjects = [], orphanedPorts = [], invalidProjects = [], orphanedWorkspaces = [], worktreeSweep = null, parkedSims = [], parkedAvds = [], parkedHostedDevices = [], orphanedDevices = [], unverifiedDevices = [], staleDevices = [], staleDeviceRecords = [], staleLedgerEntries = [], staleStatusCaches = [], buildLocks = {
+function gcReportSections({ archives, skipped = [], deadProjects = [], orphanedPorts = [], invalidProjects = [], orphanedWorkspaces = [], worktreeSweep = null, parkedSims = [], parkedAvds = [], parkedHostedDevices = [], orphanedDevices = [], unverifiedDevices = [], staleDevices = [], staleDeviceRecords = [], staleLedgerEntries = [], staleEasLedgerEntries = [], staleStatusCaches = [], buildLocks = {
 	stale: [],
 	live: [],
 	unresolved: []
@@ -1180,6 +1224,10 @@ function gcReportSections({ archives, skipped = [], deadProjects = [], orphanedP
 			kind,
 			id
 		})),
+		staleEasLedgerEntries: staleEasLedgerEntries.map(({ id, workspaceRoot }) => ({
+			id,
+			workspaceRoot
+		})),
 		staleStatusCaches: staleStatusCaches.map(({ kind, path, file, bytes }) => ({
 			kind,
 			path,
@@ -2103,6 +2151,7 @@ async function collectGcReport({ olderThan = null, cache = null, worktrees = fal
 		staleDevices: [],
 		staleDeviceRecords: [],
 		staleLedgerEntries: [],
+		staleEasLedgerEntries: [],
 		staleStatusCaches: [],
 		buildLocks: {
 			stale: [],
@@ -2304,6 +2353,7 @@ async function collectGcReport({ olderThan = null, cache = null, worktrees = fal
 		staleDevices,
 		staleDeviceRecords,
 		staleLedgerEntries,
+		staleEasLedgerEntries: findStaleEasLedgerEntries(mountedVolumes, deps),
 		staleStatusCaches: statusCaches.stale,
 		buildLocks: {
 			stale: locks.filter((l) => !l.alive && !l.unresolved),
@@ -2588,7 +2638,7 @@ async function runGcCore(opts, deps) {
 	const all = report.all;
 	for (const line of formatGcReport(report)) console.log(line);
 	const { deadProjects, invalidProjects, orphanedDevices, staleDevices, staleDeviceRecords, buildLocks, buildSlots, deviceLeases, easSessionSweep, caches } = report;
-	const actionable = archiveWorkPending(report.archives, deadProjects.length + invalidProjects.length > 0 || report.orphanedWorkspaces.length > 0 || Boolean(report.workspaceOutputs?.workspaces.some((entry) => entry.willClear)) || report.workspaceLogs.some((entry) => entry.willTrim) || report.recordings.some((entry) => entry.willDelete && !entry.withWorkspace) || Boolean(report.worktreeSweep?.worktrees.some((entry) => !entry.skipped)) || report.parkedSims.length > 0 || report.parkedAvds.length + report.parkedHostedDevices.filter((device) => device.listed !== false).length > 0 || orphanedDevices.length > 0 || staleDevices.length > 0 || staleDeviceRecords.length > 0 || report.staleLedgerEntries.length > 0 || report.staleStatusCaches.length > 0 || buildLocks.stale.length > 0 || buildSlots.stale.length > 0 || deviceLeases.expired.length > 0 || easSessionSweep.orphaned.length > 0 || (olderThan !== null || all) && caches.length > 0 || memoryWorkPending(cache, report.memory));
+	const actionable = archiveWorkPending(report.archives, deadProjects.length + invalidProjects.length > 0 || report.orphanedWorkspaces.length > 0 || Boolean(report.workspaceOutputs?.workspaces.some((entry) => entry.willClear)) || report.workspaceLogs.some((entry) => entry.willTrim) || report.recordings.some((entry) => entry.willDelete && !entry.withWorkspace) || Boolean(report.worktreeSweep?.worktrees.some((entry) => !entry.skipped)) || report.parkedSims.length > 0 || report.parkedAvds.length + report.parkedHostedDevices.filter((device) => device.listed !== false).length > 0 || orphanedDevices.length > 0 || staleDevices.length > 0 || staleDeviceRecords.length > 0 || report.staleLedgerEntries.length + report.staleEasLedgerEntries.length > 0 || report.staleStatusCaches.length > 0 || buildLocks.stale.length > 0 || buildSlots.stale.length > 0 || deviceLeases.expired.length > 0 || easSessionSweep.orphaned.length > 0 || (olderThan !== null || all) && caches.length > 0 || memoryWorkPending(cache, report.memory));
 	const idle = opts.idle ?? null;
 	const idleFailures = idle === null ? 0 : shutDownIdleDevices(report.idleDevices, idle, () => collectIdleDevices(loadConfig$1(), listAllIosSims({ timeoutMs: DEVICE_LIST_TIMEOUT_MS }), report.deadProjects)).failures;
 	if (idleFailures) process.exitCode = 1;
@@ -2628,6 +2678,7 @@ async function runGcCore(opts, deps) {
 	deleteFailures += await deleteOrphanedWorkspaces(report.orphanedWorkspaces);
 	deleteFailures += deleteProjectDevices(orphanedDevices, staleDevices, staleDeviceRecords);
 	deleteFailures += forgetStaleLedgerEntries(report.staleLedgerEntries);
+	deleteFailures += forgetStaleEasLedgerEntries(report.staleEasLedgerEntries, listMountedVolumes(), deps);
 	deleteFailures += pruneStatusCaches(report);
 	for (const lock of buildLocks.stale) {
 		const cleared = (0, ownership_claim_exports.clearFreeClaimSet)({

package/dist/git-DDfFzkMm.mjs

@@ -0,0 +1,45 @@
+import { t as getExecutor } from "./exec-DqKo9GKJ.mjs";
+//#region src/workspace/git.ts
+const GIT_TIMEOUT_MS = 1e4;
+const GIT_CONCURRENCY = 6;
+function gitCall(cwd, args, { write, timeoutMs = GIT_TIMEOUT_MS, ...opts }) {
+	return {
+		args: [
+			...write ? [] : ["--no-optional-locks"],
+			"-C",
+			cwd,
+			...args
+		],
+		opts: {
+			...opts,
+			timeoutMs
+		}
+	};
+}
+/** Runs git in `cwd`, bounded by `timeoutMs` (10 s by default); throws like `runFile`. */
+function git(cwd, args, opts = {}) {
+	const call = gitCall(cwd, args, opts);
+	return getExecutor().runFile("git", call.args, call.opts);
+}
+/** `git`, returning null instead of throwing. */
+function gitQuiet(cwd, args, opts = {}) {
+	const call = gitCall(cwd, args, opts);
+	return getExecutor().runFileQuiet("git", call.args, call.opts);
+}
+const queue = [];
+let running = 0;
+/** `git` without blocking the event loop, at most six at a time; the budget starts when the call leaves the queue. */
+async function gitAsync(cwd, args, opts = {}) {
+	if (running < GIT_CONCURRENCY) running++;
+	else await new Promise((proceed) => queue.push(proceed));
+	try {
+		const call = gitCall(cwd, args, opts);
+		return await getExecutor().runFileAsync("git", call.args, call.opts);
+	} finally {
+		const next = queue.shift();
+		if (next) next();
+		else running--;
+	}
+}
+//#endregion
+export { gitAsync as n, gitQuiet as r, git as t };

package/dist/{gradle-CZZo1TSA.mjs → gradle-DSrXb6lG.mjs}

@@ -1,10 +1,10 @@
-import { t as getExecutor } from "./exec-B81Qodjn.mjs";
+import { t as getExecutor } from "./exec-DqKo9GKJ.mjs";
 import { n as stripAnsi, r as waitForChild, t as createLineReader } from "./process-output-Fpl8PYi8.mjs";
-import { l as phaseLine } from "./command-output-CPDq_90S.mjs";
-import { o as androidHome } from "./android-DE8-JfGW.mjs";
-import { a as spawnDeclared } from "./spawn-claims-Kqiifsk2.mjs";
-import { a as readCcacheActivity, n as CCACHE_UNAVAILABLE } from "./ccache-CtbqWxIC.mjs";
-import { M as startBuildHeartbeat, y as HEARTBEAT_INTERVAL_MS } from "./toolchain-SqehyPLw.mjs";
+import { l as phaseLine } from "./command-output-BTy8hZ0F.mjs";
+import { o as androidHome } from "./android-Mz_Inn3w.mjs";
+import { a as spawnDeclared } from "./spawn-claims-DVS5RkMS.mjs";
+import { a as readCcacheActivity, n as CCACHE_UNAVAILABLE } from "./ccache-zdKiYQ3E.mjs";
+import { M as startBuildHeartbeat, y as HEARTBEAT_INTERVAL_MS } from "./toolchain-DxSsNssu.mjs";
 import { existsSync, mkdirSync, readFileSync, readdirSync, rmSync, statSync } from "node:fs";
 import { dirname, isAbsolute, join, relative, sep } from "node:path";
 import { fileURLToPath } from "node:url";

package/dist/{guide-DakjcoUt.mjs → guide-G9cAbVAc.mjs}

@@ -1,8 +1,8 @@
-import { t as ANDROID_AVD_CONFIG_HELP } from "./settings-Bbztm4oV.mjs";
-import { r as findProjectRoot } from "./project-DX8fXyw_.mjs";
-import { s as RECENT_LAUNCH_MS } from "./watchman-CqmaGcIb.mjs";
-import { o as guideStatus, t as WATCHMAN_NESTED_WORKTREES } from "./doctor-watchman-XJzT8tK-.mjs";
-import "./status-watch-ZaVqRdtW.mjs";
+import { t as ANDROID_AVD_CONFIG_HELP } from "./settings-B717odTD.mjs";
+import { r as findProjectRoot } from "./project-_phNIJfs.mjs";
+import { s as RECENT_LAUNCH_MS } from "./watchman-CPQFZLXY.mjs";
+import { o as guideStatus, t as WATCHMAN_NESTED_WORKTREES } from "./doctor-watchman-BRyV2adA.mjs";
+import "./status-watch-C23ILtf9.mjs";
 import { SETTINGS, SETTINGS_SCHEMA_URL, TUTORIAL_VERSION } from "@stim-cli/core/state";
 import chalk from "chalk";
 //#region src/guide/agent.ts
@@ -1360,6 +1360,11 @@ RULES
                               root, and browser profile paths whose
                               directory is gone; --delete forgets the
                               ledger entry only
+    staleEasLedgerEntries   { id, workspaceRoot }  entries of the machine
+                              EAS session ledger whose id is not a UUID and
+                              whose absolute workspace root is missing on a
+                              mounted volume; --delete forgets the entry
+                              only and contacts no EAS session
     staleStatusCaches       { kind: "disk-usage" | "pull-request", path,
                               file, bytes }  entries of $STIM_HOME/disk-usage
                               and pull-requests whose path is gone from a
@@ -1506,6 +1511,8 @@ RULES
               absent until it has run.
   recording   { enabled }: whether stim-server may record the workspace's
               device screens for replay, from recording.enabled
+  hidden      true when workspace.hidden is set; absent otherwise. The next
+              command that uses the workspace clears it.
 
   Each environment also carries stage, where the workspace is as Stim
   Desktop and the phone app show it: { kind, since, platform, closedApps }.
@@ -6274,11 +6281,12 @@ A RUNNING APP IS RESTARTED, LIKE XCODE'S RUN
   A stop that fails refuses the launch rather than reusing the old process.
   When a simulator's process list cannot be read, Stim launches with
   \`simctl launch --terminate-running-process\`, which replaces any running
-  copy. When an emulator's cannot be read, Stim launches without stopping
-  anything and verification reports what it observes. An iPhone run
-  (\`ios --device\`) needs no extra step: its collector launches with
-  devicectl's \`--terminate-existing\`. Remote targets launch through
-  \`agent-device open --relaunch\`.
+  copy. When an Android device's cannot be read, Stim launches with
+  \`am start -S\`, which force-stops the app first; an app without a
+  launcher activity gets a best-effort \`am force-stop\` before \`monkey\`.
+  Neither claims a restart. An iPhone run (\`ios --device\`) needs no extra
+  step: its collector launches with devicectl's \`--terminate-existing\`.
+  Remote targets launch through \`agent-device open --relaunch\`.
 
 RUNTIME STATE AND BUILD INPUTS
 Runtime state is stored outside the project tree under
@@ -8076,6 +8084,14 @@ THE MIRROR IMAGE: A STALE DEVICE RECORD
   runs still counts as this home's; run \`gc\` after deleting a Stim AVD by
   hand.
 
+  The machine EAS session ledger (~/.stim/machine/eas/sessions.json) can hold
+  entries that no EAS session ever had, such as ids written by a test
+  fixture. \`gc\` reports an entry under "Stale EAS ledger entries" only when
+  its id is not a UUID AND its workspace root is an absolute path that is
+  missing on a mounted volume. A valid id, an existing root, or a root on an
+  unmounted volume keeps the entry. \`gc --delete\` re-checks each entry and
+  removes it under the ledger lock; it never contacts EAS.
+
 THE ONE CASE GC WILL NOT REAP
   If the config is gone entirely (deleted ~/.stim, or a throwaway
   STIM_HOME), gc cannot tell your stale devices from another config's LIVE
@@ -9163,8 +9179,10 @@ The same \`remote.machines\` list names the Macs that may build for this one:
 node in $STIM_HOME/build-machines.json. A person approves the request on that
 Mac with \`stim-server devices grant <id> --build\`; doctor prints the id.
 A person can instead run \`stim-server setup\` on the worker with a node,
-ticket and expiry, under the approval rule above. Build never includes read
-or control.
+ticket and expiry, under the approval rule above. A build grant is full access
+to the account stim-server runs as: project code runs there unsandboxed, so it
+can grant itself read and control. Revoking it does not undo what that code
+already did. Grant it only to Macs you trust.
 Stim connects to a named Mac only while its name still belongs to the pinned
 node and never sends the token to another node. \`doctor\` reports each
 remote Mac's build pairing state and, for an approved one, asks it for one build
@@ -9366,6 +9384,19 @@ them within seconds, as soon as \`stim status\` shows recording.enabled false
 for them. Turning it back on records from then on. See \`guide cleanup\` for
 how recordings are removed otherwise.
 
+HIDE A WORKSPACE IN THE APPS
+\`workspace.hidden\` is a boolean, false by default, set only at workspace
+scope, so it needs no --scope. Run it from the workspace:
+
+  stim settings set workspace.hidden true
+  stim settings unset workspace.hidden
+
+\`stim status --json\` then reports hidden: true on that environment, and
+clients that read it list the workspace under Hidden. The next start, ios,
+android, web, macos, reload or worktree warm in the workspace clears it, so
+a workspace in use is never hidden. \`worktree remove\` drops it with the
+workspace.
+
 STIM NEEDS NO PROJECT CHANGES TO RUN
 Nothing above is required to use Stim. The performance caches that used to
 be setup steps are supplied by Stim on the command lines it composes itself:
@@ -9592,7 +9623,11 @@ FileStore shards across 256 directories, a build cache is keyed
 platform instead of one entry. Pass prune: 'atomic' for a cache whose index
 references its own data (an LLVM CAS): it is then left alone by --older-than
 and emptied whole only by 'gc --delete --cache all'.
-Registration is idempotent and keyed on the directory.`
+Registration is idempotent and keyed on the directory.
+dir must be absolute (a leading ~ is expanded) and dedicated to the cache.
+register throws for a path that is or contains the home directory, the system
+temporary directory, the Stim config directory or a filesystem root, and gc
+never prunes or empties such a directory.`
 };
 //#endregion
 //#region src/guide/web.ts
@@ -9955,8 +9990,11 @@ attempt falls back here. Placement and failure reasons are in build logs.
 
 AGENT ACTIONS
 
-Launch through stim macos first. Use its isolated bundleId from the JSON
-launch record or status --json:
+Launch through stim macos first. Use its isolated bundleId from the JSON launch
+record or status --json. stim macos waits, for up to 20 seconds, until macOS
+LaunchServices lists the app, so agent-device open attaches to it instead of
+starting a second copy. If it is still unlisted, stim macos warns and returns;
+wait before opening. A --remote launch skips the wait:
 
   agent-device open <bundleId> --platform macos --surface app --foreground
   agent-device click <ref> --settle
@@ -10262,7 +10300,7 @@ const TUTORIAL_ASKS = {
 	build: "Make the title purple in the Stim tutorial app and check it on the simulator.",
 	parallel: "While that builds, make the Tap me button green in a new worktree and check it on the simulator.",
 	finish: "I'm done with these experiments in {base} and don't need the changes. Stop the apps and remove the worktrees {worktrees}, and keep the clone. Follow stim guide tutorial finish.",
-	delete: "Remove the Stim tutorial: remove its worktrees and the clone at {base} with stim worktree remove, then delete {base}. Follow stim guide tutorial delete.",
+	delete: "Remove the test app: run stim worktree remove on {base}, then delete the folder. Follow stim guide tutorial delete.",
 	share: `Open a pull request to ${TUTORIAL_REPO} with my title color change, with before and after screenshots from the simulator. See stim guide tutorial share.`,
 	retry: "The first iOS build of the tutorial app in {tour} failed. Find out why and run it on iOS again."
 };
@@ -10371,8 +10409,8 @@ ${screenshots}
 
 Check each change on the device with agent-device in that same session, after
 the after screenshot, so Stim Desktop records your actions and the user can
-replay them: tap tap-button, toggle dark-accent-switch, type a name in
-name-input, then take a screenshot (agent-device screenshot
+replay them: tap tap-button, toggle dark-accent-switch, pick a size
+(size-s, size-m or size-l), then take a screenshot (agent-device screenshot
 .expo/screenshots/checked.png) and confirm the change. Refs expire after each
 action: run agent-device snapshot -i before every action and use the ref it
 reports for that testID. When agentDevice.installed is false in stim status

package/dist/{hosted-android-C-D8Dj0_.mjs → hosted-android-C3MHGld1.mjs}

@@ -1,6 +1,6 @@
-import { o as call, s as connectHost } from "./hosted-client--hNFgixu.mjs";
-import { i as requestHostedMetro } from "./metro-gateway-BzlQZQmU.mjs";
-import { n as prepareHostedNative, r as stopHostedNative, t as placeHostedNative } from "./hosted-native-3KXZ5-qn.mjs";
+import { c as connectHost, s as call } from "./hosted-client-ZEKpS9vw.mjs";
+import { i as requestHostedMetro } from "./metro-gateway-CX9Xlkq2.mjs";
+import { n as prepareHostedNative, r as stopHostedNative, t as placeHostedNative } from "./hosted-native-A4s1QPXe.mjs";
 //#region src/device-host/hosted-android.ts
 async function prepareHostedAndroid(machine, selectors, recorded, mode) {
 	return await prepareHostedNative(machine, selectors, recorded, "android", false, mode);

package/dist/{hosted-client--hNFgixu.mjs → hosted-client-ZEKpS9vw.mjs}

@@ -1,16 +1,19 @@
-import { c as pinnedEndpoint$1 } from "./tailnet-D7-tE_ug.mjs";
-import { t as BuildConnection, x as configuredMachines } from "./client-zqjFd79D.mjs";
+import { c as pinnedEndpoint$1 } from "./tailnet-Dh-qiYzG.mjs";
+import { r as throwIfCancelled, t as cancellableSleep } from "./cancellation-C_22VQTH.mjs";
+import { t as BuildConnection, x as configuredMachines } from "./client-qQAaXSUs.mjs";
 import { lstatSync, readFileSync, readdirSync, readlinkSync } from "node:fs";
 import { join } from "node:path";
-import { HOSTED_APP_CHUNK_BYTES, hostedMacosAppSlot, isJsonObject, readDeviceHostMachines } from "@stim-cli/core/state";
+import { DEVICE_HOST_LIMITS, HOSTED_APP_CHUNK_BYTES, hostedMacosAppSlot, hostedWorkerSettleMs, isJsonObject, readDeviceHostMachines } from "@stim-cli/core/state";
 import { createHash } from "node:crypto";
 //#region src/device-host/hosted-client.ts
 const CONNECT_TIMEOUT_MS = 1e4;
-/** Covers 90s stop + 15s final logs + three 10s worker group-settle bounds, with 45s for polling and transport. */
-const SESSION_TIMEOUT_MS = 18e4;
-const PREPARE_TIMEOUT_MS = 355e3;
-const INSTALL_TIMEOUT_MS = 3e5;
-const sleep = (ms) => new Promise((done) => setTimeout(done, ms));
+const HOSTED_POLL_MARGIN_MS = 45e3;
+const HOSTED_REQUEST_MARGIN_MS = 5e3;
+const workerBoundMs = (deadlineMs) => deadlineMs + hostedWorkerSettleMs();
+const SESSION_TIMEOUT_MS = hostedWorkerSettleMs() + workerBoundMs(DEVICE_HOST_LIMITS.logsMs) + workerBoundMs(DEVICE_HOST_LIMITS.stopMs) + HOSTED_POLL_MARGIN_MS;
+const PREPARE_TIMEOUT_MS = workerBoundMs(DEVICE_HOST_LIMITS.prepareMs) + HOSTED_POLL_MARGIN_MS;
+const INSTALL_TIMEOUT_MS = workerBoundMs(DEVICE_HOST_LIMITS.prepareMs) + HOSTED_POLL_MARGIN_MS;
+const OFFER_TIMEOUT_MS = workerBoundMs(DEVICE_HOST_LIMITS.offerMs) + HOSTED_REQUEST_MARGIN_MS;
 const sha256 = (content) => createHash("sha256").update(content).digest("hex");
 function credentialRefusal(message, remedy = "Run stim doctor.") {
 	return Object.assign(new Error(message), {
@@ -128,11 +131,16 @@ async function probeSession(placement, timeoutMs) {
 		host?.connection.close();
 	}
 }
-async function settle(host, session, passing, timeoutMs, platform = "macos") {
+async function settle(host, session, passing, timeoutMs, platform = "macos", signal) {
 	const deadline = Date.now() + timeoutMs;
+	const what = `wait for hosted session ${session.id}`;
 	while (passing.includes(session.state)) {
+		throwIfCancelled(signal, what);
 		if (Date.now() > deadline) throw new Error(`The hosted session ${session.id} on ${host.machine} stayed ${session.state}.`);
-		await sleep(500);
+		await cancellableSleep(500, {
+			signal,
+			what
+		});
 		session = await attach(host, session.id, void 0, platform);
 	}
 	return session;
@@ -199,4 +207,4 @@ async function upload(host, ids, missing, content) {
 	}
 }
 //#endregion
-export { bundleManifest as a, heldNoLonger as c, requireHostedAppMode as d, settle as f, upload as g, unknownSession as h, attach as i, hostedSession as l, sleep as m, PREPARE_TIMEOUT_MS as n, call as o, sha256 as p, SESSION_TIMEOUT_MS as r, connectHost as s, INSTALL_TIMEOUT_MS as t, probeHostedSession as u };
+export { attach as a, connectHost as c, probeHostedSession as d, requireHostedAppMode as f, upload as g, unknownSession as h, SESSION_TIMEOUT_MS as i, heldNoLonger as l, sha256 as m, OFFER_TIMEOUT_MS as n, bundleManifest as o, settle as p, PREPARE_TIMEOUT_MS as r, call as s, INSTALL_TIMEOUT_MS as t, hostedSession as u };

package/dist/{hosted-ios-Chx9XQyI.mjs → hosted-ios-l-o3iM9J.mjs}

@@ -1,4 +1,4 @@
-import { n as prepareHostedNative, r as stopHostedNative, t as placeHostedNative } from "./hosted-native-3KXZ5-qn.mjs";
+import { n as prepareHostedNative, r as stopHostedNative, t as placeHostedNative } from "./hosted-native-A4s1QPXe.mjs";
 //#region src/device-host/hosted-ios.ts
 async function prepareHostedIos(machine, selectors, recorded, mode) {
 	return await prepareHostedNative(machine, selectors, recorded, "ios", false, mode);

package/dist/{hosted-logs-Bkz0Hxzh.mjs → hosted-logs-EzQM7-3Z.mjs}

@@ -1,11 +1,11 @@
-import { t as getExecutor } from "./exec-B81Qodjn.mjs";
-import { L as deviceSlotFileKey, W as validateDeviceSlot } from "./config-D0LhTY3S.mjs";
-import { w as workspaceLogsDir$1, x as workspaceDir } from "./workspace-state-CvgTFe-h.mjs";
-import { l as phaseLine } from "./command-output-CPDq_90S.mjs";
-import { o as parseMachine$1 } from "./tailnet-D7-tE_ug.mjs";
+import { K as validateDeviceSlot, z as deviceSlotFileKey } from "./config-BYDxlMY3.mjs";
+import { t as getExecutor } from "./exec-DqKo9GKJ.mjs";
+import { w as workspaceLogsDir$1, x as workspaceDir } from "./workspace-state-DJt_MMvf.mjs";
+import { l as phaseLine } from "./command-output-BTy8hZ0F.mjs";
+import { o as parseMachine$1 } from "./tailnet-Dh-qiYzG.mjs";
 import { r as createNdjsonWriter } from "./ndjson-GOnbyvso.mjs";
-import { n as macosDir } from "./state-BUpAmt2r.mjs";
-import { o as call } from "./hosted-client--hNFgixu.mjs";
+import { n as macosDir } from "./state-CG_OFoaA.mjs";
+import { s as call } from "./hosted-client-ZEKpS9vw.mjs";
 import { mkdirSync, readFileSync, realpathSync, renameSync, rmSync, writeFileSync } from "node:fs";
 import { dirname, join } from "node:path";
 import { isJsonObject, parseHostedAgentGrant, parseHostedLogsCursor } from "@stim-cli/core/state";

package/dist/{hosted-macos-ckTjN-0V.mjs → hosted-macos-BACVAVqE.mjs}

@@ -1,7 +1,9 @@
-import { l as phaseLine } from "./command-output-CPDq_90S.mjs";
-import { n as macosDir } from "./state-BUpAmt2r.mjs";
-import { a as bundleManifest, c as heldNoLonger, f as settle, g as upload, h as unknownSession, i as attach, l as hostedSession, m as sleep, n as PREPARE_TIMEOUT_MS, o as call, p as sha256, r as SESSION_TIMEOUT_MS, s as connectHost, t as INSTALL_TIMEOUT_MS } from "./hosted-client--hNFgixu.mjs";
-import { i as agentAccess, r as closeAgentConnection, t as pullHostedMacosLogs } from "./hosted-logs-Bkz0Hxzh.mjs";
+import { l as phaseLine } from "./command-output-BTy8hZ0F.mjs";
+import { x as runCancellationSignal } from "./tailnet-Dh-qiYzG.mjs";
+import { t as cancellableSleep } from "./cancellation-C_22VQTH.mjs";
+import { n as macosDir } from "./state-CG_OFoaA.mjs";
+import { a as attach, c as connectHost, g as upload, h as unknownSession, i as SESSION_TIMEOUT_MS, l as heldNoLonger, m as sha256, o as bundleManifest, p as settle, r as PREPARE_TIMEOUT_MS, s as call, t as INSTALL_TIMEOUT_MS, u as hostedSession } from "./hosted-client-ZEKpS9vw.mjs";
+import { i as agentAccess, r as closeAgentConnection, t as pullHostedMacosLogs } from "./hosted-logs-EzQM7-3Z.mjs";
 import { rmSync } from "node:fs";
 import { join } from "node:path";
 import { hostedMacosBundleId, parseHostedMacosDevice, validHostedAppArguments } from "@stim-cli/core/state";
@@ -18,8 +20,8 @@ async function placeHostedMacos(host, { root, bundle, bundleId, handoff, argumen
 	let session = null;
 	if (recorded) {
 		try {
-			session = await settle(host, await attach(host, recorded.session), ["preparing"], PREPARE_TIMEOUT_MS);
-			session = await settle(host, session, ["stopping"], SESSION_TIMEOUT_MS);
+			session = await settle(host, await attach(host, recorded.session), ["preparing"], PREPARE_TIMEOUT_MS, "macos", runCancellationSignal());
+			session = await settle(host, session, ["stopping"], SESSION_TIMEOUT_MS, "macos", runCancellationSignal());
 		} catch (error) {
 			if (!heldNoLonger(error)) throw error;
 		}
@@ -50,7 +52,7 @@ async function placeHostedMacos(host, { root, bundle, bundleId, handoff, argumen
 		}
 	};
 	reserved(placement);
-	session = await settle(host, session, ["preparing"], PREPARE_TIMEOUT_MS);
+	session = await settle(host, session, ["preparing"], PREPARE_TIMEOUT_MS, "macos", runCancellationSignal());
 	if (session.state === "unknown") throw unknownSession(host, session);
 	if (session.state !== "ready") throw new Error(`The hosted session ${session.id} on ${host.machine} is ${session.state}.`);
 	const device = parseHostedMacosDevice(session.device);
@@ -97,7 +99,7 @@ async function placeHostedMacos(host, { root, bundle, bundleId, handoff, argumen
 	while (delivery.state !== "installed") {
 		if (delivery.state === "unknown") throw new Error(`${host.machine} could not install or launch the app${typeof delivery.notice === "string" ? `: ${delivery.notice}` : ""}.`);
 		if (Date.now() > deadline) throw new Error(`${host.machine} did not finish installing the app.`);
-		await sleep(500);
+		await cancellableSleep(500);
 		delivery = await call(host, "device-host.app.attach", ids);
 	}
 	const appliedArguments = validHostedAppArguments(delivery.arguments) ? delivery.arguments : [];

package/dist/{hosted-native-3KXZ5-qn.mjs → hosted-native-A4s1QPXe.mjs}

@@ -1,8 +1,10 @@
-import { r as readWorkspaceState$1, x as workspaceDir } from "./workspace-state-CvgTFe-h.mjs";
-import { a as bundleManifest, c as heldNoLonger, d as requireHostedAppMode, f as settle, g as upload, h as unknownSession, i as attach, l as hostedSession, m as sleep, n as PREPARE_TIMEOUT_MS, o as call, p as sha256, r as SESSION_TIMEOUT_MS, s as connectHost, t as INSTALL_TIMEOUT_MS } from "./hosted-client--hNFgixu.mjs";
-import { i as agentAccess, n as pullHostedNativeLogs, r as closeAgentConnection } from "./hosted-logs-Bkz0Hxzh.mjs";
-import { a as requireHostedMetro, i as requestHostedMetro, n as closeHostedMetro } from "./metro-gateway-BzlQZQmU.mjs";
-import { s as writeHostedNative } from "./ios-state-BsXMwo5y.mjs";
+import { r as readWorkspaceState$1, x as workspaceDir } from "./workspace-state-DJt_MMvf.mjs";
+import { x as runCancellationSignal } from "./tailnet-Dh-qiYzG.mjs";
+import { t as cancellableSleep } from "./cancellation-C_22VQTH.mjs";
+import { a as attach, c as connectHost, f as requireHostedAppMode, g as upload, h as unknownSession, i as SESSION_TIMEOUT_MS, l as heldNoLonger, m as sha256, n as OFFER_TIMEOUT_MS, o as bundleManifest, p as settle, r as PREPARE_TIMEOUT_MS, s as call, t as INSTALL_TIMEOUT_MS, u as hostedSession } from "./hosted-client-ZEKpS9vw.mjs";
+import { i as agentAccess, n as pullHostedNativeLogs, r as closeAgentConnection } from "./hosted-logs-EzQM7-3Z.mjs";
+import { a as requireHostedMetro, i as requestHostedMetro, n as closeHostedMetro } from "./metro-gateway-CX9Xlkq2.mjs";
+import { s as writeHostedNative } from "./ios-state-CBLe1xYw.mjs";
 import { readFileSync, rmSync } from "node:fs";
 import { join } from "node:path";
 import { hostedNativeRecords, isJsonObject, parseHostedAndroidDevice, parseHostedChoice, parseHostedDevice, parseHostedNativeOffer, parseHostedNativePlacement, requireAutomaticMachine, unreadableHostedNative } from "@stim-cli/core/state";
@@ -24,8 +26,8 @@ async function prepareHostedNative(machine, selectors, recorded, platform = "ios
 		if (recorded) {
 			let session = null;
 			try {
-				session = await settle(host, await attach(host, recorded.session, void 0, platform), ["preparing"], PREPARE_TIMEOUT_MS, platform);
-				session = await settle(host, session, ["stopping"], SESSION_TIMEOUT_MS, platform);
+				session = await settle(host, await attach(host, recorded.session, void 0, platform), ["preparing"], PREPARE_TIMEOUT_MS, platform, runCancellationSignal());
+				session = await settle(host, session, ["stopping"], SESSION_TIMEOUT_MS, platform, runCancellationSignal());
 			} catch (error) {
 				if (!heldNoLonger(error)) throw error;
 			}
@@ -49,7 +51,7 @@ async function prepareHostedNative(machine, selectors, recorded, platform = "ios
 		const offer = await call(host, "device-host.offer", {
 			platform,
 			...selectors
-		}, 45e3);
+		}, OFFER_TIMEOUT_MS);
 		const parsedOffer = parseHostedNativeOffer(offer);
 		const choice = platform === "ios" ? offer.platform === "ios" ? parseHostedChoice(offer.choice) : null : parsedOffer?.platform === "android" ? parsedOffer.choice : null;
 		if (typeof offer.declined === "string") throw new Error(offer.declined);
@@ -109,7 +111,7 @@ async function placeHostedNative(target, { root, slot, bundle, handoff, bundleId
 			}
 		};
 		reserved(placement);
-		session = await settle(host, session, ["preparing"], PREPARE_TIMEOUT_MS, platform);
+		session = await settle(host, session, ["preparing"], PREPARE_TIMEOUT_MS, platform, runCancellationSignal());
 		if (session.state !== "ready") throw unknownSession(host, session);
 		const device = platform === "ios" ? parseHostedDevice(session.device) : parseHostedAndroidDevice(session.device);
 		if (!device || device.architecture !== target.choice.architecture || "avdName" in device && "systemImage" in target.choice && (device.systemImage !== target.choice.systemImage || device.deviceProfile !== target.choice.deviceProfile)) throw new Error(platform === "ios" ? "The reserved simulator does not match the offered architecture." : "The reserved emulator does not match the offered architecture or selectors.");
@@ -182,7 +184,7 @@ async function placeHostedNative(target, { root, slot, bundle, handoff, bundleId
 					break;
 				} catch (offerError) {
 					if (!String(offerError).includes("native operation in progress") || Date.now() >= fallbackDeadline) throw offerError;
-					await sleep(Math.min(500, Math.max(0, fallbackDeadline - Date.now())));
+					await cancellableSleep(Math.min(500, Math.max(0, fallbackDeadline - Date.now())));
 				}
 			}
 		}
@@ -194,7 +196,7 @@ async function placeHostedNative(target, { root, slot, bundle, handoff, bundleId
 		while (delivery.state !== "installed") {
 			if (delivery.state === "unknown") throw new Error(typeof delivery.notice === "string" ? delivery.notice : "App installation or launch is unknown.");
 			if (Date.now() > deadline) throw new Error("App installation did not finish.");
-			await sleep(500);
+			await cancellableSleep(500);
 			delivery = await call(host, "device-host.app.attach", ids);
 		}
 		if (typeof delivery.notice === "string") note(delivery.notice);