retrieve

type Channel struct {
	Name  string
	Items []Item
}

type Item struct {
	Kind      string // "message" | "node"
	ID        string // id del mensaje o del nodo
	ChatID    string
	Title     string // título del chat/nodo (path corto)
	Source    string // codex | claude
	Role      string // rol (hits de mensaje)
	NodeKind  string // project|chat|commit (hits de nodo)
	Content   string // snippet o summary
	Timestamp int64
	// StoreID es el origen del item en lectura federada: "" = store personal,
	// si no el nombre del team store. Participa de itemKey, así un mismo ID local
	// en stores distintos (p.ej. tras promover un chat) no colapsa en uno.
	StoreID string
}

type Option func(*config)

type Params struct {
	Query   string   // query en lenguaje natural
	Top     int      // máximo de resultados (default 10)
	Roles   []string // roles de mensaje a incluir (ya resueltos; nil = todos)
	Allowed []string // scope: chatIDs visibles (nil = sin filtro)
	Mode    string   // "hybrid" (default) | "keyword" | "semantic"
	Expand  bool     // activar PRF (expansión por relevancia)
	// Learned activa el canal aprendido (pares query→read; solo store personal).
	// Los llamadores no lo activan: medido sobre un store real con preguntas
	// nuevas, bajaba el MRR de 0.76 a 0.52, porque basta un término compartido
	// para que suban los nodos más leídos. La señal se sigue registrando, así un
	// uso más estricto (p.ej. solo con queries casi repetidas) puede retomarla.
	Learned bool
}

type Scored struct {
	Item
	Score float64
}