claude-rust-tools 2.0.2

Tool implementations for bash and file operations
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

use claude_rust_errors::AppResult;
use claude_rust_types::{PermissionLevel, Tool};
use serde_json::{Value, json};

/// Tool for LSP operations (diagnostics, hover, goto definition, etc.).
///
/// TODO: Phase 4 — integrate with real LSP server.
pub struct LSPTool;

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

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

    fn description(&self) -> &str {
        "Perform LSP operations such as diagnostics, hover, goto definition, references, and code actions."
    }

    fn input_schema(&self) -> Value {
        json!({
            "type": "object",
            "properties": {
                "operation": {
                    "type": "string",
                    "description": "LSP operation: \"diagnostics\", \"hover\", \"goto_definition\", \"references\", or \"code_actions\"",
                    "enum": ["diagnostics", "hover", "goto_definition", "references", "code_actions"]
                },
                "file_path": {
                    "type": "string",
                    "description": "Path to the file for the LSP operation"
                },
                "line": {
                    "type": "integer",
                    "description": "Line number (0-indexed) for position-based operations"
                },
                "character": {
                    "type": "integer",
                    "description": "Character offset (0-indexed) for position-based operations"
                }
            },
            "required": ["operation", "file_path"]
        })
    }

    fn permission_level(&self) -> PermissionLevel {
        PermissionLevel::ReadOnly
    }

    fn is_lsp(&self) -> bool { true }
    fn is_read_only(&self, _input: &Value) -> bool { true }
    fn is_concurrent_safe(&self, _input: &Value) -> bool { true }

    async fn execute(&self, input: Value) -> AppResult<String> {
        let operation = input
            .get("operation")
            .and_then(|v| v.as_str())
            .ok_or_else(|| claude_rust_errors::AppError::Tool("missing 'operation' field".into()))?;

        let file_path = input
            .get("file_path")
            .and_then(|v| v.as_str())
            .ok_or_else(|| claude_rust_errors::AppError::Tool("missing 'file_path' field".into()))?;

        let line = input.get("line").and_then(|v| v.as_u64());
        let character = input.get("character").and_then(|v| v.as_u64());

        // TODO: Phase 4 — replace stub with real LSP integration
        tracing::info!(operation, file_path, ?line, ?character, "LSP operation (stub)");

        Ok(format!(
            "LSP server not running. Operation '{operation}' on '{file_path}' cannot be performed.\n\
             Hint: LSP integration will be available in Phase 4."
        ))
    }
}