---
name: typed_query
lang: py
domain: core
version: "1.0.0"
algebraic: product
definition: |
  @dataclass
  class TypedQuery:
      query: str
      context_type: ContextType | None
      intent: str
      priority: int = 3
      target_directories: list[str] = field(default_factory=list)
description: "Query tipada que resulta del analisis de intenciones. Un plan de busqueda se descompone en multiples TypedQueries, cada una apuntando a un tipo de contexto diferente."
tags: [retrieval, query, rag, intent, search, plan]
uses_types: [context_type_py_core]
file_path: "python/types/core/typed_query.py"
---

## Notas

`priority` sigue la convencion 1=alta, 5=baja (similar a niveles de issue). Valor por defecto 3 es prioridad media.

`context_type = None` indica que la query aplica a todos los tipos de contexto sin filtro. Util para queries generales que el retriever distribuye entre todas las categorias.

`target_directories` vacio significa buscar en todos los directorios disponibles. Con URIs especificos, el retriever limita la busqueda al subconjunto indicado — util para reducir ruido en colecciones grandes.
