stim 1.11.0 → 1.13.0

package/dist/{ownership-BiojdtAp.mjs → ownership-PUP4Dwai.mjs}

@@ -1,14 +1,18 @@
-import { D as process_identity_exports, H as projectDeviceSlots, I as assignSlotDevice, O as acquireAvdClaim, T as withConfigLock, U as removeSlotDevice, d as getConfigPath, g as loadConfig, k as ownership_claim_exports, s as ensureConfig, u as getConfigDir, x as saveConfig, z as deviceSlotPlatforms } from "./config-BEq0Qw_a.mjs";
+import { A as ownership_claim_exports, B as deviceSlotPlatforms, E as withConfigLock, O as process_identity_exports, U as projectDeviceSlots, _ as loadConfig, d as getConfigDir, k as acquireAvdClaim, p as getProject } from "./config-0jCcMM0E.mjs";
 import { t as getExecutor } from "./exec-DK8KaVHK.mjs";
-import { c as signalProcessTree, i as pidExists } from "./metro-BWLOJ_Wr.mjs";
-import { r as workspaceProcessLockPath, t as withWorkspaceProcessLock } from "./workspace-process-lock-Cx74RSDZ.mjs";
+import { a as pidExists, k as workspaceDir, l as signalProcessTree } from "./metro-BPeY1YMh.mjs";
+import { a as withWorkspaceProcessLock, r as releaseBrowserPort, s as workspaceProcessLockPath } from "./named-ports-n7tnJsI8.mjs";
 import { t as createLineReader } from "./process-output-Fpl8PYi8.mjs";
-import { l as phaseLine } from "./command-output-D5z2_bcF.mjs";
-import { G as sleepSync, H as resolveOwnedAvdSerial, J as wipeAvdUserData, K as waitForAndroidEmulatorShutdown, L as ownedAvdSystemImage, N as ownedAvdDirectory, P as ownedAvdMatchesConfiguration, W as shutdownAndroidEmulator, _ as deleteAvd, d as avdPathExists, k as listOrphanedAvdDirectories, p as avdStorageRoots, u as assertOwnedAvdStopped, w as isStimOwnedAvdName } from "./android-C4zG2Tuc.mjs";
-import { S as resolveOwnedIosSim, a as deleteParkedIosSim, d as listIosDeviceTypes, g as parseRuntimeVersion, h as parkedSimName, i as deleteIosSim, o as eraseIosSim, v as renameIosSim, w as shutdownIosSim } from "./ios-DArbmwer.mjs";
-import { closeSync, lstatSync, mkdirSync, openSync, readFileSync, renameSync, rmSync, unlinkSync } from "node:fs";
-import { basename, dirname, join, resolve, sep } from "node:path";
+import { l as phaseLine } from "./command-output-BIL7rlX7.mjs";
+import { a as readAgentDeviceRecords } from "./activity-DfVKZTEB.mjs";
+import { F as ownedAvdDirectory, I as ownedAvdMatchesConfiguration, Q as waitForAndroidEmulatorShutdown, X as sleepSync, Y as shutdownAndroidEmulator, b as deleteAvd, d as assertOwnedAvdStopped, et as wipeAvdUserData, g as avdStorageRoots, j as listOrphanedAvdDirectories, lt as readParked, m as avdPathExists, q as resolveOwnedAvdSerial, st as parkSim, tt as isStimOwnedAvd, ut as removeParkedAfter, z as ownedAvdSystemImage } from "./android-qx_31wJo.mjs";
+import { n as readCreatedDevices, r as recordCreatedDevice, t as forgetCreatedDevice } from "./created-devices-Cd558h31.mjs";
+import { a as readWebRecord, d as webProfileDir, g as removeSingletonFiles, h as liveProfileHolder, i as clearWebRecord, m as chromeProcessState, s as webClaimRoot, t as CDP_PORT_LABEL } from "./state-l1pYwOre.mjs";
+import { S as resolveOwnedIosSim, a as deleteParkedIosSim, d as listIosDeviceTypes, g as parseRuntimeVersion, h as parkedSimName, i as deleteIosSim, o as eraseIosSim, v as renameIosSim, w as shutdownIosSim } from "./ios-CmEzZiOj.mjs";
+import { closeSync, existsSync, lstatSync, mkdirSync, openSync, readFileSync, realpathSync, renameSync, rmSync, unlinkSync } from "node:fs";
+import { basename, dirname, isAbsolute, join, relative, resolve, sep } from "node:path";
 import { createHash, randomUUID } from "node:crypto";
