Struct InMemoryAuditTrail 

pub struct InMemoryAuditTrail { /* private fields */ }

In-memory audit trail backed by parking_lot::RwLock<Vec<AuditRecord>>.

Lock is never held across .await — all operations are synchronous inside the lock, then wrapped in Box::pin(async { ... }). parking_lot is used (not std::sync::RwLock) for ~2× faster uncontended read acquisition on the audit hot path (every turn, every tool call); see T2 in tasks/performance-audit-heartbit-core-2026-05-06.md.

Implementations

impl InMemoryAuditTrail

pub fn new() -> Self

Trait Implementations

impl AuditTrail for InMemoryAuditTrail

fn record( &self, entry: AuditRecord, ) -> Pin<Box<dyn Future<Output = Result<(), Error>> + Send + '_>>

Record a single audit entry. Best-effort: failures are logged, never abort the agent.

fn entries( &self, scope: &TenantScope, limit: usize, ) -> Pin<Box<dyn Future<Output = Result<Vec<AuditRecord>, Error>> + Send + '_>>

Tenant-scoped read. Returns the most recent limit entries whose tenant_id matches scope.tenant_id. Single-tenant scope (empty tenant_id) returns rows where tenant_id is None or "".

fn entries_unscoped( &self, limit: usize, ) -> Pin<Box<dyn Future<Output = Result<Vec<AuditRecord>, Error>> + Send + '_>>

Cross-tenant admin read. Renamed from the previous unscoped entries() so call sites must explicitly opt in to cross-tenant visibility. Returns the most recent limit entries.

fn entries_since( &self, scope: &TenantScope, since: DateTime<Utc>, limit: usize, ) -> Pin<Box<dyn Future<Output = Result<Vec<AuditRecord>, Error>> + Send + '_>>

Time-windowed scoped read. Returns the most recent limit entries for the given scope where timestamp >= since.

fn prune( &self, retain: Duration, ) -> Pin<Box<dyn Future<Output = Result<usize, Error>> + Send + '_>>

Delete entries older than now - retain. Returns count deleted.

fn erase_for_user( &self, user_id: &str, ) -> Pin<Box<dyn Future<Output = Result<usize, Error>> + Send + '_>>

Erase all audit records for the given user (GDPR right to erasure). Returns the number of records removed. Default: no-op returning 0.

impl Default for InMemoryAuditTrail

fn default() -> Self

Returns the “default value” for a type.