---
name: query_result
lang: py
domain: core
version: "1.0.0"
algebraic: product
definition: |
  @dataclass
  class QueryResult:
      query: TypedQuery
      matched_contexts: list[MatchedContext]
      searched_directories: list[str]
description: "Resultado de una sola TypedQuery con los contextos encontrados y los directorios que se buscaron."
tags: [retrieval, result, rag, query, search]
uses_types: [typed_query_py_core, matched_context_py_core]
file_path: "python/types/core/query_result.py"
---

## Notas

Representa la respuesta a una unica TypedQuery dentro de un QueryPlan. El campo `searched_directories` permite auditar que directorios fueron efectivamente explorados, lo que puede diferir de los `target_directories` de la query si algunos no estaban disponibles.

`matched_contexts` se ordena convencionalmente por score descendente, pero el tipo no lo impone — es responsabilidad del retriever.

Un `FindResult` agrega multiples `QueryResult` para dar la vision consolidada por tipo de contexto.
