import type { InstallLocation } from '../../types/install.js';
type Preferences = {
    install_location?: InstallLocation;
};
/**
 * Returns the path to the Alice preferences file.
 * Uses `~/.config/alice-agents/config.json` on all platforms.
 *
 * @returns Absolute path to the config file.
 */
export declare const getPreferencesPath: () => string;
/**
 * Loads saved preferences from disk. Returns an empty object if the
 * file does not exist, cannot be read, or cannot be parsed.
 *
 * @param path - Optional override path for testing.
 * @returns The preferences object (may be empty).
 */
export declare const loadPreferences: (path?: string) => Preferences;
/**
 * Saves preferences to disk. Creates the directory if it does not exist.
 *
 * @param prefs - The preferences to save.
 * @param path - Optional override path for testing.
 */
export declare const savePreferences: (prefs: Preferences, path?: string) => void;
/**
 * Returns the saved install location preference, or `undefined` if the
 * value is missing or not a valid location (`'global'` or `'local'`).
 *
 * @param path - Optional override path for testing.
 * @returns The saved install location or `undefined`.
 */
export declare const getSavedLocation: (path?: string) => InstallLocation | undefined;
export {};
//# sourceMappingURL=preferences.d.ts.map