hermes-client-typescript 1.7.11 → 1.7.15

package/dist/index.d.ts

@@ -1,4 +1,4 @@
 export { HermesClient } from "./client";
-export { Document, SearchHit, SearchResponse, IndexInfo, SearchOptions, TermQuery, BooleanQueryDef, SparseVectorQueryDef, SparseTextQueryDef, DenseVectorQueryDef, RerankerDef, Combiner, RerankerCombiner, } from "./types";
-export { SearchServiceDefinition, IndexServiceDefinition, MultiValueCombiner, Query, TermQuery as PbTermQuery, BooleanQuery, BoostQuery, AllQuery, MatchQuery, SparseVectorQuery, DenseVectorQuery, Reranker, SearchRequest, SearchResponse as PbSearchResponse, SearchHit as PbSearchHit, FieldValue, FieldEntry, SparseVector, DenseVector, GetDocumentRequest, GetDocumentResponse, GetIndexInfoRequest, GetIndexInfoResponse, CreateIndexRequest, CreateIndexResponse, IndexDocumentRequest, IndexDocumentsResponse, BatchIndexDocumentsRequest, BatchIndexDocumentsResponse, NamedDocument, CommitRequest, CommitResponse, ForceMergeRequest, ForceMergeResponse, DeleteIndexRequest, DeleteIndexResponse, ListIndexesRequest, ListIndexesResponse, MemoryStats, IndexingBufferStats, SegmentReaderStats, OrdinalScore, } from "./generated/hermes";
+export type { DocAddress, Document, SearchHit, SearchResponse, SearchTimings, IndexInfo, VectorFieldStats, SearchRequest, Query, TermQuery, MatchQuery, BooleanQuery, BoostQuery, AllQuery, SparseVectorQuery, DenseVectorQuery, Combiner, Reranker, Filter, } from "./types";
+export { SearchServiceDefinition, IndexServiceDefinition, MultiValueCombiner, Query as PbQuery, TermQuery as PbTermQuery, BooleanQuery as PbBooleanQuery, BoostQuery as PbBoostQuery, AllQuery as PbAllQuery, MatchQuery as PbMatchQuery, SparseVectorQuery as PbSparseVectorQuery, DenseVectorQuery as PbDenseVectorQuery, Reranker as PbReranker, SearchRequest as PbSearchRequest, SearchResponse as PbSearchResponse, SearchHit as PbSearchHit, FieldValue, FieldEntry, SparseVector, DenseVector, GetDocumentRequest, DocAddress as PbDocAddress, GetDocumentResponse, GetIndexInfoRequest, GetIndexInfoResponse, CreateIndexRequest, CreateIndexResponse, IndexDocumentRequest, IndexDocumentsResponse, BatchIndexDocumentsRequest, BatchIndexDocumentsResponse, NamedDocument, CommitRequest, CommitResponse, ForceMergeRequest, ForceMergeResponse, DeleteIndexRequest, DeleteIndexResponse, ListIndexesRequest, ListIndexesResponse, MemoryStats, IndexingBufferStats, SegmentReaderStats, OrdinalScore, Filter as PbFilter, } from "./generated/hermes";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,EACL,QAAQ,EACR,SAAS,EACT,cAAc,EACd,SAAS,EACT,aAAa,EACb,SAAS,EACT,eAAe,EACf,oBAAoB,EACpB,kBAAkB,EAClB,mBAAmB,EACnB,WAAW,EACX,QAAQ,EACR,gBAAgB,GACjB,MAAM,SAAS,CAAC;AAEjB,OAAO,EACL,uBAAuB,EACvB,sBAAsB,EACtB,kBAAkB,EAClB,KAAK,EACL,SAAS,IAAI,WAAW,EACxB,YAAY,EACZ,UAAU,EACV,QAAQ,EACR,UAAU,EACV,iBAAiB,EACjB,gBAAgB,EAChB,QAAQ,EACR,aAAa,EACb,cAAc,IAAI,gBAAgB,EAClC,SAAS,IAAI,WAAW,EACxB,UAAU,EACV,UAAU,EACV,YAAY,EACZ,WAAW,EACX,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,EACpB,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,sBAAsB,EACtB,0BAA0B,EAC1B,2BAA2B,EAC3B,aAAa,EACb,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,WAAW,EACX,mBAAmB,EACnB,kBAAkB,EAClB,YAAY,GACb,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,YAAY,EACV,UAAU,EACV,QAAQ,EACR,SAAS,EACT,cAAc,EACd,aAAa,EACb,SAAS,EACT,gBAAgB,EAChB,aAAa,EACb,KAAK,EACL,SAAS,EACT,UAAU,EACV,YAAY,EACZ,UAAU,EACV,QAAQ,EACR,iBAAiB,EACjB,gBAAgB,EAChB,QAAQ,EACR,QAAQ,EACR,MAAM,GACP,MAAM,SAAS,CAAC;AAEjB,OAAO,EACL,uBAAuB,EACvB,sBAAsB,EACtB,kBAAkB,EAClB,KAAK,IAAI,OAAO,EAChB,SAAS,IAAI,WAAW,EACxB,YAAY,IAAI,cAAc,EAC9B,UAAU,IAAI,YAAY,EAC1B,QAAQ,IAAI,UAAU,EACtB,UAAU,IAAI,YAAY,EAC1B,iBAAiB,IAAI,mBAAmB,EACxC,gBAAgB,IAAI,kBAAkB,EACtC,QAAQ,IAAI,UAAU,EACtB,aAAa,IAAI,eAAe,EAChC,cAAc,IAAI,gBAAgB,EAClC,SAAS,IAAI,WAAW,EACxB,UAAU,EACV,UAAU,EACV,YAAY,EACZ,WAAW,EACX,kBAAkB,EAClB,UAAU,IAAI,YAAY,EAC1B,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,EACpB,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,sBAAsB,EACtB,0BAA0B,EAC1B,2BAA2B,EAC3B,aAAa,EACb,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,WAAW,EACX,mBAAmB,EACnB,kBAAkB,EAClB,YAAY,EACZ,MAAM,IAAI,QAAQ,GACnB,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -1,22 +1,22 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.OrdinalScore = exports.SegmentReaderStats = exports.IndexingBufferStats = exports.MemoryStats = exports.ListIndexesResponse = exports.ListIndexesRequest = exports.DeleteIndexResponse = exports.DeleteIndexRequest = exports.ForceMergeResponse = exports.ForceMergeRequest = exports.CommitResponse = exports.CommitRequest = exports.NamedDocument = exports.BatchIndexDocumentsResponse = exports.BatchIndexDocumentsRequest = exports.IndexDocumentsResponse = exports.IndexDocumentRequest = exports.CreateIndexResponse = exports.CreateIndexRequest = exports.GetIndexInfoResponse = exports.GetIndexInfoRequest = exports.GetDocumentResponse = exports.GetDocumentRequest = exports.DenseVector = exports.SparseVector = exports.FieldEntry = exports.FieldValue = exports.PbSearchHit = exports.PbSearchResponse = exports.SearchRequest = exports.Reranker = exports.DenseVectorQuery = exports.SparseVectorQuery = exports.MatchQuery = exports.AllQuery = exports.BoostQuery = exports.BooleanQuery = exports.PbTermQuery = exports.Query = exports.MultiValueCombiner = exports.IndexServiceDefinition = exports.SearchServiceDefinition = exports.HermesClient = void 0;
+exports.PbFilter = exports.OrdinalScore = exports.SegmentReaderStats = exports.IndexingBufferStats = exports.MemoryStats = exports.ListIndexesResponse = exports.ListIndexesRequest = exports.DeleteIndexResponse = exports.DeleteIndexRequest = exports.ForceMergeResponse = exports.ForceMergeRequest = exports.CommitResponse = exports.CommitRequest = exports.NamedDocument = exports.BatchIndexDocumentsResponse = exports.BatchIndexDocumentsRequest = exports.IndexDocumentsResponse = exports.IndexDocumentRequest = exports.CreateIndexResponse = exports.CreateIndexRequest = exports.GetIndexInfoResponse = exports.GetIndexInfoRequest = exports.GetDocumentResponse = exports.PbDocAddress = exports.GetDocumentRequest = exports.DenseVector = exports.SparseVector = exports.FieldEntry = exports.FieldValue = exports.PbSearchHit = exports.PbSearchResponse = exports.PbSearchRequest = exports.PbReranker = exports.PbDenseVectorQuery = exports.PbSparseVectorQuery = exports.PbMatchQuery = exports.PbAllQuery = exports.PbBoostQuery = exports.PbBooleanQuery = exports.PbTermQuery = exports.PbQuery = exports.MultiValueCombiner = exports.IndexServiceDefinition = exports.SearchServiceDefinition = exports.HermesClient = void 0;
 var client_1 = require("./client");
 Object.defineProperty(exports, "HermesClient", { enumerable: true, get: function () { return client_1.HermesClient; } });
 var hermes_1 = require("./generated/hermes");
 Object.defineProperty(exports, "SearchServiceDefinition", { enumerable: true, get: function () { return hermes_1.SearchServiceDefinition; } });
 Object.defineProperty(exports, "IndexServiceDefinition", { enumerable: true, get: function () { return hermes_1.IndexServiceDefinition; } });
 Object.defineProperty(exports, "MultiValueCombiner", { enumerable: true, get: function () { return hermes_1.MultiValueCombiner; } });
