apollo-agent 0.3.0

Local-first Rust AI agent runtime — Telegram-first, trait-driven, SurrealDB + RocksDB state layer.
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

//! Core Tool trait — defines agent capabilities.

use async_trait::async_trait;
use serde::{Deserialize, Serialize};
use serde_json::Value;

/// Tool specification for LLM function calling.
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct ToolSpec {
    pub name: String,
    pub description: String,
    pub parameters: Value, // JSON Schema
}

/// Result of executing a tool.
#[derive(Debug, Clone)]
pub struct ToolResult {
    pub output: String,
    pub is_error: bool,
}

impl ToolResult {
    pub fn success(output: impl Into<String>) -> Self {
        Self {
            output: crate::redaction::redact_text(&output.into()),
            is_error: false,
        }
    }
    pub fn error(output: impl Into<String>) -> Self {
        Self {
            output: crate::redaction::redact_text(&output.into()),
            is_error: true,
        }
    }
}

/// The core Tool trait. Each tool implements this.
#[async_trait]
pub trait Tool: Send + Sync {
    /// Tool name (must match the ToolSpec name)
    fn name(&self) -> &str;

    /// Get the tool specification for LLM function calling
    fn spec(&self) -> ToolSpec;

    /// Execute the tool with the given arguments (JSON string)
    async fn execute(&self, arguments: &str) -> anyhow::Result<ToolResult>;
}