stim 1.29.0 → 1.31.0

package/dist/{eas-session-ledger-B0KLZx5m.mjs → eas-session-ledger-aFBLTZr2.mjs}

@@ -1,9 +1,9 @@
 import { C as reportSignal, t as getExecutor } from "./exec-aULwtNly.mjs";
-import { M as withDirLock$1, N as withDirLockAsync$1, w as workspaceAgentDeviceDir } from "./workspace-state-DGwkPXwq.mjs";
-import { G as projectDeviceSlots, V as deviceSlotKey } from "./config-AbUjIBOQ.mjs";
-import { a as formatElapsed, o as formatLongDuration, r as clockTime, u as plural } from "./command-output-DjCsmzLZ.mjs";
-import { n as isInsideProject } from "./metro-BMQHczcf.mjs";
-import { r as cdpEndpoint } from "./state-D5ZxwCGJ.mjs";
+import { M as withDirLock$1, N as withDirLockAsync$1, w as workspaceAgentDeviceDir } from "./workspace-state-3bF4TB8P.mjs";
+import { H as deviceSlotKey, K as projectDeviceSlots } from "./config-D5qNWJEP.mjs";
+import { a as formatElapsed, o as formatLongDuration, r as clockTime, u as plural } from "./command-output-VrXd6qPX.mjs";
+import { n as isInsideProject } from "./metro-mKHEMO-a.mjs";
+import { r as cdpEndpoint } from "./state-CM_HvvkS.mjs";
 import { accessSync, constants, existsSync, mkdirSync, realpathSync, renameSync, rmSync, statSync, writeFileSync } from "node:fs";
 import { delimiter, dirname, join, resolve } from "node:path";
 import { workspaceId } from "@stim-cli/core";
@@ -362,7 +362,7 @@ function loadLine({ loadPerCore, busyAt, limit }) {
 	return `load ${loadPerCore}/core (busy at ${busyAt}${limit === null ? "" : `, holding at ${limit}`})`;
 }
 /** The plain status lines for the `concurrency.maxBuilds` and `concurrency.maxDevices` caps that are set. */