-Object.defineProperty(exports, "Query", { enumerable: true, get: function () { return hermes_1.Query; } });
+Object.defineProperty(exports, "PbQuery", { enumerable: true, get: function () { return hermes_1.Query; } });
 Object.defineProperty(exports, "PbTermQuery", { enumerable: true, get: function () { return hermes_1.TermQuery; } });
-Object.defineProperty(exports, "BooleanQuery", { enumerable: true, get: function () { return hermes_1.BooleanQuery; } });
-Object.defineProperty(exports, "BoostQuery", { enumerable: true, get: function () { return hermes_1.BoostQuery; } });
-Object.defineProperty(exports, "AllQuery", { enumerable: true, get: function () { return hermes_1.AllQuery; } });
-Object.defineProperty(exports, "MatchQuery", { enumerable: true, get: function () { return hermes_1.MatchQuery; } });
-Object.defineProperty(exports, "SparseVectorQuery", { enumerable: true, get: function () { return hermes_1.SparseVectorQuery; } });
-Object.defineProperty(exports, "DenseVectorQuery", { enumerable: true, get: function () { return hermes_1.DenseVectorQuery; } });
-Object.defineProperty(exports, "Reranker", { enumerable: true, get: function () { return hermes_1.Reranker; } });
-Object.defineProperty(exports, "SearchRequest", { enumerable: true, get: function () { return hermes_1.SearchRequest; } });
+Object.defineProperty(exports, "PbBooleanQuery", { enumerable: true, get: function () { return hermes_1.BooleanQuery; } });
+Object.defineProperty(exports, "PbBoostQuery", { enumerable: true, get: function () { return hermes_1.BoostQuery; } });
+Object.defineProperty(exports, "PbAllQuery", { enumerable: true, get: function () { return hermes_1.AllQuery; } });
+Object.defineProperty(exports, "PbMatchQuery", { enumerable: true, get: function () { return hermes_1.MatchQuery; } });
+Object.defineProperty(exports, "PbSparseVectorQuery", { enumerable: true, get: function () { return hermes_1.SparseVectorQuery; } });
+Object.defineProperty(exports, "PbDenseVectorQuery", { enumerable: true, get: function () { return hermes_1.DenseVectorQuery; } });
+Object.defineProperty(exports, "PbReranker", { enumerable: true, get: function () { return hermes_1.Reranker; } });
+Object.defineProperty(exports, "PbSearchRequest", { enumerable: true, get: function () { return hermes_1.SearchRequest; } });
 Object.defineProperty(exports, "PbSearchResponse", { enumerable: true, get: function () { return hermes_1.SearchResponse; } });
 Object.defineProperty(exports, "PbSearchHit", { enumerable: true, get: function () { return hermes_1.SearchHit; } });
 Object.defineProperty(exports, "FieldValue", { enumerable: true, get: function () { return hermes_1.FieldValue; } });
