@hasna/mementos 0.3.0 → 0.3.1

package/dist/mcp/index.js

@@ -4936,7 +4936,7 @@ function formatMemory(m) {
   return parts.join(`
 `);
 }
-server.tool("memory_save", "Save a memory (create or upsert). Use scope 'global' for all agents, 'shared' for project-level, 'private' for single agent.", {
+server.tool("memory_save", "Save/upsert a memory. scope: global=all agents, shared=project, private=single agent.", {
   key: exports_external.string().describe("Unique key for the memory"),
   value: exports_external.string().describe("Memory content/value"),
   scope: exports_external.enum(["global", "shared", "private"]).optional().describe("Memory scope (default: private)"),
@@ -4997,7 +4997,7 @@ ${formatMemory(best.memory)}`
     return { content: [{ type: "text", text: formatError(e) }], isError: true };
   }
 });
-server.tool("memory_list", "List memories with optional filters", {
+server.tool("memory_list", "List memories. Default: compact lines. full=true for complete JSON objects.", {
   scope: exports_external.enum(["global", "shared", "private"]).optional(),
   category: exports_external.enum(["preference", "fact", "knowledge", "history"]).optional(),
   tags: exports_external.array(exports_external.string()).optional(),
@@ -5008,19 +5008,25 @@ server.tool("memory_list", "List memories with optional filters", {
   session_id: exports_external.string().optional(),
   status: exports_external.enum(["active", "archived", "expired"]).optional(),
   limit: exports_external.coerce.number().optional().describe("Max results (default: 50)"),
-  offset: exports_external.coerce.number().optional()
+  offset: exports_external.coerce.number().optional(),
+  full: exports_external.boolean().optional().describe("Return full Memory objects as JSON instead of compact lines")
 }, async (args) => {
   try {
+    const { full, ...filterArgs } = args;
     const filter = {
-      ...args,
-      limit: args.limit || 50
+      ...filterArgs,
+      limit: filterArgs.limit || 50
     };
     const memories = listMemories(filter);
     if (memories.length === 0) {
-      return { content: [{ type: "text", text: "No memories found matching filters." }] };
+      return { content: [{ type: "text", text: "No memories found." }] };
     }
-    const lines = memories.map((m, i) => `${i + 1}. [${m.scope}/${m.category}] ${m.key} = ${m.value.slice(0, 100)}${m.value.length > 100 ? "..." : ""} (importance: ${m.importance}, id: ${m.id.slice(0, 8)})`);
-    return { content: [{ type: "text", text: `${memories.length} memor${memories.length === 1 ? "y" : "ies"} found:
+    if (full) {
+      const compact = memories.map((m) => Object.fromEntries(Object.entries(m).filter(([, v]) => v !== null && v !== undefined && v !== 0 && v !== "")));
+      return { content: [{ type: "text", text: JSON.stringify(compact, null, 2) }] };
+    }
+    const lines = memories.map((m, i) => `${i + 1}. [${m.scope}/${m.category}] ${m.key} = ${m.value.slice(0, 100)}${m.value.length > 100 ? "..." : ""} (imp:${m.importance} id:${m.id.slice(0, 8)})`);
+    return { content: [{ type: "text", text: `${memories.length} memories:
 ${lines.join(`
 `)}` }] };
   } catch (e) {
@@ -5195,7 +5201,7 @@ server.tool("memory_import", "Import memories from JSON array", {
     return { content: [{ type: "text", text: formatError(e) }], isError: true };
   }
 });
-server.tool("memory_inject", "Get formatted memory context for injection into agent system prompts. Selects most relevant memories by scope, importance, and recency.", {
+server.tool("memory_inject", "Get memory context for system prompt injection. Selects by scope, importance, recency.", {
   agent_id: exports_external.string().optional().describe("Agent ID for scope filtering"),
   project_id: exports_external.string().optional().describe("Project ID for scope filtering"),
   session_id: exports_external.string().optional().describe("Session ID for scope filtering"),
@@ -5274,7 +5280,7 @@ ${lines.join(`
     return { content: [{ type: "text", text: formatError(e) }], isError: true };
   }
 });
-server.tool("register_agent", "Register an agent and get a short UUID. Idempotent: same name returns existing agent.", {
+server.tool("register_agent", "Register an agent. Idempotent \u2014 same name returns existing agent.", {
   name: exports_external.string().describe("Agent name"),
   description: exports_external.string().optional().describe("Agent description"),
   role: exports_external.string().optional().describe("Agent role")
@@ -5334,7 +5340,7 @@ Last seen: ${agent.last_seen_at}`
     return { content: [{ type: "text", text: formatError(e) }], isError: true };
   }
 });
-server.tool("update_agent", "Update an agent's name, description, role, or metadata. Agents can update themselves.", {
+server.tool("update_agent", "Update agent name, description, role, or metadata.", {
   id: exports_external.string().describe("Agent ID or name"),
   name: exports_external.string().optional().describe("New agent name"),
   description: exports_external.string().optional().describe("New description"),
@@ -5442,7 +5448,7 @@ server.tool("clean_expired", "Remove expired memories from the database", {}, as
     return { content: [{ type: "text", text: formatError(e) }], isError: true };
   }
 });
-server.tool("memory_context", "Get all memories relevant to the current context. Smart selection by scope visibility, importance, and recency.", {
+server.tool("memory_context", "Get memories relevant to current context, filtered by scope/importance/recency.", {
   agent_id: exports_external.string().optional(),
   project_id: exports_external.string().optional(),
   scope: exports_external.enum(["global", "shared", "private"]).optional().describe("Limit to specific scope"),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hasna/mementos",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "Universal memory system for AI agents - CLI + MCP server + library API",
   "type": "module",
   "main": "dist/index.js",