Struct AiLogger 

pub struct AiLogger { /* private fields */ }

Producer-side log facade. One per AI subsystem; each agent connection gets a clone (cheap – internal state is Arc<Mutex<...>>).

Cheap-by-design: append is O(1) amortized, level gating is one HashMap lookup. Logging is not a hot path – per-chunk cost is the session/update decode + apply, not the log emission.

Implementations

impl AiLogger

pub fn new(default_min_level: AiLogLevel, default_capacity: usize) -> Self

Construct a logger with the given default min level and default per-session ring capacity (e.g. AiLogLevel::Info, 10_000). Conservative defaults: Info filters out debug/trace noise; 10k records ≈ a few MB of memory at most.

pub fn set_event_publisher(&self, publisher: AiLogEventPublisher)

Install / replace the event publisher. Subsequent log calls fire the closure with AiLogPushed after the record lands in its ring. The App wires this at boot so the runtime event bus sees every append; subscribers (live log views) drain the bus on tick.

pub fn with_defaults() -> Self

Sensible defaults: Info level, 10k records / ring.

pub fn log( &self, session: Option<&SessionKey>, level: AiLogLevel, source: AiLogSource, message: impl Into<String>, )

Append a record. Gated by per-session min level (or the default). Records with session = None route to the subsystem-wide ring (*ai*) and use the default min level.

pub fn set_session_level(&self, session: SessionKey, level: Option<AiLogLevel>)

Set per-session min level. None removes the override and reverts to the default.

pub fn set_default_level(&self, level: AiLogLevel)

Set the default min level (applies to subsystem-wide records and to sessions without an override).

pub fn set_default_capacity(&self, capacity: usize)

Set the default ring capacity. Existing rings are resized; future per-session rings inherit the new value.

pub fn snapshot_global(&self) -> Vec<AiLogRecord>

Snapshot the subsystem-wide ring. Used by the *ai* buffer view to populate its body.

pub fn snapshot_session(&self, session: &SessionKey) -> Vec<AiLogRecord>

Snapshot a session’s ring (empty if the session has never logged anything).

pub fn known_sessions(&self) -> Vec<SessionKey>

List every session with a per-session ring. Useful for :ai-status and the *ai* buffer’s “sessions” header.

pub fn clear_global(&self)

Drop the subsystem-wide ring’s contents.

pub fn clear_session(&self, session: &SessionKey)

Drop a session’s ring contents.

Trait Implementations

impl Clone for AiLogger

fn clone(&self) -> AiLogger

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AiLogger

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

Formats the value using the given formatter.

impl Default for AiLogger

fn default() -> Self

Returns the “default value” for a type.