@mnemoverse/mcp-memory-server 0.4.2 → 0.7.0

package/README.md

@@ -199,7 +199,8 @@ If it doesn't remember: check that the client was fully restarted and the config
 | Tool | What it does |
 |------|-------------|
 | `memory_write` | Store a memory — insight, preference, lesson learned |
-| `memory_read` | Search memories by natural language query |
+| `memory_read` | Search memories by natural language query (optional recency ordering, time bounds, author exclusion) |
+| `memory_list_recent` | List newest memories first — no query; `since` watermark + cursor paging |
 | `memory_feedback` | Rate memories as helpful or not (improves future recall) |
 | `memory_stats` | Check how many memories stored, which domains exist |
 | `memory_delete` | Permanently delete a single memory by `atom_id` |

package/dist/index.js

@@ -3,6 +3,8 @@ import { createRequire } from "node:module";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { z } from "zod";
+import { formatReadItem, formatRecentPage, safeInline, } from "./render.js";
+import { SERVER_INSTRUCTIONS, buildReadEmptyResponse } from "./teaching.js";
 // Version is read at runtime from package.json so there is exactly one place
 // to bump on each release. Works both from `dist/` during local dev and from
 // `node_modules/@mnemoverse/mcp-memory-server/dist/` after an npm install.
