import type { RetrievalInput } from "@/schemas/retrieval"; import type { RetrievalRequest } from "@/types/retrieval"; type RetrievalConfiguration = NonNullable< RetrievalRequest["retrievalConfiguration"] >; type RerankingConfiguration = NonNullable< RetrievalConfiguration["rerankingConfiguration"] >; /** * Assemble the `retrievalConfiguration` slice of a retrieve request from the * flat form state. This is the shared core used by: * * 1. the retrieval-test form (via `assembleRetrievalRequest`), and * 2. the chat homepage, which applies a single session-wide config to * every mounted knowledge base so cross-KB scores stay comparable. * * Caller responsibilities that are deliberately outside this function: * - `filter` (KB-specific, derived from FilterBuilder) * - `subspace` (per-mount) * - the outer `retrievalQuery.text` * * Returns `undefined` when the resulting configuration would be empty so * callers can conditionally attach it to the request body. */ export function assembleRetrievalConfiguration( v: Partial, topK: number | undefined, ): RetrievalConfiguration | undefined { const denseTopK = getResultCount(v.denseTopK, v.topK, topK); const fullTextTopK = getResultCount(v.fullTextTopK, v.topK, topK); const rerankTopK = getResultCount(v.rerankTopK, v.topK, topK); const reranking = buildRerankingConfiguration(v, rerankTopK); const config: RetrievalConfiguration = {}; if (v.searchType?.length) config.searchType = v.searchType; if (denseTopK !== undefined) { config.denseVectorSearchConfiguration = { numberOfResults: denseTopK }; } if (fullTextTopK !== undefined) { config.fullTextSearchConfiguration = { numberOfResults: fullTextTopK }; } if (reranking) config.rerankingConfiguration = reranking; return Object.keys(config).length > 0 ? config : undefined; } function getResultCount( primary: number | undefined, legacyTopK: number | undefined, fallbackTopK: number | undefined, ): number | undefined { if (typeof primary === "number") return primary; if (typeof legacyTopK === "number") return legacyTopK; if (typeof fallbackTopK === "number") return fallbackTopK; return undefined; } /** Build the nested `rerankingConfiguration` sub-object from flat form fields. */ function buildRerankingConfiguration( v: Partial, topK: number | undefined, ): RerankingConfiguration | undefined { if (!v.rerankType) return undefined; const base: RerankingConfiguration = { type: v.rerankType, }; if (topK !== undefined) base.numberOfResults = topK; if (v.rerankType === "RRF") { base.rrfConfiguration = { k: v.rrfK, denseVectorSearchWeight: v.rrfDenseWeight, fullTextSearchWeight: v.rrfFullTextWeight, }; } else if (v.rerankType === "WEIGHT") { base.weightConfiguration = { denseVectorSearchWeight: v.weightDense, fullTextSearchWeight: v.weightFullText, }; } else if (v.rerankType === "MODEL") { base.modelConfiguration = { provider: v.modelProvider, model: v.modelName, }; } return base; }