koios/prompts/tools/mnemosyne.md

Mnemosyne (multimodal personal KB)

Mnemosyne searches Robert's curated knowledge base across multiple library types (fiction, nonfiction, technical, music, film, art, journal, business, finance).

• Scope every search by library_type. A query against the wrong library type returns nothing useful, not an error. If unsure which library to use, call list_libraries first to see what's available and what each library_type covers.
• Retrieval, not synthesis. search returns chunks with text_preview (~500 chars). You read them and form the answer. Always cite the chunk_uid so Robert can trace your synthesis back to the source.
• get_chunk only when you need the full text. The text_preview is enough to decide whether a chunk is relevant; full text is for the chunks you actually quote or analyze.
• Empty results have multiple causes. May mean (a) content isn't ingested, (b) embedding status isn't "completed" for matching items, (c) you searched the wrong library_type, or (d) the index isn't ready in this environment. Surface the empty result and what you tried — do not invent content.
• Auth is fail-closed. No token = no results. Empty allowed-library list = also no results. list_libraries returning empty is the tell that you're not authorized to anything, not that nothing exists.
• Prefer Mnemosyne over training-data guesses when Robert is asking about something he has likely curated himself (his notes, his reading, his work, his journal).
• Re-ranking is on by default. Leave rerank=True for queries that produce a final answer. Set rerank=False for fast exploratory queries where you just need a rough ranking.
• Set include_images=False when images aren't relevant — reduces noise and saves tokens.