export declare class GitLabApiError extends Error {
    readonly status: number;
    readonly endpoint: string;
    readonly requestId?: string;
    readonly details?: unknown;
    readonly retryAfterSeconds?: number;
    constructor(params: {
        message: string;
        status: number;
        endpoint: string;
        requestId?: string;
        details?: unknown;
        retryAfterSeconds?: number;
    });
}
export interface GitLabGraphQLErrorDetail {
    readonly message: string;
    readonly path?: readonly (string | number)[];
    readonly extensions?: Record<string, unknown>;
}
export declare class GitLabGraphQLError extends Error {
    readonly endpoint: string;
    readonly requestId?: string;
    readonly details: readonly GitLabGraphQLErrorDetail[];
    constructor(params: {
        message: string;
        endpoint: string;
        requestId?: string;
        details: readonly GitLabGraphQLErrorDetail[];
    });
}
export declare class ConfigurationError extends Error {
    constructor(message: string);
}
export declare class GuardrailError extends Error {
    readonly code: string;
    constructor(message: string, code?: string);
}
export declare class ResponseTooLargeError extends Error {
    readonly limitBytes: number;
    constructor(message: string, limitBytes: number);
}
export declare function normalizeGitLabError(input: {
    status: number;
    endpoint: string;
    requestId?: string | null;
    retryAfterHeader?: string | null;
    body?: unknown;
}): GitLabApiError;
export declare function normalizeGitLabGraphQLError(input: {
    endpoint: string;
    requestId?: string | null;
    errors: readonly GitLabGraphQLErrorDetail[];
}): GitLabGraphQLError;
export declare function buildUserFacingError(error: unknown): string;