perseus_vault_recall_when
Proactive just-in-time recall: surface entities whose recallwhen triggers match.
How to use it
perseus_vault_recall_when is exposed by the Perseus Vault MCP server. Add the server to your MCP client (Claude Desktop, Cursor, Windsurf and others), and the perseus_vault_recall_when tool becomes available to the model automatically. See the full listing for setup details and every tool this server provides.
FULL PERSEUS VAULT LISTINGOther tools in Perseus Vault (39)
Transaction-time time-travel: the version of a fact (category + key) that was believed at a past instant.
RAG: recall context, query LLM, return grounded answer with sources.
Full 2-axis bi-temporal query: "as of transaction time T, what did we believe was true at valid time V" — the exact rectangle cell.
Opt-in in-session capture (#520): distill a transcript/insight payload (text, markdown, or JSONL) into durable entities (root-cause / pitfall / decision / pattern / takeaway) the moment a problem is solved. Local rule-based distiller by default, optional llm: true with graceful fallback; near-dup me
Deja-vu guard: check an action against previously recorded failures (journal + failure/pitfall entities) before retrying it. Read-only.
GraphRAG community detection over the link graph (deterministic label propagation or greedy-modularity "louvain"; pure Rust, offline).
Extractive (optionally LLM-polished) summary of one community, materialized as an entity with evidencefor links to members.
Pre-formatted markdown block for session injection. Recall-first by default: pass query (the current task/message) and only topically relevant entities are injected, clamped to a per-model budget; the legacy unconditional dump requires mode: "alwaysinject".
Recalculate Ebbinghaus decay scores (batched 1000-entity transactions).
Generate dense vectors via the bundled model, Ollama, or OpenAI-compatible endpoint.
Time-based lifecycle sweep: entities past their body expiresat transition to status='expired' (content retained, dry-run supported).
Local, deterministic, rule-based knowledge extraction (facts / preferences / temporal events / episodes) from text or a stored entity. Read-only.
Soft-delete (archived=1).
Fetch one entity by ID with full bodyjson.
GraphRAG global search: breadth over community summaries, then depth into the best communities' members — holistic answers across clusters.
Stamp the from-side entity id as the evidence anchor on legacy edges so they become serveable by the graph recall arms (#869); dry-run preview, journaled.
Read-only graph/entities/indexes/receipts drift report (#869): unattested, dangling, archived/expired-target, and cross-workspace edges, stale community memberships, FTS drift, journal refs to missing entities.
List superseded versions of a fact (category + key), newest first — paginated (limit default 20, plus offset); total reports the full trail size (companion to perseusvaultasof).
Read-only startup-memory hygiene report (#675): scores active memories by "actionability" (concrete anchors — issue keys, #refs, paths, URLs, decisions — vs vague/date-only/short) and lists the worst offenders with reasons, for archive/consolidate curation.
Trigger connector syncs (GitHub, file watcher).
Locally extract a document's text (plaintext/markdown always; DOCX/PDF with the multimodal feature) and store it as a recallable entity.
Append structured event with actor attribution.
Create typed relationship links between entities.
Anthropic memory-tool compatible file interface (view/create/strreplace/insert/delete/rename under /memories), backed by vault entities.
Bulk archive by category, decay threshold, or age.
Permanently delete archived entities + VACUUM. Destructive.
Search with FTS5/dense/hybrid modes, filters, stemming expansion. Query contract (#562): query="" is match-all enumeration (the "list all" path); "" and other wildcards are literal FTS5 terms, not globs — "" matches nothing.
Recall from a specific biomimetic layer (world, episodic, semantic).
Store/update entity. Idempotent by (category, key); a content change snapshots the prior version into history.
Deterministic paginated enumeration of a category or the whole store (#562): immutable id ASC keyset pages with a nextcursor/hasmore contract, so export/sync/reset callers can walk every entity exactly once. Read-only — no retrieval-count/decay side-effects, no offset cap.
Dense-only semantic search shortcut — find entities by meaning, ranked purely by embedding similarity (no keyword fallback).
Delete state entry.
Get state value. Returns null if expired.
List state keys, optionally filtered by prefix.
Set key-value state with optional TTL.
Query journal by time range with filters.
Walk entity link graph up to configurable depth.
Remove entity links.
Valid-time lookup: the version that was actually true in the world at an instant, per current knowledge (SQL:2011 APPLICATIONTIME).