Repository navigation
Description
Request: #1181
Problem
In the reporter's words: "I want this worker to lease only physical Android devices that I've enrolled with simlock device add --platform android <serial>. If none is plugged in, an Android lease should fail instead of falling back to booting an emulator."
"There doesn't seem to be a way to configure this." Setting capacity.config.limits.android.maxDevices and maxRunning to 0 is refused, because both must be 1 or more, "and I don't know whether these limits also count physical devices." They do not: only simulators and emulators count.
"I test on real Android hardware and never want an emulator on this machine. Emulators use a lot of RAM (the default budget is 4 GiB per device), and a test that silently runs on an emulator when I expected a phone gives misleading results. … I often just ask the agent to test using simlock, I don't want it to boot a emulator whenever I forgot to specifically ask for a physical phone."
Today a lease without --physical always gets a simulator or emulator, and the warm pool boots them on its own.
Who it is for
An operator who runs a worker for real phones only, alone or joined to a gateway, with agents that lease through it and sometimes forget --physical. On iOS, the same operator with iPhones and iPads only.
Outcome
- The operator turns virtual devices off for one platform with one setting:
simlock config set android.virtualDevices false(orios.virtualDevices), then a restart. - From then on that worker never creates, boots or keeps a simulator or emulator of that platform.
- A lease of that platform without
--physicalis refused at once with a message that says the worker serves enrolled devices only and how to ask for one (--physicalat the CLI,physical: trueover MCP and HTTP). It never waits and never downloads. - A lease with
--physicalworks exactly as today: granted, waiting, or refused when no enrolled device could match. - Through a gateway, a lease without
--physicalgoes to a worker that still makes virtual devices. When no such worker has the platform, it gets the same message.
How it works for the user
flowchart TD
A[Operator: config set android.virtualDevices false, restart] --> B[Worker deletes its idle emulators]
C[Agent: simlock lease --platform android] --> D{--physical?}
D -- no --> E[UNKNOWN_MODEL: only enrolled devices, ask for a physical one]
D -- yes --> F{An enrolled phone could match?}
F -- no --> G[UNKNOWN_MODEL: no enrolled device can match]
F -- yes --> H{Free and plugged in?}
H -- yes --> I[Phone granted]
H -- no --> J[Waits, or NO_CAPACITY with --no-wait]
Before:
$ simlock config set capacity.config.limits.android.maxDevices 0
{"error":{"code":"USAGE","message":"Invalid config after setting capacity.config.limits.android.maxDevices: Invalid config value for \"capacity.config.limits.android.maxDevices\": expected a positive integer"}}
$ simlock config set android.virtualDevices false
{"error":{"code":"USAGE","message":"Invalid config after setting android.virtualDevices: Unknown config key: \"android.virtualDevices\""}}
$ simlock lease --platform android
{"leaseId":"…","device":{"platform":"android","model":"Pixel 9","physical":false,…}}
After:
$ simlock config set android.virtualDevices false
Updated android.virtualDevices in /Users/alex/.simlock/config.json; takes effect on daemon restart.
$ simlock daemon stop && simlock daemon start
$ simlock lease --platform android
{"error":{"code":"UNKNOWN_MODEL","message":"This worker serves only enrolled physical android devices (android.virtualDevices is false); ask for a physical device (--physical, or physical: true)"}}
$ echo $?
12
$ simlock lease --platform android --physical
{"leaseId":"…","device":{"platform":"android","model":"Pixel 8","physical":true,"class":"phone",…}}
$ simlock catalog --platform android
Platform: android
Virtual devices: off (android.virtualDevices is false); only enrolled physical devices are leased
Runtimes: (none) (default: (none))
Models: (none)
Examples
On a worker with android.virtualDevices: false, ios.virtualDevices left at true, and one enrolled Pixel 8 on API 35:
| Request | Today | After |
|---|---|---|
--platform android |
emulator granted | UNKNOWN_MODEL, phones-only message, at once |
--platform android --device "Pixel 9" |
emulator granted | UNKNOWN_MODEL, phones-only message |
--platform android --os ">=34" |
emulator granted | UNKNOWN_MODEL, phones-only message |
--platform android --image-tag google_apis_playstore |
emulator, or RUNTIME_MISSING |
UNKNOWN_MODEL, phones-only message |
--platform android --allow-download --os 36 |
downloads, then emulator | UNKNOWN_MODEL, phones-only message; nothing downloads |
--platform android --baseline checkout |
copy of the baseline | UNKNOWN_MODEL, phones-only message |
--platform android --no-wait |
emulator, or NO_CAPACITY |
UNKNOWN_MODEL, phones-only message |
--platform android --physical |
Pixel 8 granted | Pixel 8 granted |
--platform android --physical --device "Pixel 7" |
UNKNOWN_MODEL, no enrolled device can match |
same |
--platform android --physical --no-wait, Pixel 8 leased |
NO_CAPACITY |
same |
--platform android --physical --image-tag x |
BAD_REQUEST |
same |
--platform ios |
simulator granted | simulator granted |
simlock config set android.virtualDevices false |
refused, exit 2: Unknown config key: "android.virtualDevices" |
written; takes effect on daemon restart |
simlock config set android.virtualDevices no |
refused, exit 2: unknown key | refused, exit 2: expected a boolean |
simlock config set capacity.config.limits.android.maxDevices 0 |
refused, exit 2: expected a positive integer |
same |
What could go wrong
- An agent that never reads errors keeps retrying a plain lease. Likely only for scripts; the message names the fix.
- An operator turns the switch off on a worker that also serves emulator users. They see
UNKNOWN_MODELon their next lease. Likely once; the message names the key. - Idle emulators are deleted at the restart. An operator who expected them to stay loses nothing that a later lease would not make again; baselines stay.
- Behind an older gateway, the plain lease gets the old "no model of class phone is listed" message.
Words used
- virtual device: a simulator or emulator Simlock makes itself, e.g. an Android emulator copied from a seed.
- physical device (phone): a real device an admin enrolled with
simlock device add, e.g. a Pixel 8 on USB. iPads count too. - phones-only platform: a platform whose
<platform>.virtualDevicesisfalseon this worker. - plain lease: a lease request without
--physical. - idle device: a virtual device no lease holds and no operation has claimed,
readyorshutdown. - warm pool: what keeps idle virtual devices booted ahead of leases, from configured targets and kinds it learned.
- catalog: the list of models, runtimes and images a worker reports, read by
simlock catalogand by a gateway to route.
Non-goals
- Starting Android with only
adbinstalled: the full SDK (emulator, avdmanager, sdkmanager, adb) stays required. A later request. - Serving a plain lease with a phone.
- Allowing
0for the capacity limits. - Refusing
simlock component installon a phones-only platform: an operator may still install and remove images and runtimes. - Changing the setting without a restart.
- Deleting saved baselines or seeds when the switch is turned off.
- Marking baselines as unusable in
simlock baseline list.
Completion conditions
- With
android.virtualDevices: false, every plain Android lease in Examples answersUNKNOWN_MODELwith the phones-only message at once, and no emulator is created, booted or downloaded for it. - With it, an Android
--physicallease is granted, waits and is refused exactly as on a worker without it. - With it, a configured Android warm target and an Android learned kind boot nothing, and an iOS target still fills.
- With it, the worker's idle Android emulators are gone after a restart, a leased one is deleted at its release, and saved baselines are still listed by
simlock baseline list. simlock catalogshows the phones-only line for that platform, andcatalog.getcarriesvirtualDevices: false.- With it,
simlock doctorreports a configured Android warm target as unreachable becauseandroid.virtualDevicesis false. ios.virtualDevices: falsedoes the same for iOS.- Through a gateway whose only Android worker is phones-only, a plain Android lease gets the gateway's phones-only message, and
--physicalis routed to that worker. - The configuration reference, the physical devices page, the errors pages and the gateway routing page describe the setting.
Open questions
Decisions
- ADR 0084 — A worker may serve a platform's enrolled phones only (PR docs(adr): propose 0084, a worker may serve a platform's enrolled phones only (#1588) #1592): the per-platform key, what it turns off, the refusal, and the catalog field a gateway reads. Renumbered from 0080, which main gave to the network-phones ADR (docs(adr): propose 0079, an Android worker may enrol phones reached over the network (#1589) #1594); 0081–0083 are reserved by open ADR PRs (decided in delivery, pending the maintainer).
- ADR 0022 — A physical device is a second device type: "a lease without
--physicalnever gets a physical device" stays true; narrowed by 0084. - ADR 0009 — Gateway routing: §4's table gains the phones-only answer (0084 §3).
- ADR 0065 — A driver owns its config keys: this key is core's, beside
defaultModeanddefaultModels, because core, leasing and the gateway act on it and no driver does. - Decided in the session: both platforms, one key each (maintainer, 2026-11-16).
- Decided in the session: a plain lease on a phones-only platform is refused, never served by a phone (maintainer, 2026-11-16).
- Decided in the session: the full Android SDK stays required (maintainer, 2026-11-16).
- Decided in the session: the key is
<platform>.virtualDevices, a boolean, defaulttrue(maintainer, 2026-11-16). - Decided in the session: the refusal is
UNKNOWN_MODELwith its own message, no new code (maintainer, 2026-11-16). - Decided in the session: at start, idle virtual devices of the platform are deleted, leased ones run to their release, baselines stay (maintainer, 2026-11-16).
- Decided in the session: a gateway gives the same message, read from a field on each worker's catalog entry, one protocol bump (maintainer, 2026-11-16).
- Decided in the session:
component installstays allowed (maintainer, 2026-11-16). - Decided in the session:
baseline listis unchanged; a lease naming a baseline of that platform gets the phones-only refusal, because a mark on each baseline would change the baseline schema for a message the lease already gives. - Decided in the session: the refusal happens in leasing's one resolve step, before the baseline branch, so lease requests, warm targets and learned kinds are all refused by the same check; the warm pool's only change is I9.
- Decided in the session: the worker's catalog entry for a phones-only platform keeps the platform with empty lists, because a gateway routes a
--physicalrequest only to a worker whose catalog has the platform (src/gateway/routing/serviceability.ts:207). - Decided in the session: learned kinds of that platform are forgotten by the existing catalog check, since the empty catalog lists none of them; they are learned again once the key is back on.
- Decided in the session: the setting takes effect on restart, as every key does.
- Decided in the session: a shutdown or delete that fails at start is logged and the start goes on; the device stays as I6 says and the next start tries again.
- Decided in the session: doctor reports a phones-only platform's warm target with its own text and fix (maintainer, 2026-11-16).
- Decided in the session: the refusal names both
--physicalandphysical: true, so an MCP or HTTP caller can act on it (maintainer, 2026-11-16). - Decided in the session: an off platform's
warmPool.reserveRunningcounts as 0 (maintainer, 2026-11-16). - Decided in the session: the startup delete uses a new initiator,
virtual-devices-off, ondevice.shutdownanddevice.deleted, because EVENTS.md names each delete by its cause. - Decided in the session: the gateway's merged catalog carries
virtualDevices: falsefor a platform only when every worker reporting it does, sosimlock catalogthrough a gateway says "off" only when no worker would serve a plain lease.
Behaviours
| Id | Behaviour (invoker, action, what it sees) | Seam | Cases | Task |
|---|---|---|---|---|
| B1 | An operator sets <platform>.virtualDevices (I1): config set accepts a boolean and refuses anything else with the boolean message; config get shows the value, true when unset |
loadConfig with the driver sections, and simlock config set / config get |
android false; ios false; unset (true); no (refused, expected a boolean); 0 (refused); a gateway's config holding it (ignored with the worker-key warning) |
#1598 |
| B2 | An agent sends a plain lease on a phones-only platform: it is admitted as today (stored, lease.requested), then refused at its resolve step with I2 as today's unresolvable-spec rejection, before any catalog read, download or wait; the other platform is served as today |
lease.request through the worker dispatcher, with the fake drivers |
every plain row of Examples (no model, named model, OS range, image tag, allowDownload, baseline, noWait); iOS --mode slim with except; the other platform still granted; the fake driver's resolveSpec, listCatalog and installComponent never called |
#1598 |
| B3 | An agent sends a --physical lease on a phones-only platform: granted, waiting or refused exactly as on any worker |
lease.request through the worker dispatcher, with the fake drivers |
free enrolled phone (granted); every match leased (waits); same with noWait (NO_CAPACITY); no enrolled match (UNKNOWN_MODEL, today's message) |
#1598 |
| B4 | The warm pool runs on a worker with a phones-only platform: that platform's configured targets report short unknown-model (the refusal refusalOf gives I2, so no last spec is kept and no device is spared) and boot nothing, its learned kinds are forgotten, and its reserveRunning counts as 0 in the plan and in doctor (I9); the other platform fills |
core with leasing, the warm-pool converger, fake drivers | configured Android target; Android learned kind from before the switch; reserveRunning.android: 2 with an iOS target on a global budget it would otherwise squeeze (iOS target filled, not short reserve; doctor's room sum leaves it out); iOS target (filled) |
#1598 |
| B5 | The worker starts with a platform phones-only: every idle virtual device of that platform is deleted (a ready one shut down first) with its usual device.deleted, a leased one is kept and deleted at its release, phones and the other platform are untouched; a delete that fails is logged (I6) and the start goes on |
daemon start, core.converge (StartupConverger), fake drivers |
ready idle (device.shutdown, then device.deleted, both initiator virtual-devices-off); shutdown idle (device.deleted only); leased (kept, then deleted at release, initiator lease-end); claimed (left); enrolled phone (untouched); iOS idle device (kept); a saved Android baseline (still in baseline list after the start); fake driver's destroy throws (I6 logged, device shutdown, start completes); fake driver's shutdown throws (I6 logged, device stays ready, start completes) |
#1598 |
| B6 | A caller reads the catalog of a phones-only worker: the platform's entry has empty lists and virtualDevices: false (I4, I5) without asking the driver, and simlock catalog prints I7 |
catalog.get through the dispatcher; simlock catalog |
--platform android; no platform (both entries, iOS full); --json; the fake driver's listCatalog never called for Android |
#1598 |
| B7 | An operator manages components on a phones-only platform: component install, list and remove work as today |
component.install, component.list, component.remove through the dispatcher, fake drivers |
install an Android image; list; remove it | #1598 |
| B8 | An agent sends a plain lease through a gateway: when every known worker with the platform reports virtualDevices: false, it fails at once with I3; when one does not, it is routed there; a --physical lease still reaches a phones-only worker |
gateway assess and select over worker views (src/gateway/routing), and lease.request through the gateway dispatcher with fake links |
one phones-only worker (I3); phones-only plus an emulator worker (routed to the emulator worker); phones-only worker and a worker without the field (routed to the second); one worker without the field and no models (today's UNKNOWN_MODEL message); --physical to the phones-only worker (granted) |
#1599 |
| B10 | An operator runs simlock doctor on a worker with a configured warm target on a phones-only platform: the finding is I8, not "is not a known model" |
doctor.run through the dispatcher (core Doctor with the warm pool's figures), fake drivers |
Android target, android.virtualDevices: false (I8); the same target with the key true and an unknown model (today's text); iOS target on a worker whose Android is off (today's findings) |
#1598 |
| B9 | A caller reads the catalog through a gateway: the merged entry carries virtualDevices: false only when every worker reporting the platform does |
aggregateCatalog (src/gateway/aggregate.ts), catalog.get through the gateway |
two phones-only workers (false); one phones-only and one emulator worker (absent, the emulator worker's lists) | #1599 |
Stored state
| Id | What and where | Created, changed, deleted by | Listed or swept by | A restart mid-step leaves | Schema step | Task | Used by |
|---|---|---|---|---|---|---|---|
| S1 | ios.virtualDevices and android.virtualDevices in the user's config.json (I1) |
the operator, by simlock config set or by hand; read once at start |
config get; daemon.started's config snapshot |
— (read at start only) | none | #1598 | #1599 |
The devices B5 deletes are today's registry rows and driver folders, deleted by today's ManagedDeviceLifecycle.shutdown and destroy; a restart in the middle leaves a shutdown row that the next start deletes.
Interfaces
| Id | What | Shape and bounds | Errors and limits | Where | Task | Used by |
|---|---|---|---|---|---|---|
| I1 | Config keys ios.virtualDevices, android.virtualDevices |
boolean, optional, default true; core keys of the platform section (Config["ios"], Config["android"]), beside defaultMode and defaultModels; worker only |
a non-boolean fails the load as every boolean key does (booleanValue: Invalid config value for "<key>": expected a boolean, config set exit 2); on a gateway, the worker-key warning of src/core/config-role-checks.ts:96 |
src/core/config-types.ts, config-defaults.ts, config-validators.ts; website reference/configuration.mdx |
#1598 | #1599 |
| I2 | Worker refusal VirtualDevicesOffError, a subclass of UnknownModelError carrying the request's model or class |
code UNKNOWN_MODEL (exit 12, HTTP 422), details { platform, model? , class? } as today; message This worker serves only enrolled physical <platform> devices (<platform>.virtualDevices is false); ask for a physical device (--physical, or physical: true) |
thrown by AcquisitionSpecResolver.resolveSpec before the baseline branch, so resolve (warm targets) answers refusal unknown-model with the same message; mapped by the existing UnknownModelError branch of src/daemon/error-code.ts:129 |
src/leasing/acquisition-spec-resolver.ts, acquisition-errors.ts |
#1598 | — |
| I3 | Gateway refusal, a row of assessLeading after the NO_DRIVER row, for a plain request only |
code UNKNOWN_MODEL, reason unresolvable-spec, details { platform, model?, class? }; message Every worker with <platform> serves only enrolled physical <platform> devices (<platform>.virtualDevices is false); ask for a physical device (--physical, or physical: true) |
applies when no known worker lists the model and every known worker whose catalog has the platform reports virtualDevices: false |
src/gateway/routing/serviceability.ts |
#1599 | — |
| I4 | DriverCatalog.virtualDevices(platform): boolean, and the option virtualDevices: Partial<Record<Platform, boolean>> it is built with in createCore from I1 |
false only for a platform whose key is false; listCatalog for that platform answers { platform, models: [], runtimes: [], defaultRuntime: undefined, modelRuntimes: {}, modelAliases: {}, modelClasses: {}, classDefaults: {}, virtualDevices: false } (no images key) and never calls the driver's listCatalog |
— | src/core/driver-catalog.ts, src/core/create-core.ts (CoreConfig gains ios and android), leasing's catalog port (src/leasing/acquisition-ports.ts:62) |
#1598 | #1599 |
| I5 | Catalog entry field virtualDevices on platformCatalogSchema |
z.literal(false).optional(); absent means virtual devices are served; bumps the protocol by one |
an older gateway strips it and keeps today's answers | src/contract/status-schemas.ts, src/contract/protocol.ts |
#1598 | #1599 |
| I6 | Startup's delete of an idle device on a phones-only platform: ManagedDeviceLifecycle.shutdown (a ready device) then destroy, both with the new initiator virtual-devices-off, added to the device.shutdown and device.deleted rows of EVENTS.md and the website events page |
log at warn: Could not delete an idle device at start with { deviceId, platform, error } |
a failed destroy leaves the device shutdown; a failed shutdown leaves it ready (released with no commit); either way the start goes on and the next start tries again |
src/core/startup-converger.ts, wired in src/core/create-core.ts |
#1598 | — |
| I8 | Doctor's finding for a configured warm target whose platform's virtualDevices is false, checked first in unreachableTarget |
kind warm-pool-target-unreachable, reason unknown-model, target as today; message <target> cannot be met: <platform>.virtualDevices is false; remedy remove the target from warmPool.targets, or set <platform>.virtualDevices true |
— | src/core/doctor-findings.ts:157, src/core/doctor-types.ts:142 (DoctorConfig gains ios and android); website doctor page |
#1598 | — |
| I9 | The warm pool's reserve for an off platform | reservedOf and doctor's reserve sum read the platform's virtualDevices and take its reserve as 0 when false; the pool's config slice gains ios.virtualDevices and android.virtualDevices from createCore |
— | src/core/warm-pool/policy.ts:222-224, src/core/warm-pool/converger.ts:662-667 (the policy view's config), src/core/doctor.ts:567-568 |
#1598 | — |
| I7 | simlock catalog's line for an entry with virtualDevices: false, right after Platform: <platform> |
Virtual devices: off (<platform>.virtualDevices is false); only enrolled physical devices are leased |
— | src/cli/commands/catalog.ts |
#1598 | #1599 |
Existing code
Commit 5e639b4.
Searches: listCatalog\( 20 hits outside tests; resolveSpec\( 25; \.provision\( 12 (src/core/device-provisioner.ts:137 and the leasing and warm-pool callers through it); bootWarm\( 2; platformCatalogSchema 6; NO_DRIVER and UNKNOWN_MODEL in src/gateway/routing; virtualDevices 58 (all the registry's snapshot.virtualDevices, none a config key).
| Id | Code (path:line) | Today | With this feature | Handled by |
|---|---|---|---|---|
| X1 | src/core/config-validators.ts:255-263, src/core/config-types.ts:166-172, src/core/config-defaults.ts:152-153 |
the platform sections hold core's defaultMode (iOS) and defaultModels, then the driver's keys |
virtualDevices added to both |
I1, B1 |
| X2 | src/leasing/acquisition-spec-resolver.ts:53-72 |
resolveSpec takes the baseline branch first, then resolves a model, class or range |
I2 is checked first, through catalog.virtualDevices |
I2, B2 |
| X3 | src/leasing/acquisition-spec-resolver.ts:287-305, :339-343 |
resolve (warm targets and learned kinds) calls resolveSpec with downloads off; UnknownModelError maps to unknown-model |
the refusal reaches the pool as unknown-model with I2's message; no boot |
B4 |
| X4 | src/leasing/acquisition-workflow.ts:116-131 |
a --physical request skips spec resolution and checks enrolled devices |
unchanged | B3 |
| X5 | src/core/driver-catalog.ts:195-215 |
listCatalog asks every driver and adds classDefaults |
an off platform answers I4's empty entry without the driver | I4, B6 |
| X6 | src/core/warm-pool/catalog-check.ts:43-53 |
gone forgets a learned kind the latest catalog answer does not list |
forgets every kind of the off platform | B4 |
| X7 | src/core/startup-converger.ts:46-88, src/core/create-core.ts:390-405 |
startup recovers interrupted reclaims, then deletes spent shutdown devices on readable platforms |
a third step deletes every idle device of an off platform, ready ones through ManagedDeviceLifecycle.shutdown (src/core/managed-device-lifecycle.ts:168) then destroy (:190) |
B5, I6 |
| X8 | src/core/reclaim-coordinator.ts:305-312 |
deleteSpent refuses a device that mayBeGranted, so it cannot delete a never-leased idle one |
not used for B5 | B5 |
| X9 | src/contract/status-schemas.ts:273-292, src/contract/protocol.ts:13 |
the catalog entry has no field about virtual devices; protocol range { min: 89, max: 89 } |
I5's field; max +1, min unchanged | I5 |
| X10 | src/cli/commands/catalog.ts:37-78 |
prints runtimes, models and images per platform, (none) when empty |
prints I7 first for an off entry | I7, B6 |
| X11 | src/gateway/routing/serviceability.ts:197-235 |
assessLeading: NO_DRIVER when no known worker has the platform, then the physical branch, then UNKNOWN_MODEL "listed by any worker in the fleet" |
I3's row before the generic model row, plain requests only | I3, B8 |
| X12 | src/gateway/routing/stages/can-serve.ts:4-14, src/gateway/routing/request-match.ts:183-186 |
a worker with the platform but no models answers unknown-model; a --physical request needs only enrolled devices and the platform entry |
unchanged: a phones-only worker is passed over for plain requests and picked for --physical |
B8 |
| X13 | src/gateway/aggregate.ts:247-275, :365-375 |
the merged entry is the union of the workers' lists | carries I5's false only when every worker's entry does |
B9 |
| X14 | src/daemon/dispatcher-components.ts:107-115 |
component.install refuses only under downloads.policy: "never" |
unchanged | B7 |
| X15 | src/core/doctor.ts:507-526 and src/core/doctor-findings.ts:233 |
doctor reports a configured warm target it could not meet | an Android target on an off platform is reported with I8's text (today's code would say " is not a known Android model", src/core/doctor-findings.ts:209-219, since WarmTargetFigures carries only short) |
B10, I8 |
| X18 | src/core/warm-pool/policy.ts:222-224, :620; src/core/doctor.ts:567-568 |
the reserve of every platform is added to the machine-wide held slots, so an iOS target can be short reserve |
an off platform's reserve is 0 | I9, B4 |
| X16 | src/core/capacity/devices.ts:21-25 |
capacity counts only virtual devices | unchanged: phones never counted; the off platform has none | — |
| X17 | website/src/content/docs/docs/using-devices/physical-devices.mdx:43-59, using-devices/errors.mdx:40-54, reference/errors.mdx:51, reference/configuration.mdx:205-224, the gateway routing page |
describe plain and physical leases, UNKNOWN_MODEL, and the platform keys |
a "Serve enrolled devices only" section, the key rows, and the new UNKNOWN_MODEL cause on each page |
#1598 (worker pages), #1599 (gateway routing page) |
Tasks
flowchart LR
A["#1598 worker"] --> B["#1599 gateway"]
- A worker serves only enrolled devices on a platform whose virtualDevices is false #1598 A worker serves only enrolled devices on a platform whose virtualDevices is false — an operator turns a platform's simulators or emulators off with one key, and a plain lease there is refused with a message naming the fix. Risk: an emulator still boots, a
--physicallease breaks, or an idle device of the other platform is deleted. - Through a gateway, a plain lease that only phones-only workers could serve gets the phones-only refusal #1599 Through a gateway, a plain lease that only phones-only workers could serve gets the phones-only refusal — the same answer through a gateway, and correct routing in a mixed fleet. Risk: a plain lease waits or names the wrong fix, or
--physicalstops reaching the phones-only worker.
Completion conditions:
- Plain Android leases refused, nothing made: A worker serves only enrolled devices on a platform whose virtualDevices is false #1598 (B2).
--physicalleases as today: A worker serves only enrolled devices on a platform whose virtualDevices is false #1598 (B3).- Warm targets and learned kinds boot nothing: A worker serves only enrolled devices on a platform whose virtualDevices is false #1598 (B4).
- Idle emulators deleted at restart, baselines listed: A worker serves only enrolled devices on a platform whose virtualDevices is false #1598 (B5).
- Catalog line and field: A worker serves only enrolled devices on a platform whose virtualDevices is false #1598 (B6).
- Doctor names the key: A worker serves only enrolled devices on a platform whose virtualDevices is false #1598 (B10).
ios.virtualDevicesdoes the same: A worker serves only enrolled devices on a platform whose virtualDevices is false #1598 (B1–B6 iOS cases).- Through a gateway: Through a gateway, a plain lease that only phones-only workers could serve gets the phones-only refusal #1599 (B8).
- Docs: A worker serves only enrolled devices on a platform whose virtualDevices is false #1598 (worker pages), Through a gateway, a plain lease that only phones-only workers could serve gets the phones-only refusal #1599 (gateway routing page).
Open work in the same area:
- PR feat(backends): persist device backend ownership #1499 (draft, backends: persist device backend ownership) changes
src/core/driver-catalog.tsandsrc/core/startup-converger.ts, which A worker serves only enrolled devices on a platform whose virtualDevices is false #1598 changes too. It has no issue and is a draft, so no Depends on; whichever lands second rebases. - Restrict iOS lease modes on a worker #1557 (request, restrict iOS lease modes on a worker): a per-worker limit like this one; when it is specified, its key should read alike. No order.
- Android leases that name no image tag can get a Play Store emulator #1590, Android: configurable default image tag (e.g. google_apis_playstore) for leases that do not name one #1220 (Android emulator image tag defaults): same resolve path, untouched by the off branch. No order.
- PRs docs(adr): propose 0056, an operator sets warm targets at runtime (#1137) #1139 and docs(adr): propose 0057, the daemon owns config.json while it runs (#1151) #1152 (ADRs 0056 runtime warm targets, 0057 the daemon owns config.json): if they land, a runtime-set target or a live key change on a phones-only platform is theirs to decide. No order.
Written by an agent.
Activity
V3RON commentedon Nov 16, 2026
Design posted: every business section, Decisions (ADR 0078, PR #1592), Behaviours B1–B9, Stored state S1, Interfaces I1–I7 and Existing code X1–X17. Tasks come after the design check and approval.
Written by an agent.
docs(adr): accept 0078 (#1588)
V3RON commentedon Nov 16, 2026
Spec updated: task cells now name #1598 and #1599; the Tasks section is filled (order, completion conditions, open work in the same area). ADR 0078 is accepted, not yet implemented (PR #1592).
Written by an agent.
V3RON commentedon Nov 16, 2026
Spec updated: I9 and X18 added (an off platform's warm-pool reserve counts as 0), B4's reserve case rewritten, and the Decisions line added. #1598 and #1599 are task:ready. #1598 waits on #1595 and #1596, and #1599 waits on #1598 and #1596.
Written by an agent.
V3RON commentedon Nov 16, 2026
Delivery run
Merged: none
Parked: none
Waiting: #1598 — on #1595 (PR #1609) and #1596 (PR #1615, draft), both under #1590; #1599 — on #1598 and #1596
Written by an agent.
docs(adr): renumber the enrolled-phones ADR to 0080, 0078 and 0079 ar…
docs(adr): renumber the enrolled-phones-only ADR to 0084 (#1588)
docs(adr): propose 0084, a worker may serve a platform's enrolled pho…
feat(gateway): a phones-only platform through a gateway (#1657)
github-actions commentedon Nov 17, 2026
Closing: all 2 sub-issues are closed. The PR that closed the last one walks the completion conditions (delivery rule 9); reopen this if one does not hold on
main. Flip its ADRs to Accepted if delivery has not.V3RON commentedon Nov 17, 2026
Delivery run
Merged: #1592 (ADR 0084), #1623 (#1598), #1657 (#1599)
Parked: none
Waiting: none
Decided: #1599 — the gateway's phones-only refusal wording → I3's "Every worker with serves only…" (see #1657); #1588 — ADR number clash with main's 0080 (#1594) → this feature's ADR renumbered to 0084 (see #1592)
Written by an agent.