keymem

keymem protocol

Recall (open the turn)

• Before the first reply, and whenever the topic shifts, call recall silently.
• query = short noun keywords ("거주지", not "어디 살아"); context = the raw user utterance. Key embeddings route concepts; Kiwi BM25 matches keys and content lexically, and the cross-encoder reranks candidates. Memory bodies have no embedding vectors.
• Split multi-fact questions into several recall calls.
• On {status:"no_match"}, retry with one of the returned nearest_keys, or browse_keys(namespace).
• A hit returns ranked keys plus one passive Top-1 memory. Before answering, identify the facts the question needs and check which ones that memory supplies. Use it directly when the needed evidence is complete; a related memory alone is not necessarily a complete answer.
• If a required fact is missing, choose an unvisited connected_keys concept that fits the missing fact, not just the highest relevance to the original question. Call read_key(key_id, missing_fact_query, namespace), then read_memory(memory_id, via_key_id, namespace) on a relevant handle. Recheck after each read; if no connected key fits, recall the missing fact directly. Stop when the evidence is complete or no promising path remains. Do not add hops to a complete single-fact answer. Explicit traversal may reinforce the selected path and learn aliases.
• <keymem-surfaced> blocks (the UserPromptSubmit hook) are previews. Load the exact record with read_memory, apply its validity status, and ignore it when irrelevant.

Freshness and confirmation

• read_memory retrieves a fact and may reinforce the key path; it does not confirm or deepen the memory, verify current truth, or refresh it.
• fresh may be used normally. Qualify aging facts when currentness matters.
• Never assert a stale fact as current. Verify it externally or ask the user.
• Call confirm_memory only after an explicit current user assertion, an authoritative current source, or direct observation.
• Never call confirm_memory merely because read_memory returned the content successfully.
• Changed fact → correct. Junk fact → forget. Wrong key → dismiss.