Struct AgentMetadata 

pub struct AgentMetadata {
    pub session_id: String,
    pub parent_agent_id: Option<String>,
    pub spawn_reason: Option<String>,
    pub model: String,
    pub created_at: i64,
    pub last_activity: i64,
    pub working_directory: String,
    pub is_busy: bool,
    pub pid: Option<u32>,
}

Metadata about an agent for registry and discovery

This is stored alongside the agent socket as a .meta.json file to enable agent discovery, tree visualization, and lifecycle management.

Fields

session_id: String

Unique session identifier

parent_agent_id: Option<String>

Parent agent that spawned this one (if any)

spawn_reason: Option<String>

Reason this agent was spawned (e.g., “Tool call: investigate auth bug”)

model: String

Model being used by this agent

created_at: i64

Unix timestamp (seconds) when agent was created

last_activity: i64

Unix timestamp (seconds) of last activity

working_directory: String

Working directory for this agent

is_busy: bool

Whether the agent is currently busy (processing a request)

pid: Option<u32>

Process ID of the agent (for liveness checking)

Implementations

impl AgentMetadata

pub fn new(session_id: String, model: String, working_directory: String) -> Self

Create new metadata for an agent

pub fn with_parent(self, parent_id: String, reason: Option<String>) -> Self

Set parent agent info

pub fn with_pid(self, pid: u32) -> Self

Set the process ID

pub fn touch(&mut self)

Update last activity timestamp

pub fn set_busy(&mut self, busy: bool)

Set busy state

Trait Implementations

impl Clone for AgentMetadata

fn clone(&self) -> AgentMetadata

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AgentMetadata

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for AgentMetadata

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl From<AgentMetadata> for RemoteAgentInfo

Convert from IPC AgentMetadata to Remote AgentInfo

fn from(meta: AgentMetadata) -> Self

Converts to this type from the input type.

impl Serialize for AgentMetadata

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

where __S: Serializer,

Serialize this value into the given Serde serializer.