@loams/client 0.1.0 → 0.1.2

package/dist/vendor/proto/gen/loams/collection/v1/query_pb.d.ts

@@ -0,0 +1,2101 @@
+import type { GenEnum, GenFile, GenMessage, GenService } from "@bufbuild/protobuf/codegenv2";
+import type { Empty, Value } from "@bufbuild/protobuf/wkt";
+import type { Consistency, DocumentId } from "./document_pb.js";
+import type { JsonObject, Message } from "@bufbuild/protobuf";
+/**
+ * Describes the file loams/collection/v1/query.proto.
+ */
+export declare const file_loams_collection_v1_query: GenFile;
+/**
+ * @generated from message loams.collection.v1.SearchRequest
+ */
+export type SearchRequest = Message<"loams.collection.v1.SearchRequest"> & {
+    /**
+     * @generated from field: string namespace = 1;
+     */
+    namespace: string;
+    /**
+     * A collection name or an alias. The alias of `from` is this field's other
+     * name; a request that sets both names one collection, and `collection`
+     * wins.
+     *
+     * @generated from field: string collection = 2;
+     */
+    collection: string;
+    /**
+     * How fresh the read must be. Absent is `FRESHNESS_STRONG`, the same default
+     * the REST route reads, and the `loams-consistency-token` request header
+     * still merges into it by the same rule.
+     *
+     * @generated from field: loams.collection.v1.Consistency consistency = 3;
+     */
+    consistency?: Consistency | undefined;
+    /**
+     * The sources of ranked candidates. Empty with a `filter` is a filter-only
+     * query; empty with neither matches nothing.
+     *
+     * @generated from field: repeated loams.collection.v1.Retriever retrievers = 4;
+     */
+    retrievers: Retriever[];
+    /**
+     * How the ranked lists are combined. Absent is the engine's own combination,
+     * which is RRF.
+     *
+     * @generated from field: loams.collection.v1.Fusion fusion = 5;
+     */
+    fusion?: Fusion | undefined;
+    /**
+     * The filter every retriever's candidates must match.
+     *
+     * @generated from field: loams.collection.v1.Query filter = 6;
+     */
+    filter?: Query | undefined;
+    /**
+     * The effective sort; the primary key ascending always breaks ties (Ruling
+     * 10).
+     *
+     * @generated from field: repeated loams.collection.v1.SortKey sort = 7;
+     */
+    sort: SortKey[];
+    /**
+     * How many hits to skip before the window. `offset` is the IR's, and it is
+     * capped by the engine's own limits.
+     *
+     * @generated from field: uint32 offset = 8;
+     */
+    offset: number;
+    /**
+     * The window size; absent is 10, the IR's default. `optional`, so an
+     * explicit `0` is a window of nothing rather than the default.
+     *
+     * @generated from field: optional uint32 limit = 9;
+     */
+    limit?: number | undefined;
+    /**
+     * The sort values of the last hit of the previous page, for a deep page
+     * jump. Each is the IR's own JSON: `null`, a bool, a number, a string or
+     * `{"uuid": "…"}`.
+     *
+     * @generated from field: repeated google.protobuf.Value search_after = 10;
+     */
+    searchAfter: Value[];
+    /**
+     * Hits scoring below this are dropped. `optional`, so `0` is a threshold and
+     * not an absent one.
+     *
+     * @generated from field: optional float score_threshold = 11;
+     */
+    scoreThreshold?: number | undefined;
+    /**
+     * What to return of each hit, as the REST route's projection JSON
+     * (`{"source": "all" | "none" | {"include": [], "exclude": []},
+     * "vectors": [], "fields": []}`). Absent is everything, and `id` and
+     * `_score` are answered whatever it says.
+     *
+     * @generated from field: google.protobuf.Struct select = 12;
+     */
+    select?: JsonObject | undefined;
+    /**
+     * An ES aggregation request, carried verbatim as Tantivy's own
+     * `Aggregations` JSON owns it.
+     *
+     * @generated from field: google.protobuf.Value aggregations = 13;
+     */
+    aggregations?: Value | undefined;
+    /**
+     * Text fields to highlight, and how.
+     *
+     * @generated from field: loams.collection.v1.Highlight highlight = 14;
+     */
+    highlight?: Highlight | undefined;
+    /**
+     * Groups the hits by a field value instead of answering a flat page.
+     *
+     * @generated from field: loams.collection.v1.GroupBy group_by = 15;
+     */
+    groupBy?: GroupBy | undefined;
+    /**
+     * Whether and how far to count the matches. A `Value` and not a message,
+     * for the reason the header gives.
+     *
+     * @generated from field: google.protobuf.Value track_total_hits = 16;
+     */
+    trackTotalHits?: Value | undefined;
+    /**
+     * **Deprecated; always `invalid_argument`.** `rerank_spec` carries the
+     * stage (GR1 Task 20). The field stays so a body carrying it is refused
+     * rather than silently dropped.
+     *
+     * @generated from field: google.protobuf.Struct rerank = 17 [deprecated = true];
+     * @deprecated
+     */
+    rerank?: JsonObject | undefined;
+    /**
+     * **Deprecated; always `invalid_argument`.** `expand_spec` carries the
+     * stage; see `rerank`.
+     *
+     * @generated from field: google.protobuf.Struct expand = 18 [deprecated = true];
+     * @deprecated
+     */
+    expand?: JsonObject | undefined;
+    /**
+     * Design §05 §4's `from`, verbatim: `"collections.<name>"` or `"<name>"`.
+     * An alias of `collection` (see the header).
+     *
+     * @generated from field: string from = 19;
+     */
+    from: string;
+    /**
+     * Design §05 §4's `retrieve`, verbatim, same element shape. An alias of
+     * `retrievers`.
+     *
+     * @generated from field: repeated loams.collection.v1.Retriever retrieve = 20;
+     */
+    retrieve: Retriever[];
+    /**
+     * Design §05 §4's `fuse`, verbatim: `{"method": "rrf", "k": 60}`. A `Struct`
+     * for the reason the header gives, and an alias of `fusion`.
+     *
+     * @generated from field: google.protobuf.Struct fuse = 21;
+     */
+    fuse?: JsonObject | undefined;
+    /**
+     * Walks a Loams Graph graph from the top hits (design §07 §5.2, GR1 Task
+     * 20). Needs the server's `graph` feature.
+     *
+     * @generated from field: loams.collection.v1.ExpandSpec expand_spec = 22;
+     */
+    expandSpec?: ExpandSpec | undefined;
+    /**
+     * Re-scores the final candidates, seeds and neighbors (§07 §5.2).
+     *
+     * @generated from field: loams.collection.v1.RerankSpec rerank_spec = 23;
+     */
+    rerankSpec?: RerankSpec | undefined;
+};
+/**
+ * Describes the message loams.collection.v1.SearchRequest.
+ * Use `create(SearchRequestSchema)` to create a new message.
+ */
+export declare const SearchRequestSchema: GenMessage<SearchRequest>;
+/**
+ * One source of ranked candidates. A proto oneof, so the JSON is the REST
+ * route's `{"vector": {…}}` / `{"text": {…}}` / `{"fused": {…}}` /
+ * `{"rescore": {…}}` / `{"sparse": {…}}` unchanged, and a retriever that is
+ * none of the five is `invalid_argument`.
+ *
+ * @generated from message loams.collection.v1.Retriever
+ */
+export type Retriever = Message<"loams.collection.v1.Retriever"> & {
+    /**
+     * @generated from oneof loams.collection.v1.Retriever.retriever
+     */
+    retriever: {
+        /**
+         * @generated from field: loams.collection.v1.VectorQuery vector = 1;
+         */
+        value: VectorQuery;
+        case: "vector";
+    } | {
+        /**
+         * @generated from field: loams.collection.v1.TextQuery text = 2;
+         */
+        value: TextQuery;
+        case: "text";
+    } | {
+        /**
+         * Runs its own inputs and fuses them, which makes it a subtree of
+         * retrievers rather than one stage.
+         *
+         * @generated from field: loams.collection.v1.FusedQuery fused = 3;
+         */
+        value: FusedQuery;
+        case: "fused";
+    } | {
+        /**
+         * Re-ranks an input's candidates against a second vector.
+         *
+         * @generated from field: loams.collection.v1.RescoreQuery rescore = 4;
+         */
+        value: RescoreQuery;
+        case: "rescore";
+    } | {
+        /**
+         * Exact sparse-vector search (overview A29).
+         *
+         * @generated from field: loams.collection.v1.SparseQuery sparse = 5;
+         */
+        value: SparseQuery;
+        case: "sparse";
+    } | {
+        case: undefined;
+        value?: undefined;
+    };
+};
+/**
+ * Describes the message loams.collection.v1.Retriever.
+ * Use `create(RetrieverSchema)` to create a new message.
+ */
+export declare const RetrieverSchema: GenMessage<Retriever>;
+/**
+ * @generated from message loams.collection.v1.VectorQuery
+ */
+export type VectorQuery = Message<"loams.collection.v1.VectorQuery"> & {
+    /**
+     * The dense vector column to search.
+     *
+     * @generated from field: string field = 1;
+     */
+    field: string;
+    /**
+     * The query vector, as `[1.0, 0.0, 0.0]`.
+     *
+     * @generated from field: repeated float query = 2;
+     */
+    query: number[];
+    /**
+     * How many candidates this retriever contributes before fusion.
+     *
+     * @generated from field: uint32 k = 3;
+     */
+    k: number;
+    /**
+     * @generated from field: loams.collection.v1.AnnParams params = 4;
+     */
+    params?: AnnParams | undefined;
+    /**
+     * Narrows this retriever's candidates, over and above the request's
+     * `filter`.
+     *
+     * @generated from field: loams.collection.v1.Query filter = 5;
+     */
+    filter?: Query | undefined;
+};
+/**
+ * Describes the message loams.collection.v1.VectorQuery.
+ * Use `create(VectorQuerySchema)` to create a new message.
+ */
+export declare const VectorQuerySchema: GenMessage<VectorQuery>;
+/**
+ * @generated from message loams.collection.v1.TextQuery
+ */
+export type TextQuery = Message<"loams.collection.v1.TextQuery"> & {
+    /**
+     * The query over the collection's text fields.
+     *
+     * @generated from field: loams.collection.v1.Query query = 1;
+     */
+    query?: Query | undefined;
+    /**
+     * @generated from field: uint32 k = 2;
+     */
+    k: number;
+};
+/**
+ * Describes the message loams.collection.v1.TextQuery.
+ * Use `create(TextQuerySchema)` to create a new message.
+ */
+export declare const TextQuerySchema: GenMessage<TextQuery>;
+/**
+ * @generated from message loams.collection.v1.FusedQuery
+ */
+export type FusedQuery = Message<"loams.collection.v1.FusedQuery"> & {
+    /**
+     * @generated from field: repeated loams.collection.v1.Retriever inputs = 1;
+     */
+    inputs: Retriever[];
+    /**
+     * @generated from field: loams.collection.v1.Fusion fusion = 2;
+     */
+    fusion?: Fusion | undefined;
+    /**
+     * @generated from field: uint32 k = 3;
+     */
+    k: number;
+};
+/**
+ * Describes the message loams.collection.v1.FusedQuery.
+ * Use `create(FusedQuerySchema)` to create a new message.
+ */
+export declare const FusedQuerySchema: GenMessage<FusedQuery>;
+/**
+ * @generated from message loams.collection.v1.RescoreQuery
+ */
+export type RescoreQuery = Message<"loams.collection.v1.RescoreQuery"> & {
+    /**
+     * The retriever whose candidates are re-ranked.
+     *
+     * @generated from field: loams.collection.v1.Retriever input = 1;
+     */
+    input?: Retriever | undefined;
+    /**
+     * The vector column to re-score against.
+     *
+     * @generated from field: string field = 2;
+     */
+    field: string;
+    /**
+     * @generated from field: repeated float query = 3;
+     */
+    query: number[];
+    /**
+     * @generated from field: uint32 k = 4;
+     */
+    k: number;
+};
+/**
+ * Describes the message loams.collection.v1.RescoreQuery.
+ * Use `create(RescoreQuerySchema)` to create a new message.
+ */
+export declare const RescoreQuerySchema: GenMessage<RescoreQuery>;
+/**
+ * @generated from message loams.collection.v1.SparseQuery
+ */
+export type SparseQuery = Message<"loams.collection.v1.SparseQuery"> & {
+    /**
+     * The sparse vector column to search.
+     *
+     * @generated from field: string field = 1;
+     */
+    field: string;
+    /**
+     * The query vector, as the sparse vector's own JSON:
+     * `{"indices": [5], "values": [1.0]}`.
+     *
+     * @generated from field: google.protobuf.Struct query = 2;
+     */
+    query?: JsonObject | undefined;
+    /**
+     * @generated from field: uint32 k = 3;
+     */
+    k: number;
+    /**
+     * @generated from field: loams.collection.v1.Query filter = 4;
+     */
+    filter?: Query | undefined;
+    /**
+     * @generated from field: loams.collection.v1.SparseParams params = 5;
+     */
+    params?: SparseParams | undefined;
+};
+/**
+ * Describes the message loams.collection.v1.SparseQuery.
+ * Use `create(SparseQuerySchema)` to create a new message.
+ */
+export declare const SparseQuerySchema: GenMessage<SparseQuery>;
+/**
+ * The parameters of a dense-vector retriever. Every field absent is the
+ * engine's default, which is why they are `optional` rather than sent as
+ * zeroes.
+ *
+ * @generated from message loams.collection.v1.AnnParams
+ */
+export type AnnParams = Message<"loams.collection.v1.AnnParams"> & {
+    /**
+     * Search the whole index exactly instead of approximately. This is not a
+     * free read.
+     *
+     * @generated from field: bool exact = 1;
+     */
+    exact: boolean;
+    /**
+     * HNSW layers probed.
+     *
+     * @generated from field: optional uint32 nprobes = 2;
+     */
+    nprobes?: number | undefined;
+    /**
+     * Candidates the approximate pass re-ranks exactly.
+     *
+     * @generated from field: optional uint32 refine_factor = 3;
+     */
+    refineFactor?: number | undefined;
+    /**
+     * The approximate search's beam width.
+     *
+     * @generated from field: optional uint32 ef = 4;
+     */
+    ef?: number | undefined;
+    /**
+     * Fractions of each candidate's cells to visit (multi-vector).
+     *
+     * @generated from field: optional float oversampling = 5;
+     */
+    oversampling?: number | undefined;
+    /**
+     * A metric override — `cosine`, `dot`, `euclid` or `manhattan` — as the REST
+     * route spells it; only with `exact`. A string rather than an enum so the
+     * REST spelling survives verbatim (the same call `ScanColumn.distance`
+     * makes).
+     *
+     * @generated from field: string distance = 6;
+     */
+    distance: string;
+};
+/**
+ * Describes the message loams.collection.v1.AnnParams.
+ * Use `create(AnnParamsSchema)` to create a new message.
+ */
+export declare const AnnParamsSchema: GenMessage<AnnParams>;
+/**
+ * The parameters of a sparse retriever.
+ *
+ * @generated from message loams.collection.v1.SparseParams
+ */
+export type SparseParams = Message<"loams.collection.v1.SparseParams"> & {
+    /**
+     * The rows the IDF statistics count. Absent is every live row.
+     *
+     * @generated from field: loams.collection.v1.Query idf_corpus = 1;
+     */
+    idfCorpus?: Query | undefined;
+};
+/**
+ * Describes the message loams.collection.v1.SparseParams.
+ * Use `create(SparseParamsSchema)` to create a new message.
+ */
+export declare const SparseParamsSchema: GenMessage<SparseParams>;
+/**
+ * How ranked lists are combined (overview §6.6, Rulings 4 and 5). A proto
+ * oneof, so the JSON is the IR's `{"rrf": {"k": 60}}` / `{"dbsf": {}}` /
+ * `{"weightedSum": {"weights": [0.5, 0.5]}}` — `dbsf` is a unit arm and so is an
+ * empty message, because the REST spelling `"dbsf"` has no oneof form.
+ *
+ * @generated from message loams.collection.v1.Fusion
+ */
+export type Fusion = Message<"loams.collection.v1.Fusion"> & {
+    /**
+     * @generated from oneof loams.collection.v1.Fusion.fusion
+     */
+    fusion: {
+        /**
+         * @generated from field: loams.collection.v1.Rrf rrf = 1;
+         */
+        value: Rrf;
+        case: "rrf";
+    } | {
+        /**
+         * Distance-based score fusion, with the engine's own parameters.
+         *
+         * @generated from field: google.protobuf.Empty dbsf = 2;
+         */
+        value: Empty;
+        case: "dbsf";
+    } | {
+        /**
+         * @generated from field: loams.collection.v1.WeightedSum weighted_sum = 3;
+         */
+        value: WeightedSum;
+        case: "weightedSum";
+    } | {
+        case: undefined;
+        value?: undefined;
+    };
+};
+/**
+ * Describes the message loams.collection.v1.Fusion.
+ * Use `create(FusionSchema)` to create a new message.
+ */
+export declare const FusionSchema: GenMessage<Fusion>;
+/**
+ * @generated from message loams.collection.v1.Rrf
+ */
+export type Rrf = Message<"loams.collection.v1.Rrf"> & {
+    /**
+     * The RRF constant; absent is 60, the IR's default, so `optional` rather
+     * than a `0` the engine would have to read as "no smoothing at all".
+     *
+     * @generated from field: optional uint32 k = 1;
+     */
+    k?: number | undefined;
+};
+/**
+ * Describes the message loams.collection.v1.Rrf.
+ * Use `create(RrfSchema)` to create a new message.
+ */
+export declare const RrfSchema: GenMessage<Rrf>;
+/**
+ * @generated from message loams.collection.v1.WeightedSum
+ */
+export type WeightedSum = Message<"loams.collection.v1.WeightedSum"> & {
+    /**
+     * One weight per input retriever, in the order the retrievers are given.
+     *
+     * @generated from field: repeated float weights = 1;
+     */
+    weights: number[];
+};
+/**
+ * Describes the message loams.collection.v1.WeightedSum.
+ * Use `create(WeightedSumSchema)` to create a new message.
+ */
+export declare const WeightedSumSchema: GenMessage<WeightedSum>;
+/**
+ * A query over the collection's fields: a filter, a text retriever's query, or
+ * a sparse retriever's IDF corpus. A proto oneof, so the JSON is the IR's own
+ * externally-tagged spelling with the one difference proto3 JSON forces: a unit
+ * arm is `{"matchAll": {}}` rather than `"match_all"`, and the arms with an
+ * underscore in them are `lowerCamelCase` (`matchPhrase`, `multiMatch`,
+ * `valuesCount`, `isNull`, `isEmpty`, `queryString`, `constantScore`,
+ * `weightedSum` — see the header).
+ *
+ * @generated from message loams.collection.v1.Query
+ */
+export type Query = Message<"loams.collection.v1.Query"> & {
+    /**
+     * @generated from oneof loams.collection.v1.Query.query
+     */
+    query: {
+        /**
+         * Every document.
+         *
+         * @generated from field: google.protobuf.Empty match_all = 1;
+         */
+        value: Empty;
+        case: "matchAll";
+    } | {
+        /**
+         * No document.
+         *
+         * @generated from field: google.protobuf.Empty match_none = 2;
+         */
+        value: Empty;
+        case: "matchNone";
+    } | {
+        /**
+         * @generated from field: loams.collection.v1.MatchQuery match = 3;
+         */
+        value: MatchQuery;
+        case: "match";
+    } | {
+        /**
+         * @generated from field: loams.collection.v1.MatchPhraseQuery match_phrase = 4;
+         */
+        value: MatchPhraseQuery;
+        case: "matchPhrase";
+    } | {
+        /**
+         * @generated from field: loams.collection.v1.MultiMatchQuery multi_match = 5;
+         */
+        value: MultiMatchQuery;
+        case: "multiMatch";
+    } | {
+        /**
+         * The field equals one value.
+         *
+         * @generated from field: loams.collection.v1.TermQuery term = 6;
+         */
+        value: TermQuery;
+        case: "term";
+    } | {
+        /**
+         * The field equals any of these values.
+         *
+         * @generated from field: loams.collection.v1.TermsQuery terms = 7;
+         */
+        value: TermsQuery;
+        case: "terms";
+    } | {
+        /**
+         * @generated from field: loams.collection.v1.RangeQuery range = 8;
+         */
+        value: RangeQuery;
+        case: "range";
+    } | {
+        /**
+         * The field is present, whatever its value.
+         *
+         * @generated from field: loams.collection.v1.FieldQuery exists = 9;
+         */
+        value: FieldQuery;
+        case: "exists";
+    } | {
+        /**
+         * @generated from field: loams.collection.v1.FieldQuery is_null = 10;
+         */
+        value: FieldQuery;
+        case: "isNull";
+    } | {
+        /**
+         * @generated from field: loams.collection.v1.FieldQuery is_empty = 11;
+         */
+        value: FieldQuery;
+        case: "isEmpty";
+    } | {
+        /**
+         * @generated from field: loams.collection.v1.ValuesCountQuery values_count = 12;
+         */
+        value: ValuesCountQuery;
+        case: "valuesCount";
+    } | {
+        /**
+         * @generated from field: loams.collection.v1.PrefixQuery prefix = 13;
+         */
+        value: PrefixQuery;
+        case: "prefix";
+    } | {
+        /**
+         * @generated from field: loams.collection.v1.WildcardQuery wildcard = 14;
+         */
+        value: WildcardQuery;
+        case: "wildcard";
+    } | {
+        /**
+         * @generated from field: loams.collection.v1.FuzzyQuery fuzzy = 15;
+         */
+        value: FuzzyQuery;
+        case: "fuzzy";
+    } | {
+        /**
+         * @generated from field: loams.collection.v1.QueryStringQuery query_string = 17;
+         */
+        value: QueryStringQuery;
+        case: "queryString";
+    } | {
+        /**
+         * @generated from field: loams.collection.v1.BoolQuery bool = 18;
+         */
+        value: BoolQuery;
+        case: "bool";
+    } | {
+        /**
+         * @generated from field: loams.collection.v1.BoostQuery boost = 19;
+         */
+        value: BoostQuery;
+        case: "boost";
+    } | {
+        /**
+         * @generated from field: loams.collection.v1.ConstantScoreQuery constant_score = 20;
+         */
+        value: ConstantScoreQuery;
+        case: "constantScore";
+    } | {
+        case: undefined;
+        value?: undefined;
+    };
+    /**
+     * The documents with these ids, and no others.
+     *
+     * **Not a oneof arm**, and the reason is a wire spelling rather than a
+     * modelling preference: a proto3 JSON oneof arm is always `{"arm": {…}}`, and
+     * the value here is a **list**, so an arm could only be spelled
+     * `{"ids": {"ids": [1, 2]}}` — a wrapper around one field that no IR has and a
+     * caller would have to learn separately. As a plain field the list sits exactly
+     * where the REST IR puts it: `{"ids": [1, {"uuid": "…"}]}`, which is
+     * `{"ids": [{"uint": "1"}, {"uuid": "…"}]}` in proto3 JSON.
+     *
+     * So `Query` is a oneof **plus** this field, and a request that sets both is
+     * `invalid_argument` rather than letting one silently win: two keys naming two
+     * different filters is a request that cannot be answered. That refusal is the
+     * handler's, not the codec's, and it names the field.
+     *
+     * Each element is a `google.protobuf.Value`, not a `DocumentId`, because a
+     * `repeated` field cannot be a oneof arm in protobuf at all, and because the
+     * `DocumentId` shape `{"uint": "1"}` **is** a `Value` — a one-key struct whose
+     * values are strings, so a `u64::MAX` id stays exact and `{"uuid": "…"}` keeps
+     * the REST spelling verbatim. The handler reads each back through the same
+     * `loams_query::json::pk::from_json` `GetDocumentsRequest.ids` goes through, so
+     * the three arms and their refusals are the document RPCs'. A whole number
+     * (`{"uint": 1}` or a bare `1`, exact up to 2^53) is a `uint` id too, and a
+     * bare string is a `string` id, as the REST route spells them.
+     *
+     * @generated from field: repeated google.protobuf.Value ids = 16;
+     */
+    ids: Value[];
+};
+/**
+ * Describes the message loams.collection.v1.Query.
+ * Use `create(QuerySchema)` to create a new message.
+ */
+export declare const QuerySchema: GenMessage<Query>;
+/**
+ * @generated from message loams.collection.v1.MatchQuery
+ */
+export type MatchQuery = Message<"loams.collection.v1.MatchQuery"> & {
+    /**
+     * @generated from field: string field = 1;
+     */
+    field: string;
+    /**
+     * @generated from field: string text = 2;
+     */
+    text: string;
+    /**
+     * Whether every term must match: `or` or `and`, absent being `or`.
+     *
+     * A **string**, not the `BoolOperator` enum, and this is the one enum-shaped
+     * field in the file that is not one: the IR's spelling is `"or"` / `"and"`
+     * and that is what §05 §4's example body and the native REST route both
+     * write, so an enum here would have the codec refuse `"operator": "or"` as an
+     * unknown variant *before a handler runs* — a refusal with no reason and no
+     * field. A string keeps the REST spelling verbatim, which is the same call
+     * `Patch.mode` and `ScanColumn.role` make for the same reason; `or` and `and`
+     * are the accepted values and anything else is `invalid_argument`.
+     *
+     * @generated from field: string operator = 3;
+     */
+    operator: string;
+    /**
+     * How many of the terms must match, as the IR's own string form (`"2"`,
+     * `"75%"`).
+     *
+     * @generated from field: optional string minimum_should_match = 4;
+     */
+    minimumShouldMatch?: string | undefined;
+    /**
+     * @generated from field: loams.collection.v1.Fuzziness fuzziness = 5;
+     */
+    fuzziness?: Fuzziness | undefined;
+    /**
+     * The analyzer to run, over the field's own.
+     *
+     * @generated from field: string analyzer = 6;
+     */
+    analyzer: string;
+};
+/**
+ * Describes the message loams.collection.v1.MatchQuery.
+ * Use `create(MatchQuerySchema)` to create a new message.
+ */
+export declare const MatchQuerySchema: GenMessage<MatchQuery>;
+/**
+ * @generated from message loams.collection.v1.MatchPhraseQuery
+ */
+export type MatchPhraseQuery = Message<"loams.collection.v1.MatchPhraseQuery"> & {
+    /**
+     * @generated from field: string field = 1;
+     */
+    field: string;
+    /**
+     * @generated from field: string text = 2;
+     */
+    text: string;
+    /**
+     * How far apart the terms may be and still match, in positions.
+     *
+     * @generated from field: uint32 slop = 3;
+     */
+    slop: number;
+};
+/**
+ * Describes the message loams.collection.v1.MatchPhraseQuery.
+ * Use `create(MatchPhraseQuerySchema)` to create a new message.
+ */
+export declare const MatchPhraseQuerySchema: GenMessage<MatchPhraseQuery>;
+/**
+ * @generated from message loams.collection.v1.MultiMatchQuery
+ */
+export type MultiMatchQuery = Message<"loams.collection.v1.MultiMatchQuery"> & {
+    /**
+     * The fields to search, each with its boost. None is every indexed text
+     * field at boost 1, as Elasticsearch's `index.query.default_field` of `*`.
+     *
+     * @generated from field: repeated loams.collection.v1.MultiMatchField fields = 1;
+     */
+    fields: MultiMatchField[];
+    /**
+     * @generated from field: string text = 2;
+     */
+    text: string;
+    /**
+     * How the fields are combined; absent is `MULTI_MATCH_KIND_BEST_FIELDS`.
+     *
+     * @generated from field: loams.collection.v1.MultiMatchKind kind = 3;
+     */
+    kind: MultiMatchKind;
+    /**
+     * @generated from field: loams.collection.v1.BoolOperator operator = 4;
+     */
+    operator: BoolOperator;
+    /**
+     * How much a best-fields match counts against a most-fields one; absent is
+     * the engine's own.
+     *
+     * @generated from field: optional float tie_breaker = 5;
+     */
+    tieBreaker?: number | undefined;
+};
+/**
+ * Describes the message loams.collection.v1.MultiMatchQuery.
+ * Use `create(MultiMatchQuerySchema)` to create a new message.
+ */
+export declare const MultiMatchQuerySchema: GenMessage<MultiMatchQuery>;
+/**
+ * @generated from message loams.collection.v1.MultiMatchField
+ */
+export type MultiMatchField = Message<"loams.collection.v1.MultiMatchField"> & {
+    /**
+     * @generated from field: string field = 1;
+     */
+    field: string;
+    /**
+     * Absent (0) is 1, as a bare field name is in Elasticsearch.
+     *
+     * @generated from field: float boost = 2;
+     */
+    boost: number;
+};
+/**
+ * Describes the message loams.collection.v1.MultiMatchField.
+ * Use `create(MultiMatchFieldSchema)` to create a new message.
+ */
+export declare const MultiMatchFieldSchema: GenMessage<MultiMatchField>;
+/**
+ * @generated from message loams.collection.v1.TermQuery
+ */
+export type TermQuery = Message<"loams.collection.v1.TermQuery"> & {
+    /**
+     * @generated from field: string field = 1;
+     */
+    field: string;
+    /**
+     * The value, as the IR's own JSON: a string, a bool, a number or
+     * `{"date": "<RFC 3339>"}` (Ruling 9).
+     *
+     * @generated from field: google.protobuf.Value value = 2;
+     */
+    value?: Value | undefined;
+};
+/**
+ * Describes the message loams.collection.v1.TermQuery.
+ * Use `create(TermQuerySchema)` to create a new message.
+ */
+export declare const TermQuerySchema: GenMessage<TermQuery>;
+/**
+ * @generated from message loams.collection.v1.TermsQuery
+ */
+export type TermsQuery = Message<"loams.collection.v1.TermsQuery"> & {
+    /**
+     * @generated from field: string field = 1;
+     */
+    field: string;
+    /**
+     * @generated from field: repeated google.protobuf.Value values = 2;
+     */
+    values: Value[];
+};
+/**
+ * Describes the message loams.collection.v1.TermsQuery.
+ * Use `create(TermsQuerySchema)` to create a new message.
+ */
+export declare const TermsQuerySchema: GenMessage<TermsQuery>;
+/**
+ * @generated from message loams.collection.v1.RangeQuery
+ */
+export type RangeQuery = Message<"loams.collection.v1.RangeQuery"> & {
+    /**
+     * @generated from field: string field = 1;
+     */
+    field: string;
+    /**
+     * The bounds, each a value of the field's own kind and each optional: an
+     * absent bound is unbounded on that side. `gt`/`gte` and `lt`/`lte` both set
+     * is `invalid_argument`.
+     *
+     * @generated from field: google.protobuf.Value gt = 2;
+     */
+    gt?: Value | undefined;
+    /**
+     * @generated from field: google.protobuf.Value gte = 3;
+     */
+    gte?: Value | undefined;
+    /**
+     * @generated from field: google.protobuf.Value lt = 4;
+     */
+    lt?: Value | undefined;
+    /**
+     * @generated from field: google.protobuf.Value lte = 5;
+     */
+    lte?: Value | undefined;
+};
+/**
+ * Describes the message loams.collection.v1.RangeQuery.
+ * Use `create(RangeQuerySchema)` to create a new message.
+ */
+export declare const RangeQuerySchema: GenMessage<RangeQuery>;
+/**
+ * `exists`, `is_null` and `is_empty`: one message, because a caller asks the
+ * same question of a field in each case.
+ *
+ * @generated from message loams.collection.v1.FieldQuery
+ */
+export type FieldQuery = Message<"loams.collection.v1.FieldQuery"> & {
+    /**
+     * @generated from field: string field = 1;
+     */
+    field: string;
+};
+/**
+ * Describes the message loams.collection.v1.FieldQuery.
+ * Use `create(FieldQuerySchema)` to create a new message.
+ */
+export declare const FieldQuerySchema: GenMessage<FieldQuery>;
+/**
+ * How many values a field's array (or token) column holds.
+ *
+ * @generated from message loams.collection.v1.ValuesCountQuery
+ */
+export type ValuesCountQuery = Message<"loams.collection.v1.ValuesCountQuery"> & {
+    /**
+     * @generated from field: string field = 1;
+     */
+    field: string;
+    /**
+     * @generated from field: optional uint64 gt = 2;
+     */
+    gt?: bigint | undefined;
+    /**
+     * @generated from field: optional uint64 gte = 3;
+     */
+    gte?: bigint | undefined;
+    /**
+     * @generated from field: optional uint64 lt = 4;
+     */
+    lt?: bigint | undefined;
+    /**
+     * @generated from field: optional uint64 lte = 5;
+     */
+    lte?: bigint | undefined;
+};
+/**
+ * Describes the message loams.collection.v1.ValuesCountQuery.
+ * Use `create(ValuesCountQuerySchema)` to create a new message.
+ */
+export declare const ValuesCountQuerySchema: GenMessage<ValuesCountQuery>;
+/**
+ * @generated from message loams.collection.v1.PrefixQuery
+ */
+export type PrefixQuery = Message<"loams.collection.v1.PrefixQuery"> & {
+    /**
+     * @generated from field: string field = 1;
+     */
+    field: string;
+    /**
+     * @generated from field: string value = 2;
+     */
+    value: string;
+};
+/**
+ * Describes the message loams.collection.v1.PrefixQuery.
+ * Use `create(PrefixQuerySchema)` to create a new message.
+ */
+export declare const PrefixQuerySchema: GenMessage<PrefixQuery>;
+/**
+ * @generated from message loams.collection.v1.WildcardQuery
+ */
+export type WildcardQuery = Message<"loams.collection.v1.WildcardQuery"> & {
+    /**
+     * @generated from field: string field = 1;
+     */
+    field: string;
+    /**
+     * With `*` and `?`, as the REST route spells it.
+     *
+     * @generated from field: string pattern = 2;
+     */
+    pattern: string;
+};
+/**
+ * Describes the message loams.collection.v1.WildcardQuery.
+ * Use `create(WildcardQuerySchema)` to create a new message.
+ */
+export declare const WildcardQuerySchema: GenMessage<WildcardQuery>;
+/**
+ * @generated from message loams.collection.v1.FuzzyQuery
+ */
+export type FuzzyQuery = Message<"loams.collection.v1.FuzzyQuery"> & {
+    /**
+     * @generated from field: string field = 1;
+     */
+    field: string;
+    /**
+     * @generated from field: string value = 2;
+     */
+    value: string;
+    /**
+     * @generated from field: loams.collection.v1.Fuzziness fuzziness = 3;
+     */
+    fuzziness?: Fuzziness | undefined;
+};
+/**
+ * Describes the message loams.collection.v1.FuzzyQuery.
+ * Use `create(FuzzyQuerySchema)` to create a new message.
+ */
+export declare const FuzzyQuerySchema: GenMessage<FuzzyQuery>;
+/**
+ * @generated from message loams.collection.v1.QueryStringQuery
+ */
+export type QueryStringQuery = Message<"loams.collection.v1.QueryStringQuery"> & {
+    /**
+     * The Lucene query language, as the REST route's `query_string` takes it.
+     *
+     * @generated from field: string query = 1;
+     */
+    query: string;
+    /**
+     * The fields to search when the query names none. None is every indexed
+     * text field, as Elasticsearch's `index.query.default_field` of `*`.
+     *
+     * @generated from field: repeated string default_fields = 2;
+     */
+    defaultFields: string[];
+    /**
+     * @generated from field: loams.collection.v1.BoolOperator default_operator = 3;
+     */
+    defaultOperator: BoolOperator;
+};
+/**
+ * Describes the message loams.collection.v1.QueryStringQuery.
+ * Use `create(QueryStringQuerySchema)` to create a new message.
+ */
+export declare const QueryStringQuerySchema: GenMessage<QueryStringQuery>;
+/**
+ * @generated from message loams.collection.v1.BoolQuery
+ */
+export type BoolQuery = Message<"loams.collection.v1.BoolQuery"> & {
+    /**
+     * Every one of these must match.
+     *
+     * @generated from field: repeated loams.collection.v1.Query must = 1;
+     */
+    must: Query[];
+    /**
+     * At least `minimum_should_match` of these must match, and scoring is their
+     * sum.
+     *
+     * @generated from field: repeated loams.collection.v1.Query should = 2;
+     */
+    should: Query[];
+    /**
+     * None of these may match.
+     *
+     * @generated from field: repeated loams.collection.v1.Query must_not = 3;
+     */
+    mustNot: Query[];
+    /**
+     * These must match and do not score.
+     *
+     * @generated from field: repeated loams.collection.v1.Query filter = 4;
+     */
+    filter: Query[];
+    /**
+     * @generated from field: optional string minimum_should_match = 5;
+     */
+    minimumShouldMatch?: string | undefined;
+};
+/**
+ * Describes the message loams.collection.v1.BoolQuery.
+ * Use `create(BoolQuerySchema)` to create a new message.
+ */
+export declare const BoolQuerySchema: GenMessage<BoolQuery>;
+/**
+ * @generated from message loams.collection.v1.BoostQuery
+ */
+export type BoostQuery = Message<"loams.collection.v1.BoostQuery"> & {
+    /**
+     * The query whose score is multiplied.
+     *
+     * @generated from field: loams.collection.v1.Query query = 1;
+     */
+    query?: Query | undefined;
+    /**
+     * @generated from field: float boost = 2;
+     */
+    boost: number;
+};
+/**
+ * Describes the message loams.collection.v1.BoostQuery.
+ * Use `create(BoostQuerySchema)` to create a new message.
+ */
+export declare const BoostQuerySchema: GenMessage<BoostQuery>;
+/**
+ * @generated from message loams.collection.v1.ConstantScoreQuery
+ */
+export type ConstantScoreQuery = Message<"loams.collection.v1.ConstantScoreQuery"> & {
+    /**
+     * The query that decides membership; its own score is discarded.
+     *
+     * @generated from field: loams.collection.v1.Query query = 1;
+     */
+    query?: Query | undefined;
+    /**
+     * The score every match is given.
+     *
+     * @generated from field: float score = 2;
+     */
+    score: number;
+};
+/**
+ * Describes the message loams.collection.v1.ConstantScoreQuery.
+ * Use `create(ConstantScoreQuerySchema)` to create a new message.
+ */
+export declare const ConstantScoreQuerySchema: GenMessage<ConstantScoreQuery>;
+/**
+ * How far a fuzzy match may edit. A oneof, so the REST spellings `"auto"` and
+ * an integer 0–2 become `{"auto": {}}` and `{"edits": 1}` — a bare string has
+ * no oneof form, the same reason `match_all` is an empty message.
+ *
+ * @generated from message loams.collection.v1.Fuzziness
+ */
+export type Fuzziness = Message<"loams.collection.v1.Fuzziness"> & {
+    /**
+     * @generated from oneof loams.collection.v1.Fuzziness.fuzziness
+     */
+    fuzziness: {
+        /**
+         * The engine picks from the term's length.
+         *
+         * @generated from field: google.protobuf.Empty auto = 1;
+         */
+        value: Empty;
+        case: "auto";
+    } | {
+        /**
+         * An exact number of edits, 0 to 2.
+         *
+         * @generated from field: uint32 edits = 2;
+         */
+        value: number;
+        case: "edits";
+    } | {
+        case: undefined;
+        value?: undefined;
+    };
+};
+/**
+ * Describes the message loams.collection.v1.Fuzziness.
+ * Use `create(FuzzinessSchema)` to create a new message.
+ */
+export declare const FuzzinessSchema: GenMessage<Fuzziness>;
+/**
+ * One key of the effective sort; the primary key ascending always breaks ties
+ * (Ruling 10). A proto oneof, so the JSON is `{"score": {"order": …}}` /
+ * `{"pk": {"order": …}}` / `{"field": {"field": …, "order": …,
+ * "missing": …}}` — the same shape the IR's serde produces, and
+ * `{"pk": {}}` remains a valid way to say "primary key, ascending".
+ *
+ * @generated from message loams.collection.v1.SortKey
+ */
+export type SortKey = Message<"loams.collection.v1.SortKey"> & {
+    /**
+     * @generated from oneof loams.collection.v1.SortKey.key
+     */
+    key: {
+        /**
+         * @generated from field: loams.collection.v1.ScoreSort score = 1;
+         */
+        value: ScoreSort;
+        case: "score";
+    } | {
+        /**
+         * @generated from field: loams.collection.v1.PrimaryKeySort pk = 2;
+         */
+        value: PrimaryKeySort;
+        case: "pk";
+    } | {
+        /**
+         * @generated from field: loams.collection.v1.FieldSort field = 3;
+         */
+        value: FieldSort;
+        case: "field";
+    } | {
+        case: undefined;
+        value?: undefined;
+    };
+};
+/**
+ * Describes the message loams.collection.v1.SortKey.
+ * Use `create(SortKeySchema)` to create a new message.
+ */
+export declare const SortKeySchema: GenMessage<SortKey>;
+/**
+ * @generated from message loams.collection.v1.ScoreSort
+ */
+export type ScoreSort = Message<"loams.collection.v1.ScoreSort"> & {
+    /**
+     * Absent is descending, which is what sorting by score means.
+     *
+     * @generated from field: loams.collection.v1.SortOrder order = 1;
+     */
+    order: SortOrder;
+};
+/**
+ * Describes the message loams.collection.v1.ScoreSort.
+ * Use `create(ScoreSortSchema)` to create a new message.
+ */
+export declare const ScoreSortSchema: GenMessage<ScoreSort>;
+/**
+ * @generated from message loams.collection.v1.PrimaryKeySort
+ */
+export type PrimaryKeySort = Message<"loams.collection.v1.PrimaryKeySort"> & {
+    /**
+     * Absent is ascending.
+     *
+     * @generated from field: loams.collection.v1.SortOrder order = 1;
+     */
+    order: SortOrder;
+};
+/**
+ * Describes the message loams.collection.v1.PrimaryKeySort.
+ * Use `create(PrimaryKeySortSchema)` to create a new message.
+ */
+export declare const PrimaryKeySortSchema: GenMessage<PrimaryKeySort>;
+/**
+ * @generated from message loams.collection.v1.FieldSort
+ */
+export type FieldSort = Message<"loams.collection.v1.FieldSort"> & {
+    /**
+     * @generated from field: string field = 1;
+     */
+    field: string;
+    /**
+     * Absent is ascending.
+     *
+     * @generated from field: loams.collection.v1.SortOrder order = 2;
+     */
+    order: SortOrder;
+    /**
+     * Where a document without the field sorts. Absent is last.
+     *
+     * @generated from field: loams.collection.v1.MissingOrder missing = 3;
+     */
+    missing: MissingOrder;
+};
+/**
+ * Describes the message loams.collection.v1.FieldSort.
+ * Use `create(FieldSortSchema)` to create a new message.
+ */
+export declare const FieldSortSchema: GenMessage<FieldSort>;
+/**
+ * Highlighting of text fields (ES `highlight`).
+ *
+ * @generated from message loams.collection.v1.Highlight
+ */
+export type Highlight = Message<"loams.collection.v1.Highlight"> & {
+    /**
+     * @generated from field: repeated loams.collection.v1.HighlightField fields = 1;
+     */
+    fields: HighlightField[];
+};
+/**
+ * Describes the message loams.collection.v1.Highlight.
+ * Use `create(HighlightSchema)` to create a new message.
+ */
+export declare const HighlightSchema: GenMessage<Highlight>;
+/**
+ * @generated from message loams.collection.v1.HighlightField
+ */
+export type HighlightField = Message<"loams.collection.v1.HighlightField"> & {
+    /**
+     * @generated from field: string field = 1;
+     */
+    field: string;
+    /**
+     * What wraps a matched term. Absent is the IR's `<em>` / `</em>`, which is
+     * why both are `optional`: proto3 cannot tell an absent string from `""`,
+     * and `""` is a legitimate tag.
+     *
+     * @generated from field: optional string pre_tag = 2;
+     */
+    preTag?: string | undefined;
+    /**
+     * @generated from field: optional string post_tag = 3;
+     */
+    postTag?: string | undefined;
+    /**
+     * The size of one fragment in characters; absent is the IR's 100.
+     *
+     * @generated from field: optional uint32 fragment_size = 4;
+     */
+    fragmentSize?: number | undefined;
+    /**
+     * How many fragments of the field to answer; absent is the IR's 5.
+     *
+     * @generated from field: optional uint32 number_of_fragments = 5;
+     */
+    numberOfFragments?: number | undefined;
+};
+/**
+ * Describes the message loams.collection.v1.HighlightField.
+ * Use `create(HighlightFieldSchema)` to create a new message.
+ */
+export declare const HighlightFieldSchema: GenMessage<HighlightField>;
+/**
+ * Groups hits by a field value (Qdrant's `group_by`).
+ *
+ * @generated from message loams.collection.v1.GroupBy
+ */
+export type GroupBy = Message<"loams.collection.v1.GroupBy"> & {
+    /**
+     * @generated from field: string field = 1;
+     */
+    field: string;
+    /**
+     * How many hits of a group to answer; absent is the IR's 3.
+     *
+     * @generated from field: optional uint32 group_size = 2;
+     */
+    groupSize?: number | undefined;
+    /**
+     * How many groups to answer; absent is the IR's 10.
+     *
+     * @generated from field: optional uint32 limit = 3;
+     */
+    limit?: number | undefined;
+};
+/**
+ * Describes the message loams.collection.v1.GroupBy.
+ * Use `create(GroupBySchema)` to create a new message.
+ */
+export declare const GroupBySchema: GenMessage<GroupBy>;
+/**
+ * @generated from message loams.collection.v1.SearchResponse
+ */
+export type SearchResponse = Message<"loams.collection.v1.SearchResponse"> & {
+    /**
+     * The hits, in the effective order. Absent when there are none, which is
+     * proto3 JSON's spelling of an empty list.
+     *
+     * @generated from field: repeated loams.collection.v1.Hit hits = 1;
+     */
+    hits: Hit[];
+    /**
+     * How many documents matched. Absent unless `track_total_hits` asked for a
+     * count, because counting is not free.
+     *
+     * @generated from field: loams.collection.v1.TotalHits total = 2;
+     */
+    total?: TotalHits | undefined;
+    /**
+     * The aggregations, as Tantivy's own JSON answers them.
+     *
+     * @generated from field: google.protobuf.Value aggregations = 3;
+     */
+    aggregations?: Value | undefined;
+    /**
+     * The groups, when the request asked to group.
+     *
+     * @generated from field: repeated loams.collection.v1.HitGroup groups = 4;
+     */
+    groups: HitGroup[];
+    /**
+     * The state the read saw (overview §6.5), and a `consistency.at_least` that
+     * reads this state again. The same value is the `loams-consistency-token`
+     * response header.
+     *
+     * @generated from field: string read_token = 5;
+     */
+    readToken: string;
+    /**
+     * The hot structures the read used — `hnsw`, `splits` — in the REST route's
+     * spelling and in declaration order, and **absent when it used none**. The
+     * same list is the `loams-hot-used` response header, which answers `none`
+     * where this answers nothing at all: the header is always there, this field
+     * is only there when there is something in it.
+     *
+     * @generated from field: repeated string hot_used = 6;
+     */
+    hotUsed: string[];
+    /**
+     * The design's per-answer `performance` block (§05 §4). Nothing computes it
+     * yet, on either surface, so it is declared here and never answered: the
+     * field names the contract this answer will meet rather than reporting one
+     * this build does not measure. A REST answer has no such key today, and
+     * adding it to one surface only is exactly what this package's equality test
+     * exists to prevent.
+     *
+     * @generated from field: google.protobuf.Struct performance = 7;
+     */
+    performance?: JsonObject | undefined;
+    /**
+     * What the expansion did, when the request expanded (GR1 Task 20).
+     *
+     * @generated from field: loams.collection.v1.ExpandStats expand = 8;
+     */
+    expand?: ExpandStats | undefined;
+};
+/**
+ * Describes the message loams.collection.v1.SearchResponse.
+ * Use `create(SearchResponseSchema)` to create a new message.
+ */
+export declare const SearchResponseSchema: GenMessage<SearchResponse>;
+/**
+ * One hit.
+ *
+ * @generated from message loams.collection.v1.Hit
+ */
+export type Hit = Message<"loams.collection.v1.Hit"> & {
+    /**
+     * The document's id, as the `DocumentId` oneof `Document.id` already uses,
+     * for Task 3's reason: a `u64::MAX` id must not come back through a
+     * `double`.
+     *
+     * @generated from field: loams.collection.v1.DocumentId pk = 1;
+     */
+    pk?: DocumentId | undefined;
+    /**
+     * Absent at zero, which proto3 JSON spells the same way the REST route
+     * writes `0.0`: a filter-only answer scores nothing.
+     *
+     * @generated from field: float score = 2;
+     */
+    score: number;
+    /**
+     * The values this hit sorts by, in `sort`'s order, so a caller can resume
+     * from it with `search_after`.
+     *
+     * @generated from field: repeated google.protobuf.Value sort_values = 3;
+     */
+    sortValues: Value[];
+    /**
+     * Absent when the projection leaves the source out, rather than an empty
+     * object: "no source" and "an empty source" are different answers.
+     *
+     * @generated from field: google.protobuf.Struct source = 4;
+     */
+    source?: JsonObject | undefined;
+    /**
+     * Dense vectors by name, as the REST route's JSON (`[1.0, 0.0, 0.0]`).
+     *
+     * @generated from field: map<string, google.protobuf.Value> vectors = 5;
+     */
+    vectors: {
+        [key: string]: Value;
+    };
+    /**
+     * Sparse vectors by name, as the REST route's JSON
+     * (`{"indices": [1], "values": [1.0]}`), with `indices` ascending.
+     *
+     * @generated from field: map<string, google.protobuf.Struct> sparse_vectors = 6;
+     */
+    sparseVectors: {
+        [key: string]: JsonObject;
+    };
+    /**
+     * The fragments per field, when `highlight` asked for them. A `Value`
+     * because it is a list of strings, which proto3 JSON spells as a `Value`'s
+     * list.
+     *
+     * @generated from field: map<string, google.protobuf.Value> highlight = 7;
+     */
+    highlight: {
+        [key: string]: Value;
+    };
+    /**
+     * The typed field values per name, as the REST route's JSON (Ruling 9).
+     *
+     * @generated from field: map<string, google.protobuf.Value> fields = 8;
+     */
+    fields: {
+        [key: string]: Value;
+    };
+    /**
+     * The vertices an expansion reached from this hit (`EXPAND_OUTPUT_NESTED`).
+     *
+     * @generated from field: repeated loams.collection.v1.Neighbor neighbors = 9;
+     */
+    neighbors: Neighbor[];
+    /**
+     * What the hit is in the graph (`EXPAND_OUTPUT_FLAT`).
+     *
+     * @generated from field: loams.collection.v1.GraphHit graph = 10;
+     */
+    graph?: GraphHit | undefined;
+};
+/**
+ * Describes the message loams.collection.v1.Hit.
+ * Use `create(HitSchema)` to create a new message.
+ */
+export declare const HitSchema: GenMessage<Hit>;
+/**
+ * The `expand` stage (design §07 §5.2): the top `seeds` hits seed a walk of
+ * a graph. Zero takes each number's default.
+ *
+ * @generated from message loams.collection.v1.ExpandSpec
+ */
+export type ExpandSpec = Message<"loams.collection.v1.ExpandSpec"> & {
+    /**
+     * The graph, in the request's namespace.
+     *
+     * @generated from field: string graph = 1;
+     */
+    graph: string;
+    /**
+     * The hit's source field holding the seed vertex's key; empty: the hit's id.
+     *
+     * @generated from field: string from_field = 2;
+     */
+    fromField: string;
+    /**
+     * The seeds' vertex label; empty: any label.
+     *
+     * @generated from field: string seed_label = 3;
+     */
+    seedLabel: string;
+    /**
+     * How many top hits seed the walk; 0 is 10.
+     *
+     * @generated from field: uint32 seeds = 4;
+     */
+    seeds: number;
+    /**
+     * 1 or 2; 0 is 1.
+     *
+     * @generated from field: uint32 hops = 5;
+     */
+    hops: number;
+    /**
+     * Unspecified is out.
+     *
+     * @generated from field: loams.collection.v1.ExpandDirection direction = 6;
+     */
+    direction: ExpandDirection;
+    /**
+     * Edge types walked; empty walks every type.
+     *
+     * @generated from field: repeated string edge_types = 7;
+     */
+    edgeTypes: string[];
+    /**
+     * Over the edges' properties (the structured subset of `Query`).
+     *
+     * @generated from field: loams.collection.v1.Query edge_filter = 8;
+     */
+    edgeFilter?: Query | undefined;
+    /**
+     * Over the reached vertices' properties.
+     *
+     * @generated from field: loams.collection.v1.Query vertex_filter = 9;
+     */
+    vertexFilter?: Query | undefined;
+    /**
+     * Neighbors per seed; 0 is 50.
+     *
+     * @generated from field: uint32 limit_per_seed = 10;
+     */
+    limitPerSeed: number;
+    /**
+     * Neighbors in all; 0 is 100.
+     *
+     * @generated from field: uint32 limit = 11;
+     */
+    limit: number;
+    /**
+     * The neighbors' document fields, as `select` spells a projection; absent
+     * fetches none.
+     *
+     * @generated from field: google.protobuf.Struct select = 12;
+     */
+    select?: JsonObject | undefined;
+    /**
+     * Unspecified is nested.
+     *
+     * @generated from field: loams.collection.v1.ExpandOutput output = 13;
+     */
+    output: ExpandOutput;
+    /**
+     * A `loams.graph.v1` consistency token: the walk sees at least its writes.
+     *
+     * @generated from field: string consistency_token = 14;
+     */
+    consistencyToken: string;
+};
+/**
+ * Describes the message loams.collection.v1.ExpandSpec.
+ * Use `create(ExpandSpecSchema)` to create a new message.
+ */
+export declare const ExpandSpecSchema: GenMessage<ExpandSpec>;
+/**
+ * The `rerank` stage (design §07 §5.2).
+ *
+ * @generated from message loams.collection.v1.RerankSpec
+ */
+export type RerankSpec = Message<"loams.collection.v1.RerankSpec"> & {
+    /**
+     * @generated from oneof loams.collection.v1.RerankSpec.method
+     */
+    method: {
+        /**
+         * A neighbor scores the most, over its seeds, of seed score × decay^hop.
+         *
+         * @generated from field: loams.collection.v1.InheritRerank inherit = 1;
+         */
+        value: InheritRerank;
+        case: "inherit";
+    } | {
+        /**
+         * The cosine similarity of each candidate's vector to a query vector.
+         *
+         * @generated from field: loams.collection.v1.VectorRerank vector = 2;
+         */
+        value: VectorRerank;
+        case: "vector";
+    } | {
+        /**
+         * An external reranker: off on every server (§05 §4), always refused.
+         *
+         * @generated from field: loams.collection.v1.ModelRerank model = 3;
+         */
+        value: ModelRerank;
+        case: "model";
+    } | {
+        case: undefined;
+        value?: undefined;
+    };
+};
+/**
+ * Describes the message loams.collection.v1.RerankSpec.
+ * Use `create(RerankSpecSchema)` to create a new message.
+ */
+export declare const RerankSpecSchema: GenMessage<RerankSpec>;
+/**
+ * See `RerankSpec.inherit`.
+ *
+ * @generated from message loams.collection.v1.InheritRerank
+ */
+export type InheritRerank = Message<"loams.collection.v1.InheritRerank"> & {
+    /**
+     * 0 to 1; absent is 0.5.
+     *
+     * @generated from field: optional float decay = 1;
+     */
+    decay?: number | undefined;
+};
+/**
+ * Describes the message loams.collection.v1.InheritRerank.
+ * Use `create(InheritRerankSchema)` to create a new message.
+ */
+export declare const InheritRerankSchema: GenMessage<InheritRerank>;
+/**
+ * See `RerankSpec.vector`.
+ *
+ * @generated from message loams.collection.v1.VectorRerank
+ */
+export type VectorRerank = Message<"loams.collection.v1.VectorRerank"> & {
+    /**
+     * A dense vector field of the candidates' collections.
+     *
+     * @generated from field: string field = 1;
+     */
+    field: string;
+    /**
+     * @generated from field: repeated float query = 2;
+     */
+    query: number[];
+};
+/**
+ * Describes the message loams.collection.v1.VectorRerank.
+ * Use `create(VectorRerankSchema)` to create a new message.
+ */
+export declare const VectorRerankSchema: GenMessage<VectorRerank>;
+/**
+ * See `RerankSpec.model`.
+ *
+ * @generated from message loams.collection.v1.ModelRerank
+ */
+export type ModelRerank = Message<"loams.collection.v1.ModelRerank"> & {
+    /**
+     * @generated from field: string endpoint = 1;
+     */
+    endpoint: string;
+    /**
+     * @generated from field: string text_field = 2;
+     */
+    textField: string;
+    /**
+     * @generated from field: string query = 3;
+     */
+    query: string;
+    /**
+     * @generated from field: uint32 top_n = 4;
+     */
+    topN: number;
+};
+/**
+ * Describes the message loams.collection.v1.ModelRerank.
+ * Use `create(ModelRerankSchema)` to create a new message.
+ */
+export declare const ModelRerankSchema: GenMessage<ModelRerank>;
+/**
+ * A vertex an expansion reached.
+ *
+ * @generated from message loams.collection.v1.Neighbor
+ */
+export type Neighbor = Message<"loams.collection.v1.Neighbor"> & {
+    /**
+     * @generated from field: string label = 1;
+     */
+    label: string;
+    /**
+     * Its key: its document's id when a link wrote it.
+     *
+     * @generated from field: loams.collection.v1.DocumentId key = 2;
+     */
+    key?: DocumentId | undefined;
+    /**
+     * @generated from field: uint32 hop = 3;
+     */
+    hop: number;
+    /**
+     * The vertex it was reached from: the seed for hop 1.
+     *
+     * @generated from field: loams.collection.v1.DocumentId via = 4;
+     */
+    via?: DocumentId | undefined;
+    /**
+     * @generated from field: string edge_type = 5;
+     */
+    edgeType: string;
+    /**
+     * The edge's key (its document's id).
+     *
+     * @generated from field: loams.collection.v1.DocumentId edge = 6;
+     */
+    edge?: DocumentId | undefined;
+    /**
+     * @generated from field: float score = 7;
+     */
+    score: number;
+    /**
+     * The vertex's collection, when a collection link wrote it.
+     *
+     * @generated from field: string collection = 8;
+     */
+    collection: string;
+    /**
+     * Its document, when `ExpandSpec.select` asked for one.
+     *
+     * @generated from field: google.protobuf.Struct source = 9;
+     */
+    source?: JsonObject | undefined;
+};
+/**
+ * Describes the message loams.collection.v1.Neighbor.
+ * Use `create(NeighborSchema)` to create a new message.
+ */
+export declare const NeighborSchema: GenMessage<Neighbor>;
+/**
+ * What a flat answer's hit is in the graph.
+ *
+ * @generated from message loams.collection.v1.GraphHit
+ */
+export type GraphHit = Message<"loams.collection.v1.GraphHit"> & {
+    /**
+     * @generated from field: string label = 1;
+     */
+    label: string;
+    /**
+     * 0 for a seed.
+     *
+     * @generated from field: uint32 hop = 2;
+     */
+    hop: number;
+    /**
+     * The seeds it was reached from.
+     *
+     * @generated from field: repeated loams.collection.v1.DocumentId seeds = 3;
+     */
+    seeds: DocumentId[];
+    /**
+     * @generated from field: string collection = 4;
+     */
+    collection: string;
+};
+/**
+ * Describes the message loams.collection.v1.GraphHit.
+ * Use `create(GraphHitSchema)` to create a new message.
+ */
+export declare const GraphHitSchema: GenMessage<GraphHit>;
+/**
+ * What an expansion did.
+ *
+ * @generated from message loams.collection.v1.ExpandStats
+ */
+export type ExpandStats = Message<"loams.collection.v1.ExpandStats"> & {
+    /**
+     * @generated from field: uint64 seeds = 1;
+     */
+    seeds: bigint;
+    /**
+     * Seeds with no key or no vertex.
+     *
+     * @generated from field: uint64 seeds_skipped = 2;
+     */
+    seedsSkipped: bigint;
+    /**
+     * @generated from field: uint64 neighbors = 3;
+     */
+    neighbors: bigint;
+    /**
+     * The graph state the walk read.
+     *
+     * @generated from field: string graph_token = 4;
+     */
+    graphToken: string;
+};
+/**
+ * Describes the message loams.collection.v1.ExpandStats.
+ * Use `create(ExpandStatsSchema)` to create a new message.
+ */
+export declare const ExpandStatsSchema: GenMessage<ExpandStats>;
+/**
+ * One group of a grouped search.
+ *
+ * @generated from message loams.collection.v1.HitGroup
+ */
+export type HitGroup = Message<"loams.collection.v1.HitGroup"> & {
+    /**
+     * The field value the group is, in the IR's own JSON.
+     *
+     * @generated from field: google.protobuf.Value key = 1;
+     */
+    key?: Value | undefined;
+    /**
+     * @generated from field: repeated loams.collection.v1.Hit hits = 2;
+     */
+    hits: Hit[];
+};
+/**
+ * Describes the message loams.collection.v1.HitGroup.
+ * Use `create(HitGroupSchema)` to create a new message.
+ */
+export declare const HitGroupSchema: GenMessage<HitGroup>;
+/**
+ * How many documents matched, and whether the count is exact.
+ *
+ * @generated from message loams.collection.v1.TotalHits
+ */
+export type TotalHits = Message<"loams.collection.v1.TotalHits"> & {
+    /**
+     * The count. `optional` and always set: a count of zero is a count, and
+     * proto3 JSON omitting it would read as "unanswered".
+     *
+     * @generated from field: optional uint64 value = 1;
+     */
+    value?: bigint | undefined;
+    /**
+     * `TOTAL_RELATION_EQ` when `value` is the whole count and
+     * `TOTAL_RELATION_GTE` when it is a floor (`track_total_hits` capped at
+     * `up_to`).
+     *
+     * @generated from field: loams.collection.v1.TotalRelation relation = 2;
+     */
+    relation: TotalRelation;
+};
+/**
+ * Describes the message loams.collection.v1.TotalHits.
+ * Use `create(TotalHitsSchema)` to create a new message.
+ */
+export declare const TotalHitsSchema: GenMessage<TotalHits>;
+/**
+ * `or` / `and`, as the IR spells them.
+ *
+ * Declared for the two fields whose operator the IR spells differently from the
+ * fields above: `MultiMatchQuery.operator` and
+ * `QueryStringQuery.default_operator`, which keep this enum and therefore
+ * answer (and are sent) `BOOL_OPERATOR_OR` / `BOOL_OPERATOR_AND`.
+ *
+ * @generated from enum loams.collection.v1.BoolOperator
+ */
+export declare enum BoolOperator {
+    /**
+     * `or`, which is the IR's default for every operator that defaults.
+     *
+     * @generated from enum value: BOOL_OPERATOR_UNSPECIFIED = 0;
+     */
+    UNSPECIFIED = 0,
+    /**
+     * @generated from enum value: BOOL_OPERATOR_OR = 1;
+     */
+    OR = 1,
+    /**
+     * @generated from enum value: BOOL_OPERATOR_AND = 2;
+     */
+    AND = 2
+}
+/**
+ * Describes the enum loams.collection.v1.BoolOperator.
+ */
+export declare const BoolOperatorSchema: GenEnum<BoolOperator>;
+/**
+ * @generated from enum loams.collection.v1.MultiMatchKind
+ */
+export declare enum MultiMatchKind {
+    /**
+     * `best_fields`, the IR's default.
+     *
+     * @generated from enum value: MULTI_MATCH_KIND_UNSPECIFIED = 0;
+     */
+    UNSPECIFIED = 0,
+    /**
+     * @generated from enum value: MULTI_MATCH_KIND_BEST_FIELDS = 1;
+     */
+    BEST_FIELDS = 1,
+    /**
+     * @generated from enum value: MULTI_MATCH_KIND_MOST_FIELDS = 2;
+     */
+    MOST_FIELDS = 2,
+    /**
+     * @generated from enum value: MULTI_MATCH_KIND_CROSS_FIELDS = 3;
+     */
+    CROSS_FIELDS = 3,
+    /**
+     * @generated from enum value: MULTI_MATCH_KIND_PHRASE = 4;
+     */
+    PHRASE = 4,
+    /**
+     * @generated from enum value: MULTI_MATCH_KIND_PHRASE_PREFIX = 5;
+     */
+    PHRASE_PREFIX = 5
+}
+/**
+ * Describes the enum loams.collection.v1.MultiMatchKind.
+ */
+export declare const MultiMatchKindSchema: GenEnum<MultiMatchKind>;
+/**
+ * @generated from enum loams.collection.v1.SortOrder
+ */
+export declare enum SortOrder {
+    /**
+     * Ascending for a key and a field, descending for a score; each is the IR's
+     * default for that key.
+     *
+     * @generated from enum value: SORT_ORDER_UNSPECIFIED = 0;
+     */
+    UNSPECIFIED = 0,
+    /**
+     * @generated from enum value: SORT_ORDER_ASC = 1;
+     */
+    ASC = 1,
+    /**
+     * @generated from enum value: SORT_ORDER_DESC = 2;
+     */
+    DESC = 2
+}
+/**
+ * Describes the enum loams.collection.v1.SortOrder.
+ */
+export declare const SortOrderSchema: GenEnum<SortOrder>;
+/**
+ * @generated from enum loams.collection.v1.MissingOrder
+ */
+export declare enum MissingOrder {
+    /**
+     * Last, which is the IR's default.
+     *
+     * @generated from enum value: MISSING_ORDER_UNSPECIFIED = 0;
+     */
+    UNSPECIFIED = 0,
+    /**
+     * @generated from enum value: MISSING_ORDER_FIRST = 1;
+     */
+    FIRST = 1,
+    /**
+     * @generated from enum value: MISSING_ORDER_LAST = 2;
+     */
+    LAST = 2
+}
+/**
+ * Describes the enum loams.collection.v1.MissingOrder.
+ */
+export declare const MissingOrderSchema: GenEnum<MissingOrder>;
+/**
+ * Which way an expansion walks the edges.
+ *
+ * @generated from enum loams.collection.v1.ExpandDirection
+ */
+export declare enum ExpandDirection {
+    /**
+     * @generated from enum value: EXPAND_DIRECTION_UNSPECIFIED = 0;
+     */
+    UNSPECIFIED = 0,
+    /**
+     * @generated from enum value: EXPAND_DIRECTION_OUT = 1;
+     */
+    OUT = 1,
+    /**
+     * @generated from enum value: EXPAND_DIRECTION_IN = 2;
+     */
+    IN = 2,
+    /**
+     * @generated from enum value: EXPAND_DIRECTION_BOTH = 3;
+     */
+    BOTH = 3
+}
+/**
+ * Describes the enum loams.collection.v1.ExpandDirection.
+ */
+export declare const ExpandDirectionSchema: GenEnum<ExpandDirection>;
+/**
+ * How the neighbors come back.
+ *
+ * @generated from enum loams.collection.v1.ExpandOutput
+ */
+export declare enum ExpandOutput {
+    /**
+     * @generated from enum value: EXPAND_OUTPUT_UNSPECIFIED = 0;
+     */
+    UNSPECIFIED = 0,
+    /**
+     * Under each seed hit, in `Hit.neighbors`.
+     *
+     * @generated from enum value: EXPAND_OUTPUT_NESTED = 1;
+     */
+    NESTED = 1,
+    /**
+     * Seeds and neighbors in one ranked list, each neighbor a hit with
+     * `Hit.graph`.
+     *
+     * @generated from enum value: EXPAND_OUTPUT_FLAT = 2;
+     */
+    FLAT = 2
+}
+/**
+ * Describes the enum loams.collection.v1.ExpandOutput.
+ */
+export declare const ExpandOutputSchema: GenEnum<ExpandOutput>;
+/**
+ * @generated from enum loams.collection.v1.TotalRelation
+ */
+export declare enum TotalRelation {
+    /**
+     * @generated from enum value: TOTAL_RELATION_UNSPECIFIED = 0;
+     */
+    UNSPECIFIED = 0,
+    /**
+     * `eq`: the count is exact.
+     *
+     * @generated from enum value: TOTAL_RELATION_EQ = 1;
+     */
+    EQ = 1,
+    /**
+     * `gte`: at least this many matched.
+     *
+     * @generated from enum value: TOTAL_RELATION_GTE = 2;
+     */
+    GTE = 2
+}
+/**
+ * Describes the enum loams.collection.v1.TotalRelation.
+ */
+export declare const TotalRelationSchema: GenEnum<TotalRelation>;
+/**
+ * @generated from service loams.collection.v1.QueryService
+ */
+export declare const QueryService: GenService<{
+    /**
+     * One search over one collection. The whole IR is this request: the
+     * retrievers to run, how to fuse them, the filter, the sort and the window.
+     *
+     * It is `NO_SIDE_EFFECTS` — it reads and counts — so an SDK may retry it
+     * after a lost answer. It is still a `POST`, because a search is not free and
+     * the request is a body.
+     *
+     * @generated from rpc loams.collection.v1.QueryService.Search
+     */
+    search: {
+        methodKind: "unary";
+        input: typeof SearchRequestSchema;
+        output: typeof SearchResponseSchema;
+    };
+}>;