Skip to content

Events

Events are delivered after subscribe succeeds.

External events are compact deltas. They do not carry daemon-local event_seq, uptime_ms, or protocol_version fields; motor_state also omits the internal per-motor motor_seq counter.

motor_state

Reports motor state deltas, including availability changes through online. Fractional percent and target_percent values must be retained without integer truncation.

group_state

Reports processor-derived group state changes. External events never include the internal predicted marker. Group percentages may also be fractional.

Membership-affecting changes are recomputed by the processor, but an external event is emitted only when the confirmed tuple actually changes: group_state, percent presence/value, or target_percent presence/value.

registry_event

Reports motor or group registry changes that affect the external projection.

For a group create/update, the entity object contains only display_name. members, member_count, and derived state are forbidden. Membership-only updates are suppressed; name changes produce a compact registry update. Derived state arrives through group_state events and query_state snapshots.

Stream Convergence

Events have no replay or sequence-counter contract. On reconnect, query a fresh baseline and subscribe again.