brainwires-tools 0.10.0

Built-in tool implementations for the Brainwires Agent Framework
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
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

#![deny(missing_docs)]
//! # Code Interpreters
//!
//! Sandboxed code execution for multiple programming languages.
//! Designed to work both natively and compiled to WASM for browser execution.
//!
//! ## Supported Languages
//!
//! | Language | Feature | Speed | Power | Notes |
//! |----------|---------|-------|-------|-------|
//! | Rhai | `rhai` | ⚡⚡⚡⚡ | ⭐⭐ | Native Rust, fastest startup |
//! | Lua | `lua` | ⚡⚡⚡ | ⭐⭐⭐ | Small runtime, good stdlib |
//! | JavaScript | `javascript` | ⚡⚡ | ⭐⭐⭐⭐ | ECMAScript compliant (Boa) |
//! | Python | `python` | ⚡ | ⭐⭐⭐⭐⭐ | CPython 3.12 compatible |
//!
//! ## Example
//!
//! ```rust,no_run
//! use brainwires_tools::interpreters::{Executor, ExecutionRequest, Language};
//!
//! let executor = Executor::new();
//! let result = executor.execute(ExecutionRequest {
//!     language: Language::Rhai,
//!     code: "let x = 1 + 2; x".to_string(),
//!     ..Default::default()
//! });
//!
//! assert!(result.success);
//! assert_eq!(result.stdout, "3");
//! ```

mod executor;
mod languages;
mod types;

#[cfg(feature = "interpreters-wasm")]
mod wasm_bindings;

pub use executor::Executor;
pub use types::*;

/// Re-exports of language-specific executors for advanced use.
pub mod lang {
    #[cfg(feature = "interpreters-rhai")]
    pub use super::languages::rhai::RhaiExecutor;

    #[cfg(feature = "interpreters-lua")]
    pub use super::languages::lua::LuaExecutor;

    #[cfg(feature = "interpreters-js")]
    pub use super::languages::javascript::JavaScriptExecutor;

    #[cfg(feature = "interpreters-python")]
    pub use super::languages::python::PythonExecutor;
}

/// Get a list of supported languages based on enabled features
#[allow(clippy::vec_init_then_push)]
pub fn supported_languages() -> Vec<Language> {
    let mut languages = Vec::new();

    #[cfg(feature = "interpreters-rhai")]
    languages.push(Language::Rhai);

    #[cfg(feature = "interpreters-lua")]
    languages.push(Language::Lua);

    #[cfg(feature = "interpreters-js")]
    languages.push(Language::JavaScript);

    #[cfg(feature = "interpreters-python")]
    languages.push(Language::Python);

    languages
}

/// Check if a language is supported
pub fn is_language_supported(language: Language) -> bool {
    match language {
        #[cfg(feature = "interpreters-rhai")]
        Language::Rhai => true,

        #[cfg(feature = "interpreters-lua")]
        Language::Lua => true,

        #[cfg(feature = "interpreters-js")]
        Language::JavaScript => true,

        #[cfg(feature = "interpreters-python")]
        Language::Python => true,

        #[allow(unreachable_patterns)]
        _ => false,
    }
}