lean_ctx/tools/registered/
ctx_execute.rs

1use rmcp::ErrorData;
2use rmcp::model::Tool;
3use serde_json::{Map, Value, json};
4
5use crate::server::tool_trait::{
6    McpTool, ToolContext, ToolOutput, get_int, get_str, require_resolved_path,
7};
8use crate::tool_defs::tool_def;
9
10pub struct CtxExecuteTool;
11
12impl McpTool for CtxExecuteTool {
13    fn name(&self) -> &'static str {
14        "ctx_execute"
15    }
16
17    fn tool_def(&self) -> Tool {
18        tool_def(
19            "ctx_execute",
20            "Run code in sandbox (11 languages) — use when conditionals, multi-line or cross-language transforms.\n\
21             ANTIPATTERN: for simple one-liners, prefer ctx_shell (lower overhead, auto-compressed).\n\
22             action=code (default) for one-shot; action=batch for parallel multi-language;\n\
23             action=file to process a project file (extension auto-detects).\n\
24             Pass intent to focus large output and save tokens. Languages: javascript,\n\
25             typescript, python, shell, ruby, go, rust, php, perl, r, elixir.",
26            json!({
27                "type": "object",
28                "properties": {
29                    "language": {
30                        "type": "string",
31                        "description": "javascript|typescript|python|shell|ruby|go|rust|php|perl|r|elixir (for action=code)"
32                    },
33                    "code": {
34                        "type": "string",
35                        "description": "Source code for action=code. Set intent to filter large output."
36                    },
37                    "intent": {
38                        "type": "string",
39                        "description": "Focus intent; triggers filtering when output is large."
40                    },
41                    "timeout": {
42                        "type": "integer",
43                        "description": "Timeout in seconds (default: 30)"
44                    },
45                    "action": {
46                        "type": "string",
47                        "description": "code (default, run script) | batch (parallel) | file (project file)"
48                    },
49                    "items": {
50                        "type": "string",
51                        "description": "JSON array of [{language, code}] for batch action."
52                    },
53                    "path": {
54                        "type": "string",
55                        "description": "File path for action=file (language auto-detected)."
56                    }
57                }
58            }),
59        )
60    }
61
62    fn handle(
63        &self,
64        args: &Map<String, Value>,
65        ctx: &ToolContext,
66    ) -> Result<ToolOutput, ErrorData> {
67        let action = get_str(args, "action").unwrap_or_default();
68
69        let (result, outcome) = if action == "batch" {
70            let items_str = get_str(args, "items")
71                .ok_or_else(|| ErrorData::invalid_params("items is required for batch", None))?;
72            let items: Vec<serde_json::Value> = serde_json::from_str(&items_str)
73                .map_err(|e| ErrorData::invalid_params(format!("Invalid items JSON: {e}"), None))?;
74            let batch: Vec<(String, String)> = items
75                .iter()
76                .filter_map(|item| {
77                    let lang = item.get("language")?.as_str()?.to_string();
78                    let code = item.get("code")?.as_str()?.to_string();
79                    Some((lang, code))
80                })
81                .collect();
82            crate::tools::ctx_execute::handle_batch(&batch)
83        } else if action == "file" {
84            let path = require_resolved_path(ctx, args, "path")?;
85            let project_root = if ctx.project_root.is_empty() {
86                None
87            } else {
88                Some(ctx.project_root.as_str())
89            };
90            let intent = get_str(args, "intent");
91            crate::tools::ctx_execute::handle_file(&path, intent.as_deref(), project_root)
92        } else {
93            let language = get_str(args, "language")
94                .ok_or_else(|| ErrorData::invalid_params("language is required", None))?;
95            let code = get_str(args, "code")
96                .ok_or_else(|| ErrorData::invalid_params("code is required", None))?;
97            let intent = get_str(args, "intent");
98            let timeout = get_int(args, "timeout").and_then(|t| u64::try_from(t).ok());
99            crate::tools::ctx_execute::handle(&language, &code, intent.as_deref(), timeout)
100        };
101
102        let result = crate::core::redaction::redact_text_if_enabled(&result);
103        Ok(ToolOutput {
104            text: result,
105            original_tokens: 0,
106            saved_tokens: 0,
107            mode: Some(action),
108            path: None,
109            changed: false,
110            shell_outcome: Some(outcome),
111        })
112    }
113}
lean_ctx/tools/registered/ctx_execute.rs

lean_ctx/tools/registered/
ctx_execute.rs
