import type { SourceMeta } from "./types.js";
/**
 * A context file that provides persistent instructions to the agent.
 */
export interface ContextFile {
    /** Absolute path to the file */
    path: string;
    /** File content */
    content: string;
    /** Which level this came from */
    level: "user" | "project";
    /** Distance from cwd (0 = in cwd, 1 = parent, etc.) for project files */
    depth?: number;
    /**
     * User-configured extra filename. Does not compete for the one-per-depth
     * scope slot, so AGENTS.local.md loads beside AGENTS.md instead of replacing it.
     */
    additive?: boolean;
    /** Source metadata */
    _source: SourceMeta;
}
export declare const contextFileCapability: import("./types.js").Capability<ContextFile>;