+import { homedir } from "node:os";
 import { isDeepStrictEqual } from "node:util";
 import { resolve4 } from "node:dns/promises";
 import { request } from "node:https";
@@ -22,17 +26,41 @@ function parseAgentDeviceSessions(output) {
 		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,
+			name: typeof row.address === "string" && row.address.trim() ? row.address : row.name,
 			platform: row.platform,
 			id,
+			device: typeof row.device === "string" ? row.device : null,
 			createdAt: row.createdAt
 		}];
 	});
 }
+function isOwnDeviceSession(session, device, owner) {
+	if (session.platform !== device.platform || session.id !== device.id) return false;
+	if (device.platform === "android" && session.device !== device.avdName.replaceAll("_", " ")) return false;
+	if (!owner) return true;
+	return owner.claims.some((claim) => claim.session === session.name && claim.workspace !== null && within(owner.workspace, claim.workspace));
+}
+function within(root, path) {
+	const rest = relative(root, path);
+	return rest === "" || !isAbsolute(rest) && rest.split(sep)[0] !== "..";
+}
+function canonical(path) {
+	try {
+		return realpathSync(path);
+	} catch {
+		return null;
+	}
+}
+function deviceClaims(device) {
+	return readAgentDeviceRecords(homedir()).filter((record) => record.kind === "claim" && record.deviceId === device.id).map((record) => ({
+		session: record.session,
+		workspace: record.workspace && canonical(record.workspace)
+	}));
+}
 function report(message) {
 	process.stderr.write(`${phaseLine("device", message)}\n`);
 }
