parecode 0.1.1

A terminal coding agent built for token efficiency and local model reliability
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

use anyhow::{Context, Result};
use serde_json::Value;
use tokio::process::Command;
use tokio::time::{Duration, timeout};

/// Max lines of output to return inline. Rest is truncated.
const MAX_OUTPUT_LINES: usize = 500;

pub fn definition() -> Value {
    serde_json::json!({
        "name": "bash",
        "description": "Run a shell command. Returns stdout and stderr. Avoid interactive commands.",
        "parameters": {
            "type": "object",
            "properties": {
                "command": {
                    "type": "string",
                    "description": "Shell command to run"
                },
                "timeout_secs": {
                    "type": "integer",
                    "description": "Optional timeout in seconds (default: 30)"
                }
            },
            "required": ["command"]
        }
    })
}

pub async fn execute(args: &Value) -> Result<String> {
    let command = args["command"]
        .as_str()
        .context("bash: missing 'command'")?;

    let timeout_secs = Duration::from_secs(
        args["timeout_secs"].as_u64().unwrap_or(30)
    );

    let fut = Command::new("sh")
        .arg("-c")
        .arg(command)
        .output();

    let output = match timeout(timeout_secs, fut).await {
        Ok(result) => result.with_context(|| format!("bash: failed to run '{command}'"))?,
        Err(_) => {
            return Ok(format!(
                "[exit code: -1]\n[timed out after {}s — command did not complete]",
                timeout_secs.as_secs()
            ));
        }
    };

    let stdout = String::from_utf8_lossy(&output.stdout);
    let stderr = String::from_utf8_lossy(&output.stderr);
    let exit_code = output.status.code().unwrap_or(-1);

    let mut result = String::new();

    if exit_code != 0 {
        result.push_str(&format!("[exit code: {exit_code}]\n"));
    }

    let combined = if stderr.is_empty() {
        stdout.to_string()
    } else if stdout.is_empty() {
        stderr.to_string()
    } else {
        format!("{stdout}\n[stderr]\n{stderr}")
    };

    let lines: Vec<&str> = combined.lines().collect();
    let total = lines.len();

    if total == 0 {
        result.push_str("[no output]");
    } else if total <= MAX_OUTPUT_LINES {
        result.push_str(&combined);
    } else {
        for line in &lines[..MAX_OUTPUT_LINES] {
            result.push_str(line);
            result.push('\n');
        }
        result.push_str(&format!(
            "[+{} lines truncated — use a more specific command to reduce output]",
            total - MAX_OUTPUT_LINES
        ));
    }

    Ok(result)
}