Struct LogSink 

pub struct LogSink(/* private fields */);

A shared, bounded ring-buffer sink for LogEntry items.

Wraps Arc<Mutex<VecDeque<LogEntry>>> and enforces a maximum capacity of 20 entries. Oldest entries are evicted when the cap is exceeded.

LogSink can be cloned cheaply (clones the Arc, not the buffer). It is intended to be passed to the Lua bridge so that log output from both print() and alc.log() is routed into the session’s ring buffer.

Implementations

impl LogSink

pub fn new() -> Self

Create a new, empty LogSink.

pub fn push(&self, entry: LogEntry)

Push a new entry into the ring buffer, evicting the oldest if necessary.

Arguments

• entry — The LogEntry to append.

Errors

If the internal mutex is poisoned (only possible on OOM-induced panic), the entry is silently dropped. This is the approved “observation/recording” policy — log capture failure must not interrupt execution.

pub fn to_json(&self) -> Value

Snapshot the current ring-buffer contents as a JSON array.

Returns

A serde_json::Value::Array of serialized LogEntry objects, in chronological order (oldest first). Returns an empty array if the mutex is poisoned.

pub fn entries(&self) -> Vec<LogEntry>

Snapshot the current ring-buffer contents as a Vec<LogEntry>.

Useful for programmatic access (e.g. in SessionStatus::snapshot). Returns an empty vec if the mutex is poisoned.

Trait Implementations

impl Clone for LogSink

fn clone(&self) -> LogSink

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for LogSink

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

Formats the value using the given formatter.

impl Default for LogSink

fn default() -> Self

Returns the “default value” for a type.