Struct AuditEvent 

pub struct AuditEvent {
    pub timestamp: DateTime<Utc>,
    pub event_id: String,
    pub event_type: AuditEventType,
    pub actor: Option<Actor>,
    pub action: Option<Action>,
    pub result: Option<ExecutionResult>,
    pub security: SecurityContext,
    pub agent_alias: Option<String>,
    pub sequence: u64,
    pub prev_hash: String,
    pub entry_hash: String,
    pub signature: Option<String>,
}

Complete audit event with Merkle hash-chain fields.

Fields

timestamp: DateTime<Utc>

event_id: String

event_type: AuditEventType

actor: Option<Actor>

action: Option<Action>

result: Option<ExecutionResult>

security: SecurityContext

agent_alias: Option<String>

Owning agent’s alias. None on system-level events (boot, migration, scheduler ticks not bound to any specific agent) and on legacy entries written before the field existed. Audit storage stays at <install>/audit/ (global, not per-agent), so an agent delete does NOT remove its prior audit trail; this field lets queries reconstruct per-agent activity after the fact.

sequence: u64

Monotonically increasing sequence number.

prev_hash: String

SHA-256 hash of the previous entry (genesis uses GENESIS_PREV_HASH).

entry_hash: String

SHA-256 hash of (prev_hash || canonical JSON of this entry’s content fields).

signature: Option<String>

Optional HMAC-SHA256 signature over entry_hash (present only when sign_events enabled)

Implementations

impl AuditEvent

pub fn new(event_type: AuditEventType) -> Self

Create a new audit event

pub fn with_actor( self, channel: String, user_id: Option<String>, username: Option<String>, ) -> Self

Set the actor

pub fn with_agent_alias(self, agent_alias: impl Into<String>) -> Self

Set the owning agent’s alias for multi-agent attribution. Builder method so existing AuditEvent construction sites can add the alias without an explicit field assignment. Pass the alias bound at agent-loop entry.

pub fn with_action( self, command: String, risk_level: String, approved: bool, allowed: bool, ) -> Self

Set the action

pub fn with_result( self, success: bool, exit_code: Option<i32>, duration_ms: u64, error: Option<String>, ) -> Self

Set the result

pub fn with_security(self, sandbox_backend: Option<String>) -> Self

Set security context

Trait Implementations

impl Clone for AuditEvent

fn clone(&self) -> AuditEvent

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AuditEvent

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for AuditEvent

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for AuditEvent

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

where __S: Serializer,

Serialize this value into the given Serde serializer.