eli 0.5.2

Ease Lives Instantly — hook-first AI agent framework with multi-channel support
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

//! Hook plugin example — implement EliHookSpec to customize framework behavior.
//!
//! Demonstrates how to create a plugin that injects a custom system prompt
//! and a model plugin that uses it. Plugins are registered in order;
//! last-registered wins for hooks that return the first `Some`.
//!
//! ```bash
//! cargo run --example hook_plugin -p eli
//! ```

use std::sync::Arc;

use async_trait::async_trait;
use eli::{EliFramework, EliHookSpec, HookError, PromptValue, State};
use serde_json::json;

/// Plugin that injects a custom system prompt.
struct SystemPromptPlugin {
    instruction: String,
}

#[async_trait]
impl EliHookSpec for SystemPromptPlugin {
    fn plugin_name(&self) -> &str {
        "system-prompt"
    }

    fn build_system_prompt(&self, _prompt_text: &str, _state: &State) -> Option<String> {
        Some(self.instruction.clone())
    }
}

/// Minimal model plugin that prefixes output with the session id.
struct SimpleModel;

#[async_trait]
impl EliHookSpec for SimpleModel {
    fn plugin_name(&self) -> &str {
        "simple-model"
    }

    async fn run_model(
        &self,
        prompt: &PromptValue,
        session_id: &str,
        _state: &State,
    ) -> Result<Option<String>, HookError> {
        Ok(Some(format!(
            "[{session_id}] reply to: {}",
            prompt.as_text()
        )))
    }
}

#[tokio::main]
async fn main() {
    let fw = EliFramework::new();

    // Register system prompt plugin first, then model plugin.
    let prompt_plugin = SystemPromptPlugin {
        instruction: "You are a helpful assistant that speaks like a pirate.".into(),
    };
    fw.register_plugin(Arc::new(prompt_plugin)).await;
    fw.register_plugin(Arc::new(SimpleModel)).await;

    // Verify the system prompt is wired up.
    let state = State::new();
    let system = fw
        .get_system_prompt(&PromptValue::Text("hello".into()), &state)
        .await;
    println!("system prompt: {system}");

    // Process a message through the full pipeline.
    let msg = json!({"content": "Ahoy!", "channel": "cli", "chat_id": "pirate"});
    let result = fw
        .process_inbound(msg)
        .await
        .expect("process_inbound failed");

    println!("done:   processed 1 turn");
    println!("output: {}", result.model_output);
}