import { ErrorHandlingCenter } from 'rcc-errorhandling';
import { type HttpErrorPayload } from '../server/utils/http-error-mapper.js';
export type RouteErrorScope = 'http' | 'provider' | 'server' | 'pipeline' | 'cli' | 'compat' | 'other';
export type RouteErrorSeverity = 'low' | 'medium' | 'high' | 'critical';
export interface RouteErrorPayload {
    code: string;
    message: string;
    source: string;
    scope: RouteErrorScope;
    severity?: RouteErrorSeverity;
    timestamp?: number;
    requestId?: string;
    endpoint?: string;
    providerKey?: string;
    providerType?: string;
    routeName?: string;
    model?: string;
    details?: Record<string, unknown>;
    metadata?: Record<string, unknown>;
    originalError?: unknown;
}
export interface RouteErrorReportOptions {
    includeHttpResult?: boolean;
}
export interface RouteErrorReportResult {
    http?: HttpErrorPayload;
}
export interface RouteErrorHubDeps {
    errorHandlingCenter: ErrorHandlingCenter;
}
export declare class RouteErrorHubNotInitializedError extends Error {
    readonly code = "ROUTE_ERROR_HUB_NOT_INITIALIZED";
    constructor();
}
export declare class RouteErrorHub {
    private readonly deps;
    private readonly registry;
    private initialized;
    constructor(deps: RouteErrorHubDeps);
    initialize(): Promise<void>;
    report(payload: RouteErrorPayload, options?: RouteErrorReportOptions): Promise<RouteErrorReportResult>;
    private ensureInitialized;
    private normalizePayload;
    private buildErrorObject;
    private prepareErrorForCenter;
    private buildAdditionalContext;
    private buildErrorExtras;
    private buildHttpPayload;
}
export declare function initializeRouteErrorHub(deps: RouteErrorHubDeps): RouteErrorHub;
export declare function getRouteErrorHub(): RouteErrorHub | null;
export declare function reportRouteError(payload: RouteErrorPayload, options?: RouteErrorReportOptions): Promise<RouteErrorReportResult>;