/**
 * KIVO Error Catalog — 结构化错误目录
 *
 * FR-Z07: 所有用户可见错误包含错误描述 + 可能原因 + 修复建议。
 * 错误信息用用户导向表述，非技术栈 trace。
 */
export type ErrorCategory = 'config' | 'storage' | 'embedding' | 'search' | 'ingest' | 'conflict' | 'bootstrap' | 'provider' | 'auth' | 'migration' | 'access-control' | 'import-export';
export interface ErrorEntry {
    /** 错误码，格式: KIVO-{CATEGORY}-{NNN} */
    code: string;
    /** 用户可读的错误描述 */
    message: string;
    /** 可能原因 */
    cause: string;
    /** 修复建议 */
    suggestion: string;
    /** 是否支持重试 */
    retryable: boolean;
    /** 错误分类 */
    category: ErrorCategory;
}
/**
 * 结构化错误目录 — 覆盖安装、配置、导入、检索、调研等全链路场景
 */
export declare const ERROR_CATALOG: Record<string, ErrorEntry>;
//# sourceMappingURL=error-catalog.d.ts.map