Function _finalize_candidate_hits

mempalace/searcher.py:871–908

(
    *,
    candidate_strategy: str,
    hits: list,
    drawers_col,
    query: str,
    wing: str,
    room: str,
    n_results: int,
    max_distance: float,
    source_file: str = None,
)

def _finalize_candidate_hits(
    *,
    candidate_strategy: str,
    hits: list,
    drawers_col,
    query: str,
    wing: str,
    room: str,
    n_results: int,
    max_distance: float,
    source_file: str = None,
) -> tuple:
    try:
        _apply_candidate_strategy(
            candidate_strategy,
            hits,
            drawers_col,
            query,
            wing,
            room,
            n_results,
            max_distance=max_distance,
            source_file=source_file,
        )
    except UnsupportedCapabilityError:
        return [], {
            "error": "candidate_strategy='union' requires a backend with lexical_search support",
            "unsupported_capability": "supports_lexical_search",
            "hint": "Use candidate_strategy='vector' or select a backend that supports lexical search.",
        }

    hits = _hybrid_rank(hits, query, metric=_metric_for_collection(drawers_col))[:n_results]
    for h in hits:
        h.pop("_sort_key", None)
        h.pop("_source_file_full", None)
        h.pop("_chunk_index", None)
        h.pop("_parent_drawer_id", None)
    return hits, None


def _backend_mismatch_result(error: BackendMismatchError) -> dict: