sage-runtime 2.1.0

Runtime library for compiled Sage programs
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
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152

//! RFC-0011: Tool implementations for Sage agents.
//!
//! This module provides the built-in tools that agents can use via
//! `use ToolName` declarations and `ToolName.method()` calls.
//!
//! # WASM Compatibility
//!
//! - `HttpClient`: Works on both native and WASM (reqwest has a Fetch backend)
//! - `DatabaseClient`: Native only (requires SQLx)
//! - `FsClient`: Native only (requires filesystem access)
//! - `ShellClient`: Native only (requires process spawning)

#[cfg(not(target_arch = "wasm32"))]
mod database;
#[cfg(not(target_arch = "wasm32"))]
mod filesystem;
mod http;
#[cfg(not(target_arch = "wasm32"))]
mod shell;

#[cfg(not(target_arch = "wasm32"))]
pub use database::{DatabaseClient, DbRow};
#[cfg(not(target_arch = "wasm32"))]
pub use filesystem::FsClient;
pub use http::{HttpClient, HttpResponse};
#[cfg(not(target_arch = "wasm32"))]
pub use shell::{ShellClient, ShellResult};

// ---------------------------------------------------------------------------
// WASM stubs for native-only tools
// ---------------------------------------------------------------------------
// These provide the same types so generated code compiles, but return errors
// at runtime if invoked in the browser.

#[cfg(target_arch = "wasm32")]
mod wasm_stubs {
    use crate::error::{SageError, SageResult};

    /// A row returned from a database query.
    #[derive(Debug, Clone, serde::Serialize, serde::Deserialize)]
    pub struct DbRow {
        pub columns: Vec<String>,
        pub values: Vec<String>,
    }

    /// Database client stub for WASM (not supported).
    #[derive(Debug, Clone)]
    pub struct DatabaseClient;

    impl DatabaseClient {
        pub fn new() -> Self {
            Self
        }

        pub fn from_env() -> Self {
            Self
        }

        pub async fn query(&self, _sql: String) -> SageResult<Vec<DbRow>> {
            Err(SageError::Tool(
                "Database tool is not available in the WASM target".to_string(),
            ))
        }

        pub async fn execute(&self, _sql: String) -> SageResult<i64> {
            Err(SageError::Tool(
                "Database tool is not available in the WASM target".to_string(),
            ))
        }
    }

    impl Default for DatabaseClient {
        fn default() -> Self {
            Self::new()
        }
    }

    /// FileSystem client stub for WASM (not supported).
    #[derive(Debug, Clone)]
    pub struct FsClient;

    impl FsClient {
        pub fn new() -> Self {
            Self
        }

        pub fn from_env() -> Self {
            Self
        }

        pub async fn read(&self, _path: String) -> SageResult<String> {
            Err(SageError::Tool(
                "Fs tool is not available in the WASM target".to_string(),
            ))
        }

        pub async fn write(&self, _path: String, _content: String) -> SageResult<()> {
            Err(SageError::Tool(
                "Fs tool is not available in the WASM target".to_string(),
            ))
        }

        pub async fn list(&self, _path: String) -> SageResult<Vec<String>> {
            Err(SageError::Tool(
                "Fs tool is not available in the WASM target".to_string(),
            ))
        }

        pub async fn exists(&self, _path: String) -> SageResult<bool> {
            Err(SageError::Tool(
                "Fs tool is not available in the WASM target".to_string(),
            ))
        }
    }

    impl Default for FsClient {
        fn default() -> Self {
            Self::new()
        }
    }

    /// Result of running a shell command.
    #[derive(Debug, Clone, serde::Serialize, serde::Deserialize)]
    pub struct ShellResult {
        pub exit_code: i64,
        pub stdout: String,
        pub stderr: String,
    }

    /// Shell client stub for WASM (not supported).
    #[derive(Debug, Clone, Default)]
    pub struct ShellClient;

    impl ShellClient {
        pub fn new() -> Self {
            Self
        }

        pub fn from_env() -> Self {
            Self
        }

        pub async fn run(&self, _command: String) -> SageResult<ShellResult> {
            Err(SageError::Tool(
                "Shell tool is not available in the WASM target".to_string(),
            ))
        }
    }
}

#[cfg(target_arch = "wasm32")]
pub use wasm_stubs::{DatabaseClient, DbRow, FsClient, ShellClient, ShellResult};