@stim-cli/core 1.15.0 → 1.17.0

package/dist/{index-DgLuTAvh.d.mts → index-DPp8a4-9.d.mts}

@@ -1,4 +1,134 @@
 import { o as ClaimHandle } from "./ownership-claim-Xxxr9MPp.mjs";
+//#region state/ndjson.d.ts
+interface NdjsonRecord {
+  ts?: number;
+  src?: string;
+  level?: string;
+  msg?: string;
+  /** With `logs --errors --json`: the code frame and stack lines Expo printed after this error. */
+  context?: string[];
+  [key: string]: unknown;
+}
+declare const LEVELS: string[];
+declare const SOURCES: string[];
+declare function levelRank(level?: string): number;
+declare function parseNdjsonLine(line: unknown): NdjsonRecord | null;
+declare function parseNdjsonText(text: unknown): NdjsonRecord[];
+declare function readNdjsonGenerations(file: string): NdjsonRecord[];
+//#endregion
+//#region state/agent-actions.d.ts
+interface DeviceTarget {
+  platform: "ios" | "android";
+  id: string;
+  slot: string;
+  name?: string;
+}
+type AgentTarget = DeviceTarget | {
+  platform: "macos";
+  id: string;
+  slot: string;
+  bundleId: string;
+  launchedAt: number;
+};
+interface AgentActionReaderOptions {
+  sessionsDirs: readonly string[] | (() => readonly string[]);
+  /** Re-resolved on every read, so a follower picks up a native launch that starts or restarts later. */
+  targets?: AgentTarget[] | (() => AgentTarget[]);
+  sinceTs?: number;
+  now?: () => number;
+  claimedDevice?: (session: string, sessionsDir: string) => string | null;
+}
+/**
+ * Reads agent-device session actions incrementally from the supplied sessions directories. With targets,
+ * records are restricted to those devices; without targets, retained session metadata supplies attribution.
+ * Missing directories and unreadable files yield no records.
+ */
+declare function createAgentActionReader({ sessionsDirs, targets: resolveTargets, sinceTs, now, claimedDevice }: AgentActionReaderOptions): () => NdjsonRecord[];
+//#endregion
+//#region state/agent-device-usage.d.ts
+interface AgentDeviceUsage {
+  version: 1;
+  measuredAt: string;
+  bytes: number;
+  complete: boolean;
+  stateDir: {
+    dir: string;
+    present: boolean;
+    bytes: number | null;
+    sessions: {
+      dir: string;
+      bytes: number | null;
+      count: number;
+    };
+    logs: {
+      dir: string;
+      bytes: number | null;
+    };
+    other: {
+      bytes: number | null;
+      largest: {
+        name: string;
+        bytes: number | null;
+      }[];
+    };
+  };
+  runnerBuilds: {
+    dir: string;
+    present: boolean;
+    bytes: number | null;
+    sharedBytes: number | null;
+    platforms: {
+      platform: string;
+      dir: string;
+      bytes: number | null;
+      entries: {
+        name: string;
+        dir: string;
+        bytes: number | null;
+        lastUsedAt: string | null;
+        packageVersion: string | null;
+        xcodeBuildVersion: string | null;
+        inUse: boolean;
+        inUseReason: "lease" | "lock" | "unreadable" | null;
+      }[];
+    }[];
+  };
+  workspaces: {
+    dir: string;
+    projectRoot: string | null;
+    bytes: number | null;
+  }[];
+  hosted: {
+    dir: string;
+    bytes: number | null;
+    sessions: number;
+  } | null;
+}
+interface AgentDeviceUsageRoots {
+  stateDir: string;
+  runnerRoot: string;
+  hostedDir: string;
+  workspaceDirs: string[];
+}
+declare function agentDeviceUsageFile(): string;
+declare function readAgentDeviceUsageCache(): {
+  usage: AgentDeviceUsage;
+  roots: AgentDeviceUsageRoots;
+} | null;
+declare function readAgentDeviceUsage(): AgentDeviceUsage | null;
+//#endregion
+//#region state/swiftpm-cache-usage.d.ts
+interface SwiftpmCacheUsage {
+  version: 1;
+  measuredAt: string;
+  dir: string;
+  present: boolean;
+  bytes: number | null;
+  complete: boolean;
+}
+declare function swiftpmCacheUsageFile(): string;
+declare function readSwiftpmCacheUsage(): SwiftpmCacheUsage | null;
+//#endregion
 //#region state/build-capacity.d.ts
 declare function buildSlotsDir(): string;
 declare function buildSlotPath(index: number): string;
@@ -44,6 +174,7 @@ interface BuildMachineCredential {
   deviceToken: string;
   state: "pending" | "approved";
   requestedAt: string;
+  ticketHash?: string;
 }
 declare function readBuildMachines(): BuildMachineCredential[];
 //#endregion
@@ -170,6 +301,14 @@ declare function getProject(projectPath: string): ProjectRecord | null;
 declare function getConcurrencyLimits({ env }?: {
   env?: NodeJS.ProcessEnv;
 }): ConcurrencyLimits;
+interface ParkedMax {
+  max: number;
+  error: string | null;
+}
+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 getProjectSetting(projectPath: string, dottedKey: string): unknown;
 declare function getRepoSettings(gitCommonDir: string): Record<string, unknown>;
