@hasna/mementos 0.4.6 → 0.4.8

package/dist/mcp/index.js

@@ -6668,6 +6668,57 @@ server.tool("clean_expired", "Remove expired memories from the database", {}, as
     return { content: [{ type: "text", text: formatError(e) }], isError: true };
   }
 });
+server.tool("session_extract", "Extract memories from a session summary. Auto-creates structured memories from title, topics, notes.", {
+  session_id: exports_external.string(),
+  title: exports_external.string().optional(),
+  project: exports_external.string().optional(),
+  model: exports_external.string().optional(),
+  messages: exports_external.coerce.number().optional(),
+  key_topics: exports_external.array(exports_external.string()).optional(),
+  summary: exports_external.string().optional(),
+  agent_id: exports_external.string().optional(),
+  project_id: exports_external.string().optional()
+}, async (args) => {
+  try {
+    let saveExtracted = function(key, value, category, importance) {
+      try {
+        const mem = createMemory({
+          key,
+          value,
+          category,
+          scope: "shared",
+          importance,
+          source: "auto",
+          agent_id,
+          project_id,
+          session_id
+        });
+        created.push(mem.id);
+      } catch {}
+    };
+    const { session_id, title, project, model, messages, key_topics, summary, agent_id, project_id } = args;
+    const created = [];
+    if (title) {
+      const meta = [project && `project: ${project}`, model && `model: ${model}`, messages && `messages: ${messages}`].filter(Boolean).join(", ");
+      saveExtracted(`session-${session_id}-summary`, `${title}${meta ? ` (${meta})` : ""}`, "history", 6);
+    }
+    if (key_topics?.length) {
+      saveExtracted(`session-${session_id}-topics`, `Key topics: ${key_topics.join(", ")}`, "knowledge", 5);
+    }
+    if (summary) {
+      saveExtracted(`session-${session_id}-notes`, summary, "knowledge", 7);
+    }
+    return {
+      content: [{
+        type: "text",
+        text: `Extracted ${created.length} memor${created.length === 1 ? "y" : "ies"} from session ${session_id}.${created.length > 0 ? `
+IDs: ${created.join(", ")}` : ""}`
+      }]
+    };
+  } catch (e) {
+    return { content: [{ type: "text", text: formatError(e) }], isError: true };
+  }
+});
 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(),
@@ -7075,6 +7126,22 @@ var FULL_SCHEMAS = {
     },
     example: '{"project_id":"proj-uuid","max_tokens":300,"min_importance":5,"format":"compact"}'
   },
+  session_extract: {
+    description: "Auto-create memories from a session summary (title, topics, notes, project). Designed for sessions\u2192mementos integration.",
+    category: "memory",
+    params: {
+      session_id: { type: "string", description: "Session ID to link memories to", required: true },
+      title: { type: "string", description: "Session title" },
+      project: { type: "string", description: "Project name" },
+      model: { type: "string", description: "Model used" },
+      messages: { type: "number", description: "Message count" },
+      key_topics: { type: "array", description: "Key topics extracted from session", items: { type: "string" } },
+      summary: { type: "string", description: "Free-form session summary text" },
+      agent_id: { type: "string", description: "Agent ID to associate memories with" },
+      project_id: { type: "string", description: "Project ID to scope memories to" }
+    },
+    example: '{"session_id":"abc123","title":"Fix auth middleware","project":"alumia","key_topics":["jwt","compliance"],"agent_id":"galba-id"}'
+  },
   memory_context: {
     description: "Get active memories for the current context (agent/project/scope).",
     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;AAy+BH,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;AAikCH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAoG9C"}

package/dist/server/index.js

@@ -2079,6 +2079,10 @@ addRoute("GET", "/api/memories", (_req, url) => {
     filter.agent_id = q["agent_id"];
   if (q["project_id"])
     filter.project_id = q["project_id"];
+  if (q["session_id"])
+    filter.session_id = q["session_id"];
+  if (q["status"])
+    filter.status = q["status"];
   if (q["limit"])
     filter.limit = parseInt(q["limit"], 10);
   if (q["offset"])
@@ -2218,6 +2222,73 @@ addRoute("POST", "/api/memories/bulk-update", async (req) => {
   }
   return json({ updated, errors, total: ids.length });
 });
+addRoute("POST", "/api/memories/extract", async (req) => {
+  const body = await readJson(req);
+  if (!body)
+    return errorResponse("Invalid JSON body", 400);
+  const sessionId = body["session_id"];
+  const agentId = body["agent_id"];
+  const projectId = body["project_id"];
+  const title = body["title"];
+  const project = body["project"];
+  const model = body["model"];
+  const messages = body["messages"];
+  const keyTopics = Array.isArray(body["key_topics"]) ? body["key_topics"] : [];
+  const summary = body["summary"];
+  const extraMemories = Array.isArray(body["memories"]) ? body["memories"] : [];
+  const created = [];
+  const errors = [];
+  function saveExtracted(key, value, category, importance) {
+    try {
+      const mem = createMemory({
+        key,
+        value,
+        category,
+        scope: "shared",
+        importance,
+        source: "auto",
+        agent_id: agentId,
+        project_id: projectId,
+        session_id: sessionId
+      });
+      created.push(mem.id);
+    } catch (e) {
+      errors.push(`${key}: ${e instanceof Error ? e.message : String(e)}`);
+    }
+  }
+  if (title && sessionId) {
+    const meta = [
+      `title: ${title}`,
+      project ? `project: ${project}` : null,
+      model ? `model: ${model}` : null,
+      messages ? `messages: ${messages}` : null
+    ].filter(Boolean).join(", ");
+    saveExtracted(`session-${sessionId}-summary`, `${title} (${meta})`, "history", 6);
+  }
+  if (keyTopics.length > 0 && sessionId) {
+    saveExtracted(`session-${sessionId}-topics`, `Key topics: ${keyTopics.join(", ")}`, "knowledge", 5);
+  }
+  if (summary && sessionId) {
+    saveExtracted(`session-${sessionId}-notes`, summary, "knowledge", 7);
+  }
+  for (const mem of extraMemories) {
+    if (!mem["key"] || !mem["value"])
+      continue;
+    try {
+      const created_mem = createMemory({
+        ...mem,
+        source: "auto",
+        agent_id: agentId,
+        project_id: projectId,
+        session_id: sessionId
+      });
+      created.push(created_mem.id);
+    } catch (e) {
+      errors.push(`${String(mem["key"])}: ${e instanceof Error ? e.message : String(e)}`);
+    }
+  }
+  return json({ created: created.length, memory_ids: created, errors, session_id: sessionId }, 201);
+});
 addRoute("POST", "/api/memories/clean", () => {
   const cleaned = cleanExpiredMemories();
   return json({ cleaned });

package/package.json

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