import type { AgentsMdProvider } from './agents-md-provider';
export type WalkUpAgentsMdProviderOptions = {
    /**
     * 工作目录的绝对路径。
     * Provider 从此目录开始向上遍历查找 AGENTS.md 文件。
     */
    cwd: string;
    /**
     * 额外的 AGENTS.md 文件路径列表（可选）。
     * 这些文件的内容排在目录树遍历结果之前（即优先级最低）。
     * 典型用途：全局配置文件，如 ~/.config/agforge/AGENTS.md。
     */
    extraFiles?: Array<string>;
    /**
     * 要查找的文件名列表（可选）。
     * 按顺序查找，找到第一个即停止。
     * @default ['AGENTS.md', 'CLAUDE.md']
     */
    fileNames?: Array<string>;
    /**
     * 目录上溯的终止目录（可选）。
     * 到达此目录后停止上溯（不包含此目录）。
     * 未指定时遍历到文件系统根目录。
     * 典型用途：限制为 git 仓库根目录。
     */
    stopAt?: string;
};
/**
 * 基于目录上溯的 AgentsMdProvider 实现。
 * 从指定的工作目录开始向上遍历目录树，在每个目录中查找 AGENTS.md（或 CLAUDE.md）。
 *
 * 发现策略：
 * - 在每个目录中按 fileNames 顺序查找，找到第一个即停止
 * - 收集所有找到的文件，按远 → 近顺序合并
 * - extraFiles 的内容排在最前面（优先级最低）
 *
 * 首次调用后缓存结果，后续调用直接返回缓存。
 */
export declare class WalkUpAgentsMdProvider implements AgentsMdProvider {
    private readonly cwd;
    private readonly extraFiles;
    private readonly fileNames;
    private readonly stopAt?;
    private cached?;
    constructor(options: WalkUpAgentsMdProviderOptions);
    getAgentsMd(): Promise<string>;
    private walkUp;
    private findInDirectory;
}