@@ -24,6 +24,7 @@ Object.defineProperty(exports, "FieldEntry", { enumerable: true, get: function (
 Object.defineProperty(exports, "SparseVector", { enumerable: true, get: function () { return hermes_1.SparseVector; } });
 Object.defineProperty(exports, "DenseVector", { enumerable: true, get: function () { return hermes_1.DenseVector; } });
 Object.defineProperty(exports, "GetDocumentRequest", { enumerable: true, get: function () { return hermes_1.GetDocumentRequest; } });
+Object.defineProperty(exports, "PbDocAddress", { enumerable: true, get: function () { return hermes_1.DocAddress; } });
 Object.defineProperty(exports, "GetDocumentResponse", { enumerable: true, get: function () { return hermes_1.GetDocumentResponse; } });
 Object.defineProperty(exports, "GetIndexInfoRequest", { enumerable: true, get: function () { return hermes_1.GetIndexInfoRequest; } });
 Object.defineProperty(exports, "GetIndexInfoResponse", { enumerable: true, get: function () { return hermes_1.GetIndexInfoResponse; } });
@@ -46,4 +47,5 @@ Object.defineProperty(exports, "MemoryStats", { enumerable: true, get: function
 Object.defineProperty(exports, "IndexingBufferStats", { enumerable: true, get: function () { return hermes_1.IndexingBufferStats; } });
 Object.defineProperty(exports, "SegmentReaderStats", { enumerable: true, get: function () { return hermes_1.SegmentReaderStats; } });
 Object.defineProperty(exports, "OrdinalScore", { enumerable: true, get: function () { return hermes_1.OrdinalScore; } });
+Object.defineProperty(exports, "PbFilter", { enumerable: true, get: function () { return hermes_1.Filter; } });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,mCAAwC;AAA/B,sGAAA,YAAY,OAAA;AAiBrB,6CA2C4B;AA1C1B,iHAAA,uBAAuB,OAAA;AACvB,gHAAA,sBAAsB,OAAA;AACtB,4GAAA,kBAAkB,OAAA;AAClB,+FAAA,KAAK,OAAA;AACL,qGAAA,SAAS,OAAe;AACxB,sGAAA,YAAY,OAAA;AACZ,oGAAA,UAAU,OAAA;AACV,kGAAA,QAAQ,OAAA;AACR,oGAAA,UAAU,OAAA;AACV,2GAAA,iBAAiB,OAAA;AACjB,0GAAA,gBAAgB,OAAA;AAChB,kGAAA,QAAQ,OAAA;AACR,uGAAA,aAAa,OAAA;AACb,0GAAA,cAAc,OAAoB;AAClC,qGAAA,SAAS,OAAe;AACxB,oGAAA,UAAU,OAAA;AACV,oGAAA,UAAU,OAAA;AACV,sGAAA,YAAY,OAAA;AACZ,qGAAA,WAAW,OAAA;AACX,4GAAA,kBAAkB,OAAA;AAClB,6GAAA,mBAAmB,OAAA;AACnB,6GAAA,mBAAmB,OAAA;AACnB,8GAAA,oBAAoB,OAAA;AACpB,4GAAA,kBAAkB,OAAA;AAClB,6GAAA,mBAAmB,OAAA;AACnB,8GAAA,oBAAoB,OAAA;AACpB,gHAAA,sBAAsB,OAAA;AACtB,oHAAA,0BAA0B,OAAA;AAC1B,qHAAA,2BAA2B,OAAA;AAC3B,uGAAA,aAAa,OAAA;AACb,uGAAA,aAAa,OAAA;AACb,wGAAA,cAAc,OAAA;AACd,2GAAA,iBAAiB,OAAA;AACjB,4GAAA,kBAAkB,OAAA;AAClB,4GAAA,kBAAkB,OAAA;AAClB,6GAAA,mBAAmB,OAAA;AACnB,4GAAA,kBAAkB,OAAA;AAClB,6GAAA,mBAAmB,OAAA;AACnB,qGAAA,WAAW,OAAA;AACX,6GAAA,mBAAmB,OAAA;AACnB,4GAAA,kBAAkB,OAAA;AAClB,sGAAA,YAAY,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,mCAAwC;AAA/B,sGAAA,YAAY,OAAA;AAuBrB,6CA6C4B;AA5C1B,iHAAA,uBAAuB,OAAA;AACvB,gHAAA,sBAAsB,OAAA;AACtB,4GAAA,kBAAkB,OAAA;AAClB,iGAAA,KAAK,OAAW;AAChB,qGAAA,SAAS,OAAe;AACxB,wGAAA,YAAY,OAAkB;AAC9B,sGAAA,UAAU,OAAgB;AAC1B,oGAAA,QAAQ,OAAc;AACtB,sGAAA,UAAU,OAAgB;AAC1B,6GAAA,iBAAiB,OAAuB;AACxC,4GAAA,gBAAgB,OAAsB;AACtC,oGAAA,QAAQ,OAAc;AACtB,yGAAA,aAAa,OAAmB;AAChC,0GAAA,cAAc,OAAoB;AAClC,qGAAA,SAAS,OAAe;AACxB,oGAAA,UAAU,OAAA;AACV,oGAAA,UAAU,OAAA;AACV,sGAAA,YAAY,OAAA;AACZ,qGAAA,WAAW,OAAA;AACX,4GAAA,kBAAkB,OAAA;AAClB,sGAAA,UAAU,OAAgB;AAC1B,6GAAA,mBAAmB,OAAA;AACnB,6GAAA,mBAAmB,OAAA;AACnB,8GAAA,oBAAoB,OAAA;AACpB,4GAAA,kBAAkB,OAAA;AAClB,6GAAA,mBAAmB,OAAA;AACnB,8GAAA,oBAAoB,OAAA;AACpB,gHAAA,sBAAsB,OAAA;AACtB,oHAAA,0BAA0B,OAAA;AAC1B,qHAAA,2BAA2B,OAAA;AAC3B,uGAAA,aAAa,OAAA;AACb,uGAAA,aAAa,OAAA;AACb,wGAAA,cAAc,OAAA;AACd,2GAAA,iBAAiB,OAAA;AACjB,4GAAA,kBAAkB,OAAA;AAClB,4GAAA,kBAAkB,OAAA;AAClB,6GAAA,mBAAmB,OAAA;AACnB,4GAAA,kBAAkB,OAAA;AAClB,6GAAA,mBAAmB,OAAA;AACnB,qGAAA,WAAW,OAAA;AACX,6GAAA,mBAAmB,OAAA;AACnB,4GAAA,kBAAkB,OAAA;AAClB,sGAAA,YAAY,OAAA;AACZ,kGAAA,MAAM,OAAY"}

package/dist/types.d.ts

@@ -2,9 +2,14 @@
 export interface Document {
     fields: Record<string, any>;
 }
+/** Unique document address: segment + local doc_id. */
+export interface DocAddress {
+    segmentId: string;
+    docId: number;
+}
 /** A single search result. */
 export interface SearchHit {
-    docId: number;
+    address: DocAddress;
     score: number;
     fields: Record<string, any>;
 }
@@ -22,48 +27,130 @@ export interface SearchResponse {
     tookMs: number;
     timings?: SearchTimings;
 }
+/** Per-field vector statistics. */
+export interface VectorFieldStats {
+    fieldName: string;
+    vectorType: string;
+    totalVectors: number;
+    dimension: number;
+}
 /** Information about an index. */
 export interface IndexInfo {
     indexName: string;
     numDocs: number;
     numSegments: number;
     schema: string;
+    vectorStats: VectorFieldStats[];
+}
+export type Combiner = "log_sum_exp" | "max" | "avg" | "sum" | "weighted_top_k";
+export interface TermQuery {
+    field: string;
+    term: string;
+}
+export interface MatchQuery {
+    field: string;
+    text: string;
+}
+export interface BooleanQuery {
+    must?: Query[];
+    should?: Query[];
+    mustNot?: Query[];
+}
+export interface BoostQuery {
+    query: Query;
+    boost: number;
+}
+export interface AllQuery {
 }
-/** Term query: (field, term) */
-export type TermQuery = [string, string];
-/** Boolean query with must/should/mustNot clauses */
-export interface BooleanQueryDef {
-    must?: TermQuery[];
-    should?: TermQuery[];
-    mustNot?: TermQuery[];
-}
-/** Sparse vector query: (field, indices, values) */
-export type SparseVectorQueryDef = [string, number[], number[]];
-/** Sparse text query: (field, text) */
-export type SparseTextQueryDef = [string, string];
-/** Dense vector query: (field, vector) */
-export type DenseVectorQueryDef = [string, number[]];
-/** Reranker: (field, queryVector, l1Limit) */
-export type RerankerDef = [string, number[], number];
-/** Score combiner for multi-value fields */
-export type Combiner = "sum" | "max" | "avg";
-/** Reranker combiner */
-export type RerankerCombiner = "log_sum_exp" | "max" | "avg" | "sum" | "weighted_top_k";
-/** Search options */
-export interface SearchOptions {
-    term?: TermQuery;
-    boolean?: BooleanQueryDef;
-    sparseVector?: SparseVectorQueryDef;
-    sparseText?: SparseTextQueryDef;
-    denseVector?: DenseVectorQueryDef;
+export interface SparseVectorQuery {
+    field: string;
+    /** Pre-computed token indices */
+    indices?: number[];
+    /** Pre-computed token values */
+    values?: number[];
+    /** Raw text (tokenized server-side if tokenizer configured) */
+    text?: string;
+    combiner?: Combiner;
+    /** Approximate search factor (1.0 = exact, 0.8 = ~20% faster) */
+    heapFactor?: number;
+    /** Temperature for LogSumExp combiner (default: 1.5) */
+    combinerTemperature?: number;
+    /** K for WeightedTopK combiner (default: 5) */
+    combinerTopK?: number;
+    /** Decay for WeightedTopK combiner (default: 0.7) */
+    combinerDecay?: number;
+    /** Min abs(weight) for query dims (0 = no filtering) */
+    weightThreshold?: number;
+    /** Max query dimensions to process (0 = all) */
+    maxQueryDims?: number;
+    /** Fraction of query dims to keep (0-1, e.g. 0.1 = top 10%) */
+    pruning?: number;
+}
+export interface DenseVectorQuery {
+    field: string;
+    vector: number[];
+    /** Number of clusters to probe (for IVF indexes) */
     nprobe?: number;
+    /** Re-ranking factor (multiplied by k) */
     rerankFactor?: number;
-    heapFactor?: number;
     combiner?: Combiner;
+    /** Temperature for LogSumExp combiner (default: 1.5) */
+    combinerTemperature?: number;
+    /** K for WeightedTopK combiner (default: 5) */
+    combinerTopK?: number;
+    /** Decay for WeightedTopK combiner (default: 0.7) */
+    combinerDecay?: number;
+}
+/** Discriminated union matching proto Query oneof. Exactly one key must be set. */
+export type Query = {
+    term: TermQuery;
+} | {
+    match: MatchQuery;
+} | {
+    boolean: BooleanQuery;
+} | {
+    sparseVector: SparseVectorQuery;
+} | {
+    denseVector: DenseVectorQuery;
+} | {
+    boost: BoostQuery;
+} | {
+    all: AllQuery;
+};
+export interface Reranker {
+    field: string;
+    vector: number[];
+    /** L1 candidate count (0 = 10x final limit) */
+    limit?: number;
+    combiner?: Combiner;
+    combinerTemperature?: number;
+    combinerTopK?: number;
+    combinerDecay?: number;
+    /** Matryoshka pre-filter dims (0 = disabled) */
+    matryoshkaDims?: number;
+}
+export interface Filter {
+    field: string;
+    eqU64?: number;
+    eqI64?: number;
+    eqF64?: number;
+    eqText?: string;
+    range?: {
+        min?: number;
+        max?: number;
+    };
+    inValues?: {
+        textValues?: string[];
+        u64Values?: number[];
+        i64Values?: number[];
+    };
+}
+export interface SearchRequest {
+    query: Query;
     limit?: number;
     offset?: number;
     fieldsToLoad?: string[];
-    reranker?: RerankerDef;
-    rerankerCombiner?: RerankerCombiner;
+    reranker?: Reranker;
+    filters?: Filter[];
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,oCAAoC;AACpC,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC7B;AAED,8BAA8B;AAC9B,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC7B;AAED,gFAAgF;AAChF,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,8CAA8C;AAC9C,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,SAAS,EAAE,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,aAAa,CAAC;CACzB;AAED,kCAAkC;AAClC,MAAM,WAAW,SAAS;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,gCAAgC;AAChC,MAAM,MAAM,SAAS,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAEzC,qDAAqD;AACrD,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,EAAE,SAAS,EAAE,CAAC;IACnB,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC;IACrB,OAAO,CAAC,EAAE,SAAS,EAAE,CAAC;CACvB;AAED,oDAAoD;AACpD,MAAM,MAAM,oBAAoB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;AAEhE,uCAAuC;AACvC,MAAM,MAAM,kBAAkB,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAElD,0CAA0C;AAC1C,MAAM,MAAM,mBAAmB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;AAErD,8CAA8C;AAC9C,MAAM,MAAM,WAAW,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,MAAM,CAAC,CAAC;AAErD,4CAA4C;AAC5C,MAAM,MAAM,QAAQ,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,CAAC;AAE7C,wBAAwB;AACxB,MAAM,MAAM,gBAAgB,GACxB,aAAa,GACb,KAAK,GACL,KAAK,GACL,KAAK,GACL,gBAAgB,CAAC;AAErB,qBAAqB;AACrB,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,YAAY,CAAC,EAAE,oBAAoB,CAAC;IACpC,UAAU,CAAC,EAAE,kBAAkB,CAAC;IAChC,WAAW,CAAC,EAAE,mBAAmB,CAAC;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,QAAQ,CAAC,EAAE,WAAW,CAAC;IACvB,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;CACrC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -1,3 +1,6 @@
 "use strict";
+// =============================================================================
+// Response types
+// =============================================================================
 Object.defineProperty(exports, "__esModule", { value: true });
 //# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,iBAAiB;AACjB,gFAAgF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hermes-client-typescript",
-  "version": "1.7.11",
+  "version": "1.7.15",
   "description": "TypeScript client for Hermes search server",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",