import type { IntentId } from "./intents";
export interface InferIntentResult {
    intent: IntentId;
    /** 1..5 score for ranking ties. Higher = stronger match. */
    confidence: number;
    /** Other plausible intents, sorted by confidence. */
    alternates: ReadonlyArray<{
        intent: IntentId;
        confidence: number;
    }>;
}
/**
 * Map a natural-language query to a built-in intent. Returns `null` when no
 * pattern matches with meaningful confidence.
 *
 * @example
 * inferIntent("when did revenue peak?")
 *   // → { intent: "outlier-detection", confidence: 4, alternates: [] }
 * inferIntent("show me the trend over time")
 *   // → { intent: "trend", confidence: 4, alternates: [] }
 * inferIntent("hello")
 *   // → null
 */
export declare function inferIntent(query: string): InferIntentResult | null;
