@hasna/mementos 0.4.4 → 0.4.5

package/dist/mcp/index.js

@@ -6129,6 +6129,21 @@ ${formatMemory(best.memory)}`
     return { content: [{ type: "text", text: formatError(e) }], isError: true };
   }
 });
+server.tool("memory_get", "Get a single memory by ID.", {
+  id: exports_external.string()
+}, async (args) => {
+  try {
+    const id = resolveId(args.id);
+    const memory = getMemory(id);
+    if (!memory) {
+      return { content: [{ type: "text", text: `Memory not found: ${args.id}` }] };
+    }
+    touchMemory(memory.id);
+    return { content: [{ type: "text", text: formatMemory(memory) }] };
+  } catch (e) {
+    return { content: [{ type: "text", text: formatError(e) }], isError: true };
+  }
+});
 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(),
@@ -6350,6 +6365,7 @@ server.tool("memory_inject", "Get memory context for system prompt injection. Se
   max_tokens: exports_external.coerce.number().optional(),
   categories: exports_external.array(exports_external.enum(["preference", "fact", "knowledge", "history"])).optional(),
   min_importance: exports_external.coerce.number().optional(),
+  format: exports_external.enum(["xml", "markdown", "compact", "json"]).optional(),
   raw: exports_external.boolean().optional()
 }, async (args) => {
   try {
@@ -6403,8 +6419,16 @@ server.tool("memory_inject", "Get memory context for system prompt injection. Se
     const charBudget = maxTokens * 4;
     const lines = [];
     let totalChars = 0;
+    const fmt = args.format ?? (args.raw ? "compact" : "xml");
     for (const m of unique) {
-      const line = `- [${m.scope}/${m.category}] ${m.key}: ${m.value}`;
+      let line;
+      if (fmt === "compact") {
+        line = `${m.key}: ${m.value}`;
+      } else if (fmt === "json") {
+        line = JSON.stringify({ key: m.key, value: m.value, scope: m.scope, category: m.category, importance: m.importance });
+      } else {
+        line = `- [${m.scope}/${m.category}] ${m.key}: ${m.value}`;
+      }
       if (totalChars + line.length > charBudget)
         break;
       lines.push(line);
@@ -6414,11 +6438,23 @@ server.tool("memory_inject", "Get memory context for system prompt injection. Se
     if (lines.length === 0) {
       return { content: [{ type: "text", text: "No relevant memories found for injection." }] };
     }
-    const context = args.raw ? lines.join(`
-`) : `<agent-memories>
+    let context;
+    if (fmt === "compact") {
+      context = lines.join(`
+`);
+    } else if (fmt === "json") {
+      context = `[${lines.join(",")}]`;
+    } else if (fmt === "markdown") {
+      context = `## Agent Memories
+
+${lines.join(`
+`)}`;
+    } else {
+      context = `<agent-memories>
 ${lines.join(`
 `)}
 </agent-memories>`;
+    }
     return { content: [{ type: "text", text: context }] };
   } catch (e) {
     return { content: [{ type: "text", text: formatError(e) }], isError: true };
@@ -6566,6 +6602,29 @@ ${lines.join(`
     return { content: [{ type: "text", text: formatError(e) }], isError: true };
   }
 });
+server.tool("get_project", "Get a project by ID, path, or name.", {
+  id: exports_external.string()
+}, async (args) => {
+  try {
+    const project = getProject(args.id);
+    if (!project) {
+      return { content: [{ type: "text", text: `Project not found: ${args.id}` }] };
+    }
+    return {
+      content: [{
+        type: "text",
+        text: `Project:
+ID: ${project.id}
+Name: ${project.name}
+Path: ${project.path}
+Description: ${project.description || "-"}
+Created: ${project.created_at}`
+      }]
+    };
+  } catch (e) {
+    return { content: [{ type: "text", text: formatError(e) }], isError: true };
+  }
+});
 server.tool("bulk_forget", "Delete multiple memories by IDs", {
   ids: exports_external.array(exports_external.string())
 }, async (args) => {
@@ -6890,6 +6949,14 @@ var FULL_SCHEMAS = {
     },
     example: '{"key":"preferred-language","value":"TypeScript","scope":"global","importance":8,"tags":["language","preference"]}'
   },
+  memory_get: {
+    description: "Get a single memory by ID (partial IDs resolved).",
+    category: "memory",
+    params: {
+      id: { type: "string", description: "Memory ID (full or partial)", required: true }
+    },
+    example: '{"id":"abc12345"}'
+  },
   memory_recall: {
     description: "Recall a memory by exact key. Falls back to fuzzy search if no exact match.",
     category: "memory",
@@ -7003,9 +7070,10 @@ var FULL_SCHEMAS = {
       max_tokens: { type: "number", description: "Approximate token budget (default 500)" },
       categories: { type: "array", description: "Categories to include (default: preference, fact, knowledge)", items: { type: "string", enum: ["preference", "fact", "knowledge", "history"] } },
       min_importance: { type: "number", description: "Minimum importance (default 3)" },
-      raw: { type: "boolean", description: "true=plain lines only, false=wrapped in <agent-memories> tags" }
+      format: { type: "string", description: "Output format: xml (default, <agent-memories>), compact (key: value, ~60% smaller), markdown, json", enum: ["xml", "compact", "markdown", "json"] },
+      raw: { type: "boolean", description: "Deprecated: use format=compact instead. true=plain lines only" }
     },
-    example: '{"project_id":"proj-uuid","max_tokens":300,"min_importance":5}'
+    example: '{"project_id":"proj-uuid","max_tokens":300,"min_importance":5,"format":"compact"}'
   },
   memory_context: {
     description: "Get active memories for the current context (agent/project/scope).",
@@ -7080,6 +7148,14 @@ var FULL_SCHEMAS = {
     params: {},
     example: "{}"
   },
+  get_project: {
+    description: "Get a project by ID, path, or name.",
+    category: "project",
+    params: {
+      id: { type: "string", description: "Project ID, path, or name", required: true }
+    },
+    example: '{"id":"open-mementos"}'
+  },
   bulk_forget: {
     description: "Delete multiple memories by IDs in one call.",
     category: "bulk",

package/dist/server/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":";AACA;;;GAGG;AA87BH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAoG9C"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":";AACA;;;GAGG;AAy+BH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAoG9C"}

package/dist/server/index.js

@@ -2179,6 +2179,45 @@ addRoute("POST", "/api/memories/import", async (req) => {
   }
   return json({ imported, errors, total: memoriesArr.length }, 201);
 });
+addRoute("POST", "/api/memories/bulk-forget", async (req) => {
+  const body = await readJson(req);
+  if (!body || !Array.isArray(body["ids"])) {
+    return errorResponse("Missing required field: ids (array)", 400);
+  }
+  const ids = body["ids"];
+  let deleted = 0;
+  for (const id of ids) {
+    try {
+      if (deleteMemory(id))
+        deleted++;
+    } catch {}
+  }
+  return json({ deleted, total: ids.length });
+});
+addRoute("POST", "/api/memories/bulk-update", async (req) => {
+  const body = await readJson(req);
+  if (!body || !Array.isArray(body["ids"])) {
+    return errorResponse("Missing required fields: ids (array)", 400);
+  }
+  const ids = body["ids"];
+  const { ids: _ids, ...fields } = body;
+  let updated = 0;
+  const errors = [];
+  for (const id of ids) {
+    try {
+      const memory = getMemory(id);
+      if (memory) {
+        updateMemory(id, { ...fields, version: memory.version });
+        updated++;
+      } else {
+        errors.push(`Memory not found: ${id}`);
+      }
+    } catch (e) {
+      errors.push(`Failed ${id}: ${e instanceof Error ? e.message : String(e)}`);
+    }
+  }
+  return json({ updated, errors, total: ids.length });
+});
 addRoute("POST", "/api/memories/clean", () => {
   const cleaned = cleanExpiredMemories();
   return json({ cleaned });

package/package.json

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