synaps 0.1.4

Terminal-native AI agent runtime — parallel orchestration, reactive subagents, MCP, autonomous supervision
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

//! `shell_send` tool — send input to an active shell session.

use serde_json::{json, Value};
use crate::{Result, RuntimeError};
use crate::tools::{Tool, ToolContext};

pub struct ShellSendTool;

#[async_trait::async_trait]
impl Tool for ShellSendTool {
    fn name(&self) -> &str { "shell_send" }

    fn description(&self) -> &str {
        "Send input to an active shell session. Returns the output produced after sending the input. The input is sent exactly as received after JSON parsing — a JSON string containing \\n will send an actual newline (Enter key). Use \\x03 for Ctrl-C, \\x04 for Ctrl-D."
    }

    fn parameters(&self) -> Value {
        json!({
            "type": "object",
            "properties": {
                "session_id": {
                    "type": "string",
                    "description": "Session ID from shell_start"
                },
                "input": {
                    "type": "string",
                    "description": "Text to send to the shell. Use \\n for Enter, \\x03 for Ctrl-C, \\x04 for Ctrl-D"
                },
                "timeout_ms": {
                    "type": "integer",
                    "description": "Override readiness timeout for this send (ms)"
                }
            },
            "required": ["session_id", "input"]
        })
    }

    async fn execute(&self, params: Value, ctx: ToolContext) -> Result<String> {
        let mgr = ctx.capabilities.session_manager.as_ref()
            .ok_or_else(|| RuntimeError::Tool("Shell sessions not available".into()))?;
        
        let session_id = params["session_id"].as_str()
            .ok_or_else(|| RuntimeError::Tool("Missing session_id parameter".into()))?;
        let input = params["input"].as_str()
            .ok_or_else(|| RuntimeError::Tool("Missing input parameter".into()))?;
        let timeout_ms = params["timeout_ms"].as_u64();
        
        let result = mgr.send_input(session_id, input, timeout_ms, ctx.channels.tx_delta.as_ref()).await?;
        
        if result.status == "active" {
            Ok(result.output)
        } else {
            let mut out = result.output;
            out.push_str(&format!("\n[{}]", result.status));
            Ok(out)
        }
    }
}