Skip to content

Host Control Plane

The Host exposes its supervisor surface in two layers:

  1. host.supervisor — a raw NATS RPC mailbox at <root>.host.supervisor.PID-<pid>.$inbox. Owned by the Host process itself; the source of truth.
  2. host.control (HostControlActor) — a normal Matrix actor running in its own runtime. Wraps the supervisor with a friendlier actor surface and adds the device heartbeat behavior.

Both surfaces speak the same JSON envelope. Production callers go through host.control because it lives on the bus next to other actors; emergency callers go straight to host.supervisor.

Pages

  • Host supervisor actor — the host.supervisor RPC server, its subjects, ops, and envelope.
  • system.runtimes — the registry actor that owns per-runtime state on the bus, and how Host runtime records map to it.
  • Runtime records — the durable on-disk record, what changes it, and how to read/write it safely.
  • Local actor invocationmatrix invoke <mount> <op> and how the Host CLI implements it.
  • Remote control — calling these surfaces from a process other than the Host's own CLI.

See also