@stim-cli/core 1.17.2 → 1.18.0

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

@@ -276,6 +276,9 @@ interface StimConfig {
   hosting?: {
     agentDriver?: unknown;
   };
+  debug?: {
+    logs?: unknown;
+  };
   server?: {
     acceptClientBuilds?: unknown;
     maxLoadPerCore?: unknown;
@@ -317,6 +320,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`
@@ -564,6 +588,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"];
@@ -1014,6 +1048,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 +1142,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 +1181,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 +1195,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 +1218,8 @@ interface MaintenanceStatus {
   lastChecks: {
     pressure: number | null;
     size: number | null;
+    worktree: number | null;
+    sweep: number | null;
   };
   pressure: MaintenancePressure | null;
   sizes: MaintenanceSize[];
@@ -1281,6 +1320,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;
@@ -1443,6 +1484,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 +1540,8 @@ 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;
 }
 type ActivityState = "driven" | "active" | "idle" | "unknown";
 interface ActivityDriver {
@@ -2352,4 +2397,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 { readRunEstimates as $, isLayeredSetting as $a, HostedAgentGrant as $i, readHostedMacosApp as $n, sharedPods as $o, MAINTENANCE_LOG_NAME as $r, ParkedMax as $s, BuildResult as $t, DeviceHostMachineCredential as A, ANDROID_COMPILER_CACHE_CHOICES as Aa, saturation as Ac, HostedIosChoice as Ai, StatsPlatform as An, deviceHostMachinesClaims as Ao, HostedAndroidPlacement as Ar, readLogRecords as As, ActiveBuildState as At, RunHistory as B, SETTING_SCOPES as Ba, AgentActionReaderOptions as Bc, parseHostedDevice as Bi, WebBrowserState as Bn, gitMergeCacheDir as Bo, parseHostedNativePlacement as Br, readCreatedDevices as Bs, BuildCacheHit as Bt, pinnedEndpoint as C, readHostedAppMetadata as Ca, SupervisorRecord as Cc, HostedDeviceOffer as Ci, PhysicalDeviceConnection as Cn, archiveLock as Co, HostedIosPlacement as Cr, fileSizes as Cs, readEndedAgentSessions as Ct, HostedMetroRequest as D, SETTINGS_SCHEMA_FILE as Da, buildSlotPath as Dc, HostedDeviceRequest as Di, RunOutcomeKind as Dn, configLockPath as Do, hostedIosStatus as Dr, parseSince as Ds, ACTIVITY_RECENCY_BASES as Dt, HostedMetroGateway as E, validHostedAppBlob as Ea, MachineCapacity as Ec, HostedDevicePlatform as Ei, RemoteDeviceState as En, buildMachinesLock as Eo, hostedIosRecords as Er, markerWindow as Es, withGitChip as Et, HISTORY_LIMIT as F, OffloadMode as Fa, AgentDeviceUsage as Fc, deviceHostRoot as Fi, TUTORIAL_VERSION as Fn, easMachineStateRoot as Fo, hostedAndroidStatus as Fr, countErrorEntries as Fs, AndroidDeviceState as Ft, StatsCapacityWait as G, SettingsPayload as Ga, SOURCES as Gc, parseHostedRequest as Gi, WorktreeGit as Gn, maintenanceRunClaims as Go, DEVICE_RECLAIM_REASON as Gr, readJsonObject as Gs, BuildMissCategory as Gt, STATS_VERSION as H, SettingEntry as Ha, createAgentActionReader as Hc, parseHostedNativeOffer as Hi, WorkspacePhase as Hn, maintenanceChildLogFile as Ho, BUILD_HISTORY_KEY as Hr, validEasSessionClaim as Hs, BuildDetail as Ht, OffloadSummary as I, REMOTE_DEVICE_BACKENDS as Ia, AgentDeviceUsageRoots as Ic, hostedConsolePort as Ii, WEB_PAGE_STATES as In, easSessionLedgerFile as Io, parseHostedAndroidPlacement as Ir, CreatedDevicePlatform as Is, AndroidRuntimeFacts as It, StatsReport as J, WEB_VIEWPORTS as Ja, parseNdjsonText as Jc, readHostedSessions as Ji, MacosAppState as Jn, serverSetupDir as Jo, DevServerStopRequest as Jr, DEBUG_ENV as Js, BuildPhase as Jt, StatsPlacement as K, TUNNEL_MODES as Ka, levelRank as Kc, readHostedDevice as Ki, WorktreePullRequest as Kn, maintenanceStateFile as Ko, DEV_SERVER_STOP_REQUEST_KEY as Kr, readStateFile as Ks, BuildMissChange as Kt, PLACEMENT_DECISIONS as L, RemoteDeviceBackend as La, agentDeviceUsageFile as Lc, hostedDeviceId as Li, WORKSPACE_PHASES as Ln, easSessionLedgerLock as Lo, unreadableHostedAndroid as Lr, CreatedDevices as Ls, AppPresence as Lt, BuildMachineTotals as M, ANDROID_PCH_CHOICES as Ma, SwiftpmCacheUsage as Mc, HostedNativeOffer as Mi, StatusIssue as Mn, deviceHostMachinesLock as Mo, hostedAndroidDeviceName as Mr, recordMatches as Ms, ActivityRecencyBasis as Mt, CAPACITY_REFUSAL_LIMIT as N, IOS_SIMULATOR_APPS as Na, readSwiftpmCacheUsage as Nc, assertHostedDeviceLedger as Ni, StatusIssueCode as Nn, deviceViewersDir as No, hostedAndroidPlacements as Nr, sortByTs as Ns, AgentSession as Nt, hostedMetroGateways as O, SETTINGS_SCHEMA_URL as Oa, buildSlotsDir as Oc, HostedDeviceSelectors as Oi, STATUS_ISSUE_CODES as On, createdDevicesFile as Oo, parseHostedIosPlacement as Or, queryJsonLogs as Os, AGENT_TOOLS as Ot, CAPACITY_REFUSAL_MAX_AGE_MS as P, OFFLOAD_MODES as Pa, swiftpmCacheUsageFile as Pc, deviceHostArea as Pi, StatusPayload as Pn, diskUsageCacheDir as Po, hostedAndroidRecords as Pr, tailRead as Ps, AgentTool as Pt, offloadSummary as Q, expectedShape as Qa, HostedAgentDriverName as Qi, parseMacosRecord as Qn, sharedGradle as Qo, LAST_BUILD_KEYS as Qr, debugLoggingEnabled as Qs, BuildReport as Qt, ReadStatsResult as R, SETTINGS as Ra, readAgentDeviceUsage as Rc, parseHostedAndroidDevice as Ri, WORKSPACE_STAGE_KINDS as Rn, emulatorLogFile as Ro, HostedNativePlacement as Rr, EasSessionClaim as Rs, BUILD_PHASES as Rt, parseMachine as S, readHostedApp as Sa, StimConfig as Sc, HostedDevice as Si, PHYSICAL_DEVICE_CONNECTIONS as Sn, archiveDir as So, readMaintenanceState as Sr, compileGrep as Ss, readDiskUsage as St, HOSTED_METRO_REQUESTS_KEY as T, validHostedAppArguments as Ta, readBuildMachines as Tc, HostedDevicePhase as Ti, PlannedPhase as Tn, buildMachinesFile as To, hostedIosPlacements as Tr, logFiles as Ts, withDerivedFacts as Tt, StatsBucket as U, SettingScope as Ua, LEVELS as Uc, parseHostedOfferRequest as Ui, WorkspaceStage as Un, maintenanceDir as Uo, BUILD_HISTORY_LIMIT as Ur, isJsonObject as Us, BuildDiagnostic as Ut, RunSample as V, SettingDefinition as Va, AgentTarget as Vc, parseHostedLocalDeviceCount as Vi, WebPageState as Vn, maintenanceAttemptFile as Vo, unreadableHostedNative as Vr, readEasSessionLedger as Vs, BuildCause as Vt, StatsCapacityRefusal as W, SettingType as Wa, NdjsonRecord as Wc, parseHostedPlatformDevice as Wi, WorktreeFacts as Wn, maintenanceNdjsonFile as Wo, DEVICE_IDLE_SHUTDOWN_KEY as Wr, readJsonFile as Ws, BuildHistoryEntry as Wt, decodeStats as X, acceptsShape as Xa, HOSTED_MACOS_APP_SLOTS as Xi, MacosProcess as Xn, sharedCcache as Xo, IDLE_STOP_KEY as Xr, createDebugLog as Xs, BuildPlanPayload as Xt, StatsScope as Y, WebViewport as Ya, readNdjsonGenerations as Yc, HOSTED_AGENT_DRIVERS as Yi, MacosBuild as Yn, setupJournalFile as Yo, DeviceIdleShutdownRecord as Yr, DebugLog as Ys, BuildPlacement as Yt, findProjectRoot as Z, coerceSettingText as Za, HostedAgentAccess as Zi, macosAppState as Zn, sharedCompilationCache as Zo, IdleStopRecord as Zr, debugLogDir as Zs, BuildPlatform as Zt, Endpoint as _, hostedAppArea as _a, DoctorRunRecord as _c, readWorkspaceAgent as _i, MachineUsageState as _n, openSegmentName as _o, MaintenanceSize as _r, QueryCriteria as _s, endedAgentSessionOf as _t, parseSetupJournal as a, hostedMacosAppSlot as aa, getConcurrencyLimits as ac, WorkspaceState as ai, DevicePlacement as an, validRunId as ao, archivedUsage as ar, workspaceDerivedData as as, trimSamples as at, endpoint as b, parseHostedAppManifest as ba, RepoRecord as bc, HostedAndroidChoice as bi, NATIVE_BUILD_STEPS as bn, recordingEnabled as bo, parseMaintenanceState as br, buildCriteria as bs, readAgentSessionsCache as bt, HOSTED_LOGS_FIRST_BYTES as c, parseHostedAgentGrant as ca, getProjectSetting as cc, parseMissReason as ci, EnvironmentDisk as cn, RECORDING_PLATFORMS as co, readArchiveState as cr, workspaceGradleBuild as cs, ViewedDevice as ct, HostedLogsPage as d, parseHostedMacosPlacement as da, isPathPrefix as dc, readDevServerStopRequest as di, GitChipPart as dn, RecordingPlatform as do, MaintenanceActionKind as dr, workspaceMetadataFile as ds, AgentSessionsCache as dt, HostedAgentLease as ea, allMetroPorts as ec, MetroLastStop as ei, BuildWaitingFor as en, isSensitiveReference as eo, readMacosRecord as er, statsFile as es, readStats as et, hostedMacosLogsDir as f, HOSTED_APP_CHUNK_BYTES as fa, loadConfig as fc, readDeviceIdleShutdowns as fi, LastBuildReport as fn, capDrops as fo, MaintenanceCheck as fr, workspaceRecordingsDir as fs, ENDED_AGENT_RETENTION_MS as ft, readLogsSince as g, HostedAppRecord as ga, DeviceRecord as gc, readWarmRecord as gi, MachineOwnerKind as gn, listSegments as go, MaintenanceRecord as gr, NATIVE_CRASH_LOG_PREFIX as gs, diskUsageCacheFile as gt, readHostedNativeLogsCheckpoint as h, HostedAppOffer as ha, Config as hc, readLastBuilds as hi, MachineOwner as hn, listRecordedDevices as ho, MaintenancePressure as hr, ERROR_SOURCES as hs, agentSessionOf as ht, isSetupJournalPrunable as i, HostedMacosPlacement as ia, findProjectByMetroPort as ic, WarmRecord as ii, DeviceLeaseState as in, runId as io, archiveEnabled as ir, workspaceBuildDetailFile as is, trimCapacityWaits as it, readDeviceHostMachines as j, ANDROID_EMULATOR_APPS as ja, tryAcquireBuildSlotClaim as jc, HostedIosDevice as ji, StatusCapacity as jn, deviceHostMachinesFile as jo, HostedAndroidStatus as jr, readLogTimeline as js, ActivityDriver as jt, hostedMetroRequests as k, settingsJsonSchema as ka, machineCapacity as kc, HostedDeviceSession as ki, SimulatorState as kn, createdDevicesLock as ko, unreadableHostedIos as kr, queryLogs as ks, APP_PROCESS_STATES as kt, HOSTED_LOGS_PAGE_BYTES as l, parseHostedMacosChoice as la, getProjectSettings as lc, readBuildHistory as li, EnvironmentState as ln, RecordedDevice as lo, readArchives as lr, workspaceLogErrorIndex as ls, readViewedDevices as lt, parseHostedLogsCursor as m, HostedAppFile as ma, ConcurrencyLimits as mc, readIdleStop as mi, MEMORY_SOURCES as mn, footageDrops as mo, MaintenancePass as mr, workspaceStateLock as ms, StatusCacheEntry as mt, SetupJournal as n, HostedMacosChoice as na, configCorruptRepair as nc, WARM_KEY as ni, DeviceActivity as nn, settingValueError as no, ArchivedUsage as nr, supervisorPidFile as ns, statsProjectKey as nt, readSetupJournal as o, hostedMacosBundleId as oa, getParkedMax as oc, buildDiagnostics as oi, DiskMeasure as on, RECORDING_CAP_BYTES as oo, linkReplacedArchives as or, workspaceEndedAgentsFile as os, wholePhases as ot, hostedNativeLogsDir as p, HostedAppDelivery as pa, withConfigLock as pc, readDevicePlacement as pi, MACHINE_OWNER_KINDS as pn, closedSegmentName as po, MaintenanceMode as pr, workspaceStateFile as ps, PullRequestCacheEntry as pt, StatsRecord as q, TunnelMode as qa, parseNdjsonLine as qc, readHostedDeviceLedger as qi, MacosAppRecord as qn, pullRequestCacheDir as qo, DevServerStopRecord as qr, withStateReadCache as qs, BuildMissReason as qt, isJournalExpired as r, HostedMacosDevice as ra, findEnclosingWorktreeRoot as rc, WORKSPACE_AGENT_KEY as ri, DeviceAppProcess as rn, RUN_ID_ENV as ro, ArchivedWorkspace as rr, workspaceAgentDeviceDir as rs, trimCapacityRefusals as rt, agentDeviceStateDirs as s, parseHostedAgentAccess as sa, getProject as sc, lastUseFrom as si, EndedAgentSession as sn, RECORDING_FOOTAGE_MS as so, readArchive as sr, workspaceEndedAgentsLock as ss, DeviceViewersRecord as st, SetupCapability as t, HostedAppLaunch as ta, buildWorkerRoot as tc, READY_PHASE_MS as ti, ChecksState as tn, settingDefinition as to, ArchivedBytes as tr, supervisorLogFile as ts, readStatsReport as tt, HostedLogsCursor as u, parseHostedMacosDevice as ua, getRepoSettings as uc, readDevServerStop as ui, GitChip as un, RecordedSegment as uo, MaintenanceAction as ur, workspaceLogsDir as us, stimBuildDigest as ut, TAILNET_MACHINE_PATTERN as v, hostedAppAttempt as va, PlatformRecords as vc, readWorkspaceState as vi, MemorySource as vn, recordedBytes as vo, MaintenanceState as vr, advanceTail as vs, listStatusCacheEntries as vt, HOSTED_METRO_GATEWAYS_KEY as w, rememberHostedAppBlobRename as wa, BuildMachineCredential as wc, HostedDeviceOfferRequest as wi, PhysicalDeviceState as wn, archiveRoot as wo, HostedIosStatus as wr, followLogs as ws, readPullRequestCache as wt, findPeer as x, parseHostedAppOffer as xa, SettingsObject as xc, HostedAndroidDevice as xi, NativeBuildStep as xn, agentSessionsCacheFile as xo, readMaintenanceAttempt as xr, bundleMarkerPlatform as xs, readBuildDetail as xt, TailnetPeer as y, hostedAppBlobs as ya, ProjectRecord as yc, workspaceLastUsed as yi, MetroBundleState as yn, recordingDeviceName as yo, MaintenanceStatus as yr, attachExpoErrorContext as ys, pullRequestCacheFile as yt, RunEstimates as z, SETTING_GROUPS as za, readAgentDeviceUsageCache as zc, parseHostedChoice as zi, WarmStep as zn, getConfigPath as zo, hostedNativeRecords as zr, EasSessionLedgerRead as zs, BUILD_RESULTS 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 { 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, ia as HostedMacosPlacement, in as DeviceLeaseState, kn as SimulatorState, ln as EnvironmentState, mr as MaintenancePass, nn as DeviceActivity, on as DiskMeasure, qn as MacosAppRecord, qt as BuildMissReason, rn as DeviceAppProcess, rr as ArchivedWorkspace, un as GitChip, ur as MaintenanceAction, wn as PhysicalDeviceState, yn as MetroBundleState, yr as MaintenanceStatus } from "./index-DcA9D2PQ.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-DXP_JLAv.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-DXP_JLAv.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 { Ci as HostedDeviceOffer, Di as HostedDeviceRequest, Ei as HostedDevicePlatform, Pn as StatusPayload, Ti as HostedDevicePhase, Wc as NdjsonRecord, Wt as BuildHistoryEntry, Xt as BuildPlanPayload, d as HostedLogsPage, ha as HostedAppOffer, ki as HostedDeviceSession, pa as HostedAppDelivery, ta as HostedAppLaunch, u as HostedLogsCursor, wi as HostedDeviceOfferRequest } from "./index-DcA9D2PQ.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-DXP_JLAv.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 };

package/dist/receive-protocol.d.mts

@@ -8,5 +8,18 @@ declare function isRpcEvent(value: unknown): value is PhoneServerEvent;
 declare function isRpcError(value: unknown): value is PhoneProtocolError;
 /** Unknown future events can be ignored without reconnecting to a newer server. */
 declare function isRpcEventName(value: string): boolean;
+/** Why a validator rejected a value, described by the schema alone: no instance path and no value. */
+interface RpcIssue {
+  keyword: string;
+  schemaPath: string;
+  missingProperty?: string;
+  expectedType?: string;
+}
+/** The first schema violation of a result for `method`, or null when it is valid. */
+declare function rpcResultIssue<M extends PhoneMethod>(method: M, value: unknown): RpcIssue | null;
+/** The first schema violation of a phone event, or null when it is valid. */
+declare function rpcEventIssue(value: unknown): RpcIssue | null;
+/** The first schema violation of an RPC error object, or null when it is valid. */
+declare function rpcErrorIssue(value: unknown): RpcIssue | null;
 //#endregion
-export { isRpcError, isRpcEvent, isRpcEventName, isRpcResult };
+export { RpcIssue, isRpcError, isRpcEvent, isRpcEventName, isRpcResult, rpcErrorIssue, rpcEventIssue, rpcResultIssue };