@hasna/mementos 0.3.0 → 0.3.2

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)"),
@@ -4954,8 +4954,7 @@ server.tool("memory_save", "Save a memory (create or upsert). Use scope 'global'
   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 };
   }
@@ -4997,7 +4996,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(),
@@ -5007,20 +5006,36 @@ server.tool("memory_list", "List memories with optional filters", {
   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)"),
-  offset: exports_external.coerce.number().optional()
+  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"),
+  fields: exports_external.array(exports_external.string()).optional().describe("Filter fields in full mode: e.g. ['key','value','importance']")
 }, async (args) => {
   try {
+    const { full, fields, ...filterArgs } = args;
     const filter = {
-      ...args,
-      limit: args.limit || 50
+      ...filterArgs,
+      limit: filterArgs.limit || 10
     };
     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." }] };
+    }
+    if (full) {
+      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 ? "..." : ""} (importance: ${m.importance}, id: ${m.id.slice(0, 8)})`);
-    return { content: [{ type: "text", text: `${memories.length} memor${memories.length === 1 ? "y" : "ies"} found:
+    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 +5210,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 +5289,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 +5349,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 +5457,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"),
@@ -5467,6 +5482,51 @@ server.tool("memory_context", "Get all memories relevant to the current context.
     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.0",
+  "version": "0.3.2",
   "description": "Universal memory system for AI agents - CLI + MCP server + library API",
   "type": "module",
   "main": "dist/index.js",