lookup

suspend fun lookup(prompt: String, scope: String = DEFAULT_SCOPE): CacheLookup

Looks up prompt and reports the full outcome, including why a miss was a miss.

Costs one Embedder.embed call. Use this over get when you want to log or act on the reason — a cache whose hit rate is 4% is untunable unless you know whether prompts are landing below the threshold or being vetoed by a guard.