SessionStatus

sealed interface SessionStatus(source)

Durable per-node remote-administration session status, derived from the time of the last admin response that carried a session_passkey from the target node.

The Meshtastic firmware enforces a 300 s session TTL and rotates the passkey at the 150 s mark when sending any admin response (see firmware/src/modules/AdminModule.cpp:1460-1481). To leave headroom for in-flight packets and clock skew, the Android client treats sessions older than 240 s as Stale — still potentially usable for a single ping but the UI should refresh before navigating the user into a screen that fires more admin requests.

Inheritors

Types

Link copied to clipboard
data class Active(val refreshedAt: Instant) : SessionStatus

A fresh session passkey is on file and is well within the firmware TTL.

Link copied to clipboard
data object NoSession : SessionStatus

No admin response with a session passkey has ever been observed for this node since connect.

Link copied to clipboard
data class Stale(val refreshedAt: Instant) : SessionStatus

A session passkey is on file but the firmware may have already rotated it or be about to expire it; refresh before sending further admin traffic.