API

POST /query/semantic

Semantic query retrieves memories by intent and meaning, then applies temporal policy.

Request fields

`textual_query`: user question or search prompt
`entity_id`: retrieval scope
`limit`: max returned hits
`kind_filter` (optional): restrict memory kinds
`include_superseded` (optional): include invalidated facts

Hybrid retrieval behavior

Despite the endpoint name, semantic query can still include lexical fusion and reranking under the hood, depending on engine configuration.

This keeps the API stable while retrieval internals evolve.

Example response

Top hit payload

{
  "hits": [
    {
      "memory_id": "user-123::chat-82::42",
      "textual_content": "I moved from NYC to LA last month.",
      "kind": "Fact",
      "score": 0.924,
      "created_at_ms": 1763653742000
    }
  ]
}