enquire-mcp API reference - v3.9.0-rc.4
    Preparing search index...

    Interface SearchHybridHit

    One row of the fused searchHybrid response.

    Exposes per_signal for full observability — agents can see which retrieval signal contributed (BM25 / TF-IDF / embeddings) and at what rank/score, which is critical for debugging recall regressions and for explaining results to end users.

    interface SearchHybridHit {
        chunk_index?: number;
        kind: "md" | "pdf";
        line_end?: number;
        line_start?: number;
        path: string;
        per_signal: {
            bm25?: { rank: number; score: number };
            embeddings?: { rank: number; score: number };
            tfidf?: { rank: number; score: number };
        };
        reranker_score?: number;
        score: number;
        snippet: string;
        title: string;
    }
    Index

    Properties

    chunk_index?: number
    kind: "md" | "pdf"

    v2.8.0 — content-source kind. Lets agents distinguish markdown notes from PDF chunks when both are indexed. Defaults to "md" for backward compatibility (legacy DBs and TF-IDF hits have no kind metadata).

    line_end?: number
    line_start?: number
    path: string

    Vault-relative path of the matching note (or path#chunk for granularity: "block").

    per_signal: {
        bm25?: { rank: number; score: number };
        embeddings?: { rank: number; score: number };
        tfidf?: { rank: number; score: number };
    }

    Per-signal observability — which signals contributed at what rank/score.

    reranker_score?: number

    v2.9.0 — cross-encoder reranker score in [0, 1] (sigmoid of the model's relevance logit). Present only when the server was started with --enable-reranker AND this hit was within the reranker's top-N candidate set (default 50). Higher = more relevant. Compare across results within the same response, NOT across queries (the absolute value depends on the query).

    score: number

    Fused RRF score (sum of 1/(k+rank) terms across signals).

    snippet: string

    Snippet from whichever signal produced the best chunk hit.

    title: string

    Stripped basename for display (.md or .pdf removed per kind).