stim 1.14.0 → 1.16.0

package/dist/settings.schema.json

@@ -239,6 +239,7 @@
             "key": "ios.deviceType",
             "kind": "string",
             "scopes": [
+              "machine",
               "workspace",
               "repo",
               "committed"
@@ -252,6 +253,7 @@
             "key": "ios.runtime",
             "kind": "string",
             "scopes": [
+              "machine",
               "workspace",
               "repo",
               "committed"
@@ -273,15 +275,12 @@
           }
         },
         "remote": {
-          "description": "Default remote backend for iOS",
+          "description": "Default iOS remote target: eas, proxy, or an approved Mac in hosting.machines; auto is not available yet",
           "type": "string",
-          "enum": [
-            "proxy",
-            "eas"
-          ],
+          "pattern": "^[A-Za-z0-9][A-Za-z0-9.-]*(?::(?!0+$)(?:[0-5]?[0-9]{1,4}|6[0-4][0-9]{3}|65[0-4][0-9]{2}|655[0-2][0-9]|6553[0-5]))?$",
           "x-stim": {
             "key": "ios.remote",
-            "kind": "choice",
+            "kind": "string",
             "scopes": [
               "workspace",
               "repo",
@@ -357,6 +356,7 @@
             "key": "android.systemImage",
             "kind": "string",
             "scopes": [
+              "machine",
               "workspace",
               "repo",
               "committed"
@@ -486,14 +486,15 @@
       "type": "object",
       "properties": {
         "tunnel": {
-          "description": "How a remote device reaches Metro",
+          "description": "How a remote device reaches Metro; tailscale is tailnet-only and requires explicit selection",
           "type": "string",
           "enum": [
             "auto",
             "off",
             "expo",
             "cloudflared",
-            "ngrok"
+            "ngrok",
+            "tailscale"
           ],
           "default": "auto",
           "x-stim": {
@@ -532,6 +533,22 @@
             ]
           }
         },
+        "port": {
+          "description": "This workspace's Metro port, reserved instead of one Stim picks",
+          "type": "integer",
+          "minimum": 1024,
+          "maximum": 65535,
+          "x-stim": {
+            "key": "metro.port",
+            "kind": "number",
+            "scopes": [
+              "workspace",
+              "repo",
+              "committed"
+            ],
+            "env": "STIM_METRO_PORT"
+          }
+        },
         "warmupUrl": {
           "type": "object",
           "properties": {
@@ -582,6 +599,105 @@
       },
       "additionalProperties": false
     },
+    "devices": {
+      "type": "object",
+      "properties": {
+        "idleShutdownMinutes": {
+          "description": "Minutes an owned simulator or emulator stays idle before the workspace supervisor shuts it down; 0 never",
+          "type": "integer",
+          "minimum": 0,
+          "default": 0,
+          "x-stim": {
+            "key": "devices.idleShutdownMinutes",
+            "kind": "number",
+            "scopes": [
+              "machine",
+              "workspace",
+              "repo",
+              "committed"
+            ]
+          }
+        }
+      },
+      "additionalProperties": false
+    },
+    "macos": {
+      "type": "object",
+      "properties": {
+        "product": {
+          "description": "The Swift Package executable product stim macos builds in Debug.",
+          "type": "string",
+          "pattern": "^[A-Za-z0-9_-]+$",
+          "x-stim": {
+            "key": "macos.product",
+            "kind": "string",
+            "scopes": [
+              "workspace",
+              "repo",
+              "committed"
+            ]
+          }
+        },
+        "infoPlist": {
+          "description": "Development Info.plist relative to the Swift Package directory.",
+          "type": "string",
+          "x-stim": {
+            "key": "macos.infoPlist",
+            "kind": "path",
+            "scopes": [
+              "workspace",
+              "repo",
+              "committed"
+            ],
+            "relative": true
+          }
+        },
+        "arguments": {
+          "description": "Arguments passed directly to the owned macOS development executable.",
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "x-stim": {
+            "key": "macos.arguments",
+            "kind": "strings",
+            "scopes": [
+              "workspace",
+              "repo",
+              "committed"
+            ]
+          }
+        },
+        "assetCatalog": {
+          "description": "Optional .xcassets directory relative to the Swift Package directory.",
+          "type": "string",
+          "x-stim": {
+            "key": "macos.assetCatalog",
+            "kind": "path",
+            "scopes": [
+              "workspace",
+              "repo",
+              "committed"
+            ],
+            "relative": true
+          }
+        },
+        "resources": {
+          "description": "Resource destinations under Contents/Resources mapped to sources relative to the Swift Package directory.",
+          "type": "object",
+          "x-stim": {
+            "key": "macos.resources",
+            "kind": "object",
+            "scopes": [
+              "workspace",
+              "repo",
+              "committed"
+            ]
+          }
+        }
+      },
+      "additionalProperties": false
+    },
     "web": {
       "type": "object",
       "properties": {
@@ -634,6 +750,28 @@
       },
       "additionalProperties": false
     },
+    "archive": {
+      "type": "object",
+      "properties": {
+        "enabled": {
+          "description": "Keep workspace history on removal; false under STIM_HOME unless explicitly enabled",
+          "type": "boolean",
+          "default": true,
+          "x-stim": {
+            "key": "archive.enabled",
+            "kind": "boolean",
+            "scopes": [
+              "machine",
+              "workspace",
+              "repo",
+              "committed"
+            ],
+            "env": "STIM_ARCHIVE_ENABLED"
+          }
+        }
+      },
+      "additionalProperties": false
+    },
     "worktree": {
       "type": "object",
       "properties": {
@@ -934,9 +1072,57 @@
           },
           "additionalProperties": false
         },
+        "ios": {
+          "type": "object",
+          "properties": {
+            "deviceType": {
+              "description": "Simulator model for owned simulators",
+              "type": "string",
+              "x-stim": {
+                "key": "ios.deviceType",
+                "kind": "string",
+                "scopes": [
+                  "machine",
+                  "workspace",
+                  "repo",
+                  "committed"
+                ]
+              }
+            },
+            "runtime": {
+              "description": "iOS runtime owned simulators are created on",
+              "type": "string",
+              "x-stim": {
+                "key": "ios.runtime",
+                "kind": "string",
+                "scopes": [
+                  "machine",
+                  "workspace",
+                  "repo",
+                  "committed"
+                ]
+              }
+            }
+          },
+          "additionalProperties": false
+        },
         "android": {
           "type": "object",
           "properties": {
+            "systemImage": {
+              "description": "SDK system image for owned AVDs",
+              "type": "string",
+              "x-stim": {
+                "key": "android.systemImage",
+                "kind": "string",
+                "scopes": [
+                  "machine",
+                  "workspace",
+                  "repo",
+                  "committed"
+                ]
+              }
+            },
             "deviceProfile": {
               "description": "avdmanager hardware profile id for new owned AVDs",
               "type": "string",
@@ -955,130 +1141,579 @@
           },
           "additionalProperties": false
         },
-        "iosSimulatorApp": {
-          "description": "App that displays an owned iOS simulator; stim-desktop by default when Stim Desktop is installed",
-          "type": "string",
-          "enum": [
-            "xcode",
-            "siniulator",
-            "stim-desktop"
-          ],
-          "default": "xcode",
-          "x-stim": {
-            "key": "iosSimulatorApp",
-            "kind": "choice",
-            "scopes": [
-              "machine"
-            ]
-          }
-        },
-        "androidEmulatorApp": {
-          "description": "App that displays an owned Android emulator Stim boots on macOS; stim-desktop by default when Stim Desktop is installed",
-          "type": "string",
-          "enum": [
-            "emulator",
-            "stim-desktop"
-          ],
-          "default": "emulator",
-          "x-stim": {
-            "key": "androidEmulatorApp",
-            "kind": "choice",
-            "scopes": [
-              "machine"
-            ]
-          }
-        },
-        "concurrency": {
+        "devices": {
           "type": "object",
           "properties": {
-            "maxBuilds": {
-              "description": "Concurrent native builds; 0 means no limit",
+            "idleShutdownMinutes": {
+              "description": "Minutes an owned simulator or emulator stays idle before the workspace supervisor shuts it down; 0 never",
               "type": "integer",
               "minimum": 0,
               "default": 0,
               "x-stim": {
-                "key": "concurrency.maxBuilds",
+                "key": "devices.idleShutdownMinutes",
                 "kind": "number",
                 "scopes": [
-                  "machine"
-                ],
-                "env": "STIM_MAX_BUILDS"
+                  "machine",
+                  "workspace",
+                  "repo",
+                  "committed"
+                ]
               }
-            },
-            "maxDevices": {
-              "description": "Booted owned devices; 0 means no limit",
-              "type": "integer",
-              "minimum": 0,
-              "default": 0,
+            }
+          },
+          "additionalProperties": false
+        },
+        "recording": {
+          "type": "object",
+          "properties": {
+            "enabled": {
+              "description": "Let stim-server record device screens for replay; false stops it and deletes the recordings",
+              "type": "boolean",
+              "default": true,
               "x-stim": {
-                "key": "concurrency.maxDevices",
-                "kind": "number",
+                "key": "recording.enabled",
+                "kind": "boolean",
                 "scopes": [
-                  "machine"
+                  "machine",
+                  "workspace",
+                  "repo"
                 ],
-                "env": "STIM_MAX_DEVICES"
+                "env": "STIM_RECORDING"
               }
             }
           },
           "additionalProperties": false
         },
-        "budget": {
+        "archive": {
           "type": "object",
           "properties": {
-            "minFreeDiskGb": {
-              "description": "Free disk, in GB, ios, android and start reclaim toward; 0 reclaims only below the hard floor",
-              "type": "number",
-              "minimum": 0,
-              "default": 20,
+            "enabled": {
+              "description": "Keep workspace history on removal; false under STIM_HOME unless explicitly enabled",
+              "type": "boolean",
+              "default": true,
               "x-stim": {
-                "key": "budget.minFreeDiskGb",
-                "kind": "number",
+                "key": "archive.enabled",
+                "kind": "boolean",
                 "scopes": [
-                  "machine"
+                  "machine",
+                  "workspace",
+                  "repo",
+                  "committed"
                 ],
-                "env": "STIM_BUDGET_MIN_FREE_DISK_GB"
+                "env": "STIM_ARCHIVE_ENABLED"
               }
             },
-            "hardFloorDiskGb": {
-              "description": "Free disk, in GB, below which ios, android and start refuse with STIM_LOW_DISK; 0 never refuses",
-              "type": "number",
+            "maxAgeDays": {
+              "description": "Days to keep archived workspace records; 0 keeps nothing",
+              "type": "integer",
               "minimum": 0,
-              "default": 5,
+              "default": 30,
               "x-stim": {
-                "key": "budget.hardFloorDiskGb",
+                "key": "archive.maxAgeDays",
                 "kind": "number",
                 "scopes": [
                   "machine"
                 ],
-                "env": "STIM_BUDGET_HARD_FLOOR_DISK_GB"
+                "env": "STIM_ARCHIVE_MAX_AGE_DAYS"
               }
             },
-            "maxCommittedMemoryGb": {
-              "description": "Estimated memory, in GB, of live environments before idle ones are reclaimed; unset is 60% of RAM, 0 is off",
-              "type": "number",
+            "maxCount": {
+              "description": "Archived workspace count; oldest records go first, 0 keeps nothing",
+              "type": "integer",
               "minimum": 0,
+              "default": 200,
               "x-stim": {
-                "key": "budget.maxCommittedMemoryGb",
+                "key": "archive.maxCount",
                 "kind": "number",
                 "scopes": [
                   "machine"
                 ],
-                "env": "STIM_BUDGET_MAX_COMMITTED_MEMORY_GB"
+                "env": "STIM_ARCHIVE_MAX_COUNT"
               }
             },
-            "maxLiveWorkspaces": {
-              "description": "Live workspaces before idle ones are reclaimed; unset or 0 means no limit",
-              "type": "integer",
+            "maxTotalGb": {
+              "description": "Total archived bytes in binary GB; 0 keeps no artifacts",
+              "type": "number",
               "minimum": 0,
+              "default": 5,
               "x-stim": {
-                "key": "budget.maxLiveWorkspaces",
+                "key": "archive.maxTotalGb",
                 "kind": "number",
                 "scopes": [
                   "machine"
                 ],
-                "env": "STIM_BUDGET_MAX_LIVE_WORKSPACES"
+                "env": "STIM_ARCHIVE_MAX_TOTAL_GB"
               }
-            }
+            },
+            "logs": {
+              "type": "object",
+              "properties": {
+                "maxAgeDays": {
+                  "description": "Days to keep archived logs; 0 keeps none",
+                  "type": "integer",
+                  "minimum": 0,
+                  "default": 14,
+                  "x-stim": {
+                    "key": "archive.logs.maxAgeDays",
+                    "kind": "number",
+                    "scopes": [
+                      "machine"
+                    ],
+                    "env": "STIM_ARCHIVE_LOGS_MAX_AGE_DAYS"
+                  }
+                },
+                "maxMbPerWorkspace": {
+                  "description": "Archived logs per workspace in binary MB; 0 keeps none",
+                  "type": "number",
+                  "minimum": 0,
+                  "default": 100,
+                  "x-stim": {
+                    "key": "archive.logs.maxMbPerWorkspace",
+                    "kind": "number",
+                    "scopes": [
+                      "machine"
+                    ],
+                    "env": "STIM_ARCHIVE_LOGS_MAX_MB_PER_WORKSPACE"
+                  }
+                }
+              },
+              "additionalProperties": false
+            },
+            "recordings": {
+              "type": "object",
+              "properties": {
+                "maxAgeDays": {
+                  "description": "Days to keep archived recordings; 0 keeps none",
+                  "type": "integer",
+                  "minimum": 0,
+                  "default": 3,
+                  "x-stim": {
+                    "key": "archive.recordings.maxAgeDays",
+                    "kind": "number",
+                    "scopes": [
+                      "machine"
+                    ],
+                    "env": "STIM_ARCHIVE_RECORDINGS_MAX_AGE_DAYS"
+                  }
+                },
+                "maxTotalGb": {
+                  "description": "Archived recordings in binary GB; 0 keeps none",
+                  "type": "number",
+                  "minimum": 0,
+                  "default": 2,
+                  "x-stim": {
+                    "key": "archive.recordings.maxTotalGb",
+                    "kind": "number",
+                    "scopes": [
+                      "machine"
+                    ],
+                    "env": "STIM_ARCHIVE_RECORDINGS_MAX_TOTAL_GB"
+                  }
+                }
+              },
+              "additionalProperties": false
+            },
+            "agentActions": {
+              "type": "object",
+              "properties": {
+                "maxAgeDays": {
+                  "description": "Days to keep archived agent-device sessions; 0 keeps none",
+                  "type": "integer",
+                  "minimum": 0,
+                  "default": 7,
+                  "x-stim": {
+                    "key": "archive.agentActions.maxAgeDays",
+                    "kind": "number",
+                    "scopes": [
+                      "machine"
+                    ],
+                    "env": "STIM_ARCHIVE_AGENT_ACTIONS_MAX_AGE_DAYS"
+                  }
+                }
+              },
+              "additionalProperties": false
+            }
+          },
+          "additionalProperties": false
+        },
+        "iosSimulatorApp": {
+          "description": "App that displays an owned iOS simulator; stim-desktop by default when Stim Desktop is installed",
+          "type": "string",
+          "enum": [
+            "xcode",
+            "siniulator",
+            "stim-desktop"
+          ],
+          "default": "xcode",
+          "x-stim": {
+            "key": "iosSimulatorApp",
+            "kind": "choice",
+            "scopes": [
+              "machine"
+            ]
+          }
+        },
+        "androidEmulatorApp": {
+          "description": "App that displays an owned Android emulator Stim boots on macOS; stim-desktop by default when Stim Desktop is installed",
+          "type": "string",
+          "enum": [
+            "emulator",
+            "stim-desktop"
+          ],
+          "default": "emulator",
+          "x-stim": {
+            "key": "androidEmulatorApp",
+            "kind": "choice",
+            "scopes": [
+              "machine"
+            ]
+          }
+        },
+        "concurrency": {
+          "type": "object",
+          "properties": {
+            "maxBuilds": {
+              "description": "Concurrent native builds; 0 means no limit",
+              "type": "integer",
+              "minimum": 0,
+              "default": 0,
+              "x-stim": {
+                "key": "concurrency.maxBuilds",
+                "kind": "number",
+                "scopes": [
+                  "machine"
+                ],
+                "env": "STIM_MAX_BUILDS"
+              }
+            },
+            "maxDevices": {
+              "description": "Booted owned devices; 0 means no limit",
+              "type": "integer",
+              "minimum": 0,
+              "default": 0,
+              "x-stim": {
+                "key": "concurrency.maxDevices",
+                "kind": "number",
+                "scopes": [
+                  "machine"
+                ],
+                "env": "STIM_MAX_DEVICES"
+              }
+            }
+          },
+          "additionalProperties": false
+        },
+        "budget": {
+          "type": "object",
+          "properties": {
+            "minFreeDiskGb": {
+              "description": "Free disk, in GB, ios, android and start reclaim toward; 0 reclaims only below the hard floor",
+              "type": "number",
+              "minimum": 0,
+              "default": 20,
+              "x-stim": {
+                "key": "budget.minFreeDiskGb",
+                "kind": "number",
+                "scopes": [
+                  "machine"
+                ],
+                "env": "STIM_BUDGET_MIN_FREE_DISK_GB"
+              }
+            },
+            "hardFloorDiskGb": {
+              "description": "Free disk, in GB, below which ios, android and start refuse with STIM_LOW_DISK; 0 never refuses",
+              "type": "number",
+              "minimum": 0,
+              "default": 5,
+              "x-stim": {
+                "key": "budget.hardFloorDiskGb",
+                "kind": "number",
+                "scopes": [
+                  "machine"
+                ],
+                "env": "STIM_BUDGET_HARD_FLOOR_DISK_GB"
+              }
+            },
+            "maxCommittedMemoryGb": {
+              "description": "Estimated memory, in GB, of live environments before idle ones are reclaimed; unset is 60% of RAM, 0 is off",
+              "type": "number",
+              "minimum": 0,
+              "x-stim": {
+                "key": "budget.maxCommittedMemoryGb",
+                "kind": "number",
+                "scopes": [
+                  "machine"
+                ],
+                "env": "STIM_BUDGET_MAX_COMMITTED_MEMORY_GB"
+              }
+            },
+            "maxLiveWorkspaces": {
+              "description": "Live workspaces before idle ones are reclaimed; unset or 0 means no limit",
+              "type": "integer",
+              "minimum": 0,
+              "x-stim": {
+                "key": "budget.maxLiveWorkspaces",
+                "kind": "number",
+                "scopes": [
+                  "machine"
+                ],
+                "env": "STIM_BUDGET_MAX_LIVE_WORKSPACES"
+              }
+            }
+          },
+          "additionalProperties": false
+        },
+        "maintenance": {
+          "type": "object",
+          "properties": {
+            "mode": {
+              "description": "Automatic resource maintenance. report measures, plans and logs what it would do and never deletes or stops anything; off disables it. Off under STIM_HOME or CI unless STIM_MAINTENANCE is set",
+              "type": "string",
+              "enum": [
+                "off",
+                "report"
+              ],
+              "default": "report",
+              "x-stim": {
+                "key": "maintenance.mode",
+                "kind": "choice",
+                "scopes": [
+                  "machine"
+                ],
+                "env": "STIM_MAINTENANCE"
+              }
+            },
+            "pressureCheckMinutes": {
+              "description": "Disk and memory check interval in minutes",
+              "type": "integer",
+              "minimum": 1,
+              "default": 1,
+              "x-stim": {
+                "key": "maintenance.pressureCheckMinutes",
+                "kind": "number",
+                "scopes": [
+                  "machine"
+                ],
+                "env": "STIM_MAINTENANCE_PRESSURE_CHECK_MINUTES"
+              }
+            },
+            "sizeCheckMinutes": {
+              "description": "Directory size check interval in minutes",
+              "type": "integer",
+              "minimum": 1,
+              "default": 60,
+              "x-stim": {
+                "key": "maintenance.sizeCheckMinutes",
+                "kind": "number",
+                "scopes": [
+                  "machine"
+                ],
+                "env": "STIM_MAINTENANCE_SIZE_CHECK_MINUTES"
+              }
+            },
+            "maxLoadPerCore": {
+              "description": "Defer size scans above this one-minute load per CPU",
+              "type": "number",
+              "exclusiveMinimum": 0,
+              "default": 4,
+              "x-stim": {
+                "key": "maintenance.maxLoadPerCore",
+                "kind": "number",
+                "scopes": [
+                  "machine"
+                ],
+                "env": "STIM_MAINTENANCE_MAX_LOAD_PER_CORE"
+              }
+            },
+            "logMaxMb": {
+              "description": "Machine maintenance log rotation size in MiB",
+              "type": "number",
+              "exclusiveMinimum": 0,
+              "default": 1,
+              "x-stim": {
+                "key": "maintenance.logMaxMb",
+                "kind": "number",
+                "scopes": [
+                  "machine"
+                ],
+                "env": "STIM_MAINTENANCE_LOG_MAX_MB"
+              }
+            },
+            "logRetentionDays": {
+              "description": "Retention of the rotated machine maintenance log in days",
+              "type": "integer",
+              "minimum": 1,
+              "default": 30,
+              "x-stim": {
+                "key": "maintenance.logRetentionDays",
+                "kind": "number",
+                "scopes": [
+                  "machine"
+                ],
+                "env": "STIM_MAINTENANCE_LOG_RETENTION_DAYS"
+              }
+            },
+            "logChecks": {
+              "description": "Write debug check records and routine skips",
+              "type": "boolean",
+              "default": false,
+              "x-stim": {
+                "key": "maintenance.logChecks",
+                "kind": "boolean",
+                "scopes": [
+                  "machine"
+                ],
+                "env": "STIM_MAINTENANCE_LOG_CHECKS"
+              }
+            },
+            "memoryPressureLevel": {
+              "description": "Lowest macOS memory pressure level considered; off disables memory pressure reporting",
+              "type": "string",
+              "enum": [
+                "warning",
+                "critical",
+                "off"
+              ],
+              "default": "warning",
+              "x-stim": {
+                "key": "maintenance.memoryPressureLevel",
+                "kind": "choice",
+                "scopes": [
+                  "machine"
+                ],
+                "env": "STIM_MAINTENANCE_MEMORY_PRESSURE_LEVEL"
+              }
+            },
+            "memoryWarningMinutes": {
+              "description": "Consecutive warning minutes before memory counts as pressure",
+              "type": "integer",
+              "minimum": 0,
+              "default": 10,
+              "x-stim": {
+                "key": "maintenance.memoryWarningMinutes",
+                "kind": "number",
+                "scopes": [
+                  "machine"
+                ],
+                "env": "STIM_MAINTENANCE_MEMORY_WARNING_MINUTES"
+              }
+            },
+            "minAvailableMemoryGb": {
+              "description": "Available-memory threshold in GiB; unset is 10% of RAM",
+              "type": "number",
+              "minimum": 0,
+              "x-stim": {
+                "key": "maintenance.minAvailableMemoryGb",
+                "kind": "number",
+                "scopes": [
+                  "machine"
+                ],
+                "env": "STIM_MAINTENANCE_MIN_AVAILABLE_MEMORY_GB"
+              }
+            },
+            "capTargetPercent": {
+              "description": "Plan toward this percentage of each size cap",
+              "type": "integer",
+              "minimum": 10,
+              "maximum": 100,
+              "default": 80,
+              "x-stim": {
+                "key": "maintenance.capTargetPercent",
+                "kind": "number",
+                "scopes": [
+                  "machine"
+                ],
+                "env": "STIM_MAINTENANCE_CAP_TARGET_PERCENT"
+              }
+            },
+            "workspaceOutputsMaxGb": {
+              "description": "Workspace build-output cap in GiB; 0 means no cap",
+              "type": "number",
+              "minimum": 0,
+              "default": 20,
+              "x-stim": {
+                "key": "maintenance.workspaceOutputsMaxGb",
+                "kind": "number",
+                "scopes": [
+                  "machine"
+                ],
+                "env": "STIM_MAINTENANCE_WORKSPACE_OUTPUTS_MAX_GB"
+              }
+            }
+          },
+          "additionalProperties": false
+        },
+        "caches": {
+          "type": "object",
+          "properties": {
+            "buildCacheMaxGb": {
+              "description": "Shared native build-cache cap in GiB; 0 means no cap",
+              "type": "number",
+              "minimum": 0,
+              "default": 10,
+              "x-stim": {
+                "key": "caches.buildCacheMaxGb",
+                "kind": "number",
+                "scopes": [
+                  "machine"
+                ],
+                "env": "STIM_CACHES_BUILD_CACHE_MAX_GB"
+              }
+            },
+            "metroCacheMaxGb": {
+              "description": "Combined Metro transform-cache cap in GiB; 0 means no cap",
+              "type": "number",
+              "minimum": 0,
+              "default": 5,
+              "x-stim": {
+                "key": "caches.metroCacheMaxGb",
+                "kind": "number",
+                "scopes": [
+                  "machine"
+                ],
+                "env": "STIM_CACHES_METRO_CACHE_MAX_GB"
+              }
+            },
+            "swiftCompilationCacheMaxGb": {
+              "description": "Swift compilation-cache cap in GiB; planned emptying is whole; 0 means no cap",
+              "type": "number",
+              "minimum": 0,
+              "default": 15,
+              "x-stim": {
+                "key": "caches.swiftCompilationCacheMaxGb",
+                "kind": "number",
+                "scopes": [
+                  "machine"
+                ],
+                "env": "STIM_CACHES_SWIFT_COMPILATION_CACHE_MAX_GB"
+              }
+            },
+            "buildCache": {
+              "description": "Absolute path of the shared build cache",
+              "type": "string",
+              "x-stim": {
+                "key": "caches.buildCache",
+                "kind": "path",
+                "scopes": [
+                  "machine"
+                ],
+                "absolute": true,
+                "env": "STIM_BUILD_CACHE"
+              }
+            },
+            "metroCache": {
+              "description": "Absolute parent path of the Metro transform caches",
+              "type": "string",
+              "x-stim": {
+                "key": "caches.metroCache",
+                "kind": "path",
+                "scopes": [
+                  "machine"
+                ],
+                "absolute": true,
+                "env": "STIM_METRO_CACHE"
+              }
+            }
           },
           "additionalProperties": false
         },
@@ -1136,33 +1771,146 @@
           },
           "additionalProperties": false
         },
-        "caches": {
+        "hosting": {
           "type": "object",
           "properties": {
-            "buildCache": {
-              "description": "Absolute path of the shared build cache",
+            "machines": {
+              "description": "Tailscale names of the Macs that may host owned simulator sessions for this one, each optionally with :<port> of its tailscale serve route (default 7443); doctor --fix asks for separate device-host approval",
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "x-stim": {
+                "key": "hosting.machines",
+                "kind": "strings",
+                "scopes": [
+                  "machine"
+                ]
+              }
+            },
+            "agentDriver": {
+              "description": "Tool this Mac starts so a client's coding agent can drive the macOS apps and iOS simulators it hosts for that client; none starts nothing",
               "type": "string",
+              "enum": [
+                "none",
+                "agent-device"
+              ],
+              "default": "none",
               "x-stim": {
-                "key": "caches.buildCache",
-                "kind": "path",
+                "key": "hosting.agentDriver",
+                "kind": "choice",
+                "scopes": [
+                  "machine"
+                ]
+              }
+            }
+          },
+          "additionalProperties": false
+        },
+        "server": {
+          "type": "object",
+          "properties": {
+            "acceptClientBuilds": {
+              "description": "Whether a Mac approved for builds or device hosting here may update this Mac's stim-server service to that Mac's own stim-server build; releases from npm need no setting",
+              "type": "boolean",
+              "default": false,
+              "x-stim": {
+                "key": "server.acceptClientBuilds",
+                "kind": "boolean",
+                "scopes": [
+                  "machine"
+                ]
+              }
+            }
+          },
+          "additionalProperties": false
+        },
+        "offload": {
+          "type": "object",
+          "properties": {
+            "machines": {
+              "description": "Tailscale names of the Macs that may build for this one, each optionally with :<port> of its tailscale serve route (default 7443)",
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "x-stim": {
+                "key": "offload.machines",
+                "kind": "strings",
+                "scopes": [
+                  "machine"
+                ]
+              }
+            },
+            "machine": {
+              "description": "Build placement: auto follows offload.mode with local fallback; local always builds here; a name in offload.machines requires that machine without fallback. The ios, android and macos --build-machine flag overrides this setting and its environment override",
+              "type": "string",
+              "pattern": "^[A-Za-z0-9][A-Za-z0-9.-]*(?::(?!0+$)(?:[0-5]?[0-9]{1,4}|6[0-4][0-9]{3}|65[0-4][0-9]{2}|655[0-2][0-9]|6553[0-5]))?$",
+              "default": "auto",
+              "x-stim": {
+                "key": "offload.machine",
+                "kind": "string",
                 "scopes": [
                   "machine"
                 ],
-                "absolute": true,
-                "env": "STIM_BUILD_CACHE"
+                "env": "STIM_OFFLOAD_MACHINE"
               }
             },
-            "metroCache": {
-              "description": "Absolute parent path of the Metro transform caches",
+            "mode": {
+              "description": "When offload.machine is auto, where iOS simulator Debug, Android emulator debug and macOS SwiftPM Debug builds run: auto builds here while this Mac has a free concurrency.maxBuilds slot and its load is under offload.maxLoadPerCore, and otherwise offloads to a less loaded machine in offload.machines; force offloads whenever a machine can take the build; off always builds here",
               "type": "string",
+              "enum": [
+                "auto",
+                "force",
+                "off"
+              ],
+              "default": "auto",
               "x-stim": {
-                "key": "caches.metroCache",
+                "key": "offload.mode",
+                "kind": "choice",
+                "scopes": [
+                  "machine"
+                ],
+                "env": "STIM_OFFLOAD_MODE"
+              }
+            },
+            "maxLoadPerCore": {
+              "description": "Load per core (5-minute load average divided by the CPU count) at which a Mac counts as saturated: a build machine declines offloaded builds, and auto offload stops preferring this Mac",
+              "type": "number",
+              "minimum": 0.1,
+              "default": 2,
+              "x-stim": {
+                "key": "offload.maxLoadPerCore",
+                "kind": "number",
+                "scopes": [
+                  "machine"
+                ]
+              }
+            },
+            "workerRoot": {
+              "description": "Directory where stim-server keeps the checkouts, dependencies and build state of Macs that build here; default $STIM_HOME/build-worker",
+              "type": "string",
+              "x-stim": {
+                "key": "offload.workerRoot",
                 "kind": "path",
                 "scopes": [
                   "machine"
                 ],
-                "absolute": true,
-                "env": "STIM_METRO_CACHE"
+                "absolute": true
+              }
+            },
+            "gradleDaemonIdleMinutes": {
+              "description": "Minutes the Gradle daemon of an offloaded Android build stays warm on this build machine after the build; 0 stops it when the build ends",
+              "type": "integer",
+              "minimum": 0,
+              "maximum": 35791,
+              "default": 30,
+              "x-stim": {
+                "key": "offload.gradleDaemonIdleMinutes",
+                "kind": "number",
+                "scopes": [
+                  "machine"
+                ]
               }
             }
           },