/**
 * Vigthoria CLI — Workspace Hash Cache
 *
 * Persists SHA-256 hashes of workspace files in .vigthoria/file-hashes.json.
 * Allows the CLI to sort files by change status before sending them to V3:
 *   - Changed/new files → sent first (highest budget priority)
 *   - Unchanged files → sent last (trimmed by budget if token limit reached)
 */
export interface FileChangeset {
    /** Files that are new or changed since last cache write. */
    changed: string[];
    /** Files whose hash matches the cached value. */
    unchanged: string[];
    total: number;
}
/**
 * Partition file paths into changed and unchanged sets.
 *
 * @param workspacePath  Absolute project root.
 * @param relativePaths  Workspace-relative (or absolute) file paths to check.
 */
export declare function getChangedFiles(workspacePath: string, relativePaths: string[]): FileChangeset;
/**
 * Write current hashes for the given files into the persistent cache.
 * Call this after an agent run completes successfully.
 */
export declare function updateWorkspaceCache(workspacePath: string, relativePaths: string[]): void;
/**
 * Return a human-readable summary of changes since last cache update.
 */
export declare function summarizeChanges(workspacePath: string, relativePaths: string[]): string;
