/**
 * Ensure a directory exists, creating it recursively if needed.
 * Resolves symlinks so that broken symlink targets are created correctly.
 */
export declare function ensureDir(dir: string): Promise<void>;
/**
 * Copy a file from src to dest, creating parent directories if needed.
 * Resolves symlinks in the destination path so files are written to the
 * actual target location when dest contains symlinks (e.g., skill dirs
 * symlinked from ~/.claude/skills/ to ~/.agents/skills/).
 */
export declare function copyFile(src: string, dest: string): Promise<void>;
/**
 * Check if a file or directory exists.
 */
export declare function fileExists(filePath: string): Promise<boolean>;
/**
 * Read and parse a JSON file.
 */
export declare function readJson<T = unknown>(filePath: string): Promise<T>;
/**
 * Write content to a file, creating parent directories if needed.
 * Resolves symlinks so files are written to the actual target location.
 */
export declare function writeFile(filePath: string, content: string): Promise<void>;
/**
 * List entries in a directory. Returns empty array if directory doesn't exist.
 */
export declare function readDir(dirPath: string): Promise<string[]>;
/**
 * Remove a file. Returns true if the file existed and was removed.
 * Operates on the path directly so a symlink entry is removed rather than its
 * resolved target (avoids deleting files the symlink merely points at).
 */
export declare function removeFile(filePath: string): Promise<boolean>;
/**
 * Remove a directory recursively. Returns true if the directory existed and was removed.
 * Symlinked directories are unlinked directly rather than recursed into, so the
 * directory a symlink points at is never deleted.
 */
export declare function removeDir(dirPath: string): Promise<boolean>;
/**
 * Check if a directory is empty. A missing directory is treated as empty and
 * a non-directory path as non-empty; inspection failures are propagated so
 * callers can report that cleanup was incomplete.
 */
export declare function isDirEmpty(dirPath: string): Promise<boolean>;
//# sourceMappingURL=file-system.d.ts.map