import type { EffectiveDbtCloudSemanticSettings } from './semantic-runtime-settings.js';
export interface DbtCloudSemanticQueryRequest {
    metrics: string[];
    dimensions: string[];
    filters?: Array<{
        dimension?: string;
        operator?: string;
        values?: string[];
        expression?: string;
    }>;
    timeDimension?: {
        name: string;
        granularity: string;
    };
    orderBy?: Array<{
        name: string;
        direction?: 'asc' | 'desc';
    }>;
    limit?: number;
    savedQuery?: string;
}
export interface DbtCloudSemanticTestResult {
    ok: boolean;
    message: string;
    dialect?: string;
    metricCount?: number;
    metricNames?: string[];
    semanticCatalogFingerprint?: string;
    metricInventoryComplete?: boolean;
}
export interface DbtCloudSemanticCompileResult {
    sql: string;
    engine: 'dbt-cloud';
}
export interface DbtCloudSemanticMetricInventory {
    names: string[];
    totalItems: number;
    fingerprint: string;
    complete: boolean;
}
type FetchLike = typeof fetch;
export declare function testDbtCloudSemanticConnection(settings: EffectiveDbtCloudSemanticSettings, fetchImpl?: FetchLike, options?: {
    includeMetricInventory?: boolean;
}): Promise<DbtCloudSemanticTestResult>;
/**
 * API-004/PERF-002: capture a bounded, deterministic inventory of the metrics
 * that the configured dbt Cloud environment can actually resolve. Local dbt
 * artifacts are authoring evidence; this inventory is the compiler capability
 * proof and must never be inferred from a count alone.
 */
export declare function listDbtCloudSemanticMetrics(settings: EffectiveDbtCloudSemanticSettings, fetchImpl?: FetchLike): Promise<DbtCloudSemanticMetricInventory>;
export declare function compileDbtCloudSemanticQuery(settings: EffectiveDbtCloudSemanticSettings, request: DbtCloudSemanticQueryRequest, fetchImpl?: FetchLike): Promise<DbtCloudSemanticCompileResult>;
export declare function listDbtCloudCompatibleDimensions(settings: EffectiveDbtCloudSemanticSettings, metrics: string[], fetchImpl?: FetchLike): Promise<Array<{
    name: string;
    description?: string;
    type?: string;
    granularities: string[];
}>>;
export {};
//# sourceMappingURL=dbt-cloud-semantic.d.ts.map