hermes-client-python 1.7.14__tar.gz → 1.7.16__tar.gz

{hermes_client_python-1.7.14 → hermes_client_python-1.7.16}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hermes-client-python
-Version: 1.7.14
+Version: 1.7.16
 Summary: Async Python client for Hermes search server
 Project-URL: Homepage, https://github.com/SpaceFrontiers/hermes
 Project-URL: Repository, https://github.com/SpaceFrontiers/hermes

{hermes_client_python-1.7.14 → hermes_client_python-1.7.16}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "hermes-client-python"
-version = "1.7.14"
+version = "1.7.16"
 description = "Async Python client for Hermes search server"
 readme = "README.md"
 license = "MIT"

hermes_client_python-1.7.16/src/hermes_client_python/__init__.py

@@ -0,0 +1,45 @@
+"""Async Python client for Hermes search server."""
+
+from .client import HermesClient
+from .types import (
+    AllQuery,
+    BooleanQuery,
+    BoostQuery,
+    Combiner,
+    DenseVectorQuery,
+    DocAddress,
+    Document,
+    Filter,
+    IndexInfo,
+    MatchQuery,
+    Reranker,
+    SearchHit,
+    SearchResponse,
+    SearchTimings,
+    SparseVectorQuery,
+    TermQuery,
+    VectorFieldStats,
+)
+
+__all__ = [
+    "HermesClient",
+    "AllQuery",
+    "BooleanQuery",
+    "BoostQuery",
+    "Combiner",
+    "DenseVectorQuery",
+    "DocAddress",
+    "Document",
+    "Filter",
+    "IndexInfo",
+    "MatchQuery",
+    "Reranker",
+    "SearchHit",
+    "SearchResponse",
+    "SearchTimings",
+    "SparseVectorQuery",
+    "TermQuery",
+    "VectorFieldStats",
+]
+
+__version__ = "1.0.2"

{hermes_client_python-1.7.14 → hermes_client_python-1.7.16}/src/hermes_client_python/client.py

@@ -1,4 +1,8 @@
-"""Async Hermes client implementation."""
+"""Async Hermes client implementation.
+
+All search types mirror the proto API structure exactly.
+See types.py for Query, Reranker, Filter definitions.
+"""
 
 from __future__ import annotations
 
@@ -25,6 +29,8 @@ from .types import (
 class HermesClient:
     """Async client for Hermes search server.
 
+    All search types mirror the proto API structure exactly.
+
     Example:
         async with HermesClient("localhost:50051") as client:
             # Create index
@@ -43,9 +49,10 @@ class HermesClient:
             await client.commit("articles")
 
             # Search
-            results = await client.search("articles", term=("title", "hello"))
+            results = await client.search("articles",
+                query={"match": {"field": "title", "text": "hello"}})
             for hit in results.hits:
-                print(hit.doc_id, hit.score)
+                print(hit.address, hit.score)
     """
 
     def __init__(self, address: str = "localhost:50051"):
@@ -297,124 +304,95 @@ class HermesClient:
         self,
         index_name: str,
         *,
-        term: tuple[str, str] | None = None,
-        match: tuple[str, str] | None = None,
-        boolean: dict[str, list[tuple[str, str]]] | None = None,
-        sparse_vector: tuple[str, list[int], list[float]] | None = None,
-        sparse_text: tuple[str, str] | None = None,
-        dense_vector: tuple[str, list[float]] | None = None,
-        nprobe: int = 0,
-        rerank_factor: int = 0,
-        heap_factor: float = 1.0,
-        combiner: str = "sum",
+        query: dict[str, Any],
         limit: int = 10,
         offset: int = 0,
         fields_to_load: list[str] | None = None,
-        reranker: tuple[str, list[float], int] | None = None,
-        reranker_combiner: str = "weighted_top_k",
-        matryoshka_dims: int = 0,
+        reranker: dict[str, Any] | None = None,
         filters: list[dict[str, Any]] | None = None,
     ) -> SearchResponse:
         """Search for documents.
 
+        All parameters mirror the proto SearchRequest structure exactly.
+        ``query`` is a dict with exactly one key matching the proto Query oneof.
+
         Args:
             index_name: Name of the index
-            term: Term query as (field, term) tuple - exact single-term match
-            match: Match query as (field, text) tuple - tokenizes text server-side
-                and searches as OR of individual tokens (use for natural language)
-            boolean: Boolean query with "must", "should", "must_not" keys
-            sparse_vector: Sparse vector query as (field, indices, values) tuple
-            sparse_text: Sparse vector query with server-side tokenization as (field, text) tuple
-            dense_vector: Dense vector query as (field, vector) tuple
-            nprobe: Number of clusters to probe for dense vector (IVF indexes)
-            rerank_factor: Re-ranking factor for dense vector search
-            heap_factor: Approximate search factor for sparse vectors (1.0=exact, 0.8=faster)
-            combiner: Score combiner for multi-value fields: "sum", "max", or "avg"
+            query: Query dict with one key: "term", "match", "boolean",
+                "sparse_vector", "dense_vector", "boost", or "all".
             limit: Maximum number of results
             offset: Offset for pagination
             fields_to_load: List of fields to include in results
-            reranker: L2 reranker as (field, query_vector, l1_limit) tuple.
-                Reranks L1 candidates by exact dense vector distance.
-                l1_limit=0 defaults to 10x the final limit.
-            reranker_combiner: Score combiner for reranker multi-value fields:
-                "log_sum_exp" (default), "max", "avg", "sum"
-            matryoshka_dims: Matryoshka pre-filter dimensions for reranker.
-                When > 0, scores candidates on leading N dimensions first,
-                keeps top survivors, then does full-dimension exact scoring.
-                0 = disabled (default).
-            filters: Fast-field filters. Each dict has "field" and one condition key:
-                - {"field": "status", "eq_text": "active"}
-                - {"field": "price", "eq_u64": 100}
-                - {"field": "price", "range": {"min": 10.0, "max": 100.0}}
-                - {"field": "category", "in_text": ["books", "movies"]}
-                - {"field": "count", "in_u64": [1, 2, 3]}
+            reranker: Reranker dict matching proto Reranker message
+            filters: List of filter dicts matching proto Filter message
 
         Returns:
             SearchResponse with hits
 
         Examples:
             # Term query (exact single token)
-            results = await client.search("articles", term=("title", "hello"))
+            results = await client.search("articles",
+                query={"term": {"field": "title", "term": "hello"}})
 
             # Match query (full-text, tokenized server-side)
-            results = await client.search("articles", match=("title", "what is hemoglobin"))
+            results = await client.search("articles",
+                query={"match": {"field": "title", "text": "what is hemoglobin"}})
 
             # Boolean query
-            results = await client.search("articles", boolean={
-                "must": [("title", "hello")],
-                "should": [("body", "world")],
-            })
+            results = await client.search("articles",
+                query={"boolean": {
+                    "must": [{"match": {"field": "title", "text": "hello"}}],
+                    "should": [{"match": {"field": "body", "text": "world"}}],
+                }})
 
-            # Sparse vector query (pre-tokenized)
+            # Sparse text query (server-side tokenization) with pruning
             results = await client.search("docs",
-                sparse_vector=("embedding", [1, 5, 10], [0.5, 0.3, 0.2]),
-                fields_to_load=["title", "body"]
-            )
-
-            # Sparse text query (server-side tokenization)
+                query={"sparse_vector": {
+                    "field": "embedding",
+                    "text": "machine learning",
+                    "pruning": 0.5,
+                }},
+                fields_to_load=["title", "body"])
+
+            # Sparse vector query (pre-computed)
             results = await client.search("docs",
-                sparse_text=("embedding", "what is machine learning?"),
-                fields_to_load=["title", "body"]
-            )
+                query={"sparse_vector": {
+                    "field": "embedding",
+                    "indices": [1, 5, 10],
+                    "values": [0.5, 0.3, 0.2],
+                }})
 
-            # Dense vector query
+            # Dense vector query with reranker
             results = await client.search("docs",
-                dense_vector=("embedding", [0.1, 0.2, 0.3, ...]),
-                fields_to_load=["title"]
-            )
+                query={"dense_vector": {
+                    "field": "embedding",
+                    "vector": [0.1, 0.2, 0.3],
+                    "nprobe": 10,
+                }},
+                reranker={
+                    "field": "embedding",
+                    "vector": [0.1, 0.2, 0.3],
+                    "limit": 100,
+                },
+                fields_to_load=["title"])
+
+            # Filters
+            results = await client.search("docs",
+                query={"match": {"field": "title", "text": "hello"}},
+                filters=[
+                    {"field": "status", "eq_text": "active"},
+                    {"field": "price", "range": {"min": 10.0, "max": 100.0}},
+                ])
         """
         self._ensure_connected()
 
