/** Minimal sandbox surface this tool needs. */
export interface SandboxLike {
    run(options: {
        command: string;
    }): PromiseLike<{
        exitCode: number;
        stdout: string;
        stderr: string;
    }>;
}
interface RepoGuidelines {
    /** Repo-relative path of the root guideline file, or null when absent. */
    rootPath: string | null;
    /** Root guideline content (capped at {@link MAX_GUIDELINE_BYTES}). */
    root: string | null;
    /** True when the root content hit the cap; read rootPath for the rest. */
    rootTruncated: boolean;
    /** Repo-relative paths of nested guideline files, shallowest first. */
    nested: string[];
}
/**
 * Find the repo's agent guideline files. One winner per directory:
 * AGENTS.md beats CLAUDE.md (CLAUDE.md is often just a pointer at it).
 */
export declare function discoverGuidelines(sandbox: SandboxLike, dir: string): Promise<RepoGuidelines>;
export {};