harness-grep 0.1.1

Grep tool for AI agent harnesses — ripgrep-library content search with structured output modes, .gitignore respect, alias pushback, and fuzzy NOT_FOUND siblings
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

//! Grep tool — Rust port of `@agent-sh/harness-grep`.
//!
//! Conforms to `agent-knowledge/design/grep.md` (language-neutral spec).
//! Public surface mirrors the TS package: `grep(params, session)`
//! returns a discriminated `GrepResult` union. Alias pushback, zero-match
//! hint, `NOT_FOUND` with fuzzy siblings, `INVALID_REGEX` with escape
//! hint — all carry over.
//!
//! Engine: BurntSushi/ripgrep's library form (`grep-searcher` + `grep-regex`)
//! and `ignore` for .gitignore-aware file walking. No WASM, no shell-out.

mod constants;
mod engine;
mod fence;
mod format;
mod schema;
mod suggest;
mod types;

pub use constants::*;
pub use engine::{default_engine, GrepEngine, GrepEngineInput};
pub use format::{format_content, format_count, format_files_with_matches};
pub use schema::{
    parse_grep_params, safe_parse_grep_params, GrepParams, GrepParseError,
    GREP_TOOL_DESCRIPTION, GREP_TOOL_NAME,
};
pub use suggest::suggest_siblings;
pub use types::{
    ContentMeta, ContentResult, CountMeta, CountResult, ErrorResult,
    FilesMatchMeta, FilesMatchResult, GrepOutputMode, GrepResult,
    GrepSessionConfig, RgCount, RgMatch,
};

/// Top-level entry point. Parse + fence + engine + format, returning a
/// discriminated result shape. This is the `grep()` function from the TS
/// package, same contract.
pub async fn grep(
    params: serde_json::Value,
    session: &GrepSessionConfig,
) -> GrepResult {
    run::run(params, session).await
}

mod run;