Struct Blackboard 

pub struct Blackboard {
    pub entries: HashMap<String, BlackboardEntry>,
    pub current_time: f64,
}

A typed, expiring key-value knowledge base for AI agents.

Fields

entries: HashMap<String, BlackboardEntry>

current_time: f64

Implementations

impl Blackboard

pub fn new() -> Self

pub fn set(&mut self, key: impl Into<String>, value: impl Into<BlackboardValue>)

Store a permanent entry.

pub fn set_with_ttl( &mut self, key: impl Into<String>, value: impl Into<BlackboardValue>, ttl: f64, )

Store an entry that expires after ttl seconds.

pub fn get(&self, key: &str) -> Option<&BlackboardValue>

Retrieve a value if it exists and has not expired.

pub fn get_entry(&self, key: &str) -> Option<&BlackboardEntry>

Retrieve the full entry (value + metadata).

pub fn get_bool(&self, key: &str) -> Option<bool>

pub fn get_int(&self, key: &str) -> Option<i64>

pub fn get_float(&self, key: &str) -> Option<f64>

pub fn get_vec2(&self, key: &str) -> Option<Vec2>

pub fn get_vec3(&self, key: &str) -> Option<Vec3>

pub fn get_str(&self, key: &str) -> Option<&str>

pub fn get_entity(&self, key: &str) -> Option<u64>

pub fn remove(&mut self, key: &str) -> Option<BlackboardValue>

Remove a key from the blackboard.

pub fn update(&mut self, dt: f64)

Advance simulated time and remove all expired entries.

pub fn set_time(&mut self, t: f64)

Set the current time directly (useful for tests).

pub fn contains(&self, key: &str) -> bool

pub fn len(&self) -> usize

pub fn is_empty(&self) -> bool

pub fn keys(&self) -> impl Iterator<Item = &String>

Iterate over non-expired keys.

pub fn clear(&mut self)

Clear all entries.

pub fn merge(&mut self, other: &Blackboard)

Merge entries from other into this blackboard. Entries in other overwrite entries in self if the key already exists.

pub fn increment_int(&mut self, key: &str, delta: i64)

Increment an integer value, inserting 0 + delta if not present.

pub fn increment_float(&mut self, key: &str, delta: f64)

Increment a float value.

pub fn push_to_list(&mut self, key: &str, value: BlackboardValue)

Append a value to a list entry; creates the list if not present.

pub fn snapshot(&self) -> Vec<(&String, &BlackboardValue)>

Returns all non-expired (key, value) pairs.

impl Blackboard

pub fn debug_dump(&self) -> String

Dump all non-expired entries to a human-readable string.

Trait Implementations

impl Clone for Blackboard

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Blackboard

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

Formats the value using the given formatter.

impl Default for Blackboard

fn default() -> Self

Returns the “default value” for a type.