Add rescore_vector to knn query, knn section and knn retriever (#3553)

Author: carlosdelest

output/schema/schema.json

@@ -27,6 +27,11 @@ export type QueryVector = float[]
 /* KnnSearch (used in kNN search) and KnnQuery (ued in kNN queries) are close
  * but different enough to require different classes */
 
+export interface RescoreVector {
+  /** Applies the specified oversample factor to k on the approximate kNN search */
+  oversample: float
+}
+
 export interface KnnSearch {
   /** The name of the vector field to search against */
   field: Field
@@ -49,6 +54,8 @@ export interface KnnSearch {
    * @doc_id knn-inner-hits
    */
   inner_hits?: InnerHits
+  /** Apply oversampling and rescoring to quantized vectors */
+  rescore_vector?: RescoreVector
 }
 
 /**
@@ -69,6 +76,8 @@ export interface KnnQuery extends QueryBase {
   filter?: QueryContainer | QueryContainer[]
   /** The minimum similarity for a vector to be considered a match */
   similarity?: float
+  /** Apply oversampling and rescoring to quantized vectors */
+  rescore_vector?: RescoreVector
 }
 
 /** @variants container */

output/typescript/types.ts

@@ -19,7 +19,7 @@
 
 import { FieldCollapse } from '@global/search/_types/FieldCollapse'
 import { UserDefinedValue } from '@spec_utils/UserDefinedValue'
-import { QueryVector, QueryVectorBuilder } from '@_types/Knn'
+import { QueryVector, QueryVectorBuilder, RescoreVector } from '@_types/Knn'
 import { float, integer } from '@_types/Numeric'
 import { Sort, SortResults } from '@_types/sort'
 import { Id } from './common'
@@ -74,6 +74,8 @@ export class KnnRetriever extends RetrieverBase {
   num_candidates: integer
   /** The minimum similarity required for a document to be considered a match.  */
   similarity?: float
+  /** Apply oversampling and rescoring to quantized vectors */
+  rescore_vector?: RescoreVector
 }
 
 export class RRFRetriever extends RetrieverBase {