Struct Activity 

pub struct Activity {
    pub agent_id: String,
    pub collective_id: CollectiveId,
    pub current_task: Option<String>,
    pub context_summary: Option<String>,
    pub started_at: Timestamp,
    pub last_heartbeat: Timestamp,
}

A stored agent activity — presence record within a collective.

Activities track which agents are currently operating in a collective, what they’re working on, and when they last checked in. This enables agent coordination and discovery.

Key Design

Activities are uniquely identified by (collective_id, agent_id). Re-registering with the same pair replaces the existing activity (upsert semantics).

Staleness

An activity is considered stale when last_heartbeat is older than Config::activity::stale_threshold. Stale activities are excluded from get_active_agents() results but remain in storage until explicitly ended or the collective is deleted.

Fields

agent_id: String

The agent’s identifier (e.g., “claude-opus”, “agent-47”).

collective_id: CollectiveId

The collective this activity belongs to.

current_task: Option<String>

What the agent is currently working on (max 1KB).

context_summary: Option<String>

Summary of the agent’s current context (max 1KB).

started_at: Timestamp

When this activity was first registered.

last_heartbeat: Timestamp

When the agent last sent a heartbeat.

Trait Implementations

impl Clone for Activity

fn clone(&self) -> Activity

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Activity

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Activity

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for Activity

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.