Struct CodeTool 

pub struct CodeTool { /* private fields */ }

Repository source code browser.

Downloads and caches GitHub tarballs for browsing repository source code.

Implementations

impl CodeTool

pub fn new(config: CodeToolConfig, get_sha: ShaCallback) -> Result<Self, Error>

Create a new CodeTool instance from configuration.

The get_sha callback is called to determine which git SHA to download/load. For GitHub sources, this is the commit SHA. For file sources, this can be used to track file modification (e.g., mtime or a version string).

pub fn name(&self) -> &str

Get the repository name.

pub fn has_summary(&self) -> bool

Check if this code tool has a summary available.

pub fn summary(&self) -> Option<&str>

Get the summary of the codebase, if available.

pub async fn ls(&self, path: Option<&str>) -> Result<String, String>

List files in a directory (like ls).

If path is None or empty, lists the root directory.

pub async fn find(&self, pattern: Option<&str>) -> Result<String, String>

Find files matching a glob pattern (like find).

Supports glob patterns using the globset crate syntax.

pub async fn read( &self, path: &str, line_start: Option<usize>, line_end: Option<usize>, ) -> Result<String, String>

Read a file’s contents.

If line_range is provided, only returns those lines (1-indexed, inclusive).

pub async fn search( &self, pattern: &str, context: u32, path_prefix: Option<&str>, ) -> Result<String, String>

Search for a regex pattern in all files.

• pattern: The regex pattern to search for.
• context: Number of context lines to show (like grep -C).
• path_prefix: Optional path prefix to limit search scope.