kmemo-core/dev.kmemo/CacheEntry

CacheEntry

class CacheEntry(val id: String, val scope: String, val prompt: String, val response: String, embedding: FloatArray, val createdAt: Instant, val metadata: Map<String, String> = emptyMap())

One cached prompt/response pair plus the vector used to find it again.

The embedding passed in is normalized on construction, so CacheEntry.embedding is always unit length and Vectors.dot against another normalized vector yields cosine similarity directly.

Identity is the id alone: two entries with the same id are the same entry, whatever else changed. That keeps entries usable as map keys without ever comparing float arrays element by element.

Constructors

CacheEntry

constructor(id: String, scope: String, prompt: String, response: String, embedding: FloatArray, createdAt: Instant, metadata: Map<String, String> = emptyMap())

Properties

createdAt

val createdAt: Instant

Write time, used for TTL expiry and for reporting the age of a hit.

dimensions

val dimensions: Int

Dimensionality of embedding.

embedding

val embedding: FloatArray

Unit-normalized embedding of prompt.

val id: String

Store-unique identifier, assigned when the entry is written.

metadata

val metadata: Map<String, String>

Free-form caller data, returned untouched on a hit (token counts, model id, trace id...).

prompt

val prompt: String

The prompt exactly as it was seen, kept verbatim because the guards re-read it on every hit.

response

val response: String

The response to replay when this entry matches.

scope

val scope: String

Partition this entry belongs to. Lookups only ever see entries from their own scope, which is how you keep a gpt-4o answer from being served to a haiku caller — see SemanticCache.

Functions

equals

open operator override fun equals(other: Any?): Boolean

hashCode

open override fun hashCode(): Int

toString

open override fun toString(): String

withResponse

fun withResponse(response: String): CacheEntry

Copy of this entry with a different response, keeping id, embedding and creation time. Useful when refreshing a stale answer without paying to re-embed the prompt.