Documentation
¶
Overview ¶
Package presence manages agent presence metadata. Each agent can set a status and optional note, stored as presence.json in their mailbox directory with a last_seen timestamp.
Index ¶
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func SetNotifierStatus ¶ added in v0.48.0
SetNotifierStatus records notifier capability without overwriting the agent's own presence status or note. Empty values clear a stale notifier diagnosis when a later wake starts with a usable injector.
func Touch ¶ added in v0.24.1
Touch updates the LastSeen timestamp for an agent's presence. If presence already exists, it preserves Status and Note. If no presence exists, it creates one with status "active".
func TouchDeliveryRoot ¶ added in v0.45.0
func TouchDeliveryRoot(root *fsq.DeliveryRoot, handle string) error
TouchDeliveryRoot updates presence through a pinned root capability.
func WriteDeliveryRoot ¶ added in v0.45.0
func WriteDeliveryRoot(root *fsq.DeliveryRoot, p Presence) error
WriteDeliveryRoot writes presence through an already authorized root capability. Send/reply use this form so a path alias change cannot redirect a best-effort presence update outside the authorized tree.
Types ¶
type Presence ¶
type Presence struct {
Schema int `json:"schema"`
Handle string `json:"handle"`
Status string `json:"status"`
LastSeen string `json:"last_seen"`
Note string `json:"note,omitempty"`
NotifierStatus string `json:"notifier_status,omitempty"`
NotifierMode string `json:"notifier_mode,omitempty"`
NotifierReason string `json:"notifier_reason,omitempty"`
}
Presence captures the current presence for an agent handle.