-        query = _build_query(
-            term=term,
-            match=match,
-            boolean=boolean,
-            sparse_vector=sparse_vector,
-            sparse_text=sparse_text,
-            dense_vector=dense_vector,
-            nprobe=nprobe,
-            rerank_factor=rerank_factor,
-            heap_factor=heap_factor,
-            combiner=combiner,
-        )
-
-        pb_reranker = None
-        if reranker is not None:
-            field_name, query_vector, l1_limit = reranker
-            reranker_combiner_value = _reranker_combiner_to_proto(reranker_combiner)
-            pb_reranker = pb.Reranker(
-                field=field_name,
-                vector=query_vector,
-                limit=l1_limit,
-                combiner=reranker_combiner_value,
-                matryoshka_dims=matryoshka_dims,
-            )
-
-        pb_filters = _build_filters(filters) if filters else []
+        pb_query = _build_query(query)
+        pb_reranker = _build_reranker(reranker) if reranker else None
+        pb_filters = [_build_filter(f) for f in filters] if filters else []
 
         request = pb.SearchRequest(
             index_name=index_name,
-            query=query,
+            query=pb_query,
             limit=limit,
             offset=offset,
             fields_to_load=fields_to_load or [],
@@ -625,129 +603,134 @@ def _from_field_value(fv: pb.FieldValue) -> Any:
     return None
 
 
-def _combiner_to_proto(combiner: str) -> int:
-    """Convert combiner string to proto enum value."""
-    return {"sum": 0, "max": 1, "avg": 2}.get(combiner.lower(), 0)
-
-
-def _reranker_combiner_to_proto(combiner: str) -> int:
-    """Convert reranker combiner string to proto MultiValueCombiner enum."""
-    return {
-        "log_sum_exp": 0,
-        "max": 1,
-        "avg": 2,
-        "sum": 3,
-        "weighted_top_k": 4,
-    }.get(combiner.lower(), 0)
-
-
-def _build_filters(filters: list[dict[str, Any]]) -> list[pb.Filter]:
-    """Convert filter dicts to protobuf Filter messages."""
-    result = []
-    for f in filters:
-        field = f["field"]
-        kwargs: dict[str, Any] = {"field": field}
-        if "eq_u64" in f:
-            kwargs["eq_u64"] = int(f["eq_u64"])
-        elif "eq_i64" in f:
-            kwargs["eq_i64"] = int(f["eq_i64"])
-        elif "eq_f64" in f:
-            kwargs["eq_f64"] = float(f["eq_f64"])
-        elif "eq_text" in f:
-            kwargs["eq_text"] = str(f["eq_text"])
-        elif "range" in f:
-            r = f["range"]
-            range_kwargs = {}
-            if "min" in r:
-                range_kwargs["min"] = float(r["min"])
-            if "max" in r:
-                range_kwargs["max"] = float(r["max"])
-            kwargs["range"] = pb.RangeFilter(**range_kwargs)
-        elif "in_text" in f:
-            kwargs["in_values"] = pb.InFilter(text_values=list(f["in_text"]))
-        elif "in_u64" in f:
-            kwargs["in_values"] = pb.InFilter(u64_values=[int(v) for v in f["in_u64"]])
-        elif "in_i64" in f:
-            kwargs["in_values"] = pb.InFilter(i64_values=[int(v) for v in f["in_i64"]])
-        result.append(pb.Filter(**kwargs))
-    return result
-
-
-def _build_query(
-    *,
-    term: tuple[str, str] | None = None,
-    match: tuple[str, str] | None = None,
-    boolean: dict[str, list[tuple[str, str]]] | None = None,
-    sparse_vector: tuple[str, list[int], list[float]] | None = None,
-    sparse_text: tuple[str, str] | None = None,
-    dense_vector: tuple[str, list[float]] | None = None,
-    nprobe: int = 0,
-    rerank_factor: int = 0,
-    heap_factor: float = 1.0,
-    combiner: str = "sum",
-) -> pb.Query:
-    """Build a protobuf Query from parameters."""
-    if term is not None:
-        field, value = term
-        return pb.Query(term=pb.TermQuery(field=field, term=value))
-
-    if match is not None:
-        field, text = match
-        return pb.Query(match=pb.MatchQuery(field=field, text=text))
-
-    if boolean is not None:
-        must = [
-            pb.Query(match=pb.MatchQuery(field=f, text=t))
-            for f, t in boolean.get("must", [])
-        ]
-        should = [
-            pb.Query(match=pb.MatchQuery(field=f, text=t))
-            for f, t in boolean.get("should", [])
-        ]
-        must_not = [
-            pb.Query(match=pb.MatchQuery(field=f, text=t))
-            for f, t in boolean.get("must_not", [])
-        ]
-        return pb.Query(
-            boolean=pb.BooleanQuery(must=must, should=should, must_not=must_not)
-        )
+_COMBINER_MAP: dict[str, int] = {
+    "log_sum_exp": 0,
+    "max": 1,
+    "avg": 2,
+    "sum": 3,
+    "weighted_top_k": 4,
+}
+
+
+def _combiner_to_proto(combiner: str | None) -> int:
+    """Convert combiner string to proto MultiValueCombiner enum value."""
+    if combiner is None:
+        return 0  # LOG_SUM_EXP default
+    return _COMBINER_MAP.get(combiner.lower(), 0)
+
 
-    combiner_value = _combiner_to_proto(combiner)
+def _build_query(q: dict[str, Any]) -> pb.Query:
+    """Recursively convert a Query dict to protobuf Query.
 
-    if sparse_vector is not None:
-        field, indices, values = sparse_vector
+    The dict must have exactly one key matching the proto Query oneof:
+    "term", "match", "boolean", "sparse_vector", "dense_vector", "boost", "all".
+    """
+    if "term" in q:
+        t = q["term"]
+        return pb.Query(term=pb.TermQuery(field=t["field"], term=t["term"]))
+
+    if "match" in q:
+        m = q["match"]
+        return pb.Query(match=pb.MatchQuery(field=m["field"], text=m["text"]))
+
+    if "boolean" in q:
+        b = q["boolean"]
         return pb.Query(
-            sparse_vector=pb.SparseVectorQuery(
-                field=field,
-                indices=indices,
-                values=values,
-                combiner=combiner_value,
-                heap_factor=heap_factor,
+            boolean=pb.BooleanQuery(
+                must=[_build_query(sq) for sq in b.get("must", [])],
+                should=[_build_query(sq) for sq in b.get("should", [])],
+                must_not=[_build_query(sq) for sq in b.get("must_not", [])],
             )
         )
 
-    if sparse_text is not None:
-        field, text = sparse_text
+    if "sparse_vector" in q:
+        sv = q["sparse_vector"]
         return pb.Query(
             sparse_vector=pb.SparseVectorQuery(
-                field=field,
-                text=text,
-                combiner=combiner_value,
-                heap_factor=heap_factor,
+                field=sv["field"],
+                indices=sv.get("indices", []),
+                values=sv.get("values", []),
+                text=sv.get("text", ""),
+                combiner=_combiner_to_proto(sv.get("combiner")),
+                heap_factor=sv.get("heap_factor", 0),
+                combiner_temperature=sv.get("combiner_temperature", 0),
+                combiner_top_k=sv.get("combiner_top_k", 0),
+                combiner_decay=sv.get("combiner_decay", 0),
+                weight_threshold=sv.get("weight_threshold", 0),
+                max_query_dims=sv.get("max_query_dims", 0),
+                pruning=sv.get("pruning", 0),
             )
         )
 
-    if dense_vector is not None:
-        field, vector = dense_vector
+    if "dense_vector" in q:
+        dv = q["dense_vector"]
         return pb.Query(
             dense_vector=pb.DenseVectorQuery(
-                field=field,
-                vector=vector,
-                nprobe=nprobe,
-                rerank_factor=rerank_factor,
-                combiner=combiner_value,
+                field=dv["field"],
+                vector=dv["vector"],
+                nprobe=dv.get("nprobe", 0),
+                rerank_factor=dv.get("rerank_factor", 0),
+                combiner=_combiner_to_proto(dv.get("combiner")),
+                combiner_temperature=dv.get("combiner_temperature", 0),
+                combiner_top_k=dv.get("combiner_top_k", 0),
+                combiner_decay=dv.get("combiner_decay", 0),
             )
         )
 
-    # Default: match all (empty boolean query)
+    if "boost" in q:
+        bq = q["boost"]
+        return pb.Query(
+            boost=pb.BoostQuery(
+                query=_build_query(bq["query"]),
+                boost=bq["boost"],
+            )
+        )
+
+    if "all" in q:
+        return pb.Query(all=pb.AllQuery())
+
+    # Default: match all
     return pb.Query(boolean=pb.BooleanQuery())
+
+
+def _build_reranker(r: dict[str, Any]) -> pb.Reranker:
+    """Convert a Reranker dict to protobuf Reranker."""
+    return pb.Reranker(
+        field=r["field"],
+        vector=r["vector"],
+        limit=r.get("limit", 0),
+        combiner=_combiner_to_proto(r.get("combiner")),
+        combiner_temperature=r.get("combiner_temperature", 0),
+        combiner_top_k=r.get("combiner_top_k", 0),
+        combiner_decay=r.get("combiner_decay", 0),
+        matryoshka_dims=r.get("matryoshka_dims", 0),
+    )
+
+
+def _build_filter(f: dict[str, Any]) -> pb.Filter:
+    """Convert a Filter dict to protobuf Filter."""
+    kwargs: dict[str, Any] = {"field": f["field"]}
+    if "eq_u64" in f:
+        kwargs["eq_u64"] = int(f["eq_u64"])
+    elif "eq_i64" in f:
+        kwargs["eq_i64"] = int(f["eq_i64"])
+    elif "eq_f64" in f:
+        kwargs["eq_f64"] = float(f["eq_f64"])
+    elif "eq_text" in f:
+        kwargs["eq_text"] = str(f["eq_text"])
+    elif "range" in f:
+        r = f["range"]
+        range_kwargs = {}
+        if "min" in r:
+            range_kwargs["min"] = float(r["min"])
+        if "max" in r:
+            range_kwargs["max"] = float(r["max"])
+        kwargs["range"] = pb.RangeFilter(**range_kwargs)
+    elif "in_values" in f:
+        iv = f["in_values"]
+        kwargs["in_values"] = pb.InFilter(
+            text_values=iv.get("text_values", []),
+            u64_values=[int(v) for v in iv.get("u64_values", [])],
+            i64_values=[int(v) for v in iv.get("i64_values", [])],
+        )
+    return pb.Filter(**kwargs)

hermes_client_python-1.7.16/src/hermes_client_python/hermes_pb2.py

@@ -0,0 +1,142 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# NO CHECKED-IN PROTOBUF GENCODE
+# source: hermes.proto
+# Protobuf Python Version: 6.31.1
+"""Generated protocol buffer code."""
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import descriptor_pool as _descriptor_pool
+from google.protobuf import runtime_version as _runtime_version
+from google.protobuf import symbol_database as _symbol_database
+from google.protobuf.internal import builder as _builder
+_runtime_version.ValidateProtobufRuntimeVersion(
+    _runtime_version.Domain.PUBLIC,
+    6,
+    31,
+    1,
+    '',
+    'hermes.proto'
+)
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+
+
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n\x0chermes.proto\x12\x06hermes\"\xad\x02\n\x05Query\x12!\n\x04term\x18\x01 \x01(\x0b\x32\x11.hermes.TermQueryH\x00\x12\'\n\x07\x62oolean\x18\x02 \x01(\x0b\x32\x14.hermes.BooleanQueryH\x00\x12#\n\x05\x62oost\x18\x03 \x01(\x0b\x32\x12.hermes.BoostQueryH\x00\x12\x1f\n\x03\x61ll\x18\x04 \x01(\x0b\x32\x10.hermes.AllQueryH\x00\x12\x32\n\rsparse_vector\x18\x05 \x01(\x0b\x32\x19.hermes.SparseVectorQueryH\x00\x12\x30\n\x0c\x64\x65nse_vector\x18\x06 \x01(\x0b\x32\x18.hermes.DenseVectorQueryH\x00\x12#\n\x05match\x18\x07 \x01(\x0b\x32\x12.hermes.MatchQueryH\x00\x42\x07\n\x05query\"\xa5\x02\n\x11SparseVectorQuery\x12\r\n\x05\x66ield\x18\x01 \x01(\t\x12\x0f\n\x07indices\x18\x02 \x03(\r\x12\x0e\n\x06values\x18\x03 \x03(\x02\x12\x0c\n\x04text\x18\x04 \x01(\t\x12,\n\x08\x63ombiner\x18\x05 \x01(\x0e\x32\x1a.hermes.MultiValueCombiner\x12\x13\n\x0bheap_factor\x18\x06 \x01(\x02\x12\x1c\n\x14\x63ombiner_temperature\x18\x07 \x01(\x02\x12\x16\n\x0e\x63ombiner_top_k\x18\x08 \x01(\r\x12\x16\n\x0e\x63ombiner_decay\x18\t \x01(\x02\x12\x18\n\x10weight_threshold\x18\n \x01(\x02\x12\x16\n\x0emax_query_dims\x18\x0b \x01(\r\x12\x0f\n\x07pruning\x18\x0c \x01(\x02\"\xd4\x01\n\x10\x44\x65nseVectorQuery\x12\r\n\x05\x66ield\x18\x01 \x01(\t\x12\x0e\n\x06vector\x18\x02 \x03(\x02\x12\x0e\n\x06nprobe\x18\x03 \x01(\r\x12\x15\n\rrerank_factor\x18\x04 \x01(\x02\x12,\n\x08\x63ombiner\x18\x05 \x01(\x0e\x32\x1a.hermes.MultiValueCombiner\x12\x1c\n\x14\x63ombiner_temperature\x18\x06 \x01(\x02\x12\x16\n\x0e\x63ombiner_top_k\x18\x07 \x01(\r\x12\x16\n\x0e\x63ombiner_decay\x18\x08 \x01(\x02\"(\n\tTermQuery\x12\r\n\x05\x66ield\x18\x01 \x01(\t\x12\x0c\n\x04term\x18\x02 \x01(\t\"k\n\x0c\x42ooleanQuery\x12\x1b\n\x04must\x18\x01 \x03(\x0b\x32\r.hermes.Query\x12\x1d\n\x06should\x18\x02 \x03(\x0b\x32\r.hermes.Query\x12\x1f\n\x08must_not\x18\x03 \x03(\x0b\x32\r.hermes.Query\"9\n\nBoostQuery\x12\x1c\n\x05query\x18\x01 \x01(\x0b\x32\r.hermes.Query\x12\r\n\x05\x62oost\x18\x02 \x01(\x02\"\n\n\x08\x41llQuery\")\n\nMatchQuery\x12\r\n\x05\x66ield\x18\x01 \x01(\t\x12\x0c\n\x04text\x18\x02 \x01(\t\"\xcd\x01\n\x08Reranker\x12\r\n\x05\x66ield\x18\x01 \x01(\t\x12\x0e\n\x06vector\x18\x02 \x03(\x02\x12\r\n\x05limit\x18\x03 \x01(\r\x12,\n\x08\x63ombiner\x18\x04 \x01(\x0e\x32\x1a.hermes.MultiValueCombiner\x12\x1c\n\x14\x63ombiner_temperature\x18\x05 \x01(\x02\x12\x16\n\x0e\x63ombiner_top_k\x18\x06 \x01(\r\x12\x16\n\x0e\x63ombiner_decay\x18\x07 \x01(\x02\x12\x17\n\x0fmatryoshka_dims\x18\x08 \x01(\r\"\xba\x01\n\x06\x46ilter\x12\r\n\x05\x66ield\x18\x01 \x01(\t\x12\x10\n\x06\x65q_u64\x18\x02 \x01(\x04H\x00\x12\x10\n\x06\x65q_i64\x18\x03 \x01(\x03H\x00\x12\x10\n\x06\x65q_f64\x18\x04 \x01(\x01H\x00\x12\x11\n\x07\x65q_text\x18\x05 \x01(\tH\x00\x12$\n\x05range\x18\x06 \x01(\x0b\x32\x13.hermes.RangeFilterH\x00\x12%\n\tin_values\x18\x07 \x01(\x0b\x32\x10.hermes.InFilterH\x00\x42\x0b\n\tcondition\"A\n\x0bRangeFilter\x12\x10\n\x03min\x18\x01 \x01(\x01H\x00\x88\x01\x01\x12\x10\n\x03max\x18\x02 \x01(\x01H\x01\x88\x01\x01\x42\x06\n\x04_minB\x06\n\x04_max\"G\n\x08InFilter\x12\x13\n\x0btext_values\x18\x01 \x03(\t\x12\x12\n\nu64_values\x18\x02 \x03(\x04\x12\x12\n\ni64_values\x18\x03 \x03(\x03\"\xbd\x01\n\rSearchRequest\x12\x12\n\nindex_name\x18\x01 \x01(\t\x12\x1c\n\x05query\x18\x02 \x01(\x0b\x32\r.hermes.Query\x12\r\n\x05limit\x18\x03 \x01(\r\x12\x0e\n\x06offset\x18\x04 \x01(\r\x12\x16\n\x0e\x66ields_to_load\x18\x05 \x03(\t\x12\"\n\x08reranker\x18\x06 \x01(\x0b\x32\x10.hermes.Reranker\x12\x1f\n\x07\x66ilters\x18\x07 \x03(\x0b\x32\x0e.hermes.Filter\"0\n\nDocAddress\x12\x12\n\nsegment_id\x18\x01 \x01(\t\x12\x0e\n\x06\x64oc_id\x18\x02 \x01(\r\"\xdf\x01\n\tSearchHit\x12#\n\x07\x61\x64\x64ress\x18\x01 \x01(\x0b\x32\x12.hermes.DocAddress\x12\r\n\x05score\x18\x02 \x01(\x02\x12-\n\x06\x66ields\x18\x03 \x03(\x0b\x32\x1d.hermes.SearchHit.FieldsEntry\x12,\n\x0eordinal_scores\x18\x04 \x03(\x0b\x32\x14.hermes.OrdinalScore\x1a\x41\n\x0b\x46ieldsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12!\n\x05value\x18\x02 \x01(\x0b\x32\x12.hermes.FieldValue:\x02\x38\x01\".\n\x0cOrdinalScore\x12\x0f\n\x07ordinal\x18\x01 \x01(\r\x12\r\n\x05score\x18\x02 \x01(\x02\"\xdb\x01\n\nFieldValue\x12\x0e\n\x04text\x18\x01 \x01(\tH\x00\x12\r\n\x03u64\x18\x02 \x01(\x04H\x00\x12\r\n\x03i64\x18\x03 \x01(\x03H\x00\x12\r\n\x03\x66\x36\x34\x18\x04 \x01(\x01H\x00\x12\x15\n\x0b\x62ytes_value\x18\x05 \x01(\x0cH\x00\x12-\n\rsparse_vector\x18\x06 \x01(\x0b\x32\x14.hermes.SparseVectorH\x00\x12+\n\x0c\x64\x65nse_vector\x18\x07 \x01(\x0b\x32\x13.hermes.DenseVectorH\x00\x12\x14\n\njson_value\x18\x08 \x01(\tH\x00\x42\x07\n\x05value\"/\n\x0cSparseVector\x12\x0f\n\x07indices\x18\x01 \x03(\r\x12\x0e\n\x06values\x18\x02 \x03(\x02\"\x1d\n\x0b\x44\x65nseVector\x12\x0e\n\x06values\x18\x01 \x03(\x02\"~\n\x0eSearchResponse\x12\x1f\n\x04hits\x18\x01 \x03(\x0b\x32\x11.hermes.SearchHit\x12\x12\n\ntotal_hits\x18\x02 \x01(\r\x12\x0f\n\x07took_ms\x18\x03 \x01(\x04\x12&\n\x07timings\x18\x04 \x01(\x0b\x32\x15.hermes.SearchTimings\"X\n\rSearchTimings\x12\x11\n\tsearch_us\x18\x01 \x01(\x04\x12\x11\n\trerank_us\x18\x02 \x01(\x04\x12\x0f\n\x07load_us\x18\x03 \x01(\x04\x12\x10\n\x08total_us\x18\x04 \x01(\x04\"M\n\x12GetDocumentRequest\x12\x12\n\nindex_name\x18\x01 \x01(\t\x12#\n\x07\x61\x64\x64ress\x18\x02 \x01(\x0b\x32\x12.hermes.DocAddress\"\x91\x01\n\x13GetDocumentResponse\x12\x37\n\x06\x66ields\x18\x01 \x03(\x0b\x32\'.hermes.GetDocumentResponse.FieldsEntry\x1a\x41\n\x0b\x46ieldsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12!\n\x05value\x18\x02 \x01(\x0b\x32\x12.hermes.FieldValue:\x02\x38\x01\")\n\x13GetIndexInfoRequest\x12\x12\n\nindex_name\x18\x01 \x01(\t\"\xbd\x01\n\x14GetIndexInfoResponse\x12\x12\n\nindex_name\x18\x01 \x01(\t\x12\x10\n\x08num_docs\x18\x02 \x01(\r\x12\x14\n\x0cnum_segments\x18\x03 \x01(\r\x12\x0e\n\x06schema\x18\x04 \x01(\t\x12)\n\x0cmemory_stats\x18\x05 \x01(\x0b\x32\x13.hermes.MemoryStats\x12.\n\x0cvector_stats\x18\x06 \x03(\x0b\x32\x18.hermes.VectorFieldStats\"e\n\x10VectorFieldStats\x12\x12\n\nfield_name\x18\x01 \x01(\t\x12\x13\n\x0bvector_type\x18\x02 \x01(\t\x12\x15\n\rtotal_vectors\x18\x03 \x01(\x04\x12\x11\n\tdimension\x18\x04 \x01(\r\"\x8c\x01\n\x0bMemoryStats\x12\x13\n\x0btotal_bytes\x18\x01 \x01(\x04\x12\x34\n\x0findexing_buffer\x18\x02 \x01(\x0b\x32\x1b.hermes.IndexingBufferStats\x12\x32\n\x0esegment_reader\x18\x03 \x01(\x0b\x32\x1a.hermes.SegmentReaderStats\"\xdf\x01\n\x13IndexingBufferStats\x12\x13\n\x0btotal_bytes\x18\x01 \x01(\x04\x12\x16\n\x0epostings_bytes\x18\x02 \x01(\x04\x12\x1c\n\x14sparse_vectors_bytes\x18\x03 \x01(\x04\x12\x1b\n\x13\x64\x65nse_vectors_bytes\x18\x04 \x01(\x04\x12\x16\n\x0einterner_bytes\x18\x05 \x01(\x04\x12\x1c\n\x14position_index_bytes\x18\x06 \x01(\x04\x12\x14\n\x0cpending_docs\x18\x07 \x01(\r\x12\x14\n\x0cunique_terms\x18\x08 \x01(\r\"\xb7\x01\n\x12SegmentReaderStats\x12\x13\n\x0btotal_bytes\x18\x01 \x01(\x04\x12\x1d\n\x15term_dict_cache_bytes\x18\x02 \x01(\x04\x12\x19\n\x11store_cache_bytes\x18\x03 \x01(\x04\x12\x1a\n\x12sparse_index_bytes\x18\x04 \x01(\x04\x12\x19\n\x11\x64\x65nse_index_bytes\x18\x05 \x01(\x04\x12\x1b\n\x13num_segments_loaded\x18\x06 \x01(\r\"8\n\x12\x43reateIndexRequest\x12\x12\n\nindex_name\x18\x01 \x01(\t\x12\x0e\n\x06schema\x18\x02 \x01(\t\"&\n\x13\x43reateIndexResponse\x12\x0f\n\x07success\x18\x01 \x01(\x08\"=\n\nFieldEntry\x12\x0c\n\x04name\x18\x01 \x01(\t\x12!\n\x05value\x18\x02 \x01(\x0b\x32\x12.hermes.FieldValue\"3\n\rNamedDocument\x12\"\n\x06\x66ields\x18\x01 \x03(\x0b\x32\x12.hermes.FieldEntry\"Z\n\x1a\x42\x61tchIndexDocumentsRequest\x12\x12\n\nindex_name\x18\x01 \x01(\t\x12(\n\tdocuments\x18\x02 \x03(\x0b\x32\x15.hermes.NamedDocument\"I\n\x1b\x42\x61tchIndexDocumentsResponse\x12\x15\n\rindexed_count\x18\x01 \x01(\r\x12\x13\n\x0b\x65rror_count\x18\x02 \x01(\r\"N\n\x14IndexDocumentRequest\x12\x12\n\nindex_name\x18\x01 \x01(\t\x12\"\n\x06\x66ields\x18\x02 \x03(\x0b\x32\x12.hermes.FieldEntry\"/\n\x16IndexDocumentsResponse\x12\x15\n\rindexed_count\x18\x01 \x01(\r\"#\n\rCommitRequest\x12\x12\n\nindex_name\x18\x01 \x01(\t\"3\n\x0e\x43ommitResponse\x12\x0f\n\x07success\x18\x01 \x01(\x08\x12\x10\n\x08num_docs\x18\x02 \x01(\r\"\'\n\x11\x46orceMergeRequest\x12\x12\n\nindex_name\x18\x01 \x01(\t\";\n\x12\x46orceMergeResponse\x12\x0f\n\x07success\x18\x01 \x01(\x08\x12\x14\n\x0cnum_segments\x18\x02 \x01(\r\"(\n\x12\x44\x65leteIndexRequest\x12\x12\n\nindex_name\x18\x01 \x01(\t\"&\n\x13\x44\x65leteIndexResponse\x12\x0f\n\x07success\x18\x01 \x01(\x08\"\x14\n\x12ListIndexesRequest\"*\n\x13ListIndexesResponse\x12\x13\n\x0bindex_names\x18\x01 \x03(\t\"/\n\x19RetrainVectorIndexRequest\x12\x12\n\nindex_name\x18\x01 \x01(\t\"-\n\x1aRetrainVectorIndexResponse\x12\x0f\n\x07success\x18\x01 \x01(\x08*\x81\x01\n\x12MultiValueCombiner\x12\x18\n\x14\x43OMBINER_LOG_SUM_EXP\x10\x00\x12\x10\n\x0c\x43OMBINER_MAX\x10\x01\x12\x10\n\x0c\x43OMBINER_AVG\x10\x02\x12\x10\n\x0c\x43OMBINER_SUM\x10\x03\x12\x1b\n\x17\x43OMBINER_WEIGHTED_TOP_K\x10\x04\x32\xdb\x01\n\rSearchService\x12\x37\n\x06Search\x12\x15.hermes.SearchRequest\x1a\x16.hermes.SearchResponse\x12\x46\n\x0bGetDocument\x12\x1a.hermes.GetDocumentRequest\x1a\x1b.hermes.GetDocumentResponse\x12I\n\x0cGetIndexInfo\x12\x1b.hermes.GetIndexInfoRequest\x1a\x1c.hermes.GetIndexInfoResponse2\xf3\x04\n\x0cIndexService\x12\x46\n\x0b\x43reateIndex\x12\x1a.hermes.CreateIndexRequest\x1a\x1b.hermes.CreateIndexResponse\x12P\n\x0eIndexDocuments\x12\x1c.hermes.IndexDocumentRequest\x1a\x1e.hermes.IndexDocumentsResponse(\x01\x12^\n\x13\x42\x61tchIndexDocuments\x12\".hermes.BatchIndexDocumentsRequest\x1a#.hermes.BatchIndexDocumentsResponse\x12\x37\n\x06\x43ommit\x12\x15.hermes.CommitRequest\x1a\x16.hermes.CommitResponse\x12\x43\n\nForceMerge\x12\x19.hermes.ForceMergeRequest\x1a\x1a.hermes.ForceMergeResponse\x12\x46\n\x0b\x44\x65leteIndex\x12\x1a.hermes.DeleteIndexRequest\x1a\x1b.hermes.DeleteIndexResponse\x12\x46\n\x0bListIndexes\x12\x1a.hermes.ListIndexesRequest\x1a\x1b.hermes.ListIndexesResponse\x12[\n\x12RetrainVectorIndex\x12!.hermes.RetrainVectorIndexRequest\x1a\".hermes.RetrainVectorIndexResponseb\x06proto3')
+
+_globals = globals()
+_builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
+_builder.BuildTopDescriptorsAndMessages(DESCRIPTOR, 'hermes_pb2', _globals)
+if not _descriptor._USE_C_DESCRIPTORS:
+  DESCRIPTOR._loaded_options = None
+  _globals['_SEARCHHIT_FIELDSENTRY']._loaded_options = None
+  _globals['_SEARCHHIT_FIELDSENTRY']._serialized_options = b'8\001'
+  _globals['_GETDOCUMENTRESPONSE_FIELDSENTRY']._loaded_options = None
+  _globals['_GETDOCUMENTRESPONSE_FIELDSENTRY']._serialized_options = b'8\001'
+  _globals['_MULTIVALUECOMBINER']._serialized_start=4744
+  _globals['_MULTIVALUECOMBINER']._serialized_end=4873
+  _globals['_QUERY']._serialized_start=25
+  _globals['_QUERY']._serialized_end=326
+  _globals['_SPARSEVECTORQUERY']._serialized_start=329
+  _globals['_SPARSEVECTORQUERY']._serialized_end=622
+  _globals['_DENSEVECTORQUERY']._serialized_start=625
+  _globals['_DENSEVECTORQUERY']._serialized_end=837
+  _globals['_TERMQUERY']._serialized_start=839
+  _globals['_TERMQUERY']._serialized_end=879
+  _globals['_BOOLEANQUERY']._serialized_start=881
+  _globals['_BOOLEANQUERY']._serialized_end=988
+  _globals['_BOOSTQUERY']._serialized_start=990
+  _globals['_BOOSTQUERY']._serialized_end=1047
+  _globals['_ALLQUERY']._serialized_start=1049
+  _globals['_ALLQUERY']._serialized_end=1059
+  _globals['_MATCHQUERY']._serialized_start=1061
+  _globals['_MATCHQUERY']._serialized_end=1102
+  _globals['_RERANKER']._serialized_start=1105
+  _globals['_RERANKER']._serialized_end=1310
+  _globals['_FILTER']._serialized_start=1313
+  _globals['_FILTER']._serialized_end=1499
+  _globals['_RANGEFILTER']._serialized_start=1501
+  _globals['_RANGEFILTER']._serialized_end=1566
+  _globals['_INFILTER']._serialized_start=1568
+  _globals['_INFILTER']._serialized_end=1639
+  _globals['_SEARCHREQUEST']._serialized_start=1642
+  _globals['_SEARCHREQUEST']._serialized_end=1831
+  _globals['_DOCADDRESS']._serialized_start=1833
+  _globals['_DOCADDRESS']._serialized_end=1881
+  _globals['_SEARCHHIT']._serialized_start=1884
+  _globals['_SEARCHHIT']._serialized_end=2107
+  _globals['_SEARCHHIT_FIELDSENTRY']._serialized_start=2042
+  _globals['_SEARCHHIT_FIELDSENTRY']._serialized_end=2107
+  _globals['_ORDINALSCORE']._serialized_start=2109
+  _globals['_ORDINALSCORE']._serialized_end=2155
+  _globals['_FIELDVALUE']._serialized_start=2158
+  _globals['_FIELDVALUE']._serialized_end=2377
+  _globals['_SPARSEVECTOR']._serialized_start=2379
+  _globals['_SPARSEVECTOR']._serialized_end=2426
+  _globals['_DENSEVECTOR']._serialized_start=2428
+  _globals['_DENSEVECTOR']._serialized_end=2457
+  _globals['_SEARCHRESPONSE']._serialized_start=2459
+  _globals['_SEARCHRESPONSE']._serialized_end=2585
+  _globals['_SEARCHTIMINGS']._serialized_start=2587
+  _globals['_SEARCHTIMINGS']._serialized_end=2675
+  _globals['_GETDOCUMENTREQUEST']._serialized_start=2677
+  _globals['_GETDOCUMENTREQUEST']._serialized_end=2754
+  _globals['_GETDOCUMENTRESPONSE']._serialized_start=2757
+  _globals['_GETDOCUMENTRESPONSE']._serialized_end=2902
+  _globals['_GETDOCUMENTRESPONSE_FIELDSENTRY']._serialized_start=2042
+  _globals['_GETDOCUMENTRESPONSE_FIELDSENTRY']._serialized_end=2107
+  _globals['_GETINDEXINFOREQUEST']._serialized_start=2904
+  _globals['_GETINDEXINFOREQUEST']._serialized_end=2945
+  _globals['_GETINDEXINFORESPONSE']._serialized_start=2948
+  _globals['_GETINDEXINFORESPONSE']._serialized_end=3137
+  _globals['_VECTORFIELDSTATS']._serialized_start=3139
+  _globals['_VECTORFIELDSTATS']._serialized_end=3240
+  _globals['_MEMORYSTATS']._serialized_start=3243
+  _globals['_MEMORYSTATS']._serialized_end=3383
+  _globals['_INDEXINGBUFFERSTATS']._serialized_start=3386
+  _globals['_INDEXINGBUFFERSTATS']._serialized_end=3609
+  _globals['_SEGMENTREADERSTATS']._serialized_start=3612
+  _globals['_SEGMENTREADERSTATS']._serialized_end=3795
+  _globals['_CREATEINDEXREQUEST']._serialized_start=3797
+  _globals['_CREATEINDEXREQUEST']._serialized_end=3853
+  _globals['_CREATEINDEXRESPONSE']._serialized_start=3855
+  _globals['_CREATEINDEXRESPONSE']._serialized_end=3893
+  _globals['_FIELDENTRY']._serialized_start=3895
+  _globals['_FIELDENTRY']._serialized_end=3956
+  _globals['_NAMEDDOCUMENT']._serialized_start=3958
+  _globals['_NAMEDDOCUMENT']._serialized_end=4009
+  _globals['_BATCHINDEXDOCUMENTSREQUEST']._serialized_start=4011
+  _globals['_BATCHINDEXDOCUMENTSREQUEST']._serialized_end=4101
+  _globals['_BATCHINDEXDOCUMENTSRESPONSE']._serialized_start=4103
+  _globals['_BATCHINDEXDOCUMENTSRESPONSE']._serialized_end=4176
+  _globals['_INDEXDOCUMENTREQUEST']._serialized_start=4178
+  _globals['_INDEXDOCUMENTREQUEST']._serialized_end=4256
+  _globals['_INDEXDOCUMENTSRESPONSE']._serialized_start=4258
+  _globals['_INDEXDOCUMENTSRESPONSE']._serialized_end=4305
+  _globals['_COMMITREQUEST']._serialized_start=4307
+  _globals['_COMMITREQUEST']._serialized_end=4342
+  _globals['_COMMITRESPONSE']._serialized_start=4344
+  _globals['_COMMITRESPONSE']._serialized_end=4395
+  _globals['_FORCEMERGEREQUEST']._serialized_start=4397
+  _globals['_FORCEMERGEREQUEST']._serialized_end=4436
+  _globals['_FORCEMERGERESPONSE']._serialized_start=4438
+  _globals['_FORCEMERGERESPONSE']._serialized_end=4497
+  _globals['_DELETEINDEXREQUEST']._serialized_start=4499
+  _globals['_DELETEINDEXREQUEST']._serialized_end=4539
+  _globals['_DELETEINDEXRESPONSE']._serialized_start=4541
+  _globals['_DELETEINDEXRESPONSE']._serialized_end=4579
+  _globals['_LISTINDEXESREQUEST']._serialized_start=4581
+  _globals['_LISTINDEXESREQUEST']._serialized_end=4601
+  _globals['_LISTINDEXESRESPONSE']._serialized_start=4603
+  _globals['_LISTINDEXESRESPONSE']._serialized_end=4645
+  _globals['_RETRAINVECTORINDEXREQUEST']._serialized_start=4647
+  _globals['_RETRAINVECTORINDEXREQUEST']._serialized_end=4694
+  _globals['_RETRAINVECTORINDEXRESPONSE']._serialized_start=4696
+  _globals['_RETRAINVECTORINDEXRESPONSE']._serialized_end=4741
+  _globals['_SEARCHSERVICE']._serialized_start=4876
+  _globals['_SEARCHSERVICE']._serialized_end=5095
+  _globals['_INDEXSERVICE']._serialized_start=5098
+  _globals['_INDEXSERVICE']._serialized_end=5725
+# @@protoc_insertion_point(module_scope)

hermes_client_python-1.7.16/src/hermes_client_python/types.py

@@ -0,0 +1,185 @@
+"""Type definitions for Hermes client.
+
+All search-related types mirror the proto API structure exactly.
+Query is a dict with exactly one key matching the proto Query oneof variant.
+"""
+
+from dataclasses import dataclass, field
+from typing import Any, Literal, TypedDict
+
+# =============================================================================
+# Multi-value score combiner (mirrors proto MultiValueCombiner)
+# =============================================================================
+
+Combiner = Literal["log_sum_exp", "max", "avg", "sum", "weighted_top_k"]
+
+# =============================================================================
+# Query types (mirrors proto Query oneof)
+# =============================================================================
+
+
+class TermQuery(TypedDict):
+    field: str
+    term: str
+
+
+class MatchQuery(TypedDict):
+    field: str
+    text: str
+
+
+class BooleanQuery(TypedDict, total=False):
+    must: list["Query"]
+    should: list["Query"]
+    must_not: list["Query"]
+
+
+class BoostQuery(TypedDict):
+    query: "Query"
+    boost: float
+
+
+class AllQuery(TypedDict):
+    pass
+
+
+class SparseVectorQuery(TypedDict, total=False):
+    field: str  # required but total=False for optional fields
+    indices: list[int]
+    values: list[float]
+    text: str
+    combiner: Combiner
+    heap_factor: float
+    combiner_temperature: float
+    combiner_top_k: int
+    combiner_decay: float
+    weight_threshold: float
+    max_query_dims: int
+    pruning: float
+
+
+class DenseVectorQuery(TypedDict, total=False):
+    field: str  # required but total=False for optional fields
+    vector: list[float]
+    nprobe: int
+    rerank_factor: float
+    combiner: Combiner
+    combiner_temperature: float
+    combiner_top_k: int
+    combiner_decay: float
+
+
+# Query is a dict with exactly one key: "term", "match", "boolean",
+# "sparse_vector", "dense_vector", "boost", or "all".
+Query = dict[str, Any]
+
+# =============================================================================
+# Reranker (mirrors proto Reranker)
+# =============================================================================
+
+
+class Reranker(TypedDict, total=False):
+    field: str
+    vector: list[float]
+    limit: int
+    combiner: Combiner
+    combiner_temperature: float
+    combiner_top_k: int
+    combiner_decay: float
+    matryoshka_dims: int
+
+
+# =============================================================================
+# Filter (mirrors proto Filter)
+# =============================================================================
+
+
+class Filter(TypedDict, total=False):
+    field: str
+    eq_u64: int
+    eq_i64: int
+    eq_f64: float
+    eq_text: str
+    range: dict[str, float]  # {"min": ..., "max": ...}
+    in_values: dict[
+        str, list
+    ]  # {"text_values": [...], "u64_values": [...], "i64_values": [...]}
+
+
+# =============================================================================
+# Response types
+# =============================================================================
+
+
+@dataclass
+class Document:
+    """A document with field values."""
+
+    fields: dict[str, Any] = field(default_factory=dict)
+
+    def __getitem__(self, key: str) -> Any:
+        return self.fields[key]
+
+    def __setitem__(self, key: str, value: Any) -> None:
+        self.fields[key] = value
+
+    def get(self, key: str, default: Any = None) -> Any:
+        return self.fields.get(key, default)
+
+
+@dataclass
+class DocAddress:
+    """Unique document address: segment + local doc_id."""
+
+    segment_id: str
+    doc_id: int
+
+
+@dataclass
+class SearchHit:
+    """A single search result."""
+
+    address: DocAddress
+    score: float
+    fields: dict[str, Any] = field(default_factory=dict)
+
+
+@dataclass
+class SearchTimings:
+    """Detailed timing breakdown for search phases (all values in microseconds)."""
+
+    search_us: int
+    rerank_us: int
+    load_us: int
+    total_us: int
+
+
+@dataclass
+class SearchResponse:
+    """Search response with hits and metadata."""
+
+    hits: list[SearchHit]
+    total_hits: int
+    took_ms: int
+    timings: SearchTimings | None = None
+
+
+@dataclass
+class VectorFieldStats:
+    """Per-field vector statistics."""
+
+    field_name: str
+    vector_type: str  # "dense" or "sparse"
+    total_vectors: int
+    dimension: int
+
+
+@dataclass
+class IndexInfo:
+    """Information about an index."""
+
+    index_name: str
+    num_docs: int
+    num_segments: int
+    schema: str
+    vector_stats: list[VectorFieldStats] = field(default_factory=list)

hermes_client_python-1.7.14/src/hermes_client_python/__init__.py

@@ -1,23 +0,0 @@
-"""Async Python client for Hermes search server."""
-
-from .client import HermesClient
-from .types import (
-    DocAddress,
-    Document,
-    IndexInfo,
-    SearchHit,
-    SearchResponse,
-    VectorFieldStats,
-)
-
-__all__ = [
-    "HermesClient",
-    "DocAddress",
-    "Document",
-    "SearchHit",
-    "SearchResponse",
-    "IndexInfo",
-    "VectorFieldStats",
-]
-
-__version__ = "1.0.2"

hermes_client_python-1.7.14/src/hermes_client_python/hermes_pb2.py

@@ -1,142 +0,0 @@
-# -*- coding: utf-8 -*-
-# Generated by the protocol buffer compiler.  DO NOT EDIT!
-# NO CHECKED-IN PROTOBUF GENCODE
-# source: hermes.proto
-# Protobuf Python Version: 6.31.1
-"""Generated protocol buffer code."""
-from google.protobuf import descriptor as _descriptor
-from google.protobuf import descriptor_pool as _descriptor_pool
-from google.protobuf import runtime_version as _runtime_version
-from google.protobuf import symbol_database as _symbol_database
-from google.protobuf.internal import builder as _builder
-_runtime_version.ValidateProtobufRuntimeVersion(
-    _runtime_version.Domain.PUBLIC,
-    6,
-    31,
-    1,
-    '',
-    'hermes.proto'
-)
-# @@protoc_insertion_point(imports)
-
-_sym_db = _symbol_database.Default()
-
-
-
-
-DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n\x0chermes.proto\x12\x06hermes\"\xad\x02\n\x05Query\x12!\n\x04term\x18\x01 \x01(\x0b\x32\x11.hermes.TermQueryH\x00\x12\'\n\x07\x62oolean\x18\x02 \x01(\x0b\x32\x14.hermes.BooleanQueryH\x00\x12#\n\x05\x62oost\x18\x03 \x01(\x0b\x32\x12.hermes.BoostQueryH\x00\x12\x1f\n\x03\x61ll\x18\x04 \x01(\x0b\x32\x10.hermes.AllQueryH\x00\x12\x32\n\rsparse_vector\x18\x05 \x01(\x0b\x32\x19.hermes.SparseVectorQueryH\x00\x12\x30\n\x0c\x64\x65nse_vector\x18\x06 \x01(\x0b\x32\x18.hermes.DenseVectorQueryH\x00\x12#\n\x05match\x18\x07 \x01(\x0b\x32\x12.hermes.MatchQueryH\x00\x42\x07\n\x05query\"\xa5\x02\n\x11SparseVectorQuery\x12\r\n\x05\x66ield\x18\x01 \x01(\t\x12\x0f\n\x07indices\x18\x02 \x03(\r\x12\x0e\n\x06values\x18\x03 \x03(\x02\x12\x0c\n\x04text\x18\x04 \x01(\t\x12,\n\x08\x63ombiner\x18\x05 \x01(\x0e\x32\x1a.hermes.MultiValueCombiner\x12\x13\n\x0bheap_factor\x18\x06 \x01(\x02\x12\x1c\n\x14\x63ombiner_temperature\x18\x07 \x01(\x02\x12\x16\n\x0e\x63ombiner_top_k\x18\x08 \x01(\r\x12\x16\n\x0e\x63ombiner_decay\x18\t \x01(\x02\x12\x18\n\x10weight_threshold\x18\n \x01(\x02\x12\x16\n\x0emax_query_dims\x18\x0b \x01(\r\x12\x0f\n\x07pruning\x18\x0c \x01(\x02\"\xd4\x01\n\x10\x44\x65nseVectorQuery\x12\r\n\x05\x66ield\x18\x01 \x01(\t\x12\x0e\n\x06vector\x18\x02 \x03(\x02\x12\x0e\n\x06nprobe\x18\x03 \x01(\r\x12\x15\n\rrerank_factor\x18\x04 \x01(\r\x12,\n\x08\x63ombiner\x18\x05 \x01(\x0e\x32\x1a.hermes.MultiValueCombiner\x12\x1c\n\x14\x63ombiner_temperature\x18\x06 \x01(\x02\x12\x16\n\x0e\x63ombiner_top_k\x18\x07 \x01(\r\x12\x16\n\x0e\x63ombiner_decay\x18\x08 \x01(\x02\"(\n\tTermQuery\x12\r\n\x05\x66ield\x18\x01 \x01(\t\x12\x0c\n\x04term\x18\x02 \x01(\t\"k\n\x0c\x42ooleanQuery\x12\x1b\n\x04must\x18\x01 \x03(\x0b\x32\r.hermes.Query\x12\x1d\n\x06should\x18\x02 \x03(\x0b\x32\r.hermes.Query\x12\x1f\n\x08must_not\x18\x03 \x03(\x0b\x32\r.hermes.Query\"9\n\nBoostQuery\x12\x1c\n\x05query\x18\x01 \x01(\x0b\x32\r.hermes.Query\x12\r\n\x05\x62oost\x18\x02 \x01(\x02\"\n\n\x08\x41llQuery\")\n\nMatchQuery\x12\r\n\x05\x66ield\x18\x01 \x01(\t\x12\x0c\n\x04text\x18\x02 \x01(\t\"\xcd\x01\n\x08Reranker\x12\r\n\x05\x66ield\x18\x01 \x01(\t\x12\x0e\n\x06vector\x18\x02 \x03(\x02\x12\r\n\x05limit\x18\x03 \x01(\r\x12,\n\x08\x63ombiner\x18\x04 \x01(\x0e\x32\x1a.hermes.MultiValueCombiner\x12\x1c\n\x14\x63ombiner_temperature\x18\x05 \x01(\x02\x12\x16\n\x0e\x63ombiner_top_k\x18\x06 \x01(\r\x12\x16\n\x0e\x63ombiner_decay\x18\x07 \x01(\x02\x12\x17\n\x0fmatryoshka_dims\x18\x08 \x01(\r\"\xba\x01\n\x06\x46ilter\x12\r\n\x05\x66ield\x18\x01 \x01(\t\x12\x10\n\x06\x65q_u64\x18\x02 \x01(\x04H\x00\x12\x10\n\x06\x65q_i64\x18\x03 \x01(\x03H\x00\x12\x10\n\x06\x65q_f64\x18\x04 \x01(\x01H\x00\x12\x11\n\x07\x65q_text\x18\x05 \x01(\tH\x00\x12$\n\x05range\x18\x06 \x01(\x0b\x32\x13.hermes.RangeFilterH\x00\x12%\n\tin_values\x18\x07 \x01(\x0b\x32\x10.hermes.InFilterH\x00\x42\x0b\n\tcondition\"A\n\x0bRangeFilter\x12\x10\n\x03min\x18\x01 \x01(\x01H\x00\x88\x01\x01\x12\x10\n\x03max\x18\x02 \x01(\x01H\x01\x88\x01\x01\x42\x06\n\x04_minB\x06\n\x04_max\"G\n\x08InFilter\x12\x13\n\x0btext_values\x18\x01 \x03(\t\x12\x12\n\nu64_values\x18\x02 \x03(\x04\x12\x12\n\ni64_values\x18\x03 \x03(\x03\"\xbd\x01\n\rSearchRequest\x12\x12\n\nindex_name\x18\x01 \x01(\t\x12\x1c\n\x05query\x18\x02 \x01(\x0b\x32\r.hermes.Query\x12\r\n\x05limit\x18\x03 \x01(\r\x12\x0e\n\x06offset\x18\x04 \x01(\r\x12\x16\n\x0e\x66ields_to_load\x18\x05 \x03(\t\x12\"\n\x08reranker\x18\x06 \x01(\x0b\x32\x10.hermes.Reranker\x12\x1f\n\x07\x66ilters\x18\x07 \x03(\x0b\x32\x0e.hermes.Filter\"0\n\nDocAddress\x12\x12\n\nsegment_id\x18\x01 \x01(\t\x12\x0e\n\x06\x64oc_id\x18\x02 \x01(\r\"\xdf\x01\n\tSearchHit\x12#\n\x07\x61\x64\x64ress\x18\x01 \x01(\x0b\x32\x12.hermes.DocAddress\x12\r\n\x05score\x18\x02 \x01(\x02\x12-\n\x06\x66ields\x18\x03 \x03(\x0b\x32\x1d.hermes.SearchHit.FieldsEntry\x12,\n\x0eordinal_scores\x18\x04 \x03(\x0b\x32\x14.hermes.OrdinalScore\x1a\x41\n\x0b\x46ieldsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12!\n\x05value\x18\x02 \x01(\x0b\x32\x12.hermes.FieldValue:\x02\x38\x01\".\n\x0cOrdinalScore\x12\x0f\n\x07ordinal\x18\x01 \x01(\r\x12\r\n\x05score\x18\x02 \x01(\x02\"\xdb\x01\n\nFieldValue\x12\x0e\n\x04text\x18\x01 \x01(\tH\x00\x12\r\n\x03u64\x18\x02 \x01(\x04H\x00\x12\r\n\x03i64\x18\x03 \x01(\x03H\x00\x12\r\n\x03\x66\x36\x34\x18\x04 \x01(\x01H\x00\x12\x15\n\x0b\x62ytes_value\x18\x05 \x01(\x0cH\x00\x12-\n\rsparse_vector\x18\x06 \x01(\x0b\x32\x14.hermes.SparseVectorH\x00\x12+\n\x0c\x64\x65nse_vector\x18\x07 \x01(\x0b\x32\x13.hermes.DenseVectorH\x00\x12\x14\n\njson_value\x18\x08 \x01(\tH\x00\x42\x07\n\x05value\"/\n\x0cSparseVector\x12\x0f\n\x07indices\x18\x01 \x03(\r\x12\x0e\n\x06values\x18\x02 \x03(\x02\"\x1d\n\x0b\x44\x65nseVector\x12\x0e\n\x06values\x18\x01 \x03(\x02\"~\n\x0eSearchResponse\x12\x1f\n\x04hits\x18\x01 \x03(\x0b\x32\x11.hermes.SearchHit\x12\x12\n\ntotal_hits\x18\x02 \x01(\r\x12\x0f\n\x07took_ms\x18\x03 \x01(\x04\x12&\n\x07timings\x18\x04 \x01(\x0b\x32\x15.hermes.SearchTimings\"X\n\rSearchTimings\x12\x11\n\tsearch_us\x18\x01 \x01(\x04\x12\x11\n\trerank_us\x18\x02 \x01(\x04\x12\x0f\n\x07load_us\x18\x03 \x01(\x04\x12\x10\n\x08total_us\x18\x04 \x01(\x04\"M\n\x12GetDocumentRequest\x12\x12\n\nindex_name\x18\x01 \x01(\t\x12#\n\x07\x61\x64\x64ress\x18\x02 \x01(\x0b\x32\x12.hermes.DocAddress\"\x91\x01\n\x13GetDocumentResponse\x12\x37\n\x06\x66ields\x18\x01 \x03(\x0b\x32\'.hermes.GetDocumentResponse.FieldsEntry\x1a\x41\n\x0b\x46ieldsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12!\n\x05value\x18\x02 \x01(\x0b\x32\x12.hermes.FieldValue:\x02\x38\x01\")\n\x13GetIndexInfoRequest\x12\x12\n\nindex_name\x18\x01 \x01(\t\"\xbd\x01\n\x14GetIndexInfoResponse\x12\x12\n\nindex_name\x18\x01 \x01(\t\x12\x10\n\x08num_docs\x18\x02 \x01(\r\x12\x14\n\x0cnum_segments\x18\x03 \x01(\r\x12\x0e\n\x06schema\x18\x04 \x01(\t\x12)\n\x0cmemory_stats\x18\x05 \x01(\x0b\x32\x13.hermes.MemoryStats\x12.\n\x0cvector_stats\x18\x06 \x03(\x0b\x32\x18.hermes.VectorFieldStats\"e\n\x10VectorFieldStats\x12\x12\n\nfield_name\x18\x01 \x01(\t\x12\x13\n\x0bvector_type\x18\x02 \x01(\t\x12\x15\n\rtotal_vectors\x18\x03 \x01(\x04\x12\x11\n\tdimension\x18\x04 \x01(\r\"\x8c\x01\n\x0bMemoryStats\x12\x13\n\x0btotal_bytes\x18\x01 \x01(\x04\x12\x34\n\x0findexing_buffer\x18\x02 \x01(\x0b\x32\x1b.hermes.IndexingBufferStats\x12\x32\n\x0esegment_reader\x18\x03 \x01(\x0b\x32\x1a.hermes.SegmentReaderStats\"\xdf\x01\n\x13IndexingBufferStats\x12\x13\n\x0btotal_bytes\x18\x01 \x01(\x04\x12\x16\n\x0epostings_bytes\x18\x02 \x01(\x04\x12\x1c\n\x14sparse_vectors_bytes\x18\x03 \x01(\x04\x12\x1b\n\x13\x64\x65nse_vectors_bytes\x18\x04 \x01(\x04\x12\x16\n\x0einterner_bytes\x18\x05 \x01(\x04\x12\x1c\n\x14position_index_bytes\x18\x06 \x01(\x04\x12\x14\n\x0cpending_docs\x18\x07 \x01(\r\x12\x14\n\x0cunique_terms\x18\x08 \x01(\r\"\xb7\x01\n\x12SegmentReaderStats\x12\x13\n\x0btotal_bytes\x18\x01 \x01(\x04\x12\x1d\n\x15term_dict_cache_bytes\x18\x02 \x01(\x04\x12\x19\n\x11store_cache_bytes\x18\x03 \x01(\x04\x12\x1a\n\x12sparse_index_bytes\x18\x04 \x01(\x04\x12\x19\n\x11\x64\x65nse_index_bytes\x18\x05 \x01(\x04\x12\x1b\n\x13num_segments_loaded\x18\x06 \x01(\r\"8\n\x12\x43reateIndexRequest\x12\x12\n\nindex_name\x18\x01 \x01(\t\x12\x0e\n\x06schema\x18\x02 \x01(\t\"&\n\x13\x43reateIndexResponse\x12\x0f\n\x07success\x18\x01 \x01(\x08\"=\n\nFieldEntry\x12\x0c\n\x04name\x18\x01 \x01(\t\x12!\n\x05value\x18\x02 \x01(\x0b\x32\x12.hermes.FieldValue\"3\n\rNamedDocument\x12\"\n\x06\x66ields\x18\x01 \x03(\x0b\x32\x12.hermes.FieldEntry\"Z\n\x1a\x42\x61tchIndexDocumentsRequest\x12\x12\n\nindex_name\x18\x01 \x01(\t\x12(\n\tdocuments\x18\x02 \x03(\x0b\x32\x15.hermes.NamedDocument\"I\n\x1b\x42\x61tchIndexDocumentsResponse\x12\x15\n\rindexed_count\x18\x01 \x01(\r\x12\x13\n\x0b\x65rror_count\x18\x02 \x01(\r\"N\n\x14IndexDocumentRequest\x12\x12\n\nindex_name\x18\x01 \x01(\t\x12\"\n\x06\x66ields\x18\x02 \x03(\x0b\x32\x12.hermes.FieldEntry\"/\n\x16IndexDocumentsResponse\x12\x15\n\rindexed_count\x18\x01 \x01(\r\"#\n\rCommitRequest\x12\x12\n\nindex_name\x18\x01 \x01(\t\"3\n\x0e\x43ommitResponse\x12\x0f\n\x07success\x18\x01 \x01(\x08\x12\x10\n\x08num_docs\x18\x02 \x01(\r\"\'\n\x11\x46orceMergeRequest\x12\x12\n\nindex_name\x18\x01 \x01(\t\";\n\x12\x46orceMergeResponse\x12\x0f\n\x07success\x18\x01 \x01(\x08\x12\x14\n\x0cnum_segments\x18\x02 \x01(\r\"(\n\x12\x44\x65leteIndexRequest\x12\x12\n\nindex_name\x18\x01 \x01(\t\"&\n\x13\x44\x65leteIndexResponse\x12\x0f\n\x07success\x18\x01 \x01(\x08\"\x14\n\x12ListIndexesRequest\"*\n\x13ListIndexesResponse\x12\x13\n\x0bindex_names\x18\x01 \x03(\t\"/\n\x19RetrainVectorIndexRequest\x12\x12\n\nindex_name\x18\x01 \x01(\t\"-\n\x1aRetrainVectorIndexResponse\x12\x0f\n\x07success\x18\x01 \x01(\x08*\x81\x01\n\x12MultiValueCombiner\x12\x18\n\x14\x43OMBINER_LOG_SUM_EXP\x10\x00\x12\x10\n\x0c\x43OMBINER_MAX\x10\x01\x12\x10\n\x0c\x43OMBINER_AVG\x10\x02\x12\x10\n\x0c\x43OMBINER_SUM\x10\x03\x12\x1b\n\x17\x43OMBINER_WEIGHTED_TOP_K\x10\x04\x32\xdb\x01\n\rSearchService\x12\x37\n\x06Search\x12\x15.hermes.SearchRequest\x1a\x16.hermes.SearchResponse\x12\x46\n\x0bGetDocument\x12\x1a.hermes.GetDocumentRequest\x1a\x1b.hermes.GetDocumentResponse\x12I\n\x0cGetIndexInfo\x12\x1b.hermes.GetIndexInfoRequest\x1a\x1c.hermes.GetIndexInfoResponse2\xf3\x04\n\x0cIndexService\x12\x46\n\x0b\x43reateIndex\x12\x1a.hermes.CreateIndexRequest\x1a\x1b.hermes.CreateIndexResponse\x12P\n\x0eIndexDocuments\x12\x1c.hermes.IndexDocumentRequest\x1a\x1e.hermes.IndexDocumentsResponse(\x01\x12^\n\x13\x42\x61tchIndexDocuments\x12\".hermes.BatchIndexDocumentsRequest\x1a#.hermes.BatchIndexDocumentsResponse\x12\x37\n\x06\x43ommit\x12\x15.hermes.CommitRequest\x1a\x16.hermes.CommitResponse\x12\x43\n\nForceMerge\x12\x19.hermes.ForceMergeRequest\x1a\x1a.hermes.ForceMergeResponse\x12\x46\n\x0b\x44\x65leteIndex\x12\x1a.hermes.DeleteIndexRequest\x1a\x1b.hermes.DeleteIndexResponse\x12\x46\n\x0bListIndexes\x12\x1a.hermes.ListIndexesRequest\x1a\x1b.hermes.ListIndexesResponse\x12[\n\x12RetrainVectorIndex\x12!.hermes.RetrainVectorIndexRequest\x1a\".hermes.RetrainVectorIndexResponseb\x06proto3')
-
-_globals = globals()
-_builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
-_builder.BuildTopDescriptorsAndMessages(DESCRIPTOR, 'hermes_pb2', _globals)
-if not _descriptor._USE_C_DESCRIPTORS:
-  DESCRIPTOR._loaded_options = None
-  _globals['_SEARCHHIT_FIELDSENTRY']._loaded_options = None
-  _globals['_SEARCHHIT_FIELDSENTRY']._serialized_options = b'8\001'
-  _globals['_GETDOCUMENTRESPONSE_FIELDSENTRY']._loaded_options = None
-  _globals['_GETDOCUMENTRESPONSE_FIELDSENTRY']._serialized_options = b'8\001'
-  _globals['_MULTIVALUECOMBINER']._serialized_start=4744
-  _globals['_MULTIVALUECOMBINER']._serialized_end=4873
-  _globals['_QUERY']._serialized_start=25
-  _globals['_QUERY']._serialized_end=326
-  _globals['_SPARSEVECTORQUERY']._serialized_start=329
-  _globals['_SPARSEVECTORQUERY']._serialized_end=622
-  _globals['_DENSEVECTORQUERY']._serialized_start=625
-  _globals['_DENSEVECTORQUERY']._serialized_end=837
-  _globals['_TERMQUERY']._serialized_start=839
-  _globals['_TERMQUERY']._serialized_end=879
-  _globals['_BOOLEANQUERY']._serialized_start=881
-  _globals['_BOOLEANQUERY']._serialized_end=988
-  _globals['_BOOSTQUERY']._serialized_start=990
-  _globals['_BOOSTQUERY']._serialized_end=1047
-  _globals['_ALLQUERY']._serialized_start=1049
-  _globals['_ALLQUERY']._serialized_end=1059
-  _globals['_MATCHQUERY']._serialized_start=1061
-  _globals['_MATCHQUERY']._serialized_end=1102
-  _globals['_RERANKER']._serialized_start=1105
-  _globals['_RERANKER']._serialized_end=1310
-  _globals['_FILTER']._serialized_start=1313
-  _globals['_FILTER']._serialized_end=1499
-  _globals['_RANGEFILTER']._serialized_start=1501
-  _globals['_RANGEFILTER']._serialized_end=1566
-  _globals['_INFILTER']._serialized_start=1568
-  _globals['_INFILTER']._serialized_end=1639
-  _globals['_SEARCHREQUEST']._serialized_start=1642
-  _globals['_SEARCHREQUEST']._serialized_end=1831
-  _globals['_DOCADDRESS']._serialized_start=1833
-  _globals['_DOCADDRESS']._serialized_end=1881
-  _globals['_SEARCHHIT']._serialized_start=1884
-  _globals['_SEARCHHIT']._serialized_end=2107
-  _globals['_SEARCHHIT_FIELDSENTRY']._serialized_start=2042
-  _globals['_SEARCHHIT_FIELDSENTRY']._serialized_end=2107
-  _globals['_ORDINALSCORE']._serialized_start=2109
-  _globals['_ORDINALSCORE']._serialized_end=2155
-  _globals['_FIELDVALUE']._serialized_start=2158
-  _globals['_FIELDVALUE']._serialized_end=2377
-  _globals['_SPARSEVECTOR']._serialized_start=2379
-  _globals['_SPARSEVECTOR']._serialized_end=2426
-  _globals['_DENSEVECTOR']._serialized_start=2428
-  _globals['_DENSEVECTOR']._serialized_end=2457
-  _globals['_SEARCHRESPONSE']._serialized_start=2459
-  _globals['_SEARCHRESPONSE']._serialized_end=2585
-  _globals['_SEARCHTIMINGS']._serialized_start=2587
-  _globals['_SEARCHTIMINGS']._serialized_end=2675
-  _globals['_GETDOCUMENTREQUEST']._serialized_start=2677
-  _globals['_GETDOCUMENTREQUEST']._serialized_end=2754
-  _globals['_GETDOCUMENTRESPONSE']._serialized_start=2757
-  _globals['_GETDOCUMENTRESPONSE']._serialized_end=2902
-  _globals['_GETDOCUMENTRESPONSE_FIELDSENTRY']._serialized_start=2042
-  _globals['_GETDOCUMENTRESPONSE_FIELDSENTRY']._serialized_end=2107
-  _globals['_GETINDEXINFOREQUEST']._serialized_start=2904
-  _globals['_GETINDEXINFOREQUEST']._serialized_end=2945
-  _globals['_GETINDEXINFORESPONSE']._serialized_start=2948
-  _globals['_GETINDEXINFORESPONSE']._serialized_end=3137
-  _globals['_VECTORFIELDSTATS']._serialized_start=3139
-  _globals['_VECTORFIELDSTATS']._serialized_end=3240
-  _globals['_MEMORYSTATS']._serialized_start=3243
-  _globals['_MEMORYSTATS']._serialized_end=3383
-  _globals['_INDEXINGBUFFERSTATS']._serialized_start=3386
-  _globals['_INDEXINGBUFFERSTATS']._serialized_end=3609
-  _globals['_SEGMENTREADERSTATS']._serialized_start=3612
-  _globals['_SEGMENTREADERSTATS']._serialized_end=3795
-  _globals['_CREATEINDEXREQUEST']._serialized_start=3797
-  _globals['_CREATEINDEXREQUEST']._serialized_end=3853
-  _globals['_CREATEINDEXRESPONSE']._serialized_start=3855
-  _globals['_CREATEINDEXRESPONSE']._serialized_end=3893
-  _globals['_FIELDENTRY']._serialized_start=3895
-  _globals['_FIELDENTRY']._serialized_end=3956
-  _globals['_NAMEDDOCUMENT']._serialized_start=3958
-  _globals['_NAMEDDOCUMENT']._serialized_end=4009
-  _globals['_BATCHINDEXDOCUMENTSREQUEST']._serialized_start=4011
-  _globals['_BATCHINDEXDOCUMENTSREQUEST']._serialized_end=4101
-  _globals['_BATCHINDEXDOCUMENTSRESPONSE']._serialized_start=4103
-  _globals['_BATCHINDEXDOCUMENTSRESPONSE']._serialized_end=4176
-  _globals['_INDEXDOCUMENTREQUEST']._serialized_start=4178
-  _globals['_INDEXDOCUMENTREQUEST']._serialized_end=4256
-  _globals['_INDEXDOCUMENTSRESPONSE']._serialized_start=4258
-  _globals['_INDEXDOCUMENTSRESPONSE']._serialized_end=4305
-  _globals['_COMMITREQUEST']._serialized_start=4307
-  _globals['_COMMITREQUEST']._serialized_end=4342
-  _globals['_COMMITRESPONSE']._serialized_start=4344
-  _globals['_COMMITRESPONSE']._serialized_end=4395
-  _globals['_FORCEMERGEREQUEST']._serialized_start=4397
-  _globals['_FORCEMERGEREQUEST']._serialized_end=4436
-  _globals['_FORCEMERGERESPONSE']._serialized_start=4438
-  _globals['_FORCEMERGERESPONSE']._serialized_end=4497
-  _globals['_DELETEINDEXREQUEST']._serialized_start=4499
-  _globals['_DELETEINDEXREQUEST']._serialized_end=4539
-  _globals['_DELETEINDEXRESPONSE']._serialized_start=4541
-  _globals['_DELETEINDEXRESPONSE']._serialized_end=4579
-  _globals['_LISTINDEXESREQUEST']._serialized_start=4581
-  _globals['_LISTINDEXESREQUEST']._serialized_end=4601
-  _globals['_LISTINDEXESRESPONSE']._serialized_start=4603
-  _globals['_LISTINDEXESRESPONSE']._serialized_end=4645
-  _globals['_RETRAINVECTORINDEXREQUEST']._serialized_start=4647
-  _globals['_RETRAINVECTORINDEXREQUEST']._serialized_end=4694
-  _globals['_RETRAINVECTORINDEXRESPONSE']._serialized_start=4696
-  _globals['_RETRAINVECTORINDEXRESPONSE']._serialized_end=4741
-  _globals['_SEARCHSERVICE']._serialized_start=4876
-  _globals['_SEARCHSERVICE']._serialized_end=5095
-  _globals['_INDEXSERVICE']._serialized_start=5098
-  _globals['_INDEXSERVICE']._serialized_end=5725
-# @@protoc_insertion_point(module_scope)

hermes_client_python-1.7.14/src/hermes_client_python/types.py

@@ -1,78 +0,0 @@
-"""Type definitions for Hermes client."""
-
-from dataclasses import dataclass, field
-from typing import Any
-
-
-@dataclass
-class Document:
-    """A document with field values."""
-
-    fields: dict[str, Any] = field(default_factory=dict)
-
-    def __getitem__(self, key: str) -> Any:
-        return self.fields[key]
-
-    def __setitem__(self, key: str, value: Any) -> None:
-        self.fields[key] = value
-
-    def get(self, key: str, default: Any = None) -> Any:
-        return self.fields.get(key, default)
-
-
-@dataclass
-class DocAddress:
-    """Unique document address: segment + local doc_id."""
-
-    segment_id: str
-    doc_id: int
-
-
-@dataclass
-class SearchHit:
-    """A single search result."""
-
-    address: DocAddress
-    score: float
-    fields: dict[str, Any] = field(default_factory=dict)
-
-
-@dataclass
-class SearchTimings:
-    """Detailed timing breakdown for search phases (all values in microseconds)."""
-
-    search_us: int
-    rerank_us: int
-    load_us: int
-    total_us: int
-
-
-@dataclass
-class SearchResponse:
-    """Search response with hits and metadata."""
-
-    hits: list[SearchHit]
-    total_hits: int
-    took_ms: int
-    timings: SearchTimings | None = None
-
-
-@dataclass
-class VectorFieldStats:
-    """Per-field vector statistics."""
-
-    field_name: str
-    vector_type: str  # "dense" or "sparse"
-    total_vectors: int
-    dimension: int
-
-
-@dataclass
-class IndexInfo:
-    """Information about an index."""
-
-    index_name: str
-    num_docs: int
-    num_segments: int
-    schema: str
-    vector_stats: list[VectorFieldStats] = field(default_factory=list)