feat(citation): add grounding field to QueryResult + verifyCitations config + exports

Author: jddunn

src/query-router/types.ts

@@ -296,6 +296,12 @@ export interface QueryResult {
    */
   fallbacksUsed: string[];
 
+  /**
+   * Citation verification results. Populated when deep research runs
+   * or when `verifyCitations` is explicitly requested in config or query options.
+   */
+  grounding?: import('../rag/citation/types.js').VerifiedResponse;
+
   /**
    * Recommended skills, tools, and extensions based on query analysis.
    *
@@ -517,6 +523,13 @@ export interface QueryRouterConfig {
     topN: number,
   ) => Promise<RetrievedChunk[]>;
 
+  /**
+   * Enable automatic citation verification on deep research responses.
+   * When true, moderate-depth queries also verify citations.
+   * Default: false (only deep research verifies automatically).
+   */
+  verifyCitations?: boolean;
+
   /**
    * Optional host-provided deep research callback.
    *

src/rag/index.ts

@@ -306,3 +306,7 @@ export type {
   VectorStoreConfig,
 } from './setup/types.js';
 
+// Citation verification
+export { CitationVerifier, cosineSimilarity } from './citation/index.js';
+export type { CitationVerifierConfig, ClaimVerdict, VerifiedResponse, VerificationSource } from './citation/index.js';
+