@stim-cli/core 1.17.2 → 1.19.0

package/dist/{index-lRdEfJSb.d.mts → index-BITArGWH.d.mts}

@@ -276,6 +276,9 @@ interface StimConfig {
   hosting?: {
     agentDriver?: unknown;
   };
+  debug?: {
+    logs?: unknown;
+  };
   server?: {
     acceptClientBuilds?: unknown;
     maxLoadPerCore?: unknown;
@@ -286,11 +289,19 @@ interface StimConfig {
     machines?: unknown;
     build?: unknown;
     buildMode?: 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;
+declare function validateAutomaticPool(role: AutomaticPoolRole, config: StimConfig): void;
+//#endregion
 //#region state/config.d.ts
 declare function withConfigLock<T>(fn: () => T): T;
 declare function configCorruptRepair(path?: string): string;
@@ -317,6 +328,27 @@ declare function findEnclosingWorktreeRoot(projectPath: string): string | null;
 declare function allMetroPorts(): number[];
 declare function findProjectByMetroPort(port: number): string | null;
 //#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;
+}
+/**
+ * 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.
+ */
+declare function createDebugLog(component: "cli" | "server", { env, now, base }?: {
+  env?: NodeJS.ProcessEnv;
+  now?: () => number;
+  base?: () => Record<string, unknown>;
+}): DebugLog;
+//#endregion
 //#region state/json-file.d.ts
 /**
  * Runs `fn` with each state file read from disk at most once: inside it, including after an `await`, `readStateFile`
@@ -489,6 +521,8 @@ 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 Macs this Mac paired with, each with its pinned tailnet node and device token. */
 declare function buildMachinesFile(): string;
 declare function buildMachinesLock(): string;
@@ -564,6 +598,16 @@ declare function capDrops(devices: readonly RecordedDevice[], capBytes: number):
  */
 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 id 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-registry.d.ts
 declare const ANDROID_COMPILER_CACHE_CHOICES: readonly ["auto", "ccache", "cas", "none"];
 declare const ANDROID_PCH_CHOICES: readonly ["auto", "on", "off"];
@@ -612,7 +656,7 @@ interface SettingDefinition {
   type: SettingType;
   scopes: readonly SettingScope[];
   description: string;
-  default?: string | number | boolean;
+  default?: string | number | boolean | readonly string[];
   env?: string;
   sensitive?: boolean;
   committedAt?: "repository";
@@ -1014,6 +1058,7 @@ declare function readLastBuilds(state: WorkspaceState | null | undefined): Parti
 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;
+declare const MAINTENANCE_LOG_NAME = "maintenance.ndjson";
 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. */
@@ -1107,15 +1152,18 @@ 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";
+type MaintenanceMode = "off" | "report" | "on";
+type MaintenanceCheck = "pressure" | "size" | "worktree" | "sweep";
+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";
 interface MaintenanceAction {
   kind: MaintenanceActionKind;
   target: string;
   bytes: number;
   reason: string;
   workspace?: string;
+  dir?: string;
+  olderThanDays?: number;
+  check?: "worktree" | "sweep" | "disk";
 }
 interface MaintenanceSize {
   name: string;
@@ -1143,8 +1191,8 @@ interface MaintenancePass {
   startedAt: number;
   durationMs: number;
   trigger: string;
-  mode: "report";
-  freedBytes: 0;
+  mode: "report" | "on";
+  freedBytes: number;
   actions: number;
   stopped: 0;
   blocked: string[];
@@ -1157,9 +1205,8 @@ interface MaintenanceRecord extends NdjsonRecord {
   event: "maintenance_pass" | "maintenance_action" | "maintenance_skip" | "maintenance_failure" | "maintenance_check";
   pass: string;
   trigger: string;
-  mode: "report";
+  mode: "report" | "on";
 }
-/** 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>>;
@@ -1181,6 +1228,8 @@ interface MaintenanceStatus {
   lastChecks: {
     pressure: number | null;
     size: number | null;
+    worktree: number | null;
+    sweep: number | null;
   };
   pressure: MaintenancePressure | null;
   sizes: MaintenanceSize[];
@@ -1281,6 +1330,8 @@ 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;
@@ -1390,7 +1441,7 @@ interface BuildDetail {
 type BuildCacheHit = "local" | "remote" | false;
 /** A platform's most recent `ios` or `android` run in one workspace. */
 interface DevicePlacement {
-  decision: "local" | "hosted" | "waited-locally";
+  decision: "local" | "hosted" | "waited-locally" | "eas";
   reason: string;
   machine?: string;
 }
@@ -1443,6 +1494,8 @@ interface BuildHistoryEntry extends LastBuildReport {
   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 {
@@ -1497,6 +1550,23 @@ interface BuildPlanPayload {
     message: string;
     remedy: string;
   };
+  /** With ios.remote or android.remote set to auto or a Mac, where the plan assumes the device runs, such as `this Mac; auto may use janics-mac-mini`. */
+  placement?: string;
+}
+/** The read-only `stim macos --plan --json` payload; SwiftPM work and worker availability remain unknown. */
+interface MacosBuildPlanPayload {
+  platform: "macos";
+  product: string;
+  buildMachine: string;
+  fingerprint: null;
+  cacheKey: null;
+  cacheHit: false;
+  provider: null;
+  cacheSkipped: false;
+  prebuild: null;
+  outcome: null;
+  expectedMs: null;
+  basis: number;
 }
 type ActivityState = "driven" | "active" | "idle" | "unknown";
 interface ActivityDriver {
@@ -1823,7 +1893,7 @@ interface AndroidDeviceState {
   idleShutdown?: DeviceIdleShutdownRecord;
 }
 /** The tutorial format version the installed Stim writes into the tutorial app. */
-declare const TUTORIAL_VERSION = 1;
+declare const TUTORIAL_VERSION = 2;
 interface EnvironmentState {
   slots?: {
     slot: string;
@@ -1891,8 +1961,10 @@ interface EnvironmentState {
     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[];
@@ -1992,6 +2064,8 @@ declare function withDerivedFacts<T extends EnvironmentState>(env: T): T;
 //#region state/status-measures.d.ts
 /** The file that caches `path`'s measured size, one file per folder. */
 declare function diskUsageCacheFile(path: string): string;
+/** The file that records when the last walk of `path` failed, so other processes do not repeat it at once. */
+declare function diskUsageFailureFile(path: string): string;
 /** The file that caches the pull request of the worktree at `path`. */
 declare function pullRequestCacheFile(path: string): string;
 /** One file of the disk-usage or pull-request cache. */
@@ -2016,6 +2090,8 @@ interface PullRequestCacheEntry {
 declare function readPullRequestCache(path: string): PullRequestCacheEntry | null;
 /** The cached size of the folder at `path`, or null before it was measured. */
 declare function readDiskUsage(path: string): DiskMeasure | null;
+/** When the last walk of `path` failed (an ISO time), or null when none is recorded. */
+declare function readDiskUsageFailure(path: string): string | null;
 /** The running build's tool detail its process last wrote, when the file belongs to the build with `claimId`. */
 declare function readBuildDetail(root: string, claimId: string): BuildDetail | null;
 /** The coding-agent sessions `status --watch` last found running on this Mac, and when it looked. */
@@ -2216,6 +2292,7 @@ declare function readStatsReport(key: string | null, now: number): {
   report: StatsReport;
   note: string | null;
 };
+declare function projectRootDirectories(startDir: string): Generator<string>;
 declare function findProjectRoot(startDir: string): string | null;
 //#endregion
 //#region state/device-host-machines.d.ts
@@ -2352,4 +2429,4 @@ 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 $, isSensitiveReference as $a, HostedAgentLease as $i, readHostedMacosApp as $n, workspaceAgentDeviceDir as $o, MetroLastStop as $r, getProjectSetting as $s, BuildResult as $t, DeviceHostMachineCredential as A, ANDROID_EMULATOR_APPS as Aa, readAgentDeviceUsageCache as Ac, HostedIosDevice as Ai, StatsPlatform as An, diskUsageCacheDir as Ao, HostedAndroidPlacement as Ar, tailRead as As, ActiveBuildState as At, RunHistory as B, SettingDefinition as Ba, readNdjsonGenerations as Bc, parseHostedLocalDeviceCount as Bi, WebBrowserState as Bn, maintenanceNdjsonFile as Bo, parseHostedNativePlacement as Br, readJsonFile as Bs, BuildCacheHit as Bt, pinnedEndpoint as C, rememberHostedAppBlobRename as Ca, SwiftpmCacheUsage as Cc, HostedDeviceOfferRequest as Ci, PhysicalDeviceConnection as Cn, configLockPath as Co, HostedIosPlacement as Cr, parseSince as Cs, readEndedAgentSessions as Ct, HostedMetroRequest as D, SETTINGS_SCHEMA_URL as Da, AgentDeviceUsageRoots as Dc, HostedDeviceSelectors as Di, RunOutcomeKind as Dn, deviceHostMachinesFile as Do, hostedIosStatus as Dr, readLogTimeline as Ds, ACTIVITY_RECENCY_BASES as Dt, HostedMetroGateway as E, SETTINGS_SCHEMA_FILE as Ea, AgentDeviceUsage as Ec, HostedDeviceRequest as Ei, RemoteDeviceState as En, deviceHostMachinesClaims as Eo, hostedIosRecords as Er, readLogRecords as Es, withGitChip as Et, HISTORY_LIMIT as F, REMOTE_DEVICE_BACKENDS as Fa, NdjsonRecord as Fc, hostedConsolePort as Fi, TUTORIAL_VERSION as Fn, getConfigPath as Fo, hostedAndroidStatus as Fr, EasSessionLedgerRead as Fs, AndroidDeviceState as Ft, StatsCapacityWait as G, TUNNEL_MODES as Ga, readHostedDevice as Gi, WorktreeGit as Gn, setupJournalFile as Go, DEVICE_RECLAIM_REASON as Gr, allMetroPorts as Gs, BuildMissCategory as Gt, STATS_VERSION as H, SettingScope as Ha, parseHostedOfferRequest as Hi, WorkspacePhase as Hn, maintenanceStateFile as Ho, BUILD_HISTORY_KEY as Hr, readStateFile as Hs, BuildDetail as Ht, OffloadSummary as I, RemoteDeviceBackend as Ia, SOURCES as Ic, hostedDeviceId as Ii, WEB_PAGE_STATES as In, gitMergeCacheDir as Io, parseHostedAndroidPlacement as Ir, readCreatedDevices as Is, AndroidRuntimeFacts as It, StatsReport as J, WebViewport as Ja, HOSTED_AGENT_DRIVERS as Ji, MacosAppState as Jn, sharedGradle as Jo, DevServerStopRequest as Jr, findEnclosingWorktreeRoot as Js, BuildPhase as Jt, StatsPlacement as K, TunnelMode as Ka, readHostedDeviceLedger as Ki, WorktreePullRequest as Kn, sharedCcache as Ko, DEV_SERVER_STOP_REQUEST_KEY as Kr, buildWorkerRoot as Ks, BuildMissChange as Kt, PLACEMENT_DECISIONS as L, SETTINGS as La, levelRank as Lc, parseHostedAndroidDevice as Li, WORKSPACE_PHASES as Ln, maintenanceAttemptFile as Lo, unreadableHostedAndroid as Lr, readEasSessionLedger as Ls, AppPresence as Lt, BuildMachineTotals as M, IOS_SIMULATOR_APPS as Ma, AgentTarget as Mc, assertHostedDeviceLedger as Mi, StatusIssue as Mn, easSessionLedgerFile as Mo, hostedAndroidDeviceName as Mr, CreatedDevicePlatform as Ms, ActivityRecencyBasis as Mt, CAPACITY_REFUSAL_LIMIT as N, OFFLOAD_MODES as Na, createAgentActionReader as Nc, deviceHostArea as Ni, StatusIssueCode as Nn, easSessionLedgerLock as No, hostedAndroidPlacements as Nr, CreatedDevices as Ns, AgentSession as Nt, hostedMetroGateways as O, settingsJsonSchema as Oa, agentDeviceUsageFile as Oc, HostedDeviceSession as Oi, STATUS_ISSUE_CODES as On, deviceHostMachinesLock as Oo, parseHostedIosPlacement as Or, recordMatches as Os, AGENT_TOOLS as Ot, CAPACITY_REFUSAL_MAX_AGE_MS as P, OffloadMode as Pa, LEVELS as Pc, deviceHostRoot as Pi, StatusPayload as Pn, emulatorLogFile as Po, hostedAndroidRecords as Pr, EasSessionClaim as Ps, AgentTool as Pt, offloadSummary as Q, isLayeredSetting as Qa, HostedAgentGrant as Qi, parseMacosRecord as Qn, supervisorPidFile as Qo, LAST_BUILD_KEYS as Qr, getProject as Qs, BuildReport as Qt, ReadStatsResult as R, SETTING_GROUPS as Ra, parseNdjsonLine as Rc, parseHostedChoice as Ri, WORKSPACE_STAGE_KINDS as Rn, maintenanceChildLogFile as Ro, HostedNativePlacement as Rr, validEasSessionClaim as Rs, BUILD_PHASES as Rt, parseMachine as S, readHostedAppMetadata as Sa, tryAcquireBuildSlotClaim as Sc, HostedDeviceOffer as Si, PHYSICAL_DEVICE_CONNECTIONS as Sn, buildMachinesLock as So, readMaintenanceState as Sr, markerWindow as Ss, readDiskUsage as St, HOSTED_METRO_REQUESTS_KEY as T, validHostedAppBlob as Ta, swiftpmCacheUsageFile as Tc, HostedDevicePlatform as Ti, PlannedPhase as Tn, createdDevicesLock as To, hostedIosPlacements as Tr, queryLogs as Ts, withDerivedFacts as Tt, StatsBucket as U, SettingType as Ua, parseHostedPlatformDevice as Ui, WorkspaceStage as Un, pullRequestCacheDir as Uo, BUILD_HISTORY_LIMIT as Ur, withStateReadCache as Us, BuildDiagnostic as Ut, RunSample as V, SettingEntry as Va, parseHostedNativeOffer as Vi, WebPageState as Vn, maintenanceRunClaims as Vo, unreadableHostedNative as Vr, readJsonObject as Vs, BuildCause as Vt, StatsCapacityRefusal as W, SettingsPayload as Wa, parseHostedRequest as Wi, WorktreeFacts as Wn, serverSetupDir as Wo, DEVICE_IDLE_SHUTDOWN_KEY as Wr, ParkedMax as Ws, BuildHistoryEntry as Wt, decodeStats as X, coerceSettingText as Xa, HostedAgentAccess as Xi, MacosProcess as Xn, statsFile as Xo, IDLE_STOP_KEY as Xr, getConcurrencyLimits as Xs, BuildPlanPayload as Xt, StatsScope as Y, acceptsShape as Ya, HOSTED_MACOS_APP_SLOTS as Yi, MacosBuild as Yn, sharedPods as Yo, DeviceIdleShutdownRecord as Yr, findProjectByMetroPort as Ys, BuildPlacement as Yt, findProjectRoot as Z, expectedShape as Za, HostedAgentDriverName as Zi, macosAppState as Zn, supervisorLogFile as Zo, IdleStopRecord as Zr, getParkedMax as Zs, BuildPlatform as Zt, Endpoint as _, hostedAppAttempt as _a, MachineCapacity as _c, readWorkspaceState as _i, MachineUsageState as _n, agentSessionsCacheFile as _o, MaintenanceSize as _r, bundleMarkerPlatform as _s, endedAgentSessionOf as _t, parseSetupJournal as a, hostedMacosBundleId as aa, ConcurrencyLimits as ac, buildDiagnostics as ai, DevicePlacement as an, RecordedDevice as ao, archivedUsage as ar, workspaceLogErrorIndex as as, trimSamples as at, endpoint as b, parseHostedAppOffer as ba, machineCapacity as bc, HostedAndroidDevice as bi, NATIVE_BUILD_STEPS as bn, archiveRoot as bo, parseMaintenanceState as br, followLogs as bs, readAgentSessionsCache as bt, HOSTED_LOGS_FIRST_BYTES as c, parseHostedMacosChoice as ca, DoctorRunRecord as cc, readBuildHistory as ci, EnvironmentDisk as cn, capDrops as co, readArchiveState as cr, workspaceRecordingsDir as cs, ViewedDevice as ct, HostedLogsPage as d, HOSTED_APP_CHUNK_BYTES as da, RepoRecord as dc, readDeviceIdleShutdowns as di, GitChipPart as dn, listRecordedDevices as do, MaintenanceActionKind as dr, ERROR_SOURCES as ds, AgentSessionsCache as dt, HostedAppLaunch as ea, getProjectSettings as ec, READY_PHASE_MS as ei, BuildWaitingFor as en, settingDefinition as eo, readMacosRecord as er, workspaceBuildDetailFile as es, readStats as et, hostedMacosLogsDir as f, HostedAppDelivery as fa, SettingsObject as fc, readDevicePlacement as fi, LastBuildReport as fn, listSegments as fo, MaintenanceCheck as fr, NATIVE_CRASH_LOG_PREFIX as fs, ENDED_AGENT_RETENTION_MS as ft, readLogsSince as g, hostedAppArea as ga, readBuildMachines as gc, readWorkspaceAgent as gi, MachineOwnerKind as gn, recordingEnabled as go, MaintenanceRecord as gr, buildCriteria as gs, diskUsageCacheFile as gt, readHostedNativeLogsCheckpoint as h, HostedAppRecord as ha, BuildMachineCredential as hc, readWarmRecord as hi, MachineOwner as hn, recordingDeviceName as ho, MaintenancePressure as hr, attachExpoErrorContext as hs, agentSessionOf as ht, isSetupJournalPrunable as i, hostedMacosAppSlot as ia, withConfigLock as ic, WorkspaceState as ii, DeviceLeaseState as in, RECORDING_PLATFORMS as io, archiveEnabled as ir, workspaceGradleBuild as is, trimCapacityWaits as it, readDeviceHostMachines as j, ANDROID_PCH_CHOICES as ja, AgentActionReaderOptions as jc, HostedNativeOffer as ji, StatusCapacity as jn, easMachineStateRoot as jo, HostedAndroidStatus as jr, countErrorEntries as js, ActivityDriver as jt, hostedMetroRequests as k, ANDROID_COMPILER_CACHE_CHOICES as ka, readAgentDeviceUsage as kc, HostedIosChoice as ki, SimulatorState as kn, deviceViewersDir as ko, unreadableHostedIos as kr, sortByTs as ks, APP_PROCESS_STATES as kt, HOSTED_LOGS_PAGE_BYTES as l, parseHostedMacosDevice as la, PlatformRecords as lc, readDevServerStop as li, EnvironmentState as ln, closedSegmentName as lo, readArchives as lr, workspaceStateFile as ls, readViewedDevices as lt, parseHostedLogsCursor as m, HostedAppOffer as ma, SupervisorRecord as mc, readLastBuilds as mi, MEMORY_SOURCES as mn, recordedBytes as mo, MaintenancePass as mr, advanceTail as ms, StatusCacheEntry as mt, SetupJournal as n, HostedMacosDevice as na, isPathPrefix as nc, WORKSPACE_AGENT_KEY as ni, DeviceActivity as nn, RECORDING_CAP_BYTES as no, ArchivedUsage as nr, workspaceEndedAgentsFile as ns, statsProjectKey as nt, readSetupJournal as o, parseHostedAgentAccess as oa, Config as oc, lastUseFrom as oi, DiskMeasure as on, RecordedSegment as oo, linkReplacedArchives as or, workspaceLogsDir as os, wholePhases as ot, hostedNativeLogsDir as p, HostedAppFile as pa, StimConfig as pc, readIdleStop as pi, MACHINE_OWNER_KINDS as pn, openSegmentName as po, MaintenanceMode as pr, QueryCriteria as ps, PullRequestCacheEntry as pt, StatsRecord as q, WEB_VIEWPORTS as qa, readHostedSessions as qi, MacosAppRecord as qn, sharedCompilationCache as qo, DevServerStopRecord as qr, configCorruptRepair as qs, BuildMissReason as qt, isJournalExpired as r, HostedMacosPlacement as ra, loadConfig as rc, WarmRecord as ri, DeviceAppProcess as rn, RECORDING_FOOTAGE_MS as ro, ArchivedWorkspace as rr, workspaceEndedAgentsLock as rs, trimCapacityRefusals as rt, agentDeviceStateDirs as s, parseHostedAgentGrant as sa, DeviceRecord as sc, parseMissReason as si, EndedAgentSession as sn, RecordingPlatform as so, readArchive as sr, workspaceMetadataFile as ss, DeviceViewersRecord as st, SetupCapability as t, HostedMacosChoice as ta, getRepoSettings as tc, WARM_KEY as ti, ChecksState as tn, settingValueError as to, ArchivedBytes as tr, workspaceDerivedData as ts, readStatsReport as tt, HostedLogsCursor as u, parseHostedMacosPlacement as ua, ProjectRecord as uc, readDevServerStopRequest as ui, GitChip as un, footageDrops as uo, MaintenanceAction as ur, workspaceStateLock as us, stimBuildDigest as ut, TAILNET_MACHINE_PATTERN as v, hostedAppBlobs as va, buildSlotPath as vc, workspaceLastUsed as vi, MemorySource as vn, archiveDir as vo, MaintenanceState as vr, compileGrep as vs, listStatusCacheEntries as vt, HOSTED_METRO_GATEWAYS_KEY as w, validHostedAppArguments as wa, readSwiftpmCacheUsage as wc, HostedDevicePhase as wi, PhysicalDeviceState as wn, createdDevicesFile as wo, HostedIosStatus as wr, queryJsonLogs as ws, readPullRequestCache as wt, findPeer as x, readHostedApp as xa, saturation as xc, HostedDevice as xi, NativeBuildStep as xn, buildMachinesFile as xo, readMaintenanceAttempt as xr, logFiles as xs, readBuildDetail as xt, TailnetPeer as y, parseHostedAppManifest as ya, buildSlotsDir as yc, HostedAndroidChoice as yi, MetroBundleState as yn, archiveLock as yo, MaintenanceStatus as yr, fileSizes as ys, pullRequestCacheFile as yt, RunEstimates as z, SETTING_SCOPES as za, parseNdjsonText as zc, parseHostedDevice as zi, WarmStep as zn, maintenanceDir as zo, hostedNativeRecords as zr, isJsonObject as zs, BUILD_RESULTS as zt };
+export { projectRootDirectories as $, WebViewport as $a, NdjsonRecord as $c, HOSTED_AGENT_DRIVERS as $i, MacosBuild as $n, serverSetupDir as $o, DeviceIdleShutdownRecord as $r, DEBUG_ENV as $s, BuildPlanPayload as $t, DeviceHostMachineCredential as A, validHostedAppBlob as Aa, SettingsObject as Ac, HostedDevicePlatform as Ai, RemoteDeviceState as An, buildMachinesLock as Ao, hostedIosRecords as Ar, logFiles as As, ACTIVITY_RECENCY_BASES as At, RunHistory as B, REMOTE_DEVICE_BACKENDS as Ba, tryAcquireBuildSlotClaim as Bc, hostedConsolePort as Bi, WEB_PAGE_STATES as Bn, easMachineStateRoot as Bo, parseHostedAndroidPlacement as Br, countErrorEntries as Bs, AppPresence as Bt, pinnedEndpoint as C, hostedAppBlobs as Ca, ConcurrencyLimits as Cc, workspaceLastUsed as Ci, MetroBundleState as Cn, recordingDeviceName as Co, MaintenanceStatus as Cr, advanceTail as Cs, readBuildDetail as Ct, HostedMetroRequest as D, readHostedAppMetadata as Da, PlatformRecords as Dc, HostedDeviceOffer as Di, PhysicalDeviceConnection as Dn, archiveLock as Do, HostedIosPlacement as Dr, compileGrep as Ds, readPullRequestCache as Dt, HostedMetroGateway as E, readHostedApp as Ea, DoctorRunRecord as Ec, HostedDevice as Ei, PHYSICAL_DEVICE_CONNECTIONS as En, archiveDir as Eo, readMaintenanceState as Er, bundleMarkerPlatform as Es, readEndedAgentSessions as Et, HISTORY_LIMIT as F, ANDROID_EMULATOR_APPS as Fa, MachineCapacity as Fc, HostedIosDevice as Fi, StatusCapacity as Fn, deviceHostMachinesFile as Fo, HostedAndroidStatus as Fr, readLogRecords as Fs, ActivityRecencyBasis as Ft, StatsCapacityWait as G, SettingDefinition as Ga, AgentDeviceUsageRoots as Gc, parseHostedLocalDeviceCount as Gi, WebPageState as Gn, gitMergeCacheDir as Go, unreadableHostedNative as Gr, readCreatedDevices as Gs, BuildDetail as Gt, STATS_VERSION as H, SETTINGS as Ha, readSwiftpmCacheUsage as Hc, parseHostedAndroidDevice as Hi, WORKSPACE_STAGE_KINDS as Hn, easSessionLedgerLock as Ho, HostedNativePlacement as Hr, CreatedDevices as Hs, BUILD_RESULTS as Ht, OffloadSummary as I, ANDROID_PCH_CHOICES as Ia, buildSlotPath as Ic, HostedNativeOffer as Ii, StatusIssue as In, deviceHostMachinesLock as Io, hostedAndroidDeviceName as Ir, readLogTimeline as Is, AgentSession as It, StatsReport as J, SettingType as Ja, readAgentDeviceUsageCache as Jc, parseHostedPlatformDevice as Ji, WorktreeFacts as Jn, maintenanceDir as Jo, DEVICE_IDLE_SHUTDOWN_KEY as Jr, isJsonObject as Js, BuildMissCategory as Jt, StatsPlacement as K, SettingEntry as Ka, agentDeviceUsageFile as Kc, parseHostedNativeOffer as Ki, WorkspacePhase as Kn, maintenanceAttemptFile as Ko, BUILD_HISTORY_KEY as Kr, readEasSessionLedger as Ks, BuildDiagnostic as Kt, PLACEMENT_DECISIONS as L, IOS_SIMULATOR_APPS as La, buildSlotsDir as Lc, assertHostedDeviceLedger as Li, StatusIssueCode as Ln, deviceViewersDir as Lo, hostedAndroidPlacements as Lr, recordMatches as Ls, AgentTool as Lt, BuildMachineTotals as M, SETTINGS_SCHEMA_URL as Ma, SupervisorRecord as Mc, HostedDeviceSelectors as Mi, STATUS_ISSUE_CODES as Mn, createdDevicesFile as Mo, parseHostedIosPlacement as Mr, parseSince as Ms, APP_PROCESS_STATES as Mt, CAPACITY_REFUSAL_LIMIT as N, settingsJsonSchema as Na, BuildMachineCredential as Nc, HostedDeviceSession as Ni, SimulatorState as Nn, createdDevicesLock as No, unreadableHostedIos as Nr, queryJsonLogs as Ns, ActiveBuildState as Nt, hostedMetroGateways as O, rememberHostedAppBlobRename as Oa, ProjectRecord as Oc, HostedDeviceOfferRequest as Oi, PhysicalDeviceState as On, archiveRoot as Oo, HostedIosStatus as Or, fileSizes as Os, withDerivedFacts as Ot, CAPACITY_REFUSAL_MAX_AGE_MS as P, ANDROID_COMPILER_CACHE_CHOICES as Pa, readBuildMachines as Pc, HostedIosChoice as Pi, StatsPlatform as Pn, deviceHostMachinesClaims as Po, HostedAndroidPlacement as Pr, queryLogs as Ps, ActivityDriver as Pt, offloadSummary as Q, WEB_VIEWPORTS as Qa, LEVELS as Qc, readHostedSessions as Qi, MacosAppState as Qn, pullRequestCacheDir as Qo, DevServerStopRequest as Qr, withStateReadCache as Qs, BuildPlacement as Qt, ReadStatsResult as R, OFFLOAD_MODES as Ra, machineCapacity as Rc, deviceHostArea as Ri, StatusPayload as Rn, diskUsageCacheDir as Ro, hostedAndroidRecords as Rr, sortByTs as Rs, AndroidDeviceState as Rt, parseMachine as S, hostedAppAttempt as Sa, validateAutomaticPool as Sc, readWorkspaceState as Si, MemorySource as Sn, recordedBytes as So, MaintenanceState as Sr, QueryCriteria as Ss, readAgentSessionsCache as St, HOSTED_METRO_REQUESTS_KEY as T, parseHostedAppOffer as Ta, DeviceRecord as Tc, HostedAndroidDevice as Ti, NativeBuildStep as Tn, agentSessionsCacheFile as To, readMaintenanceAttempt as Tr, buildCriteria as Ts, readDiskUsageFailure as Tt, StatsBucket as U, SETTING_GROUPS as Ua, swiftpmCacheUsageFile as Uc, parseHostedChoice as Ui, WarmStep as Un, emulatorLogFile as Uo, hostedNativeRecords as Ur, EasSessionClaim as Us, BuildCacheHit as Ut, RunSample as V, RemoteDeviceBackend as Va, SwiftpmCacheUsage as Vc, hostedDeviceId as Vi, WORKSPACE_PHASES as Vn, easSessionLedgerFile as Vo, unreadableHostedAndroid as Vr, CreatedDevicePlatform as Vs, BUILD_PHASES as Vt, StatsCapacityRefusal as W, SETTING_SCOPES as Wa, AgentDeviceUsage as Wc, parseHostedDevice as Wi, WebBrowserState as Wn, getConfigPath as Wo, parseHostedNativePlacement as Wr, EasSessionLedgerRead as Ws, BuildCause as Wt, decodeStats as X, TUNNEL_MODES as Xa, AgentTarget as Xc, readHostedDevice as Xi, WorktreePullRequest as Xn, maintenanceRunClaims as Xo, DEV_SERVER_STOP_REQUEST_KEY as Xr, readJsonObject as Xs, BuildMissReason as Xt, StatsScope as Y, SettingsPayload as Ya, AgentActionReaderOptions as Yc, parseHostedRequest as Yi, WorktreeGit as Yn, maintenanceNdjsonFile as Yo, DEVICE_RECLAIM_REASON as Yr, readJsonFile as Ys, BuildMissChange as Yt, findProjectRoot as Z, TunnelMode as Za, createAgentActionReader as Zc, readHostedDeviceLedger as Zi, MacosAppRecord as Zn, maintenanceStateFile as Zo, DevServerStopRecord as Zr, readStateFile as Zs, BuildPhase as Zt, Endpoint as _, HostedAppDelivery as _a, loadConfig as _c, readDevicePlacement as _i, MEMORY_SOURCES as _n, closedSegmentName as _o, MaintenanceMode as _r, workspaceRecordingsDir as _s, diskUsageCacheFile as _t, parseSetupJournal as a, HostedAppLaunch as aa, allMetroPorts as ac, READY_PHASE_MS as ai, DeviceActivity as an, settingDefinition as ao, ArchivedBytes as ar, statsFile as as, trimCapacityWaits as at, endpoint as b, HostedAppRecord as ba, automaticMachineEnabled as bc, readWarmRecord as bi, MachineUsageState as bn, listSegments as bo, MaintenanceRecord as br, ERROR_SOURCES as bs, listStatusCacheEntries as bt, HOSTED_LOGS_FIRST_BYTES as c, HostedMacosPlacement as ca, findEnclosingWorktreeRoot as cc, WarmRecord as ci, DevicePlacement as cn, runId as co, archiveEnabled as cr, workspaceAgentDeviceDir as cs, DeviceViewersRecord as ct, HostedLogsPage as d, parseHostedAgentAccess as da, getParkedMax as dc, lastUseFrom as di, EnvironmentDisk as dn, RECORDING_FOOTAGE_MS as do, readArchive as dr, workspaceEndedAgentsFile as ds, stimBuildDigest as dt, HOSTED_MACOS_APP_SLOTS as ea, DebugLog as ec, IDLE_STOP_KEY as ei, SOURCES as el, BuildPlatform as en, acceptsShape as eo, MacosProcess as er, setupJournalFile as es, readRunEstimates as et, hostedMacosLogsDir as f, parseHostedAgentGrant as fa, getProject as fc, parseMissReason as fi, EnvironmentState as fn, RECORDING_PLATFORMS as fo, readArchiveState as fr, workspaceEndedAgentsLock as fs, AgentSessionsCache as ft, readLogsSince as g, HOSTED_APP_CHUNK_BYTES as ga, isPathPrefix as gc, readDeviceIdleShutdowns as gi, MACHINE_OWNER_KINDS as gn, capDrops as go, MaintenanceCheck as gr, workspaceMetadataFile as gs, agentSessionOf as gt, readHostedNativeLogsCheckpoint as h, parseHostedMacosPlacement as ha, getRepoSettings as hc, readDevServerStopRequest as hi, LastBuildReport as hn, RecordingPlatform as ho, MaintenanceActionKind as hr, workspaceLogsDir as hs, StatusCacheEntry as ht, isSetupJournalPrunable as i, HostedAgentLease as ia, ParkedMax as ic, MetroLastStop as ii, readNdjsonGenerations as il, ChecksState as in, isSensitiveReference as io, readMacosRecord as ir, sharedPods as is, trimCapacityRefusals as it, readDeviceHostMachines as j, SETTINGS_SCHEMA_FILE as ja, StimConfig as jc, HostedDeviceRequest as ji, RunOutcomeKind as jn, configLockPath as jo, hostedIosStatus as jr, markerWindow as js, AGENT_TOOLS as jt, hostedMetroRequests as k, validHostedAppArguments as ka, RepoRecord as kc, HostedDevicePhase as ki, PlannedPhase as kn, buildMachinesFile as ko, hostedIosPlacements as kr, followLogs as ks, withGitChip as kt, HOSTED_LOGS_PAGE_BYTES as l, hostedMacosAppSlot as la, findProjectByMetroPort as lc, WorkspaceState as li, DiskMeasure as ln, validRunId as lo, archivedUsage as lr, workspaceBuildDetailFile as ls, ViewedDevice as lt, parseHostedLogsCursor as m, parseHostedMacosDevice as ma, getProjectSettings as mc, readDevServerStop as mi, GitChipPart as mn, RecordedSegment as mo, MaintenanceAction as mr, workspaceLogErrorIndex as ms, PullRequestCacheEntry as mt, SetupJournal as n, HostedAgentDriverName as na, debugLogDir as nc, LAST_BUILD_KEYS as ni, parseNdjsonLine as nl, BuildResult as nn, expectedShape as no, parseMacosRecord as nr, sharedCompilationCache as ns, readStatsReport as nt, readSetupJournal as o, HostedMacosChoice as oa, buildWorkerRoot as oc, WARM_KEY as oi, DeviceAppProcess as on, settingValueError as oo, ArchivedUsage as or, supervisorLogFile as os, trimSamples as ot, hostedNativeLogsDir as p, parseHostedMacosChoice as pa, getProjectSetting as pc, readBuildHistory as pi, GitChip as pn, RecordedDevice as po, readArchives as pr, workspaceGradleBuild as ps, ENDED_AGENT_RETENTION_MS as pt, StatsRecord as q, SettingScope as qa, readAgentDeviceUsage as qc, parseHostedOfferRequest as qi, WorkspaceStage as qn, maintenanceChildLogFile as qo, BUILD_HISTORY_LIMIT as qr, validEasSessionClaim as qs, BuildHistoryEntry as qt, isJournalExpired as r, HostedAgentGrant as ra, debugLoggingEnabled as rc, MAINTENANCE_LOG_NAME as ri, parseNdjsonText as rl, BuildWaitingFor as rn, isLayeredSetting as ro, readHostedMacosApp as rr, sharedGradle as rs, statsProjectKey as rt, agentDeviceStateDirs as s, HostedMacosDevice as sa, configCorruptRepair as sc, WORKSPACE_AGENT_KEY as si, DeviceLeaseState as sn, RUN_ID_ENV as so, ArchivedWorkspace as sr, supervisorPidFile as ss, wholePhases as st, SetupCapability as t, HostedAgentAccess as ta, createDebugLog as tc, IdleStopRecord as ti, levelRank as tl, BuildReport as tn, coerceSettingText as to, macosAppState as tr, sharedCcache as ts, readStats as tt, HostedLogsCursor as u, hostedMacosBundleId as ua, getConcurrencyLimits as uc, buildDiagnostics as ui, EndedAgentSession as un, RECORDING_CAP_BYTES as uo, linkReplacedArchives as ur, workspaceDerivedData as us, readViewedDevices as ut, TAILNET_MACHINE_PATTERN as v, HostedAppFile as va, withConfigLock as vc, readIdleStop as vi, MachineOwner as vn, footageDrops as vo, MaintenancePass as vr, workspaceStateFile as vs, diskUsageFailureFile as vt, HOSTED_METRO_GATEWAYS_KEY as w, parseHostedAppManifest as wa, Config as wc, HostedAndroidChoice as wi, NATIVE_BUILD_STEPS as wn, recordingEnabled as wo, parseMaintenanceState as wr, attachExpoErrorContext as ws, readDiskUsage as wt, findPeer as x, hostedAppArea as xa, requireAutomaticMachine as xc, readWorkspaceAgent as xi, MacosBuildPlanPayload as xn, openSegmentName as xo, MaintenanceSize as xr, NATIVE_CRASH_LOG_PREFIX as xs, pullRequestCacheFile as xt, TailnetPeer as y, HostedAppOffer as ya, AutomaticPoolRole as yc, readLastBuilds as yi, MachineOwnerKind as yn, listRecordedDevices as yo, MaintenancePressure as yr, workspaceStateLock as ys, endedAgentSessionOf as yt, RunEstimates as z, OffloadMode as za, saturation as zc, deviceHostRoot as zi, TUTORIAL_VERSION as zn, diskUsageWalkClaims as zo, hostedAndroidStatus as zr, tailRead as zs, AndroidRuntimeFacts as zt };

package/dist/oversight.d.mts

@@ -172,8 +172,14 @@ interface WorkspaceEntry {
   errorsAt: number | null;
   stuckAt: number | null;
   finished: boolean;
+  /** Whether this run already notified that the agent stopped; the workspace going idle ends the run. */
+  finishedInRun: boolean;
+  /** Whether the workspace was not idle at the last look, so the look that starts a new run is seen. */
+  running: boolean;
   /** Ids of the `attention` items already notified, so each notifies once per episode. */
   attention: string[];
+  /** Whether this run already raised an `attention` notification; it starts over when the workspace stops being idle or has no item left. */
+  attentionRaised: boolean;
   loops: {
     ios?: Loop;
     android?: Loop;

package/dist/oversight.mjs

@@ -283,10 +283,14 @@ function overseeStart(run, { env, entry, notify, driven }) {
 	entry.driveNotified = true;
 	event(run, notify("started", `${first.activity?.driver?.tool ?? "An agent"} started driving ${first.model} on ${run.input.machine}`, deviceTarget(env, first)));
 }
+/** Whether the workspace has no live session and is not warming: the end of a run, and the start of the next when it stops being idle. */
+function isIdle(env) {
+	return !env.live && (env.phase === void 0 || env.phase === "idle");
+}
 /** Work finishes when the agent stops after a green build; it looks stuck when nothing happens for too long. */
 function overseeProgress(run, { env, entry, notify, devices, driven }) {
 	const { now } = run;
-	const idle = !env.live && (env.phase === void 0 || env.phase === "idle");
+	const idle = isIdle(env);
 	const building = env.build?.state === "running";
 	const newest = newestBuild(env);
 	const green = newest?.status === "ok";
@@ -298,10 +302,13 @@ function overseeProgress(run, { env, entry, notify, devices, driven }) {
 		if (!idle && now < due) wake(run, due);
 		else {
 			entry.finished = true;
-			event(run, notify("finished", `Agent stopped after a green ${platformName(newest.platform)} build`, {
-				kind: "workspace",
-				path: env.path
-			}));
+			if (!entry.finishedInRun) {
+				entry.finishedInRun = true;
+				event(run, notify("finished", `Agent stopped after a green ${platformName(newest.platform)} build`, {
+					kind: "workspace",
+					path: env.path
+				}));
+			}
 		}
 	}
 	if (idle || entry.finished) {
@@ -311,6 +318,7 @@ function overseeProgress(run, { env, entry, notify, devices, driven }) {
 	if (idle) {
 		entry.warmed = false;
 		entry.finished = false;
+		entry.finishedInRun = false;
 	}
 	const device = driven[0] ?? devices.find((d) => d.running);
 	if (!entry.drove || !device?.running || building || quietSince === null || releasedGreen) return;
@@ -376,7 +384,10 @@ function overseeMerge(run, { env, entry, notify }, prev) {
 		}));
 	}
 }
-/** What only a person can fix, notified once per episode; what an agent handles is left out. */
+/**
+* What only a person can fix, notified once per episode and at most once per workspace per run; what an agent
+* handles is left out. The allowance returns when the workspace stops being idle or has no item left.
+*/
 function overseeAttention(run, { env, entry, notify }, prev) {
 	const items = workspaceItems(env, {
 		now: run.now,
@@ -384,6 +395,7 @@ function overseeAttention(run, { env, entry, notify }, prev) {
 		easSessionMinutes: EAS_SESSION_MINUTES,
 		ownLeases: run.input.ownLeases
 	});
+	const pending = [];
 	for (const item of items) {
 		if (item.category !== "attention") continue;
 		let target = {
@@ -399,12 +411,29 @@ function overseeAttention(run, { env, entry, notify }, prev) {
 				platform
 			};
 		}
+		pending.push({
+			item,
+			target
+		});
+	}
+	let raised = entry.attentionRaised;
+	if (pending.length === 0 || !isIdle(env) && !prev?.running) raised = false;
+	for (const { item, target } of pending) {
+		if (prev?.attention?.includes(item.id) || raised) {
+			entry.attention.push(item.id);
+			continue;
+		}
 		const notification = {
 			...notify("attention", item.body, target),
 			id: item.id
 		};
-		if (prev?.attention?.includes(item.id) || lasting(run, notification)) entry.attention.push(item.id);
+		const sent = run.notifications.length;
+		if (lasting(run, notification)) {
+			entry.attention.push(item.id);
+			if (run.notifications.length > sent) raised = true;
+		}
 	}
+	entry.attentionRaised = raised;
 }
 function overseeWorkspace(run, env, status, prev) {
 	const errors = env.logs?.errorsSinceMarker ?? 0;
@@ -419,7 +448,10 @@ function overseeWorkspace(run, env, status, prev) {
 		errorsAt: prev && prev.errors !== errors ? run.now : prev?.errorsAt ?? null,
 		stuckAt: prev?.stuckAt ?? null,
 		finished: prev?.finished ?? false,
+		finishedInRun: prev?.finishedInRun ?? false,
+		running: !isIdle(env),
 		attention: [],
+		attentionRaised: prev?.attentionRaised ?? false,
 		loops: {},
 		pr: prev?.pr,
 		mergedInto: git ? git.mergedInto : prev?.mergedInto ?? null,

package/dist/phone-protocol.d.mts

@@ -1,5 +1,5 @@
-import { Bn as WebBrowserState, En as RemoteDeviceState, Ft as AndroidDeviceState, Gn as WorktreeGit, Ht as BuildDetail, Kn as WorktreePullRequest, Kt as BuildMissChange, Mn as StatusIssue, Nt as AgentSession, Pn as StatusPayload, Qt as BuildReport, Un as WorkspaceStage, Ut as BuildDiagnostic, Wn as WorktreeFacts, Wt as BuildHistoryEntry, Xt as BuildPlanPayload, Yn as MacosBuild, Yt as BuildPlacement, _n as MachineUsageState, cn as EnvironmentDisk, en as BuildWaitingFor, fn as LastBuildReport, hn as MachineOwner, hr as MaintenancePressure, in as DeviceLeaseState, kn as SimulatorState, ln as EnvironmentState, mr as MaintenancePass, nn as DeviceActivity, on as DiskMeasure, qn as MacosAppRecord, qt as BuildMissReason, ra as HostedMacosPlacement, rn as DeviceAppProcess, rr as ArchivedWorkspace, un as GitChip, ur as MaintenanceAction, wn as PhysicalDeviceState, yn as MetroBundleState, yr as MaintenanceStatus } from "./index-lRdEfJSb.mjs";
-import { $n as UsageHistory, An as ReplaySpan, Dn as ReplayKeyframeParams, En as ReplayKeyframe, F as ControlBeginResult, Ft as LogsEndedEvent, G as DevicePosture, Gn as SimulatorCommand, Gt as MachineUsage, H as DeviceFrameArtwork, Ht as MachineHistory, In as ServerEvent, It as LogsEvent, Jn as StatusEvent, Jt as MacosWindowsEvent, K as DeviceUsageSeries, Kn as SimulatorOptions, Kt as MachineVolume, L as ControlEndedEvent, Lt as LogsQueryResult, Mt as LogLevel, Nn as RotateDirection, Nt as LogRecord, On as ReplayMarker, P as ControlBeginParams, Pn as SERVER_UPDATE_METHODS, Pt as LogSource, Tn as ReplayEndedEvent, Tt as KeyModifier, U as DeviceFrameEvent, V as DeviceAuth, Vt as MachineDetails, X as ErrorEvent, Zn as TouchPhase, Zt as Methods, a as ArchiveDetailParams, bt as InputSimulatorParams, ct as HelloParams, dr as WorkspaceFile, en as NotificationEntry, er as UsageSample, fn as PairingAuth, fr as WorkspaceFiles, gn as PushRegisterParams, hn as PushEvent, ht as InputKey, i as ActionResult, jn as ReplayTarget, jt as LogFilter, kn as ReplayRange, ln as PROTOCOL_VERSION, lt as HelloResult, mn as ProtocolError, mr as WorkspacePatch, n as ActionName, nn as NotificationLevel, nt as FrameEvent, on as NotificationsListResult, p as BuildClientSummary, pn as Platform, pt as InputButton, r as ActionParams, rn as NotificationSuppression, rt as FrameTarget, s as BUILD_METHODS, st as FramesSubscribeResult, t as ACTIONS, tn as NotificationEvent, tt as FrameDelayedEvent, ur as WorkspaceDiff, v as BuildMachineReport, w as BuildProgressEvent, x as BuildPlanParams, z as DEVICE_HOST_METHODS } from "./protocol-DcI3hDw9.mjs";
+import { $n as MacosBuild, $t as BuildPlanPayload, An as RemoteDeviceState, Cn as MetroBundleState, Cr as MaintenanceStatus, Gt as BuildDetail, In as StatusIssue, It as AgentSession, Jn as WorktreeFacts, Kt as BuildDiagnostic, Nn as SimulatorState, On as PhysicalDeviceState, Qt as BuildPlacement, Rn as StatusPayload, Rt as AndroidDeviceState, Wn as WebBrowserState, Xn as WorktreePullRequest, Xt as BuildMissReason, Yn as WorktreeGit, Yt as BuildMissChange, Zn as MacosAppRecord, an as DeviceActivity, bn as MachineUsageState, ca as HostedMacosPlacement, dn as EnvironmentDisk, fn as EnvironmentState, hn as LastBuildReport, ln as DiskMeasure, mr as MaintenanceAction, on as DeviceAppProcess, pn as GitChip, qn as WorkspaceStage, qt as BuildHistoryEntry, rn as BuildWaitingFor, sn as DeviceLeaseState, sr as ArchivedWorkspace, tn as BuildReport, vn as MachineOwner, vr as MaintenancePass, yr as MaintenancePressure } from "./index-BITArGWH.mjs";
+import { An as ReplayRange, B as DEVICE_HOST_METHODS, Dn as ReplayKeyframe, En as ReplayEndedEvent, Et as KeyModifier, F as ControlBeginParams, Fn as SERVER_UPDATE_METHODS, Ft as LogSource, H as DeviceAuth, Ht as MachineDetails, I as ControlBeginResult, It as LogsEndedEvent, K as DevicePosture, Kn as SimulatorCommand, Kt as MachineUsage, Ln as ServerEvent, Lt as LogsEvent, Mn as ReplayTarget, Mt as LogFilter, Nt as LogLevel, On as ReplayKeyframeParams, Pn as RotateDirection, Pt as LogRecord, Qn as TouchPhase, Qt as Methods, R as ControlEndedEvent, Rt as LogsQueryResult, S as BuildPlanParams, T as BuildProgressEvent, U as DeviceFrameArtwork, Ut as MachineHistory, W as DeviceFrameEvent, Yn as StatusEvent, Yt as MacosWindowsEvent, Z as ErrorEvent, _n as PushRegisterParams, a as ArchiveDetailParams, ct as FramesSubscribeResult, dr as WorkspaceDiff, er as UsageHistory, fr as WorkspaceFile, gn as PushEvent, gt as InputKey, hn as ProtocolError, hr as WorkspacePatch, i as ActionResult, in as NotificationSuppression, it as FrameTarget, jn as ReplaySpan, kn as ReplayMarker, lt as HelloParams, m as BuildClientSummary, mn as Platform, mt as InputButton, n as ActionName, nn as NotificationEvent, nt as FrameDelayedEvent, pn as PairingAuth, pr as WorkspaceFiles, q as DeviceUsageSeries, qn as SimulatorOptions, qt as MachineVolume, r as ActionParams, rn as NotificationLevel, rt as FrameEvent, s as BUILD_METHODS, sn as NotificationsListResult, t as ACTIONS, tn as NotificationEntry, tr as UsageSample, un as PROTOCOL_VERSION, ut as HelloResult, xt as InputSimulatorParams, y as BuildMachineReport } from "./protocol-CXPbHten.mjs";
 //#region phone-protocol.d.ts
 type PhonePlatform = BuildPlanParams["platform"];
 type PhoneDevicePlatform = Platform;
@@ -213,15 +213,22 @@ type PhoneLastBuild = Omit<LastBuildReport, "platform" | "status" | "cacheHit" |
 };
 type PhoneBuildDiagnostic = BuildDiagnostic;
 type PhoneDeviceLeaseState = DeviceLeaseState;
-type PhoneMaintenanceStatus = Omit<MaintenanceStatus, "mode" | "lastPass" | "plan" | "pressure" | "sizes" | "recent"> & {
+type PhoneMaintenanceStatus = Omit<MaintenanceStatus, "mode" | "lastPass" | "plan" | "pressure" | "sizes" | "recent" | "lastChecks"> & {
   mode: string;
+  lastChecks: {
+    pressure: number | null;
+    size: number | null;
+    worktree?: number | null;
+    sweep?: number | null;
+  };
   lastPass: (Omit<MaintenancePass, "mode" | "freedBytes" | "stopped"> & {
     mode: string;
     freedBytes: number;
     stopped: number;
   }) | null;
-  plan: (Omit<MaintenanceAction, "kind"> & {
+  plan: (Omit<MaintenanceAction, "kind" | "check"> & {
     kind: string;
+    check?: string;
   })[];
   pressure: (Omit<MaintenancePressure, "memory"> & {
     memory: Omit<MaintenancePressure["memory"], "level"> & {

package/dist/{protocol-DcI3hDw9.d.mts → protocol-CXPbHten.d.mts}

@@ -1,4 +1,4 @@
-import { Ci as HostedDeviceOfferRequest, Ei as HostedDeviceRequest, Fc as NdjsonRecord, Oi as HostedDeviceSession, Pn as StatusPayload, Si as HostedDeviceOffer, Ti as HostedDevicePlatform, Wt as BuildHistoryEntry, Xt as BuildPlanPayload, d as HostedLogsPage, ea as HostedAppLaunch, fa as HostedAppDelivery, ma as HostedAppOffer, u as HostedLogsCursor, wi as HostedDevicePhase } from "./index-lRdEfJSb.mjs";
+import { $c as NdjsonRecord, $t as BuildPlanPayload, Ai as HostedDevicePlatform, Di as HostedDeviceOffer, Ni as HostedDeviceSession, Oi as HostedDeviceOfferRequest, Rn as StatusPayload, _a as HostedAppDelivery, aa as HostedAppLaunch, d as HostedLogsPage, ji as HostedDeviceRequest, ki as HostedDevicePhase, qt as BuildHistoryEntry, u as HostedLogsCursor, ya as HostedAppOffer } from "./index-BITArGWH.mjs";
 //#region protocol.d.ts
 declare const PROTOCOL_VERSION = 1;
 declare const PROTOCOL_SCHEMA_FILE = "protocol.schema.json";
@@ -76,9 +76,11 @@ interface DeviceHostRequestAuth {
 }
 interface HelloParams {
   protocol: number;
+  /** `runId` is the CLI invocation's id: letters, digits, `.`, `_`, `-`, at most 64. The server puts it on its log lines for the connection. */
   client: {
     name: string;
     version: string;
+    runId?: string;
   };
   auth: PairingAuth | DeviceAuth | BuildRequestAuth | DeviceHostRequestAuth;
 }
@@ -123,7 +125,7 @@ interface SubscribeResult {
 interface UnsubscribeParams {
   subscription: string;
 }
-declare const LOG_SOURCES: readonly ["metro", "client", "device", "build", "agent", "maintenance"];
+declare const LOG_SOURCES: readonly ["metro", "client", "device", "build", "agent", "maintenance", "placement"];
 type LogSource = (typeof LOG_SOURCES)[number];
 declare const LOG_LEVELS: readonly ["debug", "info", "warn", "error", "fatal"];
 type LogLevel = (typeof LOG_LEVELS)[number];
@@ -495,11 +497,15 @@ interface BuildPlanParams {
 type BuildPlanResult = BuildPlanPayload;
 /** A client's repository on a remote Mac: letters, digits, `.`, `_` and `-`, at most 80. */
 declare const BUILD_REPO_PATTERN = "^[A-Za-z0-9][A-Za-z0-9._-]{0,79}$";
+/** A version-manager Ruby installation name, without path separators. */
+declare const BUILD_RUBY_VERSION_PATTERN = "^(?!\\.{1,2}$)[^/\\\\\\u0000\\r\\n]+$";
 /** Asks a remote Mac what it can build, how busy it is, and how warm its copy of `repo` is. */
 interface BuildOfferParams {
   repo: string;
   /** sha256 of the repository's lockfile, compared with the one the machine last installed from. */
   lockfile?: string;
+  /** The project's normalized .ruby-version; absent uses the worker's default Ruby. */
+  rubyVersion?: string;
 }
 /** The toolchain a build must match exactly on both Macs. */
 interface BuildToolchain {
@@ -523,8 +529,8 @@ interface BuildToolchain {
 /**
  * How busy the remote Mac is. `running` counts offloaded builds and `max` is how many it runs at once.
  * `cpus`, `loadPerCore` (5-minute load average per CPU), `builds` (its own Stim native builds plus the offloaded
- * ones), `maxBuilds` (its `concurrency.maxBuilds`, 0 when unlimited) and `maxLoadPerCore` are absent from a
- * stim-server older than them. `declined` is why it would refuse a build now, null when it would take one.
+ * ones), `maxBuilds` (its `concurrency.maxBuilds`, 0 when unlimited), `maxLoadPerCore`, `memoryUsedBytes`
+ * (Activity Monitor's Memory Used) and `memoryTotalBytes` are absent from a stim-server older than them. `declined` is why it would refuse a build now, null when it would take one.
  */
 interface BuildCapacity {
   running: number;
@@ -536,6 +542,8 @@ interface BuildCapacity {
   builds?: number;
   maxBuilds?: number;
   maxLoadPerCore?: number;
+  memoryUsedBytes?: number;
+  memoryTotalBytes?: number;
   declined?: string | null;
 }
 interface BuildOfferResult {
@@ -755,6 +763,8 @@ interface BuildMachineCapacity {
   builds?: number;
   maxBuilds?: number;
   maxLoadPerCore?: number;
+  memoryUsedBytes?: number;
+  memoryTotalBytes?: number;
   declined?: string | null;
 }
 /**
@@ -1511,4 +1521,4 @@ type ServeRoute = {
   port: number;
 };
 //#endregion
-export { FRAME_FPS as $, UsageHistory as $n, NOTIFICATION_SUPPRESSIONS as $t, CAPABILITIES as A, ReplaySpan as An, LegacyPushEvent as At, DEVICE_POSTURES as B, ServerUpdatePackage as Bn, METHODS as Bt, BuildPlatform as C, RecordingSetResult as Cn, InputWindowParams as Ct, BuildSyncParams as D, ReplayKeyframeParams as Dn, LEGACY_PUSH_EVENTS as Dt, BuildStartParams as E, ReplayKeyframe as En, KeyframeParams as Et, ControlBeginResult as F, ServeRoute as Fn, LogsEndedEvent as Ft, DevicePosture as G, SimulatorCommand as Gn, MachineUsage as Gt, DeviceFrameArtwork as H, ServerUpdateStartParams as Hn, MachineHistory as Ht, ControlEndParams as I, ServerEvent as In, LogsEvent as It, ERROR_CODES as J, StatusEvent as Jn, MacosWindowsEvent as Jt, DeviceUsageSeries as K, SimulatorOptions as Kn, MachineVolume as Kt, ControlEndedEvent as L, ServerMessage as Ln, LogsQueryResult as Lt, Capability as M, RequestId as Mn, LogLevel as Mt, ClientRequest as N, RotateDirection as Nn, LogRecord as Nt, BuildSyncResult as O, ReplayMarker as On, LOG_LEVELS as Ot, ControlBeginParams as P, SERVER_UPDATE_METHODS as Pn, LogSource as Pt, FRAME_EDGE as Q, UnsubscribeParams as Qn, NOTIFICATION_LEVELS as Qt, ControlPlatform as R, ServerResponse as Rn, MAX_INPUT_TEXT as Rt, BuildPlanResult as S, RecordingSetParams as Sn, InputTouchParams as St, BuildRequestAuth as T, ReplayEndedEvent as Tn, KeyModifier as Tt, DeviceFrameEvent as U, ServerUpdateStatus as Un, MachineHistoryParams as Ut, DeviceAuth as V, ServerUpdateProgress as Vn, MachineDetails as Vt, DeviceHostRequestAuth as W, SettingsResult as Wn, MachineUpdateStatus as Wt, ErrorEvent as X, TOUCH_PHASES as Xn, Method as Xt, ErrorCode as Y, SubscribeResult as Yn, MemoryPressure as Yt, FEATURES as Z, TouchPhase as Zn, Methods as Zt, BuildMachineCapacity as _, QuietHours as _n, InputPostureParams as _t, ArchiveDetailParams as a, NotificationsListParams as an, VIDEO_HEADER_VERSION as ar, FramesSeekParams as at, BuildOfferResult as b, REPLAY_RATES as bn, InputSimulatorParams as bt, BUILD_REPO_PATTERN as c, PROTOCOL_SCHEMA_FILE as cn, VideoCodec as cr, HelloParams as ct, BuildAttachResult as d, PUSH_TOKEN_PATTERN as dn, WorkspaceFile as dr, INPUT_BUTTONS as dt, NotificationEntry as en, UsageSample as er, Feature as et, BuildCapacity as f, PairingAuth as fn, WorkspaceFiles as fr, INPUT_KEYS as ft, BuildJobParams as g, PushRegisterParams as gn, InputKeyParams as gt, BuildJobOutcome as h, PushEvent as hn, InputKey as ht, ActionResult as i, NotificationTarget as in, VIDEO_FOLDED as ir, FramesLiveParams as it, CONTROL_END_REASONS as j, ReplayTarget as jn, LogFilter as jt, BuildToolchain as k, ReplayRange as kn, LOG_SOURCES as kt, BuildAndroidOptions as l, PROTOCOL_VERSION as ln, VideoPacket as lr, HelloResult as lt, BuildFile as m, ProtocolError as mn, WorkspacePatch as mr, InputButtonParams as mt, ActionName as n, NotificationLevel as nn, VIDEO_ARTWORK as nr, FrameEvent as nt, ArchiveDetailResult as o, NotificationsListResult as on, VIDEO_KEYFRAME as or, FramesSeekResult as ot, BuildClientSummary as p, Platform as pn, WorkspaceParams as pr, InputButton as pt, DuoFramePose as q, StatsResult as qn, MacosWindow as qt, ActionParams as r, NotificationSuppression as rn, VIDEO_CODECS as rr, FrameTarget as rt, BUILD_METHODS as s, PLATFORMS as sn, VIDEO_UNFOLDED as sr, FramesSubscribeResult as st, ACTIONS as t, NotificationEvent as tn, UsageSeries as tr, FrameDelayedEvent as tt, BuildArtifactResult as u, PUSH_EVENTS as un, WorkspaceDiff as ur, HostedSessionRow as ut, BuildMachineReport as v, RELOAD_PLATFORMS as vn, InputRotateParams as vt, BuildProgressEvent as w, ReloadPlatform as wn, KEY_MODIFIERS as wt, BuildPlanParams as x, ROTATE_DIRECTIONS as xn, InputTextParams as xt, BuildOfferParams as y, REPLAY_MARKER_KINDS as yn, InputScrollParams as yt, DEVICE_HOST_METHODS as z, ServerUpdateOutcome as zn, MAX_LOG_TAIL as zt };
+export { FRAME_EDGE as $, UnsubscribeParams as $n, NOTIFICATION_LEVELS as $t, BuildToolchain as A, ReplayRange as An, LOG_SOURCES as At, DEVICE_HOST_METHODS as B, ServerUpdateOutcome as Bn, MAX_LOG_TAIL as Bt, BuildPlanResult as C, RecordingSetParams as Cn, InputTouchParams as Ct, BuildStartParams as D, ReplayKeyframe as Dn, KeyframeParams as Dt, BuildRequestAuth as E, ReplayEndedEvent as En, KeyModifier as Et, ControlBeginParams as F, SERVER_UPDATE_METHODS as Fn, LogSource as Ft, DeviceHostRequestAuth as G, SettingsResult as Gn, MachineUpdateStatus as Gt, DeviceAuth as H, ServerUpdateProgress as Hn, MachineDetails as Ht, ControlBeginResult as I, ServeRoute as In, LogsEndedEvent as It, DuoFramePose as J, StatsResult as Jn, MacosWindow as Jt, DevicePosture as K, SimulatorCommand as Kn, MachineUsage as Kt, ControlEndParams as L, ServerEvent as Ln, LogsEvent as Lt, CONTROL_END_REASONS as M, ReplayTarget as Mn, LogFilter as Mt, Capability as N, RequestId as Nn, LogLevel as Nt, BuildSyncParams as O, ReplayKeyframeParams as On, LEGACY_PUSH_EVENTS as Ot, ClientRequest as P, RotateDirection as Pn, LogRecord as Pt, FEATURES as Q, TouchPhase as Qn, Methods as Qt, ControlEndedEvent as R, ServerMessage as Rn, LogsQueryResult as Rt, BuildPlanParams as S, ROTATE_DIRECTIONS as Sn, InputTextParams as St, BuildProgressEvent as T, ReloadPlatform as Tn, KEY_MODIFIERS as Tt, DeviceFrameArtwork as U, ServerUpdateStartParams as Un, MachineHistory as Ut, DEVICE_POSTURES as V, ServerUpdatePackage as Vn, METHODS as Vt, DeviceFrameEvent as W, ServerUpdateStatus as Wn, MachineHistoryParams as Wt, ErrorCode as X, SubscribeResult as Xn, MemoryPressure as Xt, ERROR_CODES as Y, StatusEvent as Yn, MacosWindowsEvent as Yt, ErrorEvent as Z, TOUCH_PHASES as Zn, Method as Zt, BuildJobParams as _, PushRegisterParams as _n, InputKeyParams as _t, ArchiveDetailParams as a, NotificationTarget as an, VIDEO_FOLDED as ar, FramesLiveParams as at, BuildOfferParams as b, REPLAY_MARKER_KINDS as bn, InputScrollParams as bt, BUILD_REPO_PATTERN as c, PLATFORMS as cn, VIDEO_UNFOLDED as cr, FramesSubscribeResult as ct, BuildArtifactResult as d, PUSH_EVENTS as dn, WorkspaceDiff as dr, HostedSessionRow as dt, NOTIFICATION_SUPPRESSIONS as en, UsageHistory as er, FRAME_FPS as et, BuildAttachResult as f, PUSH_TOKEN_PATTERN as fn, WorkspaceFile as fr, INPUT_BUTTONS as ft, BuildJobOutcome as g, PushEvent as gn, InputKey as gt, BuildFile as h, ProtocolError as hn, WorkspacePatch as hr, InputButtonParams as ht, ActionResult as i, NotificationSuppression as in, VIDEO_CODECS as ir, FrameTarget as it, CAPABILITIES as j, ReplaySpan as jn, LegacyPushEvent as jt, BuildSyncResult as k, ReplayMarker as kn, LOG_LEVELS as kt, BUILD_RUBY_VERSION_PATTERN as l, PROTOCOL_SCHEMA_FILE as ln, VideoCodec as lr, HelloParams as lt, BuildClientSummary as m, Platform as mn, WorkspaceParams as mr, InputButton as mt, ActionName as n, NotificationEvent as nn, UsageSeries as nr, FrameDelayedEvent as nt, ArchiveDetailResult as o, NotificationsListParams as on, VIDEO_HEADER_VERSION as or, FramesSeekParams as ot, BuildCapacity as p, PairingAuth as pn, WorkspaceFiles as pr, INPUT_KEYS as pt, DeviceUsageSeries as q, SimulatorOptions as qn, MachineVolume as qt, ActionParams as r, NotificationLevel as rn, VIDEO_ARTWORK as rr, FrameEvent as rt, BUILD_METHODS as s, NotificationsListResult as sn, VIDEO_KEYFRAME as sr, FramesSeekResult as st, ACTIONS as t, NotificationEntry as tn, UsageSample as tr, Feature as tt, BuildAndroidOptions as u, PROTOCOL_VERSION as un, VideoPacket as ur, HelloResult as ut, BuildMachineCapacity as v, QuietHours as vn, InputPostureParams as vt, BuildPlatform as w, RecordingSetResult as wn, InputWindowParams as wt, BuildOfferResult as x, REPLAY_RATES as xn, InputSimulatorParams as xt, BuildMachineReport as y, RELOAD_PLATFORMS as yn, InputRotateParams as yt, ControlPlatform as z, ServerResponse as zn, MAX_INPUT_TEXT as zt };

package/dist/protocol.d.mts

@@ -1,2 +1,2 @@
-import { $ as FRAME_FPS, $n as UsageHistory, $t as NOTIFICATION_SUPPRESSIONS, A as CAPABILITIES, An as ReplaySpan, At as LegacyPushEvent, B as DEVICE_POSTURES, Bn as ServerUpdatePackage, Bt as METHODS, C as BuildPlatform, Cn as RecordingSetResult, Ct as InputWindowParams, D as BuildSyncParams, Dn as ReplayKeyframeParams, Dt as LEGACY_PUSH_EVENTS, E as BuildStartParams, En as ReplayKeyframe, Et as KeyframeParams, F as ControlBeginResult, Fn as ServeRoute, Ft as LogsEndedEvent, G as DevicePosture, Gn as SimulatorCommand, Gt as MachineUsage, H as DeviceFrameArtwork, Hn as ServerUpdateStartParams, Ht as MachineHistory, I as ControlEndParams, In as ServerEvent, It as LogsEvent, J as ERROR_CODES, Jn as StatusEvent, Jt as MacosWindowsEvent, K as DeviceUsageSeries, Kn as SimulatorOptions, Kt as MachineVolume, L as ControlEndedEvent, Ln as ServerMessage, Lt as LogsQueryResult, M as Capability, Mn as RequestId, Mt as LogLevel, N as ClientRequest, Nn as RotateDirection, Nt as LogRecord, O as BuildSyncResult, On as ReplayMarker, Ot as LOG_LEVELS, P as ControlBeginParams, Pn as SERVER_UPDATE_METHODS, Pt as LogSource, Q as FRAME_EDGE, Qn as UnsubscribeParams, Qt as NOTIFICATION_LEVELS, R as ControlPlatform, Rn as ServerResponse, Rt as MAX_INPUT_TEXT, S as BuildPlanResult, Sn as RecordingSetParams, St as InputTouchParams, T as BuildRequestAuth, Tn as ReplayEndedEvent, Tt as KeyModifier, U as DeviceFrameEvent, Un as ServerUpdateStatus, Ut as MachineHistoryParams, V as DeviceAuth, Vn as ServerUpdateProgress, Vt as MachineDetails, W as DeviceHostRequestAuth, Wn as SettingsResult, Wt as MachineUpdateStatus, X as ErrorEvent, Xn as TOUCH_PHASES, Xt as Method, Y as ErrorCode, Yn as SubscribeResult, Yt as MemoryPressure, Z as FEATURES, Zn as TouchPhase, Zt as Methods, _ as BuildMachineCapacity, _n as QuietHours, _t as InputPostureParams, a as ArchiveDetailParams, an as NotificationsListParams, ar as VIDEO_HEADER_VERSION, at as FramesSeekParams, b as BuildOfferResult, bn as REPLAY_RATES, bt as InputSimulatorParams, c as BUILD_REPO_PATTERN, cn as PROTOCOL_SCHEMA_FILE, cr as VideoCodec, ct as HelloParams, d as BuildAttachResult, dn as PUSH_TOKEN_PATTERN, dr as WorkspaceFile, dt as INPUT_BUTTONS, en as NotificationEntry, er as UsageSample, et as Feature, f as BuildCapacity, fn as PairingAuth, fr as WorkspaceFiles, ft as INPUT_KEYS, g as BuildJobParams, gn as PushRegisterParams, gt as InputKeyParams, h as BuildJobOutcome, hn as PushEvent, ht as InputKey, i as ActionResult, in as NotificationTarget, ir as VIDEO_FOLDED, it as FramesLiveParams, j as CONTROL_END_REASONS, jn as ReplayTarget, jt as LogFilter, k as BuildToolchain, kn as ReplayRange, kt as LOG_SOURCES, l as BuildAndroidOptions, ln as PROTOCOL_VERSION, lr as VideoPacket, lt as HelloResult, m as BuildFile, mn as ProtocolError, mr as WorkspacePatch, mt as InputButtonParams, n as ActionName, nn as NotificationLevel, nr as VIDEO_ARTWORK, nt as FrameEvent, o as ArchiveDetailResult, on as NotificationsListResult, or as VIDEO_KEYFRAME, ot as FramesSeekResult, p as BuildClientSummary, pn as Platform, pr as WorkspaceParams, pt as InputButton, q as DuoFramePose, qn as StatsResult, qt as MacosWindow, r as ActionParams, rn as NotificationSuppression, rr as VIDEO_CODECS, rt as FrameTarget, s as BUILD_METHODS, sn as PLATFORMS, sr as VIDEO_UNFOLDED, st as FramesSubscribeResult, t as ACTIONS, tn as NotificationEvent, tr as UsageSeries, tt as FrameDelayedEvent, u as BuildArtifactResult, un as PUSH_EVENTS, ur as WorkspaceDiff, ut as HostedSessionRow, v as BuildMachineReport, vn as RELOAD_PLATFORMS, vt as InputRotateParams, w as BuildProgressEvent, wn as ReloadPlatform, wt as KEY_MODIFIERS, x as BuildPlanParams, xn as ROTATE_DIRECTIONS, xt as InputTextParams, y as BuildOfferParams, yn as REPLAY_MARKER_KINDS, yt as InputScrollParams, z as DEVICE_HOST_METHODS, zn as ServerUpdateOutcome, zt as MAX_LOG_TAIL } from "./protocol-DcI3hDw9.mjs";
-export { ACTIONS, ActionName, ActionParams, ActionResult, ArchiveDetailParams, ArchiveDetailResult, BUILD_METHODS, BUILD_REPO_PATTERN, BuildAndroidOptions, BuildArtifactResult, BuildAttachResult, BuildCapacity, BuildClientSummary, BuildFile, BuildJobOutcome, BuildJobParams, BuildMachineCapacity, BuildMachineReport, BuildOfferParams, BuildOfferResult, BuildPlanParams, BuildPlanResult, BuildPlatform, BuildProgressEvent, BuildRequestAuth, BuildStartParams, BuildSyncParams, BuildSyncResult, BuildToolchain, CAPABILITIES, CONTROL_END_REASONS, Capability, ClientRequest, ControlBeginParams, ControlBeginResult, ControlEndParams, ControlEndedEvent, ControlPlatform, DEVICE_HOST_METHODS, DEVICE_POSTURES, DeviceAuth, DeviceFrameArtwork, DeviceFrameEvent, DeviceHostRequestAuth, DevicePosture, DeviceUsageSeries, DuoFramePose, ERROR_CODES, ErrorCode, ErrorEvent, FEATURES, FRAME_EDGE, FRAME_FPS, Feature, FrameDelayedEvent, FrameEvent, FrameTarget, FramesLiveParams, FramesSeekParams, FramesSeekResult, FramesSubscribeResult, HelloParams, HelloResult, HostedSessionRow, INPUT_BUTTONS, INPUT_KEYS, InputButton, InputButtonParams, InputKey, InputKeyParams, InputPostureParams, InputRotateParams, InputScrollParams, InputSimulatorParams, InputTextParams, InputTouchParams, InputWindowParams, KEY_MODIFIERS, KeyModifier, KeyframeParams, LEGACY_PUSH_EVENTS, LOG_LEVELS, LOG_SOURCES, LegacyPushEvent, LogFilter, LogLevel, LogRecord, LogSource, LogsEndedEvent, LogsEvent, LogsQueryResult, MAX_INPUT_TEXT, MAX_LOG_TAIL, METHODS, MachineDetails, MachineHistory, MachineHistoryParams, MachineUpdateStatus, MachineUsage, MachineVolume, MacosWindow, MacosWindowsEvent, MemoryPressure, Method, Methods, NOTIFICATION_LEVELS, NOTIFICATION_SUPPRESSIONS, NotificationEntry, NotificationEvent, NotificationLevel, NotificationSuppression, NotificationTarget, NotificationsListParams, NotificationsListResult, PLATFORMS, PROTOCOL_SCHEMA_FILE, PROTOCOL_VERSION, PUSH_EVENTS, PUSH_TOKEN_PATTERN, PairingAuth, Platform, ProtocolError, PushEvent, PushRegisterParams, QuietHours, RELOAD_PLATFORMS, REPLAY_MARKER_KINDS, REPLAY_RATES, ROTATE_DIRECTIONS, RecordingSetParams, RecordingSetResult, ReloadPlatform, ReplayEndedEvent, ReplayKeyframe, ReplayKeyframeParams, ReplayMarker, ReplayRange, ReplaySpan, ReplayTarget, RequestId, RotateDirection, SERVER_UPDATE_METHODS, ServeRoute, ServerEvent, ServerMessage, ServerResponse, ServerUpdateOutcome, ServerUpdatePackage, ServerUpdateProgress, ServerUpdateStartParams, ServerUpdateStatus, SettingsResult, SimulatorCommand, SimulatorOptions, StatsResult, StatusEvent, SubscribeResult, TOUCH_PHASES, TouchPhase, UnsubscribeParams, UsageHistory, UsageSample, UsageSeries, VIDEO_ARTWORK, VIDEO_CODECS, VIDEO_FOLDED, VIDEO_HEADER_VERSION, VIDEO_KEYFRAME, VIDEO_UNFOLDED, VideoCodec, VideoPacket, WorkspaceDiff, WorkspaceFile, WorkspaceFiles, WorkspaceParams, WorkspacePatch };
+import { $ as FRAME_EDGE, $n as UnsubscribeParams, $t as NOTIFICATION_LEVELS, A as BuildToolchain, An as ReplayRange, At as LOG_SOURCES, B as DEVICE_HOST_METHODS, Bn as ServerUpdateOutcome, Bt as MAX_LOG_TAIL, C as BuildPlanResult, Cn as RecordingSetParams, Ct as InputTouchParams, D as BuildStartParams, Dn as ReplayKeyframe, Dt as KeyframeParams, E as BuildRequestAuth, En as ReplayEndedEvent, Et as KeyModifier, F as ControlBeginParams, Fn as SERVER_UPDATE_METHODS, Ft as LogSource, G as DeviceHostRequestAuth, Gn as SettingsResult, Gt as MachineUpdateStatus, H as DeviceAuth, Hn as ServerUpdateProgress, Ht as MachineDetails, I as ControlBeginResult, In as ServeRoute, It as LogsEndedEvent, J as DuoFramePose, Jn as StatsResult, Jt as MacosWindow, K as DevicePosture, Kn as SimulatorCommand, Kt as MachineUsage, L as ControlEndParams, Ln as ServerEvent, Lt as LogsEvent, M as CONTROL_END_REASONS, Mn as ReplayTarget, Mt as LogFilter, N as Capability, Nn as RequestId, Nt as LogLevel, O as BuildSyncParams, On as ReplayKeyframeParams, Ot as LEGACY_PUSH_EVENTS, P as ClientRequest, Pn as RotateDirection, Pt as LogRecord, Q as FEATURES, Qn as TouchPhase, Qt as Methods, R as ControlEndedEvent, Rn as ServerMessage, Rt as LogsQueryResult, S as BuildPlanParams, Sn as ROTATE_DIRECTIONS, St as InputTextParams, T as BuildProgressEvent, Tn as ReloadPlatform, Tt as KEY_MODIFIERS, U as DeviceFrameArtwork, Un as ServerUpdateStartParams, Ut as MachineHistory, V as DEVICE_POSTURES, Vn as ServerUpdatePackage, Vt as METHODS, W as DeviceFrameEvent, Wn as ServerUpdateStatus, Wt as MachineHistoryParams, X as ErrorCode, Xn as SubscribeResult, Xt as MemoryPressure, Y as ERROR_CODES, Yn as StatusEvent, Yt as MacosWindowsEvent, Z as ErrorEvent, Zn as TOUCH_PHASES, Zt as Method, _ as BuildJobParams, _n as PushRegisterParams, _t as InputKeyParams, a as ArchiveDetailParams, an as NotificationTarget, ar as VIDEO_FOLDED, at as FramesLiveParams, b as BuildOfferParams, bn as REPLAY_MARKER_KINDS, bt as InputScrollParams, c as BUILD_REPO_PATTERN, cn as PLATFORMS, cr as VIDEO_UNFOLDED, ct as FramesSubscribeResult, d as BuildArtifactResult, dn as PUSH_EVENTS, dr as WorkspaceDiff, dt as HostedSessionRow, en as NOTIFICATION_SUPPRESSIONS, er as UsageHistory, et as FRAME_FPS, f as BuildAttachResult, fn as PUSH_TOKEN_PATTERN, fr as WorkspaceFile, ft as INPUT_BUTTONS, g as BuildJobOutcome, gn as PushEvent, gt as InputKey, h as BuildFile, hn as ProtocolError, hr as WorkspacePatch, ht as InputButtonParams, i as ActionResult, in as NotificationSuppression, ir as VIDEO_CODECS, it as FrameTarget, j as CAPABILITIES, jn as ReplaySpan, jt as LegacyPushEvent, k as BuildSyncResult, kn as ReplayMarker, kt as LOG_LEVELS, l as BUILD_RUBY_VERSION_PATTERN, ln as PROTOCOL_SCHEMA_FILE, lr as VideoCodec, lt as HelloParams, m as BuildClientSummary, mn as Platform, mr as WorkspaceParams, mt as InputButton, n as ActionName, nn as NotificationEvent, nr as UsageSeries, nt as FrameDelayedEvent, o as ArchiveDetailResult, on as NotificationsListParams, or as VIDEO_HEADER_VERSION, ot as FramesSeekParams, p as BuildCapacity, pn as PairingAuth, pr as WorkspaceFiles, pt as INPUT_KEYS, q as DeviceUsageSeries, qn as SimulatorOptions, qt as MachineVolume, r as ActionParams, rn as NotificationLevel, rr as VIDEO_ARTWORK, rt as FrameEvent, s as BUILD_METHODS, sn as NotificationsListResult, sr as VIDEO_KEYFRAME, st as FramesSeekResult, t as ACTIONS, tn as NotificationEntry, tr as UsageSample, tt as Feature, u as BuildAndroidOptions, un as PROTOCOL_VERSION, ur as VideoPacket, ut as HelloResult, v as BuildMachineCapacity, vn as QuietHours, vt as InputPostureParams, w as BuildPlatform, wn as RecordingSetResult, wt as InputWindowParams, x as BuildOfferResult, xn as REPLAY_RATES, xt as InputSimulatorParams, y as BuildMachineReport, yn as RELOAD_PLATFORMS, yt as InputRotateParams, z as ControlPlatform, zn as ServerResponse, zt as MAX_INPUT_TEXT } from "./protocol-CXPbHten.mjs";
+export { ACTIONS, ActionName, ActionParams, ActionResult, ArchiveDetailParams, ArchiveDetailResult, BUILD_METHODS, BUILD_REPO_PATTERN, BUILD_RUBY_VERSION_PATTERN, BuildAndroidOptions, BuildArtifactResult, BuildAttachResult, BuildCapacity, BuildClientSummary, BuildFile, BuildJobOutcome, BuildJobParams, BuildMachineCapacity, BuildMachineReport, BuildOfferParams, BuildOfferResult, BuildPlanParams, BuildPlanResult, BuildPlatform, BuildProgressEvent, BuildRequestAuth, BuildStartParams, BuildSyncParams, BuildSyncResult, BuildToolchain, CAPABILITIES, CONTROL_END_REASONS, Capability, ClientRequest, ControlBeginParams, ControlBeginResult, ControlEndParams, ControlEndedEvent, ControlPlatform, DEVICE_HOST_METHODS, DEVICE_POSTURES, DeviceAuth, DeviceFrameArtwork, DeviceFrameEvent, DeviceHostRequestAuth, DevicePosture, DeviceUsageSeries, DuoFramePose, ERROR_CODES, ErrorCode, ErrorEvent, FEATURES, FRAME_EDGE, FRAME_FPS, Feature, FrameDelayedEvent, FrameEvent, FrameTarget, FramesLiveParams, FramesSeekParams, FramesSeekResult, FramesSubscribeResult, HelloParams, HelloResult, HostedSessionRow, INPUT_BUTTONS, INPUT_KEYS, InputButton, InputButtonParams, InputKey, InputKeyParams, InputPostureParams, InputRotateParams, InputScrollParams, InputSimulatorParams, InputTextParams, InputTouchParams, InputWindowParams, KEY_MODIFIERS, KeyModifier, KeyframeParams, LEGACY_PUSH_EVENTS, LOG_LEVELS, LOG_SOURCES, LegacyPushEvent, LogFilter, LogLevel, LogRecord, LogSource, LogsEndedEvent, LogsEvent, LogsQueryResult, MAX_INPUT_TEXT, MAX_LOG_TAIL, METHODS, MachineDetails, MachineHistory, MachineHistoryParams, MachineUpdateStatus, MachineUsage, MachineVolume, MacosWindow, MacosWindowsEvent, MemoryPressure, Method, Methods, NOTIFICATION_LEVELS, NOTIFICATION_SUPPRESSIONS, NotificationEntry, NotificationEvent, NotificationLevel, NotificationSuppression, NotificationTarget, NotificationsListParams, NotificationsListResult, PLATFORMS, PROTOCOL_SCHEMA_FILE, PROTOCOL_VERSION, PUSH_EVENTS, PUSH_TOKEN_PATTERN, PairingAuth, Platform, ProtocolError, PushEvent, PushRegisterParams, QuietHours, RELOAD_PLATFORMS, REPLAY_MARKER_KINDS, REPLAY_RATES, ROTATE_DIRECTIONS, RecordingSetParams, RecordingSetResult, ReloadPlatform, ReplayEndedEvent, ReplayKeyframe, ReplayKeyframeParams, ReplayMarker, ReplayRange, ReplaySpan, ReplayTarget, RequestId, RotateDirection, SERVER_UPDATE_METHODS, ServeRoute, ServerEvent, ServerMessage, ServerResponse, ServerUpdateOutcome, ServerUpdatePackage, ServerUpdateProgress, ServerUpdateStartParams, ServerUpdateStatus, SettingsResult, SimulatorCommand, SimulatorOptions, StatsResult, StatusEvent, SubscribeResult, TOUCH_PHASES, TouchPhase, UnsubscribeParams, UsageHistory, UsageSample, UsageSeries, VIDEO_ARTWORK, VIDEO_CODECS, VIDEO_FOLDED, VIDEO_HEADER_VERSION, VIDEO_KEYFRAME, VIDEO_UNFOLDED, VideoCodec, VideoPacket, WorkspaceDiff, WorkspaceFile, WorkspaceFiles, WorkspaceParams, WorkspacePatch };

package/dist/protocol.mjs

@@ -217,7 +217,8 @@ const LOG_SOURCES = [
 	"device",
 	"build",
 	"agent",
-	"maintenance"
+	"maintenance",
+	"placement"
 ];
 const LOG_LEVELS = [
 	"debug",
@@ -346,6 +347,8 @@ const DEVICE_POSTURES = [
 ];
 /** A client's repository on a remote Mac: letters, digits, `.`, `_` and `-`, at most 80. */
 const BUILD_REPO_PATTERN = "^[A-Za-z0-9][A-Za-z0-9._-]{0,79}$";
+/** A version-manager Ruby installation name, without path separators. */
+const BUILD_RUBY_VERSION_PATTERN = "^(?!\\.{1,2}$)[^/\\\\\\u0000\\r\\n]+$";
 /**
 * What stim-server can push, named like the phone's notification settings: work `started` (a workspace began
 * warming or an agent first drove its device), an agent that looks `stuck`, one that is `looping` on the same
@@ -384,4 +387,4 @@ const CONTROL_END_REASONS = [
 	"failed"
 ];
 //#endregion
-export { ACTIONS, BUILD_METHODS, BUILD_REPO_PATTERN, CAPABILITIES, CONTROL_END_REASONS, DEVICE_HOST_METHODS, DEVICE_POSTURES, ERROR_CODES, FEATURES, FRAME_EDGE, FRAME_FPS, INPUT_BUTTONS, INPUT_KEYS, KEY_MODIFIERS, LEGACY_PUSH_EVENTS, LOG_LEVELS, LOG_SOURCES, MAX_INPUT_TEXT, MAX_LOG_TAIL, METHODS, NOTIFICATION_LEVELS, NOTIFICATION_SUPPRESSIONS, PLATFORMS, PROTOCOL_SCHEMA_FILE, PROTOCOL_VERSION, PUSH_EVENTS, PUSH_TOKEN_PATTERN, RELOAD_PLATFORMS, REPLAY_MARKER_KINDS, REPLAY_RATES, ROTATE_DIRECTIONS, SERVER_UPDATE_METHODS, TOUCH_PHASES, VIDEO_ARTWORK, VIDEO_CODECS, VIDEO_FOLDED, VIDEO_HEADER_VERSION, VIDEO_KEYFRAME, VIDEO_UNFOLDED };
+export { ACTIONS, BUILD_METHODS, BUILD_REPO_PATTERN, BUILD_RUBY_VERSION_PATTERN, CAPABILITIES, CONTROL_END_REASONS, DEVICE_HOST_METHODS, DEVICE_POSTURES, ERROR_CODES, FEATURES, FRAME_EDGE, FRAME_FPS, INPUT_BUTTONS, INPUT_KEYS, KEY_MODIFIERS, LEGACY_PUSH_EVENTS, LOG_LEVELS, LOG_SOURCES, MAX_INPUT_TEXT, MAX_LOG_TAIL, METHODS, NOTIFICATION_LEVELS, NOTIFICATION_SUPPRESSIONS, PLATFORMS, PROTOCOL_SCHEMA_FILE, PROTOCOL_VERSION, PUSH_EVENTS, PUSH_TOKEN_PATTERN, RELOAD_PLATFORMS, REPLAY_MARKER_KINDS, REPLAY_RATES, ROTATE_DIRECTIONS, SERVER_UPDATE_METHODS, TOUCH_PHASES, VIDEO_ARTWORK, VIDEO_CODECS, VIDEO_FOLDED, VIDEO_HEADER_VERSION, VIDEO_KEYFRAME, VIDEO_UNFOLDED };