@hasna/mementos 0.4.13 → 0.4.15

package/dist/mcp/index.js

@@ -6190,7 +6190,7 @@ ${lines.join(`
     return { content: [{ type: "text", text: formatError(e) }], isError: true };
   }
 });
-server.tool("memory_update", "Update a memory's metadata (value, importance, tags, etc.)", {
+server.tool("memory_update", "Update a memory's metadata (value, importance, tags, etc.). version is optional \u2014 auto-fetched if omitted.", {
   id: exports_external.string(),
   value: exports_external.string().optional(),
   category: exports_external.enum(["preference", "fact", "knowledge", "history"]).optional(),
@@ -6202,18 +6202,58 @@ server.tool("memory_update", "Update a memory's metadata (value, importance, tag
   status: exports_external.enum(["active", "archived", "expired"]).optional(),
   metadata: exports_external.record(exports_external.unknown()).optional(),
   expires_at: exports_external.string().nullable().optional(),
-  version: exports_external.coerce.number()
+  version: exports_external.coerce.number().optional()
 }, async (args) => {
   try {
     const id = resolveId(args.id);
-    const { id: _id, ...updateFields } = args;
-    const memory = updateMemory(id, updateFields);
+    const { id: _id, version, ...updateFields } = args;
+    const resolvedVersion = version ?? getMemory(id)?.version;
+    if (resolvedVersion === undefined) {
+      return { content: [{ type: "text", text: `Memory not found: ${id}` }] };
+    }
+    const memory = updateMemory(id, { ...updateFields, version: resolvedVersion });
     return { content: [{ type: "text", text: `Memory updated:
 ${formatMemory(memory)}` }] };
   } catch (e) {
     return { content: [{ type: "text", text: formatError(e) }], isError: true };
   }
 });
+server.tool("memory_pin", "Pin or unpin a memory by ID or key. No version needed.", {
+  id: exports_external.string().optional(),
+  key: exports_external.string().optional(),
+  pinned: exports_external.boolean().optional(),
+  scope: exports_external.enum(["global", "shared", "private"]).optional(),
+  agent_id: exports_external.string().optional(),
+  project_id: exports_external.string().optional()
+}, async (args) => {
+  try {
+    let memory = args.id ? getMemory(resolveId(args.id)) : getMemoryByKey(args.key, args.scope, args.agent_id, args.project_id);
+    if (!memory)
+      return { content: [{ type: "text", text: `Memory not found.` }] };
+    const pinned = args.pinned !== false;
+    updateMemory(memory.id, { pinned, version: memory.version });
+    return { content: [{ type: "text", text: `Memory "${memory.key}" ${pinned ? "pinned" : "unpinned"}.` }] };
+  } catch (e) {
+    return { content: [{ type: "text", text: formatError(e) }], isError: true };
+  }
+});
+server.tool("memory_archive", "Archive a memory by ID or key (hides from lists, keeps history). No version needed.", {
+  id: exports_external.string().optional(),
+  key: exports_external.string().optional(),
+  scope: exports_external.enum(["global", "shared", "private"]).optional(),
+  agent_id: exports_external.string().optional(),
+  project_id: exports_external.string().optional()
+}, async (args) => {
+  try {
+    let memory = args.id ? getMemory(resolveId(args.id)) : getMemoryByKey(args.key, args.scope, args.agent_id, args.project_id);
+    if (!memory)
+      return { content: [{ type: "text", text: `Memory not found.` }] };
+    updateMemory(memory.id, { status: "archived", version: memory.version });
+    return { content: [{ type: "text", text: `Memory "${memory.key}" archived.` }] };
+  } catch (e) {
+    return { content: [{ type: "text", text: formatError(e) }], isError: true };
+  }
+});
 server.tool("memory_forget", "Delete a memory by ID or key", {
   id: exports_external.string().optional(),
   key: exports_external.string().optional(),
@@ -7041,11 +7081,11 @@ var FULL_SCHEMAS = {
     example: '{"scope":"global","min_importance":7,"limit":20}'
   },
   memory_update: {
-    description: "Update a memory's fields. Requires current version for optimistic concurrency.",
+    description: "Update a memory's fields. version is optional \u2014 auto-fetched if omitted (eliminates 2-round-trip pattern).",
     category: "memory",
     params: {
       id: { type: "string", description: "Memory ID (partial OK)", required: true },
-      version: { type: "number", description: "Current version (for conflict detection)", required: true },
+      version: { type: "number", description: "Current version for conflict detection (omit to auto-fetch)" },
       value: { type: "string", description: "New value" },
       category: { type: "string", description: "New category", enum: ["preference", "fact", "knowledge", "history"] },
       scope: { type: "string", description: "New scope", enum: ["global", "shared", "private"] },
@@ -7059,6 +7099,27 @@ var FULL_SCHEMAS = {
     },
     example: '{"id":"abc123","version":1,"importance":9,"tags":["correction","important"]}'
   },
+  memory_pin: {
+    description: "Pin or unpin a memory by ID or key. No version required.",
+    category: "memory",
+    params: {
+      id: { type: "string", description: "Memory ID" },
+      key: { type: "string", description: "Memory key (alternative to id)" },
+      pinned: { type: "boolean", description: "true=pin (default), false=unpin" },
+      scope: { type: "string", description: "Scope filter for key lookup", enum: ["global", "shared", "private"] }
+    },
+    example: '{"key":"project-stack","pinned":true}'
+  },
+  memory_archive: {
+    description: "Archive a memory by ID or key. Hides from lists, preserves history. No version required.",
+    category: "memory",
+    params: {
+      id: { type: "string", description: "Memory ID" },
+      key: { type: "string", description: "Memory key (alternative to id)" },
+      scope: { type: "string", description: "Scope filter for key lookup", enum: ["global", "shared", "private"] }
+    },
+    example: '{"key":"old-project-stack"}'
+  },
   memory_forget: {
     description: "Delete a memory by ID or key.",
     category: "memory",

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;AAkkCH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAkH9C"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":";AACA;;;GAGG;AAukCH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAkH9C"}

package/dist/server/index.js

@@ -2418,11 +2418,15 @@ addRoute("PATCH", "/api/memories/:id", async (req, _url, params) => {
   if (!body) {
     return errorResponse("Invalid JSON body", 400);
   }
-  if (body["version"] === undefined) {
-    return errorResponse("Missing required field: version", 400);
+  const updateBody = { ...body };
+  if (updateBody["version"] === undefined) {
+    const existing = getMemory(params["id"]);
+    if (!existing)
+      return errorResponse("Memory not found", 404);
+    updateBody["version"] = existing.version;
   }
   try {
-    const memory = updateMemory(params["id"], body);
+    const memory = updateMemory(params["id"], updateBody);
     return json(memory);
   } catch (e) {
     if (e instanceof MemoryNotFoundError) {

package/package.json

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