added linear and pinned retriever

Author: l-trotta

specification/_types/Retriever.ts

@@ -42,13 +42,22 @@ export class RetrieverContainer {
   rule?: RuleRetriever
   /** A retriever that re-scores only the results produced by its child retriever. */
   rescorer?: RescorerRetriever
+  /** A retriever that supports the combination of different retrievers through a weighted linear combination. */
+  linear?: LinearRetriever
+  /**
+   * A pinned retriever applies pinned documents to the underlying retriever.
+   * This retriever will rewrite to a PinnedQueryBuilder.
+   */
+  pinned?: PinnedRetriever
 }
 
 export class RetrieverBase {
   /** Query to filter the documents that can match. */
   filter?: QueryContainer | QueryContainer[]
   /** Minimum _score for matching documents. Documents with a lower _score are not included in the top documents. */
   min_score?: float
+  /** Retriever name. */
+  _name?: string
 }
 
 export class RescorerRetriever extends RetrieverBase {
@@ -57,6 +66,36 @@ export class RescorerRetriever extends RetrieverBase {
   rescore: Rescore | Rescore[]
 }
 
+export class LinearRetriever extends RetrieverBase {
+  /** Inner retrievers. */
+  retrievers?: InnerRetriever[]
+  rank_window_size: integer
+}
+
+export class PinnedRetriever extends RetrieverBase {
+  /** Inner retriever. */
+  retriever: RetrieverContainer
+  ids?: string[]
+  docs?: SpecifiedDocument[]
+  rank_window_size: integer
+}
+
+export class InnerRetriever {
+  retriever: RetrieverContainer
+  weight: float
+  normalizer: ScoreNormalizer
+}
+
+export enum ScoreNormalizer {
+  none,
+  minmax
+}
+
+export class SpecifiedDocument {
+  index?: string
+  id: string
+}
+
 export class StandardRetriever extends RetrieverBase {
   /** Defines a query to retrieve a set of top documents. */
   query?: QueryContainer