-function closeOwnedDeviceSessions(device, stillOwned) {
+function closeOwnedDeviceSessions(device, stillOwned, workspace) {
 	const exec = getExecutor();
 	const deadline = Date.now() + 15e3;
 	const run = (args) => {
@@ -56,7 +84,13 @@ function closeOwnedDeviceSessions(device, stillOwned) {
 	]));
 	try {
 		if (!exec.findExecutable("agent-device")) return;
-		const sessions = list().filter((session) => session.platform === device.platform && session.id === device.id);
+		const root = workspace === void 0 ? void 0 : canonical(workspace);
+		if (root === null) return;
+		const owner = root === void 0 ? void 0 : {
+			workspace: root,
+			claims: deviceClaims(device)
+		};
+		const sessions = list().filter((session) => isOwnDeviceSession(session, device, owner));
 		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;
@@ -79,202 +113,6 @@ function closeOwnedDeviceSessions(device, stillOwned) {
 		report(`could not list agent-device sessions for ${device.id}: ${error.message}`);
 	}
 }
-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;
-}
-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 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 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 readParked(platform, { config } = {}) {
-	return poolBlock(config === void 0 ? loadConfig() : config)[platform];
-}
-function writeParked(config, platform, records) {
-	config.parked = {
-		...poolBlock(config),
-		[platform]: records
-	};
-}
-function oldestFirst(records) {
-	return records.toSorted((a, b) => String(a.parkedAt).localeCompare(String(b.parkedAt)));
-}
-function isLegacyDeletionClaim(value) {
-	if (value === void 0) return false;
-	if (value === null || typeof value !== "object" || Array.isArray(value)) return true;
-	const marker = value;
-	return marker.kind !== "ownership-claim" || typeof marker.claimId !== "string" || marker.claimId.length === 0;
-}
-function selectParked(records, { deviceTypeIdentifier, runtimeIdentifier }) {
-	return oldestFirst(records.filter((r) => !isLegacyDeletionClaim(r.deletionClaim) && 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 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 adoptParked({ platform, projectPath, slot = "default", udid, device }) {
-	const claim = claimParkedOperation(platform, udid);
-	if (!claim) return null;
-	try {
-		return withConfigLock(() => {
-			const cfg = ensureConfig();
-			const records = readParked(platform, { config: cfg });
-			const taken = records.find((r) => r.udid === udid);
-			if (!taken || isLegacyDeletionClaim(taken.deletionClaim)) 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);
-			const adopted = { ...taken };
-			delete adopted.deletionClaim;
-			return adopted;
-		});
-	} finally {
-		(0, ownership_claim_exports.releaseClaim)(claim);
-	}
-}
-function claimParkedOperation(platform, udid) {
-	const attempt = (0, ownership_claim_exports.tryAcquireClaim)({
-		root: join(getConfigDir(), "pool-locks", platform, `${encodeURIComponent(udid.toLowerCase())}.lock`),
-		mode: "exclusive",
-		label: `parked ${platform} device ${udid}`
-	});
-	if (attempt.pending) (0, ownership_claim_exports.releaseClaim)(attempt.pending);
-	return attempt.acquired ?? null;
-}
-function removeParkedAfter(platform, udid, beforeRemove) {
-	const claim = claimParkedOperation(platform, udid);
-	if (!claim) return null;
-	try {
-		const claimed = withConfigLock(() => {
-			const cfg = loadConfig();
-			if (!cfg) return null;
-			const records = readParked(platform, { config: cfg });
-			const current = records.find((candidate) => candidate.udid === udid);
-			if (!current) return null;
-			if (isLegacyDeletionClaim(current.deletionClaim)) throw new Error(`Parked ${platform} device ${udid} has a legacy deletionClaim in ${getConfigPath()}. Its PID does not establish whether the original operation finished. Keep the device and pool record; after verifying that neither the old Stim process nor its native child is using it, remove only that record's deletionClaim field and retry.`);
-			const record = { ...current };
-			delete record.deletionClaim;
-			const marked = {
-				...record,
-				deletionClaim: {
-					kind: "ownership-claim",
-					claimId: claim.claimId
-				}
-			};
-			writeParked(cfg, platform, records.map((candidate) => candidate.udid === udid ? marked : candidate));
-			saveConfig(cfg);
-			return {
-				record,
-				marked
-			};
-		});
-		if (!claimed) return null;
-		let completed = false;
-		let removed = null;
-		try {
-			(0, ownership_claim_exports.markClaimChildPending)(claim);
-			try {
-				beforeRemove(claimed.record);
-			} finally {
-				(0, ownership_claim_exports.clearClaimChild)(claim);
-			}
-			completed = true;
-		} finally {
-			withConfigLock(() => {
-				const cfg = loadConfig();
-				if (!cfg) return;
-				const records = readParked(platform, { config: cfg });
-				const current = records.find((candidate) => candidate.udid === udid);
-				if (!isDeepStrictEqual(current, claimed.marked)) return;
-				writeParked(cfg, platform, completed ? records.filter((candidate) => candidate.udid !== udid) : records.map((candidate) => candidate.udid === udid ? claimed.record : candidate));
-				saveConfig(cfg);
-				if (completed) removed = claimed.record;
-			});
-		}
-		return removed;
-	} finally {
-		(0, ownership_claim_exports.releaseClaim)(claim);
-	}
-}
-function dropParked(platform, udid) {
-	return removeParkedAfter(platform, udid, () => {}) !== null;
-}
 //#endregion
 //#region src/devices/teardown.ts
 function teardownParkedAvd(avdName) {
@@ -376,7 +214,7 @@ function parkOwnedIosSim(settled, udid, park) {
 		})
 	};
 }
