codetether_agent/tool/

file.rs

//! File tools: read, write, list, glob

use super::{Tool, ToolResult};
use anyhow::Result;
use async_trait::async_trait;
use serde_json::{Value, json};
use std::path::PathBuf;
use std::time::Instant;
use tokio::fs;

use crate::telemetry::{FileChange, TOOL_EXECUTIONS, ToolExecution, record_persistent};

/// Read file contents
pub struct ReadTool;

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

#[async_trait]
impl Tool for ReadTool {
    fn id(&self) -> &str {
        "read"
    }

    fn name(&self) -> &str {
        "Read File"
    }

    fn description(&self) -> &str {
        "read(path: string, offset?: int, limit?: int) - Read the contents of a file. Provide the file path to read."
    }

    fn parameters(&self) -> Value {
        json!({
            "type": "object",
            "properties": {
                "path": {
                    "type": "string",
                    "description": "The path to the file to read"
                },
                "offset": {
                    "type": "integer",
                    "description": "Line number to start reading from (1-indexed)"
                },
                "limit": {
                    "type": "integer",
                    "description": "Maximum number of lines to read"
                }
            },
            "required": ["path"],
            "example": {
                "path": "src/main.rs",
                "offset": 1,
                "limit": 100
            }
        })
    }

    async fn execute(&self, args: Value) -> Result<ToolResult> {
        let start = Instant::now();

        let path = match args["path"].as_str() {
            Some(p) => p,
            None => {
                return Ok(ToolResult::structured_error(
                    "INVALID_ARGUMENT",
                    "read",
                    "path is required",
                    Some(vec!["path"]),
                    Some(json!({"path": "src/main.rs"})),
                ));
            }
        };
        let offset = args["offset"].as_u64().map(|n| n as usize);
        let limit = args["limit"].as_u64().map(|n| n as usize);

        let content = fs::read_to_string(path).await?;

        let lines: Vec<&str> = content.lines().collect();
        let start_line = offset
            .map(|o| o.saturating_sub(1))
            .unwrap_or(0)
            .min(lines.len());
        let end_line = limit
            .map(|l| (start_line + l).min(lines.len()))
            .unwrap_or(lines.len());

        let selected: String = lines[start_line..end_line]
            .iter()
            .enumerate()
            .map(|(i, line)| format!("{:4} | {}", start_line + i + 1, line))
            .collect::<Vec<_>>()
            .join("\n");

        let duration = start.elapsed();

        // Record telemetry
        let file_change = FileChange::read(path, Some((start_line as u32 + 1, end_line as u32)));

        let mut exec = ToolExecution::start(
            "read",
            json!({
                "path": path,
                "offset": offset,
                "limit": limit,
            }),
        );
        exec.add_file_change(file_change);
        let exec = exec.complete_success(
            format!("Read {} lines from {}", end_line - start_line, path),
            duration,
        );
        TOOL_EXECUTIONS.record(exec.clone());
        record_persistent(exec);

        Ok(ToolResult::success(selected)
            .with_metadata("total_lines", json!(lines.len()))
            .with_metadata("read_lines", json!(end_line - start_line)))
    }
}

/// Write file contents
pub struct WriteTool;

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

#[async_trait]
impl Tool for WriteTool {
    fn id(&self) -> &str {
        "write"
    }

    fn name(&self) -> &str {
        "Write File"
    }

    fn description(&self) -> &str {
        "write(path: string, content: string) - Write content to a file. Creates the file if it doesn't exist, or overwrites it."
    }

    fn parameters(&self) -> Value {
        json!({
            "type": "object",
            "properties": {
                "path": {
                    "type": "string",
                    "description": "The path to the file to write"
                },
                "content": {
                    "type": "string",
                    "description": "The content to write to the file"
                }
            },
            "required": ["path", "content"],
            "example": {
                "path": "src/config.rs",
                "content": "// Configuration module\n\npub struct Config {\n    pub debug: bool,\n}\n"
            }
        })
    }

    async fn execute(&self, args: Value) -> Result<ToolResult> {
        let start = Instant::now();

        let path = match args["path"].as_str() {
            Some(p) => p,
            None => {
                return Ok(ToolResult::structured_error(
                    "INVALID_ARGUMENT",
                    "write",
                    "path is required",
                    Some(vec!["path"]),
                    Some(json!({"path": "src/example.rs", "content": "// file content"})),
                ));
            }
        };
        let content = match args["content"].as_str() {
            Some(c) => c,
            None => {
                return Ok(ToolResult::structured_error(
                    "INVALID_ARGUMENT",
                    "write",
                    "content is required",
                    Some(vec!["content"]),
                    Some(json!({"path": path, "content": "// file content"})),
                ));
            }
        };

        // Create parent directories if needed
        if let Some(parent) = PathBuf::from(path).parent() {
            fs::create_dir_all(parent).await?;
        }

        // Check if file exists for telemetry
        let existed = fs::metadata(path).await.is_ok();
        let old_content = if existed {
            fs::read_to_string(path).await.ok()
        } else {
            None
        };

        fs::write(path, content).await?;

        let duration = start.elapsed();

        // Record telemetry
        let file_change = if existed {
            FileChange::modify(
                path,
                old_content.as_deref().unwrap_or(""),
                content,
                Some((1, content.lines().count() as u32)),
            )
        } else {
            FileChange::create(path, content)
        };

        let mut exec = ToolExecution::start(
            "write",
            json!({
                "path": path,
                "content_length": content.len(),
            }),
        );
        exec.add_file_change(file_change);
        let exec = exec.complete_success(
            format!("Wrote {} bytes to {}", content.len(), path),
            duration,
        );
        TOOL_EXECUTIONS.record(exec.clone());
        record_persistent(exec);

        Ok(ToolResult::success(format!(
            "Wrote {} bytes to {}",
            content.len(),
            path
        )))
    }
}

