/**
 * Content search capability.
 *
 * `grep` hunts for a regular expression inside the *text* of files beneath a
 * starting path. The traversal is a hand-rolled recursive descent over
 * {@link ToolContext.fs}; it never reaches for `node:fs`, a child process, or the
 * platform `grep` binary, so it behaves identically against any backend a host
 * cares to plug in (real disk, sandbox, in-memory).
 *
 * Each hit is reported as `relative/path:line` followed by the line that matched.
 * Bulky output is pared back through {@link ToolContext.budget} so the result can
 * never overrun the model's window.
 */
/** The arguments this tool accepts from the model. */
export interface GrepInput {
    /** The regular expression to test each line against. */
    readonly pattern: string;
    /** Directory (or single file) to search under; defaults to the working dir. */
    readonly path?: string;
    /** Standard JS regex flag letters, e.g. `"i"` for case-insensitive. */
    readonly flags?: string;
    /** Stop after this many hits have been collected. */
    readonly maxMatches?: number;
}
/**
 * The content-search tool. Walks a path with {@link ToolContext.fs}, tests each
 * line of every readable text file against the supplied regex, and returns
 * `path:line` hits clamped to {@link ToolContext.budget}.
 */
export declare const grepTool: import("..").DefinedTool;
