volition-core 0.2.0

Core library for the Volition AI agent
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

// volition-agent-core/src/tools/mod.rs

//! Contains implementations for standard, non-interactive tools.
//!
//! These functions provide the core logic for interacting with external commands
//! (shell, git, cargo), the filesystem, and performing searches.
//! They are designed as reusable building blocks for `ToolProvider` implementations.
//!
//! **Important:** These functions generally do *not* include safety checks
//! (like command argument validation, file path sandboxing) or user interaction
//! (like confirmation prompts). Callers, typically `ToolProvider` implementations,
//! are responsible for adding necessary safety layers before invoking these core functions.

pub mod cargo;
pub mod fs;
pub mod git;
pub mod search;
pub mod shell;

/// Represents the structured output of an executed external command.
#[derive(Debug, Clone, PartialEq)]
pub struct CommandOutput {
    /// The exit status code of the command (e.g., 0 for success).
    pub status: i32,
    /// The captured standard output as a string.
    pub stdout: String,
    /// The captured standard error as a string.
    pub stderr: String,
}

impl CommandOutput {
    /// Checks if the command executed successfully (status code 0).
    pub fn success(&self) -> bool {
        self.status == 0
    }
}