export type StructuredErrorCode = "VALIDATION_ERROR" | "COOKIE_EXPIRED" | "SUBTITLE_UNAVAILABLE" | "NETWORK_ERROR" | "NETWORK_TIMEOUT" | "API_RATE_LIMITED" | "ACCESS_DENIED" | "PAID_VIDEO" | "COMMENTS_DISABLED" | "BILIBILI_API_ERROR" | "RESOURCE_LIMIT_EXCEEDED" | "UNKNOWN_ERROR";
export type StructuredErrorCategory = "validation" | "credentials" | "content" | "network" | "access" | "rate_limit" | "api" | "resource" | "runtime" | "unknown";
export interface StructuredErrorPayload {
    error: true;
    message: string;
    message_en: string;
    message_zh: string;
    code: StructuredErrorCode | string;
    category: StructuredErrorCategory;
    retryable: boolean;
    user_action_required: boolean;
    next_steps: string[];
    next_steps_en: string[];
    next_steps_zh: string[];
    details?: {
        status_code?: number;
        timeout_ms?: number;
        api_code?: string | number;
    };
}
export interface StructuredErrorContext {
    fallbackToDescriptionAvailable?: boolean;
}
export declare function buildStructuredErrorPayload(error: unknown, context?: StructuredErrorContext): StructuredErrorPayload;
//# sourceMappingURL=error-guidance.d.ts.map