export interface UnsupportedSparqlQueryErrorOptions {
    code?: string;
    capability?: string;
    hint?: string;
    correction?: SparqlCorrection;
}
export type SparqlCorrectionAction = 'rewrite_query' | 'constrain_graph_scope' | 'materialize_intermediate' | 'route_external_executor' | 'use_write_api';
export type SparqlCorrectionTarget = 'embedded_rdf_engine' | 'trusted_client_or_federated_engine' | 'pod_write_api';
export interface SparqlCorrection {
    capability: string;
    primaryAction: SparqlCorrectionAction;
    availableActions: SparqlCorrectionAction[];
    target: SparqlCorrectionTarget;
    message: string;
}
export declare class UnsupportedSparqlQueryError extends Error {
    readonly code: string;
    readonly capability: string;
    readonly hint: string;
    readonly correction: SparqlCorrection;
    constructor(message: string, options?: UnsupportedSparqlQueryErrorOptions);
}
export declare class DisabledSparqlFeatureError extends Error {
    constructor(message: string);
}
export declare class NativeSparqlExecutionError extends Error {
    readonly code = "rdf.sparql.native_execution_error";
    constructor(message: string);
}
export declare class NativeSparqlTimeoutError extends Error {
    readonly timeoutMs: number;
    readonly code = "rdf.sparql.timeout";
    constructor(timeoutMs: number, detail?: string);
}
export declare function sparqlCorrectionForCapability(capability: string): SparqlCorrection;
/** Validate only the server-owned graph and SERVICE boundary before native QLever execution. */
export declare function assertServerOwnedNativeSparqlQuery(query: string, basePath: string): boolean;