import type { AgentTrace } from './types';
export interface SimilarityResult {
    tracePath: string;
    similarity: number;
    reason: string;
}
/**
 * Compute tool-call sequence similarity between two traces using
 * longest common subsequence (LCS) ratio.
 */
export declare function toolSequenceSimilarity(traceA: AgentTrace, traceB: AgentTrace): number;
/**
 * Compute output similarity based on simple token overlap (Jaccard).
 */
export declare function outputSimilarity(traceA: AgentTrace, traceB: AgentTrace): number;
/**
 * Compute overall similarity (weighted average of tool + output similarity).
 */
export declare function traceSimilarity(traceA: AgentTrace, traceB: AgentTrace, weights?: {
    toolWeight?: number;
    outputWeight?: number;
}): number;
/**
 * Find top-N similar traces from a corpus.
 */
export declare function findSimilarTraces(target: AgentTrace, corpusDir: string, options?: {
    topN?: number;
}): SimilarityResult[];
/**
 * Format similarity results for display.
 */
export declare function formatSimilarityResults(results: SimilarityResult[]): string;
//# sourceMappingURL=similarity.d.ts.map