Skip to content

QualityCheckResult

avgScore: number;

Mean relevance score across all results.


optional backgroundReformulation?: boolean;

Whether background reformulation was triggered (voice agents).


coverageEstimate: number;

0-1 estimate of how well results cover the query.


estimatedTokens: number;

Estimated prompt-token cost of the result set (~chars/4). Retrieval pays for itself in tokens — track this to catch a retriever that is “accurate” only by flooding the context window.


quality: "high" | "medium" | "low";

Quality bucket: high, medium, or low.


reformulated: boolean;

Whether the query was reformulated and re-retrieved.


optional reformulatedQuery?: string;

The reformulated query string, if reformulation occurred.


topScore: number;

Highest relevance score in the result set.