butterfly-bot 0.8.0

Butterfly Bot is an opinionated personal-ops AI assistant built for people who want results, not setup overhead.
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

use async_trait::async_trait;
use tokio::sync::Mutex;

use crate::error::Result;
use crate::interfaces::brain::{BrainContext, BrainEvent, BrainPlugin};

#[derive(Debug, Clone)]
pub struct ExplainabilityNote {
    pub explanation: String,
}

pub struct ExplainabilityBrain {
    last_note: Mutex<Option<ExplainabilityNote>>,
}

impl ExplainabilityBrain {
    pub fn new() -> Self {
        Self {
            last_note: Mutex::new(None),
        }
    }

    pub async fn last_note(&self) -> Option<ExplainabilityNote> {
        let guard = self.last_note.lock().await;
        guard.clone()
    }

    fn explain(message: &str) -> ExplainabilityNote {
        let explanation = format!("Response reasoning grounded in user input: {message}");
        ExplainabilityNote { explanation }
    }
}

#[async_trait]
impl BrainPlugin for ExplainabilityBrain {
    fn name(&self) -> &str {
        "explainability"
    }

    fn description(&self) -> &str {
        "Creates lightweight explainability notes"
    }

    async fn on_event(&self, event: BrainEvent, _ctx: &BrainContext) -> Result<()> {
        if let BrainEvent::UserMessage { text, .. } = event {
            let note = Self::explain(&text);
            let mut guard = self.last_note.lock().await;
            *guard = Some(note);
        }
        Ok(())
    }
}