simvx.core.ai.blackboard

Blackboard: the shared key-value store deciders read and write.

Perception writes percepts into a Blackboard; deciders (behaviour trees, state machines, utility scorers, or an LLM brain) read them, and high-level deciders write intent (current goal, mood, target) that low-level deciders execute. An optional parent chain lets a squad share intent: a child board falls back to its parent for keys it does not define locally, so a squad-lead brain can publish one shared goal that every member reads while keeping per-member scratch state private.

Module Contents

Classes

Blackboard

A dict-like store with optional parent fallback.

API

class simvx.core.ai.blackboard.Blackboard(initial: collections.abc.Mapping[str, Any] | None = None, *, parent: simvx.core.ai.blackboard.Blackboard | None = None)

A dict-like store with optional parent fallback.

Initialization

__slots__

(‘_data’, ‘_parent’)

get(key: str, default: Any = None) → Any

set(key: str, value: Any) → None

has(key: str) → bool

delete(key: str) → None

update(mapping: collections.abc.Mapping[str, Any]) → None

clear() → None

Clear only this board’s local entries (parent untouched).

local_keys() → list[str]

as_dict(*, inherited: bool = True) → dict[str, Any]

Flatten to a plain dict; local keys shadow inherited ones.

child() → simvx.core.ai.blackboard.Blackboard

A new board that falls back to this one for missing keys.

__getitem__(key: str) → Any

__setitem__(key: str, value: Any) → None

__delitem__(key: str) → None

__contains__(key: str) → bool

__iter__() → collections.abc.Iterator[str]

__len__() → int

__repr__() → str