@@ -216,23 +355,6 @@ interface EasSessionLedgerRead {
 declare function validEasSessionClaim(id: string, value: unknown): EasSessionClaim | null;
 declare function readEasSessionLedger(root?: string): EasSessionLedgerRead;
 //#endregion
-//#region state/ndjson.d.ts
-interface NdjsonRecord {
-  ts?: number;
-  src?: string;
-  level?: string;
-  msg?: string;
-  /** With `logs --errors --json`: the code frame and stack lines Expo printed after this error. */
-  context?: string[];
-  [key: string]: unknown;
-}
-declare const LEVELS: string[];
-declare const SOURCES: string[];
-declare function levelRank(level?: string): number;
-declare function parseNdjsonLine(line: unknown): NdjsonRecord | null;
-declare function parseNdjsonText(text: unknown): NdjsonRecord[];
-declare function readNdjsonGenerations(file: string): NdjsonRecord[];
-//#endregion
 //#region state/error-entries.d.ts
 /**
  * The number of rows a log list shows for `records`, an error query's result in log order. Stim Desktop's
@@ -295,6 +417,9 @@ declare function buildCriteria({ slot, sources, minLevel, since, grep, errorsOnl
 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[];
 type ExpoContextTarget = "msg" | "field";
 /**
  * Adds the code frame and stack lines Expo printed after each Expo error record, either joined into
@@ -314,6 +439,8 @@ declare function queryLogs({ slot, dir, records, sources, minLevel, since, grep,
   errorContext?: boolean;
   now?: number;
 }): 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;
@@ -337,6 +464,7 @@ declare function sortByTs(records: NdjsonRecord[]): NdjsonRecord[];
 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;
@@ -376,6 +504,17 @@ 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 statsFile(): string;
+declare function maintenanceDir(): string;
+declare function maintenanceStateFile(): string;
+declare function maintenanceAttemptFile(): string;
+declare function maintenanceNdjsonFile(): string;
+declare function maintenanceChildLogFile(): string;
+declare function maintenanceRunClaims(): string;
+declare function archiveRoot(): string;
+declare function archiveDir(id: string): string;
+declare function archiveLock(): string;
+declare function serverSetupDir(): string;
+declare function setupJournalFile(hash: string): string | null;
 //#endregion
 //#region state/recordings.d.ts
 /** The footage stim-server keeps per device: the last 15 minutes recorded, however long ago. */
@@ -407,10 +546,10 @@ declare function recordingDeviceName(platform: RecordingPlatform, slot: 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. */
-declare function listSegments(dir: string): RecordedSegment[];
+/** 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[];
 /** Every device slot recorded under a workspace's recordings directory. */
-declare function listRecordedDevices(recordingsDir: string): RecordedDevice[];
+declare function listRecordedDevices(recordingsDir: string, closedOnly?: boolean): 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
@@ -447,6 +586,7 @@ type SettingType = {
   kind: "number";
   integer?: boolean;
   minimum?: number;
+  exclusiveMinimum?: number;
   maximum?: number;
 } | {
   kind: "boolean";
@@ -464,6 +604,7 @@ type SettingType = {
  * `.stim.json` instead of the app's. A `sensitive` value is never printed and is
  * written to `.stim.json` only as an `env:` or `file:` reference. `scopedHomeValue`
  * replaces every layer and the default while STIM_HOME is set and `env` is not.
+ * `ciValue` replaces every layer and the default while CI is set and `env` is not.
  * `desktopDefault` replaces `default` on macOS while Stim Desktop is installed.
  */
 interface SettingDefinition {
@@ -475,7 +616,8 @@ interface SettingDefinition {
   env?: string;
   sensitive?: boolean;
   committedAt?: "repository";
-  scopedHomeValue?: number;
+  scopedHomeValue?: string | number | boolean;
+  ciValue?: string | number | boolean;
   desktopDefault?: string;
 }
 interface SettingEntry {
@@ -568,6 +710,17 @@ interface HostedAppRecord extends HostedAppDelivery {
 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;
@@ -592,20 +745,21 @@ interface HostedMacosDevice extends HostedMacosChoice {
   appSlot: number;
 }
 /**
- * The rest of an agent-device `macos-app` lease's owner scope, which a client names on every request:
- * `deviceKey` is `<bundleId>@<pid>` of the hosted app.
+ * 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 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.
  * `path` is the session's base route on the host, `scope` the driver's handle that limits it to this one app,
- * and `lease` the scope the driver's lease was allocated with.
+ * and `lease` the scope that pins the driver's lease allocation.
  */
 type HostedAgentGrant = {
   driver: "none";
@@ -649,48 +803,132 @@ declare function parseHostedMacosChoice(value: unknown): HostedMacosChoice | nul
 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/macos.d.ts
-interface MacosProcess {
-  pid: number;
-  processToken: string;
-  startedAtMicros: number;
+//#region state/device-host.d.ts
+type HostedDevicePlatform = "ios" | "android" | "macos";
+interface HostedIosChoice {
+  deviceTypeId: string;
+  runtimeId: string;
+  deviceType: string;
+  runtime: string;
+  architecture: "arm64" | "x86_64";
 }
-interface MacosBuild {
-  state: "running" | "ok" | "failed";
-  startedAt: string;
-  finishedAt?: string;
-  durationMs?: number;
-  error?: string;
-  errorCode?: string;
-  buildMachine?: string;
-  builtOn?: string;
-  offloadedTo?: string;
-  offloadFallback?: string;
+interface HostedIosDevice extends HostedIosChoice {
+  udid: string;
+  name: string;
 }
-interface MacosAppRecord {
-  launchId: string;
-  arguments: string[];
-  product: 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 HostedAndroidChoice {
+  systemImage: string;
+  deviceProfile: string;
+  architecture: "arm64-v8a" | "x86_64";
 }
-interface MacosAppState extends MacosAppRecord {
-  state: "running" | "orphaned" | "stopped" | "unverified";
+interface HostedAndroidDevice extends HostedAndroidChoice {
+  avdName: string;
+  serial: string;
+  consolePort: number;
 }
-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;
+type HostedDevice = HostedIosDevice | HostedAndroidDevice | HostedMacosDevice;
+interface HostedDeviceSelectors {
+  deviceType?: string;
+  runtime?: string;
+  systemImage?: string;
+  deviceProfile?: string;
+}
+interface HostedDeviceOfferRequest extends HostedDeviceSelectors {
+  platform: HostedDevicePlatform;
+}
+type HostedNativeOffer = {
+  resources: {
+    cpus: number;
+    /** Five-minute system load divided by available CPU count. */
+    loadPerCore: 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;
+  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?: {
+    at: string;
+  };
+  notice?: string;
+  appAttempt?: string;
+  agent?: HostedAgentGrant;
+  metroPort?: number;
+  clientMetroPort?: number;
+}
+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 {
@@ -710,11 +948,13 @@ interface IdleStopRecord {
   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 the supervisor shut down after `devices.idleShutdownMinutes` with no use. */
+/** 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>;
@@ -768,6 +1008,7 @@ declare function parseMissReason(value: unknown): BuildMissReason | null;
  * ones with a source position first.
  */
 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<StatsPlatform, BuildHistoryEntry[]>>;
@@ -801,6 +1042,254 @@ declare const WORKSPACE_AGENT_KEY = "agentSession";
  */
 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 = Pick<HostedAndroidPlacement, "machine" | "session" | "selected" | "reason" | "agent"> & {
+  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 = Pick<HostedIosPlacement, "machine" | "session" | "selected" | "reason" | "agent"> & {
+  device: {
+    name: string;
+    runtime: string;
+  } | null;
+  /** The latest session probe in status, independent of a conflicting local simulator's state. */
+  state?: string;
+};
+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";
+type MaintenanceCheck = "pressure" | "size";
+type MaintenanceActionKind = "would-clear-outputs" | "would-trim-cache" | "would-empty-cache" | "would-shutdown-device" | "would-stop-workspace";
+interface MaintenanceAction {
+  kind: MaintenanceActionKind;
+  target: string;
+  bytes: number;
+  reason: string;
+  workspace?: string;
+}
+interface MaintenanceSize {
+  name: string;
+  dir: string;
+  bytes: number;
+  measuredAt: number;
+  category: "workspace-outputs" | "build-cache" | "metro-cache" | "compilation-cache" | "ccache" | "other";
+  workspace?: string;
+  idleDays?: number | null;
+  blocked?: string;
+}
+interface MaintenancePressure {
+  disk: {
+    volume: string;
+    freeMb: number;
+  }[];
+  memory: {
+    level: "normal" | "warning" | "critical" | null;
+    availableBytes: number | null;
+    pressured: boolean;
+  };
+  warningSince: number | null;
+}
+interface MaintenancePass {
+  startedAt: number;
+  durationMs: number;
+  trigger: string;
+  mode: "report";
+  freedBytes: 0;
+  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";
+}
+/** Version 1 contains report-only observations; every action is a plan and no resource was reclaimed. */
+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;
+  };
+  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 ArchivedUsage {
+  count: number;
+  bytes: number;
+  byKind: {
+    logs: number;
+    recordings: number;
+    agentActions: number;
+    record: number;
+  };
+}
+declare function readArchives(): ArchivedWorkspace[];
+declare function readArchive(id: string): 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;
+}
+interface MacosBuild {
+  state: "running" | "ok" | "failed";
+  startedAt: string;
+  finishedAt?: string;
+  durationMs?: number;
+  error?: string;
+  errorCode?: string;
+  buildMachine?: string;
+  builtOn?: string;
+  offloadedTo?: string;
+  offloadFallback?: string;
+}
+interface MacosAppRecord {
+  launchId: string;
+  arguments: string[];
+  product: 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/status.d.ts
 type StatsPlatform = "ios" | "android";
 type RunOutcomeKind = "hit" | "cold";
@@ -817,6 +1306,12 @@ type BuildPlacement = "local" | {
   startedAt: string;
   phaseStartedAt: string;
 };
+interface BuildWaitingFor {
+  kind: "build-slot" | "device-slot";
+  inUse: number;
+  max: number;
+  since: string;
+}
 interface BuildReport {
   platform: StatsPlatform;
   slot: string;
@@ -831,6 +1326,8 @@ interface BuildReport {
   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
@@ -851,6 +1348,7 @@ interface BuildReport {
   waitingOn?: {
     path: string;
   };
+  waitingFor?: BuildWaitingFor;
 }
 /** One phase a running build is expected to go through, and its median duration in comparable runs. */
 interface PlannedPhase {
@@ -878,7 +1376,13 @@ interface BuildDetail {
 /** 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";
+  reason: string;
+  machine?: string;
+}
 interface LastBuildReport {
+  devicePlacement?: DevicePlacement;
   platform: StatsPlatform;
   status: "ok" | "failed";
   cacheHit: BuildCacheHit;
@@ -1274,6 +1778,8 @@ interface MetroBundleState {
   };
 }
 interface SimulatorState {
+  devicePlacement?: DevicePlacement;
+  host?: HostedIosStatus;
   name: string | null;
   udid: string;
   owned: boolean;
@@ -1283,24 +1789,28 @@ interface SimulatorState {
   appPresence?: AppPresence;
   /** The simulator's data folder, for an owned simulator once measured. */
   disk?: DiskMeasure;
-  /** Present while the device is not booted after the supervisor shut it down for `devices.idleShutdownMinutes`. */
+  /** 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"];
+  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 the supervisor shut it down for `devices.idleShutdownMinutes`. */
+  /** 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 = 1;
 interface EnvironmentState {
   slots?: {
     slot: string;
@@ -1308,6 +1818,12 @@ interface EnvironmentState {
     android: AndroidDeviceState | null | undefined;
   }[];
   path: 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;
+  };
   live: boolean;
   phase?: WorkspacePhase;
   /** When the warm started (`warming`) or finished (`ready`); null for `live` and `idle`. */
@@ -1362,6 +1878,9 @@ interface EnvironmentState {
     dir: string;
     errorsSinceMarker: number;
   } | null;
+  agentDevice?: {
+    stateDir: string;
+  };
   worktree?: WorktreeFacts | null;
   remoteDevices?: RemoteDeviceState[];
   /** The physical devices this workspace leases, in every slot; absent when it leases none. */
@@ -1438,6 +1957,9 @@ interface MachineUsageState {
 }
 /** 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;
   })[];
@@ -1564,10 +2086,34 @@ interface StatsPlacement {
   reason: string;
   machine?: string;
   buildMs?: number;
+  slotWaitMs?: number;
+  deviceSlotWaitMs?: number;
   /** The project's last cold build here before this run. */
   localEstimateMs?: number;
   failed?: true;
 }
+declare const CAPACITY_REFUSAL_LIMIT = 50;
+declare const CAPACITY_REFUSAL_MAX_AGE_MS: number;
+interface StatsCapacityRefusal {
+  at: string;
+  kind: "device";
+  platform: StatsPlatform;
+  max: number;
+  workspace: string;
+}
+interface StatsCapacityWait {
+  at: string;
+  kind: "device-wait";
+  reclaimed?: number;
+  platform: StatsPlatform;
+  ms: number;
+  max: number;
+  workspace: string;
+}
+declare function trimCapacityRefusals<T extends {
+  at: string;
+}>(events: T[], now: number): T[];
+declare const trimCapacityWaits: (events: StatsCapacityWait[], now: number) => StatsCapacityWait[];
 interface BuildMachineTotals {
   offloaded: number;
   offloadedMs: number;
@@ -1583,6 +2129,8 @@ interface StatsRecord {
   projects: Record<string, StatsScope>;
   history?: Record<string, RunHistory>;
   placements?: StatsPlacement[];
+  capacityRefusals?: StatsCapacityRefusal[];
+  capacityWaits?: StatsCapacityWait[];
   buildMachines?: Record<string, BuildMachineTotals>;
 }
 /**
@@ -1646,6 +2194,10 @@ interface StatsReport {
     android: StatsBucket | null;
   };
   offload: OffloadSummary;
+  capacityRefusals?: StatsCapacityRefusal[];
+  capacityWaits?: StatsCapacityWait[];
+  agentDevice: AgentDeviceUsage | null;
+  swiftpmCache: SwiftpmCacheUsage | null;
 }
 declare function readStatsReport(key: string | null, now: number): {
   report: StatsReport;
@@ -1653,107 +2205,6 @@ declare function readStatsReport(key: string | null, now: number): {
 };
 declare function findProjectRoot(startDir: string): string | null;
 //#endregion
-//#region state/device-host.d.ts
-type HostedDevicePlatform = "ios" | "android" | "macos";
-interface HostedIosChoice {
-  deviceTypeId: string;
-  runtimeId: string;
-  deviceType: string;
-  runtime: string;
-  architecture: "arm64" | "x86_64";
-}
-interface HostedIosDevice extends HostedIosChoice {
-  udid: string;
-  name: string;
-}
-interface HostedAndroidChoice {
-  systemImage: string;
-  deviceProfile: string;
-  architecture: "arm64-v8a" | "x86_64";
-}
-interface HostedAndroidDevice extends HostedAndroidChoice {
-  avdName: string;
-  serial: string;
-  consolePort: number;
-}
-type HostedDevice = HostedIosDevice | HostedAndroidDevice | HostedMacosDevice;
-interface HostedDeviceSelectors {
-  deviceType?: string;
-  runtime?: string;
-  systemImage?: string;
-  deviceProfile?: string;
-}
-interface HostedDeviceOfferRequest extends HostedDeviceSelectors {
-  platform: HostedDevicePlatform;
-}
-type HostedNativeOffer = {
-  resources: {
-    cpus: number;
-    /** Five-minute system load divided by available CPU count. */
-    loadPerCore: number;
-    memoryFreeBytes: number;
-    memoryPressure: "normal" | "warning" | "critical" | null;
-    /** Available bytes on the Stim home volume, not necessarily the Android AVD volume. */
-    workerDiskFreeBytes: number | null;
-  };
-  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;
-  };
-};
-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;
-  notice?: string;
-  appAttempt?: string;
-  metroPort?: number;
-}
-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 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;
-/** 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): void;
-//#endregion
 //#region state/device-host-machines.d.ts
 /** A separately approved hosting machine, pinned before sending its device token. */
 interface DeviceHostMachineCredential {
@@ -1764,11 +2215,33 @@ interface DeviceHostMachineCredential {
   deviceToken: string;
   state: "pending" | "approved";
   requestedAt: string;
+  ticketHash?: string;
 }
 /** An absent store is empty; unreadable or malformed credentials refuse access without discarding pins. */
 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";
+/** 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 {
+  id: string;
+  processToken: string;
+  port?: number;
+  error?: string;
+}
+declare function hostedMetroRequests(state: WorkspaceState | null): Record<string, HostedMetroRequest>;
+declare function hostedMetroGateways(state: WorkspaceState | null): Record<string, HostedMetroGateway>;
+//#endregion
 //#region state/tailnet.d.ts
+declare const TAILNET_MACHINE_PATTERN: string;
 interface TailnetPeer {
   nodeId: string;
   dnsName: string;
@@ -1809,6 +2282,8 @@ type HostedLogsCursor = Record<string, number>;
 interface HostedLogsPage {
   records: NdjsonRecord[];
   cursor: HostedLogsCursor;
+  /** Last completed native collection window, for detecting catch-up progress independently of file offsets. */
+  checkpoint?: number;
   /** True when the budget ended this page before the end of the logs; ask again with `cursor`. */
   more: boolean;
 }
@@ -1816,6 +2291,15 @@ declare const HOSTED_LOGS_PAGE_BYTES: number;
 declare const HOSTED_LOGS_FIRST_BYTES: number;
 declare function parseHostedLogsCursor(value: unknown): HostedLogsCursor | null;
 declare function hostedMacosLogsDir(home: string): string | null;
+declare const hostedNativeLogsDir: (home: string, platform: "ios" | "android") => string;
+/** The completed query window and overlap digests, or null for a missing, malformed or unreadable checkpoint. */
+declare function readHostedNativeLogsCheckpoint(home: string, platform?: "ios" | "android"): {
+  until: number;
+  boundary: string[];
+  windowMs?: number;
+  appAttempt?: string;
+  pid?: number;
+} | null;
 /**
  * The records in `dir` after `cursor`, in file order. A file without a cursor entry starts at most
  * {@link HOSTED_LOGS_FIRST_BYTES} before its end. A file that shrank since the cursor was taken was rotated: the end of
@@ -1823,4 +2307,35 @@ declare function hostedMacosLogsDir(home: string): string | null;
  */
 declare function readLogsSince(dir: string, cursor: HostedLogsCursor): HostedLogsPage;
 //#endregion
-export { StatsPlacement as $, levelRank as $a, configLockPath as $i, DevServerStopRequest as $n, hostedAppAttempt as $r, BuildPhase as $t, deviceHostArea as A, workspaceStateFile as Aa, expectedShape as Ai, STATUS_ISSUE_CODES as An, DeviceRecord as Ao, readMacosRecord as Ar, withDerivedFacts as At, parseHostedRequest as B, followLogs as Ba, RecordingPlatform as Bi, WarmStep as Bn, MachineCapacity as Bo, HostedMacosPlacement as Br, AndroidDeviceState as Bt, HostedDeviceRequest as C, workspaceEndedAgentsFile as Ca, SettingsPayload as Ci, NativeBuildStep as Cn, getProjectSettings as Co, MacosAppRecord as Cr, listStatusCacheEntries as Ct, HostedIosDevice as D, workspaceLogsDir as Da, WebViewport as Di, PlannedPhase as Dn, withConfigLock as Do, macosAppState as Dr, readDiskUsage as Dt, HostedIosChoice as E, workspaceLogErrorIndex as Ea, WEB_VIEWPORTS as Ei, PhysicalDeviceState as En, loadConfig as Eo, MacosProcess as Er, readBuildDetail as Et, parseHostedChoice as F, attachExpoErrorContext as Fa, RECORDING_CAP_BYTES as Fi, StatusIssueCode as Fn, SettingsObject as Fo, HostedAgentGrant as Fr, ActiveBuildState as Ft, OffloadSummary as G, readLogRecords as Ga, listSegments as Gi, WorktreeFacts as Gn, tryAcquireBuildSlotClaim as Go, parseHostedMacosDevice as Gr, BuildCacheHit as Gt, readHostedSessions as H, markerWindow as Ha, closedSegmentName as Hi, WebPageState as Hn, buildSlotsDir as Ho, hostedMacosBundleId as Hr, AppPresence as Ht, parseHostedDevice as I, buildCriteria as Ia, RECORDING_FOOTAGE_MS as Ii, StatusPayload as In, StimConfig as Io, HostedAgentLease as Ir, ActivityDriver as It, RunEstimates as J, tailRead as Ja, recordingDeviceName as Ji, BUILD_HISTORY_KEY as Jn, HostedAppDelivery as Jr, BuildDiagnostic as Jt, PLACEMENT_DECISIONS as K, recordMatches as Ka, openSegmentName as Ki, WorktreeGit as Kn, parseHostedMacosPlacement as Kr, BuildCause as Kt, parseHostedNativeOffer as L, bundleMarkerPlatform as La, RECORDING_PLATFORMS as Li, WEB_PAGE_STATES as Ln, SupervisorRecord as Lo, HostedAppLaunch as Lr, ActivityRecencyBasis as Lt, hostedConsolePort as M, ERROR_SOURCES as Ma, isSensitiveReference as Mi, StatsPlatform as Mn, PlatformRecords as Mo, HOSTED_MACOS_APP_SLOTS as Mr, ACTIVITY_RECENCY_BASES as Mt, hostedDeviceId as N, QueryCriteria as Na, settingDefinition as Ni, StatusCapacity as Nn, ProjectRecord as No, HostedAgentAccess as Nr, AGENT_TOOLS as Nt, HostedNativeOffer as O, workspaceMetadataFile as Oa, acceptsShape as Oi, RemoteDeviceState as On, ConcurrencyLimits as Oo, parseMacosRecord as Or, readEndedAgentSessions as Ot, parseHostedAndroidDevice as P, advanceTail as Pa, settingValueError as Pi, StatusIssue as Pn, RepoRecord as Po, HostedAgentDriverName as Pr, APP_PROCESS_STATES as Pt, StatsBucket as Q, SOURCES as Qa, buildMachinesLock as Qi, DevServerStopRecord as Qn, hostedAppArea as Qr, BuildMissReason as Qt, parseHostedOfferRequest as R, compileGrep as Ra, RecordedDevice as Ri, WORKSPACE_PHASES as Rn, BuildMachineCredential as Ro, HostedMacosChoice as Rr, AgentSession as Rt, HostedDevicePlatform as S, workspaceDerivedData as Sa, SettingType as Si, NATIVE_BUILD_STEPS as Sn, getProjectSetting as So, workspaceLastUsed as Sr, endedAgentSessionOf as St, HostedDeviceSession as T, workspaceGradleBuild as Ta, TunnelMode as Ti, PhysicalDeviceConnection as Tn, isPathPrefix as To, MacosBuild as Tr, readAgentSessionsCache as Tt, BuildMachineTotals as U, parseSince as Ua, footageDrops as Ui, WorkspacePhase as Un, machineCapacity as Uo, parseHostedAgentGrant as Ur, BUILD_PHASES as Ut, readHostedDevice as V, logFiles as Va, capDrops as Vi, WebBrowserState as Vn, buildSlotPath as Vo, hostedMacosAppSlot as Vr, AndroidRuntimeFacts as Vt, HISTORY_LIMIT as W, queryLogs as Wa, listRecordedDevices as Wi, WorkspaceStage as Wn, saturation as Wo, parseHostedMacosChoice as Wr, BUILD_RESULTS as Wt, RunSample as X, LEVELS as Xa, agentSessionsCacheFile as Xi, DEVICE_IDLE_SHUTDOWN_KEY as Xn, HostedAppOffer as Xr, BuildMissCategory as Xt, RunHistory as Y, countErrorEntries as Ya, recordingEnabled as Yi, BUILD_HISTORY_LIMIT as Yn, HostedAppFile as Yr, BuildHistoryEntry as Yt, STATS_VERSION as Z, NdjsonRecord as Za, buildMachinesFile as Zi, DEV_SERVER_STOP_REQUEST_KEY as Zn, HostedAppRecord as Zr, BuildMissChange as Zt, HostedAndroidDevice as _, sharedPods as _a, SETTING_GROUPS as _i, MachineOwner as _n, configCorruptRepair as _o, readIdleStop as _r, ENDED_AGENT_RETENTION_MS as _t, hostedMacosLogsDir as a, deviceViewersDir as aa, SETTINGS_SCHEMA_FILE as ai, DeviceActivity as an, EasSessionClaim as ao, READY_PHASE_MS as ar, offloadSummary as at, HostedDeviceOfferRequest as b, supervisorPidFile as ba, SettingEntry as bi, MemorySource as bn, getConcurrencyLimits as bo, readWorkspaceAgent as br, agentSessionOf as bt, Endpoint as c, easSessionLedgerFile as ca, ANDROID_COMPILER_CACHE_CHOICES as ci, DiskMeasure as cn, readEasSessionLedger as co, WarmRecord as cr, readStatsReport as ct, findPeer as d, getConfigPath as da, IOS_SIMULATOR_APPS as di, EnvironmentState as dn, readJsonFile as do, lastUseFrom as dr, wholePhases as dt, createdDevicesFile as ea, parseHostedAppManifest as ei, BuildPlacement as en, parseNdjsonLine as eo, DeviceIdleShutdownRecord as er, StatsRecord as et, parseMachine as f, gitMergeCacheDir as fa, OFFLOAD_MODES as fi, GitChip as fn, readJsonObject as fo, parseMissReason as fr, DeviceViewersRecord as ft, HostedAndroidChoice as g, sharedGradle as ga, SETTINGS as gi, MEMORY_SOURCES as gn, buildWorkerRoot as go, readDeviceIdleShutdowns as gr, AgentSessionsCache as gt, readDeviceHostMachines as h, sharedCompilationCache as ha, RemoteDeviceBackend as hi, MACHINE_OWNER_KINDS as hn, allMetroPorts as ho, readDevServerStopRequest as hr, stimBuildDigest as ht, HostedLogsPage as i, deviceHostMachinesLock as ia, validHostedAppArguments as ii, ChecksState as in, CreatedDevices as io, MetroLastStop as ir, findProjectRoot as it, deviceHostRoot as j, workspaceStateLock as ja, isLayeredSetting as ji, SimulatorState as jn, DoctorRunRecord as jo, HOSTED_AGENT_DRIVERS as jr, withGitChip as jt, assertHostedDeviceLedger as k, workspaceRecordingsDir as ka, coerceSettingText as ki, RunOutcomeKind as kn, Config as ko, readHostedMacosApp as kr, readPullRequestCache as kt, TailnetPeer as l, easSessionLedgerLock as la, ANDROID_EMULATOR_APPS as li, EndedAgentSession as ln, validEasSessionClaim as lo, WorkspaceState as lr, statsProjectKey as lt, DeviceHostMachineCredential as m, sharedCcache as ma, REMOTE_DEVICE_BACKENDS as mi, LastBuildReport as mn, withStateReadCache as mo, readDevServerStop as mr, readViewedDevices as mt, HOSTED_LOGS_PAGE_BYTES as n, deviceHostMachinesClaims as na, readHostedApp as ni, BuildReport as nn, readNdjsonGenerations as no, IdleStopRecord as nr, StatsScope as nt, parseHostedLogsCursor as o, diskUsageCacheDir as oa, SETTINGS_SCHEMA_URL as oi, DeviceAppProcess as on, EasSessionLedgerRead as oo, WARM_KEY as or, readRunEstimates as ot, pinnedEndpoint as p, pullRequestCacheDir as pa, OffloadMode as pi, GitChipPart as pn, readStateFile as po, readBuildHistory as pr, ViewedDevice as pt, ReadStatsResult as q, sortByTs as qa, recordedBytes as qi, WorktreePullRequest as qn, HOSTED_APP_CHUNK_BYTES as qr, BuildDetail as qt, HostedLogsCursor as r, deviceHostMachinesFile as ra, readHostedAppMetadata as ri, BuildResult as rn, CreatedDevicePlatform as ro, LAST_BUILD_KEYS as rr, decodeStats as rt, readLogsSince as s, easMachineStateRoot as sa, settingsJsonSchema as si, DeviceLeaseState as sn, readCreatedDevices as so, WORKSPACE_AGENT_KEY as sr, readStats as st, HOSTED_LOGS_FIRST_BYTES as t, createdDevicesLock as ta, parseHostedAppOffer as ti, BuildPlanPayload as tn, parseNdjsonText as to, IDLE_STOP_KEY as tr, StatsReport as tt, endpoint as u, emulatorLogFile as ua, ANDROID_PCH_CHOICES as ui, EnvironmentDisk as un, isJsonObject as uo, buildDiagnostics as ur, trimSamples as ut, HostedDevice as v, statsFile as va, SETTING_SCOPES as vi, MachineOwnerKind as vn, findEnclosingWorktreeRoot as vo, readLastBuilds as vr, PullRequestCacheEntry as vt, HostedDeviceSelectors as w, workspaceEndedAgentsLock as wa, TUNNEL_MODES as wi, PHYSICAL_DEVICE_CONNECTIONS as wn, getRepoSettings as wo, MacosAppState as wr, pullRequestCacheFile as wt, HostedDevicePhase as x, workspaceBuildDetailFile as xa, SettingScope as xi, MetroBundleState as xn, getProject as xo, readWorkspaceState as xr, diskUsageCacheFile as xt, HostedDeviceOffer as y, supervisorLogFile as ya, SettingDefinition as yi, MachineUsageState as yn, findProjectByMetroPort as yo, readWarmRecord as yr, StatusCacheEntry as yt, parseHostedPlatformDevice as z, fileSizes as za, RecordedSegment as zi, WORKSPACE_STAGE_KINDS as zn, readBuildMachines as zo, HostedMacosDevice as zr, AgentTool as zt };
+//#region state/agent-device.d.ts
+declare function agentDeviceStateDirs(home?: string): string[];
+//#endregion
+//#region state/setup-journal.d.ts
+type SetupCapability = "build" | "device-host";
+interface SetupJournal {
+  v: 1;
+  client: {
+    nodeId: string;
+  };
+  expiresAt: string;
+  capabilities: SetupCapability[];
+  steps: {
+    id: string;
+    state: "pending" | "running" | "ok" | "skipped" | "failed";
+    title: string;
+    detail?: string;
+    fix?: string;
+  }[];
+  granted: {
+    capability: SetupCapability;
+    id: string;
+  }[];
+  done: boolean;
+  exit?: number;
+}
+declare function parseSetupJournal(value: unknown): SetupJournal | null;
+declare function readSetupJournal(hash: string): SetupJournal | null;
+declare function isJournalExpired(journal: SetupJournal, now?: number): boolean;
+declare function isSetupJournalPrunable(journal: SetupJournal, now: number): boolean;
+//#endregion
+export { readRunEstimates as $, settingDefinition as $a, HostedAppLaunch as $i, readMacosRecord as $n, workspaceBuildDetailFile as $o, READY_PHASE_MS as $r, getProjectSettings as $s, BuildWaitingFor as $t, DeviceHostMachineCredential as A, ANDROID_PCH_CHOICES as Aa, AgentActionReaderOptions as Ac, HostedNativeOffer as Ai, StatusCapacity as An, easMachineStateRoot as Ao, HostedAndroidStatus as Ar, countErrorEntries as As, ActiveBuildState as At, RunHistory as B, SettingEntry as Ba, parseHostedNativeOffer as Bi, WebPageState as Bn, maintenanceRunClaims as Bo, unreadableHostedNative as Br, readJsonObject as Bs, BuildCacheHit as Bt, pinnedEndpoint as C, validHostedAppArguments as Ca, readSwiftpmCacheUsage as Cc, HostedDevicePhase as Ci, PhysicalDeviceState as Cn, createdDevicesFile as Co, HostedIosStatus as Cr, queryJsonLogs as Cs, readEndedAgentSessions as Ct, HostedMetroRequest as D, settingsJsonSchema as Da, agentDeviceUsageFile as Dc, HostedDeviceSession as Di, STATUS_ISSUE_CODES as Dn, deviceHostMachinesLock as Do, parseHostedIosPlacement as Dr, recordMatches as Ds, ACTIVITY_RECENCY_BASES as Dt, HostedMetroGateway as E, SETTINGS_SCHEMA_URL as Ea, AgentDeviceUsageRoots as Ec, HostedDeviceSelectors as Ei, RunOutcomeKind as En, deviceHostMachinesFile as Eo, hostedIosStatus as Er, readLogTimeline as Es, withGitChip as Et, HISTORY_LIMIT as F, RemoteDeviceBackend as Fa, SOURCES as Fc, hostedDeviceId as Fi, WEB_PAGE_STATES as Fn, gitMergeCacheDir as Fo, parseHostedAndroidPlacement as Fr, readCreatedDevices as Fs, AndroidDeviceState as Ft, StatsCapacityWait as G, TunnelMode as Ga, readHostedDeviceLedger as Gi, WorktreePullRequest as Gn, sharedCcache as Go, DEV_SERVER_STOP_REQUEST_KEY as Gr, buildWorkerRoot as Gs, BuildMissCategory as Gt, STATS_VERSION as H, SettingType as Ha, parseHostedPlatformDevice as Hi, WorkspaceStage as Hn, pullRequestCacheDir as Ho, BUILD_HISTORY_LIMIT as Hr, withStateReadCache as Hs, BuildDetail as Ht, OffloadSummary as I, SETTINGS as Ia, levelRank as Ic, parseHostedAndroidDevice as Ii, WORKSPACE_PHASES as In, maintenanceAttemptFile as Io, unreadableHostedAndroid as Ir, readEasSessionLedger as Is, AndroidRuntimeFacts as It, StatsReport as J, acceptsShape as Ja, HOSTED_MACOS_APP_SLOTS as Ji, MacosBuild as Jn, sharedPods as Jo, DeviceIdleShutdownRecord as Jr, findProjectByMetroPort as Js, BuildPhase as Jt, StatsPlacement as K, WEB_VIEWPORTS as Ka, readHostedSessions as Ki, MacosAppRecord as Kn, sharedCompilationCache as Ko, DevServerStopRecord as Kr, configCorruptRepair as Ks, BuildMissChange as Kt, PLACEMENT_DECISIONS as L, SETTING_GROUPS as La, parseNdjsonLine as Lc, parseHostedChoice as Li, WORKSPACE_STAGE_KINDS as Ln, maintenanceChildLogFile as Lo, HostedNativePlacement as Lr, validEasSessionClaim as Ls, AppPresence as Lt, BuildMachineTotals as M, OFFLOAD_MODES as Ma, createAgentActionReader as Mc, deviceHostArea as Mi, StatusIssueCode as Mn, easSessionLedgerLock as Mo, hostedAndroidPlacements as Mr, CreatedDevices as Ms, ActivityRecencyBasis as Mt, CAPACITY_REFUSAL_LIMIT as N, OffloadMode as Na, LEVELS as Nc, deviceHostRoot as Ni, StatusPayload as Nn, emulatorLogFile as No, hostedAndroidRecords as Nr, EasSessionClaim as Ns, AgentSession as Nt, hostedMetroGateways as O, ANDROID_COMPILER_CACHE_CHOICES as Oa, readAgentDeviceUsage as Oc, HostedIosChoice as Oi, SimulatorState as On, deviceViewersDir as Oo, unreadableHostedIos as Or, sortByTs as Os, AGENT_TOOLS as Ot, CAPACITY_REFUSAL_MAX_AGE_MS as P, REMOTE_DEVICE_BACKENDS as Pa, NdjsonRecord as Pc, hostedConsolePort as Pi, TUTORIAL_VERSION as Pn, getConfigPath as Po, hostedAndroidStatus as Pr, EasSessionLedgerRead as Ps, AgentTool as Pt, offloadSummary as Q, isSensitiveReference as Qa, HostedAgentLease as Qi, readHostedMacosApp as Qn, workspaceAgentDeviceDir as Qo, MetroLastStop as Qr, getProjectSetting as Qs, BuildResult as Qt, ReadStatsResult as R, SETTING_SCOPES as Ra, parseNdjsonText as Rc, parseHostedDevice as Ri, WarmStep as Rn, maintenanceDir as Ro, hostedNativeRecords as Rr, isJsonObject as Rs, BUILD_PHASES as Rt, parseMachine as S, rememberHostedAppBlobRename as Sa, SwiftpmCacheUsage as Sc, HostedDeviceOfferRequest as Si, PhysicalDeviceConnection as Sn, configLockPath as So, HostedIosPlacement as Sr, parseSince as Ss, readDiskUsage as St, HOSTED_METRO_REQUESTS_KEY as T, SETTINGS_SCHEMA_FILE as Ta, AgentDeviceUsage as Tc, HostedDeviceRequest as Ti, RemoteDeviceState as Tn, deviceHostMachinesClaims as To, hostedIosRecords as Tr, readLogRecords as Ts, withDerivedFacts as Tt, StatsBucket as U, SettingsPayload as Ua, parseHostedRequest as Ui, WorktreeFacts as Un, serverSetupDir as Uo, DEVICE_IDLE_SHUTDOWN_KEY as Ur, ParkedMax as Us, BuildDiagnostic as Ut, RunSample as V, SettingScope as Va, parseHostedOfferRequest as Vi, WorkspacePhase as Vn, maintenanceStateFile as Vo, BUILD_HISTORY_KEY as Vr, readStateFile as Vs, BuildCause as Vt, StatsCapacityRefusal as W, TUNNEL_MODES as Wa, readHostedDevice as Wi, WorktreeGit as Wn, setupJournalFile as Wo, DEVICE_RECLAIM_REASON as Wr, allMetroPorts as Ws, BuildHistoryEntry as Wt, decodeStats as X, expectedShape as Xa, HostedAgentDriverName as Xi, macosAppState as Xn, supervisorLogFile as Xo, IdleStopRecord as Xr, getParkedMax as Xs, BuildPlanPayload as Xt, StatsScope as Y, coerceSettingText as Ya, HostedAgentAccess as Yi, MacosProcess as Yn, statsFile as Yo, IDLE_STOP_KEY as Yr, getConcurrencyLimits as Ys, BuildPlacement as Yt, findProjectRoot as Z, isLayeredSetting as Za, HostedAgentGrant as Zi, parseMacosRecord as Zn, supervisorPidFile as Zo, LAST_BUILD_KEYS as Zr, getProject as Zs, BuildReport as Zt, Endpoint as _, hostedAppBlobs as _a, buildSlotPath as _c, workspaceLastUsed as _i, MemorySource as _n, archiveDir as _o, MaintenanceState as _r, compileGrep as _s, endedAgentSessionOf as _t, parseSetupJournal as a, parseHostedAgentAccess as aa, Config as ac, lastUseFrom as ai, DiskMeasure as an, RecordedSegment as ao, linkReplacedArchives as ar, workspaceLogsDir as as, trimSamples as at, endpoint as b, readHostedApp as ba, saturation as bc, HostedDevice as bi, NativeBuildStep as bn, buildMachinesFile as bo, readMaintenanceAttempt as br, logFiles as bs, readAgentSessionsCache as bt, HOSTED_LOGS_FIRST_BYTES as c, parseHostedMacosDevice as ca, PlatformRecords as cc, readDevServerStop as ci, EnvironmentState as cn, closedSegmentName as co, readArchives as cr, workspaceStateFile as cs, ViewedDevice as ct, HostedLogsPage as d, HostedAppDelivery as da, SettingsObject as dc, readDevicePlacement as di, LastBuildReport as dn, listSegments as do, MaintenanceCheck as dr, NATIVE_CRASH_LOG_PREFIX as ds, AgentSessionsCache as dt, HostedMacosChoice as ea, getRepoSettings as ec, WARM_KEY as ei, ChecksState as en, settingValueError as eo, ArchivedBytes as er, workspaceDerivedData as es, readStats as et, hostedMacosLogsDir as f, HostedAppFile as fa, StimConfig as fc, readIdleStop as fi, MACHINE_OWNER_KINDS as fn, openSegmentName as fo, MaintenanceMode as fr, QueryCriteria as fs, ENDED_AGENT_RETENTION_MS as ft, readLogsSince as g, hostedAppAttempt as ga, MachineCapacity as gc, readWorkspaceState as gi, MachineUsageState as gn, agentSessionsCacheFile as go, MaintenanceSize as gr, bundleMarkerPlatform as gs, diskUsageCacheFile as gt, readHostedNativeLogsCheckpoint as h, hostedAppArea as ha, readBuildMachines as hc, readWorkspaceAgent as hi, MachineOwnerKind as hn, recordingEnabled as ho, MaintenanceRecord as hr, buildCriteria as hs, agentSessionOf as ht, isSetupJournalPrunable as i, hostedMacosBundleId as ia, ConcurrencyLimits as ic, buildDiagnostics as ii, DevicePlacement as in, RecordedDevice as io, archivedUsage as ir, workspaceLogErrorIndex as is, trimCapacityWaits as it, readDeviceHostMachines as j, IOS_SIMULATOR_APPS as ja, AgentTarget as jc, assertHostedDeviceLedger as ji, StatusIssue as jn, easSessionLedgerFile as jo, hostedAndroidDeviceName as jr, CreatedDevicePlatform as js, ActivityDriver as jt, hostedMetroRequests as k, ANDROID_EMULATOR_APPS as ka, readAgentDeviceUsageCache as kc, HostedIosDevice as ki, StatsPlatform as kn, diskUsageCacheDir as ko, HostedAndroidPlacement as kr, tailRead as ks, APP_PROCESS_STATES as kt, HOSTED_LOGS_PAGE_BYTES as l, parseHostedMacosPlacement as la, ProjectRecord as lc, readDevServerStopRequest as li, GitChip as ln, footageDrops as lo, MaintenanceAction as lr, workspaceStateLock as ls, readViewedDevices as lt, parseHostedLogsCursor as m, HostedAppRecord as ma, BuildMachineCredential as mc, readWarmRecord as mi, MachineOwner as mn, recordingDeviceName as mo, MaintenancePressure as mr, attachExpoErrorContext as ms, StatusCacheEntry as mt, SetupJournal as n, HostedMacosPlacement as na, loadConfig as nc, WarmRecord as ni, DeviceAppProcess as nn, RECORDING_FOOTAGE_MS as no, ArchivedWorkspace as nr, workspaceEndedAgentsLock as ns, statsProjectKey as nt, readSetupJournal as o, parseHostedAgentGrant as oa, DeviceRecord as oc, parseMissReason as oi, EndedAgentSession as on, RecordingPlatform as oo, readArchive as or, workspaceMetadataFile as os, wholePhases as ot, hostedNativeLogsDir as p, HostedAppOffer as pa, SupervisorRecord as pc, readLastBuilds as pi, MEMORY_SOURCES as pn, recordedBytes as po, MaintenancePass as pr, advanceTail as ps, PullRequestCacheEntry as pt, StatsRecord as q, WebViewport as qa, HOSTED_AGENT_DRIVERS as qi, MacosAppState as qn, sharedGradle as qo, DevServerStopRequest as qr, findEnclosingWorktreeRoot as qs, BuildMissReason as qt, isJournalExpired as r, hostedMacosAppSlot as ra, withConfigLock as rc, WorkspaceState as ri, DeviceLeaseState as rn, RECORDING_PLATFORMS as ro, archiveEnabled as rr, workspaceGradleBuild as rs, trimCapacityRefusals as rt, agentDeviceStateDirs as s, parseHostedMacosChoice as sa, DoctorRunRecord as sc, readBuildHistory as si, EnvironmentDisk as sn, capDrops as so, readArchiveState as sr, workspaceRecordingsDir as ss, DeviceViewersRecord as st, SetupCapability as t, HostedMacosDevice as ta, isPathPrefix as tc, WORKSPACE_AGENT_KEY as ti, DeviceActivity as tn, RECORDING_CAP_BYTES as to, ArchivedUsage as tr, workspaceEndedAgentsFile as ts, readStatsReport as tt, HostedLogsCursor as u, HOSTED_APP_CHUNK_BYTES as ua, RepoRecord as uc, readDeviceIdleShutdowns as ui, GitChipPart as un, listRecordedDevices as uo, MaintenanceActionKind as ur, ERROR_SOURCES as us, stimBuildDigest as ut, TAILNET_MACHINE_PATTERN as v, parseHostedAppManifest as va, buildSlotsDir as vc, HostedAndroidChoice as vi, MetroBundleState as vn, archiveLock as vo, MaintenanceStatus as vr, fileSizes as vs, listStatusCacheEntries as vt, HOSTED_METRO_GATEWAYS_KEY as w, validHostedAppBlob as wa, swiftpmCacheUsageFile as wc, HostedDevicePlatform as wi, PlannedPhase as wn, createdDevicesLock as wo, hostedIosPlacements as wr, queryLogs as ws, readPullRequestCache as wt, findPeer as x, readHostedAppMetadata as xa, tryAcquireBuildSlotClaim as xc, HostedDeviceOffer as xi, PHYSICAL_DEVICE_CONNECTIONS as xn, buildMachinesLock as xo, readMaintenanceState as xr, markerWindow as xs, readBuildDetail as xt, TailnetPeer as y, parseHostedAppOffer as ya, machineCapacity as yc, HostedAndroidDevice as yi, NATIVE_BUILD_STEPS as yn, archiveRoot as yo, parseMaintenanceState as yr, followLogs as ys, pullRequestCacheFile as yt, RunEstimates as z, SettingDefinition as za, readNdjsonGenerations as zc, parseHostedLocalDeviceCount as zi, WebBrowserState as zn, maintenanceNdjsonFile as zo, parseHostedNativePlacement as zr, readJsonFile as zs, BUILD_RESULTS as zt };