/**
 * AGENTS.md 提供者接口。
 * 负责发现、读取和合并 AGENTS.md 文件内容。
 * 具体的发现策略由实现决定。
 */
export type AgentsMdProvider = {
    /**
     * 获取合并后的 AGENTS.md 文本内容。
     * 多个文件按层级顺序合并（远 → 近），用分隔标记区分来源。
     * 无文件时返回空字符串。
     *
     * Provider 实现应在首次调用后缓存结果，后续调用直接返回缓存。
     */
    getAgentsMd(): Promise<string>;
};