/**
 * Central OS platform path resolution using env-paths.
 *
 * Provides OS-appropriate paths for CLEO's global directories using
 * XDG conventions on Linux, standard conventions on macOS/Windows.
 * Results are cached for the process lifetime. Env vars take precedence.
 *
 * Platform path defaults (no env vars set):
 *   data:   ~/.local/share/cleo  | ~/Library/Application Support/cleo | %LOCALAPPDATA%\cleo\Data
 *   config: ~/.config/cleo       | ~/Library/Preferences/cleo          | %APPDATA%\cleo\Config
 *   cache:  ~/.cache/cleo        | ~/Library/Caches/cleo               | %LOCALAPPDATA%\cleo\Cache
 *   log:    ~/.local/state/cleo  | ~/Library/Logs/cleo                 | %LOCALAPPDATA%\cleo\Log
 *   temp:   /tmp/<user>/cleo     | /var/folders/.../cleo               | %TEMP%\cleo
 *
 * CLEO_HOME env var overrides the data path for backward compatibility
 * with existing ~/.cleo installations.
 */
/** OS-appropriate paths for CLEO's global directories. */
export interface PlatformPaths {
    /** User data dir. Override with CLEO_HOME env var. */
    data: string;
    /** User config dir (XDG_CONFIG_HOME / Library/Preferences / %APPDATA%). */
    config: string;
    /** User cache dir (XDG_CACHE_HOME / Library/Caches / %LOCALAPPDATA%). */
    cache: string;
    /** User log dir (XDG_STATE_HOME / Library/Logs / %LOCALAPPDATA%). */
    log: string;
    /** Temp dir for ephemeral files. */
    temp: string;
}
/** Immutable system information snapshot, captured once per process. */
export interface SystemInfo {
    platform: NodeJS.Platform;
    arch: string;
    release: string;
    hostname: string;
    nodeVersion: string;
    paths: PlatformPaths;
}
/**
 * Get OS-appropriate paths for CLEO's global directories.
 * Cached after first call. CLEO_HOME env var overrides the data path.
 *
 * The cache is automatically invalidated when CLEO_HOME changes,
 * so test code can set process.env['CLEO_HOME'] without calling
 * _resetPlatformPathsCache() manually.
 */
export declare function getPlatformPaths(): PlatformPaths;
/**
 * Get a cached system information snapshot.
 * Captured once and reused for the process lifetime.
 * Useful for diagnostics, issue reports, and log enrichment.
 */
export declare function getSystemInfo(): SystemInfo;
/**
 * Invalidate the path and system info caches.
 * Use in tests after mutating CLEO_HOME env var.
 * @internal
 */
export declare function _resetPlatformPathsCache(): void;
//# sourceMappingURL=platform-paths.d.ts.map