echo_agent 0.1.2

Production-grade AI Agent framework for Rust — ReAct engine, multi-agent, memory, streaming, MCP, IM channels, workflows
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
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114

//! Executor — responsible for executing individual steps in a plan

use crate::agent::Agent;
use crate::error::Result;
use futures::future::BoxFuture;
use tracing::{debug, info};

/// Executor trait — executes a single step
pub trait Executor: Send + Sync {
    /// Execute a single step
    ///
    /// - `step_description`: Step description
    /// - `context`: Execution context (results from previous steps, etc.)
    fn execute_step<'a>(
        &'a mut self,
        step_description: &'a str,
        context: &'a str,
    ) -> BoxFuture<'a, Result<String>>;
}

// ── ReactExecutor ────────────────────────────────────────────────────────────

/// Uses ReactAgent as the Executor: each step is executed through a full ReAct loop
pub struct ReactExecutor {
    agent: Box<dyn Agent>,
}

impl ReactExecutor {
    /// Create a ReactExecutor from a type implementing the Agent trait
    ///
    /// # Parameters
    /// * `agent` - Agent instance for executing steps
    pub fn new(agent: impl Agent + 'static) -> Self {
        Self {
            agent: Box::new(agent),
        }
    }

    /// Create a ReactExecutor from an already-boxed Agent trait object
    ///
    /// # Parameters
    /// * `agent` - Already-boxed Agent trait object
    pub fn from_boxed(agent: Box<dyn Agent>) -> Self {
        Self { agent }
    }
}

impl Executor for ReactExecutor {
    fn execute_step<'a>(
        &'a mut self,
        step_description: &'a str,
        context: &'a str,
    ) -> BoxFuture<'a, Result<String>> {
        Box::pin(async move {
            let prompt = if context.is_empty() {
                step_description.to_string()
            } else {
                format!("{}\n\n{}", context, step_description)
            };

            info!(
                agent = %self.agent.name(),
                step = %step_description,
                "⚡ ReactExecutor executing step"
            );

            let result = self.agent.execute(&prompt).await?;
            debug!(
                agent = %self.agent.name(),
                output_len = result.len(),
                "✅ Step execution complete"
            );

            Ok(result)
        })
    }
}

// ── SimpleExecutor ───────────────────────────────────────────────────────────

/// Simple Executor: calls LLM directly (no tools), suitable for pure reasoning steps
pub struct SimpleExecutor {
    agent: Box<dyn Agent>,
}

impl SimpleExecutor {
    /// Create a SimpleExecutor from a type implementing the Agent trait
    ///
    /// # Parameters
    /// * `agent` - Agent instance for executing steps
    pub fn new(agent: impl Agent + 'static) -> Self {
        Self {
            agent: Box::new(agent),
        }
    }
}

impl Executor for SimpleExecutor {
    fn execute_step<'a>(
        &'a mut self,
        step_description: &'a str,
        context: &'a str,
    ) -> BoxFuture<'a, Result<String>> {
        Box::pin(async move {
            let prompt = if context.is_empty() {
                step_description.to_string()
            } else {
                format!("{}\n\n{}", context, step_description)
            };

            self.agent.execute(&prompt).await
        })
    }
}