clawdb 0.1.0

The cognitive database for AI agents — unified memory, semantic retrieval, branching, sync, and governance.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84

//! Plugin manager for dynamic libraries.

use std::path::Path;

use tokio::sync::broadcast;

use crate::{
    error::ClawDBResult,
    plugins::{events::ClawEvent, interface::ClawPlugin},
};

/// Dynamic plugin manager.
pub struct PluginManager {
    plugins: Vec<Box<dyn ClawPlugin>>,
    event_tx: broadcast::Sender<ClawEvent>,
}

impl PluginManager {
    /// Creates a new plugin manager and an event receiver.
    pub fn new() -> (Self, broadcast::Receiver<ClawEvent>) {
        let (event_tx, event_rx) = broadcast::channel(256);
        (
            Self {
                plugins: Vec::new(),
                event_tx,
            },
            event_rx,
        )
    }

    /// Loads all supported shared libraries from `dir`.
    ///
    /// Safety invariant: the loaded library must export a `clawdb_create_plugin`
    /// symbol with signature `fn() -> Box<dyn ClawPlugin>`. Libraries are leaked
    /// after loading so plugin vtables remain valid for the lifetime of the process.
    pub fn load_from_dir(&mut self, dir: &Path) -> ClawDBResult<usize> {
        if !dir.exists() {
            return Ok(0);
        }

        let mut loaded = 0usize;
        for entry in std::fs::read_dir(dir)? {
            let path = entry?.path();
            if !is_dynamic_library(&path) {
                continue;
            }
            // SAFETY: The caller controls the plugin directory and we validate the symbol name.
            unsafe {
                let library = libloading::Library::new(&path).map_err(|error| {
                    crate::error::ClawDBError::ComponentInit("plugin", error.to_string())
                })?;
                let constructor: libloading::Symbol<unsafe fn() -> Box<dyn ClawPlugin>> =
                    library.get(b"clawdb_create_plugin").map_err(|error| {
                        crate::error::ClawDBError::ComponentInit("plugin", error.to_string())
                    })?;
                let plugin = constructor();
                self.plugins.push(plugin);
                std::mem::forget(library);
                loaded += 1;
            }
        }

        Ok(loaded)
    }

    /// Emits an event to subscribed listeners.
    pub fn emit(&self, event: ClawEvent) {
        let _ = self.event_tx.send(event);
    }

    /// Dispatches an event to all loaded plugins.
    pub async fn dispatch(&mut self, event: &ClawEvent) {
        for plugin in &mut self.plugins {
            let _ = plugin.on_event(event).await;
        }
    }
}

fn is_dynamic_library(path: &Path) -> bool {
    matches!(
        path.extension().and_then(|value| value.to_str()),
        Some("so") | Some("dylib") | Some("dll")
    )
}