@stim-cli/core 1.27.0 → 1.29.0

package/dist/{index-DfpdqDFf.d.mts → index-BYn5zs27.d.mts}

@@ -160,690 +160,690 @@ interface MachineCacheUsage {
 declare function machineCacheUsageFile(): string;
 declare function readMachineCacheUsage(): MachineCacheUsage | null;
 //#endregion
-//#region state/build-capacity.d.ts
-declare function buildSlotsDir(): string;
-declare function buildSlotPath(index: number): string;
+//#region state/hosted-app.d.ts
+interface HostedAppFile {
+  path: string;
+  kind: "file" | "exec" | "link";
+  size: number;
+  sha256: string;
+}
+interface HostedAppOffer {
+  session: string;
+  attempt: string;
+  bundleId: string;
+  mode: "development" | "release" | "process";
+  devClientScheme?: string;
+  arguments?: string[];
+  manifest: {
+    sha256: string;
+    size: number;
+  };
+}
+interface HostedAppDelivery extends Omit<HostedAppOffer, "manifest"> {
+  state: "receiving" | "installing" | "installed" | "unknown";
+  launched: true | "unverified" | null;
+  notice?: string;
+}
+interface HostedAppRecord extends HostedAppDelivery {
+  manifest: HostedAppOffer["manifest"];
+  files: HostedAppFile[];
+}
+declare const HOSTED_APP_CHUNK_BYTES: number;
+declare function hostedAppAttempt(value: unknown): value is string;
+declare function hostedAppArea(session: string, attempt: string, workerHome?: string): string;
+declare function hostedAppBlobs(session: string, workerHome?: string): string;
+/** Transfers cached verification after a rename, only for the same inode, size, mtime and digest. */
+declare function rememberHostedAppBlobRename(from: string, to: string, file: {
+  size: number;
+  sha256: string;
+}): void;
+/** Checks regular blob bytes, including their size, before content-addressed reuse. */
+declare function validHostedAppBlob(path: string, file: {
+  size: number;
+  sha256: string;
+}): boolean;
+/** At most 32 plain arguments of 1024 characters (8192 in total), with no NUL, CR or LF. */
+declare function validHostedAppArguments(value: unknown): value is string[];
+declare function parseHostedAppOffer(value: unknown): HostedAppOffer | null;
+/** Relative normalized paths, with no file or link as another entry's ancestor. */
+declare function parseHostedAppManifest(value: unknown): HostedAppFile[] | null;
+/** Reads a server-written receipt; malformed or missing established state remains unresolved. */
+declare function readHostedAppMetadata(session: string, attempt: string, workerHome?: string): Omit<HostedAppRecord, "files">;
+declare function readHostedApp(session: string, attempt: string, workerHome?: string): HostedAppRecord;
+//#endregion
+//#region state/hosted-macos.d.ts
+/** App slots one host offers; a slot names the host-assigned bundle id `<bundleId>.hosted<slot>`. */
+declare const HOSTED_MACOS_APP_SLOTS = 64;
+/** The drivers `hosting.agentDriver` can name: `none` and the first-party driver packages stim-server ships. */
+declare const HOSTED_AGENT_DRIVERS: readonly ["none", "agent-device"];
+type HostedAgentDriverName = (typeof HOSTED_AGENT_DRIVERS)[number];
+/** A driver name a grant or access record can carry; a client resolves only the drivers it knows. */
+declare function hostedAgentDriverName(value: unknown): value is string;
+/** What a host reports in a macOS offer: no simulator is created, so the choice is the host itself. */
+interface HostedMacosChoice {
+  architecture: "arm64" | "x86_64";
+  macosVersion: string;
+}
+/** A ready hosted macOS session's identity: the host it runs on and the app slot reserved for it. */
+interface HostedMacosDevice extends HostedMacosChoice {
+  appSlot: number;
+}
 /**
- * Takes the first free one of `max` `concurrency.maxBuilds` slots, recording `details` and the slot `index`. Returns
- * null while every slot is held; throws the claim refusal when no slot is busy but one cannot be resolved.
+ * The agent-device lease owner scope a client names on every request. `deviceKey` is `<bundleId>@<pid>`
+ * for a macOS app, or `ios:mobile:<udid>` with `backend: ios-instance` for a hosted simulator, or `android:mobile:<serial>` with `backend: android-instance` for a hosted emulator.
  */
-declare function tryAcquireBuildSlotClaim({ max, details }: {
-  max: number;
-  details: Record<string, unknown>;
-}): {
-  claim: ClaimHandle;
-  index: number;
-  path: string;
-} | null;
+interface HostedAgentLease {
+  tenant: string;
+  runId: string;
+  clientId: string;
+  deviceKey: string;
+  backend?: "ios-instance" | "android-instance";
+}
 /**
- * How busy this machine is for native builds. `loadPerCore` is the 5-minute load average divided by the CPU count,
- * rounded to one decimal. `builds` counts this Stim home's runs that hold a live native-run claim and are in
- * prebuild, pods or compile here, not on a remote machine, plus the build slots this machine holds for other machines'
- * offloaded builds. `maxBuilds` is `concurrency.maxBuilds`, 0 when unlimited.
+ * Agent control a driver issues for one installed hosted app. `path` is the session's base route on the host,
+ * `scope` the driver's handle that limits it to this one app, and `lease`, for a driver that allocates leases,
+ * the scope that pins the allocation.
  */
-interface MachineCapacity {
-  cpus: number;
-  loadPerCore: number;
-  builds: number;
-  maxBuilds: number;
-  maxLoadPerCore: number;
+interface HostedAgentIssuedGrant {
+  driver: string;
+  path: string;
+  token: string;
+  scope: string;
+  lease?: HostedAgentLease;
 }
-declare function maxLoadPerCore(): number;
-declare function machineCapacity(): MachineCapacity;
-/** Why a machine with this capacity should not take another native build; null when it can. */
-declare function saturation(capacity: MachineCapacity): string | null;
-//#endregion
-//#region state/build-machines.d.ts
 /**
- * What this machine keeps about a remote machine it asked for access. `machine` is the `remote.machines` entry and
- * `address` the name it resolved to. Once approved, `serverKey` is the worker's pinned stim-server key: every later
- * connection must prove it holds that key. While pending, `ticket` is the setup ticket this machine generated or was
- * given, and `expiresAt` its expiry when known. Records of protocol 1, which pinned a tailnet node, are not read.
+ * Agent control the host grants a client for one installed hosted app, sent only over that client's approved
+ * device-host connection and never journaled. `none` means the host's `hosting.agentDriver` starts no driver.
  */
-interface MachineCredential {
+type HostedAgentGrant = {
+  driver: "none";
+} | HostedAgentIssuedGrant;
+/** `app.launch` and `app.attach` results; a host includes `agent` once the app is installed. */
+type HostedAppLaunch = HostedAppDelivery & {
+  agent?: HostedAgentGrant;
+};
+/**
+ * Agent control as the client hands it to a coding agent: secrets stay in files Stim writes with mode
+ * 0600, and `command` shows how to address the hosted app. Never carries a token inline. `setting` names
+ * the hosting Mac's setting that turns a driver on.
+ */
+type HostedAgentAccess = {
+  driver: "none";
+  setting: "hosting.agentDriver";
+} | {
+  driver: string;
+  remoteConfig: string;
+  command: string;
+};
+/** Where a workspace's macOS app runs when `stim macos --remote` placed it on another Mac. */
+interface HostedMacosPlacement {
   machine: string;
-  transport: "tailscale";
-  address: string;
-  state: "pending" | "approved";
-  requestedAt: string;
-  serverKey?: string;
-  deviceId?: string;
-  ticket?: string;
-  expiresAt?: string;
+  session: string;
+  appSlot: number;
+  appAttempt: string;
+  /** The host-assigned id the running app uses, `hostedMacosBundleId(<offered id>, appSlot)`. */
+  bundleId: string;
+  agent: HostedAgentAccess;
 }
-type BuildMachineCredential = MachineCredential;
-declare const MACHINE_CREDENTIALS_VERSION = 2;
-/** A stored credential, or null when it is malformed or from an older version. */
-declare function parseMachineCredential(value: unknown): MachineCredential | null;
-declare function readBuildMachines(): BuildMachineCredential[];
-//#endregion
-//#region state/client-identity.d.ts
-/** This machine's long-term X25519 key as a client of other machines, in `$STIM_HOME/client-identity.key`. */
-declare function clientIdentity(): NoiseKeyPair;
+declare function hostedMacosAppSlot(value: unknown): value is number;
+declare function hostedMacosBundleId(bundleId: string, appSlot: number): string;
+declare function parseHostedMacosChoice(value: unknown): HostedMacosChoice | null;
+declare function parseHostedMacosDevice(value: unknown): HostedMacosDevice | null;
+/** A grant naming a driver this client does not know is not usable; it parses as null. */
+declare function parseHostedAgentGrant(value: unknown): HostedAgentGrant | null;
+declare function parseHostedAgentAccess(value: unknown): HostedAgentAccess | null;
+declare function parseHostedMacosPlacement(value: unknown): HostedMacosPlacement | null;
 //#endregion
-//#region state/config-types.d.ts
-type SettingsObject = Record<string, unknown>;
-interface SupervisorRecord {
-  processToken?: string;
-  pid?: number;
-  port?: number;
-  startedAt?: string;
-  serverPid?: number;
-  mode?: string;
-  [key: string]: unknown;
+//#region state/device-host.d.ts
+type HostedDevicePlatform = "ios" | "android" | "macos";
+/** Deadlines stim-server gives each hosted worker run. Clients derive their waits from these. */
+interface DeviceHostLimits {
+  prepareMs: number;
+  offerMs: number;
+  stopMs: number;
+  logsMs: number;
+  killGraceMs: number;
 }
-interface IosDeviceRecord {
-  deviceUdid?: string;
-  deviceName?: string | null;
-  owned?: boolean;
-  serial?: string;
-  simslimManaged?: boolean;
-  simslimApplied?: {
-    profile: string;
-    springBoardPid: number;
-  };
-  schemeApprovals?: string[];
-  [key: string]: unknown;
+declare const DEVICE_HOST_LIMITS: Readonly<DeviceHostLimits>;
+/** How many parked sessions one reserve inspects, and possibly retires, before it creates a device. */
+declare const HOSTED_PARKED_CANDIDATES: number;
+/** How long a cancelled hosted worker run can take to settle: SIGTERM, SIGKILL after the grace, then it is abandoned. */
+declare function hostedWorkerSettleMs(limits?: Pick<DeviceHostLimits, "killGraceMs">): number;
+interface HostedIosChoice {
+  deviceTypeId: string;
+  runtimeId: string;
+  deviceType: string;
+  runtime: string;
+  architecture: "arm64" | "x86_64";
 }
-interface AndroidDeviceRecord {
-  avdName?: string;
-  consolePort?: number;
-  serial?: string;
-  kind?: string;
-  deviceName?: string | null;
-  owned?: boolean;
-  setupIncomplete?: boolean;
-  bootPending?: boolean;
-  [key: string]: unknown;
+interface HostedIosDevice extends HostedIosChoice {
+  udid: string;
+  name: string;
 }
-type DeviceRecord = IosDeviceRecord | AndroidDeviceRecord;
-interface PlatformRecords {
-  ios?: IosDeviceRecord;
-  android?: AndroidDeviceRecord;
-  [platform: string]: DeviceRecord | undefined;
+interface HostedAndroidChoice {
+  systemImage: string;
+  deviceProfile: string;
+  architecture: "arm64-v8a" | "x86_64";
 }
-interface ProjectRecord {
-  ports?: Record<string, number>;
-  metroPort?: number | null;
-  platforms?: PlatformRecords;
-  deviceSlots?: Record<string, PlatformRecords>;
-  supervisor?: SupervisorRecord;
-  settings?: SettingsObject;
-  worktreeRoot?: boolean;
-  worktreeBranch?: string;
-  worktreeBranchOwned?: boolean;
-  worktreeMainRoot?: string;
-  worktreeRemovalComplete?: boolean;
-  worktreePendingBranchSha?: string;
-  label?: string;
-  bundleId?: string;
-  androidPackage?: string;
-  isExpo?: boolean;
-  lastBuild?: Record<string, unknown>;
-  doctorRuns?: Partial<Record<"ios" | "android", DoctorRunRecord>>;
-  [key: string]: unknown;
-}
-interface DoctorRunRecord {
-  at: string;
-  version: string;
+interface HostedAndroidDevice extends HostedAndroidChoice {
+  avdName: string;
+  serial: string;
+  consolePort: number;
 }
-interface RepoRecord {
-  settings?: SettingsObject;
-  [key: string]: unknown;
+type HostedDevice = HostedIosDevice | HostedAndroidDevice | HostedMacosDevice;
+interface HostedDeviceSelectors {
+  deviceType?: string;
+  runtime?: string;
+  systemImage?: string;
+  deviceProfile?: string;
 }
-interface ConcurrencyLimits {
-  maxBuilds: number;
-  maxDevices: number;
+interface HostedDeviceOfferRequest extends HostedDeviceSelectors {
+  platform: HostedDevicePlatform;
 }
-interface StimConfig {
-  version?: number;
-  homeId?: string;
-  projects: Record<string, ProjectRecord>;
-  repos: Record<string, RepoRecord>;
-  tempDir?: unknown;
-  iosSimulatorApp?: unknown;
-  androidEmulatorApp?: unknown;
-  optimizations?: unknown;
-  concurrency?: {
-    maxBuilds?: unknown;
-    maxDevices?: unknown;
+type HostedNativeOffer = {
+  resources: {
+    cpus: number;
+    /** Five-minute system load divided by available CPU count. */
+    loadPerCore: number;
+    maxLoadPerCore?: number;
+    memoryFreeBytes: number;
+    memoryPressure: "normal" | "warning" | "critical" | null;
+    /** Available bytes on the Stim home volume, not necessarily the Android AVD volume. */
+    workerDiskFreeBytes: number | null;
+    localDevices?: number | {
+      unknown: string;
+    };
   };
-  pool?: {
-    iosParkedMax?: unknown;
-    androidParkedMax?: unknown;
+  declined: string | null;
+} & ({
+  platform: "ios";
+  choice: HostedIosChoice | null;
+} | {
+  platform: "android";
+  choice: HostedAndroidChoice | null;
+} | {
+  platform: "macos";
+  choice: HostedMacosChoice | null;
+});
+type HostedDeviceOffer = HostedNativeOffer & {
+  capacity: {
+    running: number;
+    max: number;
+    available: number | null;
+    local?: number | {
+      unknown: string;
+    };
   };
+};
+interface HostedDeviceRequest extends HostedDeviceOfferRequest {
+  workspace: string;
+  slot: string;
+  attempt: string;
+}
+type HostedDevicePhase = "preparing" | "ready" | "stopping" | "stopped" | "unknown";
+interface HostedDeviceSession extends HostedDeviceRequest {
+  id: string;
+  client: string;
+  state: HostedDevicePhase;
+  device: HostedDevice | null;
+  consolePort?: number;
+  appSlot?: number;
+  createdAt: string;
   parked?: {
-    ios?: unknown;
-    android?: unknown;
-  };
-  caches?: {
-    buildCache?: unknown;
-    metroCache?: unknown;
-  };
-  hosting?: {
-    agentDriver?: unknown;
-  };
-  debug?: {
-    logs?: unknown;
-  };
-  server?: {
-    buildsPaused?: unknown;
-    devicesPaused?: unknown;
-    acceptClientBuilds?: unknown;
-    maxLoadPerCore?: unknown;
-    workerRoot?: unknown;
-    gradleDaemonIdleMinutes?: unknown;
-  };
-  remote?: {
-    machines?: unknown;
-    easMaxDurationMinutes?: unknown;
-    build?: unknown;
-    buildPoolDisabled?: unknown;
-    devicePoolDisabled?: unknown;
+    at: string;
   };
-  [key: string]: unknown;
+  notice?: string;
+  appAttempt?: string;
+  agent?: HostedAgentGrant;
+  metroPort?: number;
+  clientMetroPort?: number;
 }
-type Config = StimConfig;
-//#endregion
-//#region state/automatic-pools.d.ts
-type AutomaticPoolRole = "build" | "device";
-declare function automaticMachineEnabled(role: AutomaticPoolRole, machine: string, config?: StimConfig | null): boolean;
-declare function requireAutomaticMachine(role: AutomaticPoolRole, machine: string): void;
-/**
- * Refuses a pool with no enabled member: local, or a configured remote approved for the role. `canHost` excludes
- * device-pool remotes that can never host, such as a Linux machine.
- */
-declare function validateAutomaticPool(role: AutomaticPoolRole, config: StimConfig, canHost?: (machine: string) => boolean): void;
+declare function deviceHostRoot(): string;
+declare function deviceHostArea(id: string): string;
+declare function parseHostedChoice(value: unknown): HostedIosChoice | null;
+declare function parseHostedDevice(value: unknown): HostedIosDevice | null;
+declare function parseHostedAndroidDevice(value: unknown): HostedAndroidDevice | null;
+/** Android Emulator -help-port defines the supported even console ports as 5554 through 5584. */
+declare function hostedConsolePort(value: unknown): value is number;
+declare function parseHostedPlatformDevice(value: unknown, platform: HostedDevicePlatform): HostedDevice | null;
+declare function hostedDeviceId(device: HostedDevice): string;
+declare function parseHostedRequest(value: unknown): HostedDeviceRequest | null;
+declare function parseHostedOfferRequest(value: unknown): HostedDeviceOfferRequest | null;
+declare function parseHostedLocalDeviceCount(value: unknown): number | {
+  unknown: string;
+} | null;
+declare function parseHostedNativeOffer(value: unknown): HostedNativeOffer | null;
+/** A missing established journal or malformed record is a refusal, never an empty reservation set. */
+declare function readHostedSessions(): HostedDeviceSession[];
+/** The private worker's exact device record; an absent record is unresolved after creation started. */
+declare function readHostedDevice(home: string): HostedIosDevice;
+declare function readHostedDevice(home: string, platform: "android"): HostedAndroidDevice;
+declare function readHostedDevice(home: string, platform: "macos"): HostedMacosDevice;
+declare function readHostedDevice(home: string, platform: HostedDevicePlatform): HostedDevice;
+declare function readHostedDeviceLedger(home: string, options?: {
+  required?: boolean;
+}): {
+  ios: string[];
+  android: string[];
+  web: string[];
+} | null;
+/** Hosted sessions use isolated homes: only one exact device of their platform may appear in this ledger. */
+declare function assertHostedDeviceLedger(home: string, id: string, platform?: HostedDevicePlatform, options?: {
+  allowEmpty?: boolean;
+}): "listed" | "empty";
 //#endregion
-//#region state/config.d.ts
-declare function withConfigLock<T>(fn: () => T): T;
-/** Waits for the config lock without blocking the event loop. The signal cancels acquisition; `fn` runs synchronously. */
-declare function withConfigLockAsync<T>(fn: () => T, signal?: AbortSignal): Promise<T>;
-declare function configCorruptRepair(path?: string): string;
-/** The build worker root: `server.workerRoot` when it is absolute, else `$STIM_HOME/build-worker`. */
-declare function buildWorkerRoot(config?: Config | null): string;
-/**
- * A short directory at the drive root that stands in for the build worker directory `path` on Windows. The NDK's
- * ninja is not long-path aware (STIM_PATH_TOO_LONG), and it opens paths under the checkout and under the Gradle user
- * home's transforms cache, both of which are too long under the worker root. A subst drive does not help: Node's
- * native realpath, which expo-modules-autolinking uses, resolves it back to the long path.
- */
-declare function windowsShortDir(path: string, systemDrive?: string): string;
-/** The ASCII key a Windows build worker records beside a `windowsShortDir` to tell which `kind` and `path` it serves. */
-declare function windowsShortDirKey(kind: "checkout" | "gradle", path: string): string;
-declare function loadConfig(): Config | null;
-declare function getProject(projectPath: string): ProjectRecord | null;
-declare function getConcurrencyLimits({ env }?: {
-  env?: NodeJS.ProcessEnv;
-}): ConcurrencyLimits;
-interface ParkedMax {
-  max: number;
-  error: string | null;
+//#region state/workspace-state.d.ts
+interface WorkspaceState {
+  supervisor?: Record<string, unknown>;
+  collectors?: Record<string, unknown>;
+  lastBuild?: Record<string, unknown>;
+  launches?: Record<string, unknown>;
+  remoteDevice?: Record<string, unknown>;
+  metroTunnel?: Record<string, unknown>;
+  [key: string]: unknown;
 }
-declare function getParkedMax(platform: "ios" | "android", { config, env }?: {
-  config?: Config | null;
-  env?: NodeJS.ProcessEnv;
-}): ParkedMax;
-declare function getProjectSettings(projectPath: string): Record<string, unknown>;
-declare function getRepoSettings(gitCommonDir: string): Record<string, unknown>;
-declare function isPathPrefix(prefix: string, path: string): boolean;
-declare function findEnclosingWorktreeRoot(projectPath: string): string | null;
-declare function allMetroPorts(): number[];
-//#endregion
-//#region state/debug-log.d.ts
-declare const DEBUG_ENV = "STIM_DEBUG";
-declare function debugLogDir(): string;
-/** The `STIM_DEBUG` override (1/true on, 0/false off, anything else off), else the machine setting `debug.logs`. Never throws. */
-declare function debugLoggingEnabled(env?: NodeJS.ProcessEnv): boolean;
-interface DebugLog {
-  /** Whether debug logging is on right now; re-read every few seconds so a long-running process follows the setting. */
-  enabled(): boolean;
-  /** Appends one record to `$STIM_HOME/logs/debug/<component>.ndjson` when enabled. Never throws; keys that look like secrets are redacted. */
-  log(event: string, fields?: Record<string, unknown>): void;
+declare const IDLE_STOP_KEY = "devServerStop";
+/** Why the supervisor last stopped the dev server on its own: `metro.idleStopMinutes` with no use. */
+interface IdleStopRecord {
+  reason: "idle";
+  at: string;
+  idleMinutes: number;
+}
+declare function readIdleStop(state: WorkspaceState | null | undefined): IdleStopRecord | null;
+declare const DEVICE_RECLAIM_REASON = "reclaimed for a waiting run";
+declare const DEVICE_IDLE_SHUTDOWN_KEY = "deviceIdleShutdowns";
+/** An owned simulator or emulator shut down after being idle. */
+interface DeviceIdleShutdownRecord {
+  at: string;
+  idleMinutes: number;
+  reason?: string;
+}
+/** The recorded idle shutdowns by device slot key (`ios`, `android`, `ios:<slot>`). */
+declare function readDeviceIdleShutdowns(state: WorkspaceState | null | undefined): Record<string, DeviceIdleShutdownRecord>;
+declare const DEV_SERVER_STOP_REQUEST_KEY = "devServerStopRequest";
+/** A Stim component's intent to stop the supervisor with `processToken`, written before it signals. */
+interface DevServerStopRequest {
+  processToken: string;
+  by: string;
+  pid: number;
+  at: string;
+  workspace?: string;
 }
+declare function readDevServerStopRequest(state: WorkspaceState | null | undefined): DevServerStopRequest | null;
 /**
- * Debug-level records for one component (`cli` or `server`). Off by default; `STIM_DEBUG=1` or `debug.logs` turns it
- * on. Callers pass names, durations and codes, never arguments, environment values, tokens or tickets.
+ * Why the dev server last stopped, stored under `IDLE_STOP_KEY`. `requested` names the Stim component that
+ * asked; `signal` is a SIGTERM or SIGINT no Stim component asked for; `server-exited` is the dev server
+ * process exiting on its own.
  */
-declare function createDebugLog(component: "cli" | "server", { env, now, base }?: {
-  env?: NodeJS.ProcessEnv;
-  now?: () => number;
-  base?: () => Record<string, unknown>;
-}): DebugLog;
-//#endregion
-//#region state/trace.d.ts
-declare const TRACE_ENV = "STIM_TRACE";
-/**
- * `args` with the value of any flag or assignment that looks like a secret, credentials in URLs, token shapes and
- * the `exact` values replaced. `program` selects the flags that carry a credential without a secret-looking name,
- * such as `curl -u`.
- */
-declare function redactArgv(args: readonly string[], exact?: readonly string[], program?: string): string[];
-/** A shell command line with the same redactions as `redactArgv`, clipped to a fixed length. */
-declare function redactCommandLine(command: string, exact?: readonly string[]): string;
-type TraceArgs = Record<string, unknown>;
-type EndSpan = (args?: TraceArgs) => void;
-type Args = TraceArgs;
-interface TracePhases {
-  /** Ends the phase in progress and starts `name`; entering the phase already in progress does nothing. */
-  enter(name: string, args?: Args): void;
-  end(args?: Args): void;
-}
-interface Trace {
-  enabled(): boolean;
-  /** Starts a span; the returned function ends it, with optional extra args. */
-  begin(name: string, args?: TraceArgs): EndSpan;
-  /** `begin` for the outermost span of a process: it ends at exit with the exit code. */
-  command(name: string, args?: TraceArgs): void;
-  /** `begin` for a child process: same event with the `exec` category. */
-  beginExec(name: string, args?: TraceArgs): EndSpan;
-  /** Runs `fn` inside a span and ends it when `fn` returns or throws. */
-  span<T>(name: string, fn: () => T, args?: TraceArgs): T;
-  /** `span` for an async `fn`: ends when its promise settles. */
-  spanAsync<T>(name: string, fn: () => Promise<T>, args?: TraceArgs): Promise<T>;
-  mark(name: string, args?: TraceArgs): void;
-  /** A strip of consecutive, non-overlapping phases on its own track. */
-  phases(track: string): TracePhases;
-}
+type DevServerStopRecord = IdleStopRecord | {
+  reason: "requested";
+  at: string;
+  by: string;
+  byPid: number;
+  byWorkspace?: string;
+} | {
+  reason: "signal";
+  at: string;
+  signal: string;
+} | {
+  reason: "server-exited";
+  at: string;
+  mode: string;
+  code: number | null;
+  signal: string | null;
+};
+/** A stopped dev server's last cause in status; `vanished` is a supervisor proven gone that recorded none. */
+type MetroLastStop = DevServerStopRecord | {
+  reason: "vanished";
+  pid: number;
+  startedAt: string | null;
+};
+declare function readDevServerStop(state: WorkspaceState | null | undefined): DevServerStopRecord | null;
+/** Each platform's latest run; `lastBuild` holds whichever platform ran last. */
+declare const LAST_BUILD_KEYS: Readonly<Record<StatsPlatform, string>>;
+declare const BUILD_HISTORY_KEY = "buildHistory";
+declare const BUILD_HISTORY_LIMIT = 10;
+/** A recorded miss reason in the shape status reports, without `baseline.cacheKey`; null when malformed. */
+declare function parseMissReason(value: unknown): BuildMissReason | null;
 /**
- * Timing spans for one stim process tree, written as Chrome trace events (open the file in Perfetto or
- * chrome://tracing) when `STIM_TRACE=<path>` is set. Unset, every call is one environment check. A stim command
- * (`trace.command`) truncates the file and writes `[`; every other process that inherits the variable appends one
- * event per line, creating the file if it is missing, so the file has no closing bracket. Child process arguments are written through `redactArgv`.
+ * The first diagnostics of a failed build in the shape a last-build record stores and `status` reports, the
+ * ones with a source position first.
  */
-declare const trace: Trace;
-//#endregion
-//#region state/home-identity.d.ts
-/** The persistent, nonsecret identity of this Stim home; null until the CLI initializes it. */
-declare function readHomeIdentity(config?: Config | null): string | null;
-//#endregion
-//#region state/json-file.d.ts
+declare function buildDiagnostics(value: unknown): BuildDiagnostic[];
+declare function readDevicePlacement(state: WorkspaceState | null, platform: StatsPlatform, slot?: string): DevicePlacement | null;
+declare function readLastBuilds(state: WorkspaceState | null | undefined): Partial<Record<StatsPlatform, LastBuildReport>>;
+/** Each platform's recorded runs, newest first, at most `BUILD_HISTORY_LIMIT` each. */
+declare function readBuildHistory(state: WorkspaceState | null | undefined): Partial<Record<BuildPlatform, BuildHistoryEntry[]>>;
+declare function readWorkspaceState(root: string): WorkspaceState | null;
+declare function lastUseFrom(state: WorkspaceState | null, logMtimes: readonly number[]): number;
 /**
- * Runs `fn` with each state file read from disk at most once: inside it, including after an `await`, `readStateFile`
- * returns the text of the first read of that path, and a path found missing stays missing. Callers still parse every time, so no two
- * share a mutable object. Only for computations that write none of the files they read.
+ * When an ios, android or macos run last finished in the workspace, from its recorded builds (a cache hit counts),
+ * in epoch milliseconds; NaN when it records none. Dev server starts, reloads and logs do not count.
  */
-declare function withStateReadCache<T>(fn: () => T): T;
-declare function readStateFile(path: string): string;
-declare function readJsonFile(path: string): unknown;
-declare function isJsonObject(value: unknown): value is Record<string, unknown>;
-declare function readJsonObject(path: string): Record<string, unknown> | null;
-//#endregion
-//#region state/ledgers.d.ts
-type CreatedDevicePlatform = "ios" | "android" | "web";
-/** `web` lists the absolute paths of browser profile directories Stim created. */
-interface CreatedDevices {
-  ios: ReadonlySet<string>;
-  android: ReadonlySet<string>;
-  web: ReadonlySet<string>;
-}
-declare function readCreatedDevices(): CreatedDevices;
-interface EasSessionClaim {
-  sessionId: string;
-  name: string;
-  platform: "ios" | "android";
-  workspaceRoot: string;
-  workspaceHome: string;
-  stateFile: string;
-}
-interface EasSessionLedgerRead {
-  claims: Map<string, EasSessionClaim>;
-  notice: string | null;
-  safe: boolean;
-}
-/** Returns the claim normalized to canonical paths, or null when it is not a valid claim for `id`. */
-declare function validEasSessionClaim(id: string, value: unknown): EasSessionClaim | null;
-declare function readEasSessionLedger(root?: string): EasSessionLedgerRead;
-//#endregion
-//#region state/error-entries.d.ts
+declare function lastNativeUseFrom(state: WorkspaceState | null): number;
+declare const MAINTENANCE_LOG_NAME = "maintenance.ndjson";
 /**
- * The number of rows a log list shows for `records`, an error query's result in log order. Stim Desktop's
- * `LogEntryList` and the phone's `groupRecords` group the same way and replay the same vectors: in Expo's dev
- * server one failed bundle is a `Bundling failed` marker line, the error line and a failed bundle response,
- * which the apps list as one row, and every other record is its own row.
+ * When the workspace was last used, in epoch milliseconds. A workspace that recorded no use falls back to the mtime
+ * of its workspace.json, which is written once when the workspace is created, so it is a lower bound on the last
+ * use. NaN when its state.json exists but does not parse, or when workspace.json cannot be read either.
  */
-declare function countErrorEntries(records: readonly NdjsonRecord[]): number;
-//#endregion
-//#region state/fingerprint-memo.d.ts
-declare const FINGERPRINT_MEMO_SCHEMA = 1;
-/** Full native fingerprints shared by every workspace of this Stim home, one file per platform and static digest. */
-declare function fingerprintMemoDir(platform?: string): string;
-declare function fingerprintMemoFile(platform: string, digest: string): string;
-declare function fingerprintMemoLock(): string;
-/** The full fingerprint a tree with this static digest produced, written by the CLI. */
-interface FingerprintMemoRecord {
-  schema: typeof FINGERPRINT_MEMO_SCHEMA;
-  platform: string;
-  digest: string;
-  recordedAt: number;
-  hash: string;
-  sources: unknown[];
-  /** The packages the static check counted as native, to name the ones a disagreeing check found it missed. */
-  nativePackages: string[];
-}
-declare function readFingerprintMemo(platform: string, digest: string): FingerprintMemoRecord | null;
-//#endregion
-//#region state/logs-query.d.ts
-interface SinceResult {
-  ms?: number;
-  error?: string;
-}
-interface GrepResult {
-  re?: RegExp;
-  error?: string;
-}
-interface MarkerWindow {
-  launchTs: number | null;
-  bundleTs: number | null;
-  pageLoadTs: number | null;
-}
-interface QueryCriteria {
-  slot?: string;
-  includeAppDeviceErrors?: boolean;
-  sources?: string[];
-  minLevel?: string;
-  grep?: RegExp;
-  sinceTs?: number;
-  errorsOnly?: boolean;
-  markerTs?: number;
-  bundleMarkerTs?: number;
-}
-interface TailState {
-  offset: number;
-  partial: string;
-}
-declare function parseSince(text: unknown): SinceResult;
-declare function compileGrep(pattern: unknown): GrepResult;
-declare const ERROR_SOURCES: string[];
-declare function markerWindow(records: NdjsonRecord[]): MarkerWindow;
+declare function workspaceLastUsed(root: string): number;
+declare const WARM_KEY = "warm";
+/** How long a successful warm keeps a workspace `ready` when nothing runs in it. */
+declare const READY_PHASE_MS: number;
 /**
- * The platform a bundle marker speaks for, lowercased: its `platform` field, or the tag @expo/cli prints before
- * "Bundled" ("iOS", "Android", "Web", "RSC(iOS)" as ios, or an environment tag such as "DOM"). Null when unknown.
+ * What `stim worktree warm` last recorded in a workspace: a warm in progress, held by the ownership claim
+ * `claim` names, or a successful warm that finished at `at`.
  */
-declare function bundleMarkerPlatform(record: NdjsonRecord): string | null;
-declare function recordMatches(record: NdjsonRecord | null | undefined, criteria?: QueryCriteria): boolean;
-declare function buildCriteria({ slot, sources, minLevel, since, grep, errorsOnly, markerTs, bundleMarkerTs, now }?: {
-  slot?: string;
-  sources?: string[];
-  minLevel?: string;
-  since?: string | null;
-  grep?: string | RegExp | null;
-  errorsOnly?: boolean;
-  markerTs?: number;
-  bundleMarkerTs?: number;
-  now?: number;
-}): QueryCriteria;
-declare function logFiles(dir: string): string[];
-declare function fileSizes(dir: string): Record<string, number>;
-declare function readLogRecords(dir: string, include?: (name: string) => boolean): NdjsonRecord[];
-declare const NATIVE_CRASH_LOG_PREFIX = "native-crash-";
-/** Reads the CLI timeline with retained native crash records after other records at the same timestamp. */
-declare function readLogTimeline(dir: string, records?: NdjsonRecord[]): NdjsonRecord[];
-declare function isExpoErrorContext(record: NdjsonRecord, event: unknown): boolean;
-type ExpoContextTarget = "msg" | "field";
+type WarmRecord = {
+  phase: "warming";
+  step: WarmStep;
+  startedAt: string;
+  claim: {
+    root: string;
+    claimId: string;
+  };
+} | {
+  phase: "ready";
+  at: string;
+};
+declare function readWarmRecord(state: WorkspaceState | null | undefined): WarmRecord | null;
+declare const WORKSPACE_AGENT_KEY = "agentSession";
 /**
- * Adds the code frame and stack lines Expo printed after each Expo error record, either joined into
- * `msg` or as a `context` string array.
+ * The coding-agent session whose shell ran the Stim command that last recorded `lastUsedAt`, with that command's
+ * working directory as `cwd` and its time as `lastActiveAt`.
  */
-declare function attachExpoErrorContext(all: NdjsonRecord[], matched: NdjsonRecord[], into?: ExpoContextTarget): NdjsonRecord[];
-interface LogQueryOptions {
-  slot?: string;
-  sources?: string[];
-  minLevel?: string;
-  since?: string;
-  grep?: string | RegExp;
-  errorsOnly?: boolean;
-  now?: number;
+declare function readWorkspaceAgent(state: WorkspaceState | null | undefined): AgentSession | null;
+//#endregion
+//#region state/hosted-native.d.ts
+interface HostedNativePlacement<D> {
+  machine: string;
+  session: string;
+  appAttempt: string;
+  device: D | null;
+  selected: string;
+  reason?: string;
+  agent: HostedAgentAccess;
 }
-interface LogQueryPlan {
-  /** Whether a record belongs to the queried slot's timeline, before any other filter. */
-  inTimeline: (record: NdjsonRecord) => boolean;
-  matches: (record: NdjsonRecord) => boolean;
-  launchTs: number | null;
-  sinceTs: number | undefined;
-  /**
-   * Whether no record with a timestamp at most `maxTs`, or without one when `maxTs` is Infinity, can match.
-   * `slots` lists every `slot ?? 'default'` value the records can carry; without it, a query that depends on
-   * per-slot launch markers cannot rule out any timestamp.
-   */
-  excludesUpTo: (maxTs: number, slots?: ReadonlySet<unknown>) => boolean;
-}
-/** Decides which records a query matches from the timeline's marker records alone. */
-declare function planLogQuery(markers: readonly NdjsonRecord[], { slot, sources, minLevel, since, grep, errorsOnly, now }?: LogQueryOptions): LogQueryPlan;
-declare function queryLogs({ slot, dir, records, sources, minLevel, since, grep, tail, errorsOnly, errorContext, now }?: LogQueryOptions & {
-  dir?: string;
-  records?: NdjsonRecord[];
-  tail?: number;
-  errorContext?: boolean;
-}): NdjsonRecord[];
-/** Queries the JSON timeline, including Expo context fields on errors as `stim logs --json` does. */
-declare function queryJsonLogs(options?: Parameters<typeof queryLogs>[0]): NdjsonRecord[];
-declare function tailRead(prev: TailState | null | undefined, size: number): {
-  start: number;
-  prev: TailState;
+declare function parseHostedNativePlacement(value: unknown, platform: "ios"): HostedNativePlacement<HostedIosDevice> | null;
+declare function parseHostedNativePlacement(value: unknown, platform: "android"): HostedNativePlacement<HostedAndroidDevice> | null;
+declare function parseHostedNativePlacement(value: unknown, platform: "ios" | "android"): HostedNativePlacement<HostedIosDevice | HostedAndroidDevice> | null;
+declare function hostedNativeRecords(state: WorkspaceState | null, platform: "ios" | "android"): Record<string, unknown>;
+declare function unreadableHostedNative(slot: string, platform: "ios" | "android"): string;
+//#endregion
+//#region state/hosted-android.d.ts
+/** A workspace slot's placement; null device means its reservation has not reached ready yet. */
+interface HostedAndroidPlacement extends HostedNativePlacement<HostedAndroidDevice> {}
+/** Public hosting facts; the host's serial, AVD name and private Metro links are excluded. */
+type HostedAndroidStatus = {
+  machine: string;
+  session: string;
+  selected: string;
+  reason?: string;
+  agent: HostedAgentAccess;
+  device: {
+    name: string;
+    systemImage: string;
+    api: number;
+  } | null;
+  /** The latest session probe in status, independent of a conflicting local emulator's state. */
+  state?: string;
 };
-declare function advanceTail(prev: TailState | null | undefined, chunk: string | null | undefined, size: number): {
-  state: TailState;
-  records: NdjsonRecord[];
+declare function parseHostedAndroidPlacement(value: unknown): HostedAndroidPlacement | null;
+declare function hostedAndroidStatus(placement: HostedAndroidPlacement): HostedAndroidStatus;
+declare function hostedAndroidRecords(state: WorkspaceState | null): Record<string, unknown>;
+declare function unreadableHostedAndroid(slot: string): string;
+declare function hostedAndroidPlacements(state: WorkspaceState | null): Record<string, HostedAndroidPlacement>;
+declare function hostedAndroidDeviceName(device: HostedAndroidDevice): string;
+//#endregion
+//#region state/hosted-ios.d.ts
+/** A workspace slot's placement; null device means its reservation has not reached ready yet. */
+interface HostedIosPlacement extends HostedNativePlacement<HostedIosDevice> {}
+/** Public hosting facts; the host's UDID and private Metro links are excluded. */
+type HostedIosStatus = {
+  machine: string;
+  session: string;
+  selected: string;
+  reason?: string;
+  agent: HostedAgentAccess;
+  device: {
+    name: string;
+    runtime: string;
+  } | null;
+  /** The latest session probe in status, independent of a conflicting local simulator's state. */
+  state?: string;
 };
-declare function followLogs({ dir, onRecord, criteria, intervalMs, offsets, identities: seededIdentities, errorContext }: {
-  dir: string;
-  onRecord: (record: NdjsonRecord) => void;
-  criteria?: QueryCriteria;
-  /** An explicit polling interval. Omit for filesystem hints with a ten-second repair scan. */
-  intervalMs?: number;
-  offsets?: Record<string, number> | null;
-  /** `fileIdentity` of each file `offsets` was read from, so a replacement made since is recognized. */
-  identities?: Record<string, string> | null;
-  /** Holds each Expo error until its code frame and stack stop growing, then attaches them. */
-  errorContext?: ExpoContextTarget;
-}): () => void;
-declare function fileIdentity(stat: BigIntStats): string | undefined;
-declare function sortByTs(records: NdjsonRecord[]): NdjsonRecord[];
+declare function parseHostedIosPlacement(value: unknown): HostedIosPlacement | null;
+declare function hostedIosStatus(placement: HostedIosPlacement): HostedIosStatus;
+declare function hostedIosRecords(state: WorkspaceState | null): Record<string, unknown>;
+declare function unreadableHostedIos(slot: string): string;
+declare function hostedIosPlacements(state: WorkspaceState | null): Record<string, HostedIosPlacement>;
 //#endregion
-//#region state/log-reader.d.ts
-interface LogDirQuery extends LogQueryOptions {
-  tail?: number;
-  /** Records from outside the directory, such as agent-device actions; they follow its records at equal timestamps. */
-  extra?: readonly NdjsonRecord[];
+//#region state/maintenance.d.ts
+type MaintenanceMode = "off" | "report" | "on";
+type MaintenanceCheck = "pressure" | "size" | "worktree" | "sweep" | "idle";
+type MaintenanceActionKind = "would-clear-outputs" | "would-trim-cache" | "would-empty-cache" | "would-shutdown-device" | "would-stop-workspace" | "would-remove-worktree" | "would-remove-orphan" | "would-unregister-cache" | "would-delete-parked-device" | "would-delete-devices" | "would-clear-build-dirs" | "would-delete-dependencies" | "would-stop-gradle-daemons" | "would-delete-gradle-version" | "would-delete-temp-leftovers";
+/** Disk pressure: 0 above every threshold, 1 under the budget floor, 2 under the urgent threshold, 3 under the critical threshold or the hard floor. */
+type DiskPressureLevel = 0 | 1 | 2 | 3;
+interface MaintenanceAction {
+  kind: MaintenanceActionKind;
+  target: string;
+  bytes: number;
+  reason: string;
+  workspace?: string;
+  dir?: string;
+  olderThanDays?: number;
+  check?: "worktree" | "sweep" | "disk" | "idle";
+  /** The disk pressure level that planned the action; it runs only while free disk stays under that level's floor. */
+  level?: 2 | 3;
 }
-/**
- * An indexed view of a workspace log directory, read in timestamp order without loading whole files. Each file
- * generation is indexed once per process (block timestamp bounds, markers, slots and launch attempts) and later
- * views read only what was appended since. Close it to release the open files.
- */
-interface LogDir {
-  /** Bytes read from each current `.ndjson` file, through its last complete line. */
-  readonly sizes: Record<string, number>;
-  /** `fileIdentity` of each current `.ndjson` file that `sizes` was read from. */
-  readonly identities: Record<string, string>;
-  /** The oldest timestamp in the directory. */
-  readonly firstTs: number | undefined;
-  /** Launch attempt records outside native crash files, in timeline order. */
-  launchAttempts(): NdjsonRecord[];
-  /** The records `queryJsonLogs` returns for this directory's timeline followed by `extra`. */
-  query(query?: LogDirQuery): Promise<NdjsonRecord[]>;
-  /** Every matching record in timestamp order, in batches of at most 500, with the same filters and context as query. */
-  batches(query?: Omit<LogDirQuery, "tail">): AsyncIterable<NdjsonRecord[]>;
-  /** Prepares the directory marker predicate for records without markers, such as attributed agent actions. */
-  filter(query?: LogQueryOptions): (record: NdjsonRecord) => boolean;
-  close(): Promise<void>;
+interface MaintenanceSize {
+  name: string;
+  dir: string;
+  bytes: number;
+  measuredAt: number;
+  category: "workspace-outputs" | "build-cache" | "metro-cache" | "compilation-cache" | "ccache" | "owned-devices" | "other";
+  workspace?: string;
+  idleDays?: number | null;
+  blocked?: string;
 }
 /**
- * Opens `dir` for reading. With `order: 'timeline'`, native crash files follow every other file at equal
- * timestamps, as `readLogTimeline` orders them; with `'name'`, every file is ranked by name, as `readLogRecords`.
- */
-declare function openLogDir(dir: string, { order, signal }?: {
-  order?: "timeline" | "name";
-  signal?: AbortSignal;
-}): Promise<LogDir>;
-//#endregion
-//#region state/ndjson-tail.d.ts
-/**
- * Returns a reader of `file` and its rotated generation that yields, on every call, the records a full
- * `readNdjsonGenerations(file)` would, while reading only the bytes appended since the previous call. A file renamed
- * to its rotated generation between two calls is finished from there; any other replacement or a shrunk file is
- * read again from its start. A file rewritten in place to at least its previous length is not detected.
- */
-declare function createNdjsonTail(file: string): () => NdjsonRecord[];
-//#endregion
-//#region state/paths.d.ts
-declare function getConfigPath(): string;
-declare function configLockPath(): string;
-declare function workspaceMetadataFile(projectRoot: string): string;
-declare function workspaceAgentDeviceDir(projectRoot: string): string;
-declare function workspaceLogsDir(projectRoot: string): string;
-/** Device screen footage stim-server records for the workspace, one directory per platform and slot. */
-declare function workspaceRecordingsDir(projectRoot: string): string;
-declare function workspaceLogErrorIndex(projectRoot: string): string;
-declare function workspaceDerivedData(projectRoot: string): string;
-declare function workspaceGradleBuild(projectRoot: string): string;
-declare function workspaceBuildDetailFile(projectRoot: string): string;
-/** The agent sessions that stopped running in the workspace in the last `ENDED_AGENT_RETENTION_MS`. */
-declare function workspaceEndedAgentsFile(projectRoot: string): string;
-declare function workspaceEndedAgentsLock(projectRoot: string): string;
-declare function supervisorPidFile(projectRoot: string): string;
-declare function workspaceStateFile(projectRoot: string): string;
-/** The dependency directories `gc --delete` deleted from the workspace's worktree, apart from state.json so writing it is not workspace activity. */
-declare function workspaceLightenedFile(projectRoot: string): string;
-declare function workspaceStateLock(projectRoot: string): string;
-declare function supervisorLogFile(projectRoot: string): string;
-declare function emulatorLogFile(projectRoot: string): string;
-declare function sharedCompilationCache(): string;
-declare function sharedCcache(): string;
-declare function sharedGradle(): string;
-declare function sharedPods(): string;
-declare function createdDevicesFile(): string;
-declare function gitMergeCacheDir(): string;
-declare function pullRequestCacheDir(): string;
-declare function agentSessionsCacheFile(): string;
-declare function diskUsageCacheDir(): string;
-/** The ownership claim root that admits one disk-usage walk at a time on this machine. */
-declare function diskUsageWalkClaims(): string;
-/** The remote machines this machine asked for build access, each with its pinned stim-server key once approved. */
-declare function buildMachinesFile(): string;
-declare function buildMachinesLock(): string;
-/** The remote machines this machine asked for access, separate from build credentials. */
-declare function deviceHostMachinesFile(): string;
-declare function deviceHostMachinesLock(): string;
-declare function deviceHostMachinesClaims(): string;
-declare function createdDevicesLock(): string;
-/** The EAS session ledger lives under the real home directory, never under STIM_HOME. */
-declare function easMachineStateRoot(): string;
-declare function easSessionLedgerFile(root?: string): string;
-declare function easSessionLedgerLock(root?: string): string;
-/** Where stim-server records, one file per server process, the devices whose frames a client subscribes to. */
-declare function deviceViewersDir(): string;
-declare function budgetSweepFile(): string;
-declare function budgetSweepLock(): string;
-declare function statsFile(): string;
-declare function maintenanceDir(): string;
-declare function maintenanceStateFile(): string;
-declare function maintenanceAttemptFile(): string;
-declare function maintenanceNdjsonFile(): string;
-declare function gcLogDir(): string;
-declare function gcLogFile(): string;
-declare function buildLedgerDir(): string;
-declare function buildLedgerFile(): string;
-declare function buildLedgerLock(): string;
-declare function maintenanceChildLogFile(): string;
-declare function maintenanceRunClaims(): string;
-/** Dependency trees `worktree remove` moved out of a worktree before git removed it; gc deletes what is left. */
-declare function trashRoot(): string;
-declare function archiveRoot(): string;
-declare function archiveDir(id: string): string;
-declare function archiveLock(): string;
-/** Uncommitted changes of removed worktrees: `<repository>/<branch-or-dir>-<timestamp>/` holding `manifest.json`. */
-declare function worktreeArchiveRoot(): string;
-/** This machine's own long-term X25519 key as a client of other machines' stim-servers. */
-declare function clientIdentityKeyFile(): string;
-/**
- * The local Unix socket. sun_path permits 103 UTF-8 bytes on macOS and 107 on Linux. Longer paths use
- * /tmp/stim-sockets-<uid>/<SHA-256 of the normalized absolute socket path>.sock.
- */
-declare function serverLocalSocket(): string;
-declare function serverSetupDir(): string;
-declare function setupJournalFile(hash: string): string | null;
-//#endregion
-//#region state/placement.d.ts
-/**
- * The placement words every workload shares (`remote.build`, `ios.remote`, `android.remote`, `macos.remote` and their
- * flags). Anything else a setting holds is a machine name, or for devices `eas` or `proxy`.
- *
- * - `local`: this machine only.
- * - `auto`: this machine first, a remote machine when this one is full or busy.
- * - `remote`: remote machines first, in `remote.machines` order; this machine only when none takes the run.
- * - `remote-only`: remote machines in `remote.machines` order, never this machine.
- */
-declare const PLACEMENT_WORDS: readonly ["local", "auto", "remote", "remote-only"];
-type PlacementWord = (typeof PLACEMENT_WORDS)[number];
-type AutomaticPlacement = Exclude<PlacementWord, "local">;
-declare function placementWord(value: string): PlacementWord | null;
-declare function prefersRemote(word: PlacementWord): boolean;
-declare function mayRunHere(word: PlacementWord): boolean;
-//#endregion
-//#region state/recordings.d.ts
-/** The footage stim-server keeps per device: the last 15 minutes recorded, however long ago. */
-declare const RECORDING_FOOTAGE_MS: number;
-/** The recordings of every workspace of one Stim home together; past it the oldest footage goes first. */
-declare const RECORDING_CAP_BYTES: number;
-/** The platforms stim-server records: owned simulators and emulators, and the Stim-owned Chrome page. */
-declare const RECORDING_PLATFORMS: readonly ["ios", "android", "web"];
-type RecordingPlatform = (typeof RECORDING_PLATFORMS)[number];
-/**
- * One file of H.264 footage. A closed segment is named `<start>-<end>.seg`, in epoch milliseconds of its first and
- * last access unit; the segment being written is `<start>.part`, and its end is its modification time.
+ * A process whose physical footprint, as `top` reports it, is abnormally large. `command` is the one command that
+ * safely restarts or stops it, null when Stim knows none; `note` says what that command does.
  */
-interface RecordedSegment {
-  file: string;
-  start: number;
-  end: number;
+interface MemoryCulprit {
+  pid: number;
+  name: string;
   bytes: number;
-  open: boolean;
+  command: string | null;
+  note: string | null;
+}
+interface MaintenancePressure {
+  disk: {
+    volume: string;
+    freeMb: number;
+  }[];
+  memory: {
+    level: "normal" | "warning" | "critical" | null;
+    availableBytes: number | null;
+    pressured: boolean;
+    /** Read only while the level is warning or critical; absent otherwise. */
+    culprits?: MemoryCulprit[];
+  };
+  warningSince: number | null;
+  diskLevel?: DiskPressureLevel;
+}
+interface MaintenancePass {
+  startedAt: number;
+  durationMs: number;
+  trigger: string;
+  mode: "report" | "on";
+  freedBytes: number;
+  actions: number;
+  stopped: 0;
+  blocked: string[];
+}
+interface MaintenanceRecord extends NdjsonRecord {
+  ts: number;
+  src: "maintenance";
+  level: "debug" | "info" | "warn" | "error";
+  msg: string;
+  event: "maintenance_pass" | "maintenance_action" | "maintenance_skip" | "maintenance_failure" | "maintenance_check";
+  pass: string;
+  trigger: string;
+  mode: "report" | "on";
+}
+interface MaintenanceState {
+  version: 1;
+  lastAt: Partial<Record<MaintenanceCheck, number>>;
+  deferredAt?: Partial<Record<MaintenanceCheck, number>>;
+  pressure: MaintenancePressure | null;
+  sizes: MaintenanceSize[];
+  lastPass: MaintenancePass | null;
+  recent: MaintenanceRecord[];
+  plan: MaintenanceAction[];
+  skipKeys?: string[];
+}
+interface MaintenanceStatus {
+  mode: MaintenanceMode;
+  invalid?: string;
+  claim?: {
+    unresolved: string;
+    removeCommand: string;
+  };
+  lastChecks: {
+    pressure: number | null;
+    size: number | null;
+    worktree: number | null;
+    sweep: number | null;
+  };
+  pressure: MaintenancePressure | null;
+  sizes: MaintenanceSize[];
+  lastPass: MaintenancePass | null;
+  running: {
+    startedAt: string;
+    trigger: string;
+  } | null;
+  recent: MaintenanceRecord[];
+  plan: MaintenanceAction[];
+}
+/** Rejects missing, corrupt or unsupported payloads without throwing. */
+declare function parseMaintenanceState(value: unknown): MaintenanceState | null;
+declare function readMaintenanceState(): MaintenanceState | null;
+declare function readMaintenanceAttempt(): number | undefined;
+//#endregion
+//#region state/archive.d.ts
+interface ArchivedBytes {
+  logs: number;
+  recordings: number;
+  agentActions: number;
+  record: number;
+  total: number;
+}
+interface ArchivedWorkspace {
+  id: string;
+  projectRoot: string;
+  project: string;
+  workspace: string;
+  worktree: {
+    repository: string | null;
+    branch: string | null;
+    head: string | null;
+    subject: string | null;
+    merged: boolean | null;
+    pullRequest: {
+      number: number;
+      state: string;
+      title: string;
+      url: string;
+    } | null;
+  };
+  removedAt: string;
+  removedBy: string;
+  lastUsedAt: string | null;
+  builds: {
+    count: number;
+    last: LastBuildReport | null;
+    lastErrorCount: number;
+  };
+  agents: EndedAgentSession[];
+  bytes: ArchivedBytes;
+  expires: {
+    logs: string | null;
+    recordings: string | null;
+    agentActions: string | null;
+    record: string | null;
+  };
+  version: number;
+  replacedBy?: string;
 }
-interface RecordedDevice {
-  platform: RecordingPlatform;
-  slot: string;
-  dir: string;
-  segments: RecordedSegment[];
+interface ArchivedUsage {
+  count: number;
+  bytes: number;
+  byKind: {
+    logs: number;
+    recordings: number;
+    agentActions: number;
+    record: number;
+  };
 }
-/** The directory under a workspace's recordings that holds one device slot's footage. */
-declare function recordingDeviceName(platform: RecordingPlatform, slot: string): string;
-/** Segment names hold whole milliseconds: the start rounded down and the end rounded up. */
-declare function closedSegmentName(start: number, end: number): string;
-declare function openSegmentName(start: number): string;
-/** The segments in one device directory, oldest first. Files that are not segments are left out; `closedOnly` excludes files still being written. */
-declare function listSegments(dir: string, closedOnly?: boolean): RecordedSegment[];
-/** Reads current segment files asynchronously, oldest first; cancellation propagates. */
-declare function listSegmentsAsync(dir: string, closedOnly?: boolean, signal?: AbortSignal): Promise<RecordedSegment[]>;
-/** Every device slot recorded under a workspace's recordings directory. */
-declare function listRecordedDevices(recordingsDir: string, closedOnly?: boolean): RecordedDevice[];
-/** Reads current device slots and their segment files asynchronously; cancellation propagates. */
-declare function listRecordedDevicesAsync(recordingsDir: string, closedOnly?: boolean, signal?: AbortSignal): Promise<RecordedDevice[]>;
-declare function recordedBytes(devices: readonly RecordedDevice[]): number;
-/**
- * The oldest closed segments to delete so that one device keeps at most `footageMs` of footage. Time between
- * segments, while nothing was recorded, does not count. The open segment is never chosen.
- */
-declare function footageDrops(segments: readonly RecordedSegment[], footageMs: number): RecordedSegment[];
-/** The oldest closed segments across all devices to delete so that together they hold at most `capBytes`. */
-declare function capDrops(devices: readonly RecordedDevice[], capBytes: number): RecordedSegment[];
-/**
- * Whether stim-server records a workspace's devices: `STIM_RECORDING`, then `recording.enabled` in the workspace,
- * repo and machine layers, in that order, and true by default.
- */
-declare function recordingEnabled(env: NodeJS.ProcessEnv, layers: readonly unknown[]): boolean;
+declare function readArchives(): ArchivedWorkspace[];
+/** Reads current archive files asynchronously, outside the synchronous state-read cache; cancellation propagates. */
+declare function readArchivesAsync(signal?: AbortSignal): Promise<ArchivedWorkspace[]>;
+declare function readArchive(id: string): ArchivedWorkspace | null;
+/** Reads a current archive without the synchronous state-read cache; invalid or missing records return null. */
+declare function readArchiveAsync(id: string, signal?: AbortSignal): Promise<ArchivedWorkspace | null>;
+declare function readArchiveState(id: string): WorkspaceState | null;
+declare function archivedUsage(archives: readonly ArchivedWorkspace[]): ArchivedUsage;
+declare function linkReplacedArchives(archives: readonly ArchivedWorkspace[], paths: readonly string[]): ArchivedWorkspace[];
+declare function archiveEnabled(env: NodeJS.ProcessEnv, layers: readonly unknown[]): boolean;
 //#endregion
-//#region state/run-id.d.ts
-declare const RUN_ID_ENV = "STIM_RUN_ID";
-/** A run id as the CLI and stim-server accept it: letters, digits, `.`, `_` and `-`, at most 64. Null otherwise. */
-declare function validRunId(value: unknown): string | null;
-/**
- * The run id of the ambient operation context, else of this CLI invocation: `STIM_RUN_ID` when it holds a valid id
- * (Stim Desktop passes one), else a random one. The CLI entry exports it back to `STIM_RUN_ID` so processes the run
- * starts inherit it; this function does not.
- */
-declare function runId(env?: NodeJS.ProcessEnv): string;
+//#region state/macos.d.ts
+interface MacosProcess {
+  pid: number;
+  processToken: string;
+  startedAtMicros: number;
+}
+interface MacosBuild {
+  state: "running" | "ok" | "failed";
+  startedAt: string;
+  finishedAt?: string;
+  durationMs?: number;
+  fingerprint?: string;
+  cacheKey?: string;
+  cacheHit?: boolean;
+  cacheSource?: "local" | "provider" | "peer";
+  error?: string;
+  errorCode?: string;
+  buildMachine?: string;
+  builtOn?: string;
+  offloadedTo?: string;
+  offloadFallback?: string;
+}
+interface MacosAppRecord {
+  launchId: string;
+  arguments: string[];
+  product: string;
+  /** The app's visible name: the product and the workspace label. Absent in older records. */
+  displayName?: string;
+  bundle: string;
+  bundleId: string;
+  executable: string;
+  build: MacosBuild;
+  supervisor?: MacosProcess;
+  app?: MacosProcess;
+  /** Set when `stim macos --remote` reserved a session on another Mac; the app then has no local process. */
+  host?: HostedMacosPlacement;
+  /** Host launch evidence: true for a live app; status can override it in memory after probing the session. */
+  hostLaunched?: boolean | "unverified";
+}
+interface MacosAppState extends MacosAppRecord {
+  state: "running" | "orphaned" | "stopped" | "unverified";
+}
+declare function parseMacosRecord(value: unknown): MacosAppRecord | null;
+declare function readMacosRecord(root: string): MacosAppRecord | null;
+declare function readHostedMacosApp(home: string): MacosAppRecord | null;
+declare function macosAppState(record: MacosAppRecord | null): MacosAppState | null;
 //#endregion
 //#region state/settings-registry.d.ts
 declare const ANDROID_COMPILER_CACHE_CHOICES: readonly ["auto", "ccache", "cas", "none"];
@@ -941,1454 +941,1520 @@ declare const ANDROID_EMULATOR_APPS: readonly ["emulator", "stim-desktop"];
 declare const REPLACED_SETTINGS: Readonly<Record<string, {
   key: string;
   env?: string;
-  value: (old: unknown) => string | null;
-}>>;
-declare function replacementAdvice(key: string, old: unknown): {
-  key: string;
-  command: string | null;
-} | null;
-declare const WEB_VIEWPORTS: readonly ["desktop", "phone"];
-type WebViewport = (typeof WEB_VIEWPORTS)[number];
-declare const SETTINGS: readonly SettingDefinition[];
-declare function settingDefinition(key: string): SettingDefinition | null;
-declare function isLayeredSetting(setting: SettingDefinition): boolean;
-declare const SETTING_GROUPS: readonly string[];
-declare function expectedShape(type: SettingType): string;
-declare function acceptsShape(setting: SettingDefinition, value: unknown): boolean;
-declare function settingValueError(setting: SettingDefinition, value: unknown): string | null;
-declare function isSensitiveReference(value: unknown): boolean;
-/**
- * Coerces raw text (a CLI argument or an environment variable) through a setting's
- * registry type, the same way for both sources. Types whose values are not written
- * as bare text (boolean, number, strings, object) are read as JSON; a value that
- * fails to parse is left as the original string so `settingValueError` reports it. A boolean also reads `1` and `0`.
- */
-declare function coerceSettingText(setting: SettingDefinition, raw: string): unknown;
-//#endregion
-//#region state/settings-schema.d.ts
-declare const SETTINGS_SCHEMA_FILE = "settings.schema.json";
-declare const SETTINGS_SCHEMA_URL: string;
-type JsonSchema = Record<string, unknown>;
-/**
- * The published settings schema. The root describes a committed `.stim.json`;
- * `$defs.machine` describes the settings keys of `$STIM_HOME/config.json`.
- * Every leaf carries `x-stim` with its dotted key, kind, writable scopes,
- * environment override, and sensitivity.
- */
-declare function settingsJsonSchema(): JsonSchema;
-//#endregion
-//#region state/hosted-app.d.ts
-interface HostedAppFile {
-  path: string;
-  kind: "file" | "exec" | "link";
-  size: number;
-  sha256: string;
-}
-interface HostedAppOffer {
-  session: string;
-  attempt: string;
-  bundleId: string;
-  mode: "development" | "release" | "process";
-  devClientScheme?: string;
-  arguments?: string[];
-  manifest: {
-    sha256: string;
-    size: number;
-  };
-}
-interface HostedAppDelivery extends Omit<HostedAppOffer, "manifest"> {
-  state: "receiving" | "installing" | "installed" | "unknown";
-  launched: true | "unverified" | null;
-  notice?: string;
-}
-interface HostedAppRecord extends HostedAppDelivery {
-  manifest: HostedAppOffer["manifest"];
-  files: HostedAppFile[];
-}
-declare const HOSTED_APP_CHUNK_BYTES: number;
-declare function hostedAppAttempt(value: unknown): value is string;
-declare function hostedAppArea(session: string, attempt: string, workerHome?: string): string;
-declare function hostedAppBlobs(session: string, workerHome?: string): string;
-/** Transfers cached verification after a rename, only for the same inode, size, mtime and digest. */
-declare function rememberHostedAppBlobRename(from: string, to: string, file: {
-  size: number;
-  sha256: string;
-}): void;
-/** Checks regular blob bytes, including their size, before content-addressed reuse. */
-declare function validHostedAppBlob(path: string, file: {
-  size: number;
-  sha256: string;
-}): boolean;
-/** At most 32 plain arguments of 1024 characters (8192 in total), with no NUL, CR or LF. */
-declare function validHostedAppArguments(value: unknown): value is string[];
-declare function parseHostedAppOffer(value: unknown): HostedAppOffer | null;
-/** Relative normalized paths, with no file or link as another entry's ancestor. */
-declare function parseHostedAppManifest(value: unknown): HostedAppFile[] | null;
-/** Reads a server-written receipt; malformed or missing established state remains unresolved. */
-declare function readHostedAppMetadata(session: string, attempt: string, workerHome?: string): Omit<HostedAppRecord, "files">;
-declare function readHostedApp(session: string, attempt: string, workerHome?: string): HostedAppRecord;
-//#endregion
-//#region state/hosted-macos.d.ts
-/** App slots one host offers; a slot names the host-assigned bundle id `<bundleId>.hosted<slot>`. */
-declare const HOSTED_MACOS_APP_SLOTS = 64;
-/** The drivers `hosting.agentDriver` can name: `none` and the first-party driver packages stim-server ships. */
-declare const HOSTED_AGENT_DRIVERS: readonly ["none", "agent-device"];
-type HostedAgentDriverName = (typeof HOSTED_AGENT_DRIVERS)[number];
-/** A driver name a grant or access record can carry; a client resolves only the drivers it knows. */
-declare function hostedAgentDriverName(value: unknown): value is string;
-/** What a host reports in a macOS offer: no simulator is created, so the choice is the host itself. */
-interface HostedMacosChoice {
-  architecture: "arm64" | "x86_64";
-  macosVersion: string;
-}
-/** A ready hosted macOS session's identity: the host it runs on and the app slot reserved for it. */
-interface HostedMacosDevice extends HostedMacosChoice {
-  appSlot: number;
-}
-/**
- * The agent-device lease owner scope a client names on every request. `deviceKey` is `<bundleId>@<pid>`
- * for a macOS app, or `ios:mobile:<udid>` with `backend: ios-instance` for a hosted simulator, or `android:mobile:<serial>` with `backend: android-instance` for a hosted emulator.
- */
-interface HostedAgentLease {
-  tenant: string;
-  runId: string;
-  clientId: string;
-  deviceKey: string;
-  backend?: "ios-instance" | "android-instance";
-}
-/**
- * Agent control a driver issues for one installed hosted app. `path` is the session's base route on the host,
- * `scope` the driver's handle that limits it to this one app, and `lease`, for a driver that allocates leases,
- * the scope that pins the allocation.
- */
-interface HostedAgentIssuedGrant {
-  driver: string;
-  path: string;
-  token: string;
-  scope: string;
-  lease?: HostedAgentLease;
-}
+  value: (old: unknown) => string | null;
+}>>;
+declare function replacementAdvice(key: string, old: unknown): {
+  key: string;
+  command: string | null;
+} | null;
+declare const WEB_VIEWPORTS: readonly ["desktop", "phone"];
+type WebViewport = (typeof WEB_VIEWPORTS)[number];
+declare const SETTINGS: readonly SettingDefinition[];
+declare function settingDefinition(key: string): SettingDefinition | null;
+declare function isLayeredSetting(setting: SettingDefinition): boolean;
+declare const SETTING_GROUPS: readonly string[];
+declare function expectedShape(type: SettingType): string;
+declare function acceptsShape(setting: SettingDefinition, value: unknown): boolean;
+declare function settingValueError(setting: SettingDefinition, value: unknown): string | null;
+declare function isSensitiveReference(value: unknown): boolean;
 /**
- * Agent control the host grants a client for one installed hosted app, sent only over that client's approved
- * device-host connection and never journaled. `none` means the host's `hosting.agentDriver` starts no driver.
+ * Coerces raw text (a CLI argument or an environment variable) through a setting's
+ * registry type, the same way for both sources. Types whose values are not written
+ * as bare text (boolean, number, strings, object) are read as JSON; a value that
+ * fails to parse is left as the original string so `settingValueError` reports it. A boolean also reads `1` and `0`.
  */
-type HostedAgentGrant = {
-  driver: "none";
-} | HostedAgentIssuedGrant;
-/** `app.launch` and `app.attach` results; a host includes `agent` once the app is installed. */
-type HostedAppLaunch = HostedAppDelivery & {
-  agent?: HostedAgentGrant;
-};
+declare function coerceSettingText(setting: SettingDefinition, raw: string): unknown;
+//#endregion
+//#region state/status.d.ts
+type StatsPlatform = "ios" | "android";
+/** A platform whose build reports phases: the stats platforms and `macos`. */
+type BuildPlatform = StatsPlatform | "macos";
+type RunOutcomeKind = "hit" | "cold";
+declare const BUILD_PHASES: readonly ["prepare", "cache-lookup", "wait", "prebuild", "pods", "compile", "device", "install", "launch"];
+type BuildPhase = (typeof BUILD_PHASES)[number];
+type ActiveBuildState = "running" | "stale" | "unknown";
 /**
- * Agent control as the client hands it to a coding agent: secrets stay in files Stim writes with mode
- * 0600, and `command` shows how to address the hosted app. Never carries a token inline. `setting` names
- * the hosting Mac's setting that turns a driver on.
+ * Where a running build compiles: `local`, or the remote machine it was offloaded to, with the phase it is in there
+ * (`sync`, `deps`, `prebuild`, `pods`, `build` or `fetch`) and when the offload and that phase started.
  */
-type HostedAgentAccess = {
-  driver: "none";
-  setting: "hosting.agentDriver";
-} | {
-  driver: string;
-  remoteConfig: string;
-  command: string;
+type BuildPlacement = "local" | {
+  host: string;
+  phase: string;
+  startedAt: string;
+  phaseStartedAt: string;
 };
-/** Where a workspace's macOS app runs when `stim macos --remote` placed it on another Mac. */
-interface HostedMacosPlacement {
-  machine: string;
-  session: string;
-  appSlot: number;
-  appAttempt: string;
-  /** The host-assigned id the running app uses, `hostedMacosBundleId(<offered id>, appSlot)`. */
-  bundleId: string;
-  agent: HostedAgentAccess;
-}
-declare function hostedMacosAppSlot(value: unknown): value is number;
-declare function hostedMacosBundleId(bundleId: string, appSlot: number): string;
-declare function parseHostedMacosChoice(value: unknown): HostedMacosChoice | null;
-declare function parseHostedMacosDevice(value: unknown): HostedMacosDevice | null;
-/** A grant naming a driver this client does not know is not usable; it parses as null. */
-declare function parseHostedAgentGrant(value: unknown): HostedAgentGrant | null;
-declare function parseHostedAgentAccess(value: unknown): HostedAgentAccess | null;
-declare function parseHostedMacosPlacement(value: unknown): HostedMacosPlacement | null;
-//#endregion
-//#region state/device-host.d.ts
-type HostedDevicePlatform = "ios" | "android" | "macos";
-/** Deadlines stim-server gives each hosted worker run. Clients derive their waits from these. */
-interface DeviceHostLimits {
-  prepareMs: number;
-  offerMs: number;
-  stopMs: number;
-  logsMs: number;
-  killGraceMs: number;
-}
-declare const DEVICE_HOST_LIMITS: Readonly<DeviceHostLimits>;
-/** How many parked sessions one reserve inspects, and possibly retires, before it creates a device. */
-declare const HOSTED_PARKED_CANDIDATES: number;
-/** How long a cancelled hosted worker run can take to settle: SIGTERM, SIGKILL after the grace, then it is abandoned. */
-declare function hostedWorkerSettleMs(limits?: Pick<DeviceHostLimits, "killGraceMs">): number;
-interface HostedIosChoice {
-  deviceTypeId: string;
-  runtimeId: string;
-  deviceType: string;
-  runtime: string;
-  architecture: "arm64" | "x86_64";
+interface BuildWaitingFor {
+  kind: "build-slot" | "device-slot";
+  inUse: number;
+  max: number;
+  since: string;
 }
-interface HostedIosDevice extends HostedIosChoice {
-  udid: string;
-  name: string;
+interface BuildReport {
+  platform: BuildPlatform;
+  slot: string;
+  state: ActiveBuildState;
+  phase: BuildPhase;
+  startedAt: string;
+  phaseStartedAt: string;
+  outcome: RunOutcomeKind | null;
+  /** Whether `outcome` is this run's own; before its cache lookup resolves it is the project's latest outcome. */
+  outcomeKnown: boolean;
+  /** The resolved lookup result; absent before resolution and when the run skips cache lookup. */
+  cacheLookupOutcome?: "hit" | "miss";
+  expectedMs: number | null;
+  expectedPhaseMs: number | null;
+  /** Milliseconds spent in phases already left; sums repeat visits, excludes the current visit, and is omitted before any phase completes and by older Stim. */
+  completedPhaseMs?: Partial<Record<BuildPhase, number>>;
+  basis: number;
+  /**
+   * The phases a run like this one goes through, in order, with each one's median in milliseconds, from the same
+   * runs as `expectedMs`; null without comparable runs. The current phase can be one the plan does not list.
+   */
+  plannedPhases: PlannedPhase[] | null;
+  /** Why the run's cache lookup missed, once the run knows; `baseline` omits `cacheKey`. */
+  missReason?: BuildMissReason;
+  /**
+   * True while `missReason` is the miss of the key the run looked up first and the run will prebuild or install pods,
+   * then look the key up again. A hit on the second lookup removes `missReason` and sets `outcome` to `hit`.
+   */
+  missProvisional?: true;
+  /** What the native build tool is doing now, once it printed a line Stim recognizes. */
+  detail?: BuildDetail;
+  /** What the `device` or `launch` phase is waiting on, once Stim observed it; absent otherwise and from older Stim. */
+  activity?: BuildActivity;
+  placement: BuildPlacement;
+  /** While `phase` is `wait`: the workspace whose build of the same artifact this run waits on, when it is known. */
+  waitingOn?: {
+    path: string;
+  };
+  waitingFor?: BuildWaitingFor;
 }
-interface HostedAndroidChoice {
-  systemImage: string;
-  deviceProfile: string;
-  architecture: "arm64-v8a" | "x86_64";
+/**
+ * What a run's `device` or `launch` phase is waiting on. `booting` lasts while the run waits for the owned simulator or
+ * emulator it started booting. `bundling` starts when the app's bundle request reaches this workspace's
+ * Metro and ends when Metro delivered it; `percent` is Metro's own progress for that request, present only once Metro
+ * reported one. `waiting-ready` lasts while the app reports its readiness pending. `startedAt` is when the evidence was
+ * recorded.
+ */
+interface BuildActivity {
+  name: "booting" | "bundling" | "waiting-ready";
+  startedAt: string;
+  percent?: number;
 }
-interface HostedAndroidDevice extends HostedAndroidChoice {
-  avdName: string;
-  serial: string;
-  consolePort: number;
+/** One phase a running build is expected to go through, and its median duration in comparable runs. */
+interface PlannedPhase {
+  phase: BuildPhase;
+  expectedMs: number;
 }
-type HostedDevice = HostedIosDevice | HostedAndroidDevice | HostedMacosDevice;
-interface HostedDeviceSelectors {
-  deviceType?: string;
-  runtime?: string;
-  systemImage?: string;
-  deviceProfile?: string;
+/** The native build tool's step inside a build's `compile` phase. */
+declare const NATIVE_BUILD_STEPS: readonly ["configure", "compile", "link", "resources", "script", "dex", "package", "sign"];
+type NativeBuildStep = (typeof NATIVE_BUILD_STEPS)[number];
+/**
+ * A running build's progress as its tool reports it. `unit` is `targets` for xcodebuild, `tasks` for Gradle and
+ * `steps` for SwiftPM. xcodebuild's `done` counts targets it finished and `total` the targets in its dependency graph,
+ * which includes targets with nothing to do; Gradle's `done` counts the tasks it reported, with a null `total`;
+ * SwiftPM's `done` and `total` are the `[done/total]` of its latest progress line, and its total can grow while it
+ * builds. They are counts, not a completion fraction. `status` reports the detail only during the `compile` phase. `line` is
+ * the latest compile, link or task line with paths shortened to file names.
+ */
+interface BuildDetail {
+  step: NativeBuildStep | null;
+  unit: "targets" | "tasks" | "steps" | null;
+  done: number | null;
+  total: number | null;
+  line: string | null;
+  updatedAt: string;
 }
-interface HostedDeviceOfferRequest extends HostedDeviceSelectors {
-  platform: HostedDevicePlatform;
+/** Where a build's app came from: a cache tier, or `false` when it compiled or failed before one was found. */
+type BuildCacheHit = "local" | "remote" | false;
+/** A platform's most recent `ios` or `android` run in one workspace. */
+interface DevicePlacement {
+  decision: "local" | "hosted" | "waited-locally" | "eas";
+  reason: string;
+  machine?: string;
 }
-type HostedNativeOffer = {
-  resources: {
-    cpus: number;
-    /** Five-minute system load divided by available CPU count. */
-    loadPerCore: number;
-    maxLoadPerCore?: number;
-    memoryFreeBytes: number;
-    memoryPressure: "normal" | "warning" | "critical" | null;
-    /** Available bytes on the Stim home volume, not necessarily the Android AVD volume. */
-    workerDiskFreeBytes: number | null;
-    localDevices?: number | {
-      unknown: string;
-    };
-  };
-  declined: string | null;
-} & ({
-  platform: "ios";
-  choice: HostedIosChoice | null;
-} | {
-  platform: "android";
-  choice: HostedAndroidChoice | null;
-} | {
-  platform: "macos";
-  choice: HostedMacosChoice | null;
-});
-type HostedDeviceOffer = HostedNativeOffer & {
-  capacity: {
-    running: number;
-    max: number;
-    available: number | null;
-    local?: number | {
-      unknown: string;
-    };
-  };
-};
-interface HostedDeviceRequest extends HostedDeviceOfferRequest {
-  workspace: string;
+interface LastBuildReport {
+  devicePlacement?: DevicePlacement;
+  platform: BuildPlatform;
+  status: "ok" | "failed";
+  cacheHit: BuildCacheHit;
+  cacheSkipped: boolean;
+  durationMs: number | null;
+  fingerprint: string | null;
+  startedAt: string;
+  finishedAt: string | null;
+  errorCode?: string;
+  missReason?: BuildMissReason;
+  /** The selected auto, local, or configured machine entry; present on new build records, including cache hits. */
+  buildMachine?: string;
+  /** Where compilation ran: here or a machine name; absent when no build ran. */
+  builtOn?: string;
+  /** The remote machine that compiled the app when the build was offloaded. */
+  offloadedTo?: string;
+  /** Why the run built here after it considered offloading; absent when it offloaded or never considered it. */
+  offloadFallback?: string;
+  /** The first compiler diagnostics of a failed build, when the build tool reported any. */
+  diagnostics?: BuildDiagnostic[];
+  /** Present on a failed run: what failed, from `buildCause`. */
+  cause?: BuildCause;
+}
+/**
+ * A failed run's cause: the first diagnostic with a file and a line, keyed `file:line`, else the run's error code
+ * (or `failed`), with null `file` and `line`. Consecutive failures with the same `key` failed the same way.
+ */
+interface BuildCause {
+  key: string;
+  file: string | null;
+  line: number | null;
+}
+/** How a recorded build ended. `interrupted` is a run whose process ended without recording a result. */
+declare const BUILD_RESULTS: readonly ["succeeded", "failed", "cancelled", "interrupted"];
+type BuildResult = (typeof BUILD_RESULTS)[number];
+/**
+ * One run in a workspace's recent build history. `configuration` is the iOS configuration or the Android
+ * variant the run built, `Debug` or `debug` by default, and null when the run ended before resolving it.
+ * `phases` holds the milliseconds spent in each phase the run entered. An interrupted run has null
+ * `durationMs` and `finishedAt`, no cache facts, and 0 for the phase it stopped in.
+ */
+interface BuildHistoryEntry extends LastBuildReport {
+  result: BuildResult;
   slot: string;
-  attempt: string;
+  configuration: string | null;
+  cacheKey: string | null;
+  phases: Partial<Record<BuildPhase, number>>;
+  /** A `stim macos` run's SwiftPM step total; absent for other runs and when the build reported none. */
+  compileSteps?: number;
 }
-type HostedDevicePhase = "preparing" | "ready" | "stopping" | "stopped" | "unknown";
-interface HostedDeviceSession extends HostedDeviceRequest {
-  id: string;
-  client: string;
-  state: HostedDevicePhase;
-  device: HostedDevice | null;
-  consolePort?: number;
-  appSlot?: number;
-  createdAt: string;
-  parked?: {
-    at: string;
+/** One compiler error from a failed build: where it is, when the tool said, and its message. */
+interface BuildDiagnostic {
+  file: string | null;
+  line: number | null;
+  column: number | null;
+  message: string;
+}
+/** What kind of native input a changed fingerprint source is. */
+type BuildMissCategory = "native-dependency" | "config-plugin" | "app-config" | "app-asset" | "package" | "native-dir" | "autolinking" | "package-scripts" | "file" | "other";
+interface BuildMissChange {
+  source: string;
+  change: "added" | "removed" | "changed";
+  category: BuildMissCategory;
+}
+/**
+ * Why a run compiled instead of installing a cached app. `changes` holds at most 20 entries,
+ * ordered by importance; `changeCount` is the full number of changed fingerprint sources.
+ * Only a plan reports `prebuild-pending`: the run would prebuild before compiling, so the changes
+ * compare the fingerprint before that prebuild.
+ */
+interface BuildMissReason {
+  kind: "changed" | "no-baseline" | "same-sources" | "cache-skipped" | "fingerprint-error" | "prebuild-pending";
+  summary: string;
+  changes: BuildMissChange[];
+  changeCount: number;
+  /** `cacheKey` is kept in workspace state so a later miss can find this baseline; status omits it. */
+  baseline: {
+    fingerprint: string;
+    cacheKey?: string;
+    from: "workspace" | "project";
+  } | null;
+  rekeyedBy: string[];
+}
+/** The payload `stim ios --plan --json` and `stim android --plan --json` print. */
+interface BuildPlanPayload {
+  platform: StatsPlatform;
+  slot?: string;
+  fingerprint: string;
+  cacheKey: string | null;
+  cacheHit: BuildCacheHit;
+  provider: string | null;
+  cacheSkipped: boolean;
+  prebuild: "none" | "generate" | "regenerate" | "refuse" | null;
+  outcome: RunOutcomeKind | null;
+  expectedMs: number | null;
+  basis: number;
+  /** On a predicted miss with cache reads on, why the cache has no app; `baseline` omits `cacheKey`. */
+  missReason?: BuildMissReason;
+  refusal?: {
+    code: string;
+    message: string;
+    remedy: string;
   };
-  notice?: string;
-  appAttempt?: string;
-  agent?: HostedAgentGrant;
-  metroPort?: number;
-  clientMetroPort?: number;
+  /** With ios.remote or android.remote set to auto or a Mac, where the plan assumes the device runs, such as `this machine; auto may use janics-mac-mini`. */
+  placement?: string;
 }
-declare function deviceHostRoot(): string;
-declare function deviceHostArea(id: string): string;
-declare function parseHostedChoice(value: unknown): HostedIosChoice | null;
-declare function parseHostedDevice(value: unknown): HostedIosDevice | null;
-declare function parseHostedAndroidDevice(value: unknown): HostedAndroidDevice | null;
-/** Android Emulator -help-port defines the supported even console ports as 5554 through 5584. */
-declare function hostedConsolePort(value: unknown): value is number;
-declare function parseHostedPlatformDevice(value: unknown, platform: HostedDevicePlatform): HostedDevice | null;
-declare function hostedDeviceId(device: HostedDevice): string;
-declare function parseHostedRequest(value: unknown): HostedDeviceRequest | null;
-declare function parseHostedOfferRequest(value: unknown): HostedDeviceOfferRequest | null;
-declare function parseHostedLocalDeviceCount(value: unknown): number | {
-  unknown: string;
-} | null;
-declare function parseHostedNativeOffer(value: unknown): HostedNativeOffer | null;
-/** A missing established journal or malformed record is a refusal, never an empty reservation set. */
-declare function readHostedSessions(): HostedDeviceSession[];
-/** The private worker's exact device record; an absent record is unresolved after creation started. */
-declare function readHostedDevice(home: string): HostedIosDevice;
-declare function readHostedDevice(home: string, platform: "android"): HostedAndroidDevice;
-declare function readHostedDevice(home: string, platform: "macos"): HostedMacosDevice;
-declare function readHostedDevice(home: string, platform: HostedDevicePlatform): HostedDevice;
-declare function readHostedDeviceLedger(home: string, options?: {
-  required?: boolean;
-}): {
-  ios: string[];
-  android: string[];
-  web: string[];
-} | null;
-/** Hosted sessions use isolated homes: only one exact device of their platform may appear in this ledger. */
-declare function assertHostedDeviceLedger(home: string, id: string, platform?: HostedDevicePlatform, options?: {
-  allowEmpty?: boolean;
-}): "listed" | "empty";
-//#endregion
-//#region state/workspace-state.d.ts
-interface WorkspaceState {
-  supervisor?: Record<string, unknown>;
-  collectors?: Record<string, unknown>;
-  lastBuild?: Record<string, unknown>;
-  launches?: Record<string, unknown>;
-  remoteDevice?: Record<string, unknown>;
-  metroTunnel?: Record<string, unknown>;
-  [key: string]: unknown;
+/** The read-only `stim macos --plan --json` payload; SwiftPM work and worker availability remain unknown. */
+interface MacosBuildPlanPayload {
+  platform: "macos";
+  product: string;
+  buildMachine: string;
+  fingerprint: string | null;
+  cacheKey: string | null;
+  cacheHit: boolean;
+  provider: null;
+  cacheSkipped: boolean;
+  prebuild: null;
+  outcome: null;
+  expectedMs: null;
+  basis: number;
 }
-declare const IDLE_STOP_KEY = "devServerStop";
-/** Why the supervisor last stopped the dev server on its own: `metro.idleStopMinutes` with no use. */
-interface IdleStopRecord {
-  reason: "idle";
-  at: string;
-  idleMinutes: number;
+type ActivityState = "driven" | "active" | "idle" | "unknown";
+interface ActivityDriver {
+  tool: string;
+  pid: number | null;
+  since: string | null;
 }
-declare function readIdleStop(state: WorkspaceState | null | undefined): IdleStopRecord | null;
-declare const DEVICE_RECLAIM_REASON = "reclaimed for a waiting run";
-declare const DEVICE_IDLE_SHUTDOWN_KEY = "deviceIdleShutdowns";
-/** An owned simulator or emulator shut down after being idle. */
-interface DeviceIdleShutdownRecord {
-  at: string;
-  idleMinutes: number;
-  reason?: string;
+/** The kinds of evidence that date a device's last activity, in the order `recent` lists them. */
+declare const ACTIVITY_RECENCY_BASES: readonly ["agent-action", "device-log", "metro-bundle", "workspace-use", "supervisor-start", "page-log", "viewer"];
+type ActivityRecencyBasis = (typeof ACTIVITY_RECENCY_BASES)[number];
+interface DeviceActivity {
+  state: ActivityState;
+  driver?: ActivityDriver;
+  lastActivityAt?: string;
+  /** The newest time of each kind of evidence behind `lastActivityAt`, so a reader can leave out app log chatter. */
+  recent?: Partial<Record<ActivityRecencyBasis, string>>;
+  basis: string[];
+  /** For a driven device, the probes that could not be read, which `basis` leaves out. */
+  unknown?: string[];
 }
-/** The recorded idle shutdowns by device slot key (`ios`, `android`, `ios:<slot>`). */
-declare function readDeviceIdleShutdowns(state: WorkspaceState | null | undefined): Record<string, DeviceIdleShutdownRecord>;
-declare const DEV_SERVER_STOP_REQUEST_KEY = "devServerStopRequest";
-/** A Stim component's intent to stop the supervisor with `processToken`, written before it signals. */
-interface DevServerStopRequest {
-  processToken: string;
-  by: string;
-  pid: number;
-  at: string;
-  workspace?: string;
+/** Every state a device's app process can report. */
+declare const APP_PROCESS_STATES: readonly ["running", "stopped", "unknown"];
+/**
+ * Whether the workspace's app process is alive on a device now. This is current process state, not launch evidence:
+ * `launched` in an `ios` or `android` result stays the record of one launch. `id` is the bundle identifier or
+ * package that was checked; `state` is "unknown" when the process listing could not be read.
+ */
+interface DeviceAppProcess {
+  id: string;
+  state: (typeof APP_PROCESS_STATES)[number];
 }
-declare function readDevServerStopRequest(state: WorkspaceState | null | undefined): DevServerStopRequest | null;
 /**
- * Why the dev server last stopped, stored under `IDLE_STOP_KEY`. `requested` names the Stim component that
- * asked; `signal` is a SIGTERM or SIGINT no Stim component asked for; `server-exited` is the dev server
- * process exiting on its own.
+ * A linked worktree's `git status`. `changed` counts tracked paths with staged or unstaged changes, including
+ * conflicts; `untracked` counts untracked entries as `git status` lists them, so an untracked directory counts once.
+ * `ahead` and `behind` compare HEAD with `upstream`, and are null when there is no upstream or it no longer exists.
+ * `mergedInto` names the default branch (`origin/main`) when `gc` would consider the branch merged into it, judged
+ * from local refs without fetching.
  */
-type DevServerStopRecord = IdleStopRecord | {
-  reason: "requested";
-  at: string;
-  by: string;
-  byPid: number;
-  byWorkspace?: string;
-} | {
-  reason: "signal";
-  at: string;
-  signal: string;
-} | {
-  reason: "server-exited";
-  at: string;
-  mode: string;
-  code: number | null;
-  signal: string | null;
-};
-/** A stopped dev server's last cause in status; `vanished` is a supervisor proven gone that recorded none. */
-type MetroLastStop = DevServerStopRecord | {
-  reason: "vanished";
-  pid: number;
-  startedAt: string | null;
-};
-declare function readDevServerStop(state: WorkspaceState | null | undefined): DevServerStopRecord | null;
-/** Each platform's latest run; `lastBuild` holds whichever platform ran last. */
-declare const LAST_BUILD_KEYS: Readonly<Record<StatsPlatform, string>>;
-declare const BUILD_HISTORY_KEY = "buildHistory";
-declare const BUILD_HISTORY_LIMIT = 10;
-/** A recorded miss reason in the shape status reports, without `baseline.cacheKey`; null when malformed. */
-declare function parseMissReason(value: unknown): BuildMissReason | null;
+interface WorktreeGit {
+  changed: number;
+  untracked: number;
+  upstream: string | null;
+  ahead: number | null;
+  behind: number | null;
+  mergedInto: string | null;
+}
 /**
- * The first diagnostics of a failed build in the shape a last-build record stores and `status` reports, the
- * ones with a source position first.
+ * The GitHub pull request of a worktree's branch and HEAD, as `status --watch` last looked it up through `gh`.
+ * `state` is `draft` for an open draft. `checks` counts the head commit's check runs and commit statuses, null when it
+ * has none. `checkedAt` is when Stim last asked GitHub.
  */
-declare function buildDiagnostics(value: unknown): BuildDiagnostic[];
-declare function readDevicePlacement(state: WorkspaceState | null, platform: StatsPlatform, slot?: string): DevicePlacement | null;
-declare function readLastBuilds(state: WorkspaceState | null | undefined): Partial<Record<StatsPlatform, LastBuildReport>>;
-/** Each platform's recorded runs, newest first, at most `BUILD_HISTORY_LIMIT` each. */
-declare function readBuildHistory(state: WorkspaceState | null | undefined): Partial<Record<BuildPlatform, BuildHistoryEntry[]>>;
-declare function readWorkspaceState(root: string): WorkspaceState | null;
-declare function lastUseFrom(state: WorkspaceState | null, logMtimes: readonly number[]): number;
+interface WorktreePullRequest {
+  number: number;
+  url: string;
+  title: string;
+  state: "open" | "draft" | "merged" | "closed";
+  checks: {
+    passing: number;
+    failing: number;
+    pending: number;
+  } | null;
+  reviewDecision: "approved" | "changes-requested" | "review-required" | null;
+  checkedAt: string;
+}
+interface WorktreeFacts {
+  path: string;
+  branch?: string;
+  repository?: string;
+  /** Null when git could not be read in time, the worktree is in a folder status does not open, or one-shot status skipped an idle environment or an unprovisioned worktree. */
+  git?: WorktreeGit | null;
+  /** Null when GitHub has no pull request for the branch; absent when unknown, such as without `gh`. */
+  pullRequest?: WorktreePullRequest | null;
+  /** Present with `git`: what the worktree's git chip shows, from `gitChip`. */
+  gitChip?: GitChip;
+}
+/** Every coding-agent tool whose sessions status can attribute to an environment. */
+declare const AGENT_TOOLS: readonly ["claude-code", "codex"];
+type AgentTool = (typeof AGENT_TOOLS)[number];
 /**
- * When an ios, android or macos run last finished in the workspace, from its recorded builds (a cache hit counts),
- * in epoch milliseconds; NaN when it records none. Dev server starts, reloads and logs do not count.
+ * A coding-agent session working in an environment: one whose working directory `cwd` is the environment's path,
+ * inside it, or its git worktree root, or one that ran a Stim command in it. `title` is the short name the tool keeps
+ * for the session, never its conversation. `lastActiveAt` is the tool's own last update, or the Stim command's time
+ * when that is newer. `openUrl` opens the session in the tool's desktop app when that app is installed on this machine.
+ * `webUrl` opens a Claude Code session with Remote Control connected on claude.ai/code or in the Claude mobile app.
  */
-declare function lastNativeUseFrom(state: WorkspaceState | null): number;
-declare const MAINTENANCE_LOG_NAME = "maintenance.ndjson";
+interface AgentSession {
+  tool: AgentTool;
+  sessionId: string;
+  title?: string;
+  cwd: string;
+  startedAt?: string;
+  lastActiveAt?: string;
+  pid?: number;
+  openUrl?: string;
+  webUrl?: string;
+}
 /**
- * When the workspace was last used, in epoch milliseconds. A workspace that recorded no use falls back to the mtime
- * of its workspace.json, which is written once when the workspace is created, so it is a lower bound on the last
- * use. NaN when its state.json exists but does not parse, or when workspace.json cannot be read either.
+ * An agent session that stopped running in an environment, with the details Stim last found while it ran. `endedAt`
+ * is the last time a status watcher found it running.
  */
-declare function workspaceLastUsed(root: string): number;
-declare const WARM_KEY = "warm";
-/** How long a successful warm keeps a workspace `ready` when nothing runs in it. */
-declare const READY_PHASE_MS: number;
+interface EndedAgentSession extends Omit<AgentSession, "pid"> {
+  endedAt: string;
+}
+interface AndroidRuntimeFacts {
+  serial: string | null;
+  state: "detected" | "not-detected" | "missing" | "unknown";
+  error?: string;
+}
+/** Every connection state a physical device can report. */
+declare const PHYSICAL_DEVICE_CONNECTIONS: readonly ["connected", "disconnected", "unknown"];
+type PhysicalDeviceConnection = (typeof PHYSICAL_DEVICE_CONNECTIONS)[number];
 /**
- * What `stim worktree warm` last recorded in a workspace: a warm in progress, held by the ownership claim
- * `claim` names, or a successful warm that finished at `at`.
+ * A physical iPhone, iPad or Android phone the workspace holds an unexpired lease on, from `ios --device`,
+ * `android --device` or `device lock`. Stim uses it and never owns it, so `owned` is always false. `id` is the
+ * UDID or adb serial. `name` is the device's own name, falling back to the name the lease recorded; `model` is the
+ * marketing name devicectl reports, null when it could not be read, or the Android model the lease recorded.
+ * `connection` is `connected` when devicectl can reach the phone or adb lists it as `device`, `disconnected` when
+ * the tool answered without it, and `unknown` when the tool could not be read in time. `lease.holder` is the
+ * workspace path that holds it.
  */
-type WarmRecord = {
-  phase: "warming";
-  step: WarmStep;
-  startedAt: string;
-  claim: {
-    root: string;
-    claimId: string;
+interface PhysicalDeviceState {
+  platform: StatsPlatform;
+  slot: string;
+  id: string;
+  name: string | null;
+  model: string | null;
+  owned: false;
+  physical: true;
+  connection: PhysicalDeviceConnection;
+  lease: {
+    holder: string;
+    kind: "declared" | "run";
+    grantedAt: string | null;
+    expiresAt: string;
   };
-} | {
-  phase: "ready";
-  at: string;
-};
-declare function readWarmRecord(state: WorkspaceState | null | undefined): WarmRecord | null;
-declare const WORKSPACE_AGENT_KEY = "agentSession";
+}
+interface RemoteDeviceState {
+  platform: "ios" | "android" | null;
+  backend: "eas";
+  sessionId: string;
+  state: "claimed" | "unclaimed" | "unknown";
+  startedAt: string | null;
+  webPreviewUrl: string | null;
+}
 /**
- * The coding-agent session whose shell ran the Stim command that last recorded `lastUsedAt`, with that command's
- * working directory as `cwd` and its time as `lastActiveAt`.
+ * One part of a worktree's git chip, in display order: commits ahead of and behind the upstream, uncommitted files
+ * (changed plus untracked), the base branch the branch is merged into (left out when its pull request is merged,
+ * whose own mark says so), and a branch with no upstream that is not merged.
  */
-declare function readWorkspaceAgent(state: WorkspaceState | null | undefined): AgentSession | null;
-//#endregion
-//#region state/hosted-native.d.ts
-interface HostedNativePlacement<D> {
-  machine: string;
-  session: string;
-  appAttempt: string;
-  device: D | null;
-  selected: string;
-  reason?: string;
-  agent: HostedAgentAccess;
-}
-declare function parseHostedNativePlacement(value: unknown, platform: "ios"): HostedNativePlacement<HostedIosDevice> | null;
-declare function parseHostedNativePlacement(value: unknown, platform: "android"): HostedNativePlacement<HostedAndroidDevice> | null;
-declare function parseHostedNativePlacement(value: unknown, platform: "ios" | "android"): HostedNativePlacement<HostedIosDevice | HostedAndroidDevice> | null;
-declare function hostedNativeRecords(state: WorkspaceState | null, platform: "ios" | "android"): Record<string, unknown>;
-declare function unreadableHostedNative(slot: string, platform: "ios" | "android"): string;
-//#endregion
-//#region state/hosted-android.d.ts
-/** A workspace slot's placement; null device means its reservation has not reached ready yet. */
-interface HostedAndroidPlacement extends HostedNativePlacement<HostedAndroidDevice> {}
-/** Public hosting facts; the host's serial, AVD name and private Metro gateway are excluded. */
-type HostedAndroidStatus = {
-  machine: string;
-  session: string;
-  selected: string;
-  reason?: string;
-  agent: HostedAgentAccess;
-  device: {
-    name: string;
-    systemImage: string;
-    api: number;
-  } | null;
-  /** The latest session probe in status, independent of a conflicting local emulator's state. */
-  state?: string;
-};
-declare function parseHostedAndroidPlacement(value: unknown): HostedAndroidPlacement | null;
-declare function hostedAndroidStatus(placement: HostedAndroidPlacement): HostedAndroidStatus;
-declare function hostedAndroidRecords(state: WorkspaceState | null): Record<string, unknown>;
-declare function unreadableHostedAndroid(slot: string): string;
-declare function hostedAndroidPlacements(state: WorkspaceState | null): Record<string, HostedAndroidPlacement>;
-declare function hostedAndroidDeviceName(device: HostedAndroidDevice): string;
-//#endregion
-//#region state/hosted-ios.d.ts
-/** A workspace slot's placement; null device means its reservation has not reached ready yet. */
-interface HostedIosPlacement extends HostedNativePlacement<HostedIosDevice> {}
-/** Public hosting facts; the host's UDID and private Metro gateway are excluded. */
-type HostedIosStatus = {
-  machine: string;
-  session: string;
-  selected: string;
-  reason?: string;
-  agent: HostedAgentAccess;
-  device: {
-    name: string;
-    runtime: string;
-  } | null;
-  /** The latest session probe in status, independent of a conflicting local simulator's state. */
-  state?: string;
+type GitChipPart = {
+  kind: "arrows";
+  ahead: number;
+  behind: number;
+} | {
+  kind: "changed";
+  count: number;
+} | {
+  kind: "merged";
+  into: string;
+} | {
+  kind: "no-upstream";
 };
-declare function parseHostedIosPlacement(value: unknown): HostedIosPlacement | null;
-declare function hostedIosStatus(placement: HostedIosPlacement): HostedIosStatus;
-declare function hostedIosRecords(state: WorkspaceState | null): Record<string, unknown>;
-declare function unreadableHostedIos(slot: string): string;
-declare function hostedIosPlacements(state: WorkspaceState | null): Record<string, HostedIosPlacement>;
-//#endregion
-//#region state/maintenance.d.ts
-type MaintenanceMode = "off" | "report" | "on";
-type MaintenanceCheck = "pressure" | "size" | "worktree" | "sweep" | "idle";
-type MaintenanceActionKind = "would-clear-outputs" | "would-trim-cache" | "would-empty-cache" | "would-shutdown-device" | "would-stop-workspace" | "would-remove-worktree" | "would-remove-orphan" | "would-unregister-cache" | "would-delete-parked-device" | "would-delete-devices" | "would-clear-build-dirs" | "would-delete-dependencies" | "would-stop-gradle-daemons" | "would-delete-gradle-version" | "would-delete-temp-leftovers";
-/** Disk pressure: 0 above every threshold, 1 under the budget floor, 2 under the urgent threshold, 3 under the critical threshold or the hard floor. */
-type DiskPressureLevel = 0 | 1 | 2 | 3;
-interface MaintenanceAction {
-  kind: MaintenanceActionKind;
-  target: string;
-  bytes: number;
-  reason: string;
-  workspace?: string;
-  dir?: string;
-  olderThanDays?: number;
-  check?: "worktree" | "sweep" | "disk";
-  /** The disk pressure level that planned the action; it runs only while free disk stays under that level's floor. */
-  level?: 2 | 3;
+/** A pull request's checks at a glance: any failing, else any pending, else any passing; null without checks. */
+type ChecksState = "passing" | "failing" | "pending" | null;
+interface GitChip {
+  parts: GitChipPart[];
+  ci: ChecksState;
 }
-interface MaintenanceSize {
-  name: string;
-  dir: string;
-  bytes: number;
-  measuredAt: number;
-  category: "workspace-outputs" | "build-cache" | "metro-cache" | "compilation-cache" | "ccache" | "owned-devices" | "other";
-  workspace?: string;
-  idleDays?: number | null;
-  blocked?: string;
+/**
+ * Whether a running owned simulator or emulator lacks the workspace's app: `none` when its platform never built
+ * successfully here and the latest build failed, `closed` when status saw no app process, else null.
+ */
+type AppPresence = "none" | "closed" | null;
+declare const WORKSPACE_STAGE_KINDS: readonly ["building", "warming", "ready", "build-failed", "running", "stopped"];
+/**
+ * Where a workspace is, first match wins: `building` while a build runs, `warming` and `ready` from `phase` when
+ * nothing is live, `build-failed` when the newest run of either platform failed, `running` when it is live, its
+ * macOS app is running or orphaned, or it holds a remote device, else `stopped`. `since` is when that began: the
+ * build's start, the warm phase's time, the failed run's end (else start), the supervisor's start (else the running
+ * macOS app's build end, else its start), or Metro's last stop. `platform` names the build for `building`
+ * and `build-failed`. `closedApps` lists, for `running`, the devices whose `appPresence` is `closed`.
+ */
+interface WorkspaceStage {
+  kind: (typeof WORKSPACE_STAGE_KINDS)[number];
+  since: string | null;
+  platform: StatsPlatform | "macos" | null;
+  closedApps: {
+    platform: StatsPlatform;
+    slot: string;
+  }[];
 }
+/** Every code a status issue can carry. */
+declare const STATUS_ISSUE_CODES: readonly ["port-not-ours", "sim-missing", "sim-without-metro", "avd-serial-changed", "avd-missing", "avd-not-detected", "avd-unchecked", "android-reverse-missing", "supervisor-unverified", "browser-unverified", "browser-orphaned"];
+type StatusIssueCode = (typeof STATUS_ISSUE_CODES)[number];
 /**
- * A process whose physical footprint, as `top` reports it, is abnormally large. `command` is the one command that
- * safely restarts or stops it, null when Stim knows none; `note` says what that command does.
+ * One thing in a workspace that needs the user, or with severity `info` a note that needs nothing. `remedy` is a
+ * command to run from `workspace`; `slot` is absent for the default device slot. `warnings` carries the `error` and
+ * `warning` issues as text.
+ *
+ * Severity:
+ * - `error`: Stim cannot verify or safely act on something; a person resolves it, following the teardown guide.
+ * - `warning`: something is broken now and needs someone to act, such as an app that cannot reach Metro, a held
+ *   port or a device that vanished while expected.
+ * - `info`: a fact the next normal Stim command handles by itself, so it needs no action.
+ *
+ * The phone app and Stim Desktop show `error` and `warning` and hide `info`; plain `stim status` prints `info` as a
+ * dim note with no remedy.
  */
-interface MemoryCulprit {
-  pid: number;
-  name: string;
-  bytes: number;
-  command: string | null;
-  note: string | null;
+interface StatusIssue {
+  code: StatusIssueCode;
+  severity: "error" | "warning" | "info";
+  message: string;
+  remedy: string;
+  workspace: string;
+  slot?: string;
 }
-interface MaintenancePressure {
-  disk: {
-    volume: string;
-    freeMb: number;
-  }[];
-  memory: {
-    level: "normal" | "warning" | "critical" | null;
-    availableBytes: number | null;
-    pressured: boolean;
-    /** Read only while the level is warning or critical; absent otherwise. */
-    culprits?: MemoryCulprit[];
-  };
-  warningSince: number | null;
-  diskLevel?: DiskPressureLevel;
+/** Every state the owned page's latest load can report. */
+declare const WEB_PAGE_STATES: readonly ["loading", "loaded", "failed"];
+/**
+ * The owned page's latest load, from the page-load marker in the workspace's web log: `url` is the document it
+ * loaded, `state` is `failed` when that document did not load or the page crashed, with the log message as
+ * `error`. `route`, present only when an in-app route change (history API or fragment) moved the page off `url`
+ * since the load, is the URL it shows now.
+ */
+interface WebPageState {
+  url: string;
+  state: (typeof WEB_PAGE_STATES)[number];
+  error?: string;
+  route?: string;
 }
-interface MaintenancePass {
-  startedAt: number;
-  durationMs: number;
-  trigger: string;
-  mode: "report" | "on";
-  freedBytes: number;
-  actions: number;
-  stopped: 0;
-  blocked: string[];
+/**
+ * The workspace's Stim-owned Chrome. `pid` is Chrome's process and `supervisorPid` the Stim process that holds
+ * its DevTools session. `cdpEndpoint` is the loopback DevTools HTTP endpoint agents can attach to, and `targetId`
+ * the DevTools target of the owned page; both are null when the browser is not running. `profile` is the
+ * Stim-owned user data directory. `page` is null before the page's first load. `activity` names DevTools clients
+ * other than Stim's as drivers.
+ */
+interface WebBrowserState {
+  browser: "chrome";
+  version: string | null;
+  running: boolean;
+  pid: number | null;
+  supervisorPid: number | null;
+  url: string;
+  headless: boolean;
+  viewport: WebViewport;
+  profile: string;
+  cdpEndpoint: string | null;
+  targetId: string | null;
+  page?: WebPageState | null;
+  activity?: DeviceActivity;
 }
-interface MaintenanceRecord extends NdjsonRecord {
-  ts: number;
-  src: "maintenance";
-  level: "debug" | "info" | "warn" | "error";
-  msg: string;
-  event: "maintenance_pass" | "maintenance_action" | "maintenance_skip" | "maintenance_failure" | "maintenance_check";
-  pass: string;
-  trigger: string;
-  mode: "report" | "on";
+/** The steps of `stim worktree warm`: `refresh` fast-forwards and installs in the source checkout, `copy` carries ignored entries. */
+type WarmStep = "refresh" | "copy";
+/**
+ * Where a workspace is in its lifecycle: `warming` while `stim worktree warm` runs in it, `ready` after a warm
+ * succeeded and before any `start`, `ios`, `android`, `web` or `reload` there, for at most two hours; `live` when
+ * anything it owns runs, else `idle`.
+ */
+declare const WORKSPACE_PHASES: readonly ["warming", "ready", "live", "idle"];
+type WorkspacePhase = (typeof WORKSPACE_PHASES)[number];
+/** A folder's size on disk as `status --watch` last measured it. */
+interface DiskMeasure {
+  bytes: number;
+  measuredAt: string;
 }
-interface MaintenanceState {
-  version: 1;
-  lastAt: Partial<Record<MaintenanceCheck, number>>;
-  deferredAt?: Partial<Record<MaintenanceCheck, number>>;
-  pressure: MaintenancePressure | null;
-  sizes: MaintenanceSize[];
-  lastPass: MaintenancePass | null;
-  recent: MaintenanceRecord[];
-  plan: MaintenanceAction[];
-  skipKeys?: string[];
+/**
+ * An environment's disk use as `status --watch` last measured it. `worktreeBytes` is the git worktree folder, or the
+ * workspace folder outside one, node_modules included. `nodeModulesBytes` is node_modules at the worktree root and,
+ * when different, at the workspace path, and is part of `worktreeBytes`. `buildBytes` is Stim's own folder for the
+ * workspace: Xcode derived data, Gradle outputs and logs. A figure is null until it was measured; `measuredAt` is the
+ * oldest measurement.
+ */
+interface EnvironmentDisk {
+  worktreeBytes: number | null;
+  nodeModulesBytes: number | null;
+  buildBytes: number | null;
+  measuredAt: string;
 }
-interface MaintenanceStatus {
-  mode: MaintenanceMode;
-  invalid?: string;
-  claim?: {
-    unresolved: string;
-    removeCommand: string;
-  };
-  lastChecks: {
-    pressure: number | null;
-    size: number | null;
-    worktree: number | null;
-    sweep: number | null;
+/**
+ * A Metro bundle request: `bundling` while one is in flight on the workspace's Metro, with its `platform`,
+ * `startedAt` and, when Metro reported progress for it, `percent` (0-100). `last` is the newest finished request,
+ * `durationMs` from request to response end.
+ */
+interface MetroBundleState {
+  bundling: boolean;
+  platform?: StatsPlatform;
+  startedAt?: string;
+  percent?: number;
+  last?: {
+    platform: StatsPlatform;
+    status: "ok" | "failed";
+    durationMs: number;
+    finishedAt: string;
   };
-  pressure: MaintenancePressure | null;
-  sizes: MaintenanceSize[];
-  lastPass: MaintenancePass | null;
-  running: {
-    startedAt: string;
-    trigger: string;
-  } | null;
-  recent: MaintenanceRecord[];
-  plan: MaintenanceAction[];
 }
-/** Rejects missing, corrupt or unsupported payloads without throwing. */
-declare function parseMaintenanceState(value: unknown): MaintenanceState | null;
-declare function readMaintenanceState(): MaintenanceState | null;
-declare function readMaintenanceAttempt(): number | undefined;
-//#endregion
-//#region state/archive.d.ts
-interface ArchivedBytes {
-  logs: number;
-  recordings: number;
-  agentActions: number;
-  record: number;
-  total: number;
+interface SimulatorState {
+  devicePlacement?: DevicePlacement;
+  host?: HostedIosStatus;
+  name: string | null;
+  udid: string;
+  owned: boolean;
+  state: string;
+  activity?: DeviceActivity;
+  app?: DeviceAppProcess;
+  appPresence?: AppPresence;
+  /** The simulator's data folder, for an owned simulator once measured. */
+  disk?: DiskMeasure;
+  /** Present while the device is not booted after idle shutdown or queue reclaim. */
+  idleShutdown?: DeviceIdleShutdownRecord;
 }
-interface ArchivedWorkspace {
-  id: string;
-  projectRoot: string;
-  project: string;
-  workspace: string;
-  worktree: {
-    repository: string | null;
-    branch: string | null;
-    head: string | null;
-    subject: string | null;
-    merged: boolean | null;
-    pullRequest: {
-      number: number;
-      state: string;
-      title: string;
-      url: string;
-    } | null;
-  };
-  removedAt: string;
-  removedBy: string;
-  lastUsedAt: string | null;
-  builds: {
-    count: number;
-    last: LastBuildReport | null;
-    lastErrorCount: number;
+interface AndroidDeviceState {
+  devicePlacement?: DevicePlacement;
+  host?: HostedAndroidStatus;
+  name: string | undefined;
+  owned: boolean;
+  physical: boolean;
+  serial?: string | null;
+  state?: AndroidRuntimeFacts["state"] | "ready" | "stopped" | "unverified";
+  deviceProfile?: string | null;
+  activity?: DeviceActivity;
+  app?: DeviceAppProcess;
+  appPresence?: AppPresence;
+  /** The AVD's folder, for an owned emulator once measured. */
+  disk?: DiskMeasure;
+  /** Present while the emulator is not running after idle shutdown or queue reclaim. */
+  idleShutdown?: DeviceIdleShutdownRecord;
+}
+/** The tutorial format version the installed Stim writes into the tutorial app. */
+declare const TUTORIAL_VERSION = 2;
+interface EnvironmentState {
+  slots?: {
+    slot: string;
+    ios: SimulatorState | null | undefined;
+    android: AndroidDeviceState | null | undefined;
+  }[];
+  path: string;
+  /** The 16-hex identity of the registered canonical project path, used by shared workspace links. */
+  workspaceId?: string;
+  /** Statically detected app platforms; always set by status, empty when none are detected. */
+  platforms?: string[];
+  /** Present when the app's app.json sets expo.extra.stimTutorial to a positive integer: that version. */
+  tutorial?: {
+    version: number;
   };
-  agents: EndedAgentSession[];
-  bytes: ArchivedBytes;
-  expires: {
-    logs: string | null;
-    recordings: string | null;
-    agentActions: string | null;
-    record: string | null;
+  /** When `stim doctor` last ran in this workspace, per platform; absent until it has run. */
+  doctorRuns?: Partial<Record<"ios" | "android", {
+    at: string;
+  }>>;
+  live: boolean;
+  phase?: WorkspacePhase;
+  /** When the warm started (`warming`) or finished (`ready`); null for `live` and `idle`. */
+  phaseSince?: string | null;
+  /** Whether stim-server may record this workspace's device screens, from `recording.enabled`. */
+  recording?: {
+    enabled: boolean;
   };
-  version: number;
-  replacedBy?: string;
-}
-interface ArchivedUsage {
-  count: number;
-  bytes: number;
-  byKind: {
-    logs: number;
-    recordings: number;
-    agentActions: number;
-    record: number;
+  /** Present when `workspace.hidden` is true: clients list the workspace under Hidden. */
+  hidden?: true;
+  /** Where the workspace is, from `workspaceStage`; `stim status --json` always sets it. */
+  stage?: WorkspaceStage;
+  /** The step a `warming` workspace's warm is in; absent in every other phase. */
+  warmStep?: WarmStep;
+  /**
+   * The memory this workspace's processes use, as `memorySource` says: the sum of its `machine` owners' `memoryMb`
+   * when status read their footprints, or else a fixed estimate per booted simulator, detected emulator, running
+   * Metro and running Chrome. `capacity.committedMb` sums it.
+   */
+  memoryMb: number;
+  /** How `memoryMb` was obtained; absent from payloads written before it existed, which carry the estimate. */
+  memorySource?: Exclude<MemorySource, "rss">;
+  warnings: string[];
+  issues: StatusIssue[];
+  ios?: SimulatorState | null;
+  android?: AndroidDeviceState | null;
+  metro?: {
+    port: number;
+    running: boolean;
+    pid: number | null;
+    tunnel?: {
+      provider: Exclude<TunnelMode, "auto" | "off" | "expo">;
+      url: string;
+    };
+    idleStop?: IdleStopRecord;
+    lastStop?: MetroLastStop;
+    /** The other process that answers Metro on `port`; `cwd` is null when its directory could not be read. */
+    heldBy?: {
+      pid: number;
+      cwd: string | null;
+    };
+    /** Absent when the Metro log holds no bundle request. */
+    bundle?: MetroBundleState;
+  } | null;
+  web?: WebBrowserState | null;
+  macos?: MacosAppState | null;
+  supervisor?: {
+    pid: number | null;
+    mode: string | null;
+    startedAt: string | null;
+    healthy: boolean;
+  } | null;
+  logs?: {
+    dir: string;
+    errorsSinceMarker: number;
+  } | null;
+  /** `installed` is whether the agent-device executable is on the PATH of the process that ran status. */
+  agentDevice?: {
+    stateDir: string;
+    installed?: boolean;
   };
+  worktree?: WorktreeFacts | null;
+  remoteDevices?: RemoteDeviceState[];
+  /** The physical devices this workspace leases, in every slot; absent when it leases none. */
+  physicalDevices?: PhysicalDeviceState[];
+  build?: BuildReport | null;
+  lastBuilds?: Partial<Record<StatsPlatform, LastBuildReport>>;
+  /** Each platform's recent runs, newest first, at most `BUILD_HISTORY_LIMIT` each. */
+  builds?: Partial<Record<BuildPlatform, BuildHistoryEntry[]>>;
+  disk?: EnvironmentDisk;
+  /** The coding-agent sessions working in the environment, most recently active first; absent when none. */
+  agents?: AgentSession[];
+  /** The agent sessions that stopped running here in the last 3 days, most recently ended first; absent when none. */
+  endedAgents?: EndedAgentSession[];
 }
-declare function readArchives(): ArchivedWorkspace[];
-/** Reads current archive files asynchronously, outside the synchronous state-read cache; cancellation propagates. */
-declare function readArchivesAsync(signal?: AbortSignal): Promise<ArchivedWorkspace[]>;
-declare function readArchive(id: string): ArchivedWorkspace | null;
-/** Reads a current archive without the synchronous state-read cache; invalid or missing records return null. */
-declare function readArchiveAsync(id: string, signal?: AbortSignal): Promise<ArchivedWorkspace | null>;
-declare function readArchiveState(id: string): WorkspaceState | null;
-declare function archivedUsage(archives: readonly ArchivedWorkspace[]): ArchivedUsage;
-declare function linkReplacedArchives(archives: readonly ArchivedWorkspace[], paths: readonly string[]): ArchivedWorkspace[];
-declare function archiveEnabled(env: NodeJS.ProcessEnv, layers: readonly unknown[]): boolean;
-//#endregion
-//#region state/macos.d.ts
-interface MacosProcess {
-  pid: number;
-  processToken: string;
-  startedAtMicros: number;
+/** `committedMb` sums the environments' `memoryMb`; `overCapacity` is that sum over 60% of `totalMemoryMb`. */
+interface StatusCapacity {
+  liveCount: number;
+  committedMb: number;
+  totalMemoryMb: number;
+  overCapacity: boolean;
+  /** `concurrency.maxBuilds` usage; present only while that cap is set. */
+  builds?: StatusBuildSlots;
+  /** `concurrency.maxDevices` usage; present only while that cap is set. */
+  devices?: StatusDeviceSlots;
+  /** This machine's load. Optional only so payloads from releases that predate it still decode. */
+  load?: StatusCapacityLoad;
 }
-interface MacosBuild {
-  state: "running" | "ok" | "failed";
-  startedAt: string;
-  finishedAt?: string;
-  durationMs?: number;
-  fingerprint?: string;
-  cacheKey?: string;
-  cacheHit?: boolean;
-  cacheSource?: "local" | "provider" | "peer";
-  error?: string;
-  errorCode?: string;
-  buildMachine?: string;
-  builtOn?: string;
-  offloadedTo?: string;
-  offloadFallback?: string;
+/**
+ * `free` is under `busyAt` (`server.maxLoadPerCore`), where placement keeps work on this machine; `busy` is at or over
+ * it, where placement prefers another machine; `holding` is at or over `limit`, where new local native work waits.
+ */
+type LoadState = "free" | "busy" | "holding";
+/**
+ * `loadPerCore` is the 5-minute load average divided by `cpus`, rounded to one decimal. `limit` is the load per core at
+ * which new local native work waits, null while no limit is configured.
+ */
+interface StatusCapacityLoad {
+  cpus: number;
+  loadPerCore: number;
+  busyAt: number;
+  limit: number | null;
+  state: LoadState;
 }
-interface MacosAppRecord {
-  launchId: string;
-  arguments: string[];
-  product: string;
-  /** The app's visible name: the product and the workspace label. Absent in older records. */
-  displayName?: string;
-  bundle: string;
-  bundleId: string;
-  executable: string;
-  build: MacosBuild;
-  supervisor?: MacosProcess;
-  app?: MacosProcess;
-  /** Set when `stim macos --remote` reserved a session on another Mac; the app then has no local process. */
-  host?: HostedMacosPlacement;
-  /** Host launch evidence: true for a live app; status can override it in memory after probing the session. */
-  hostLaunched?: boolean | "unverified";
+/**
+ * A held build slot. `workspace` is the root of the local build holding it, `client` the device id of the client
+ * whose offloaded build this machine runs in it; both are null for a slot whose holder Stim cannot read.
+ */
+interface StatusBuildSlotHolder {
+  slot: number;
+  workspace: string | null;
+  client: string | null;
+  since: string | null;
+  unresolved?: true;
 }
-interface MacosAppState extends MacosAppRecord {
-  state: "running" | "orphaned" | "stopped" | "unverified";
+/** `inUse` counts the slots below `max` that a live or unresolved claim holds, which a new build cannot take. */
+interface StatusBuildSlots {
+  max: number;
+  inUse: number;
+  holders: StatusBuildSlotHolder[];
 }
-declare function parseMacosRecord(value: unknown): MacosAppRecord | null;
-declare function readMacosRecord(root: string): MacosAppRecord | null;
-declare function readHostedMacosApp(home: string): MacosAppRecord | null;
-declare function macosAppState(record: MacosAppRecord | null): MacosAppState | null;
-//#endregion
-//#region state/status.d.ts
-type StatsPlatform = "ios" | "android";
-/** A platform whose build reports phases: the stats platforms and `macos`. */
-type BuildPlatform = StatsPlatform | "macos";
-type RunOutcomeKind = "hit" | "cold";
-declare const BUILD_PHASES: readonly ["prepare", "cache-lookup", "wait", "prebuild", "pods", "compile", "device", "install", "launch"];
-type BuildPhase = (typeof BUILD_PHASES)[number];
-type ActiveBuildState = "running" | "stale" | "unknown";
 /**
- * Where a running build compiles: `local`, or the remote machine it was offloaded to, with the phase it is in there
- * (`sync`, `deps`, `prebuild`, `pods`, `build` or `fetch`) and when the offload and that phase started.
+ * An owned device counted against `concurrency.maxDevices`. `label` is the label of the workspace that records it, or
+ * the device's name when no workspace does; `workspace` and `slot` are null then.
  */
-type BuildPlacement = "local" | {
-  host: string;
-  phase: string;
-  startedAt: string;
-  phaseStartedAt: string;
-};
-interface BuildWaitingFor {
-  kind: "build-slot" | "device-slot";
-  inUse: number;
+interface StatusDeviceSlotHolder {
+  platform: "ios" | "android";
+  label: string;
+  workspace: string | null;
+  slot: string | null;
+  booting?: true;
+}
+/** `inUse` is null, with `unknown` saying why, when Stim cannot count the owned devices. */
+interface StatusDeviceSlots {
   max: number;
-  since: string;
+  inUse: number | null;
+  unknown?: string;
+  holders: StatusDeviceSlotHolder[];
 }
-interface BuildReport {
-  platform: BuildPlatform;
-  slot: string;
-  state: ActiveBuildState;
-  phase: BuildPhase;
-  startedAt: string;
-  phaseStartedAt: string;
-  outcome: RunOutcomeKind | null;
-  /** Whether `outcome` is this run's own; before its cache lookup resolves it is the project's latest outcome. */
-  outcomeKnown: boolean;
-  /** The resolved lookup result; absent before resolution and when the run skips cache lookup. */
-  cacheLookupOutcome?: "hit" | "miss";
-  expectedMs: number | null;
-  expectedPhaseMs: number | null;
-  /** Milliseconds spent in phases already left; sums repeat visits, excludes the current visit, and is omitted before any phase completes and by older Stim. */
-  completedPhaseMs?: Partial<Record<BuildPhase, number>>;
-  basis: number;
-  /**
-   * The phases a run like this one goes through, in order, with each one's median in milliseconds, from the same
-   * runs as `expectedMs`; null without comparable runs. The current phase can be one the plan does not list.
-   */
-  plannedPhases: PlannedPhase[] | null;
-  /** Why the run's cache lookup missed, once the run knows; `baseline` omits `cacheKey`. */
-  missReason?: BuildMissReason;
-  /**
-   * True while `missReason` is the miss of the key the run looked up first and the run will prebuild or install pods,
-   * then look the key up again. A hit on the second lookup removes `missReason` and sets `outcome` to `hit`.
-   */
-  missProvisional?: true;
-  /** What the native build tool is doing now, once it printed a line Stim recognizes. */
-  detail?: BuildDetail;
-  /** What the `device` or `launch` phase is waiting on, once Stim observed it; absent otherwise and from older Stim. */
-  activity?: BuildActivity;
-  placement: BuildPlacement;
-  /** While `phase` is `wait`: the workspace whose build of the same artifact this run waits on, when it is known. */
-  waitingOn?: {
-    path: string;
-  };
-  waitingFor?: BuildWaitingFor;
+interface DeviceLeaseState {
+  slot?: string;
+  path: string;
+  platform: string;
+  id: string | null;
+  deviceName: string | null;
+  holder: string | null;
+  grantedAt: string | null;
+  expiresAt: string | null;
+  mine: boolean;
+  expired: boolean;
+  parsed: boolean;
 }
 /**
- * What a run's `device` or `launch` phase is waiting on. `booting` lasts while the run waits for the owned simulator or
- * emulator it started booting. `bundling` starts when the app's bundle request reaches this workspace's
- * Metro and ends when Metro delivered it; `percent` is Metro's own progress for that request, present only once Metro
- * reported one. `waiting-ready` lasts while the app reports its readiness pending. `startedAt` is when the evidence was
- * recorded.
+ * Where a memory figure comes from. `footprint` is each process's physical footprint, which Activity Monitor's Memory
+ * column shows. `rss` sums resident set sizes, which count pages shared between processes once per process, so a
+ * simulator reports well above its footprint; the machine owners fall back to it when the footprint helper cannot be
+ * built. `estimate` is a fixed amount per running thing, which an environment reports whenever it has no footprint.
  */
-interface BuildActivity {
-  name: "booting" | "bundling" | "waiting-ready";
-  startedAt: string;
-  percent?: number;
-}
-/** One phase a running build is expected to go through, and its median duration in comparable runs. */
-interface PlannedPhase {
-  phase: BuildPhase;
-  expectedMs: number;
-}
-/** The native build tool's step inside a build's `compile` phase. */
-declare const NATIVE_BUILD_STEPS: readonly ["configure", "compile", "link", "resources", "script", "dex", "package", "sign"];
-type NativeBuildStep = (typeof NATIVE_BUILD_STEPS)[number];
+declare const MEMORY_SOURCES: readonly ["footprint", "rss", "estimate"];
+type MemorySource = (typeof MEMORY_SOURCES)[number];
+/** Every kind of process owner the status machine section reports. */
+declare const MACHINE_OWNER_KINDS: readonly ["simulator", "emulator", "metro", "build", "browser", "macos", "server", "shared"];
+type MachineOwnerKind = (typeof MACHINE_OWNER_KINDS)[number];
 /**
- * A running build's progress as its tool reports it. `unit` is `targets` for xcodebuild, `tasks` for Gradle and
- * `steps` for SwiftPM. xcodebuild's `done` counts targets it finished and `total` the targets in its dependency graph,
- * which includes targets with nothing to do; Gradle's `done` counts the tasks it reported, with a null `total`;
- * SwiftPM's `done` and `total` are the `[done/total]` of its latest progress line, and its total can grow while it
- * builds. They are counts, not a completion fraction. `status` reports the detail only during the `compile` phase. `line` is
- * the latest compile, link or task line with paths shortened to file names.
+ * One thing using this machine's CPU and memory now. Each process is counted in exactly one owner: the one whose root
+ * process is its nearest ancestor. `workspace` and `slot` (absent for the default slot) name the workspace a
+ * simulator, emulator, Metro, build or Chrome belongs to; a device no workspace records has a null workspace, and
+ * machine-wide processes are `shared`. `id` is the simulator's UDID, the emulator's AVD name, Metro's port as text,
+ * the build's platform, or null. `owned` is true only for what Stim started and stops: a workspace's owned device,
+ * Metro, build or Chrome. `cpuPercent` is `ps` %CPU summed over the owner's processes, where 100 is one core.
+ * `residentMb` sums their resident set sizes; pages shared between processes count once per process, so a
+ * simulator, whose processes all map the runtime's shared libraries, reports well above its physical footprint.
+ * `memoryMb` sums their physical footprints when `MachineUsageState.memorySource` is `footprint`, taking the resident
+ * size of a process the footprint helper could not read, and equals `residentMb` when it is `rss`.
  */
-interface BuildDetail {
-  step: NativeBuildStep | null;
-  unit: "targets" | "tasks" | "steps" | null;
-  done: number | null;
-  total: number | null;
-  line: string | null;
-  updatedAt: string;
+interface MachineOwner {
+  kind: MachineOwnerKind;
+  name: string;
+  workspace: string | null;
+  slot?: string;
+  id: string | null;
+  owned: boolean;
+  cpuPercent: number;
+  residentMb: number;
+  memoryMb: number;
+  processes: number;
 }
-/** Where a build's app came from: a cache tier, or `false` when it compiled or failed before one was found. */
-type BuildCacheHit = "local" | "remote" | false;
-/** A platform's most recent `ios` or `android` run in one workspace. */
-interface DevicePlacement {
-  decision: "local" | "hosted" | "waited-locally" | "eas";
-  reason: string;
-  machine?: string;
+/** Where this machine's CPU and memory go, from one pass over the host process table. */
+interface MachineUsageState {
+  memorySource: Exclude<MemorySource, "estimate">;
+  owners: MachineOwner[];
 }
-interface LastBuildReport {
-  devicePlacement?: DevicePlacement;
-  platform: BuildPlatform;
-  status: "ok" | "failed";
-  cacheHit: BuildCacheHit;
-  cacheSkipped: boolean;
-  durationMs: number | null;
-  fingerprint: string | null;
-  startedAt: string;
-  finishedAt: string | null;
-  errorCode?: string;
-  missReason?: BuildMissReason;
-  /** The selected auto, local, or configured machine entry; present on new build records, including cache hits. */
-  buildMachine?: string;
-  /** Where compilation ran: here or a machine name; absent when no build ran. */
-  builtOn?: string;
-  /** The remote machine that compiled the app when the build was offloaded. */
-  offloadedTo?: string;
-  /** Why the run built here after it considered offloading; absent when it offloaded or never considered it. */
-  offloadFallback?: string;
-  /** The first compiler diagnostics of a failed build, when the build tool reported any. */
-  diagnostics?: BuildDiagnostic[];
-  /** Present on a failed run: what failed, from `buildCause`. */
-  cause?: BuildCause;
+/** The payload `stim status --json` prints, and `status --watch --json` prints on each change. */
+interface StatusPayload {
+  maintenance?: MaintenanceStatus;
+  archived?: ArchivedWorkspace[];
+  archivedUsage?: ArchivedUsage;
+  environments: (EnvironmentState & {
+    labelOnly?: true;
+  })[];
+  capacity: StatusCapacity;
+  deviceLeases: DeviceLeaseState[];
+  unprovisionedWorktrees: WorktreeFacts[];
+  simctlAvailable: boolean;
+  /** Null when nothing runs that status attributes, so it read no process table, or when the table was unreadable. */
+  machine: MachineUsageState | null;
 }
+//#endregion
+//#region state/build-capacity.d.ts
+declare function buildSlotsDir(): string;
+declare function buildSlotPath(index: number): string;
 /**
- * A failed run's cause: the first diagnostic with a file and a line, keyed `file:line`, else the run's error code
- * (or `failed`), with null `file` and `line`. Consecutive failures with the same `key` failed the same way.
+ * Takes the first free one of `max` `concurrency.maxBuilds` slots, recording `details` and the slot `index`. Returns
+ * null while every slot is held; throws the claim refusal when no slot is busy but one cannot be resolved.
  */
-interface BuildCause {
-  key: string;
-  file: string | null;
-  line: number | null;
-}
-/** How a recorded build ended. `interrupted` is a run whose process ended without recording a result. */
-declare const BUILD_RESULTS: readonly ["succeeded", "failed", "cancelled", "interrupted"];
-type BuildResult = (typeof BUILD_RESULTS)[number];
+declare function tryAcquireBuildSlotClaim({ max, details }: {
+  max: number;
+  details: Record<string, unknown>;
+}): {
+  claim: ClaimHandle;
+  index: number;
+  path: string;
+} | null;
 /**
- * One run in a workspace's recent build history. `configuration` is the iOS configuration or the Android
- * variant the run built, `Debug` or `debug` by default, and null when the run ended before resolving it.
- * `phases` holds the milliseconds spent in each phase the run entered. An interrupted run has null
- * `durationMs` and `finishedAt`, no cache facts, and 0 for the phase it stopped in.
+ * How busy this machine is for native builds. `loadPerCore` is the 5-minute load average divided by the CPU count,
+ * rounded to one decimal. `builds` counts this Stim home's runs that hold a live native-run claim and are in
+ * prebuild, pods or compile here, not on a remote machine, plus the build slots this machine holds for other machines'
+ * offloaded builds. `maxBuilds` is `concurrency.maxBuilds`, 0 when unlimited.
  */
-interface BuildHistoryEntry extends LastBuildReport {
-  result: BuildResult;
-  slot: string;
-  configuration: string | null;
-  cacheKey: string | null;
-  phases: Partial<Record<BuildPhase, number>>;
-  /** A `stim macos` run's SwiftPM step total; absent for other runs and when the build reported none. */
-  compileSteps?: number;
-}
-/** One compiler error from a failed build: where it is, when the tool said, and its message. */
-interface BuildDiagnostic {
-  file: string | null;
-  line: number | null;
-  column: number | null;
-  message: string;
-}
-/** What kind of native input a changed fingerprint source is. */
-type BuildMissCategory = "native-dependency" | "config-plugin" | "app-config" | "app-asset" | "package" | "native-dir" | "autolinking" | "package-scripts" | "file" | "other";
-interface BuildMissChange {
-  source: string;
-  change: "added" | "removed" | "changed";
-  category: BuildMissCategory;
+interface MachineCapacity {
+  cpus: number;
+  loadPerCore: number;
+  builds: number;
+  maxBuilds: number;
+  maxLoadPerCore: number;
 }
+declare function maxLoadPerCore(): number;
+/** The 5-minute load average per CPU, rounded to one decimal, and the CPU count it divides by. */
+declare function loadPerCore(): {
+  cpus: number;
+  loadPerCore: number;
+};
+declare function loadState(load: number, busyAt: number, limit: number | null): LoadState;
+declare function machineCapacity(): MachineCapacity;
+/** Why a machine with this capacity should not take another native build; null when it can. */
+declare function saturation(capacity: MachineCapacity): string | null;
+//#endregion
+//#region state/build-machines.d.ts
 /**
- * Why a run compiled instead of installing a cached app. `changes` holds at most 20 entries,
- * ordered by importance; `changeCount` is the full number of changed fingerprint sources.
- * Only a plan reports `prebuild-pending`: the run would prebuild before compiling, so the changes
- * compare the fingerprint before that prebuild.
+ * What this machine keeps about a remote machine it asked for access. `machine` is the `remote.machines` entry,
+ * `transport` how it is reached, and `address` the tailnet name or local network host it resolved to. Once approved, `serverKey` is the worker's pinned stim-server key: every later
+ * connection must prove it holds that key. While pending, `ticket` is the setup ticket this machine generated or was
+ * given, and `expiresAt` its expiry when known. Records of protocol 1, which pinned a tailnet node, are not read.
  */
-interface BuildMissReason {
-  kind: "changed" | "no-baseline" | "same-sources" | "cache-skipped" | "fingerprint-error" | "prebuild-pending";
-  summary: string;
-  changes: BuildMissChange[];
-  changeCount: number;
-  /** `cacheKey` is kept in workspace state so a later miss can find this baseline; status omits it. */
-  baseline: {
-    fingerprint: string;
-    cacheKey?: string;
-    from: "workspace" | "project";
-  } | null;
-  rekeyedBy: string[];
+interface MachineCredential {
+  machine: string;
+  transport: "tailscale" | "local";
+  address: string;
+  state: "pending" | "approved";
+  requestedAt: string;
+  serverKey?: string;
+  deviceId?: string;
+  ticket?: string;
+  expiresAt?: string;
 }
-/** The payload `stim ios --plan --json` and `stim android --plan --json` print. */
-interface BuildPlanPayload {
-  platform: StatsPlatform;
-  slot?: string;
-  fingerprint: string;
-  cacheKey: string | null;
-  cacheHit: BuildCacheHit;
-  provider: string | null;
-  cacheSkipped: boolean;
-  prebuild: "none" | "generate" | "regenerate" | "refuse" | null;
-  outcome: RunOutcomeKind | null;
-  expectedMs: number | null;
-  basis: number;
-  /** On a predicted miss with cache reads on, why the cache has no app; `baseline` omits `cacheKey`. */
-  missReason?: BuildMissReason;
-  refusal?: {
-    code: string;
-    message: string;
-    remedy: string;
+type BuildMachineCredential = MachineCredential;
+declare const MACHINE_CREDENTIALS_VERSION = 2;
+/** A stored credential, or null when it is malformed or from an older version. */
+declare function parseMachineCredential(value: unknown): MachineCredential | null;
+declare function readBuildMachines(): BuildMachineCredential[];
+//#endregion
+//#region state/client-identity.d.ts
+/** This machine's long-term X25519 key as a client of other machines, in `$STIM_HOME/client-identity.key`. */
+declare function clientIdentity(): NoiseKeyPair;
+//#endregion
+//#region state/config-types.d.ts
+type SettingsObject = Record<string, unknown>;
+interface SupervisorRecord {
+  processToken?: string;
+  pid?: number;
+  port?: number;
+  startedAt?: string;
+  serverPid?: number;
+  mode?: string;
+  [key: string]: unknown;
+}
+interface IosDeviceRecord {
+  deviceUdid?: string;
+  deviceName?: string | null;
+  owned?: boolean;
+  serial?: string;
+  simslimManaged?: boolean;
+  simslimApplied?: {
+    profile: string;
+    springBoardPid: number;
   };
-  /** With ios.remote or android.remote set to auto or a Mac, where the plan assumes the device runs, such as `this machine; auto may use janics-mac-mini`. */
-  placement?: string;
+  schemeApprovals?: string[];
+  [key: string]: unknown;
+}
+interface AndroidDeviceRecord {
+  avdName?: string;
+  consolePort?: number;
+  serial?: string;
+  kind?: string;
+  deviceName?: string | null;
+  owned?: boolean;
+  setupIncomplete?: boolean;
+  bootPending?: boolean;
+  [key: string]: unknown;
+}
+type DeviceRecord = IosDeviceRecord | AndroidDeviceRecord;
+interface PlatformRecords {
+  ios?: IosDeviceRecord;
+  android?: AndroidDeviceRecord;
+  [platform: string]: DeviceRecord | undefined;
+}
+interface ProjectRecord {
+  ports?: Record<string, number>;
+  metroPort?: number | null;
+  platforms?: PlatformRecords;
+  deviceSlots?: Record<string, PlatformRecords>;
+  supervisor?: SupervisorRecord;
+  settings?: SettingsObject;
+  worktreeRoot?: boolean;
+  worktreeBranch?: string;
+  worktreeBranchOwned?: boolean;
+  worktreeMainRoot?: string;
+  worktreeRemovalComplete?: boolean;
+  worktreePendingBranchSha?: string;
+  label?: string;
+  bundleId?: string;
+  androidPackage?: string;
+  isExpo?: boolean;
+  lastBuild?: Record<string, unknown>;
+  doctorRuns?: Partial<Record<"ios" | "android", DoctorRunRecord>>;
+  [key: string]: unknown;
 }
-/** The read-only `stim macos --plan --json` payload; SwiftPM work and worker availability remain unknown. */
-interface MacosBuildPlanPayload {
-  platform: "macos";
-  product: string;
-  buildMachine: string;
-  fingerprint: string | null;
-  cacheKey: string | null;
-  cacheHit: boolean;
-  provider: null;
-  cacheSkipped: boolean;
-  prebuild: null;
-  outcome: null;
-  expectedMs: null;
-  basis: number;
+interface DoctorRunRecord {
+  at: string;
+  version: string;
 }
-type ActivityState = "driven" | "active" | "idle" | "unknown";
-interface ActivityDriver {
-  tool: string;
-  pid: number | null;
-  since: string | null;
+interface RepoRecord {
+  settings?: SettingsObject;
+  [key: string]: unknown;
 }
-/** The kinds of evidence that date a device's last activity, in the order `recent` lists them. */
-declare const ACTIVITY_RECENCY_BASES: readonly ["agent-action", "device-log", "metro-bundle", "workspace-use", "supervisor-start", "page-log", "viewer"];
-type ActivityRecencyBasis = (typeof ACTIVITY_RECENCY_BASES)[number];
-interface DeviceActivity {
-  state: ActivityState;
-  driver?: ActivityDriver;
-  lastActivityAt?: string;
-  /** The newest time of each kind of evidence behind `lastActivityAt`, so a reader can leave out app log chatter. */
-  recent?: Partial<Record<ActivityRecencyBasis, string>>;
-  basis: string[];
+interface ConcurrencyLimits {
+  maxBuilds: number;
+  maxDevices: number;
 }
-/** Every state a device's app process can report. */
-declare const APP_PROCESS_STATES: readonly ["running", "stopped", "unknown"];
-/**
- * Whether the workspace's app process is alive on a device now. This is current process state, not launch evidence:
- * `launched` in an `ios` or `android` result stays the record of one launch. `id` is the bundle identifier or
- * package that was checked; `state` is "unknown" when the process listing could not be read.
- */
-interface DeviceAppProcess {
-  id: string;
-  state: (typeof APP_PROCESS_STATES)[number];
+interface StimConfig {
+  version?: number;
+  homeId?: string;
+  projects: Record<string, ProjectRecord>;
+  repos: Record<string, RepoRecord>;
+  tempDir?: unknown;
+  iosSimulatorApp?: unknown;
+  androidEmulatorApp?: unknown;
+  optimizations?: unknown;
+  concurrency?: {
+    maxBuilds?: unknown;
+    maxDevices?: unknown;
+  };
+  pool?: {
+    iosParkedMax?: unknown;
+    androidParkedMax?: unknown;
+  };
+  parked?: {
+    ios?: unknown;
+    android?: unknown;
+  };
+  caches?: {
+    buildCache?: unknown;
+    metroCache?: unknown;
+  };
+  hosting?: {
+    agentDriver?: unknown;
+  };
+  debug?: {
+    logs?: unknown;
+  };
+  server?: {
+    buildsPaused?: unknown;
+    devicesPaused?: unknown;
+    acceptClientBuilds?: unknown;
+    lanAddresses?: unknown;
+    maxLoadPerCore?: unknown;
+    workerRoot?: unknown;
+    gradleDaemonIdleMinutes?: unknown;
+  };
+  remote?: {
+    machines?: unknown;
+    easMaxDurationMinutes?: unknown;
+    build?: unknown;
+    buildPoolDisabled?: unknown;
+    devicePoolDisabled?: unknown;
+  };
+  [key: string]: unknown;
 }
+type Config = StimConfig;
+//#endregion
+//#region state/automatic-pools.d.ts
+type AutomaticPoolRole = "build" | "device";
+declare function automaticMachineEnabled(role: AutomaticPoolRole, machine: string, config?: StimConfig | null): boolean;
+declare function requireAutomaticMachine(role: AutomaticPoolRole, machine: string): void;
 /**
- * A linked worktree's `git status`. `changed` counts tracked paths with staged or unstaged changes, including
- * conflicts; `untracked` counts untracked entries as `git status` lists them, so an untracked directory counts once.
- * `ahead` and `behind` compare HEAD with `upstream`, and are null when there is no upstream or it no longer exists.
- * `mergedInto` names the default branch (`origin/main`) when `gc` would consider the branch merged into it, judged
- * from local refs without fetching.
+ * Refuses a pool with no enabled member: local, or a configured remote approved for the role. `canHost` excludes
+ * device-pool remotes that can never host, such as a Linux machine.
  */
-interface WorktreeGit {
-  changed: number;
-  untracked: number;
-  upstream: string | null;
-  ahead: number | null;
-  behind: number | null;
-  mergedInto: string | null;
-}
+declare function validateAutomaticPool(role: AutomaticPoolRole, config: StimConfig, canHost?: (machine: string) => boolean): void;
+//#endregion
+//#region state/config.d.ts
+declare function withConfigLock<T>(fn: () => T): T;
+/** Waits for the config lock without blocking the event loop. The signal cancels acquisition; `fn` runs synchronously. */
+declare function withConfigLockAsync<T>(fn: () => T, signal?: AbortSignal): Promise<T>;
+declare function configCorruptRepair(path?: string): string;
+/** The build worker root: `server.workerRoot` when it is absolute, else `$STIM_HOME/build-worker`. */
+declare function buildWorkerRoot(config?: Config | null): string;
 /**
- * The GitHub pull request of a worktree's branch and HEAD, as `status --watch` last looked it up through `gh`.
- * `state` is `draft` for an open draft. `checks` counts the head commit's check runs and commit statuses, null when it
- * has none. `checkedAt` is when Stim last asked GitHub.
+ * A short directory at the drive root that stands in for the build worker directory `path` on Windows. The NDK's
+ * ninja is not long-path aware (STIM_PATH_TOO_LONG), and it opens paths under the checkout and under the Gradle user
+ * home's transforms cache, both of which are too long under the worker root. A subst drive does not help: Node's
+ * native realpath, which expo-modules-autolinking uses, resolves it back to the long path.
  */
-interface WorktreePullRequest {
-  number: number;
-  url: string;
-  title: string;
-  state: "open" | "draft" | "merged" | "closed";
-  checks: {
-    passing: number;
-    failing: number;
-    pending: number;
-  } | null;
-  reviewDecision: "approved" | "changes-requested" | "review-required" | null;
-  checkedAt: string;
+declare function windowsShortDir(path: string, systemDrive?: string): string;
+/** The ASCII key a Windows build worker records beside a `windowsShortDir` to tell which `kind` and `path` it serves. */
+declare function windowsShortDirKey(kind: "checkout" | "gradle", path: string): string;
+declare function loadConfig(): Config | null;
+declare function getProject(projectPath: string): ProjectRecord | null;
+declare function getConcurrencyLimits({ env }?: {
+  env?: NodeJS.ProcessEnv;
+}): ConcurrencyLimits;
+interface ParkedMax {
+  max: number;
+  error: string | null;
 }
-interface WorktreeFacts {
-  path: string;
-  branch?: string;
-  repository?: string;
-  /** Null when git could not be read in time, the worktree is in a folder status does not open, or one-shot status skipped an idle environment or an unprovisioned worktree. */
-  git?: WorktreeGit | null;
-  /** Null when GitHub has no pull request for the branch; absent when unknown, such as without `gh`. */
-  pullRequest?: WorktreePullRequest | null;
-  /** Present with `git`: what the worktree's git chip shows, from `gitChip`. */
-  gitChip?: GitChip;
+declare function getParkedMax(platform: "ios" | "android", { config, env }?: {
+  config?: Config | null;
+  env?: NodeJS.ProcessEnv;
+}): ParkedMax;
+declare function getProjectSettings(projectPath: string): Record<string, unknown>;
+declare function getRepoSettings(gitCommonDir: string): Record<string, unknown>;
+declare function isPathPrefix(prefix: string, path: string): boolean;
+declare function findEnclosingWorktreeRoot(projectPath: string): string | null;
+declare function allMetroPorts(): number[];
+//#endregion
+//#region state/debug-log.d.ts
+declare const DEBUG_ENV = "STIM_DEBUG";
+declare function debugLogDir(): string;
+/** The `STIM_DEBUG` override (1/true on, 0/false off, anything else off), else the machine setting `debug.logs`. Never throws. */
+declare function debugLoggingEnabled(env?: NodeJS.ProcessEnv): boolean;
+interface DebugLog {
+  /** Whether debug logging is on right now; re-read every few seconds so a long-running process follows the setting. */
+  enabled(): boolean;
+  /** Appends one record to `$STIM_HOME/logs/debug/<component>.ndjson` when enabled. Never throws; keys that look like secrets are redacted. */
+  log(event: string, fields?: Record<string, unknown>): void;
 }
-/** Every coding-agent tool whose sessions status can attribute to an environment. */
-declare const AGENT_TOOLS: readonly ["claude-code", "codex"];
-type AgentTool = (typeof AGENT_TOOLS)[number];
 /**
- * A coding-agent session working in an environment: one whose working directory `cwd` is the environment's path,
- * inside it, or its git worktree root, or one that ran a Stim command in it. `title` is the short name the tool keeps
- * for the session, never its conversation. `lastActiveAt` is the tool's own last update, or the Stim command's time
- * when that is newer. `openUrl` opens the session in the tool's desktop app when that app is installed on this machine.
- * `webUrl` opens a Claude Code session with Remote Control connected on claude.ai/code or in the Claude mobile app.
+ * Debug-level records for one component (`cli` or `server`). Off by default; `STIM_DEBUG=1` or `debug.logs` turns it
+ * on. Callers pass names, durations and codes, never arguments, environment values, tokens or tickets.
  */
-interface AgentSession {
-  tool: AgentTool;
-  sessionId: string;
-  title?: string;
-  cwd: string;
-  startedAt?: string;
-  lastActiveAt?: string;
-  pid?: number;
-  openUrl?: string;
-  webUrl?: string;
+declare function createDebugLog(component: "cli" | "server", { env, now, base }?: {
+  env?: NodeJS.ProcessEnv;
+  now?: () => number;
+  base?: () => Record<string, unknown>;
+}): DebugLog;
+//#endregion
+//#region state/trace.d.ts
+declare const TRACE_ENV = "STIM_TRACE";
+/**
+ * `args` with the value of any flag or assignment that looks like a secret, credentials in URLs, token shapes and
+ * the `exact` values replaced. `program` selects the flags that carry a credential without a secret-looking name,
+ * such as `curl -u`.
+ */
+declare function redactArgv(args: readonly string[], exact?: readonly string[], program?: string): string[];
+/** A shell command line with the same redactions as `redactArgv`, clipped to a fixed length. */
+declare function redactCommandLine(command: string, exact?: readonly string[]): string;
+type TraceArgs = Record<string, unknown>;
+type EndSpan = (args?: TraceArgs) => void;
+type Args = TraceArgs;
+interface TracePhases {
+  /** Ends the phase in progress and starts `name`; entering the phase already in progress does nothing. */
+  enter(name: string, args?: Args): void;
+  end(args?: Args): void;
+}
+interface Trace {
+  enabled(): boolean;
+  /** Starts a span; the returned function ends it, with optional extra args. */
+  begin(name: string, args?: TraceArgs): EndSpan;
+  /** `begin` for the outermost span of a process: it ends at exit with the exit code. */
+  command(name: string, args?: TraceArgs): void;
+  /** `begin` for a child process: same event with the `exec` category. */
+  beginExec(name: string, args?: TraceArgs): EndSpan;
+  /** Runs `fn` inside a span and ends it when `fn` returns or throws. */
+  span<T>(name: string, fn: () => T, args?: TraceArgs): T;
+  /** `span` for an async `fn`: ends when its promise settles. */
+  spanAsync<T>(name: string, fn: () => Promise<T>, args?: TraceArgs): Promise<T>;
+  mark(name: string, args?: TraceArgs): void;
+  /** A strip of consecutive, non-overlapping phases on its own track. */
+  phases(track: string): TracePhases;
 }
 /**
- * An agent session that stopped running in an environment, with the details Stim last found while it ran. `endedAt`
- * is the last time a status watcher found it running.
+ * Timing spans for one stim process tree, written as Chrome trace events (open the file in Perfetto or
+ * chrome://tracing) when `STIM_TRACE=<path>` is set. Unset, every call is one environment check. A stim command
+ * (`trace.command`) truncates the file and writes `[`; every other process that inherits the variable appends one
+ * event per line, creating the file if it is missing, so the file has no closing bracket. Child process arguments are written through `redactArgv`.
  */
-interface EndedAgentSession extends Omit<AgentSession, "pid"> {
-  endedAt: string;
-}
-interface AndroidRuntimeFacts {
-  serial: string | null;
-  state: "detected" | "not-detected" | "missing" | "unknown";
-  error?: string;
-}
-/** Every connection state a physical device can report. */
-declare const PHYSICAL_DEVICE_CONNECTIONS: readonly ["connected", "disconnected", "unknown"];
-type PhysicalDeviceConnection = (typeof PHYSICAL_DEVICE_CONNECTIONS)[number];
+declare const trace: Trace;
+//#endregion
+//#region state/home-identity.d.ts
+/** The persistent, nonsecret identity of this Stim home; null until the CLI initializes it. */
+declare function readHomeIdentity(config?: Config | null): string | null;
+//#endregion
+//#region state/json-file.d.ts
 /**
- * A physical iPhone, iPad or Android phone the workspace holds an unexpired lease on, from `ios --device`,
- * `android --device` or `device lock`. Stim uses it and never owns it, so `owned` is always false. `id` is the
- * UDID or adb serial. `name` is the device's own name, falling back to the name the lease recorded; `model` is the
- * marketing name devicectl reports, null when it could not be read, or the Android model the lease recorded.
- * `connection` is `connected` when devicectl can reach the phone or adb lists it as `device`, `disconnected` when
- * the tool answered without it, and `unknown` when the tool could not be read in time. `lease.holder` is the
- * workspace path that holds it.
+ * Runs `fn` with each state file read from disk at most once: inside it, including after an `await`, `readStateFile`
+ * returns the text of the first read of that path, and a path found missing stays missing. Callers still parse every time, so no two
+ * share a mutable object. Only for computations that write none of the files they read.
  */
-interface PhysicalDeviceState {
-  platform: StatsPlatform;
-  slot: string;
-  id: string;
-  name: string | null;
-  model: string | null;
-  owned: false;
-  physical: true;
-  connection: PhysicalDeviceConnection;
-  lease: {
-    holder: string;
-    kind: "declared" | "run";
-    grantedAt: string | null;
-    expiresAt: string;
-  };
+declare function withStateReadCache<T>(fn: () => T): T;
+declare function readStateFile(path: string): string;
+declare function readJsonFile(path: string): unknown;
+declare function isJsonObject(value: unknown): value is Record<string, unknown>;
+declare function readJsonObject(path: string): Record<string, unknown> | null;
+//#endregion
+//#region state/ledgers.d.ts
+type CreatedDevicePlatform = "ios" | "android" | "web";
+/** `web` lists the absolute paths of browser profile directories Stim created. */
+interface CreatedDevices {
+  ios: ReadonlySet<string>;
+  android: ReadonlySet<string>;
+  web: ReadonlySet<string>;
 }
-interface RemoteDeviceState {
-  platform: "ios" | "android" | null;
-  backend: "eas";
+declare function readCreatedDevices(): CreatedDevices;
+interface EasSessionClaim {
   sessionId: string;
-  state: "claimed" | "unclaimed" | "unknown";
-  startedAt: string | null;
-  webPreviewUrl: string | null;
+  name: string;
+  platform: "ios" | "android";
+  workspaceRoot: string;
+  workspaceHome: string;
+  stateFile: string;
 }
-/**
- * One part of a worktree's git chip, in display order: commits ahead of and behind the upstream, uncommitted files
- * (changed plus untracked), the base branch the branch is merged into (left out when its pull request is merged,
- * whose own mark says so), and a branch with no upstream that is not merged.
- */
-type GitChipPart = {
-  kind: "arrows";
-  ahead: number;
-  behind: number;
-} | {
-  kind: "changed";
-  count: number;
-} | {
-  kind: "merged";
-  into: string;
-} | {
-  kind: "no-upstream";
-};
-/** A pull request's checks at a glance: any failing, else any pending, else any passing; null without checks. */
-type ChecksState = "passing" | "failing" | "pending" | null;
-interface GitChip {
-  parts: GitChipPart[];
-  ci: ChecksState;
+interface EasSessionLedgerRead {
+  claims: Map<string, EasSessionClaim>;
+  notice: string | null;
+  safe: boolean;
 }
+/** Returns the claim normalized to canonical paths, or null when it is not a valid claim for `id`. */
+declare function validEasSessionClaim(id: string, value: unknown): EasSessionClaim | null;
+declare function readEasSessionLedger(root?: string): EasSessionLedgerRead;
+//#endregion
+//#region state/error-entries.d.ts
 /**
- * Whether a running owned simulator or emulator lacks the workspace's app: `none` when its platform never built
- * successfully here and the latest build failed, `closed` when status saw no app process, else null.
- */
-type AppPresence = "none" | "closed" | null;
-declare const WORKSPACE_STAGE_KINDS: readonly ["building", "warming", "ready", "build-failed", "running", "stopped"];
-/**
- * Where a workspace is, first match wins: `building` while a build runs, `warming` and `ready` from `phase` when
- * nothing is live, `build-failed` when the newest run of either platform failed, `running` when it is live, its
- * macOS app is running or orphaned, or it holds a remote device, else `stopped`. `since` is when that began: the
- * build's start, the warm phase's time, the failed run's end (else start), the supervisor's start (else the running
- * macOS app's build end, else its start), or Metro's last stop. `platform` names the build for `building`
- * and `build-failed`. `closedApps` lists, for `running`, the devices whose `appPresence` is `closed`.
+ * The number of rows a log list shows for `records`, an error query's result in log order. Stim Desktop's
+ * `LogEntryList` and the phone's `groupRecords` group the same way and replay the same vectors: in Expo's dev
+ * server one failed bundle is a `Bundling failed` marker line, the error line and a failed bundle response,
+ * which the apps list as one row, and every other record is its own row.
  */
-interface WorkspaceStage {
-  kind: (typeof WORKSPACE_STAGE_KINDS)[number];
-  since: string | null;
-  platform: StatsPlatform | "macos" | null;
-  closedApps: {
-    platform: StatsPlatform;
-    slot: string;
-  }[];
+declare function countErrorEntries(records: readonly NdjsonRecord[]): number;
+//#endregion
+//#region state/fingerprint-memo.d.ts
+declare const FINGERPRINT_MEMO_SCHEMA = 1;
+/** Full native fingerprints shared by every workspace of this Stim home, one file per platform and static digest. */
+declare function fingerprintMemoDir(platform?: string): string;
+declare function fingerprintMemoFile(platform: string, digest: string): string;
+declare function fingerprintMemoLock(): string;
+/** The full fingerprint a tree with this static digest produced, written by the CLI. */
+interface FingerprintMemoRecord {
+  schema: typeof FINGERPRINT_MEMO_SCHEMA;
+  platform: string;
+  digest: string;
+  recordedAt: number;
+  hash: string;
+  sources: unknown[];
+  /** The packages the static check counted as native, to name the ones a disagreeing check found it missed. */
+  nativePackages: string[];
 }
-/** Every code a status issue can carry. */
-declare const STATUS_ISSUE_CODES: readonly ["port-not-ours", "sim-missing", "sim-without-metro", "avd-serial-changed", "avd-missing", "avd-not-detected", "avd-unchecked", "android-reverse-missing", "supervisor-unverified", "browser-unverified", "browser-orphaned"];
-type StatusIssueCode = (typeof STATUS_ISSUE_CODES)[number];
-/**
- * One thing in a workspace that needs the user, or with severity `info` a note that needs nothing. `remedy` is a
- * command to run from `workspace`; `slot` is absent for the default device slot. `warnings` carries the `error` and
- * `warning` issues as text.
- *
- * Severity:
- * - `error`: Stim cannot verify or safely act on something; a person resolves it, following the teardown guide.
- * - `warning`: something is broken now and needs someone to act, such as an app that cannot reach Metro, a held
- *   port or a device that vanished while expected.
- * - `info`: a fact the next normal Stim command handles by itself, so it needs no action.
- *
- * The phone app and Stim Desktop show `error` and `warning` and hide `info`; plain `stim status` prints `info` as a
- * dim note with no remedy.
- */
-interface StatusIssue {
-  code: StatusIssueCode;
-  severity: "error" | "warning" | "info";
-  message: string;
-  remedy: string;
-  workspace: string;
-  slot?: string;
+declare function readFingerprintMemo(platform: string, digest: string): FingerprintMemoRecord | null;
+//#endregion
+//#region state/logs-query.d.ts
+interface SinceResult {
+  ms?: number;
+  error?: string;
 }
-/** Every state the owned page's latest load can report. */
-declare const WEB_PAGE_STATES: readonly ["loading", "loaded", "failed"];
-/**
- * The owned page's latest load, from the page-load marker in the workspace's web log: `url` is the document it
- * loaded, `state` is `failed` when that document did not load or the page crashed, with the log message as
- * `error`. `route`, present only when an in-app route change (history API or fragment) moved the page off `url`
- * since the load, is the URL it shows now.
- */
-interface WebPageState {
-  url: string;
-  state: (typeof WEB_PAGE_STATES)[number];
+interface GrepResult {
+  re?: RegExp;
   error?: string;
-  route?: string;
 }
-/**
- * The workspace's Stim-owned Chrome. `pid` is Chrome's process and `supervisorPid` the Stim process that holds
- * its DevTools session. `cdpEndpoint` is the loopback DevTools HTTP endpoint agents can attach to, and `targetId`
- * the DevTools target of the owned page; both are null when the browser is not running. `profile` is the
- * Stim-owned user data directory. `page` is null before the page's first load. `activity` names DevTools clients
- * other than Stim's as drivers.
- */
-interface WebBrowserState {
-  browser: "chrome";
-  version: string | null;
-  running: boolean;
-  pid: number | null;
-  supervisorPid: number | null;
-  url: string;
-  headless: boolean;
-  viewport: WebViewport;
-  profile: string;
-  cdpEndpoint: string | null;
-  targetId: string | null;
-  page?: WebPageState | null;
-  activity?: DeviceActivity;
+interface MarkerWindow {
+  launchTs: number | null;
+  bundleTs: number | null;
+  pageLoadTs: number | null;
 }
-/** The steps of `stim worktree warm`: `refresh` fast-forwards and installs in the source checkout, `copy` carries ignored entries. */
-type WarmStep = "refresh" | "copy";
-/**
- * Where a workspace is in its lifecycle: `warming` while `stim worktree warm` runs in it, `ready` after a warm
- * succeeded and before any `start`, `ios`, `android`, `web` or `reload` there, for at most two hours; `live` when
- * anything it owns runs, else `idle`.
- */
-declare const WORKSPACE_PHASES: readonly ["warming", "ready", "live", "idle"];
-type WorkspacePhase = (typeof WORKSPACE_PHASES)[number];
-/** A folder's size on disk as `status --watch` last measured it. */
-interface DiskMeasure {
-  bytes: number;
-  measuredAt: string;
+interface QueryCriteria {
+  slot?: string;
+  includeAppDeviceErrors?: boolean;
+  sources?: string[];
+  minLevel?: string;
+  grep?: RegExp;
+  sinceTs?: number;
+  errorsOnly?: boolean;
+  markerTs?: number;
+  bundleMarkerTs?: number;
 }
+interface TailState {
+  offset: number;
+  partial: string;
+}
+declare function parseSince(text: unknown): SinceResult;
+declare function compileGrep(pattern: unknown): GrepResult;
+declare const ERROR_SOURCES: string[];
+declare function markerWindow(records: NdjsonRecord[]): MarkerWindow;
 /**
- * An environment's disk use as `status --watch` last measured it. `worktreeBytes` is the git worktree folder, or the
- * workspace folder outside one, node_modules included. `nodeModulesBytes` is node_modules at the worktree root and,
- * when different, at the workspace path, and is part of `worktreeBytes`. `buildBytes` is Stim's own folder for the
- * workspace: Xcode derived data, Gradle outputs and logs. A figure is null until it was measured; `measuredAt` is the
- * oldest measurement.
+ * The platform a bundle marker speaks for, lowercased: its `platform` field, or the tag @expo/cli prints before
+ * "Bundled" ("iOS", "Android", "Web", "RSC(iOS)" as ios, or an environment tag such as "DOM"). Null when unknown.
  */
-interface EnvironmentDisk {
-  worktreeBytes: number | null;
-  nodeModulesBytes: number | null;
-  buildBytes: number | null;
-  measuredAt: string;
-}
+declare function bundleMarkerPlatform(record: NdjsonRecord): string | null;
+declare function recordMatches(record: NdjsonRecord | null | undefined, criteria?: QueryCriteria): boolean;
+declare function buildCriteria({ slot, sources, minLevel, since, grep, errorsOnly, markerTs, bundleMarkerTs, now }?: {
+  slot?: string;
+  sources?: string[];
+  minLevel?: string;
+  since?: string | null;
+  grep?: string | RegExp | null;
+  errorsOnly?: boolean;
+  markerTs?: number;
+  bundleMarkerTs?: number;
+  now?: number;
+}): QueryCriteria;
+declare function logFiles(dir: string): string[];
+declare function fileSizes(dir: string): Record<string, number>;
+declare function readLogRecords(dir: string, include?: (name: string) => boolean): NdjsonRecord[];
+declare const NATIVE_CRASH_LOG_PREFIX = "native-crash-";
+/** Reads the CLI timeline with retained native crash records after other records at the same timestamp. */
+declare function readLogTimeline(dir: string, records?: NdjsonRecord[]): NdjsonRecord[];
+declare function isExpoErrorContext(record: NdjsonRecord, event: unknown): boolean;
+type ExpoContextTarget = "msg" | "field";
 /**
- * A Metro bundle request: `bundling` while one is in flight on the workspace's Metro, with its `platform`,
- * `startedAt` and, when Metro reported progress for it, `percent` (0-100). `last` is the newest finished request,
- * `durationMs` from request to response end.
+ * Adds the code frame and stack lines Expo printed after each Expo error record, either joined into
+ * `msg` or as a `context` string array.
  */
-interface MetroBundleState {
-  bundling: boolean;
-  platform?: StatsPlatform;
-  startedAt?: string;
-  percent?: number;
-  last?: {
-    platform: StatsPlatform;
-    status: "ok" | "failed";
-    durationMs: number;
-    finishedAt: string;
-  };
-}
-interface SimulatorState {
-  devicePlacement?: DevicePlacement;
-  host?: HostedIosStatus;
-  name: string | null;
-  udid: string;
-  owned: boolean;
-  state: string;
-  activity?: DeviceActivity;
-  app?: DeviceAppProcess;
-  appPresence?: AppPresence;
-  /** The simulator's data folder, for an owned simulator once measured. */
-  disk?: DiskMeasure;
-  /** Present while the device is not booted after idle shutdown or queue reclaim. */
-  idleShutdown?: DeviceIdleShutdownRecord;
-}
-interface AndroidDeviceState {
-  devicePlacement?: DevicePlacement;
-  host?: HostedAndroidStatus;
-  name: string | undefined;
-  owned: boolean;
-  physical: boolean;
-  serial?: string | null;
-  state?: AndroidRuntimeFacts["state"] | "ready" | "stopped" | "unverified";
-  deviceProfile?: string | null;
-  activity?: DeviceActivity;
-  app?: DeviceAppProcess;
-  appPresence?: AppPresence;
-  /** The AVD's folder, for an owned emulator once measured. */
-  disk?: DiskMeasure;
-  /** Present while the emulator is not running after idle shutdown or queue reclaim. */
-  idleShutdown?: DeviceIdleShutdownRecord;
+declare function attachExpoErrorContext(all: NdjsonRecord[], matched: NdjsonRecord[], into?: ExpoContextTarget): NdjsonRecord[];
+interface LogQueryOptions {
+  slot?: string;
+  sources?: string[];
+  minLevel?: string;
+  since?: string;
+  grep?: string | RegExp;
+  errorsOnly?: boolean;
+  now?: number;
 }
-/** The tutorial format version the installed Stim writes into the tutorial app. */
-declare const TUTORIAL_VERSION = 2;
-interface EnvironmentState {
-  slots?: {
-    slot: string;
-    ios: SimulatorState | null | undefined;
-    android: AndroidDeviceState | null | undefined;
-  }[];
-  path: string;
-  /** The 16-hex identity of the registered canonical project path, used by shared workspace links. */
-  workspaceId?: string;
-  /** Statically detected app platforms; always set by status, empty when none are detected. */
-  platforms?: string[];
-  /** Present when the app's app.json sets expo.extra.stimTutorial to a positive integer: that version. */
-  tutorial?: {
-    version: number;
-  };
-  /** When `stim doctor` last ran in this workspace, per platform; absent until it has run. */
-  doctorRuns?: Partial<Record<"ios" | "android", {
-    at: string;
-  }>>;
-  live: boolean;
-  phase?: WorkspacePhase;
-  /** When the warm started (`warming`) or finished (`ready`); null for `live` and `idle`. */
-  phaseSince?: string | null;
-  /** Whether stim-server may record this workspace's device screens, from `recording.enabled`. */
-  recording?: {
-    enabled: boolean;
-  };
-  /** Present when `workspace.hidden` is true: clients list the workspace under Hidden. */
-  hidden?: true;
-  /** Where the workspace is, from `workspaceStage`; `stim status --json` always sets it. */
-  stage?: WorkspaceStage;
-  /** The step a `warming` workspace's warm is in; absent in every other phase. */
-  warmStep?: WarmStep;
+interface LogQueryPlan {
+  /** Whether a record belongs to the queried slot's timeline, before any other filter. */
+  inTimeline: (record: NdjsonRecord) => boolean;
+  matches: (record: NdjsonRecord) => boolean;
+  launchTs: number | null;
+  sinceTs: number | undefined;
   /**
-   * The memory this workspace's processes use, as `memorySource` says: the sum of its `machine` owners' `memoryMb`
-   * when status read their footprints, or else a fixed estimate per booted simulator, detected emulator, running
-   * Metro and running Chrome. `capacity.committedMb` sums it.
+   * Whether no record with a timestamp at most `maxTs`, or without one when `maxTs` is Infinity, can match.
+   * `slots` lists every `slot ?? 'default'` value the records can carry; without it, a query that depends on
+   * per-slot launch markers cannot rule out any timestamp.
    */
-  memoryMb: number;
-  /** How `memoryMb` was obtained; absent from payloads written before it existed, which carry the estimate. */
-  memorySource?: Exclude<MemorySource, "rss">;
-  warnings: string[];
-  issues: StatusIssue[];
-  ios?: SimulatorState | null;
-  android?: AndroidDeviceState | null;
-  metro?: {
-    port: number;
-    running: boolean;
-    pid: number | null;
-    tunnel?: {
-      provider: Exclude<TunnelMode, "auto" | "off" | "expo">;
-      url: string;
-    };
-    idleStop?: IdleStopRecord;
-    lastStop?: MetroLastStop;
-    /** The other process that answers Metro on `port`; `cwd` is null when its directory could not be read. */
-    heldBy?: {
-      pid: number;
-      cwd: string | null;
-    };
-    /** Absent when the Metro log holds no bundle request. */
-    bundle?: MetroBundleState;
-  } | null;
-  web?: WebBrowserState | null;
-  macos?: MacosAppState | null;
-  supervisor?: {
-    pid: number | null;
-    mode: string | null;
-    startedAt: string | null;
-    healthy: boolean;
-  } | null;
-  logs?: {
-    dir: string;
-    errorsSinceMarker: number;
-  } | null;
-  /** `installed` is whether the agent-device executable is on the PATH of the process that ran status. */
-  agentDevice?: {
-    stateDir: string;
-    installed?: boolean;
-  };
-  worktree?: WorktreeFacts | null;
-  remoteDevices?: RemoteDeviceState[];
-  /** The physical devices this workspace leases, in every slot; absent when it leases none. */
-  physicalDevices?: PhysicalDeviceState[];
-  build?: BuildReport | null;
-  lastBuilds?: Partial<Record<StatsPlatform, LastBuildReport>>;
-  /** Each platform's recent runs, newest first, at most `BUILD_HISTORY_LIMIT` each. */
-  builds?: Partial<Record<BuildPlatform, BuildHistoryEntry[]>>;
-  disk?: EnvironmentDisk;
-  /** The coding-agent sessions working in the environment, most recently active first; absent when none. */
-  agents?: AgentSession[];
-  /** The agent sessions that stopped running here in the last 3 days, most recently ended first; absent when none. */
-  endedAgents?: EndedAgentSession[];
+  excludesUpTo: (maxTs: number, slots?: ReadonlySet<unknown>) => boolean;
 }
-/** `committedMb` sums the environments' `memoryMb`; `overCapacity` is that sum over 60% of `totalMemoryMb`. */
-interface StatusCapacity {
-  liveCount: number;
-  committedMb: number;
-  totalMemoryMb: number;
-  overCapacity: boolean;
+/** Decides which records a query matches from the timeline's marker records alone. */
+declare function planLogQuery(markers: readonly NdjsonRecord[], { slot, sources, minLevel, since, grep, errorsOnly, now }?: LogQueryOptions): LogQueryPlan;
+declare function queryLogs({ slot, dir, records, sources, minLevel, since, grep, tail, errorsOnly, errorContext, now }?: LogQueryOptions & {
+  dir?: string;
+  records?: NdjsonRecord[];
+  tail?: number;
+  errorContext?: boolean;
+}): NdjsonRecord[];
+/** Queries the JSON timeline, including Expo context fields on errors as `stim logs --json` does. */
+declare function queryJsonLogs(options?: Parameters<typeof queryLogs>[0]): NdjsonRecord[];
+declare function tailRead(prev: TailState | null | undefined, size: number): {
+  start: number;
+  prev: TailState;
+};
+declare function advanceTail(prev: TailState | null | undefined, chunk: string | null | undefined, size: number): {
+  state: TailState;
+  records: NdjsonRecord[];
+};
+declare function followLogs({ dir, onRecord, criteria, intervalMs, offsets, identities: seededIdentities, errorContext }: {
+  dir: string;
+  onRecord: (record: NdjsonRecord) => void;
+  criteria?: QueryCriteria;
+  /** An explicit polling interval. Omit for filesystem hints with a ten-second repair scan. */
+  intervalMs?: number;
+  offsets?: Record<string, number> | null;
+  /** `fileIdentity` of each file `offsets` was read from, so a replacement made since is recognized. */
+  identities?: Record<string, string> | null;
+  /** Holds each Expo error until its code frame and stack stop growing, then attaches them. */
+  errorContext?: ExpoContextTarget;
+}): () => void;
+declare function fileIdentity(stat: BigIntStats): string | undefined;
+declare function sortByTs(records: NdjsonRecord[]): NdjsonRecord[];
+//#endregion
+//#region state/log-reader.d.ts
+interface LogDirQuery extends LogQueryOptions {
+  tail?: number;
+  /** Records from outside the directory, such as agent-device actions; they follow its records at equal timestamps. */
+  extra?: readonly NdjsonRecord[];
 }
-interface DeviceLeaseState {
-  slot?: string;
-  path: string;
-  platform: string;
-  id: string | null;
-  deviceName: string | null;
-  holder: string | null;
-  grantedAt: string | null;
-  expiresAt: string | null;
-  mine: boolean;
-  expired: boolean;
-  parsed: boolean;
+/**
+ * An indexed view of a workspace log directory, read in timestamp order without loading whole files. Each file
+ * generation is indexed once per process (block timestamp bounds, markers, slots and launch attempts) and later
+ * views read only what was appended since. Close it to release the open files.
+ */
+interface LogDir {
+  /** Bytes read from each current `.ndjson` file, through its last complete line. */
+  readonly sizes: Record<string, number>;
+  /** `fileIdentity` of each current `.ndjson` file that `sizes` was read from. */
+  readonly identities: Record<string, string>;
+  /** The oldest timestamp in the directory. */
+  readonly firstTs: number | undefined;
+  /** Launch attempt records outside native crash files, in timeline order. */
+  launchAttempts(): NdjsonRecord[];
+  /** The records `queryJsonLogs` returns for this directory's timeline followed by `extra`. */
+  query(query?: LogDirQuery): Promise<NdjsonRecord[]>;
+  /** Every matching record in timestamp order, in batches of at most 500, with the same filters and context as query. */
+  batches(query?: Omit<LogDirQuery, "tail">): AsyncIterable<NdjsonRecord[]>;
+  /** Prepares the directory marker predicate for records without markers, such as attributed agent actions. */
+  filter(query?: LogQueryOptions): (record: NdjsonRecord) => boolean;
+  close(): Promise<void>;
 }
 /**
- * Where a memory figure comes from. `footprint` is each process's physical footprint, which Activity Monitor's Memory
- * column shows. `rss` sums resident set sizes, which count pages shared between processes once per process, so a
- * simulator reports well above its footprint; the machine owners fall back to it when the footprint helper cannot be
- * built. `estimate` is a fixed amount per running thing, which an environment reports whenever it has no footprint.
+ * Opens `dir` for reading. With `order: 'timeline'`, native crash files follow every other file at equal
+ * timestamps, as `readLogTimeline` orders them; with `'name'`, every file is ranked by name, as `readLogRecords`.
  */
-declare const MEMORY_SOURCES: readonly ["footprint", "rss", "estimate"];
-type MemorySource = (typeof MEMORY_SOURCES)[number];
-/** Every kind of process owner the status machine section reports. */
-declare const MACHINE_OWNER_KINDS: readonly ["simulator", "emulator", "metro", "build", "browser", "macos", "server", "shared"];
-type MachineOwnerKind = (typeof MACHINE_OWNER_KINDS)[number];
+declare function openLogDir(dir: string, { order, signal }?: {
+  order?: "timeline" | "name";
+  signal?: AbortSignal;
+}): Promise<LogDir>;
+//#endregion
+//#region state/ndjson-tail.d.ts
 /**
- * One thing using this machine's CPU and memory now. Each process is counted in exactly one owner: the one whose root
- * process is its nearest ancestor. `workspace` and `slot` (absent for the default slot) name the workspace a
- * simulator, emulator, Metro, build or Chrome belongs to; a device no workspace records has a null workspace, and
- * machine-wide processes are `shared`. `id` is the simulator's UDID, the emulator's AVD name, Metro's port as text,
- * the build's platform, or null. `owned` is true only for what Stim started and stops: a workspace's owned device,
- * Metro, build or Chrome. `cpuPercent` is `ps` %CPU summed over the owner's processes, where 100 is one core.
- * `residentMb` sums their resident set sizes; pages shared between processes count once per process, so a
- * simulator, whose processes all map the runtime's shared libraries, reports well above its physical footprint.
- * `memoryMb` sums their physical footprints when `MachineUsageState.memorySource` is `footprint`, taking the resident
- * size of a process the footprint helper could not read, and equals `residentMb` when it is `rss`.
+ * Returns a reader of `file` and its rotated generation that yields, on every call, the records a full
+ * `readNdjsonGenerations(file)` would, while reading only the bytes appended since the previous call. A file renamed
+ * to its rotated generation between two calls is finished from there; any other replacement or a shrunk file is
+ * read again from its start. A file rewritten in place to at least its previous length is not detected.
  */
-interface MachineOwner {
-  kind: MachineOwnerKind;
-  name: string;
-  workspace: string | null;
-  slot?: string;
-  id: string | null;
-  owned: boolean;
-  cpuPercent: number;
-  residentMb: number;
-  memoryMb: number;
-  processes: number;
-}
-/** Where this machine's CPU and memory go, from one pass over the host process table. */
-interface MachineUsageState {
-  memorySource: Exclude<MemorySource, "estimate">;
-  owners: MachineOwner[];
+declare function createNdjsonTail(file: string): () => NdjsonRecord[];
+//#endregion
+//#region state/paths.d.ts
+declare function getConfigPath(): string;
+declare function configLockPath(): string;
+declare function workspaceMetadataFile(projectRoot: string): string;
+declare function workspaceAgentDeviceDir(projectRoot: string): string;
+declare function workspaceLogsDir(projectRoot: string): string;
+/** Device screen footage stim-server records for the workspace, one directory per platform and slot. */
+declare function workspaceRecordingsDir(projectRoot: string): string;
+declare function workspaceLogErrorIndex(projectRoot: string): string;
+declare function workspaceDerivedData(projectRoot: string): string;
+declare function workspaceGradleBuild(projectRoot: string): string;
+declare function workspaceBuildDetailFile(projectRoot: string): string;
+/** The agent sessions that stopped running in the workspace in the last `ENDED_AGENT_RETENTION_MS`. */
+declare function workspaceEndedAgentsFile(projectRoot: string): string;
+declare function workspaceEndedAgentsLock(projectRoot: string): string;
+declare function supervisorPidFile(projectRoot: string): string;
+declare function workspaceStateFile(projectRoot: string): string;
+/** The dependency directories `gc --delete` deleted from the workspace's worktree, apart from state.json so writing it is not workspace activity. */
+declare function workspaceLightenedFile(projectRoot: string): string;
+declare function workspaceStateLock(projectRoot: string): string;
+declare function supervisorLogFile(projectRoot: string): string;
+declare function emulatorLogFile(projectRoot: string): string;
+declare function sharedCompilationCache(): string;
+declare function sharedCcache(): string;
+declare function sharedGradle(): string;
+declare function sharedPods(): string;
+declare function createdDevicesFile(): string;
+declare function gitMergeCacheDir(): string;
+declare function pullRequestCacheDir(): string;
+declare function agentSessionsCacheFile(): string;
+declare function diskUsageCacheDir(): string;
+/** The ownership claim root that admits one disk-usage walk at a time on this machine. */
+declare function diskUsageWalkClaims(): string;
+/** The remote machines this machine asked for build access, each with its pinned stim-server key once approved. */
+declare function buildMachinesFile(): string;
+declare function buildMachinesLock(): string;
+/** The remote machines this machine asked for access, separate from build credentials. */
+declare function deviceHostMachinesFile(): string;
+declare function deviceHostMachinesLock(): string;
+declare function deviceHostMachinesClaims(): string;
+declare function createdDevicesLock(): string;
+/** The EAS session ledger lives under the real home directory, never under STIM_HOME. */
+declare function easMachineStateRoot(): string;
+declare function easSessionLedgerFile(root?: string): string;
+declare function easSessionLedgerLock(root?: string): string;
+/** Where stim-server records, one file per server process, the devices whose frames a client subscribes to. */
+declare function deviceViewersDir(): string;
+declare function budgetSweepFile(): string;
+declare function budgetSweepLock(): string;
+declare function statsFile(): string;
+declare function maintenanceDir(): string;
+declare function maintenanceStateFile(): string;
+declare function maintenanceAttemptFile(): string;
+declare function maintenanceNdjsonFile(): string;
+declare function gcLogDir(): string;
+declare function gcLogFile(): string;
+declare function buildLedgerDir(): string;
+declare function buildLedgerFile(): string;
+declare function buildLedgerLock(): string;
+declare function maintenanceChildLogFile(): string;
+declare function maintenanceRunClaims(): string;
+/** Dependency trees `worktree remove` moved out of a worktree before git removed it; gc deletes what is left. */
+declare function trashRoot(): string;
+declare function archiveRoot(): string;
+declare function archiveDir(id: string): string;
+declare function archiveLock(): string;
+/** Uncommitted changes of removed worktrees: `<repository>/<branch-or-dir>-<timestamp>/` holding `manifest.json`. */
+declare function worktreeArchiveRoot(): string;
+/** This machine's own long-term X25519 key as a client of other machines' stim-servers. */
+declare function clientIdentityKeyFile(): string;
+/**
+ * The local Unix socket. sun_path permits 103 UTF-8 bytes on macOS and 107 on Linux. Longer paths use
+ * /tmp/stim-sockets-<uid>/<SHA-256 of the normalized absolute socket path>.sock.
+ */
+declare function serverLocalSocket(): string;
+declare function serverSetupDir(): string;
+declare function setupJournalFile(hash: string): string | null;
+//#endregion
+//#region state/placement.d.ts
+/**
+ * The placement words every workload shares (`remote.build`, `ios.remote`, `android.remote`, `macos.remote` and their
+ * flags). Anything else a setting holds is a machine name, or for devices `eas` or `proxy`.
+ *
+ * - `local`: this machine only.
+ * - `auto`: this machine first, a remote machine when this one is full or busy.
+ * - `remote`: remote machines first, in `remote.machines` order; this machine only when none takes the run.
+ * - `remote-only`: remote machines in `remote.machines` order, never this machine.
+ */
+declare const PLACEMENT_WORDS: readonly ["local", "auto", "remote", "remote-only"];
+type PlacementWord = (typeof PLACEMENT_WORDS)[number];
+type AutomaticPlacement = Exclude<PlacementWord, "local">;
+declare function placementWord(value: string): PlacementWord | null;
+declare function prefersRemote(word: PlacementWord): boolean;
+declare function mayRunHere(word: PlacementWord): boolean;
+//#endregion
+//#region state/recordings.d.ts
+/** The footage stim-server keeps per device: the last 15 minutes recorded, however long ago. */
+declare const RECORDING_FOOTAGE_MS: number;
+/** The recordings of every workspace of one Stim home together; past it the oldest footage goes first. */
+declare const RECORDING_CAP_BYTES: number;
+/** The platforms stim-server records: owned simulators and emulators, and the Stim-owned Chrome page. */
+declare const RECORDING_PLATFORMS: readonly ["ios", "android", "web"];
+type RecordingPlatform = (typeof RECORDING_PLATFORMS)[number];
+/**
+ * One file of H.264 footage. A closed segment is named `<start>-<end>.seg`, in epoch milliseconds of its first and
+ * last access unit; the segment being written is `<start>.part`, and its end is its modification time.
+ */
+interface RecordedSegment {
+  file: string;
+  start: number;
+  end: number;
+  bytes: number;
+  open: boolean;
 }
-/** The payload `stim status --json` prints, and `status --watch --json` prints on each change. */
-interface StatusPayload {
-  maintenance?: MaintenanceStatus;
-  archived?: ArchivedWorkspace[];
-  archivedUsage?: ArchivedUsage;
-  environments: (EnvironmentState & {
-    labelOnly?: true;
-  })[];
-  capacity: StatusCapacity;
-  deviceLeases: DeviceLeaseState[];
-  unprovisionedWorktrees: WorktreeFacts[];
-  simctlAvailable: boolean;
-  /** Null when nothing runs that status attributes, so it read no process table, or when the table was unreadable. */
-  machine: MachineUsageState | null;
+interface RecordedDevice {
+  platform: RecordingPlatform;
+  slot: string;
+  dir: string;
+  segments: RecordedSegment[];
 }
+/** The directory under a workspace's recordings that holds one device slot's footage. */
+declare function recordingDeviceName(platform: RecordingPlatform, slot: string): string;
+/** Segment names hold whole milliseconds: the start rounded down and the end rounded up. */
+declare function closedSegmentName(start: number, end: number): string;
+declare function openSegmentName(start: number): string;
+/** The segments in one device directory, oldest first. Files that are not segments are left out; `closedOnly` excludes files still being written. */
+declare function listSegments(dir: string, closedOnly?: boolean): RecordedSegment[];
+/** Reads current segment files asynchronously, oldest first; cancellation propagates. */
+declare function listSegmentsAsync(dir: string, closedOnly?: boolean, signal?: AbortSignal): Promise<RecordedSegment[]>;
+/** Every device slot recorded under a workspace's recordings directory. */
+declare function listRecordedDevices(recordingsDir: string, closedOnly?: boolean): RecordedDevice[];
+/** Reads current device slots and their segment files asynchronously; cancellation propagates. */
+declare function listRecordedDevicesAsync(recordingsDir: string, closedOnly?: boolean, signal?: AbortSignal): Promise<RecordedDevice[]>;
+declare function recordedBytes(devices: readonly RecordedDevice[]): number;
+/**
+ * The oldest closed segments to delete so that one device keeps at most `footageMs` of footage. Time between
+ * segments, while nothing was recorded, does not count. The open segment is never chosen.
+ */
+declare function footageDrops(segments: readonly RecordedSegment[], footageMs: number): RecordedSegment[];
+/** The oldest closed segments across all devices to delete so that together they hold at most `capBytes`. */
+declare function capDrops(devices: readonly RecordedDevice[], capBytes: number): RecordedSegment[];
+/**
+ * Whether stim-server records a workspace's devices: `STIM_RECORDING`, then `recording.enabled` in the workspace,
+ * repo and machine layers, in that order, and true by default.
+ */
+declare function recordingEnabled(env: NodeJS.ProcessEnv, layers: readonly unknown[]): boolean;
+//#endregion
+//#region state/run-id.d.ts
+declare const RUN_ID_ENV = "STIM_RUN_ID";
+/** A run id as the CLI and stim-server accept it: letters, digits, `.`, `_` and `-`, at most 64. Null otherwise. */
+declare function validRunId(value: unknown): string | null;
+/**
+ * The run id of the ambient operation context, else of this CLI invocation: `STIM_RUN_ID` when it holds a valid id
+ * (Stim Desktop passes one), else a random one. The CLI entry exports it back to `STIM_RUN_ID` so processes the run
+ * starts inherit it; this function does not.
+ */
+declare function runId(env?: NodeJS.ProcessEnv): string;
+//#endregion
+//#region state/settings-schema.d.ts
+declare const SETTINGS_SCHEMA_FILE = "settings.schema.json";
+declare const SETTINGS_SCHEMA_URL: string;
+type JsonSchema = Record<string, unknown>;
+/**
+ * The published settings schema. The root describes a committed `.stim.json`;
+ * `$defs.machine` describes the settings keys of `$STIM_HOME/config.json`.
+ * Every leaf carries `x-stim` with its dotted key, kind, writable scopes,
+ * environment override, and sensitivity.
+ */
+declare function settingsJsonSchema(): JsonSchema;
 //#endregion
 //#region state/status-derived.d.ts
 declare function withGitChip(worktree: WorktreeFacts): WorktreeFacts;
@@ -2649,25 +2715,29 @@ declare function readDeviceHostMachines(): DeviceHostMachineCredential[];
 //#endregion
 //#region state/hosted-metro.d.ts
 declare const HOSTED_METRO_REQUESTS_KEY = "hostedMetroRequests";
-declare const HOSTED_METRO_GATEWAYS_KEY = "hostedMetroGateways";
+declare const HOSTED_METRO_LINKS_KEY = "hostedMetroLinks";
 /** Private supervisor request, keyed by hosted session; never part of a public payload. */
 interface HostedMetroRequest {
   id: string;
   machine: string;
-  address: string;
-  peer: string;
-  secret: string;
 }
-interface HostedMetroGateway {
+/** The supervisor's answer to a request: `ready` while the host holds one of its links, `error` when it cannot link. */
+interface HostedMetroLinks {
   id: string;
   processToken: string;
-  port?: number;
+  ready?: true;
   error?: string;
 }
 declare function hostedMetroRequests(state: WorkspaceState | null): Record<string, HostedMetroRequest>;
-declare function hostedMetroGateways(state: WorkspaceState | null): Record<string, HostedMetroGateway>;
+declare function hostedMetroLinks(state: WorkspaceState | null): Record<string, HostedMetroLinks>;
 //#endregion
 //#region state/tailnet.d.ts
+/** stim-server's own port, which a machine on the local network connects to directly. */
+declare const DEFAULT_SERVER_PORT = 7787;
+/**
+ * A `remote.machines` entry: a tailnet name, or `local:` and a host name or IPv4 address on the local network, each
+ * optionally with `:<port>`.
+ */
 declare const TAILNET_MACHINE_PATTERN: string;
 interface TailnetPeer {
   nodeId: string;
@@ -2681,7 +2751,13 @@ interface TailnetPeer {
   /** When Tailscale last saw the node, as an ISO timestamp; absent when it never did or the status omits it. */
   lastSeen?: string;
 }
+type MachineTransport = "tailscale" | "local";
+/**
+ * A `remote.machines` entry's parts. A `tailscale` entry names a tailnet peer and the port of its `tailscale serve`
+ * route; a `local` entry names a host on the local network and stim-server's own port there.
+ */
 declare function parseMachine(entry: string): {
+  transport: MachineTransport;
   name: string;
   port: number;
 } | null;
@@ -2706,9 +2782,14 @@ interface Endpoint {
  */
 declare function endpoint(peer: TailnetPeer, port: number): Endpoint;
 /**
- * Where to reach a `remote.machines` entry now, or why Stim cannot. The tailnet only carries the bytes: the Noise
- * handshake, pinned to the worker's server key, decides whether the machine answering is the one this machine paired
- * with.
+ * A `local` entry's stim-server, reached directly with plain WebSocket: protocol 2's Noise session authenticates and
+ * encrypts it, so it needs no TLS.
+ */
+declare function localEndpoint(name: string, port: number): Endpoint;
+/**
+ * Where to reach a `remote.machines` entry now, or why Stim cannot. The tailnet or local network only carries the
+ * bytes: the Noise handshake, pinned to the worker's server key, decides whether the machine answering is the one this
+ * machine paired with. `current` is `tailscale status --json`, which a `local` entry does not need.
  */
 declare function machineEndpoint(machine: string, current: unknown): Endpoint | string;
 //#endregion
@@ -2836,8 +2917,16 @@ interface BuildLedgerRecord extends NdjsonRecord {
   outcome: BuildLedgerOutcome;
   failure?: BuildLedgerFailure;
   device?: BuildLedgerDevice;
+  /** This machine's 5-minute load per core when the run started. Absent in older records. */
+  loadPerCore?: number;
+  /** The run's first owned simulator or emulator boot: when it started, in epoch milliseconds, and the load per core then. */
+  boot?: BuildLedgerBoot;
   stimVersion: string;
 }
+interface BuildLedgerBoot {
+  startedAt: number;
+  loadPerCore: number;
+}
 declare function isBuildLedgerRecord(record: NdjsonRecord): record is BuildLedgerRecord;
 /** The ledger's records, oldest first. A missing or unreadable ledger is empty. */
 declare function readBuildLedger(file?: string): BuildLedgerRecord[];
@@ -2956,4 +3045,4 @@ declare class KeyedEntities<T> {
 /** Applies `delta` to `entities` keyed by `key`, keeping the order of `entities` and appending new keys. */
 declare function applyKeyedDelta<T>(entities: readonly T[], delta: KeyedDelta<T>, key: (entity: T) => string): T[];
 //#endregion
-export { findPeer as $, hostedMacosAppSlot as $a, queryJsonLogs as $c, readDevServerStopRequest as $i, withConfigLock as $l, MachineUsageState as $n, runId as $o, MaintenanceMode as $r, maintenanceAttemptFile as $s, pullRequestCacheFile as $t, BuildLedgerRecord as A, parseHostedAndroidDevice as Aa, worktreeArchiveRoot as Ac, BUILD_HISTORY_LIMIT as Ai, TracePhases as Al, BuildPhase as An, RemoteDeviceBackend as Ao, MacosAppRecord as Ar, buildLedgerDir as As, offloadSummary as At, machineCacheUsageFile as Au, HOSTED_LOGS_PAGE_BYTES as B, readHostedSessions as Ba, advanceTail as Bc, MAINTENANCE_LOG_NAME as Bi, allMetroPorts as Bl, DeviceLeaseState as Bn, TUNNEL_MODES as Bo, ArchivedWorkspace as Br, deviceHostMachinesFile as Bs, DeviceViewersRecord as Bt, AgentActionReaderOptions as Bu, BuildLedgerCache as C, HostedNativeOffer as Ca, workspaceLightenedFile as Cc, parseHostedAndroidPlacement as Ci, readStateFile as Cl, BuildCause as Cn, settingsJsonSchema as Co, WebBrowserState as Cr, prefersRemote as Cs, StatsCapacityWait as Ct, buildSlotsDir as Cu, BuildLedgerOutcome as D, hostedConsolePort as Da, workspaceRecordingsDir as Dc, parseHostedNativePlacement as Di, TRACE_ENV as Dl, BuildMissCategory as Dn, IOS_SIMULATOR_APPS as Do, WorktreeFacts as Dr, archiveRoot as Ds, StatsScope as Dt, tryAcquireBuildSlotClaim as Du, BuildLedgerFailure as E, deviceHostRoot as Ea, workspaceMetadataFile as Ec, hostedNativeRecords as Ei, EndSpan as El, BuildHistoryEntry as En, ANDROID_PCH_CHOICES as Eo, WorkspaceStage as Er, archiveLock as Es, StatsReport as Et, saturation as Eu, GcLogStatus as F, parseHostedOfferRequest as Fa, ERROR_SOURCES as Fc, DevServerStopRequest as Fi, DebugLog as Fl, BuildResult as Fn, SettingEntry as Fo, parseMacosRecord as Fr, clientIdentityKeyFile as Fs, statsProjectKey as Ft, AgentDeviceUsage as Fu, parseHostedLogsCursor as G, HostedAgentGrant as Ga, fileIdentity as Gc, WarmRecord as Gi, getParkedMax as Gl, EnvironmentState as Gn, coerceSettingText as Go, readArchiveAsync as Gr, easMachineStateRoot as Gs, ENDED_AGENT_RETENTION_MS as Gt, LEVELS as Gu, HostedLogsPage as H, HOSTED_MACOS_APP_SLOTS as Ha, buildCriteria as Hc, READY_PHASE_MS as Hi, configCorruptRepair as Hl, DiskMeasure as Hn, WEB_VIEWPORTS as Ho, archivedUsage as Hr, deviceViewersDir as Hs, readViewedDevices as Ht, AgentTarget as Hu, GcLogTrigger as I, parseHostedPlatformDevice as Ia, LogQueryOptions as Ic, DeviceIdleShutdownRecord as Ii, createDebugLog as Il, BuildWaitingFor as In, SettingScope as Io, readHostedMacosApp as Ir, configLockPath as Is, trimCapacityRefusals as It, AgentDeviceUsageRoots as Iu, Endpoint as J, HostedAppLaunch as Ja, isExpoErrorContext as Jc, lastNativeUseFrom as Ji, getRepoSettings as Jl, LastBuildReport as Jn, isSensitiveReference as Jo, readArchivesAsync as Jr, emulatorLogFile as Js, agentSessionOf as Jt, levelRank as Ju, readHostedNativeLogsCheckpoint as K, HostedAgentIssuedGrant as Ka, fileSizes as Kc, WorkspaceState as Ki, getProject as Kl, GitChip as Kn, expectedShape as Ko, readArchiveState as Kr, easSessionLedgerFile as Ks, PullRequestCacheEntry as Kt, NdjsonRecord as Ku, isGcLogRecord as L, parseHostedRequest as La, LogQueryPlan as Lc, IDLE_STOP_KEY as Li, debugLogDir as Ll, ChecksState as Ln, SettingType as Lo, readMacosRecord as Lr, createdDevicesFile as Ls, trimCapacityWaits as Lt, agentDeviceUsageFile as Lu, readBuildLedger as M, parseHostedDevice as Ma, LogDir as Mc, DEVICE_RECLAIM_REASON as Mi, redactCommandLine as Ml, BuildPlanPayload as Mn, SETTING_GROUPS as Mo, MacosBuild as Mr, buildLedgerLock as Ms, readRunEstimates as Mt, SwiftpmCacheUsage as Mu, GcLogOptions as N, parseHostedLocalDeviceCount as Na, LogDirQuery as Nc, DEV_SERVER_STOP_REQUEST_KEY as Ni, trace as Nl, BuildPlatform as Nn, SETTING_SCOPES as No, MacosProcess as Nr, buildMachinesFile as Ns, readStats as Nt, readSwiftpmCacheUsage as Nu, BuildLedgerPlacement as O, hostedDeviceId as Oa, workspaceStateFile as Oc, unreadableHostedNative as Oi, Trace as Ol, BuildMissChange as On, REMOTE_DEVICE_BACKENDS as Oo, WorktreeGit as Or, budgetSweepFile as Os, decodeStats as Ot, MachineCacheUsage as Ou, GcLogRecord as P, parseHostedNativeOffer as Pa, openLogDir as Pc, DevServerStopRecord as Pi, DEBUG_ENV as Pl, BuildReport as Pn, SettingDefinition as Po, macosAppState as Pr, buildMachinesLock as Ps, readStatsReport as Pt, swiftpmCacheUsageFile as Pu, endpoint as Q, hostedAgentDriverName as Qa, planLogQuery as Qc, readDevServerStop as Qi, windowsShortDirKey as Ql, MachineOwnerKind as Qn, RUN_ID_ENV as Qo, MaintenanceCheck as Qr, gitMergeCacheDir as Qs, listStatusCacheEntries as Qt, readGcLog as R, readHostedDevice as Ra, NATIVE_CRASH_LOG_PREFIX as Rc, IdleStopRecord as Ri, debugLoggingEnabled as Rl, DeviceActivity as Rn, SettingWriteResult as Ro, ArchivedBytes as Rr, createdDevicesLock as Rs, trimSamples as Rt, readAgentDeviceUsage as Ru, BUILD_LEDGER_CAP as S, HostedIosDevice as Sa, workspaceGradleBuild as Sc, hostedAndroidStatus as Si, readJsonObject as Sl, BuildCacheHit as Sn, SETTINGS_SCHEMA_URL as So, WarmStep as Sr, placementWord as Ss, StatsCapacityRefusal as St, buildSlotPath as Su, BuildLedgerDevice as T, deviceHostArea as Ta, workspaceLogsDir as Tc, HostedNativePlacement as Ti, readHomeIdentity as Tl, BuildDiagnostic as Tn, ANDROID_EMULATOR_APPS as To, WorkspacePhase as Tr, archiveDir as Ts, StatsRecord as Tt, maxLoadPerCore as Tu, hostedMacosLogsDir as U, HostedAgentAccess as Ua, bundleMarkerPlatform as Uc, WARM_KEY as Ui, findEnclosingWorktreeRoot as Ul, EndedAgentSession as Un, WebViewport as Uo, linkReplacedArchives as Ur, diskUsageCacheDir as Us, stimBuildDigest as Ut, createAgentActionReader as Uu, HostedLogsCursor as V, HOSTED_AGENT_DRIVERS as Va, attachExpoErrorContext as Vc, MetroLastStop as Vi, buildWorkerRoot as Vl, DevicePlacement as Vn, TunnelMode as Vo, archiveEnabled as Vr, deviceHostMachinesLock as Vs, ViewedDevice as Vt, AgentRecordSelection as Vu, hostedNativeLogsDir as W, HostedAgentDriverName as Wa, compileGrep as Wc, WORKSPACE_AGENT_KEY as Wi, getConcurrencyLimits as Wl, EnvironmentDisk as Wn, acceptsShape as Wo, readArchive as Wr, diskUsageWalkClaims as Ws, AgentSessionsCache as Wt, createAsyncAgentActionReader as Wu, TailnetPeer as X, HostedMacosDevice as Xa, markerWindow as Xc, parseMissReason as Xi, loadConfig as Xl, MEMORY_SOURCES as Xn, settingDefinition as Xo, MaintenanceAction as Xr, gcLogFile as Xs, diskUsageFailureFile as Xt, parseNdjsonText as Xu, TAILNET_MACHINE_PATTERN as Y, HostedMacosChoice as Ya, logFiles as Yc, lastUseFrom as Yi, isPathPrefix as Yl, MACHINE_OWNER_KINDS as Yn, replacementAdvice as Yo, DiskPressureLevel as Yr, gcLogDir as Ys, diskUsageCacheFile as Yt, parseNdjsonLine as Yu, cannotHost as Z, HostedMacosPlacement as Za, parseSince as Zc, readBuildHistory as Zi, windowsShortDir as Zl, MachineOwner as Zn, settingValueError as Zo, MaintenanceActionKind as Zr, getConfigPath as Zs, endedAgentSessionOf as Zt, readNdjsonGenerations as Zu, isSetupJournalPrunable as _, HostedDevicePlatform as _a, workspaceAgentDeviceDir as _c, HostedAndroidPlacement as _i, readCreatedDevices as _l, AndroidRuntimeFacts as _n, readHostedAppMetadata as _o, StatusPayload as _r, recordingEnabled as _s, RunEstimates as _t, MACHINE_CREDENTIALS_VERSION as _u, MachineView as a, readWorkspaceAgent as aa, pullRequestCacheDir as ac, MaintenanceStatus as ai, tailRead as al, readPullRequestCache as an, parseHostedMacosPlacement as ao, PHYSICAL_DEVICE_CONNECTIONS as ar, RecordedSegment as as, HostedMetroRequest as at, ConcurrencyLimits as au, agentDeviceStateDirs as b, HostedDeviceSession as ba, workspaceEndedAgentsFile as bc, hostedAndroidPlacements as bi, isJsonObject as bl, BUILD_RESULTS as bn, validHostedAppBlob as bo, WORKSPACE_PHASES as br, PlacementWord as bs, STATS_VERSION as bt, readBuildMachines as bu, SummaryBuild as c, DEVICE_HOST_LIMITS as ca, setupJournalFile as cc, readMaintenanceAttempt as ci, fingerprintMemoDir as cl, ACTIVITY_RECENCY_BASES as cn, HostedAppFile as co, PlannedPhase as cr, closedSegmentName as cs, DeviceHostMachineCredential as ct, DoctorRunRecord as cu, WorktreeRow as d, HostedAndroidChoice as da, sharedGradle as dc, HostedIosStatus as di, readFingerprintMemo as dl, ActiveBuildState as dn, hostedAppArea as do, STATUS_ISSUE_CODES as dr, listRecordedDevicesAsync as ds, CAPACITY_REFUSAL_LIMIT as dt, RepoRecord as du, readDeviceIdleShutdowns as ea, maintenanceChildLogFile as ec, MaintenancePass as ei, queryLogs as el, readAgentSessionsCache as en, hostedMacosBundleId as eo, MacosBuildPlanPayload as er, validRunId as es, machineEndpoint as et, withConfigLockAsync as eu, statusViews as f, HostedAndroidDevice as fa, sharedPods as fc, hostedIosPlacements as fi, countErrorEntries as fl, ActivityDriver as fn, hostedAppAttempt as fo, SimulatorState as fr, listSegments as fs, CAPACITY_REFUSAL_MAX_AGE_MS as ft, SettingsObject as fu, isJournalExpired as g, HostedDevicePhase as ga, trashRoot as gc, unreadableHostedIos as gi, EasSessionLedgerRead as gl, AndroidDeviceState as gn, readHostedApp as go, StatusIssueCode as gr, recordingDeviceName as gs, ReadStatsResult as gt, BuildMachineCredential as gu, SetupJournal as h, HostedDeviceOfferRequest as ha, supervisorPidFile as hc, parseHostedIosPlacement as hi, EasSessionClaim as hl, AgentTool as hn, parseHostedAppOffer as ho, StatusIssue as hr, recordedBytes as hs, PLACEMENT_DECISIONS as ht, clientIdentity as hu, ArchivedSummary as i, readWarmRecord as ia, maintenanceStateFile as ic, MaintenanceState as ii, sortByTs as il, readEndedAgentSessions as in, parseHostedMacosDevice as io, NativeBuildStep as ir, RecordedDevice as is, HostedMetroGateway as it, validateAutomaticPool as iu, isBuildLedgerRecord as j, parseHostedChoice as ja, createNdjsonTail as jc, DEVICE_IDLE_SHUTDOWN_KEY as ji, redactArgv as jl, BuildPlacement as jn, SETTINGS as jo, MacosAppState as jr, buildLedgerFile as js, projectRootDirectories as jt, readMachineCacheUsage as ju, BuildLedgerPlatform as k, hostedWorkerSettleMs as ka, workspaceStateLock as kc, BUILD_HISTORY_KEY as ki, TraceArgs as kl, BuildMissReason as kn, REPLACED_SETTINGS as ko, WorktreePullRequest as kr, budgetSweepLock as ks, findProjectRoot as kt, SimRuntimeUsage as ku, SummaryHistoryEntry as l, DeviceHostLimits as la, sharedCcache as lc, readMaintenanceState as li, fingerprintMemoFile as ll, AGENT_TOOLS as ln, HostedAppOffer as lo, RemoteDeviceState as lr, footageDrops as ls, readDeviceHostMachines as lt, PlatformRecords as lu, SetupCapability as m, HostedDeviceOffer as ma, supervisorLogFile as mc, hostedIosStatus as mi, CreatedDevices as ml, AgentSession as mn, parseHostedAppManifest as mo, StatusCapacity as mr, openSegmentName as ms, OffloadSummary as mt, SupervisorRecord as mu, KeyedEntities as n, readIdleStop as na, maintenanceNdjsonFile as nc, MaintenanceRecord as ni, readLogTimeline as nl, readDiskUsage as nn, parseHostedAgentGrant as no, MetroBundleState as nr, RECORDING_FOOTAGE_MS as ns, HOSTED_METRO_GATEWAYS_KEY as nt, automaticMachineEnabled as nu, SUMMARY_ARCHIVES as o, readWorkspaceState as oa, serverLocalSocket as oc, MemoryCulprit as oi, FINGERPRINT_MEMO_SCHEMA as ol, withDerivedFacts as on, HOSTED_APP_CHUNK_BYTES as oo, PhysicalDeviceConnection as or, RecordingPlatform as os, hostedMetroGateways as ot, Config as ou, workspaceSummary as p, HostedDevice as pa, statsFile as pc, hostedIosRecords as pi, CreatedDevicePlatform as pl, ActivityRecencyBasis as pn, hostedAppBlobs as po, StatsPlatform as pr, listSegmentsAsync as ps, HISTORY_LIMIT as pt, StimConfig as pu, readLogsSince as q, HostedAgentLease as qa, followLogs as qc, buildDiagnostics as qi, getProjectSettings as ql, GitChipPart as qn, isLayeredSetting as qo, readArchives as qr, easSessionLedgerLock as qs, StatusCacheEntry as qt, SOURCES as qu, applyKeyedDelta as r, readLastBuilds as ra, maintenanceRunClaims as rc, MaintenanceSize as ri, recordMatches as rl, readDiskUsageFailure as rn, parseHostedMacosChoice as ro, NATIVE_BUILD_STEPS as rr, RECORDING_PLATFORMS as rs, HOSTED_METRO_REQUESTS_KEY as rt, requireAutomaticMachine as ru, StatusViews as s, workspaceLastUsed as sa, serverSetupDir as sc, parseMaintenanceState as si, FingerprintMemoRecord as sl, withGitChip as sn, HostedAppDelivery as so, PhysicalDeviceState as sr, capDrops as ss, hostedMetroRequests as st, DeviceRecord as su, KeyedDelta as t, readDevicePlacement as ta, maintenanceDir as tc, MaintenancePressure as ti, readLogRecords as tl, readBuildDetail as tn, parseHostedAgentAccess as to, MemorySource as tr, RECORDING_CAP_BYTES as ts, parseMachine as tt, AutomaticPoolRole as tu, WorkspaceSummary as u, HOSTED_PARKED_CANDIDATES as ua, sharedCompilationCache as uc, HostedIosPlacement as ui, fingerprintMemoLock as ul, APP_PROCESS_STATES as un, HostedAppRecord as uo, RunOutcomeKind as ur, listRecordedDevices as us, BuildMachineTotals as ut, ProjectRecord as uu, parseSetupJournal as v, HostedDeviceRequest as va, workspaceBuildDetailFile as vc, HostedAndroidStatus as vi, readEasSessionLedger as vl, AppPresence as vn, rememberHostedAppBlobRename as vo, TUTORIAL_VERSION as vr, AutomaticPlacement as vs, RunHistory as vt, MachineCredential as vu, BuildLedgerCacheResult as w, assertHostedDeviceLedger as wa, workspaceLogErrorIndex as wc, unreadableHostedAndroid as wi, withStateReadCache as wl, BuildDetail as wn, ANDROID_COMPILER_CACHE_CHOICES as wo, WebPageState as wr, agentSessionsCacheFile as ws, StatsPlacement as wt, machineCapacity as wu, agentDeviceStateDirsAsync as x, HostedIosChoice as xa, workspaceEndedAgentsLock as xc, hostedAndroidRecords as xi, readJsonFile as xl, BuildActivity as xn, SETTINGS_SCHEMA_FILE as xo, WORKSPACE_STAGE_KINDS as xr, mayRunHere as xs, StatsBucket as xt, MachineCapacity as xu, readSetupJournal as y, HostedDeviceSelectors as ya, workspaceDerivedData as yc, hostedAndroidDeviceName as yi, validEasSessionClaim as yl, BUILD_PHASES as yn, validHostedAppArguments as yo, WEB_PAGE_STATES as yr, PLACEMENT_WORDS as ys, RunSample as yt, parseMachineCredential as yu, HOSTED_LOGS_FIRST_BYTES as z, readHostedDeviceLedger as za, QueryCriteria as zc, LAST_BUILD_KEYS as zi, ParkedMax as zl, DeviceAppProcess as zn, SettingsPayload as zo, ArchivedUsage as zr, deviceHostMachinesClaims as zs, wholePhases as zt, readAgentDeviceUsageCache as zu };
+export { TailnetPeer as $, AgentSession as $a, DevServerStopRecord as $c, createDebugLog as $i, parseHostedNativeOffer as $l, configLockPath as $n, StatsPlatform as $o, LogQueryOptions as $r, macosAppState as $s, diskUsageCacheFile as $t, AgentRecordSelection as $u, BuildLedgerPlatform as A, StimConfig as Aa, HostedIosStatus as Ac, CreatedDevicePlatform as Ai, HostedAndroidChoice as Al, listSegmentsAsync as An, EnvironmentState as Ao, statsFile as Ar, SETTING_SCOPES as As, StatsReport as At, hostedAppArea as Au, HOSTED_LOGS_FIRST_BYTES as B, buildSlotsDir as Ba, hostedAndroidRecords as Bc, readStateFile as Bi, HostedIosChoice as Bl, prefersRemote as Bn, MacosBuildPlanPayload as Bo, workspaceLightenedFile as Br, WebViewport as Bs, trimCapacityRefusals as Bt, MachineCacheUsage as Bu, BuildLedgerBoot as C, Config as Ca, MaintenanceState as Cc, FINGERPRINT_MEMO_SCHEMA as Ci, readWarmRecord as Cl, RecordingPlatform as Cn, DeviceActivity as Co, serverLocalSocket as Cr, ANDROID_PCH_CHOICES as Cs, RunSample as Ct, parseHostedMacosDevice as Cu, BuildLedgerFailure as D, ProjectRecord as Da, readMaintenanceAttempt as Dc, fingerprintMemoLock as Di, DEVICE_HOST_LIMITS as Dl, listRecordedDevices as Dn, DiskMeasure as Do, sharedCompilationCache as Dr, RemoteDeviceBackend as Ds, StatsCapacityWait as Dt, HostedAppFile as Du, BuildLedgerDevice as E, PlatformRecords as Ea, parseMaintenanceState as Ec, fingerprintMemoFile as Ei, workspaceLastUsed as El, footageDrops as En, DevicePlacement as Eo, sharedCcache as Er, REPLACED_SETTINGS as Es, StatsCapacityRefusal as Et, HostedAppDelivery as Eu, GcLogRecord as F, MachineCredential as Fa, unreadableHostedIos as Fc, readEasSessionLedger as Fi, HostedDevicePhase as Fl, AutomaticPlacement as Fn, MACHINE_OWNER_KINDS as Fo, workspaceBuildDetailFile as Fr, SettingWriteResult as Fs, projectRootDirectories as Ft, readHostedApp as Fu, hostedNativeLogsDir as G, saturation as Ga, hostedNativeRecords as Gc, Trace as Gi, deviceHostRoot as Gl, budgetSweepFile as Gn, PHYSICAL_DEVICE_CONNECTIONS as Go, workspaceStateFile as Gr, isSensitiveReference as Gs, ViewedDevice as Gt, readSwiftpmCacheUsage as Gu, HostedLogsCursor as H, loadState as Ha, parseHostedAndroidPlacement as Hc, readHomeIdentity as Hi, HostedNativeOffer as Hl, archiveDir as Hn, MetroBundleState as Ho, workspaceLogsDir as Hr, coerceSettingText as Hs, trimSamples as Ht, machineCacheUsageFile as Hu, GcLogStatus as I, parseMachineCredential as Ia, HostedAndroidPlacement as Ic, validEasSessionClaim as Ii, HostedDevicePlatform as Il, PLACEMENT_WORDS as In, MEMORY_SOURCES as Io, workspaceDerivedData as Ir, SettingsPayload as Is, readRunEstimates as It, readHostedAppMetadata as Iu, readLogsSince as J, AGENT_TOOLS as Ja, BUILD_HISTORY_KEY as Jc, redactArgv as Ji, hostedWorkerSettleMs as Jl, buildLedgerFile as Jn, PlannedPhase as Jo, createNdjsonTail as Jr, settingValueError as Js, AgentSessionsCache as Jt, AgentDeviceUsageRoots as Ju, parseHostedLogsCursor as K, tryAcquireBuildSlotClaim as Ka, parseHostedNativePlacement as Kc, TraceArgs as Ki, hostedConsolePort as Kl, budgetSweepLock as Kn, PhysicalDeviceConnection as Ko, workspaceStateLock as Kr, replacementAdvice as Ks, readViewedDevices as Kt, swiftpmCacheUsageFile as Ku, GcLogTrigger as L, readBuildMachines as La, HostedAndroidStatus as Lc, isJsonObject as Li, HostedDeviceRequest as Ll, PlacementWord as Ln, MachineOwner as Lo, workspaceEndedAgentsFile as Lr, TUNNEL_MODES as Ls, readStats as Lt, rememberHostedAppBlobRename as Lu, isBuildLedgerRecord as M, clientIdentity as Ma, hostedIosRecords as Mc, EasSessionClaim as Mi, HostedDevice as Ml, recordedBytes as Mn, GitChipPart as Mo, supervisorPidFile as Mr, SettingEntry as Ms, decodeStats as Mt, hostedAppBlobs as Mu, readBuildLedger as N, BuildMachineCredential as Na, hostedIosStatus as Nc, EasSessionLedgerRead as Ni, HostedDeviceOffer as Nl, recordingDeviceName as Nn, LastBuildReport as No, trashRoot as Nr, SettingScope as Ns, findProjectRoot as Nt, parseHostedAppManifest as Nu, BuildLedgerOutcome as O, RepoRecord as Oa, readMaintenanceState as Oc, readFingerprintMemo as Oi, DeviceHostLimits as Ol, listRecordedDevicesAsync as On, EndedAgentSession as Oo, sharedGradle as Or, SETTINGS as Os, StatsPlacement as Ot, HostedAppOffer as Ou, GcLogOptions as P, MACHINE_CREDENTIALS_VERSION as Pa, parseHostedIosPlacement as Pc, readCreatedDevices as Pi, HostedDeviceOfferRequest as Pl, recordingEnabled as Pn, LoadState as Po, workspaceAgentDeviceDir as Pr, SettingType as Ps, offloadSummary as Pt, parseHostedAppOffer as Pu, TAILNET_MACHINE_PATTERN as Q, ActivityRecencyBasis as Qa, DEV_SERVER_STOP_REQUEST_KEY as Qc, DebugLog as Qi, parseHostedLocalDeviceCount as Ql, clientIdentityKeyFile as Qn, SimulatorState as Qo, ERROR_SOURCES as Qr, MacosProcess as Qs, agentSessionOf as Qt, AgentActionReaderOptions as Qu, isGcLogRecord as R, MachineCapacity as Ra, hostedAndroidDeviceName as Rc, readJsonFile as Ri, HostedDeviceSelectors as Rl, mayRunHere as Rn, MachineOwnerKind as Ro, workspaceEndedAgentsLock as Rr, TunnelMode as Rs, readStatsReport as Rt, validHostedAppArguments as Ru, BUILD_LEDGER_CAP as S, ConcurrencyLimits as Sa, MaintenanceSize as Sc, tailRead as Si, readLastBuilds as Sl, RecordedSegment as Sn, ChecksState as So, pullRequestCacheDir as Sr, ANDROID_EMULATOR_APPS as Ss, RunHistory as St, parseHostedMacosChoice as Su, BuildLedgerCacheResult as T, DoctorRunRecord as Ta, MemoryCulprit as Tc, fingerprintMemoDir as Ti, readWorkspaceState as Tl, closedSegmentName as Tn, DeviceLeaseState as To, setupJournalFile as Tr, REMOTE_DEVICE_BACKENDS as Ts, StatsBucket as Tt, HOSTED_APP_CHUNK_BYTES as Tu, HostedLogsPage as U, machineCapacity as Ua, unreadableHostedAndroid as Uc, EndSpan as Ui, assertHostedDeviceLedger as Ul, archiveLock as Un, NATIVE_BUILD_STEPS as Uo, workspaceMetadataFile as Ur, expectedShape as Us, wholePhases as Ut, readMachineCacheUsage as Uu, HOSTED_LOGS_PAGE_BYTES as V, loadPerCore as Va, hostedAndroidStatus as Vc, withStateReadCache as Vi, HostedIosDevice as Vl, agentSessionsCacheFile as Vn, MemorySource as Vo, workspaceLogErrorIndex as Vr, acceptsShape as Vs, trimCapacityWaits as Vt, SimRuntimeUsage as Vu, hostedMacosLogsDir as W, maxLoadPerCore as Wa, HostedNativePlacement as Wc, TRACE_ENV as Wi, deviceHostArea as Wl, archiveRoot as Wn, NativeBuildStep as Wo, workspaceRecordingsDir as Wr, isLayeredSetting as Ws, DeviceViewersRecord as Wt, SwiftpmCacheUsage as Wu, Endpoint as X, ActiveBuildState as Xa, DEVICE_IDLE_SHUTDOWN_KEY as Xc, trace as Xi, parseHostedChoice as Xl, buildMachinesFile as Xn, RunOutcomeKind as Xo, LogDirQuery as Xr, MacosAppState as Xs, PullRequestCacheEntry as Xt, readAgentDeviceUsage as Xu, DEFAULT_SERVER_PORT as Y, APP_PROCESS_STATES as Ya, BUILD_HISTORY_LIMIT as Yc, redactCommandLine as Yi, parseHostedAndroidDevice as Yl, buildLedgerLock as Yn, RemoteDeviceState as Yo, LogDir as Yr, MacosAppRecord as Ys, ENDED_AGENT_RETENTION_MS as Yt, agentDeviceUsageFile as Yu, MachineTransport as Z, ActivityDriver as Za, DEVICE_RECLAIM_REASON as Zc, DEBUG_ENV as Zi, parseHostedDevice as Zl, buildMachinesLock as Zn, STATUS_ISSUE_CODES as Zo, openLogDir as Zr, MacosBuild as Zs, StatusCacheEntry as Zt, readAgentDeviceUsageCache as Zu, isSetupJournalPrunable as _, withConfigLockAsync as _a, MaintenanceCheck as _c, queryLogs as _i, readDevServerStop as _l, validRunId as _n, BuildPlanPayload as _o, maintenanceChildLogFile as _r, WorkspaceStage as _s, HISTORY_LIMIT as _t, hostedAgentDriverName as _u, MachineView as a, configCorruptRepair as aa, ArchivedWorkspace as ac, SOURCES as ad, buildCriteria as ai, MAINTENANCE_LOG_NAME as al, readBuildDetail as an, BUILD_RESULTS as ao, deviceViewersDir as ar, StatusDeviceSlots as as, parseMachine as at, readHostedSessions as au, agentDeviceStateDirs as b, requireAutomaticMachine as ba, MaintenancePressure as bc, recordMatches as bi, readDevicePlacement as bl, RECORDING_PLATFORMS as bn, BuildResult as bo, maintenanceRunClaims as br, WorktreePullRequest as bs, ReadStatsResult as bt, parseHostedAgentAccess as bu, SummaryBuild as c, getParkedMax as ca, linkReplacedArchives as cc, parseNdjsonText as cd, fileIdentity as ci, WARM_KEY as cl, readEndedAgentSessions as cn, BuildCause as co, easMachineStateRoot as cr, StatusPayload as cs, HostedMetroLinks as ct, HostedAgentAccess as cu, WorktreeRow as d, getRepoSettings as da, readArchiveState as dc, isExpoErrorContext as di, WorkspaceState as dl, withGitChip as dn, BuildHistoryEntry as do, emulatorLogFile as dr, WORKSPACE_PHASES as ds, hostedMetroRequests as dt, HostedAgentIssuedGrant as du, debugLogDir as ea, parseMacosRecord as ec, AgentTarget as ed, LogQueryPlan as ei, DevServerStopRequest as el, diskUsageFailureFile as en, AgentTool as eo, createdDevicesFile as er, StatusBuildSlotHolder as es, cannotHost as et, parseHostedOfferRequest as eu, statusViews as f, isPathPrefix as fa, readArchives as fc, logFiles as fi, buildDiagnostics as fl, SETTINGS_SCHEMA_FILE as fn, BuildMissCategory as fo, gcLogDir as fr, WORKSPACE_STAGE_KINDS as fs, DeviceHostMachineCredential as ft, HostedAgentLease as fu, isJournalExpired as g, withConfigLock as ga, MaintenanceActionKind as gc, queryJsonLogs as gi, readBuildHistory as gl, runId as gn, BuildPlacement as go, maintenanceAttemptFile as gr, WorkspacePhase as gs, CAPACITY_REFUSAL_MAX_AGE_MS as gt, HostedMacosPlacement as gu, SetupJournal as h, windowsShortDirKey as ha, MaintenanceAction as hc, planLogQuery as hi, parseMissReason as hl, RUN_ID_ENV as hn, BuildPhase as ho, gitMergeCacheDir as hr, WebPageState as hs, CAPACITY_REFUSAL_LIMIT as ht, HostedMacosDevice as hu, ArchivedSummary as i, buildWorkerRoot as ia, ArchivedUsage as ic, NdjsonRecord as id, attachExpoErrorContext as ii, LAST_BUILD_KEYS as il, readAgentSessionsCache as in, BUILD_PHASES as io, deviceHostMachinesLock as ir, StatusDeviceSlotHolder as is, machineEndpoint as it, readHostedDeviceLedger as iu, BuildLedgerRecord as j, SupervisorRecord as ja, hostedIosPlacements as jc, CreatedDevices as ji, HostedAndroidDevice as jl, openSegmentName as jn, GitChip as jo, supervisorLogFile as jr, SettingDefinition as js, StatsScope as jt, hostedAppAttempt as ju, BuildLedgerPlacement as k, SettingsObject as ka, HostedIosPlacement as kc, countErrorEntries as ki, HOSTED_PARKED_CANDIDATES as kl, listSegments as kn, EnvironmentDisk as ko, sharedPods as kr, SETTING_GROUPS as ks, StatsRecord as kt, HostedAppRecord as ku, SummaryHistoryEntry as l, getProject as la, readArchive as lc, readNdjsonGenerations as ld, fileSizes as li, WORKSPACE_AGENT_KEY as ll, readPullRequestCache as ln, BuildDetail as lo, easSessionLedgerFile as lr, TUTORIAL_VERSION as ls, HostedMetroRequest as lt, HostedAgentDriverName as lu, SetupCapability as m, windowsShortDir as ma, DiskPressureLevel as mc, parseSince as mi, lastUseFrom as ml, settingsJsonSchema as mn, BuildMissReason as mo, getConfigPath as mr, WebBrowserState as ms, BuildMachineTotals as mt, HostedMacosChoice as mu, KeyedEntities as n, ParkedMax as na, readMacosRecord as nc, createAsyncAgentActionReader as nd, QueryCriteria as ni, IDLE_STOP_KEY as nl, listStatusCacheEntries as nn, AndroidRuntimeFacts as no, deviceHostMachinesClaims as nr, StatusCapacity as ns, findPeer as nt, parseHostedRequest as nu, SUMMARY_ARCHIVES as o, findEnclosingWorktreeRoot as oa, archiveEnabled as oc, levelRank as od, bundleMarkerPlatform as oi, MetroLastStop as ol, readDiskUsage as on, BuildActivity as oo, diskUsageCacheDir as or, StatusIssue as os, HOSTED_METRO_LINKS_KEY as ot, HOSTED_AGENT_DRIVERS as ou, workspaceSummary as p, loadConfig as pa, readArchivesAsync as pc, markerWindow as pi, lastNativeUseFrom as pl, SETTINGS_SCHEMA_URL as pn, BuildMissChange as po, gcLogFile as pr, WarmStep as ps, readDeviceHostMachines as pt, HostedAppLaunch as pu, readHostedNativeLogsCheckpoint as q, ACTIVITY_RECENCY_BASES as qa, unreadableHostedNative as qc, TracePhases as qi, hostedDeviceId as ql, buildLedgerDir as qn, PhysicalDeviceState as qo, worktreeArchiveRoot as qr, settingDefinition as qs, stimBuildDigest as qt, AgentDeviceUsage as qu, applyKeyedDelta as r, allMetroPorts as ra, ArchivedBytes as rc, LEVELS as rd, advanceTail as ri, IdleStopRecord as rl, pullRequestCacheFile as rn, AppPresence as ro, deviceHostMachinesFile as rr, StatusCapacityLoad as rs, localEndpoint as rt, readHostedDevice as ru, StatusViews as s, getConcurrencyLimits as sa, archivedUsage as sc, parseNdjsonLine as sd, compileGrep as si, READY_PHASE_MS as sl, readDiskUsageFailure as sn, BuildCacheHit as so, diskUsageWalkClaims as sr, StatusIssueCode as ss, HOSTED_METRO_REQUESTS_KEY as st, HOSTED_MACOS_APP_SLOTS as su, KeyedDelta as t, debugLoggingEnabled as ta, readHostedMacosApp as tc, createAgentActionReader as td, NATIVE_CRASH_LOG_PREFIX as ti, DeviceIdleShutdownRecord as tl, endedAgentSessionOf as tn, AndroidDeviceState as to, createdDevicesLock as tr, StatusBuildSlots as ts, endpoint as tt, parseHostedPlatformDevice as tu, WorkspaceSummary as u, getProjectSettings as ua, readArchiveAsync as uc, followLogs as ui, WarmRecord as ul, withDerivedFacts as un, BuildDiagnostic as uo, easSessionLedgerLock as ur, WEB_PAGE_STATES as us, hostedMetroLinks as ut, HostedAgentGrant as uu, parseSetupJournal as v, AutomaticPoolRole as va, MaintenanceMode as vc, readLogRecords as vi, readDevServerStopRequest as vl, RECORDING_CAP_BYTES as vn, BuildPlatform as vo, maintenanceDir as vr, WorktreeFacts as vs, OffloadSummary as vt, hostedMacosAppSlot as vu, BuildLedgerCache as w, DeviceRecord as wa, MaintenanceStatus as wc, FingerprintMemoRecord as wi, readWorkspaceAgent as wl, capDrops as wn, DeviceAppProcess as wo, serverSetupDir as wr, IOS_SIMULATOR_APPS as ws, STATS_VERSION as wt, parseHostedMacosPlacement as wu, agentDeviceStateDirsAsync as x, validateAutomaticPool as xa, MaintenanceRecord as xc, sortByTs as xi, readIdleStop as xl, RecordedDevice as xn, BuildWaitingFor as xo, maintenanceStateFile as xr, ANDROID_COMPILER_CACHE_CHOICES as xs, RunEstimates as xt, parseHostedAgentGrant as xu, readSetupJournal as y, automaticMachineEnabled as ya, MaintenancePass as yc, readLogTimeline as yi, readDeviceIdleShutdowns as yl, RECORDING_FOOTAGE_MS as yn, BuildReport as yo, maintenanceNdjsonFile as yr, WorktreeGit as ys, PLACEMENT_DECISIONS as yt, hostedMacosBundleId as yu, readGcLog as z, buildSlotPath as za, hostedAndroidPlacements as zc, readJsonObject as zi, HostedDeviceSession as zl, placementWord as zn, MachineUsageState as zo, workspaceGradleBuild as zr, WEB_VIEWPORTS as zs, statsProjectKey as zt, validHostedAppBlob as zu };