/**
 * Disk Storage Manager — unified atomic file I/O for agent self-managed storage.
 *
 * Provides:
 * - Atomic write (tmp + rename) with dir auto-creation
 * - JSON read/write helpers
 */
/**
 * Write data atomically: write to a temp file in the same directory,
 * then rename over the target. This prevents partial/corrupted reads.
 */
export declare function atomicWriteFile(filePath: string, data: string | Buffer): Promise<void>;
/**
 * Read a JSON file. Returns `undefined` if the file does not exist.
 */
export declare function readJsonFile<T = unknown>(filePath: string): Promise<T | undefined>;
/**
 * Write a JSON file atomically.
 */
export declare function writeJsonFile(filePath: string, data: unknown): Promise<void>;
