/**
 * Leaper Agent – Context References
 * Parse and expand @file, @folder, @git, @url, @diff, @staged references.
 */
export type ReferenceKind = 'file' | 'folder' | 'git' | 'url' | 'diff' | 'staged';
export interface ContextReference {
    raw: string;
    kind: ReferenceKind;
    target: string;
    start: number;
    end: number;
    line_start?: number;
    line_end?: number;
}
export interface ContextReferenceResult {
    message: string;
    original_message: string;
    references: ContextReference[];
    warnings: string[];
    injected_tokens: number;
    expanded: number;
    blocked: number;
}
export declare function isBlockedPath(filePath: string): boolean;
export declare function ensurePathAllowed(filePath: string): {
    allowed: boolean;
    reason?: string;
};
export declare function parseContextReferences(message: string): ContextReference[];
export declare function expandFileReference(ref: ContextReference, cwd?: string): {
    content: string;
    blocked?: boolean;
    warning?: string;
};
export declare function expandFolderReference(ref: ContextReference, cwd?: string): {
    content: string;
    warning?: string;
};
export declare function expandGitReference(ref: ContextReference, cwd?: string): Promise<{
    content: string;
    warning?: string;
}>;
export declare function expandDiffReference(cwd?: string): Promise<{
    content: string;
    warning?: string;
}>;
export declare function expandStagedReference(cwd?: string): Promise<{
    content: string;
    warning?: string;
}>;
export declare function fetchUrlContent(url: string): Promise<{
    content: string;
    warning?: string;
}>;
export declare function preprocessContextReferences(message: string, opts?: {
    cwd?: string;
    maxTokens?: number;
}): Promise<ContextReferenceResult>;
//# sourceMappingURL=context-references.d.ts.map