Struct ActorRegistry 

pub struct ActorRegistry {
    entries: HashMap<String, RegistryEntry>,
    reverse: HashMap<KernelId, Vec<String>>,
    watchers: Vec<(String, Vec<RegistryEvent>)>,
}

Global actor registry with symbolic names.

Provides service discovery for the actor system: LLM tool calls, external APIs, and inter-actor routing can find actors by name instead of opaque kernel IDs.

Fields

entries: HashMap<String, RegistryEntry>

Name → Entry mapping.

reverse: HashMap<KernelId, Vec<String>>

Reverse mapping: KernelId → names (one kernel can have multiple names).

watchers: Vec<(String, Vec<RegistryEvent>)>

Watchers: pattern → callback channels.

Implementations

impl ActorRegistry

pub fn new() -> Self

Create an empty registry.

pub fn register( &mut self, name: impl Into<String>, kernel_id: KernelId, ) -> RegistryEvent

Register an actor by name.

If the name is already registered, updates the mapping and emits an Updated event.

pub fn register_with_tags( &mut self, name: impl Into<String>, kernel_id: KernelId, tags: HashMap<String, String>, ) -> RegistryEvent

Register with metadata tags.

pub fn deregister(&mut self, name: &str) -> Option<RegistryEvent>

Deregister an actor by name.

pub fn deregister_kernel(&mut self, kernel_id: &KernelId) -> Vec<RegistryEvent>

Deregister all names associated with a kernel ID.

pub fn lookup(&self, name: &str) -> Option<&KernelId>

Lookup an actor by exact name.

pub fn lookup_entry(&self, name: &str) -> Option<&RegistryEntry>

Lookup the full registry entry by name.

pub fn names_for(&self, kernel_id: &KernelId) -> Vec<&str>

Lookup all names registered to a kernel ID.

pub fn lookup_pattern(&self, pattern: &str) -> Vec<(&str, &KernelId)>

Lookup actors by wildcard pattern.

Supports:

• * matches any sequence of characters (excluding /)
• ** matches any sequence including /
• ? matches a single character

Examples:

• "standards/*" matches "standards/isa" but not "standards/isa/500"
• "standards/**" matches "standards/isa/500"
• "isa_*" matches "isa_ontology", "isa_rules"

pub fn list_names(&self) -> Vec<&str>

List all registered names.

pub fn len(&self) -> usize

Number of registered entries.

pub fn is_empty(&self) -> bool

Check if registry is empty.

pub fn watch(&mut self, pattern: impl Into<String>) -> usize

Add a watcher for registry changes.

Returns a watcher ID that can be used to retrieve events.

pub fn drain_events(&mut self, watcher_id: usize) -> Vec<RegistryEvent>

Drain events for a watcher.

fn notify_watchers(&mut self, event: &RegistryEvent)

Trait Implementations

impl Default for ActorRegistry

fn default() -> Self

Returns the “default value” for a type.