export interface ActionEvent {
    /** Stable identifier for the action, e.g. tool name or signal type. */
    key: string;
    /** Optional human label. */
    label?: string;
    /** ISO timestamp. */
    at: string;
    /** Optional capability name used to gate execution via the Trust Ladder. */
    capability?: string;
    /** Free-form metadata for the suggestion card. */
    metadata?: Record<string, unknown>;
}
export interface NextActionSuggestion {
    trigger: string;
    predicted: string;
    confidence: number;
    sampleSize: number;
    capability?: string;
    rationale: string;
}
export interface MineOptions {
    /** Maximum lookahead window when scanning for "X then Y". */
    windowSize?: number;
    /** Minimum number of observed transitions before a suggestion is allowed. */
    minSamples?: number;
    /** Minimum confidence (transition count / total trigger count). */
    minConfidence?: number;
    /** Cap on how many suggestions to return. */
    limit?: number;
}
/**
 * Scan a chronological list of action events and return the top N
 * "after X usually Y" suggestions, sorted by confidence × sampleSize.
 */
export declare function mineNextActions(events: ActionEvent[], options?: MineOptions): NextActionSuggestion[];
/**
 * Convenience: given the latest action and a precomputed suggestion set,
 * return the highest-confidence next action keyed off it. Used by Mission
 * Control to surface a card right after a tool call completes.
 */
export declare function suggestNextAfter(latestKey: string, suggestions: NextActionSuggestion[]): NextActionSuggestion | undefined;
//# sourceMappingURL=predictiveEngine.d.ts.map