Struct AgentEventMetadata 

pub struct AgentEventMetadata {
    pub session_id: SessionId,
    pub causal_context_hash: Hash,
    pub capability_id: Option<CapabilityId>,
    pub attestation_hash: Option<Hash>,
    pub reasoning: Option<String>,
    pub human_approved: bool,
}

Structured metadata embedded in agent audit events.

This is serialized to JSON and stored in the AuditEvent.metadata field, providing the full accountability context for any agent action.

Fields

session_id: SessionId

Session in which the action occurred.

causal_context_hash: Hash

Causal context linking this event to its origin.

capability_id: Option<CapabilityId>

Capability that authorized this action.

attestation_hash: Option<Hash>

Hash of the agent’s attestation for cross-reference.

reasoning: Option<String>

Reasoning summary for the action.

human_approved: bool

Whether human approval was obtained.

Implementations

impl AgentEventMetadata

pub fn new(session_id: SessionId, causal_context: &CausalContext) -> Self

Create metadata for an agent action.

pub fn with_capability(self, id: CapabilityId) -> Self

Set the capability that authorized this action.

pub fn with_attestation_hash(self, hash: Hash) -> Self

Set the attestation hash for cross-reference.

pub fn with_reasoning(self, reasoning: impl Into<String>) -> Self

Set the reasoning summary.

pub fn with_human_approval(self) -> Self

Mark that human approval was obtained.

pub fn to_bytes(&self) -> Vec<u8>

Serialize to bytes for embedding in AuditEvent metadata.

pub fn from_bytes(bytes: &[u8]) -> Result<Self>

Deserialize from AuditEvent metadata bytes.

Trait Implementations

impl Clone for AgentEventMetadata

fn clone(&self) -> AgentEventMetadata

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AgentEventMetadata

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for AgentEventMetadata

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for AgentEventMetadata

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

where __S: Serializer,

Serialize this value into the given Serde serializer.