Skip to content

Inventory

The Inventory section covers how system.devices actually stores Device records, how presence ages out, how runtimes show up under a Device, and how ownership scoping prevents cross-tenant leakage.

Pages in this section

  • Device records — the in-memory IDeviceRecord shape, how presence and durable Host Link rows merge, and the source enum.
  • Heartbeatshost.control heartbeat path, frequency, TTLs, and what each heartbeat updates.
  • Online / offline status — the four-status enum (online / offline / linked / revoked) and the prune timer that drives it.
  • Runtime visibility — what devices.runtimes.list exposes about a Device's runtimes and what it deliberately omits.
  • Ownership — principal/Space/authority-root scoping rules and the "scope mutation cannot lose previous scope" rule.

Authority: system.devices is one of the singleton authority actors per WORKSTREAMS/core-and-packaging/MATRIX-AUTHORITY-MODEL.md. One live owner per authority root.