@hasna/mementos 0.3.1 → 0.3.2

package/dist/mcp/index.js

@@ -4954,8 +4954,7 @@ server.tool("memory_save", "Save/upsert a memory. scope: global=all agents, shar
   try {
     ensureAutoProject();
     const memory = createMemory(args);
-    return { content: [{ type: "text", text: `Memory saved:
-${formatMemory(memory)}` }] };
+    return { content: [{ type: "text", text: `Saved: ${memory.key} (${memory.id.slice(0, 8)})` }] };
   } catch (e) {
     return { content: [{ type: "text", text: formatError(e) }], isError: true };
   }
@@ -5007,22 +5006,32 @@ server.tool("memory_list", "List memories. Default: compact lines. full=true for
   project_id: exports_external.string().optional(),
   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)"),
+  limit: exports_external.coerce.number().optional().describe("Max results (default: 10)"),
   offset: exports_external.coerce.number().optional(),
-  full: exports_external.boolean().optional().describe("Return full Memory objects as JSON instead of compact lines")
+  full: exports_external.boolean().optional().describe("Return full Memory objects as JSON instead of compact lines"),
+  fields: exports_external.array(exports_external.string()).optional().describe("Filter fields in full mode: e.g. ['key','value','importance']")
 }, async (args) => {
   try {
-    const { full, ...filterArgs } = args;
+    const { full, fields, ...filterArgs } = args;
     const filter = {
       ...filterArgs,
-      limit: filterArgs.limit || 50
+      limit: filterArgs.limit || 10
     };
     const memories = listMemories(filter);
     if (memories.length === 0) {
       return { content: [{ type: "text", text: "No memories found." }] };
     }
     if (full) {
-      const compact = memories.map((m) => Object.fromEntries(Object.entries(m).filter(([, v]) => v !== null && v !== undefined && v !== 0 && v !== "")));
+      const compact = memories.map((m) => {
+        const obj = Object.fromEntries(Object.entries(m).filter(([k, v]) => {
+          if (v === null || v === undefined)
+            return false;
+          if (fields && fields.length > 0)
+            return fields.includes(k);
+          return true;
+        }));
+        return obj;
+      });
       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)})`);
@@ -5473,6 +5482,51 @@ server.tool("memory_context", "Get memories relevant to current context, filtere
     return { content: [{ type: "text", text: formatError(e) }], isError: true };
   }
 });
+var TOOL_REGISTRY = [
+  { name: "memory_save", description: "Save/upsert a memory. scope: global=all agents, shared=project, private=single agent.", category: "memory" },
+  { name: "memory_recall", description: "Recall a memory by key. Returns the best matching active memory.", category: "memory" },
+  { name: "memory_list", description: "List memories. Default: compact lines. full=true for complete JSON objects.", category: "memory" },
+  { name: "memory_update", description: "Update a memory's metadata (value, importance, tags, etc.)", category: "memory" },
+  { name: "memory_forget", description: "Delete a memory by ID or key", category: "memory" },
+  { name: "memory_search", description: "Search memories by keyword across key, value, summary, and tags", category: "memory" },
+  { name: "memory_stats", description: "Get aggregate statistics about stored memories", category: "memory" },
+  { name: "memory_export", description: "Export memories as JSON", category: "memory" },
+  { name: "memory_import", description: "Import memories from JSON array", category: "memory" },
+  { name: "memory_inject", description: "Get memory context for system prompt injection. Selects by scope, importance, recency.", category: "memory" },
+  { name: "memory_context", description: "Get memories relevant to current context, filtered by scope/importance/recency.", category: "memory" },
+  { name: "register_agent", description: "Register an agent. Idempotent \u2014 same name returns existing agent.", category: "agent" },
+  { name: "list_agents", description: "List all registered agents", category: "agent" },
+  { name: "get_agent", description: "Get agent details by ID or name", category: "agent" },
+  { name: "update_agent", description: "Update agent name, description, role, or metadata.", category: "agent" },
+  { name: "register_project", description: "Register a project for memory scoping", category: "project" },
+  { name: "list_projects", description: "List all registered projects", category: "project" },
+  { name: "bulk_forget", description: "Delete multiple memories by IDs", category: "bulk" },
+  { name: "bulk_update", description: "Update multiple memories with the same changes", category: "bulk" },
+  { name: "clean_expired", description: "Remove expired memories from the database", category: "utility" },
+  { name: "search_tools", description: "Search available tools by name or keyword. Returns names only.", category: "meta" },
+  { name: "describe_tools", description: "Get full schemas for specific tools by name.", category: "meta" }
+];
+server.tool("search_tools", "Search available tools by name or keyword. Returns names only.", {
+  query: exports_external.string().describe("Search term to match against tool names and descriptions"),
+  category: exports_external.enum(["memory", "agent", "project", "bulk", "utility", "meta"]).optional()
+}, async (args) => {
+  const q = args.query.toLowerCase();
+  const results = TOOL_REGISTRY.filter((t) => (!args.category || t.category === args.category) && (t.name.includes(q) || t.description.toLowerCase().includes(q)));
+  if (results.length === 0)
+    return { content: [{ type: "text", text: "No tools found." }] };
+  return { content: [{ type: "text", text: results.map((t) => `${t.name} [${t.category}]`).join(`
+`) }] };
+});
+server.tool("describe_tools", "Get full schemas for specific tools by name.", {
+  names: exports_external.array(exports_external.string()).describe("Tool names to describe")
+}, async (args) => {
+  const found = TOOL_REGISTRY.filter((t) => args.names.includes(t.name));
+  if (found.length === 0)
+    return { content: [{ type: "text", text: "No matching tools." }] };
+  const lines = found.map((t) => `**${t.name}** [${t.category}]: ${t.description}`);
+  return { content: [{ type: "text", text: lines.join(`
+`) }] };
+});
 server.resource("memories", "mementos://memories", { description: "All active memories", mimeType: "application/json" }, async () => {
   const memories = listMemories({ status: "active", limit: 1000 });
   return { contents: [{ uri: "mementos://memories", text: JSON.stringify(memories, null, 2), mimeType: "application/json" }] };

package/package.json

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