-function teardownOwnedIosSim(udid, { del = false, label, park, shutdownClock = {} } = {}) {
+function teardownOwnedIosSim(udid, { del = false, label, park, workspace, shutdownClock = {} } = {}) {
 	let parkFallback;
 	try {
 		const resolved = resolveOwnedIosSim(udid);
@@ -389,7 +227,7 @@ function teardownOwnedIosSim(udid, { del = false, label, park, shutdownClock = {
 		closeOwnedDeviceSessions({
 			platform: "ios",
 			id: udid
-		}, () => Boolean(resolveOwnedIosSim(udid).sim));
+		}, () => Boolean(resolveOwnedIosSim(udid).sim), workspace);
 		const current = resolveOwnedIosSim(udid);
 		if (current.missing) return { status: "missing" };
 		if (current.notOwned) return {
@@ -468,8 +306,16 @@ function removeOrphanedAvdDirectory(candidate, owner) {
 		const current = lstatSync(candidate.directory);
 		if (!current.isDirectory() || current.dev !== candidate.dev || current.ino !== candidate.ino) throw new Error(`AVD data at ${candidate.directory} changed or is registered; it was kept.`);
 		assertAvdReferences(candidate.name, owner);
-		const destination = join(dirname(candidate.directory), `stim-gc-${randomUUID()}.avd`);
-		renameSync(candidate.directory, destination);
+		const name = `stim-gc-${randomUUID()}`;
+		recordCreatedDevice("android", name);
+		const destination = join(dirname(candidate.directory), `${name}.avd`);
+		try {
+			renameSync(candidate.directory, destination);
+		} catch (error) {
+			forgetCreatedDevice("android", name);
+			throw error;
+		}
+		forgetCreatedDevice("android", candidate.name);
 		return destination;
 	});
 	const current = lstatSync(detached);
@@ -479,6 +325,7 @@ function removeOrphanedAvdDirectory(candidate, owner) {
 	} catch (error) {
 		throw new Error(`Could not remove AVD data at ${detached}; retry gc --delete: ${error.message}`, { cause: error });
 	}
+	forgetCreatedDevice("android", basename(detached, ".avd"));
 }
 function teardownUnregisteredAvd(avdName, del, owner, surveyed) {
 	const candidates = surveyed ? [surveyed] : listOrphanedAvdDirectories(avdName);
@@ -502,7 +349,7 @@ function teardownUnregisteredAvd(avdName, del, owner, surveyed) {
 function teardownOwnedAvd(avdName, options = {}) {
 	let claim;
 	try {
-		if (!isStimOwnedAvdName(avdName, options.orphanedDirectory ? options.orphanedDirectory.directory : void 0)) return {
+		if (!isStimOwnedAvd(avdName)) return {
 			status: "skipped",
 			kind: "not-owned",
 			reason: `AVD ${avdName} is not Stim-owned: Stim has no record of creating it`
@@ -520,7 +367,7 @@ function teardownOwnedAvd(avdName, options = {}) {
 		(0, ownership_claim_exports.releaseClaim)(claim);
 	}
 }
-function teardownClaimedAvd(avdName, claim, { del = false, park, owner, orphanedDirectory, onlyIfMissing = false, waitForShutdown = waitForAndroidEmulatorShutdown, assertStopped = assertOwnedAvdStopped, resolveAvd = resolveOwnedAvdSerial }) {
+function teardownClaimedAvd(avdName, claim, { del = false, park, owner, workspace, orphanedDirectory, onlyIfMissing = false, waitForShutdown = waitForAndroidEmulatorShutdown, assertStopped = assertOwnedAvdStopped, resolveAvd = resolveOwnedAvdSerial }) {
 	let parkFallback;
 	try {
 		if (del) withConfigLock(() => assertAvdReferences(avdName, owner));
@@ -547,8 +394,9 @@ function teardownClaimedAvd(avdName, claim, { del = false, park, owner, orphaned
 			};
 			closeOwnedDeviceSessions({
 				platform: "android",
-				id: serial
-			}, stillOwned);
+				id: serial,
+				avdName
+			}, stillOwned, workspace);
 			if (!stillOwned()) throw new Error(`Owned AVD ${avdName} changed before shutdown; it was kept.`);
 			waitForShutdown(avdName, (timeoutMs) => {
 				(0, ownership_claim_exports.markClaimChildPending)(claim);
@@ -558,7 +406,7 @@ function teardownClaimedAvd(avdName, claim, { del = false, park, owner, orphaned
 					(0, ownership_claim_exports.clearClaimChild)(claim);
 				}
 			});
-		} else assertStopped(avdName);
+		} else waitForShutdown(avdName, null);
 		if (del) {
 			const current = resolveAvd(avdName);
 			if (current.notOwned) return {
@@ -639,6 +487,116 @@ function teardownClaimedAvd(avdName, claim, { del = false, park, owner, orphaned
 		};
 	}
 }
+const BROWSER_EXIT_WAIT_MS = 15e3;
+const CHROME_KILL_WAIT_MS = 5e3;
+async function stopOwnedChrome(record) {
+	for (const signal of ["SIGTERM", "SIGKILL"]) {
+		const state = chromeProcessState(record);
+		if (state === "gone") return true;
+		if (state === "unknown") return false;
+		try {
+			signalProcessTree(record.pid, signal, { group: true });
+		} catch {}
+		const deadline = Date.now() + CHROME_KILL_WAIT_MS;
+		while (chromeProcessState(record) !== "gone" && Date.now() < deadline) await sleepAsync(50);
+	}
+	return chromeProcessState(record) === "gone";
+}
+const sleepAsync = (ms) => new Promise((done) => setTimeout(done, ms));
+/**
+* Closes the workspace's Stim-owned Chrome and its supervisor, after verifying both process identities. With
+* `deleteProfile`, it also deletes the profile directory, only when the created-devices ledger lists it.
+*/
+async function teardownOwnedBrowser(root, options = {}) {
+	try {
+		return await withWorkspaceProcessLock(workspaceDir(root), "web", () => teardownBrowserHeld(root, options), {
+			external: true,
+			ownerPurpose: "browser teardown"
+		});
+	} catch (error) {
+		return {
+			status: "failed",
+			reason: String(error?.message || error)
+		};
+	}
+}
+/** {@link teardownOwnedBrowser} for a caller that already holds the {@link BROWSER_LOCK} lock. */
+async function teardownBrowserHeld(root, { deleteProfile = false } = {}) {
+	try {
+		const record = readWebRecord(root);
+		const profile = record?.profile ?? webProfileDir(root);
+		if (record) {
+			const supervisor = (0, process_identity_exports.inspectProcessIdentity)(record);
+			const chrome = record.chromeProcess ? (0, process_identity_exports.inspectProcessIdentity)(record.chromeProcess) : "gone";
+			if (supervisor === "unknown" || chrome === "unknown") return {
+				status: "skipped",
+				kind: "not-verified",
+				reason: `the browser supervisor (pid ${record.pid}) or its Chrome could not be verified; its record was kept`
+			};
+			if (supervisor === "same") {
+				try {
+					process.kill(record.pid, "SIGTERM");
+				} catch {}
+				if (!await (0, process_identity_exports.waitForProcessExit)(record, BROWSER_EXIT_WAIT_MS)) return {
+					status: "failed",
+					reason: `browser supervisor pid ${record.pid} did not exit`
+				};
+			}
+			if (record.chromeProcess && !await stopOwnedChrome(record.chromeProcess)) return {
+				status: "failed",
+				reason: `Chrome pid ${record.chromeProcess.pid} did not exit`
+			};
+			const holder = liveProfileHolder(profile);
+			if (holder !== null) return {
+				status: "skipped",
+				kind: "not-verified",
+				reason: `pid ${holder} still holds ${profile}, and the browser record does not name it; it was left running`
+			};
+			const claims = (0, ownership_claim_exports.clearFreeClaimSet)({
+				root: webClaimRoot(root),
+				label: "browser supervisor"
+			});
+			if (claims.status !== "cleared") return {
+				status: "skipped",
+				kind: "not-verified",
+				reason: claims.status === "held" ? `the browser supervisor claim is still held${claims.holder ? ` by pid ${claims.holder.owner.pid}` : ""}` : `the browser supervisor claim could not be cleared (${claims.reason}); remove it with ${(0, ownership_claim_exports.claimRemoveCommand)(webClaimRoot(root))}`
+			};
+			clearWebRecord(root, record);
+			await releaseBrowserPort(root, record.cdpPort);
+		} else {
+			const holder = liveProfileHolder(profile);
+			if (holder !== null) return {
+				status: "skipped",
+				kind: "not-verified",
+				reason: `pid ${holder} holds ${profile} but no browser supervisor is recorded; it was left running`
+			};
+			const port = getProject(root)?.ports?.[CDP_PORT_LABEL];
+			if (typeof port === "number") await releaseBrowserPort(root, port);
+		}
+		if (existsSync(profile)) removeSingletonFiles(profile);
+		if (deleteProfile && existsSync(profile)) {
+			if (!readCreatedDevices().web.has(profile)) return {
+				status: "skipped",
+				kind: "not-owned",
+				reason: `${profile} is not in Stim's ledger; it was kept`
+			};
+			rmSync(profile, {
+				recursive: true,
+				force: true
+			});
+			forgetCreatedDevice("web", profile);
+		}
+		return record ? {
+			status: "torn-down",
+			label: `Chrome (${profile})`
+		} : { status: "missing" };
+	} catch (error) {
+		return {
+			status: "failed",
+			reason: String(error?.message || error)
+		};
+	}
+}
 //#endregion
 //#region src/engine/public-http-probe.ts
 const DNS_TIMEOUT_MS = 5e3;
@@ -1177,4 +1135,4 @@ function numberOrNull(v) {
 	return typeof v === "number" && Number.isSafeInteger(v) && v > 0 ? v : null;
 }
 //#endregion
-export { dropParked as _, terminateChild as a, readParked as b, withManagedTunnelLock as c, teardownOwnedAvd as d, teardownOwnedIosSim as f, adoptParked as g, POOL_SETTING_REMEDY as h, stopTunnel as i, withManagedTunnelRemovalLock as l, teardownParkedIosSim as m, managedLockHolders as n, withManagedRemoteWorktreeLock as o, teardownParkedAvd as p, startTunnelSequence as r, withManagedRemoteWorktreeRemovalLock as s, resolveSupervisorTarget as t, probePublicHttp as u, isLegacyDeletionClaim as v, selectParked as x, parkedMaxSetting as y };
+export { terminateChild as a, withManagedTunnelLock as c, teardownBrowserHeld as d, teardownOwnedAvd as f, teardownParkedIosSim as g, teardownParkedAvd as h, stopTunnel as i, withManagedTunnelRemovalLock as l, teardownOwnedIosSim as m, managedLockHolders as n, withManagedRemoteWorktreeLock as o, teardownOwnedBrowser as p, startTunnelSequence as r, withManagedRemoteWorktreeRemovalLock as s, resolveSupervisorTarget as t, probePublicHttp as u };

package/dist/page-BTu7I60K.mjs

@@ -0,0 +1,29 @@
+import { O as process_identity_exports } from "./config-0jCcMM0E.mjs";
+import { t as connectOwnedBrowser } from "./cdp-Dq_ypAlJ.mjs";
+//#region src/web/page.ts
+/** The record of a verified live browser: its supervisor and Chrome are the processes the record names. */
+function liveWebRecord(record) {
+	if (!record?.targetId || !record.chromeProcess) return null;
+	if ((0, process_identity_exports.inspectProcessIdentity)(record) !== "same" || (0, process_identity_exports.inspectProcessIdentity)(record.chromeProcess) !== "same") return null;
+	return record;
+}
+const NAVIGATE_ACK_MS = 1e3;
+/** Sends one page-level DevTools command to the owned page, through a connection verified to reach its Chrome. */
+async function sendToOwnedPage(record, method, params = {}) {
+	const cdp = await connectOwnedBrowser(record.cdpPort, record.chromeProcess.pid);
+	try {
+		const { sessionId } = await cdp.send("Target.attachToTarget", {
+			targetId: record.targetId,
+			flatten: true
+		});
+		const reply = cdp.send(method, params, sessionId);
+		if (method === "Page.navigate") {
+			reply.catch(() => {});
+			await Promise.race([reply, new Promise((resolve) => setTimeout(resolve, NAVIGATE_ACK_MS))]);
+		} else await reply;
+	} finally {
+		cdp.close();
+	}
+}
+//#endregion
+export { sendToOwnedPage as n, liveWebRecord as t };

package/dist/{ports-DwBaRFJs.mjs → ports-C5UutqpJ.mjs}

@@ -1,10 +1,10 @@
-import { f as getProject } from "./config-BEq0Qw_a.mjs";
-import { o as findProjectRoot } from "./project-BXZzOABt.mjs";
-import { n as getNamedPort, t as clearNamedPorts } from "./named-ports-Dc7neAlc.mjs";
+import { p as getProject } from "./config-0jCcMM0E.mjs";
+import { i as findCommandWorkspace } from "./project-DGeclhvO.mjs";
+import { n as getNamedPort, t as clearNamedPorts } from "./named-ports-n7tnJsI8.mjs";
 //#region src/commands/ports.ts
 async function inProject(action) {
 	try {
-		const root = findProjectRoot(process.cwd());
+		const root = findCommandWorkspace(process.cwd());
 		if (!root) throw new Error("No package.json found. Run stim ports from the workspace that owns the server.");
 		await action(root);
 	} catch (error) {
@@ -16,7 +16,7 @@ function portsCommand(program) {
 	const ports = program.command("ports").description("Reserve workspace ports for servers Stim does not manage");
 	ports.action(() => inProject(async (root) => {
 		const project = getProject(root);
-		const rows = Object.entries(project?.ports ?? {});
+		const rows = Object.entries(project?.ports ?? {}).map(([name, port]) => [name === "web-cdp" ? "web-cdp (managed)" : name, port]);
 		if (typeof project?.metroPort === "number") rows.push(["metro (managed)", project.metroPort]);
 		if (!rows.length) {
 			console.log("No ports allocated. Use stim ports get <label>.");