Discovery
data class DiscoveryQuery(val mode: RetrievalMode, val text: String? = null, val entityId: String? = null, val from: Instant? = null, val to: Instant? = null, val topK: Int = 10, val depth: Int = 1, val similarityThreshold: Double = 0.0)
A leak-free request for the discovery surface.
The request carries only primitive / String / Instant / enum fields — no store, RAG, or graph types cross the caller boundary. The context is NOT part of the request: it is baked into the router so a caller cannot read across contexts.
Path-style queries (connecting two entities) are not a retrieval mode; they are served by the dedicated path endpoint/tool which takes its two entity ids directly, so this request carries no destination-entity field.