import { type SemanticAdapterIdV1, type SemanticExecutionReceiptV1, type SemanticTargetBindingV1, type WarehouseTargetIdentityV1 } from '@duckcodeailabs/dql-core';
import { type ConnectionConfig, type QueryExecutor, type QueryResult } from '@duckcodeailabs/dql-connectors';
import type { SemanticRuntimeCompileResult, SemanticRuntimeTrace } from '../semantic-runtime.js';
import { type MetricFlowTargetMetadata } from './target-binding.js';
export declare class SemanticPhysicalPreflightError extends Error {
    readonly code: 'IDENTIFIER_SCOPE_INVALID' | 'PHYSICAL_PREFLIGHT_FAILED';
    readonly details: {
        adapterId: SemanticAdapterIdV1;
        phase: 'validation';
        queryId?: string;
        sqlState?: string;
        vendorCode?: string;
        line?: number;
        position?: number;
        identifier?: string;
        compiledSql?: string;
        compiledSqlTruncated: boolean;
        compiledSqlFingerprint: string;
        sqlExcerpt?: {
            startLine: number;
            endLine: number;
            text: string;
        };
        targetBinding: SemanticTargetBindingV1;
        safeActions: string[];
    };
    constructor(adapterId: SemanticAdapterIdV1, error: unknown, sql: string, targetBinding: SemanticTargetBindingV1);
}
export interface SemanticExecutionGatewayResult {
    compiled: SemanticRuntimeCompileResult;
    preparedSql: string;
    executionTarget: WarehouseTargetIdentityV1;
    targetBinding: SemanticTargetBindingV1;
    result: QueryResult;
    executionReceipt: SemanticExecutionReceiptV1;
    semanticTrace: SemanticRuntimeTrace;
}
export declare function executeTargetBoundSemanticQuery(input: {
    executor: QueryExecutor;
    connection: ConnectionConfig;
    projectRoot: string;
    plannedAdapter: SemanticAdapterIdV1;
    metricFlow?: MetricFlowTargetMetadata;
    compile: () => Promise<SemanticRuntimeCompileResult | null>;
    prepareSql?: (sql: string) => {
        sql: string;
        connection?: ConnectionConfig;
    };
    rowBound?: number;
}): Promise<SemanticExecutionGatewayResult | null>;
export declare function semanticExecutionFailureCode(error: unknown): string | undefined;
export declare function semanticExecutionFailureDetails(error: unknown): unknown;
//# sourceMappingURL=execution-gateway.d.ts.map