/**
 * Extract a human-readable message from an API error.
 */
export declare function formatApiError(error: unknown): string;
/**
 * Get repair hints for an error (for display after the error message).
 */
export declare function getErrorHints(error: unknown): string[];
/**
 * Format an error, print to stderr with hints, and exit with code 1.
 * In JSON mode, outputs a structured error object instead.
 */
export declare function handleError(error: unknown, options?: {
    json?: boolean;
}): never;