-function slotUsageLines({ builds, devices }) {
+function slotUsageLines({ builds, devices, platformDevices }) {
 	const lines = [];
 	if (builds) {
 		const holders = builds.holders.map((holder) => holder.unresolved ? `slot ${holder.slot} unresolved` : holder.client ? `offloaded for ${holder.client}` : holder.workspace ? basename$1(holder.workspace) : `slot ${holder.slot}`);
@@ -375,6 +375,19 @@ function slotUsageLines({ builds, devices }) {
 			lines.push(`devices ${devices.inUse}/${devices.max} (concurrency.maxDevices)${holders.length ? `: ${holders.join(", ")}` : ""}`);
 		}
 	}
+	for (const [platform, setting, noun] of [[
+		"ios",
+		"concurrency.maxIosDevices",
+		"iOS simulators"
+	], [
+		"android",
+		"concurrency.maxAndroidDevices",
+		"Android emulators"
+	]]) {
+		const slots = platformDevices?.[platform];
+		if (!slots) continue;
+		lines.push(slots.inUse === null ? `${noun} ?/${slots.max} (${setting}): ${slots.unknown ?? "not counted"}` : `${noun} ${slots.inUse}/${slots.max} (${setting})`);
+	}
 	return lines;
 }
 function parseDfFree(output) {

package/dist/{error-diagnostics-CV_1RoEH.mjs → error-diagnostics-CCsq_3uG.mjs}

@@ -1,12 +1,12 @@
 import { t as getExecutor } from "./exec-aULwtNly.mjs";
-import { r as readWorkspaceState$1 } from "./workspace-state-DGwkPXwq.mjs";
-import { H as deviceSlotPlatforms, V as deviceSlotKey, p as getProject } from "./config-AbUjIBOQ.mjs";
-import { v as launchErrorPreview } from "./command-output-DjCsmzLZ.mjs";
-import { I as readWorkspaceLaunches } from "./project-D1n0K4yg.mjs";
-import { o as androidHome, u as androidToolCwd } from "./android-BHKgeOuq.mjs";
-import { d as resolveProjectMetro } from "./metro-BMQHczcf.mjs";
-import { i as parseLogcatLine, n as androidLogGroups, r as isAndroidCrashText } from "./android-CLU_MMnb.mjs";
-import { S as parseLease, v as deviceLeasePath, y as fileLeaseIo } from "./activity-BR5oHSO5.mjs";
+import { r as readWorkspaceState$1 } from "./workspace-state-3bF4TB8P.mjs";
+import { H as deviceSlotKey, U as deviceSlotPlatforms, m as getProject } from "./config-D5qNWJEP.mjs";
+import { v as launchErrorPreview } from "./command-output-VrXd6qPX.mjs";
+import { I as readWorkspaceLaunches } from "./project-DCLkDM8C.mjs";
+import { o as androidHome, u as androidToolCwd } from "./android-DsEj2CCs.mjs";
+import { d as resolveProjectMetro } from "./metro-mKHEMO-a.mjs";
+import { i as parseLogcatLine, n as androidLogGroups, r as isAndroidCrashText } from "./android-BeeC15Ve.mjs";
+import { S as parseLease, v as deviceLeasePath, y as fileLeaseIo } from "./activity-Dw4N_RFe.mjs";
 import { r as deviceConsoleLevel } from "./ios-device-CiBA-er9.mjs";
 import { createHash, randomUUID } from "node:crypto";
 import { existsSync, readFileSync, renameSync } from "node:fs";

package/dist/{gc-CKHqL4aS.mjs → gc-B0K4d_PL.mjs}

@@ -1,24 +1,24 @@
 import { D as ownership_claim_exports, S as process_identity_exports, c as throwIfCancelled, l as WorkspaceProcessCleanupError, m as declareSpawnsOn, t as getExecutor, v as stopDeclaringSpawnsOn, x as withDrainingCancellation } from "./exec-aULwtNly.mjs";
-import { E as workspaceDir, u as workspaceLastUsed } from "./workspace-state-DGwkPXwq.mjs";
-import { F as isOnMountedVolume, G as projectDeviceSlots, I as listMountedVolumes, L as measuredDirectorySizeAsync, N as directorySizeAsync, O as withConfigLockAsync$1, P as formatBytes, R as volumeRootFor, S as removeProject, _ as loadConfig$1, d as getConfigDir, j as acquireAvdClaim } from "./config-AbUjIBOQ.mjs";
-import { d as quotedPath$1, h as shortUdid, o as formatLongDuration, u as plural } from "./command-output-DjCsmzLZ.mjs";
+import { E as workspaceDir, u as workspaceLastUsed } from "./workspace-state-3bF4TB8P.mjs";
+import { C as removeProject, F as formatBytes, I as isOnMountedVolume, K as projectDeviceSlots, L as listMountedVolumes, M as acquireAvdClaim, P as directorySizeAsync, R as measuredDirectorySizeAsync, d as getConfigDir, k as withConfigLockAsync$1, v as loadConfig$1, z as volumeRootFor } from "./config-D5qNWJEP.mjs";
+import { d as quotedPath$1, h as shortUdid, o as formatLongDuration, u as plural } from "./command-output-VrXd6qPX.mjs";
 import { t as runOperationFile } from "./operation-exec-Dp4FuIGR.mjs";
-import { $t as TRASH_MANIFEST, Ft as matchWorktreeEntry, Wt as resolveSourceCheckoutAsync, Zt as TRASH_CLAIMS, en as deleteTrashEntry, jt as listWorktreesAsync } from "./settings-D776ygML.mjs";
-import { i as findProjectRoot$1, v as detectIsExpo } from "./project-D1n0K4yg.mjs";
-import { Ct as forgetCreatedDeviceAsync, F as listAvdsAsync, L as listOrphanedAvdDirectories, V as ownedAvdDirectory, ft as POOL_SETTING_REMEDY, h as avdNameAbsent, vt as parkedMaxSetting, wt as readCreatedDevices$1 } from "./android-BHKgeOuq.mjs";
-import { $ as gradleVersionLines, $n as memoryCacheKind, B as includesArchives, Ct as describeError, En as runProcessOperation, F as gcOptionsOf, Ft as withEasProjectLock, G as planCacheEmptying, H as includesRecordings, J as selectsBeyondCaches, Jn as parseArchiveSelector, K as previewScopedEmptying, L as openGcLog, Q as deleteGradleVersions, St as deleteEasSessions, U as includesWorkspaceOutputs, V as includesParkedDevices, W as isWorkspacesScope, X as collectGradleVersions, Y as trimCaches, Zn as collectMemoryReport, _t as findStaleDeviceRecords, ar as scopedMemoryReport, at as DEVICE_LIST_TIMEOUT_MS, bt as withAndroidAvdSizes, ct as collectParkedSims, dt as deleteProjectDevices, er as memoryLines, et as gradleVersionsPending, fr as sizeCaches, gt as findOrphanedDevices, ht as eraseParkedDevices, ir as reclaimMemory, it as collectInventory, lt as deleteParkedAvds, mt as deviceSweepIsScoped, nr as memorySweepIsScoped, ot as collectDeviceLeases, pt as describeUnverifiableDevices, q as selectCaches, rr as memoryWorkPending, rt as getMachineCacheReport, sr as phase, st as collectParkedAvds, tr as memoryScope, tt as includesGradleVersions, ur as discoverCaches, ut as deleteParkedSims, vt as findStaleProjectDevices, wt as withRemoteSessionGcLocks, xt as collectEasSessionSweep, yt as unverifiedDeviceCommand, z as emptyCaches } from "./ccache-DsDkdP72.mjs";
-import { n as easMachineStateRoot$1, o as removeEasSessionClaimAsync, r as readEasSessionLedger$1 } from "./eas-session-ledger-B0KLZx5m.mjs";
-import { At as mapLimited, Dt as createGcResults, Et as GC_OUTPUT, I as idleDeviceLines, M as collectIdleDevices, Mt as sizeConcurrency, N as collectIdleDevicesAsync, R as parseIdleDuration, a as collectOrphanedWorkspaces, b as workspaceInUseAsync, c as isInsideWorkspaces, f as rootPresence, g as ARTIFACT_DIRS, i as clearWorkspaceOutputs, jt as readConcurrency, kt as eachLimited, n as REBUILD_COST, o as collectWorkspaceOutputs, p as sizeText, r as WORKSPACE_OUTPUT_DIRS, s as deleteOrphanedWorkspaces, t as LIGHTEN_AFTER_MS, u as listWorkspaceDirs, v as withIdleWorkspace, wt as listBuildSlots, z as shutDownIdleDevices } from "./workspaces-CvSYD_78.mjs";
+import { $t as TRASH_MANIFEST, Ft as matchWorktreeEntry, Wt as resolveSourceCheckoutAsync, Zt as TRASH_CLAIMS, en as deleteTrashEntry, jt as listWorktreesAsync } from "./settings-C6UTYW2K.mjs";
+import { i as findProjectRoot$1, v as detectIsExpo } from "./project-DCLkDM8C.mjs";
+import { B as listOrphanedAvdDirectories, Et as readCreatedDevices$1, R as listAvdsAsync, Tt as forgetCreatedDeviceAsync, U as ownedAvdDirectory, bt as parkedMaxSetting, h as avdNameAbsent, mt as POOL_SETTING_REMEDY } from "./android-DsEj2CCs.mjs";
+import { $ as gradleVersionLines, $n as memoryCacheKind, B as includesArchives, Ct as describeError, En as runProcessOperation, F as gcOptionsOf, Ft as withEasProjectLock, G as planCacheEmptying, H as includesRecordings, J as selectsBeyondCaches, Jn as parseArchiveSelector, K as previewScopedEmptying, L as openGcLog, Q as deleteGradleVersions, St as deleteEasSessions, U as includesWorkspaceOutputs, V as includesParkedDevices, W as isWorkspacesScope, X as collectGradleVersions, Y as trimCaches, Zn as collectMemoryReport, _t as findStaleDeviceRecords, ar as scopedMemoryReport, at as DEVICE_LIST_TIMEOUT_MS, bt as withAndroidAvdSizes, ct as collectParkedSims, dt as deleteProjectDevices, er as memoryLines, et as gradleVersionsPending, fr as sizeCaches, gt as findOrphanedDevices, ht as eraseParkedDevices, ir as reclaimMemory, it as collectInventory, lt as deleteParkedAvds, mt as deviceSweepIsScoped, nr as memorySweepIsScoped, ot as collectDeviceLeases, pt as describeUnverifiableDevices, q as selectCaches, rr as memoryWorkPending, rt as getMachineCacheReport, sr as phase, st as collectParkedAvds, tr as memoryScope, tt as includesGradleVersions, ur as discoverCaches, ut as deleteParkedSims, vt as findStaleProjectDevices, wt as withRemoteSessionGcLocks, xt as collectEasSessionSweep, yt as unverifiedDeviceCommand, z as emptyCaches } from "./ccache-DVDO2ocE.mjs";
+import { n as easMachineStateRoot$1, o as removeEasSessionClaimAsync, r as readEasSessionLedger$1 } from "./eas-session-ledger-aFBLTZr2.mjs";
+import { At as mapLimited, Dt as createGcResults, Et as GC_OUTPUT, I as idleDeviceLines, M as collectIdleDevices, Mt as sizeConcurrency, N as collectIdleDevicesAsync, R as parseIdleDuration, a as collectOrphanedWorkspaces, b as workspaceInUseAsync, c as isInsideWorkspaces, f as rootPresence, g as ARTIFACT_DIRS, i as clearWorkspaceOutputs, jt as readConcurrency, kt as eachLimited, n as REBUILD_COST, o as collectWorkspaceOutputs, p as sizeText, r as WORKSPACE_OUTPUT_DIRS, s as deleteOrphanedWorkspaces, t as LIGHTEN_AFTER_MS, u as listWorkspaceDirs, v as withIdleWorkspace, wt as listBuildSlots, z as shutDownIdleDevices } from "./workspaces-BNEyJ1B_.mjs";
 import { t as canonicalPath } from "./paths-BsJMoPP2.mjs";
-import { N as listBuildLocks, k as removeExpiredLease } from "./activity-BR5oHSO5.mjs";
-import { d as listAllIosSims, f as listAllIosSimsAsync } from "./ios-CoMCWfub.mjs";
+import { N as listBuildLocks, k as removeExpiredLease } from "./activity-Dw4N_RFe.mjs";
+import { d as listAllIosSims, f as listAllIosSimsAsync } from "./ios-CdAV4-1E.mjs";
 import { t as resolveMaintenanceSettings } from "./settings-D9LtQaUw.mjs";
-import { r as readCollectors } from "./ownership-Dtz9G5Gl.mjs";
-import { A as deleteSelectedArchives, O as describeDereferenced, j as sweepArchiveStaging, k as reclaimProject } from "./worktree-CaQBf6kh.mjs";
-import { p as writeCacheFile } from "./warm-progress--KkkBBaq.mjs";
-import { a as restoreProblem, o as workspaceKeys } from "./lightened-vSxkstg6.mjs";
-import { C as candidateRootsAsync, D as worktreeRemovalReason, E as worktreePullRequestNote, S as maintenancePinned, T as removeWorktrees, _ as finishedWorkspaces, a as previewMaintenance, b as cachedDeviceActivity, c as deleteTempLeftovers, d as appRoots, f as artifactWorktrees, g as stopIdleWorkspace, h as planIdleStop, l as tempLeftoverLines, m as collectArtifactsAsync, o as triggeringRoot, p as clearArtifact, s as collectTempLeftovers, t as deleteIdleWorkspaceDevices, u as tempLeftoverSection, w as collectWorktreeSweep, x as cachedDeviceActivityAsync, y as ownedDeviceUsage } from "./act-CrTcskiE.mjs";
-import { i as getSwiftpmCacheUsage, n as swiftpmCacheLines, r as getAgentDeviceUsage, t as agentDeviceLines } from "./agent-device-usage-output-W0x4SoC7.mjs";
+import { r as readCollectors } from "./ownership-CCfiBfOP.mjs";
+import { A as deleteSelectedArchives, O as describeDereferenced, j as sweepArchiveStaging, k as reclaimProject } from "./worktree-BTrii9e_.mjs";
+import { p as writeCacheFile } from "./warm-progress-_aTMvkIH.mjs";
+import { a as restoreProblem, o as workspaceKeys } from "./lightened-DZ9Ip0T3.mjs";
+import { C as candidateRootsAsync, D as worktreeRemovalReason, E as worktreePullRequestNote, S as maintenancePinned, T as removeWorktrees, _ as finishedWorkspaces, a as previewMaintenance, b as cachedDeviceActivity, c as deleteTempLeftovers, d as appRoots, f as artifactWorktrees, g as stopIdleWorkspace, h as planIdleStop, l as tempLeftoverLines, m as collectArtifactsAsync, o as triggeringRoot, p as clearArtifact, s as collectTempLeftovers, t as deleteIdleWorkspaceDevices, u as tempLeftoverSection, w as collectWorktreeSweep, x as cachedDeviceActivityAsync, y as ownedDeviceUsage } from "./act-lcOIEy32.mjs";
+import { i as getSwiftpmCacheUsage, n as swiftpmCacheLines, r as getAgentDeviceUsage, t as agentDeviceLines } from "./agent-device-usage-output-Boie2yB-.mjs";
 import { claimRemoveCommand, isClaimRefusal, isClaimUnavailable, readClaimSet, releaseClaim, tryAcquireClaim } from "@stim-cli/core/ownership-claim";
 import { existsSync, lstatSync, readFileSync, readdirSync, statSync } from "node:fs";
 import { basename, dirname, isAbsolute, join, relative, resolve, sep } from "node:path";

package/dist/{gc-DjXwQXHK.mjs → gc-DASUa3Z_.mjs}

@@ -1,3 +1,3 @@
-import { _t as findStaleDeviceRecords, ft as describeParkedSims, gt as findOrphanedDevices, pt as describeUnverifiableDevices, q as selectCaches, ut as deleteParkedSims, vt as findStaleProjectDevices } from "./ccache-DsDkdP72.mjs";
-import { a as runGc, i as readGcReport, n as executeGc, o as withGcMaintenanceClaim, r as gcCommand, s as formatGcReport, t as collectGcReport } from "./gc-CKHqL4aS.mjs";
+import { _t as findStaleDeviceRecords, ft as describeParkedSims, gt as findOrphanedDevices, pt as describeUnverifiableDevices, q as selectCaches, ut as deleteParkedSims, vt as findStaleProjectDevices } from "./ccache-DVDO2ocE.mjs";
+import { a as runGc, i as readGcReport, n as executeGc, o as withGcMaintenanceClaim, r as gcCommand, s as formatGcReport, t as collectGcReport } from "./gc-B0K4d_PL.mjs";
 export { collectGcReport, gcCommand as default, deleteParkedSims, describeParkedSims, describeUnverifiableDevices, executeGc, findOrphanedDevices, findStaleDeviceRecords, findStaleProjectDevices, formatGcReport, readGcReport, runGc, selectCaches, withGcMaintenanceClaim };

package/dist/{guide-CeRlWVsS.mjs → guide-Civo5-zV.mjs}

@@ -1,8 +1,8 @@
-import { t as ANDROID_AVD_CONFIG_HELP } from "./settings-D776ygML.mjs";
-import { i as findProjectRoot$1 } from "./project-D1n0K4yg.mjs";
-import { h as RECENT_LAUNCH_MS } from "./eas-session-ledger-B0KLZx5m.mjs";
-import { o as guideStatus, t as WATCHMAN_NESTED_WORKTREES } from "./doctor-watchman-CJr2aXXv.mjs";
-import "./status-watch-okrpea4i.mjs";
+import { t as ANDROID_AVD_CONFIG_HELP } from "./settings-C6UTYW2K.mjs";
+import { i as findProjectRoot$1 } from "./project-DCLkDM8C.mjs";
+import { h as RECENT_LAUNCH_MS } from "./eas-session-ledger-aFBLTZr2.mjs";
+import { o as guideStatus, t as WATCHMAN_NESTED_WORKTREES } from "./doctor-watchman-DJY550yz.mjs";
+import "./status-watch-BwG4lJ1q.mjs";
 import { SETTINGS, SETTINGS_SCHEMA_URL, TUTORIAL_VERSION } from "@stim-cli/core/state";
 import chalk from "chalk";
 //#region src/guide/agent.ts
@@ -418,6 +418,7 @@ FULL TOPIC LIST
   stim guide lifecycle budget     # disk and memory budgets, automatic reclaim
   stim guide lifecycle options    # every flag, Android variants, --device-type, --system-image, --device-profile
   stim guide lifecycle devices    # ios --device and android --device on a physical phone
+  stim guide lifecycle tools      # device location|permission|push|network on the owned simulator or emulator
   stim guide lifecycle release    # Release configurations and ...Release variants
   stim guide api                  # typed run, stop, diagnostics and cancellation from the main package
   stim guide facts                # the --json payloads
@@ -703,7 +704,7 @@ Do not point independent Stim homes at a concurrently writable shared cache.
 //#endregion
 //#region src/guide/facts.ts
 const facts = {
-	summary: "The --json payloads: `start`, `ios`, `android`, `web`, `ios|android --plan`, `reload`, `stop`, `status`, `doctor`, `device lock`/`unlock`, `gc`, and the error contract",
+	summary: "The --json payloads: `start`, `ios`, `android`, `web`, `ios|android --plan`, `reload`, `stop`, `status`, `doctor`, `device lock`/`unlock`, `device location|permission|push|network`, `gc`, and the error contract",
 	preamble: () => `SLOTS
 Named ios/android runs add slot to their JSON facts. Default-run fields remain
 compatible. status adds a slots array per environment with each named slot's
@@ -713,7 +714,7 @@ Named collector, lease-holder, and launch keys use platform:slot internally.
 FACTS CONTRACT
 
 \`start\`, \`ios\`, \`android\`, \`web\`, \`reload\`, \`stop\`, \`status\`, \`stats\`, \`doctor\`,
-\`gc\`, and \`device lock\`/\`device unlock\` each print exactly ONE line of JSON on
+\`gc\`, \`device lock\`/\`device unlock\`, and \`device location|permission|push|network\` each print exactly ONE line of JSON on
 stdout for \`--json\`. Every other line goes to stderr, so it is always safe
 to pipe. \`logs --json\` is the one exception: it is NDJSON, one record per
 line by design (see \`guide logs\`), not this single-payload contract.
@@ -2503,8 +2504,9 @@ RULES
   \`guide lifecycle\`), so the sums can differ from what they sum.
 
   capacity.load is always present. capacity.builds is present only while
-  concurrency.maxBuilds is set, and capacity.devices only while
-  concurrency.maxDevices is set (see \`guide lifecycle concurrency\`):
+  concurrency.maxBuilds is set, capacity.devices only while
+  concurrency.maxDevices is set, and capacity.platformDevices only for the
+  platforms whose cap is set (see \`guide lifecycle concurrency\`):
 
   load     { cpus, loadPerCore, busyAt, limit, state }. loadPerCore is the
            5-minute load average divided by cpus, to one decimal. busyAt is
@@ -2527,6 +2529,11 @@ RULES
            device, with its device slot; for a device no workspace records,
            label is its name and workspace and slot are null. inUse is null
            and unknown says why when the devices could not be listed.
+  platformDevices  { ios?: { max, inUse, unknown? }, android?: { max, inUse,
+           unknown? } }, the booted owned simulators and emulators counted
+           against concurrency.maxIosDevices and concurrency.maxAndroidDevices.
+           Each key is present only while its cap is set, whether or not
+           concurrency.maxDevices is.
 
   The memory budget plans before a boot
   and always uses the estimate. What is using CPU and memory now is the
@@ -2667,7 +2674,9 @@ CAPACITY REFUSALS
   capacityRefusals?: [{ at, kind: "device", platform: "ios" | "android",
                        max, workspace }]
   Only device refusals with STIM_AT_CAPACITY are recorded; build caps wait.
-  at is the ISO timestamp, max is concurrency.maxDevices, and workspace is
+  at is the ISO timestamp, max is the cap of the limit that was full
+  (concurrency.maxDevices, or the platform's concurrency.maxIosDevices or
+  concurrency.maxAndroidDevices), and workspace is
   the workspace id used by status and Desktop. The list is newest first:
   the last 50 from the last 7 days, omitted when empty. Desktop uses events
   within 6 hours for its device-limit suggestion, including terminal runs.
@@ -4643,7 +4652,11 @@ so a Debug run on one is wired to a LAN origin instead of localhost.`,
   then until SpringBoard has finished starting, which \`simctl launch\` needs.
   Booted alone does not end that wait. The failure names the udid and the wait.
   After boot, a process-spawn probe must finish within 30 seconds before
-  installation. If it fails, the refusal includes observed host memory pressure
+  installation. A probe that times out while the simulator still reports Booted
+  is retried for about three minutes, since a loaded host can leave a booted
+  simulator unresponsive for a while; a timeout on a simulator that no longer
+  reports Booted, and any other probe failure, refuse at once. If it
+  fails, the refusal includes observed host memory pressure
   when available. Free memory before retrying under pressure; see
   \`stim guide lifecycle simslim\`. Booted alone does not prove readiness.
   The same probe lists the simulator's launchd jobs and requires a running
@@ -4715,6 +4728,35 @@ so a Debug run on one is wired to a LAN origin instead of localhost.`,
   no token left in its \`state.json\` (its workspace directory was recreated).
   The remedy for that last one is \`stim device unlock\`, which releases by
   holder rather than by token.`
+		},
+		STIM_DEVICE_TOOL_TARGET: {
+			summary: "a device tool found no owned, running simulator or emulator in that slot to act on",
+			body: () => `STIM_DEVICE_TOOL_TARGET
+  \`stim device location|permission|push|network\` act only on this workspace's
+  own local simulator or emulator in the slot. The message says which check
+  failed: the slot's device is hosted on another Mac, the workspace runs an
+  EAS Simulator session, the slot has no owned device (a physical device
+  reached with \`--device\` is never one), the recorded simulator is gone or not
+  owned by this Stim home, or it is not booted or running. Permission and push
+  also refuse when no app is recorded for the device. Run the platform command
+  the remedy names (\`stim ios\` or \`stim android\`, with \`--slot\` for a named
+  slot) and retry. No tool runs before this refusal.`
+		},
+		STIM_DEVICE_TOOL_UNSUPPORTED: {
+			summary: "that device tool has no equivalent on that platform",
+			body: () => `STIM_DEVICE_TOOL_UNSUPPORTED
+  The platform lacks the action: Android cannot clear a simulated location
+  (\`adb emu geo fix\` only sets one), iOS has no network switch, and Android
+  has no simulated push. The remedy names the nearest thing.`
+		},
+		STIM_DEVICE_TOOL_FAILED: {
+			summary: "simctl or adb failed, or the device did not report the change afterwards",
+			body: () => `STIM_DEVICE_TOOL_FAILED
+  The tool call exited non-zero or timed out, with its output in the message, or
+  the read-back after an Android permission or network change did not show the
+  requested state. For a permission, the app must declare the permission in its
+  manifest; when it declares none of the service's permissions the call refuses
+  with this code. Check the device with \`stim status\` and retry.`
 		},
 		STIM_DEVICE_WIRELESS_FAILED: {
 			summary: "an iPhone paired over Wi-Fi timed out or dropped during install or launch; use the cable",
@@ -4745,8 +4787,10 @@ so a Debug run on one is wired to a LAN origin instead of localhost.`,
 		STIM_AT_CAPACITY: {
 			summary: "owned-device slot wait timed out, or --no-wait reached the cap or queue",
 			body: () => `STIM_AT_CAPACITY
-  Only when concurrency.maxDevices is set (unset by default). New owned
-  devices queue in FIFO order across $STIM_HOME for 600 seconds by default.
+  Only when concurrency.maxDevices, concurrency.maxIosDevices or
+  concurrency.maxAndroidDevices is set (all unset by default). A boot must fit
+  its platform cap and concurrency.maxDevices; the message names the limit that
+  was full with its count and cap. New owned devices queue in FIFO order across $STIM_HOME for 600 seconds by default.
   This refusal means the wait expired, or \`--no-wait\` / \`--wait 0\`
   found the cap full or another run queued. The message gives the current
   count and, on timeout, how long it waited. iOS waits beside its build,
@@ -4764,7 +4808,10 @@ so a Debug run on one is wired to a LAN origin instead of localhost.`,
   --no-wait and --wait 0 refuse at once. Builds under remote-only refuse with
   STIM_OFFLOAD_REFUSED instead.
   Stop an environment (\`stim stop\`), pass a longer \`--wait <seconds>\`,
-  or raise concurrency.maxDevices. With --remote auto, remote.machines and
+  or raise the limit the message names (concurrency.maxDevices, or the
+  platform's concurrency.maxIosDevices / maxAndroidDevices). On a stim-server
+  worker the hosted offer and reserve name the full limit too, including
+  concurrency.maxMacosApps. With --remote auto, remote.machines and
   the opt-in remote.easFallback (billed EAS Simulator) are tried before this
   wait; \`stim logs --source placement\` says why neither took the run. Waiting prints holder names and elapsed
   time; status JSON exposes build.waitingFor independently of phase.
@@ -5734,8 +5781,11 @@ SpringBoard is back; an already slim simulator is not touched. Turn sound on
 for one device with Sound (iOS) or Media sound (Android) in its Stim Desktop
 options; the choice lasts until that device next boots. Android 14 and older images have no shell command that can
 set media volume, so startup warns, as it does whenever a mute is not
-confirmed. Host volume, Android alarm and ringtone volumes, hosted devices and
-physical devices are unchanged.
+confirmed. A hosted simulator or emulator on a named Mac is muted the same way
+after the host boots or adopts it (best effort; a failed mute is not reported
+to the client), and Stim Desktop's Sound options do not reach
+it. Host volume, Android alarm and ringtone volumes and physical devices are
+unchanged.
 
 Repeat step 3 whenever a NATIVE input changes. A JS-only edit needs nothing --
 that is what Fast Refresh over the running dev server is for. \`stim reload\` is
@@ -6282,7 +6332,7 @@ The same setup serves macos --remote and macos.remote. Approval is separate from
 and phone control. Set ios.remote to the machine name for a default (machine scope for every app on this machine);
 no flag or setting runs here. eas and proxy keep their remote backend meanings.
 --remote auto (or ios.remote = auto / android.remote = auto) stays here when
-there is a free concurrency.maxDevices slot (0 means unlimited), no device
+there is a free concurrency.maxDevices slot and platform cap slot (0 means unlimited), no device
 waiter ahead, normal host memory pressure, no budget shortfall,
 and 5-minute load per core below server.maxLoadPerCore. Without remote.machines,
 auto and remote are local and remote-only refuses with STIM_HOSTING_REFUSED. An unknown local device count also stays local; boot admission
@@ -6317,7 +6367,7 @@ when it names a machine, then remote.machines order, so the first listed host wi
 room fills before the next gets a run. Load and free memory do not rank hosts.
 Automatic build offload resolves later, after the device architecture is known.
 
-When no host admits and this machine is at its concurrency.maxDevices cap (or runs
+When no host admits and this machine is at its concurrency.maxDevices or per-platform cap (or runs
 are queued ahead), remote.easFallback (default false; EAS Simulator is billed)
 runs the device on an EAS Simulator exactly as --remote eas would: the build
 stays here, nothing starts an EAS cloud build, stop ends the session, and
@@ -6358,7 +6408,8 @@ refuses. The host boots headless and ignores this Mac's iosSimulatorApp setting.
 the offered simulator architecture, not this machine's. --remote-build remains
 independent and selects a compatible build worker for a Debug cache miss.
 
-The host's own owned devices count toward concurrency.maxDevices.
+The host's own owned devices count toward concurrency.maxDevices and its per-platform cap
+(concurrency.maxIosDevices, concurrency.maxAndroidDevices; hosted macOS apps use concurrency.maxMacosApps).
 
 The host's person sees Hosted here rows in stim-server devices; --json adds
 hostedSessions beside devices. Rows show client, platform, device, installed
@@ -7702,7 +7753,8 @@ OPT-IN CONCURRENCY LIMITS (UNLIMITED BY DEFAULT)
                             wait also records a capacityWaits event in stats,
                             with reclaimed when one or more devices were
                             shut down for it.
-                            While at the cap, only the queue head reclaims:
+                            While at the cap, only the queue head reclaims (or a run behind a
+                            head held back only by its own platform's cap):
                             it shuts down the longest-idle eligible owned
                             device in another workspace of this Stim home,
                             one per attempt, at most once every 15 seconds,
@@ -7722,6 +7774,35 @@ OPT-IN CONCURRENCY LIMITS (UNLIMITED BY DEFAULT)
                             and the command to remove that exact claim.
                             See \`guide errors STIM_AT_CAPACITY\`.
 
+    concurrency.maxIosDevices      booted owned iOS simulators at once.
+    concurrency.maxAndroidDevices  booted owned Android emulators at once.
+    concurrency.maxMacosApps       hosted macOS apps on a worker at once.
+                            Each is 0 (no per-platform limit) unless set, and
+                            each only tightens: a run must fit its platform's
+                            cap AND concurrency.maxDevices. maxDevices counts
+                            simulators and emulators together, local and
+                            hosted, and counts hosted macOS apps as a pool of
+                            their own, so a macOS app is bounded by
+                            maxMacosApps and by maxDevices, and never adds to
+                            the simulator and emulator total. Leaving the new
+                            settings unset changes no existing cap.
+                            Local admission applies the iOS and Android caps
+                            with the same queue and reclaim as maxDevices; a
+                            waiter held back only by its own platform's cap
+                            does not hold up a waiter of another platform.
+                            Reclaim for a full platform cap only shuts down
+                            devices of that platform. Hosted admission on a
+                            worker (offer and reserve) applies all three,
+                            counting the worker's local devices too.
+                            Local \`stim macos\` runs are not counted, so
+                            maxMacosApps limits hosted macOS apps only.
+                            A refusal names the full limit, its count and its
+                            cap, for example "1 Stim iOS simulator(s) are
+                            already booted and concurrency.maxIosDevices is 1".
+                            Status JSON capacity.platformDevices reports
+                            { max, inUse } for each of ios and android whose
+                            cap is set.
+
   \`stim doctor\` prints one note echoing the caps and the current active count,
   but ONLY when a cap is set. \`stim gc\` reports stale build slots the way it
   reports stale build locks, and \`gc --delete\` clears them. Set the caps
@@ -8453,6 +8534,60 @@ THE POOL: WHICH DEVICE AN ID-LESS \`--device\` PICKS
   The chosen device is on the phase line and in \`--json\` (\`udid\` or
   \`serial\`, plus \`deviceName\`), so an agent can hand the same id to its
   device tool.`
+		},
+		tools: {
+			summary: "device location, permission, push and network: change the owned simulator or emulator and read it back",
+			body: () => `  \`stim device location|permission|push|network\` change the workspace's own
+  simulator or emulator. Each takes the platform first, like \`device lock\`,
+  and \`--slot <name>\` and \`--json\`:
+
+    stim device location <ios|android> --set <lat,lng>   # --set 45.5,-73.6
+    stim device location ios --clear
+    stim device permission <ios|android> <grant|revoke|reset> <service>
+    stim device push ios --payload '<json with an "aps" key>'
+    stim device network android <on|off>
+
+  THE TARGET is the slot's owned, booted simulator or emulator, resolved the
+  way \`reload\` resolves it: the project record says \`owned\`, the ledger
+  agrees, and the serial belongs to the recorded AVD. A hosted device, an EAS
+  Simulator session, a physical device (\`--device\`), a device Stim does not
+  own, and a device that is not running refuse with STIM_DEVICE_TOOL_TARGET and
+  run no tool. An action the platform lacks (Android \`--clear\`, iOS network,
+  Android push) refuses with STIM_DEVICE_TOOL_UNSUPPORTED. A tool call that
+  fails, or a device that disagrees with the change afterwards, is
+  STIM_DEVICE_TOOL_FAILED. A bad value is STIM_BAD_ARG.
+
+  \`--set\` takes latitude and longitude as ONE value so a negative latitude is
+  not read as a flag. Android's \`adb emu geo fix\` takes longitude first; Stim
+  swaps them. The emulator has no way to clear a location.
+
+  \`permission\` acts on the app of the slot's last launch, else the project's
+  bundle id or Android package. iOS services are simctl's own: all, calendar,
+  contacts, contacts-limited, location, location-always, media-library,
+  microphone, motion, photos, photos-add, reminders, siri. iOS notifications
+  and camera are not simctl services. Android services are calendar, camera,
+  contacts, location, microphone, motion, notifications, photos; one service is
+  one or two \`pm\` permissions. A permission the app did not declare is
+  listed in \`skipped\` and the call succeeds when the app declares at least one;
+  an app that declares none is STIM_DEVICE_TOOL_FAILED.
+  \`push\` needs the app to hold notification permission on the simulator, which
+  \`simctl privacy\` cannot grant: without it simctl answers "Source is not
+  authorized" and the call is STIM_DEVICE_TOOL_FAILED; open the app and accept
+  its prompt.
+  Android \`reset\` revokes the permission and clears its user-set flags so
+  the app asks again. A grant needs one of the
+  service's permissions to read back granted; a revoke or reset needs all of
+  them not granted, and a reset also no USER_SET or USER_FIXED flag. Changing a
+  permission can terminate the running app on both platforms.
+
+  \`--json\` prints ONE line: { platform, slot, deviceId, deviceName, tool,
+  action, ..., readBack }. \`readBack\` is read from the device after the change:
+  Android permissions are { permissions: [{ name, granted }] } from
+  \`dumpsys package\`, and Android network is { wifi, data } from \`settings get
+  global wifi_on|mobile_data\`. \`readBack\` is null where the platform has no
+  read: iOS location, permission and push, and Android location. Then the exit
+  status of simctl or adb is the only confirmation; Stim never echoes the
+  request as a read-back.`
 		},
 		release: {
 			summary: "Release configurations and ...Release variants: Metro skipped, process-proven launch, the JS swap",
@@ -10130,7 +10265,7 @@ KEYS STIM READS
                         restores stock services when Stim applied the profile. Absolute paths, root or
                         symlink escapes, and missing files are refused before
                         simulator creation. Remote and unowned simulators are
-                        never changed.
+                        never slimmed.
   ios.signingIdentity   e.g. "Apple Development: Jane (TEAMID5678)" -- the
                         keychain identity to re-seal a \`--device\` build with,
                         overriding the one Stim derives from the artifact's own
@@ -10324,8 +10459,9 @@ ${ANDROID_AVD_CONFIG_HELP.map((line) => `                          ${line}`).joi
                         lifecycle hosted-android.
   remote.easFallback    true lets "auto" or "remote" (ios.remote, android.remote
                         or --remote) run the simulator or emulator on a
-                        billed EAS Simulator when this machine is at its
-                        concurrency.maxDevices cap (or has runs queued) and no
+                        billed EAS Simulator when this machine is at a
+                        device cap (concurrency.maxDevices or a per-platform
+                        cap, or has runs queued) and no
                         remote.machines entry takes the run, instead of waiting
                         or refusing with STIM_AT_CAPACITY. Default false. A
                         busy machine with a free slot never uses it. Stim checks
@@ -10559,12 +10695,20 @@ machine's. They live under a top-level \`concurrency\` key in
     "concurrency": { "maxBuilds": 2, "maxDevices": 3 }
   }
 
-The keys are concurrency.maxBuilds and concurrency.maxDevices.
+The keys are concurrency.maxBuilds and concurrency.maxDevices, plus the
+per-platform device caps concurrency.maxIosDevices,
+concurrency.maxAndroidDevices and concurrency.maxMacosApps. A boot must fit
+its platform cap and concurrency.maxDevices; the per-platform caps only
+tighten (see \`guide lifecycle concurrency\`).
 
 or via the environment, which overrides the file:
 
   STIM_MAX_BUILDS=2 STIM_MAX_DEVICES=3 stim ios
 
+  concurrency.maxIosDevices      STIM_MAX_IOS_DEVICES
+  concurrency.maxAndroidDevices  STIM_MAX_ANDROID_DEVICES
+  concurrency.maxMacosApps       STIM_MAX_MACOS_APPS
+
 Unset, 0, or any non-positive value means NO enforcement -- the default, where
 Stim limits nothing. See \`guide lifecycle concurrency\` for what each cap
 does.
@@ -10931,6 +11075,13 @@ answer, an incompatible Stim build, CPU, Xcode, simulator SDK or CocoaPods, no
 Bundler for an app whose Gemfile.lock pins CocoaPods, no iPhone simulator on
 the runtime \`stim ios\` builds for here, low disk, or busy. With Package.swift
 and no platform selection on a Mac, it also checks the macOS Xcode and SDK.
+A client with no Xcode and no simulator SDK, such as Linux or Windows, has no
+Xcode to match: the Mac's own Xcode, simulator SDK and CocoaPods are the
+build's toolchain, the client leaves pod install to it, and \`stim ios --remote
+<mac> --remote-build <mac>\` runs the app on that Mac's hosted simulator. If
+that pod install changes Podfile.lock or the Xcode project, the build fails
+with fingerprint-mismatch; run pod install once on a Mac and commit the
+result. A client with an Xcode still needs the same one.
 Two machines build for each other when their Stim releases share a build
 compatibility version, which changes only when what a worker builds, how it
 builds, or the build messages change; their Stim builds can differ. A
@@ -12186,10 +12337,9 @@ script such as mini-desktop.sh use these instead:
   quit                       stim stop (verified stop; the host frees the slot
                              and removes the app's defaults)
   clean                      stim worktree remove
-  3 concurrent slots         concurrency.maxDevices on the host; one bundle id
-                             slot per session
-
-The host's own owned devices count toward concurrency.maxDevices.
+  3 concurrent slots         concurrency.maxMacosApps and concurrency.maxDevices
+                             on the host, counted apart from simulators and
+                             emulators; one bundle id slot per session
 
 The agent-device rows work once the host's agent field names agent-device.
 

package/dist/{hosted-android-DI_vvv7U.mjs → hosted-android-CH1Sm4wo.mjs}

@@ -1,7 +1,7 @@
 import { c as throwIfCancelled } from "./exec-aULwtNly.mjs";
-import { c as call, l as connectHost } from "./hosted-client-CgoxdU9j.mjs";
-import { i as requestHostedMetro } from "./metro-request-BtF7ox53.mjs";
-import { a as stopHostedNative, i as prepareHostedNative, r as placeHostedNative } from "./hosted-native-DvZENAL-.mjs";
+import { c as call, l as connectHost } from "./hosted-client-5ur3YpxY.mjs";
+import { i as requestHostedMetro } from "./metro-request-RDhyx85c.mjs";
+import { a as stopHostedNative, i as prepareHostedNative, r as placeHostedNative } from "./hosted-native-kaR4nUHk.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-CgoxdU9j.mjs → hosted-client-5ur3YpxY.mjs}

@@ -1,7 +1,7 @@
 import { c as throwIfCancelled, o as cancellableSleep } from "./exec-aULwtNly.mjs";
-import { Y as diagnoseConnectFailure, st as resolveEndpoint } from "./config-AbUjIBOQ.mjs";
-import { t as BuildConnection } from "./client-BTUH8TF1.mjs";
-import { g as configuredMachines } from "./selection-D1ZDzHFX.mjs";
+import { X as diagnoseConnectFailure, ct as resolveEndpoint } from "./config-D5qNWJEP.mjs";
+import { t as BuildConnection } from "./client-DhJOvSvh.mjs";
+import { g as configuredMachines } from "./selection-C95m--1_.mjs";
 import { createHash } from "node:crypto";
 import { lstatSync, readFileSync, readdirSync, readlinkSync } from "node:fs";
 import { join } from "node:path";
@@ -232,25 +232,49 @@ function bundleManifest(bundle) {
 		content
 	};
 }
+/** stim-server answers one connection's requests in arrival order, so chunks sent in order reach it in order. */
+const UPLOAD_WINDOW = 64;
 async function upload(host, ids, missing, content) {
 	if (!Array.isArray(missing)) throw new Error(`${host.machine} answered device-host.app.offer without missing content.`);
-	for (const entry of missing) {
+	const files = missing.map((entry) => {
 		const read = isJsonObject(entry) && typeof entry.sha256 === "string" ? content.get(entry.sha256) : void 0;
-		if (!read || !isJsonObject(entry) || typeof entry.offset !== "number") throw new Error(`${host.machine} asked for content this app does not have.`);
-		const bytes = read();
-		let offset = entry.offset;
-		do {
-			const data = bytes.subarray(offset, offset + HOSTED_APP_CHUNK_BYTES).toString("base64");
+		if (!read || !isJsonObject(entry) || typeof entry.sha256 !== "string" || typeof entry.offset !== "number") throw new Error(`${host.machine} asked for content this app does not have.`);
+		return {
+			digest: entry.sha256,
+			start: entry.offset,
+			read
+		};
+	});
+	const inFlight = /* @__PURE__ */ new Set();
+	let failure;
+	const send = async (digest, offset, end, data) => {
+		try {
 			const next = (await call(host, "device-host.app.chunk", {
 				...ids,
-				sha256: entry.sha256,
+				sha256: digest,
 				offset,
 				data
 			})).offset;
-			if (typeof next !== "number" || next <= offset && next !== bytes.length) throw new Error(`${host.machine} did not accept app content at byte ${offset}.`);
-			offset = next;
+			if (typeof next !== "number" || next < end) throw new Error(`${host.machine} did not accept app content at byte ${offset}.`);
+		} catch (error) {
+			failure ??= error instanceof Error ? error : new Error(String(error));
+		}
+	};
+	for (const { digest, start, read } of files) {
+		if (failure) break;
+		const bytes = read();
+		let offset = start;
+		do {
+			if (inFlight.size >= UPLOAD_WINDOW) await Promise.race(inFlight);
+			if (failure) break;
+			const end = Math.min(offset + HOSTED_APP_CHUNK_BYTES, bytes.length);
+			const pending = send(digest, offset, end, bytes.subarray(offset, end).toString("base64")).finally(() => inFlight.delete(pending));
+			inFlight.add(pending);
+			offset = end;
 		} while (offset < bytes.length);
 	}
+	await Promise.all(inFlight);
+	if (failure) throw failure;
 }
 //#endregion
 export { stoppedSession as _, SESSION_TIMEOUT_MS as a, call as c, hostConnector as d, hostedSession as f, sha256 as g, settle as h, RESERVE_TIMEOUT_MS as i, connectHost as l, requireHostedAppMode as m, OFFER_TIMEOUT_MS as n, attach as o, probeHostedSession as p, PREPARE_TIMEOUT_MS as r, bundleManifest as s, INSTALL_TIMEOUT_MS as t, heldNoLonger as u, unknownSession as v, upload as y };

package/dist/{hosted-logs-C-4INmkn.mjs → hosted-logs-BYg4yeti.mjs}

@@ -1,11 +1,11 @@
 import { t as getExecutor } from "./exec-aULwtNly.mjs";
-import { E as workspaceDir, k as workspaceLogsDir$1 } from "./workspace-state-DGwkPXwq.mjs";
-import { B as deviceSlotFileKey, it as parseMachine$1, q as validateDeviceSlot } from "./config-AbUjIBOQ.mjs";
-import { l as phaseLine } from "./command-output-DjCsmzLZ.mjs";
-import { n as macosDir } from "./state-C2AUjjhg.mjs";
-import { n as androidLogGroups, r as isAndroidCrashText } from "./android-CLU_MMnb.mjs";
+import { E as workspaceDir, k as workspaceLogsDir$1 } from "./workspace-state-3bF4TB8P.mjs";
+import { J as validateDeviceSlot, V as deviceSlotFileKey, at as parseMachine$1 } from "./config-D5qNWJEP.mjs";
+import { l as phaseLine } from "./command-output-VrXd6qPX.mjs";
+import { n as macosDir } from "./state-CiflgxTP.mjs";
+import { n as androidLogGroups, r as isAndroidCrashText } from "./android-BeeC15Ve.mjs";
 import { c as readNdjsonGenerations$1, i as createNdjsonWriter } from "./ndjson-CrjIsGzw.mjs";
-import { c as call } from "./hosted-client-CgoxdU9j.mjs";
+import { c as call } from "./hosted-client-5ur3YpxY.mjs";
 import { mkdirSync, readFileSync, realpathSync, renameSync, rmSync, writeFileSync } from "node:fs";
 import { dirname, join } from "node:path";
 import { LOG_ROTATE_BYTES, ambientWrite, withDirLockAsync } from "@stim-cli/core";