/**
 * HTTP validation error response from the API.
 * Matches Python's HTTPValidationError structure.
 */
export interface HTTPValidationError {
    detail: string | Array<{
        loc: string[];
        msg: string;
        type: string;
    }>;
}
/**
 * Galileo Standard error data structure from the API.
 * This represents the raw error data structure (snake_case from API).
 * Used internally for type checking during conversion.
 */
export interface GalileoAPIStandardErrorData {
    /** Numeric error code that uniquely identifies the error type */
    error_code: number;
    /** Human-readable error type identifier */
    error_type: string;
    /** Group/category the error belongs to (e.g., "dataset", "playground", "shared") */
    error_group: string;
    /** Severity level (e.g., "low", "medium", "high", "critical") */
    severity: string;
    /** Human-readable error message */
    message: string;
    /** Suggested action for the user to resolve the error */
    user_action?: string;
    /** Optional link to documentation about this error */
    documentation_link?: string | null;
    /** Whether the error is retriable (client can retry the request) */
    retriable: boolean;
    /** Whether the error is blocking (requires user intervention) */
    blocking: boolean;
    /** HTTP status code associated with this error */
    http_status_code?: number;
    /** Internal identifier of the service emitting the error (api, runners, ui) */
    source_service?: string | null;
    /** Optional context information (e.g., exception_type, exception_message) */
    context?: Record<string, unknown> | null;
}
/**
 * Type guard to validate if an object matches the GalileoAPIStandardErrorData interface.
 * @param value - The value to validate
 * @returns True if the value matches the interface shape, false otherwise
 */
export declare function isGalileoAPIStandardErrorData(value: unknown): value is GalileoAPIStandardErrorData;
/**
 * Galileo API Error class for structured error handling.
 * Extends Error to provide proper stack traces and error handling while
 * preserving all structured error information from the API.
 *
 * As specified in https://github.com/rungalileo/orbit/blob/main/libs/python/error_management/docs/error_catalog.md
 */
export declare class GalileoAPIError extends Error {
    readonly errorCode: number;
    readonly errorType: string;
    readonly errorGroup: string;
    readonly severity: string;
    readonly userAction?: string;
    readonly documentationLink?: string | null;
    readonly retriable: boolean;
    readonly blocking: boolean;
    readonly httpStatusCode?: number;
    readonly sourceService?: string | null;
    readonly context?: Record<string, unknown> | null;
    constructor(data: GalileoAPIStandardErrorData);
    /**
     * Serializes the error to JSON format for logging and debugging.
     * Includes all error properties including stack trace.
     */
    toJSON(): Record<string, unknown>;
}