/// List directory contents
pub struct ListTool;

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

#[async_trait]
impl Tool for ListTool {
    fn id(&self) -> &str {
        "list"
    }

    fn name(&self) -> &str {
        "List Directory"
    }

    fn description(&self) -> &str {
        "list(path: string) - List the contents of a directory."
    }

    fn parameters(&self) -> Value {
        json!({
            "type": "object",
            "properties": {
                "path": {
                    "type": "string",
                    "description": "The path to the directory to list"
                }
            },
            "required": ["path"],
            "example": {
                "path": "src/"
            }
        })
    }

    async fn execute(&self, args: Value) -> Result<ToolResult> {
        let path = match args["path"].as_str() {
            Some(p) => p,
            None => {
                return Ok(ToolResult::structured_error(
                    "INVALID_ARGUMENT",
                    "list",
                    "path is required",
                    Some(vec!["path"]),
                    Some(json!({"path": "src/"})),
                ));
            }
        };

        let mut entries = fs::read_dir(path).await?;
        let mut items = Vec::new();

        while let Some(entry) = entries.next_entry().await? {
            let name = entry.file_name().to_string_lossy().to_string();
            let file_type = entry.file_type().await?;

            let suffix = if file_type.is_dir() {
                "/"
            } else if file_type.is_symlink() {
                "@"
            } else {
                ""
            };

            items.push(format!("{}{}", name, suffix));
        }

        items.sort();
        Ok(ToolResult::success(items.join("\n")).with_metadata("count", json!(items.len())))
    }
}

/// Find files using glob patterns
pub struct GlobTool;

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

#[async_trait]
impl Tool for GlobTool {
    fn id(&self) -> &str {
        "glob"
    }

    fn name(&self) -> &str {
        "Glob Search"
    }

    fn description(&self) -> &str {
        "glob(pattern: string, limit?: int) - Find files matching a glob pattern (e.g., **/*.rs, src/**/*.ts)"
    }

    fn parameters(&self) -> Value {
        json!({
            "type": "object",
            "properties": {
                "pattern": {
                    "type": "string",
                    "description": "The glob pattern to match files"
                },
                "limit": {
                    "type": "integer",
                    "description": "Maximum number of results to return"
                }
            },
            "required": ["pattern"],
            "example": {
                "pattern": "src/**/*.rs",
                "limit": 50
            }
        })
    }

    async fn execute(&self, args: Value) -> Result<ToolResult> {
        let pattern = match args["pattern"].as_str() {
            Some(p) => p,
            None => {
                return Ok(ToolResult::structured_error(
                    "INVALID_ARGUMENT",
                    "glob",
                    "pattern is required",
                    Some(vec!["pattern"]),
                    Some(json!({"pattern": "src/**/*.rs"})),
                ));
            }
        };
        let limit = args["limit"].as_u64().unwrap_or(100) as usize;

        let mut matches = Vec::new();

        // Determine the base directory from the pattern for WalkBuilder.
        // E.g. "src/**/*.rs" → walk "src/", "**/*.ts" → walk ".".
        let (base_dir, match_pattern) = {
            let p = std::path::Path::new(pattern);
            let mut prefix = std::path::PathBuf::new();
            let mut found_meta = false;
            for component in p.components() {
                let s = component.as_os_str().to_string_lossy();
                if !found_meta && glob::Pattern::escape(&s) == *s {
                    prefix.push(component);
                } else {
                    found_meta = true;
                }
            }
            let base = if prefix.as_os_str().is_empty() {
                ".".to_string()
            } else {
                prefix.display().to_string()
            };
            (base, pattern.to_string())
        };

        let compiled = glob::Pattern::new(&match_pattern)?;

        let walker = ignore::WalkBuilder::new(&base_dir)
            .hidden(false)
            .git_ignore(true)
            .follow_links(false) // prevent symlink loops
            .max_depth(Some(30)) // hard depth cap
            .build();

        for entry in walker {
            if matches.len() >= limit {
                break;
            }
            let entry = match entry {
                Ok(e) => e,
                Err(_) => continue,
            };
            let path = entry.path();
            if compiled.matches_path(path) || compiled.matches(path.to_string_lossy().as_ref()) {
                matches.push(path.display().to_string());
            }
        }

        let truncated = matches.len() >= limit;
        let output = matches.join("\n");

        Ok(ToolResult::success(output)
            .with_metadata("count", json!(matches.len()))
            .with_metadata("truncated", json!(truncated)))
    }
}