@@ -67,7 +69,7 @@ async function apiFetch(path, options = {}) {
  * result stays well-formed. Otherwise an emoji or non-BMP character at the
  * boundary can produce a lone surrogate and corrupt downstream JSON encoding.
  */
-function capResult(text) {
+function capResult(text, moreHint = "Use a more specific query or smaller top_k to see all results.") {
     if (text.length <= MAX_RESULT_CHARS)
         return text;
     let truncated = text.slice(0, MAX_RESULT_CHARS - 200);
@@ -75,17 +77,33 @@ function capResult(text) {
     if (lastCode >= 0xd800 && lastCode <= 0xdbff) {
         truncated = truncated.slice(0, -1);
     }
-    return (truncated +
-        `\n\n[…truncated to fit 25K token limit. Use a more specific query or smaller top_k to see all results.]`);
+    // `moreHint` lets no-input tools (the discovery lists) give accurate truncation
+    // guidance instead of the read-tool default (which points at query/top_k controls a
+    // repeated no-arg call cannot use). Existing callers keep the default message.
+    return `${truncated}\n\n[…truncated to fit the 25K token limit. ${moreHint}]`;
 }
+/**
+ * Sanitize an untrusted string for safe inline rendering in tool output that a
+ * DIFFERENT principal's LLM will read (CN-032 anti-injection). A room name is
+ * chosen by the room OWNER but surfaced to a JOINER's assistant on join/invite;
+ * core only trims whitespace on it, so quotes/colons/newlines pass. Strip to a
+ * conservative charset and collapse whitespace, then cap length. Same treatment
+ * `formatAuthorTag` already applies to a server-stamped author.
+ * Implementation lives in src/render.ts (shared with the item renderers,
+ * testable there); re-imported here for the 15 other call sites.
+ */
 // --- Server setup ---
+// The second argument lands verbatim in the connected model's system prompt on
+// clients that surface MCP instructions — it is the single highest-leverage
+// teaching surface this server has. Kept in src/teaching.ts so tests can
+// assert its polarity/length without booting the server.
 const server = new McpServer({
     name: "mnemoverse-memory",
     version: pkg.version,
-});
+}, { instructions: SERVER_INSTRUCTIONS });
 // --- Tool: memory_write ---
 server.registerTool("memory_write", {
-    description: "Store a long-term memory that persists across sessions AND across every AI tool the user has connected to Mnemoverse (Claude, ChatGPT, Cursor, VS Code) — write once, recall everywhere. Call this PROACTIVELY the moment the user states a preference, makes a decision, or you learn a durable fact (people, roles, project setup, a lesson). Don't wait to be asked. Do NOT use it for transient chatter, secrets, or anything only relevant to the current turn. Behavior: an importance gate may filter low-value writes, so the result tells you whether the memory was stored or filtered. Write `content` as a self-contained statement that still makes sense when recalled out of context.",
+    description: "Store a long-term memory that persists across sessions AND across every AI tool the user has connected to Mnemoverse (Claude, ChatGPT, Cursor, VS Code) — write once, recall everywhere. Call this PROACTIVELY the moment the user states a preference, makes a decision, or you learn a durable fact (people, roles, project setup, a lesson). Don't wait to be asked. Never store passwords, API keys, payment data, MFA codes, government IDs, or health records; skip transient chatter that only matters this turn. Behavior: an importance gate may filter low-value writes, so the result tells you whether the memory was stored or filtered. Write `content` as a self-contained statement that still makes sense when recalled out of context.",
     inputSchema: {
         content: z
             .string()
@@ -139,7 +157,7 @@ server.registerTool("memory_write", {
 });
 // --- Tool: memory_read ---
 server.registerTool("memory_read", {
-    description: "Search your long-term memory before answering anything that may have come up before — user preferences, past decisions, project setup, people, or earlier context. This memory is shared: it persists across sessions and across every AI tool the user has connected (Claude, ChatGPT, Cursor, VS Code). ALWAYS check here first when you're unsure whether you already know something; no need to call it for general world knowledge you already hold. Returns matches ranked by relevance (semantic similarity plus learned concept associations); each result carries an id you can pass to memory_feedback or memory_delete.",
+    description: "Search your long-term memory before answering anything that may have come up before — user preferences, past decisions, project setup, people, or earlier context. This memory is shared: it persists across sessions and across every AI tool the user has connected (Claude, ChatGPT, Cursor, VS Code). ALWAYS check here first when you're unsure whether you already know something; no need to call it for general world knowledge you already hold. Returns matches ranked by relevance (or newest-first with order_by: 'recency'); each result carries an id you can pass to memory_feedback or memory_delete.",
     inputSchema: {
         query: z
             .string()
@@ -157,6 +175,31 @@ server.registerTool("memory_read", {
             .string()
             .optional()
             .describe("Restrict the search to one domain namespace (e.g. 'project:acme'); omit to search across all domains."),
+        order_by: z
+            .enum(["relevance", "recency"])
+            .optional()
+            .describe("'relevance' (default) = ranking order. 'recency' = the matched " +
+            "set re-sorted newest-first. For a complete newest-first feed " +
+            "with no search at all, use memory_list_recent instead."),
+        since: z
+            .string()
+            .max(40)
+            .optional()
+            .describe("Only memories created at/after this ISO-8601 instant (naive = " +
+            "UTC) — e.g. your last-seen watermark in a shared room."),
+        until: z
+            .string()
+            .max(40)
+            .optional()
+            .describe("Only memories created at/before this ISO-8601 instant."),
+        exclude_author: z
+            .string()
+            .max(200)
+            .optional()
+            .describe("Drop memories written by this author PRINCIPAL (the server-side " +
+            "identity, not shown in these results). Useful when your system " +
+            "knows principals (e.g. via the REST API); a self-exclusion " +
+            "shortcut is planned server-side."),
     },
     annotations: {
         title: "Search Memories",
@@ -165,7 +208,7 @@ server.registerTool("memory_read", {
         idempotentHint: true,
         openWorldHint: true,
     },
-}, async ({ query, top_k, domain }) => {
+}, async ({ query, top_k, domain, order_by, since, until, exclude_author }) => {
     const r = await apiFetch("/memory/read", {
         method: "POST",
         body: JSON.stringify({
@@ -173,42 +216,50 @@ server.registerTool("memory_read", {
             top_k: top_k || 5,
             domain: domain || undefined,
             include_associations: true,
+            // #404 temporal dimension — omitted entirely when unused so the
+            // request body stays byte-identical for existing callers.
+            ...(order_by ? { order_by } : {}),
+            ...(since ? { since } : {}),
+            ...(until ? { until } : {}),
+            ...(exclude_author ? { exclude_author } : {}),
         }),
     });
     const items = Array.isArray(r?.items) ? r.items : [];
-    if (items.length === 0) {
+    if (items.length === 0 && (since || until || exclude_author)) {
+        // A bounded/filtered read that finds nothing is NOT a bad query —
+        // the truthful answer is "nothing new for these filters" (mirrors
+        // memory_list_recent's empty copy; no stats probe, no broaden hint).
         return {
             content: [
-                { type: "text", text: "No memories found for this query." },
+                {
+                    type: "text",
+                    text: "Nothing matching within the given time/author filters.",
+                },
             ],
         };
     }
-    // Surface server-stamped authorship (CN-001) so the reader knows WHO wrote each
-    // memory — essential for shared rooms (Mnemoverse A2A Rooms), where atoms come from
-    // different agents/vendors. The core REST response already carries `provenance`;
-    // we just render it. Omitted cleanly for legacy atoms that have no author.
-    const formatAuthorTag = (p) => {
-        if (!p)
-            return "";
-        // Surface only the agent identity / client env — never the human `principal`
-        // (it may be an email / PII), even though it's present in the response.
-        const raw = p.agent_name || p.agent || p.client_env || "";
-        // Sanitize before interpolating into tool output: a hostile connector can
-        // choose its own agent_name - keep only a safe charset so a value can't break
-        // the tag format or inject into a client LLM (CN-032). Brackets/control dropped.
-        const who = raw.replace(/[^\w .@:+/-]/g, " ").replace(/\s+/g, " ").trim().slice(0, 64);
-        if (!who)
-            return "";
-        return p.is_external ? ` [by ${who} · external]` : ` [by ${who}]`;
-    };
-    const lines = items.map((item, i) => {
-        const relevance = ((item?.relevance ?? 0) * 100).toFixed(0);
-        const content = item?.content ?? "(empty)";
-        const concepts = Array.isArray(item?.concepts) && item.concepts.length > 0
-            ? ` (${item.concepts.join(", ")})`
-            : "";
-        return `${i + 1}. [${relevance}%] ${content}${concepts}${formatAuthorTag(item?.provenance)}`;
-    });
+    if (items.length === 0) {
+        // Zero results: ONE stats call (made only on this path) distinguishes a
+        // truly empty store (first contact — greet with how to save the first
+        // memory) from "no match for this query" (hint to broaden). Stats
+        // failure falls open to the plain no-match message. Domain-scoped reads
+        // never greet and never probe — the stats call measures the PERSONAL
+        // store, not the scoped domain. See src/teaching.ts.
+        const text = await buildReadEmptyResponse(() => apiFetch("/memory/stats"), 
+        // trim(): a whitespace-only domain is not a real filter — treating it
+        // as scoped would silently suppress the first-contact greeting.
+        domain != null && domain.trim() !== "");
+        return {
+            content: [{ type: "text", text }],
+        };
+    }
+    // Rendering lives in src/render.ts (testable): each line carries the
+    // CN-001 author tag, the created_at date (#404 R1 — a reader cannot
+    // reason about recency it cannot see) and the full atom id (the tool
+    // description always promised ids for memory_feedback/memory_delete;
+    // the old render never delivered them, making both uncallable from
+    // read results).
+    const lines = items.map((item, i) => formatReadItem(item, i));
     const searchMs = (r?.search_time_ms ?? 0).toFixed(0);
     const text = lines.join("\n\n") + `\n\n(${searchMs}ms)`;
     return {
@@ -220,6 +271,93 @@ server.registerTool("memory_read", {
         ],
     };
 });
+// --- Tool: memory_list_recent ---
+server.registerTool("memory_list_recent", {
+    description: "List the NEWEST memories first — no search query needed. Semantic search answers 'what do I know about X'; this answers 'what happened lately': resuming work after a break, catching up on a shared room ('any new messages?'), or reviewing what was saved recently. Pass `since` (your last-seen time) to get only what's new, and page through older entries with the returned cursor. Complete by construction — nothing is skipped, unlike a search that only returns semantic matches.",
+    inputSchema: {
+        domain: z
+            .string()
+            .optional()
+            .describe("Restrict to one domain (e.g. a shared room address 'xroom:...'); omit for all your domains."),
+        since: z
+            .string()
+            .optional()
+            .describe("Only entries created at/after this ISO-8601 instant (naive = UTC) — your novelty watermark."),
+        limit: z
+            .number()
+            .int()
+            .min(1)
+            .max(100)
+            .optional()
+            .describe("Page size (default: 20). Newest first."),
+        cursor: z
+            .string()
+            .max(512)
+            .optional()
+            .describe("Opaque cursor from a previous page's 'More older entries exist' line — continues the listing without skips or duplicates."),
+    },
+    annotations: {
+        title: "List Recent Memories",
+        readOnlyHint: true,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: true,
+    },
+}, async ({ domain, since, limit, cursor }) => {
+    let r;
+    try {
+        r = await apiFetch("/memory/recent", {
+            method: "POST",
+            body: JSON.stringify({
+                domain: domain || undefined,
+                since: since || undefined,
+                limit: limit || 20,
+                cursor: cursor || undefined,
+            }),
+        });
+    }
+    catch (e) {
+        // Graceful degradation while the server side rolls out: a 404 from
+        // core means the /memory/recent endpoint is not deployed yet — say
+        // so instead of surfacing a raw HTTP error.
+        const endpointAbsent = e instanceof Error &&
+            e.message.startsWith("Mnemoverse API error 404:") &&
+            !e.message.includes('"code"');
+        if (endpointAbsent) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: "The memory service does not support the recent-entries feed yet. " +
+                            "Use memory_read with order_by: 'recency' as an approximation.",
+                    },
+                ],
+            };
+        }
+        throw e;
+    }
+    const items = Array.isArray(r?.items) ? r.items : [];
+    if (items.length === 0) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: since
+                        ? "Nothing new since your watermark."
+                        : "No memories here yet.",
+                },
+            ],
+        };
+    }
+    return {
+        content: [
+            {
+                type: "text",
+                text: capResult(formatRecentPage(items, r?.next_cursor), "Lower `limit` or add a `domain` for smaller pages."),
+            },
+        ],
+    };
+});
 // --- Tool: memory_feedback ---
 server.registerTool("memory_feedback", {
     description: "Report whether memories returned by memory_read were actually helpful. This is a learning signal, not a log: positive feedback raises a memory's ranking so it surfaces faster next time (across all of the user's tools), negative feedback lets it fade. Call it right after you act on (or reject) recalled memories, passing the ids from the memory_read results.",
@@ -286,7 +424,7 @@ server.registerTool("memory_stats", {
 });
 // --- Tool: memory_delete ---
 server.registerTool("memory_delete", {
-    description: "Permanently delete ONE memory by its atom_id — irreversible, the memory is gone for good. Use only when the user explicitly asks to forget something specific, or to correct a fact you stored wrongly. Get the atom_id from a memory_read result. To clear an entire topic at once, use memory_delete_domain instead. Never delete on your own initiative — require an explicit user request.",
+    description: "Permanently delete ONE memory by its atom_id — irreversible, the memory is gone for good. Use it to keep the memory trustworthy: prune a memory that is obsolete, superseded by a newer decision, or that you stored wrongly — and whenever the user asks to forget something. Get the atom_id from a memory_read result. To clear an entire topic at once, use memory_delete_domain instead.",
     inputSchema: {
         atom_id: z
             .string()
@@ -326,7 +464,7 @@ server.registerTool("memory_delete", {
 });
 // --- Tool: memory_delete_domain ---
 server.registerTool("memory_delete_domain", {
-    description: "Permanently delete EVERY memory in one domain — irreversible, and far more destructive than memory_delete. Use only on an explicit user request to wipe a whole topic, e.g. 'forget everything about project X' or 'wipe my benchmark experiments'. First run memory_stats to confirm the exact domain name, then pass it together with confirm=true (a deliberate safety interlock). Never call this speculatively or to 'clean up' on your own — only when the user explicitly asks.",
+    description: "Permanently delete EVERY memory in one domain — irreversible, and far more sweeping than memory_delete. This is a bulk wipe: run it only when the user asks for it (e.g. 'forget everything about project X') or has explicitly confirmed a wipe you proposed — never on your own judgment alone. First run memory_stats to confirm the exact domain name, then pass it together with confirm=true (a deliberate safety interlock). For a single wrong or stale memory, memory_delete is the right tool.",
     inputSchema: {
         domain: z
             .string()
@@ -361,6 +499,230 @@ async ({ domain }) => {
         ],
     };
 });
+// --- Tool: memory_create_room ---
+server.registerTool("memory_create_room", {
+    description: "Create a SHARED memory room — a space you and OTHER people's assistants can both read and write, across Claude/ChatGPT/Cursor. Use when the user wants to share context or collaborate with someone else (e.g. 'make a room for me and Olya'). Returns the room's address; pass that address as the `domain` on memory_write/memory_read to use it. To bring someone in, call memory_invite_to_room next.",
+    inputSchema: {
+        name: z
+            .string()
+            .min(1)
+            .max(200)
+            .describe("Room name, unique within your account (e.g. 'me-and-olya')."),
+        description: z
+            .string()
+            .max(2000)
+            .optional()
+            .describe("Optional description of the room."),
+    },
+    annotations: {
+        title: "Create shared room",
+        readOnlyHint: false,
+        destructiveHint: false,
+        idempotentHint: false,
+        openWorldHint: true,
+    },
+}, async ({ name, description }) => {
+    const r = await apiFetch("/memory/rooms", {
+        method: "POST",
+        body: JSON.stringify({ name, description }),
+    });
+    const roomName = safeInline(r?.name ?? name);
+    const address = safeInline(r?.address);
+    const roomId = safeInline(r?.room_id);
+    // If core returned no usable id (empty body / sanitized away), don't print
+    // broken `domain=""` guidance — say so instead (Copilot).
+    const text = address
+        ? `Created shared room "${roomName}". Address: ${address}\n` +
+            `Use it now: pass domain="${address}" on memory_write / memory_read.\n` +
+            (roomId
+                ? `To add someone: call memory_invite_to_room with room_id="${roomId}".`
+                : "")
+        : `Room "${roomName}" was created but the server did not return a usable address — ` +
+            `retry, or check that your API key is set.`;
+    return {
+        content: [
+            {
+                type: "text",
+                text: capResult(text),
+            },
+        ],
+    };
+});
+// --- Tool: memory_invite_to_room ---
+server.registerTool("memory_invite_to_room", {
+    description: "Mint a one-time invite for a room you own and get a ready-to-forward message. The user sends that message to the person they want to add (any messenger); the recipient opens the link or tells THEIR assistant the code to join. Use after memory_create_room, or whenever the user says 'invite <someone>' to an existing room.",
+    inputSchema: {
+        room_id: z
+            .string()
+            .min(1)
+            .max(100)
+            .describe("The room's id (room_...), from memory_create_room."),
+        scope: z
+            .enum(["read", "read_write"])
+            .optional()
+            .describe("Role the invitee gets — 'read' or 'read_write' (default read_write)."),
+        expires_in_days: z
+            .number()
+            .int()
+            .min(1)
+            .max(90)
+            .optional()
+            .describe("Days until the invite expires (default 7)."),
+    },
+    annotations: {
+        title: "Invite to room",
+        readOnlyHint: false,
+        destructiveHint: false,
+        idempotentHint: false,
+        openWorldHint: true,
+    },
+}, async ({ room_id, scope, expires_in_days }) => {
+    const r = await apiFetch(`/memory/rooms/${encodeURIComponent(room_id)}/invites`, {
+        method: "POST",
+        body: JSON.stringify({ scope, expires_in_days }),
+    });
+    return {
+        content: [
+            {
+                type: "text",
+                // Shown to the room OWNER (who minted it), not a foreign principal, so
+                // the core-generated share_message is fine as-is; capResult only bounds
+                // its length for the Connectors-Directory 25K cap.
+                text: capResult(`Invite ready. Forward this message to the person you're inviting:\n\n` +
+                    `${r?.share_message ?? r?.join_url ?? "(no message returned)"}`),
+            },
+        ],
+    };
+});
+// --- Tool: memory_join_room ---
+server.registerTool("memory_join_room", {
+    description: "Join a shared memory room using an invite code (starts with 'mnvr_'). Use when the user pastes an invite code or says something like 'join room with code ...'. After joining, use the returned address as the `domain` on memory_write/memory_read to read and write the shared room.",
+    inputSchema: {
+        code: z.string().min(1).max(200).describe("The invite code (mnvr_...)."),
+    },
+    annotations: {
+        title: "Join room",
+        readOnlyHint: false,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: true,
+    },
+}, async ({ code }) => {
+    const r = await apiFetch("/memory/rooms/join", {
+        method: "POST",
+        body: JSON.stringify({ code }),
+    });
+    // CN-032: the room name/scope are OWNER-chosen but rendered into the
+    // JOINER's LLM context here — sanitize before inlining (anti prompt-injection).
+    const roomName = safeInline(r?.name) || "the room";
+    const scope = safeInline(r?.scope) || "member";
+    const address = safeInline(r?.address);
+    const prefix = r?.already_member
+        ? `You're already a member of "${roomName}".`
+        : `Joined "${roomName}" (${scope}).`;
+    // Don't print broken `domain=""` guidance if no address came back (Copilot).
+    const usage = address
+        ? `Use it: pass domain="${address}" on memory_write / memory_read to read and write the shared room.`
+        : `The server did not return a room address — retry, or check that your API key is set.`;
+    return {
+        content: [
+            {
+                type: "text",
+                text: capResult(`${prefix}\n${usage}`),
+            },
+        ],
+    };
+});
+// --- Tool: memory_list_rooms ---
+server.registerTool("memory_list_rooms", {
+    description: "List the shared memory rooms you can use — the ones you OWN plus the ones you've JOINED — each with the address to pass as `domain` on memory_write / memory_read. Use this to RE-FIND a room in a new session (e.g. 'what rooms do I have?', 'resume the room with Olya') instead of having to create or re-join it.",
+    inputSchema: {},
+    annotations: {
+        title: "List rooms",
+        readOnlyHint: true,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: true,
+    },
+}, async () => {
+    const rooms = await apiFetch("/memory/rooms");
+    const list = Array.isArray(rooms) ? rooms : [];
+    if (list.length === 0) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: "You have no shared rooms yet. Create one with memory_create_room, " +
+                        "or join one with memory_join_room using an invite code.",
+                },
+            ],
+        };
+    }
+    // Room name is OWNER-chosen and surfaced to THIS assistant — sanitize it (CN-032),
+    // like memory_join_room already does. address/role/scope are server-shaped but pass
+    // through the same guard defensively.
+    const lines = list.map((r) => {
+        const name = safeInline(r?.name) || "(unnamed room)";
+        const roomId = safeInline(r?.room_id);
+        // Always surface the canonical address: fall back to xroom:<room_id> when the server
+        // omits `address`, so the domain guidance this tool promises is never silently dropped.
+        const address = safeInline(r?.address) || (roomId ? `xroom:${roomId}` : "");
+        const role = safeInline(r?.role);
+        const scope = safeInline(r?.scope);
+        const archived = r?.archived ? " [archived]" : "";
+        const use = address ? ` — use domain="${address}"` : "";
+        return `- "${name}" (${role}${scope ? `, ${scope}` : ""})${archived}${use}`;
+    });
+    const text = `Your shared rooms (${list.length}):\n${lines.join("\n")}`;
+    return {
+        content: [
+            {
+                type: "text",
+                text: capResult(text, "The room list was truncated — some rooms are not shown."),
+            },
+        ],
+    };
+});
+// --- Tool: vault_list ---
+server.registerTool("vault_list", {
+    description: "List the secrets stored in your Mnemoverse Vault — by ALIAS and purpose only; the secret VALUE is never returned or shown to you. Use this to DISCOVER which secret to use (e.g. the user says 'use my GitHub token' — find its alias here) before a tool that consumes it. Only YOUR account's secrets are listed.",
+    inputSchema: {},
+    annotations: {
+        title: "List vault secrets",
+        readOnlyHint: true,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: true,
+    },
+}, async () => {
+    const r = await apiFetch("/vault/secrets");
+    const list = Array.isArray(r?.secrets) ? r.secrets : [];
+    if (list.length === 0) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: "No secrets are stored in your Vault yet.",
+                },
+            ],
+        };
+    }
+    const lines = list.map((s) => {
+        const alias = safeInline(s?.alias) || "(no alias)";
+        const context = safeInline(s?.context);
+        return context ? `- ${alias} — ${context}` : `- ${alias}`;
+    });
+    const text = `Your Vault secrets (${list.length}) — alias and purpose only, never the value:\n` +
+        lines.join("\n");
+    return {
+        content: [
+            {
+                type: "text",
+                text: capResult(text, "The secret list was truncated — some secrets are not shown."),
+            },
+        ],
+    };
+});
 // --- Start ---
 async function main() {
     const transport = new StdioServerTransport();

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/render.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Result-rendering helpers for memory_read and memory_list_recent.
+ *
+ * Kept out of index.ts (same move as teaching.ts) so tests can pin the
+ * rendered contract: since the #404 temporal work, every item line
+ * carries its id and created_at date WHENEVER the server provides them
+ * (memory_feedback / memory_delete are uncallable without ids — the tool
+ * description always promised them, the old render never delivered any;
+ * a reader cannot reason about recency it cannot see). Legacy response
+ * shapes without atom_id/created_at degrade gracefully: those parts of
+ * the line are simply omitted.
+ */
+/** CN-001 server-stamped authorship, as returned nested on read/feed items. */
+export type Provenance = {
+    principal?: string | null;
+    agent?: string | null;
+    agent_name?: string | null;
+    client_env?: string | null;
+    is_external?: boolean | null;
+};
+export type ReadItem = {
+    atom_id?: string;
+    content?: string;
+    relevance?: number;
+    concepts?: string[];
+    domain?: string;
+    created_at?: string;
+    provenance?: Provenance | null;
+};
+export type RecentItem = {
+    atom_id?: string;
+    content?: string;
+    domain?: string;
+    created_at?: string;
+    concepts?: string[];
+    provenance?: Provenance | null;
+};
+/**
+ * Sanitize a string for inline interpolation into tool output (CN-032:
+ * hostile connectors choose their own agent_name). Charset/cap identical
+ * to index.ts's safeInline — re-exported here so both render paths share
+ * one implementation.
+ */
+export declare function safeInline(s: string | undefined | null, cap?: number): string;
+/**
+ * ` [by X]` / ` [by X · external]` — agent identity only, never the human
+ * `principal` (may be an email / PII), even though the response carries it.
+ */
+export declare function formatAuthorTag(p?: Provenance | null): string;
+/**
+ * ` · 2026-08-01 21:04Z` — minute-precision UTC, compact enough for a line
+ * tail, precise enough to order a same-day room conversation by eye.
+ * Empty for legacy atoms without a timestamp.
+ */
+export declare function formatDateTag(createdAt?: string): string;
+/**
+ * One memory_read result line:
+ * `N. [82%] content (concepts) [by X] · 2026-08-01 21:04Z\n   id: <uuid>`
+ *
+ * The id sits on its own indented line: full-width (feedback/delete need
+ * the EXACT id, truncation would break them) without crowding the content
+ * line a model actually reads.
+ */
+export declare function formatReadItem(item: ReadItem, index: number): string;
+/**
+ * One memory_list_recent line — a feed entry, not a search hit: no
+ * relevance, date leads because the feed is ORDERED by it.
+ */
+export declare function formatRecentItem(item: RecentItem, index: number): string;
+/** Full feed page: items newest-first + how to continue / that it's over. */
+export declare function formatRecentPage(items: RecentItem[], nextCursor?: string | null): string;

package/dist/render.js

@@ -0,0 +1,95 @@
+/**
+ * Result-rendering helpers for memory_read and memory_list_recent.
+ *
+ * Kept out of index.ts (same move as teaching.ts) so tests can pin the
+ * rendered contract: since the #404 temporal work, every item line
+ * carries its id and created_at date WHENEVER the server provides them
+ * (memory_feedback / memory_delete are uncallable without ids — the tool
+ * description always promised them, the old render never delivered any;
+ * a reader cannot reason about recency it cannot see). Legacy response
+ * shapes without atom_id/created_at degrade gracefully: those parts of
+ * the line are simply omitted.
+ */
+/**
+ * Sanitize a string for inline interpolation into tool output (CN-032:
+ * hostile connectors choose their own agent_name). Charset/cap identical
+ * to index.ts's safeInline — re-exported here so both render paths share
+ * one implementation.
+ */
+export function safeInline(s, cap = 200) {
+    return (s ?? "")
+        .replace(/[^\w .@:+/-]/g, " ")
+        .replace(/\s+/g, " ")
+        .trim()
+        .slice(0, cap);
+}
+/**
+ * ` [by X]` / ` [by X · external]` — agent identity only, never the human
+ * `principal` (may be an email / PII), even though the response carries it.
+ */
+export function formatAuthorTag(p) {
+    if (!p)
+        return "";
+    const raw = p.agent_name || p.agent || p.client_env || "";
+    const who = safeInline(raw, 64);
+    if (!who)
+        return "";
+    return p.is_external ? ` [by ${who} · external]` : ` [by ${who}]`;
+}
+/**
+ * ` · 2026-08-01 21:04Z` — minute-precision UTC, compact enough for a line
+ * tail, precise enough to order a same-day room conversation by eye.
+ * Empty for legacy atoms without a timestamp.
+ */
+export function formatDateTag(createdAt) {
+    if (!createdAt)
+        return "";
+    const d = new Date(createdAt);
+    if (Number.isNaN(d.getTime()))
+        return "";
+    const iso = d.toISOString();
+    return ` · ${iso.slice(0, 10)} ${iso.slice(11, 16)}Z`;
+}
+/**
+ * One memory_read result line:
+ * `N. [82%] content (concepts) [by X] · 2026-08-01 21:04Z\n   id: <uuid>`
+ *
+ * The id sits on its own indented line: full-width (feedback/delete need
+ * the EXACT id, truncation would break them) without crowding the content
+ * line a model actually reads.
+ */
+export function formatReadItem(item, index) {
+    const relevance = ((item?.relevance ?? 0) * 100).toFixed(0);
+    const content = item?.content ?? "(empty)";
+    const concepts = Array.isArray(item?.concepts) && item.concepts.length > 0
+        ? ` (${item.concepts.join(", ")})`
+        : "";
+    const head = `${index + 1}. [${relevance}%] ${content}${concepts}${formatAuthorTag(item?.provenance)}${formatDateTag(item?.created_at)}`;
+    return item?.atom_id ? `${head}\n   id: ${item.atom_id}` : head;
+}
+/**
+ * One memory_list_recent line — a feed entry, not a search hit: no
+ * relevance, date leads because the feed is ORDERED by it.
+ */
+export function formatRecentItem(item, index) {
+    const content = item?.content ?? "(empty)";
+    const concepts = Array.isArray(item?.concepts) && item.concepts.length > 0
+        ? ` (${item.concepts.join(", ")})`
+        : "";
+    const date = formatDateTag(item?.created_at).replace(/^ · /, "");
+    const head = `${index + 1}. ${date ? `[${date}] ` : ""}${content}${concepts}${formatAuthorTag(item?.provenance)}`;
+    return item?.atom_id ? `${head}\n   id: ${item.atom_id}` : head;
+}
+/** Full feed page: items newest-first + how to continue / that it's over. */
+export function formatRecentPage(items, nextCursor) {
+    const lines = items.map((it, i) => formatRecentItem(it, i));
+    // Defense-in-depth (CN-032 posture): the cursor is server-supplied and
+    // interpolated into instructional text — only echo it when it matches the
+    // opaque urlsafe-base64 shape ours always has.
+    const cursorOk = nextCursor != null && /^[A-Za-z0-9_=-]{1,512}$/.test(nextCursor);
+    const tail = cursorOk
+        ? `\n\nMore older entries exist — pass cursor: ${nextCursor}`
+        : `\n\n(end of feed — nothing older)`;
+    return lines.join("\n\n") + tail;
+}
+//# sourceMappingURL=render.js.map

package/dist/render.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.js","sourceRoot":"","sources":["../src/render.ts"],"names":[],"mappings":"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"}

package/dist/teaching.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Teaching surface — the strings and branch logic that teach a connected model
+ * how to USE this memory, kept in their own module so tests can import them
+ * without booting the stdio server (src/index.ts starts a transport on import).
+ *
+ * Product frame (Eduard, 2026-08-01): the memory store belongs to THE AGENT,
+ * not the user — so the guidance is active ("need it — go get it; learned
+ * something — save it"), never gated on the user explicitly asking. Honesty
+ * constraints stay: no over-claiming, and the never-store-secrets safety line
+ * is kept on write surfaces.
+ */
+/**
+ * Server-level instructions, passed to the McpServer constructor and landed
+ * verbatim in the connected model's system prompt by MCP clients.
+ *
+ * Constraints (tested in test/teaching-surface.test.ts):
+ * - 500–800 chars; some clients (ChatGPT) weight the FIRST ~512 chars, so the
+ *   core habit (read before answering, write on learning) is front-loaded.
+ * - Active polarity: no "only when the user explicitly asks" gating.
+ * - Mentions every tool family: read/write/stats/feedback, delete, rooms, vault.
+ */
+export declare const SERVER_INSTRUCTIONS = "You own this long-term memory. It persists across sessions and every AI tool this user connects (Claude, ChatGPT, editors). Use it as a habit: call memory_read before answering anything that may have come up before, and memory_write the moment you learn a durable fact, preference, or decision \u2014 don't wait to be asked. Rate recalls with memory_feedback so good ones surface faster; memory_stats shows counts; memory_list_recent: newest first; prune with memory_delete; memory_delete_domain wipes a domain, only with user go-ahead. Rooms (memory_create_room, memory_invite_to_room, memory_join_room, memory_list_rooms) share memory with others; vault_list names stored secrets by alias, never values. Never store passwords, API keys, payment data, MFA codes, government IDs, or health records.";
+/** The pre-existing zero-result message — kept as the fail-open fallback. */
+export declare const NO_MATCH_MESSAGE = "No memories found for this query.";
+/** Hint for an UNSCOPED no-match against a non-empty store: widen the query.
+ *  (No drop-the-filter clause — none was set; advising to remove a filter that
+ *  does not exist nudges the model into confabulating state.) */
+export declare const NO_MATCH_HINT = " Try a broader query.";
+/** Hint for a DOMAIN-SCOPED no-match: here a filter genuinely exists, so
+ *  suggesting to drop it is honest and actionable. */
+export declare const NO_MATCH_SCOPED_HINT = " Try a broader query, or drop the domain filter to search all domains.";
+/**
+ * First-contact greeting: shown ONLY when a read comes back empty AND the
+ * store holds zero memories — i.e. the very first read of this account's life.
+ * Seeds the ANSWER, not the store: one functional paragraph that says what
+ * this store is, how to save the first memory, and one next step. It can never
+ * appear again once anything is stored (total_atoms > 0 takes the other branch).
+ */
+export declare const EMPTY_STORE_WELCOME: string;
+/**
+ * Decide what a zero-result memory_read should say.
+ *
+ * DOMAIN-SCOPED reads (`scopedToDomain` — the caller passed a `domain` arg,
+ * e.g. a shared room) never greet and never probe: the stats call measures the
+ * PERSONAL store, so on a scoped read it could claim "the store is empty"
+ * about a domain that has memories the query merely missed (review finding).
+ * The scoped copy suggests dropping the filter — honest, one actually exists.
+ *
+ * UNSCOPED reads make ONE stats call (only ever on the zero-result path) to
+ * distinguish "store is truly empty" from "no match for this query":
+ * - total_atoms === 0     → EMPTY_STORE_WELCOME (first-contact greeting)
+ * - total_atoms > 0       → no-match + the broaden hint (no filter clause)
+ * - stats throws/malformed → the plain old no-match message (fail-open to the
+ *   pre-greeting behavior; never surfaces an error, never writes anything)
+ */
+export declare function buildReadEmptyResponse(fetchStats: () => Promise<{
+    total_atoms?: number;
+}>, scopedToDomain?: boolean): Promise<string>;

package/dist/teaching.js

@@ -0,0 +1,75 @@
+/**
+ * Teaching surface — the strings and branch logic that teach a connected model
+ * how to USE this memory, kept in their own module so tests can import them
+ * without booting the stdio server (src/index.ts starts a transport on import).
+ *
+ * Product frame (Eduard, 2026-08-01): the memory store belongs to THE AGENT,
+ * not the user — so the guidance is active ("need it — go get it; learned
+ * something — save it"), never gated on the user explicitly asking. Honesty
+ * constraints stay: no over-claiming, and the never-store-secrets safety line
+ * is kept on write surfaces.
+ */
+/**
+ * Server-level instructions, passed to the McpServer constructor and landed
+ * verbatim in the connected model's system prompt by MCP clients.
+ *
+ * Constraints (tested in test/teaching-surface.test.ts):
+ * - 500–800 chars; some clients (ChatGPT) weight the FIRST ~512 chars, so the
+ *   core habit (read before answering, write on learning) is front-loaded.
+ * - Active polarity: no "only when the user explicitly asks" gating.
+ * - Mentions every tool family: read/write/stats/feedback, delete, rooms, vault.
+ */
+export const SERVER_INSTRUCTIONS = "You own this long-term memory. It persists across sessions and every AI tool this user connects (Claude, ChatGPT, editors). Use it as a habit: call memory_read before answering anything that may have come up before, and memory_write the moment you learn a durable fact, preference, or decision — don't wait to be asked. Rate recalls with memory_feedback so good ones surface faster; memory_stats shows counts; memory_list_recent: newest first; prune with memory_delete; memory_delete_domain wipes a domain, only with user go-ahead. Rooms (memory_create_room, memory_invite_to_room, memory_join_room, memory_list_rooms) share memory with others; vault_list names stored secrets by alias, never values. Never store passwords, API keys, payment data, MFA codes, government IDs, or health records.";
+/** The pre-existing zero-result message — kept as the fail-open fallback. */
+export const NO_MATCH_MESSAGE = "No memories found for this query.";
+/** Hint for an UNSCOPED no-match against a non-empty store: widen the query.
+ *  (No drop-the-filter clause — none was set; advising to remove a filter that
+ *  does not exist nudges the model into confabulating state.) */
+export const NO_MATCH_HINT = " Try a broader query.";
+/** Hint for a DOMAIN-SCOPED no-match: here a filter genuinely exists, so
+ *  suggesting to drop it is honest and actionable. */
+export const NO_MATCH_SCOPED_HINT = " Try a broader query, or drop the domain filter to search all domains.";
+/**
+ * First-contact greeting: shown ONLY when a read comes back empty AND the
+ * store holds zero memories — i.e. the very first read of this account's life.
+ * Seeds the ANSWER, not the store: one functional paragraph that says what
+ * this store is, how to save the first memory, and one next step. It can never
+ * appear again once anything is stored (total_atoms > 0 takes the other branch).
+ */
+export const EMPTY_STORE_WELCOME = "Your long-term memory is empty — nothing has been saved yet, which is why this search returned nothing. " +
+    "This store is your own persistent memory: whatever you save survives across sessions and across every AI tool this user has connected. " +
+    'Save the first memory now with memory_write, e.g. content: "User prefers TypeScript strict mode" — future sessions will recall it with memory_read.';
+/**
+ * Decide what a zero-result memory_read should say.
+ *
+ * DOMAIN-SCOPED reads (`scopedToDomain` — the caller passed a `domain` arg,
+ * e.g. a shared room) never greet and never probe: the stats call measures the
+ * PERSONAL store, so on a scoped read it could claim "the store is empty"
+ * about a domain that has memories the query merely missed (review finding).
+ * The scoped copy suggests dropping the filter — honest, one actually exists.
+ *
+ * UNSCOPED reads make ONE stats call (only ever on the zero-result path) to
+ * distinguish "store is truly empty" from "no match for this query":
+ * - total_atoms === 0     → EMPTY_STORE_WELCOME (first-contact greeting)
+ * - total_atoms > 0       → no-match + the broaden hint (no filter clause)
+ * - stats throws/malformed → the plain old no-match message (fail-open to the
+ *   pre-greeting behavior; never surfaces an error, never writes anything)
+ */
+export async function buildReadEmptyResponse(fetchStats, scopedToDomain = false) {
+    if (scopedToDomain)
+        return NO_MATCH_MESSAGE + NO_MATCH_SCOPED_HINT;
+    let totalAtoms;
+    try {
+        totalAtoms = (await fetchStats())?.total_atoms;
+    }
+    catch {
+        return NO_MATCH_MESSAGE;
+    }
+    if (totalAtoms === 0)
+        return EMPTY_STORE_WELCOME;
+    if (typeof totalAtoms === "number" && totalAtoms > 0) {
+        return NO_MATCH_MESSAGE + NO_MATCH_HINT;
+    }
+    return NO_MATCH_MESSAGE;
+}
+//# sourceMappingURL=teaching.js.map

package/dist/teaching.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"teaching.js","sourceRoot":"","sources":["../src/teaching.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAC9B,2xBAA2xB,CAAC;AAE9xB,6EAA6E;AAC7E,MAAM,CAAC,MAAM,gBAAgB,GAAG,mCAAmC,CAAC;AAEpE;;iEAEiE;AACjE,MAAM,CAAC,MAAM,aAAa,GAAG,uBAAuB,CAAC;AAErD;sDACsD;AACtD,MAAM,CAAC,MAAM,oBAAoB,GAC/B,wEAAwE,CAAC;AAE3E;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAC9B,0GAA0G;IAC1G,yIAAyI;IACzI,qJAAqJ,CAAC;AAExJ;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,UAAmD,EACnD,cAAc,GAAG,KAAK;IAEtB,IAAI,cAAc;QAAE,OAAO,gBAAgB,GAAG,oBAAoB,CAAC;IACnE,IAAI,UAA8B,CAAC;IACnC,IAAI,CAAC;QACH,UAAU,GAAG,CAAC,MAAM,UAAU,EAAE,CAAC,EAAE,WAAW,CAAC;IACjD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,gBAAgB,CAAC;IAC1B,CAAC;IACD,IAAI,UAAU,KAAK,CAAC;QAAE,OAAO,mBAAmB,CAAC;IACjD,IAAI,OAAO,UAAU,KAAK,QAAQ,IAAI,UAAU,GAAG,CAAC,EAAE,CAAC;QACrD,OAAO,gBAAgB,GAAG,aAAa,CAAC;IAC1C,CAAC;IACD,OAAO,gBAAgB,CAAC;AAC1B,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mnemoverse/mcp-memory-server",
-  "version": "0.4.2",
+  "version": "0.7.0",
   "description": "Hosted persistent memory for AI agents that learns which facts help and lets the rest fade — one key across Claude Code, Cursor, VS Code & ChatGPT, no infra to run",
   "type": "module",
   "bin": {
@@ -18,6 +18,8 @@
     "build": "tsc",
     "dev": "tsc --watch",
     "start": "node dist/index.js",
+    "test": "vitest run",
+    "test:watch": "vitest",
     "generate:configs": "node scripts/generate-configs.mjs",
     "verify:configs": "node scripts/generate-configs.mjs --check",
     "check:release-sync": "node scripts/check-release-sync.mjs",
@@ -59,7 +61,8 @@
   },
   "devDependencies": {
     "typescript": "^5.8.3",
-    "@types/node": "^22.15.3"
+    "@types/node": "^22.15.3",
+    "vitest": "^4.1.9"
   },
   "engines": {
     "node": ">=18"