@mnemoai/core 1.1.0 → 1.1.2

package/{src/mcp-server.ts → dist/src/mcp-server.js}

@@ -1,29 +1,11 @@
-// SPDX-License-Identifier: LicenseRef-Mnemo-Pro
-/**
- * MCP Server for Mnemo
- *
- * Exposes memory tools (search, store, delete, update, list, stats) over
- * stdio JSON-RPC so Claude Code can call them directly without going through
- * the OpenClaw gateway.
- *
- * Usage:
- *   node --import jiti/register src/mcp-server.ts
- *
- * Register with Claude Code:
- *   claude mcp add memory -s user -- node --import jiti/register \
- *     /path/to/mnemo/src/mcp-server.ts
- */
-
-// Redirect console.log to stderr — stdout is reserved for JSON-RPC
 const _origLog = console.log;
-console.log = (...args: any[]) => console.error(...args);
-
+console.log = (...args) => console.error(...args);
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { z } from "zod";
 import { join } from "node:path";
 import { mkdir, appendFile } from "node:fs/promises";
-
+import { log } from "./logger.js";
 import { loadConfigFromOpenClaw, getDefaultDbPath } from "./config.js";
 import { MemoryStore, validateStoragePath } from "./store.js";
 import { createEmbedder, getVectorDimensions } from "./embedder.js";
@@ -32,25 +14,17 @@ import { createScopeManager } from "./scopes.js";
 import { isNoise } from "./noise-filter.js";
 import { SemanticGate } from "./semantic-gate.js";
 import { recoverPendingWrites } from "./wal-recovery.js";
-
-// ============================================================================
-// Initialization
-// ============================================================================
-
 const config = loadConfigFromOpenClaw();
-
 const dbPath = config.dbPath || getDefaultDbPath();
 try {
   validateStoragePath(dbPath);
 } catch (err) {
-  console.error(`mnemo mcp: storage path issue — ${String(err)}`);
+  log.error(`mnemo mcp: storage path issue \u2014 ${String(err)}`);
 }
-
 const vectorDim = getVectorDimensions(
   config.embedding.model || "text-embedding-3-small",
-  config.embedding.dimensions,
+  config.embedding.dimensions
 );
-
 const store = new MemoryStore({ dbPath, vectorDim });
 const embedder = createEmbedder({
   provider: "openai-compatible",
@@ -60,77 +34,47 @@ const embedder = createEmbedder({
   dimensions: config.embedding.dimensions,
   taskQuery: config.embedding.taskQuery,
   taskPassage: config.embedding.taskPassage,
-  normalized: config.embedding.normalized,
+  normalized: config.embedding.normalized
 });
-console.warn(`[config-debug] config.retrieval keys: ${JSON.stringify(Object.keys(config.retrieval || {}))}`);
-console.warn(`[config-debug] config.retrieval.rerankApiKey: ${config.retrieval?.rerankApiKey ? 'SET(' + String(config.retrieval.rerankApiKey).substring(0, 8) + ')' : 'EMPTY'}`);
+log.warn(`[config-debug] config.retrieval keys: ${JSON.stringify(Object.keys(config.retrieval || {}))}`);
+log.warn(`[config-debug] config.retrieval.rerankApiKey: ${config.retrieval?.rerankApiKey ? "SET(" + String(config.retrieval.rerankApiKey).substring(0, 8) + ")" : "EMPTY"}`);
 const retriever = createRetriever(store, embedder, {
   ...DEFAULT_RETRIEVAL_CONFIG,
-  ...config.retrieval,
+  ...config.retrieval
 });
 const scopeManager = createScopeManager(config.scopes);
-
-// Inject semantic gate into store
 const semanticGate = new SemanticGate(embedder);
 store.setSemanticGate(semanticGate);
-
-// WAL recovery: fire-and-forget on startup
 recoverPendingWrites().catch((err) => {
-  console.error(`mnemo mcp: WAL recovery failed — ${String(err)}`);
+  log.error(`mnemo mcp: WAL recovery failed \u2014 ${String(err)}`);
 });
-
-// ============================================================================
-// Markdown Mirror (simplified — no OpenClaw API dependency)
-// ============================================================================
-
-const mirrorDir = config.mdMirror?.enabled
-  ? (config.mdMirror.dir || join(getDefaultDbPath(), "..", "lancedb-pro-mirror"))
-  : null;
-
-async function mirrorWrite(
-  text: string,
-  category: string,
-  scope: string,
-  timestamp?: number,
-): Promise<void> {
+const mirrorDir = config.mdMirror?.enabled ? config.mdMirror.dir || join(getDefaultDbPath(), "..", "lancedb-pro-mirror") : null;
+async function mirrorWrite(text, category, scope, timestamp) {
   if (!mirrorDir) return;
   try {
     const ts = new Date(timestamp || Date.now());
     const dateStr = ts.toISOString().split("T")[0];
     const filePath = join(mirrorDir, `${dateStr}.md`);
     const safeText = text.replace(/\n/g, " ").slice(0, 500);
-    const line = `- ${ts.toISOString()} [${category}:${scope}] source=mcp ${safeText}\n`;
+    const line = `- ${ts.toISOString()} [${category}:${scope}] source=mcp ${safeText}
+`;
     await mkdir(mirrorDir, { recursive: true });
     await appendFile(filePath, line, "utf8");
   } catch {
-    // Fail-open: mirror errors never block tool responses
   }
 }
-
-// ============================================================================
-// Helpers
-// ============================================================================
-
-function clampInt(value: number, min: number, max: number): number {
+function clampInt(value, min, max) {
   if (!Number.isFinite(value)) return min;
   return Math.min(max, Math.max(min, Math.floor(value)));
 }
-
-function clamp01(value: number, fallback = 0.7): number {
+function clamp01(value, fallback = 0.7) {
   if (!Number.isFinite(value)) return fallback;
   return Math.min(1, Math.max(0, value));
 }
-
-// ============================================================================
-// MCP Server
-// ============================================================================
-
 const server = new McpServer({
   name: "mnemo",
-  version: "1.0.0",
+  version: "1.0.0"
 });
-
-// --- memory_search ---
 server.tool(
   "memory_search",
   "Search through long-term memories using hybrid retrieval (vector + keyword search). Use when you need context about user preferences, past decisions, or previously discussed topics.",
@@ -138,51 +82,44 @@ server.tool(
     query: z.string().describe("Search query for finding relevant memories"),
     limit: z.number().optional().describe("Max results to return (default: 5, max: 20)"),
     scope: z.string().optional().describe("Specific memory scope to search in"),
-    category: z.enum(["preference", "fact", "decision", "entity", "other"]).optional(),
+    category: z.enum(["preference", "fact", "decision", "entity", "other"]).optional()
   },
   async ({ query, limit = 5, scope, category }) => {
     try {
       const safeLimit = clampInt(limit, 1, 20);
-
       let scopeFilter = scopeManager.getAccessibleScopes();
       if (scope) {
         if (scopeManager.isAccessible(scope)) {
           scopeFilter = [scope];
         } else {
-          return { content: [{ type: "text" as const, text: `Access denied to scope: ${scope}` }] };
+          return { content: [{ type: "text", text: `Access denied to scope: ${scope}` }] };
         }
       }
-
       const results = await retriever.retrieve({
         query,
         limit: safeLimit,
         scopeFilter,
         category,
-        source: "manual",
+        source: "manual"
       });
-
       if (results.length === 0) {
-        return { content: [{ type: "text" as const, text: "No relevant memories found." }] };
+        return { content: [{ type: "text", text: "No relevant memories found." }] };
       }
-
-      const text = results
-        .map((r, i) => {
-          const sources: string[] = [];
-          if (r.sources.vector) sources.push("vector");
-          if (r.sources.bm25) sources.push("BM25");
-          if (r.sources.reranked) sources.push("reranked");
-          return `${i + 1}. [${r.entry.id}] [${r.entry.category}:${r.entry.scope}] ${r.entry.text} (${(r.score * 100).toFixed(0)}%${sources.length > 0 ? `, ${sources.join("+")}` : ""})`;
-        })
-        .join("\n");
-
-      return { content: [{ type: "text" as const, text: `Found ${results.length} memories:\n\n${text}` }] };
+      const text = results.map((r, i) => {
+        const sources = [];
+        if (r.sources.vector) sources.push("vector");
+        if (r.sources.bm25) sources.push("BM25");
+        if (r.sources.reranked) sources.push("reranked");
+        return `${i + 1}. [${r.entry.id}] [${r.entry.category}:${r.entry.scope}] ${r.entry.text} (${(r.score * 100).toFixed(0)}%${sources.length > 0 ? `, ${sources.join("+")}` : ""})`;
+      }).join("\n");
+      return { content: [{ type: "text", text: `Found ${results.length} memories:
+
+${text}` }] };
     } catch (error) {
-      return { content: [{ type: "text" as const, text: `Memory search failed: ${error instanceof Error ? error.message : String(error)}` }] };
+      return { content: [{ type: "text", text: `Memory search failed: ${error instanceof Error ? error.message : String(error)}` }] };
     }
-  },
+  }
 );
-
-// --- memory_store ---
 server.tool(
   "memory_store",
   "Save important information in long-term memory. Use for preferences, facts, decisions, and other notable information.",
@@ -190,78 +127,64 @@ server.tool(
     text: z.string().describe("Information to remember"),
     importance: z.number().optional().describe("Importance score 0-1 (default: 0.7)"),
     category: z.enum(["preference", "fact", "decision", "entity", "other"]).optional(),
-    scope: z.string().optional().describe("Memory scope (optional, defaults to global)"),
+    scope: z.string().optional().describe("Memory scope (optional, defaults to global)")
   },
   async ({ text, importance = 0.7, category = "other", scope }) => {
     try {
       let targetScope = scope || scopeManager.getDefaultScope();
-
       if (!scopeManager.isAccessible(targetScope)) {
-        return { content: [{ type: "text" as const, text: `Access denied to scope: ${targetScope}` }] };
+        return { content: [{ type: "text", text: `Access denied to scope: ${targetScope}` }] };
       }
-
       if (isNoise(text)) {
-        return { content: [{ type: "text" as const, text: "Skipped: text detected as noise (greeting, boilerplate, or meta-question)" }] };
+        return { content: [{ type: "text", text: "Skipped: text detected as noise (greeting, boilerplate, or meta-question)" }] };
       }
-
       const safeImportance = clamp01(importance, 0.7);
       const vector = await embedder.embedPassage(text);
-
-      // Dedup check (fail-open)
-      let existing: Awaited<ReturnType<typeof store.vectorSearch>> = [];
+      let existing = [];
       try {
         existing = await store.vectorSearch(vector, 1, 0.1, [targetScope]);
       } catch {
-        // Dedup check failed — continue store
       }
-
       if (existing.length > 0 && existing[0].score > 0.98) {
         return {
-          content: [{ type: "text" as const, text: `Similar memory already exists: "${existing[0].entry.text}"` }],
+          content: [{ type: "text", text: `Similar memory already exists: "${existing[0].entry.text}"` }]
         };
       }
-
       const entry = await store.store({
         text,
         vector,
         importance: safeImportance,
-        category: category as any,
-        scope: targetScope,
+        category,
+        scope: targetScope
       });
-
       await mirrorWrite(text, category, targetScope, entry.timestamp);
-
       return {
-        content: [{ type: "text" as const, text: `Stored: "${text.slice(0, 100)}${text.length > 100 ? "..." : ""}" [id=${entry.id}] in scope '${targetScope}'` }],
+        content: [{ type: "text", text: `Stored: "${text.slice(0, 100)}${text.length > 100 ? "..." : ""}" [id=${entry.id}] in scope '${targetScope}'` }]
       };
     } catch (error) {
-      return { content: [{ type: "text" as const, text: `Memory storage failed: ${error instanceof Error ? error.message : String(error)}` }] };
+      return { content: [{ type: "text", text: `Memory storage failed: ${error instanceof Error ? error.message : String(error)}` }] };
     }
-  },
+  }
 );
-
-// --- memory_delete ---
 server.tool(
   "memory_delete",
   "Delete a specific memory by ID.",
   {
-    memoryId: z.string().describe("Memory ID to delete (full UUID or 8+ char prefix)"),
+    memoryId: z.string().describe("Memory ID to delete (full UUID or 8+ char prefix)")
   },
   async ({ memoryId }) => {
     try {
       const scopeFilter = scopeManager.getAccessibleScopes();
       const deleted = await store.delete(memoryId, scopeFilter);
       if (deleted) {
-        return { content: [{ type: "text" as const, text: `Memory ${memoryId} deleted.` }] };
+        return { content: [{ type: "text", text: `Memory ${memoryId} deleted.` }] };
       }
-      return { content: [{ type: "text" as const, text: `Memory ${memoryId} not found or access denied.` }] };
+      return { content: [{ type: "text", text: `Memory ${memoryId} not found or access denied.` }] };
     } catch (error) {
-      return { content: [{ type: "text" as const, text: `Memory deletion failed: ${error instanceof Error ? error.message : String(error)}` }] };
+      return { content: [{ type: "text", text: `Memory deletion failed: ${error instanceof Error ? error.message : String(error)}` }] };
     }
-  },
+  }
 );
-
-// --- memory_update ---
 server.tool(
   "memory_update",
   "Update an existing memory in-place. Preserves original timestamp.",
@@ -269,46 +192,38 @@ server.tool(
     memoryId: z.string().describe("ID of the memory to update (full UUID or 8+ char prefix)"),
     text: z.string().optional().describe("New text content (triggers re-embedding)"),
     importance: z.number().optional().describe("New importance score 0-1"),
-    category: z.enum(["preference", "fact", "decision", "entity", "other"]).optional(),
+    category: z.enum(["preference", "fact", "decision", "entity", "other"]).optional()
   },
   async ({ memoryId, text, importance, category }) => {
     try {
-      if (!text && importance === undefined && !category) {
-        return { content: [{ type: "text" as const, text: "Nothing to update. Provide at least one of: text, importance, category." }] };
+      if (!text && importance === void 0 && !category) {
+        return { content: [{ type: "text", text: "Nothing to update. Provide at least one of: text, importance, category." }] };
       }
-
       const scopeFilter = scopeManager.getAccessibleScopes();
-
-      let newVector: number[] | undefined;
+      let newVector;
       if (text) {
         if (isNoise(text)) {
-          return { content: [{ type: "text" as const, text: "Skipped: updated text detected as noise" }] };
+          return { content: [{ type: "text", text: "Skipped: updated text detected as noise" }] };
         }
         newVector = await embedder.embedPassage(text);
       }
-
-      const updates: Record<string, any> = {};
+      const updates = {};
       if (text) updates.text = text;
       if (newVector) updates.vector = newVector;
-      if (importance !== undefined) updates.importance = clamp01(importance, 0.7);
+      if (importance !== void 0) updates.importance = clamp01(importance, 0.7);
       if (category) updates.category = category;
-
       const updated = await store.update(memoryId, updates, scopeFilter);
-
       if (!updated) {
-        return { content: [{ type: "text" as const, text: `Memory ${memoryId} not found or access denied.` }] };
+        return { content: [{ type: "text", text: `Memory ${memoryId} not found or access denied.` }] };
       }
-
       return {
-        content: [{ type: "text" as const, text: `Updated memory ${updated.id.slice(0, 8)}...: "${updated.text.slice(0, 80)}${updated.text.length > 80 ? "..." : ""}"` }],
+        content: [{ type: "text", text: `Updated memory ${updated.id.slice(0, 8)}...: "${updated.text.slice(0, 80)}${updated.text.length > 80 ? "..." : ""}"` }]
       };
     } catch (error) {
-      return { content: [{ type: "text" as const, text: `Memory update failed: ${error instanceof Error ? error.message : String(error)}` }] };
+      return { content: [{ type: "text", text: `Memory update failed: ${error instanceof Error ? error.message : String(error)}` }] };
     }
-  },
+  }
 );
-
-// --- memory_list ---
 server.tool(
   "memory_list",
   "List recent memories with optional filtering by scope and category.",
@@ -316,48 +231,41 @@ server.tool(
     limit: z.number().optional().describe("Max memories to list (default: 10, max: 50)"),
     offset: z.number().optional().describe("Number of memories to skip (default: 0)"),
     scope: z.string().optional().describe("Filter by specific scope"),
-    category: z.enum(["preference", "fact", "decision", "entity", "other"]).optional(),
+    category: z.enum(["preference", "fact", "decision", "entity", "other"]).optional()
   },
   async ({ limit = 10, offset = 0, scope, category }) => {
     try {
       const safeLimit = clampInt(limit, 1, 50);
-      const safeOffset = clampInt(offset, 0, 1000);
-
+      const safeOffset = clampInt(offset, 0, 1e3);
       let scopeFilter = scopeManager.getAccessibleScopes();
       if (scope) {
         if (scopeManager.isAccessible(scope)) {
           scopeFilter = [scope];
         } else {
-          return { content: [{ type: "text" as const, text: `Access denied to scope: ${scope}` }] };
+          return { content: [{ type: "text", text: `Access denied to scope: ${scope}` }] };
         }
       }
-
       const entries = await store.list(scopeFilter, category, safeLimit, safeOffset);
-
       if (entries.length === 0) {
-        return { content: [{ type: "text" as const, text: "No memories found." }] };
+        return { content: [{ type: "text", text: "No memories found." }] };
       }
+      const text = entries.map((entry, i) => {
+        const date = new Date(entry.timestamp).toISOString().split("T")[0];
+        return `${safeOffset + i + 1}. [${entry.id}] [${entry.category}:${entry.scope}] ${entry.text.slice(0, 100)}${entry.text.length > 100 ? "..." : ""} (${date})`;
+      }).join("\n");
+      return { content: [{ type: "text", text: `Recent memories (showing ${entries.length}):
 
-      const text = entries
-        .map((entry, i) => {
-          const date = new Date(entry.timestamp).toISOString().split("T")[0];
-          return `${safeOffset + i + 1}. [${entry.id}] [${entry.category}:${entry.scope}] ${entry.text.slice(0, 100)}${entry.text.length > 100 ? "..." : ""} (${date})`;
-        })
-        .join("\n");
-
-      return { content: [{ type: "text" as const, text: `Recent memories (showing ${entries.length}):\n\n${text}` }] };
+${text}` }] };
     } catch (error) {
-      return { content: [{ type: "text" as const, text: `Failed to list memories: ${error instanceof Error ? error.message : String(error)}` }] };
+      return { content: [{ type: "text", text: `Failed to list memories: ${error instanceof Error ? error.message : String(error)}` }] };
     }
-  },
+  }
 );
-
-// --- memory_stats ---
 server.tool(
   "memory_stats",
   "Get statistics about memory usage, scopes, and categories.",
   {
-    scope: z.string().optional().describe("Specific scope to get stats for"),
+    scope: z.string().optional().describe("Specific scope to get stats for")
   },
   async ({ scope }) => {
     try {
@@ -366,14 +274,12 @@ server.tool(
         if (scopeManager.isAccessible(scope)) {
           scopeFilter = [scope];
         } else {
-          return { content: [{ type: "text" as const, text: `Access denied to scope: ${scope}` }] };
+          return { content: [{ type: "text", text: `Access denied to scope: ${scope}` }] };
         }
       }
-
       const stats = await store.stats(scopeFilter);
       const scopeManagerStats = scopeManager.getStats();
       const retrievalConfig = retriever.getConfig();
-
       const text = [
         `Memory Statistics:`,
         `  Total memories: ${stats.totalCount}`,
@@ -383,33 +289,27 @@ server.tool(
         ``,
         `Memories by scope:`,
         ...Object.entries(stats.scopeCounts).map(
-          ([s, count]) => `  ${s}: ${count}`,
+          ([s, count]) => `  ${s}: ${count}`
         ),
         ``,
         `Memories by category:`,
         ...Object.entries(stats.categoryCounts).map(
-          ([c, count]) => `  ${c}: ${count}`,
-        ),
+          ([c, count]) => `  ${c}: ${count}`
+        )
       ].join("\n");
-
-      return { content: [{ type: "text" as const, text }] };
+      return { content: [{ type: "text", text }] };
     } catch (error) {
-      return { content: [{ type: "text" as const, text: `Failed to get memory stats: ${error instanceof Error ? error.message : String(error)}` }] };
+      return { content: [{ type: "text", text: `Failed to get memory stats: ${error instanceof Error ? error.message : String(error)}` }] };
     }
-  },
+  }
 );
-
-// ============================================================================
-// Start
-// ============================================================================
-
 async function main() {
   const transport = new StdioServerTransport();
   await server.connect(transport);
-  console.error("mnemo MCP server started (stdio)");
+  log.error("mnemo MCP server started (stdio)");
 }
-
 main().catch((err) => {
-  console.error("Fatal:", err);
+  log.error("Fatal:", err);
   process.exit(1);
 });
+//# sourceMappingURL=mcp-server.js.map

package/dist/src/mcp-server.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/mcp-server.ts"],
+  "sourcesContent": ["// SPDX-License-Identifier: LicenseRef-Mnemo-Pro\n/**\n * MCP Server for Mnemo\n *\n * Exposes memory tools (search, store, delete, update, list, stats) over\n * stdio JSON-RPC so Claude Code can call them directly without going through\n * the OpenClaw gateway.\n *\n * Usage:\n *   node --import jiti/register src/mcp-server.ts\n *\n * Register with Claude Code:\n *   claude mcp add memory -s user -- node --import jiti/register \\\n *     /path/to/mnemo/src/mcp-server.ts\n */\n\n// Redirect console.log to stderr \u2014 stdout is reserved for JSON-RPC\nconst _origLog = console.log;\nconsole.log = (...args: any[]) => console.error(...args);\n\nimport { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport { StdioServerTransport } from \"@modelcontextprotocol/sdk/server/stdio.js\";\nimport { z } from \"zod\";\nimport { join } from \"node:path\";\nimport { mkdir, appendFile } from \"node:fs/promises\";\n\nimport { log } from \"./logger.js\";\nimport { loadConfigFromOpenClaw, getDefaultDbPath } from \"./config.js\";\nimport { MemoryStore, validateStoragePath } from \"./store.js\";\nimport { createEmbedder, getVectorDimensions } from \"./embedder.js\";\nimport { createRetriever, DEFAULT_RETRIEVAL_CONFIG } from \"./retriever.js\";\nimport { createScopeManager } from \"./scopes.js\";\nimport { isNoise } from \"./noise-filter.js\";\nimport { SemanticGate } from \"./semantic-gate.js\";\nimport { recoverPendingWrites } from \"./wal-recovery.js\";\n\n// ============================================================================\n// Initialization\n// ============================================================================\n\nconst config = loadConfigFromOpenClaw();\n\nconst dbPath = config.dbPath || getDefaultDbPath();\ntry {\n  validateStoragePath(dbPath);\n} catch (err) {\n  log.error(`mnemo mcp: storage path issue \u2014 ${String(err)}`);\n}\n\nconst vectorDim = getVectorDimensions(\n  config.embedding.model || \"text-embedding-3-small\",\n  config.embedding.dimensions,\n);\n\nconst store = new MemoryStore({ dbPath, vectorDim });\nconst embedder = createEmbedder({\n  provider: \"openai-compatible\",\n  apiKey: config.embedding.apiKey,\n  model: config.embedding.model || \"text-embedding-3-small\",\n  baseURL: config.embedding.baseURL,\n  dimensions: config.embedding.dimensions,\n  taskQuery: config.embedding.taskQuery,\n  taskPassage: config.embedding.taskPassage,\n  normalized: config.embedding.normalized,\n});\nlog.warn(`[config-debug] config.retrieval keys: ${JSON.stringify(Object.keys(config.retrieval || {}))}`);\nlog.warn(`[config-debug] config.retrieval.rerankApiKey: ${config.retrieval?.rerankApiKey ? 'SET(' + String(config.retrieval.rerankApiKey).substring(0, 8) + ')' : 'EMPTY'}`);\nconst retriever = createRetriever(store, embedder, {\n  ...DEFAULT_RETRIEVAL_CONFIG,\n  ...config.retrieval,\n});\nconst scopeManager = createScopeManager(config.scopes);\n\n// Inject semantic gate into store\nconst semanticGate = new SemanticGate(embedder);\nstore.setSemanticGate(semanticGate);\n\n// WAL recovery: fire-and-forget on startup\nrecoverPendingWrites().catch((err) => {\n  log.error(`mnemo mcp: WAL recovery failed \u2014 ${String(err)}`);\n});\n\n// ============================================================================\n// Markdown Mirror (simplified \u2014 no OpenClaw API dependency)\n// ============================================================================\n\nconst mirrorDir = config.mdMirror?.enabled\n  ? (config.mdMirror.dir || join(getDefaultDbPath(), \"..\", \"lancedb-pro-mirror\"))\n  : null;\n\nasync function mirrorWrite(\n  text: string,\n  category: string,\n  scope: string,\n  timestamp?: number,\n): Promise<void> {\n  if (!mirrorDir) return;\n  try {\n    const ts = new Date(timestamp || Date.now());\n    const dateStr = ts.toISOString().split(\"T\")[0];\n    const filePath = join(mirrorDir, `${dateStr}.md`);\n    const safeText = text.replace(/\\n/g, \" \").slice(0, 500);\n    const line = `- ${ts.toISOString()} [${category}:${scope}] source=mcp ${safeText}\\n`;\n    await mkdir(mirrorDir, { recursive: true });\n    await appendFile(filePath, line, \"utf8\");\n  } catch {\n    // Fail-open: mirror errors never block tool responses\n  }\n}\n\n// ============================================================================\n// Helpers\n// ============================================================================\n\nfunction clampInt(value: number, min: number, max: number): number {\n  if (!Number.isFinite(value)) return min;\n  return Math.min(max, Math.max(min, Math.floor(value)));\n}\n\nfunction clamp01(value: number, fallback = 0.7): number {\n  if (!Number.isFinite(value)) return fallback;\n  return Math.min(1, Math.max(0, value));\n}\n\n// ============================================================================\n// MCP Server\n// ============================================================================\n\nconst server = new McpServer({\n  name: \"mnemo\",\n  version: \"1.0.0\",\n});\n\n// --- memory_search ---\nserver.tool(\n  \"memory_search\",\n  \"Search through long-term memories using hybrid retrieval (vector + keyword search). Use when you need context about user preferences, past decisions, or previously discussed topics.\",\n  {\n    query: z.string().describe(\"Search query for finding relevant memories\"),\n    limit: z.number().optional().describe(\"Max results to return (default: 5, max: 20)\"),\n    scope: z.string().optional().describe(\"Specific memory scope to search in\"),\n    category: z.enum([\"preference\", \"fact\", \"decision\", \"entity\", \"other\"]).optional(),\n  },\n  async ({ query, limit = 5, scope, category }) => {\n    try {\n      const safeLimit = clampInt(limit, 1, 20);\n\n      let scopeFilter = scopeManager.getAccessibleScopes();\n      if (scope) {\n        if (scopeManager.isAccessible(scope)) {\n          scopeFilter = [scope];\n        } else {\n          return { content: [{ type: \"text\" as const, text: `Access denied to scope: ${scope}` }] };\n        }\n      }\n\n      const results = await retriever.retrieve({\n        query,\n        limit: safeLimit,\n        scopeFilter,\n        category,\n        source: \"manual\",\n      });\n\n      if (results.length === 0) {\n        return { content: [{ type: \"text\" as const, text: \"No relevant memories found.\" }] };\n      }\n\n      const text = results\n        .map((r, i) => {\n          const sources: string[] = [];\n          if (r.sources.vector) sources.push(\"vector\");\n          if (r.sources.bm25) sources.push(\"BM25\");\n          if (r.sources.reranked) sources.push(\"reranked\");\n          return `${i + 1}. [${r.entry.id}] [${r.entry.category}:${r.entry.scope}] ${r.entry.text} (${(r.score * 100).toFixed(0)}%${sources.length > 0 ? `, ${sources.join(\"+\")}` : \"\"})`;\n        })\n        .join(\"\\n\");\n\n      return { content: [{ type: \"text\" as const, text: `Found ${results.length} memories:\\n\\n${text}` }] };\n    } catch (error) {\n      return { content: [{ type: \"text\" as const, text: `Memory search failed: ${error instanceof Error ? error.message : String(error)}` }] };\n    }\n  },\n);\n\n// --- memory_store ---\nserver.tool(\n  \"memory_store\",\n  \"Save important information in long-term memory. Use for preferences, facts, decisions, and other notable information.\",\n  {\n    text: z.string().describe(\"Information to remember\"),\n    importance: z.number().optional().describe(\"Importance score 0-1 (default: 0.7)\"),\n    category: z.enum([\"preference\", \"fact\", \"decision\", \"entity\", \"other\"]).optional(),\n    scope: z.string().optional().describe(\"Memory scope (optional, defaults to global)\"),\n  },\n  async ({ text, importance = 0.7, category = \"other\", scope }) => {\n    try {\n      let targetScope = scope || scopeManager.getDefaultScope();\n\n      if (!scopeManager.isAccessible(targetScope)) {\n        return { content: [{ type: \"text\" as const, text: `Access denied to scope: ${targetScope}` }] };\n      }\n\n      if (isNoise(text)) {\n        return { content: [{ type: \"text\" as const, text: \"Skipped: text detected as noise (greeting, boilerplate, or meta-question)\" }] };\n      }\n\n      const safeImportance = clamp01(importance, 0.7);\n      const vector = await embedder.embedPassage(text);\n\n      // Dedup check (fail-open)\n      let existing: Awaited<ReturnType<typeof store.vectorSearch>> = [];\n      try {\n        existing = await store.vectorSearch(vector, 1, 0.1, [targetScope]);\n      } catch {\n        // Dedup check failed \u2014 continue store\n      }\n\n      if (existing.length > 0 && existing[0].score > 0.98) {\n        return {\n          content: [{ type: \"text\" as const, text: `Similar memory already exists: \"${existing[0].entry.text}\"` }],\n        };\n      }\n\n      const entry = await store.store({\n        text,\n        vector,\n        importance: safeImportance,\n        category: category as any,\n        scope: targetScope,\n      });\n\n      await mirrorWrite(text, category, targetScope, entry.timestamp);\n\n      return {\n        content: [{ type: \"text\" as const, text: `Stored: \"${text.slice(0, 100)}${text.length > 100 ? \"...\" : \"\"}\" [id=${entry.id}] in scope '${targetScope}'` }],\n      };\n    } catch (error) {\n      return { content: [{ type: \"text\" as const, text: `Memory storage failed: ${error instanceof Error ? error.message : String(error)}` }] };\n    }\n  },\n);\n\n// --- memory_delete ---\nserver.tool(\n  \"memory_delete\",\n  \"Delete a specific memory by ID.\",\n  {\n    memoryId: z.string().describe(\"Memory ID to delete (full UUID or 8+ char prefix)\"),\n  },\n  async ({ memoryId }) => {\n    try {\n      const scopeFilter = scopeManager.getAccessibleScopes();\n      const deleted = await store.delete(memoryId, scopeFilter);\n      if (deleted) {\n        return { content: [{ type: \"text\" as const, text: `Memory ${memoryId} deleted.` }] };\n      }\n      return { content: [{ type: \"text\" as const, text: `Memory ${memoryId} not found or access denied.` }] };\n    } catch (error) {\n      return { content: [{ type: \"text\" as const, text: `Memory deletion failed: ${error instanceof Error ? error.message : String(error)}` }] };\n    }\n  },\n);\n\n// --- memory_update ---\nserver.tool(\n  \"memory_update\",\n  \"Update an existing memory in-place. Preserves original timestamp.\",\n  {\n    memoryId: z.string().describe(\"ID of the memory to update (full UUID or 8+ char prefix)\"),\n    text: z.string().optional().describe(\"New text content (triggers re-embedding)\"),\n    importance: z.number().optional().describe(\"New importance score 0-1\"),\n    category: z.enum([\"preference\", \"fact\", \"decision\", \"entity\", \"other\"]).optional(),\n  },\n  async ({ memoryId, text, importance, category }) => {\n    try {\n      if (!text && importance === undefined && !category) {\n        return { content: [{ type: \"text\" as const, text: \"Nothing to update. Provide at least one of: text, importance, category.\" }] };\n      }\n\n      const scopeFilter = scopeManager.getAccessibleScopes();\n\n      let newVector: number[] | undefined;\n      if (text) {\n        if (isNoise(text)) {\n          return { content: [{ type: \"text\" as const, text: \"Skipped: updated text detected as noise\" }] };\n        }\n        newVector = await embedder.embedPassage(text);\n      }\n\n      const updates: Record<string, any> = {};\n      if (text) updates.text = text;\n      if (newVector) updates.vector = newVector;\n      if (importance !== undefined) updates.importance = clamp01(importance, 0.7);\n      if (category) updates.category = category;\n\n      const updated = await store.update(memoryId, updates, scopeFilter);\n\n      if (!updated) {\n        return { content: [{ type: \"text\" as const, text: `Memory ${memoryId} not found or access denied.` }] };\n      }\n\n      return {\n        content: [{ type: \"text\" as const, text: `Updated memory ${updated.id.slice(0, 8)}...: \"${updated.text.slice(0, 80)}${updated.text.length > 80 ? \"...\" : \"\"}\"` }],\n      };\n    } catch (error) {\n      return { content: [{ type: \"text\" as const, text: `Memory update failed: ${error instanceof Error ? error.message : String(error)}` }] };\n    }\n  },\n);\n\n// --- memory_list ---\nserver.tool(\n  \"memory_list\",\n  \"List recent memories with optional filtering by scope and category.\",\n  {\n    limit: z.number().optional().describe(\"Max memories to list (default: 10, max: 50)\"),\n    offset: z.number().optional().describe(\"Number of memories to skip (default: 0)\"),\n    scope: z.string().optional().describe(\"Filter by specific scope\"),\n    category: z.enum([\"preference\", \"fact\", \"decision\", \"entity\", \"other\"]).optional(),\n  },\n  async ({ limit = 10, offset = 0, scope, category }) => {\n    try {\n      const safeLimit = clampInt(limit, 1, 50);\n      const safeOffset = clampInt(offset, 0, 1000);\n\n      let scopeFilter = scopeManager.getAccessibleScopes();\n      if (scope) {\n        if (scopeManager.isAccessible(scope)) {\n          scopeFilter = [scope];\n        } else {\n          return { content: [{ type: \"text\" as const, text: `Access denied to scope: ${scope}` }] };\n        }\n      }\n\n      const entries = await store.list(scopeFilter, category, safeLimit, safeOffset);\n\n      if (entries.length === 0) {\n        return { content: [{ type: \"text\" as const, text: \"No memories found.\" }] };\n      }\n\n      const text = entries\n        .map((entry, i) => {\n          const date = new Date(entry.timestamp).toISOString().split(\"T\")[0];\n          return `${safeOffset + i + 1}. [${entry.id}] [${entry.category}:${entry.scope}] ${entry.text.slice(0, 100)}${entry.text.length > 100 ? \"...\" : \"\"} (${date})`;\n        })\n        .join(\"\\n\");\n\n      return { content: [{ type: \"text\" as const, text: `Recent memories (showing ${entries.length}):\\n\\n${text}` }] };\n    } catch (error) {\n      return { content: [{ type: \"text\" as const, text: `Failed to list memories: ${error instanceof Error ? error.message : String(error)}` }] };\n    }\n  },\n);\n\n// --- memory_stats ---\nserver.tool(\n  \"memory_stats\",\n  \"Get statistics about memory usage, scopes, and categories.\",\n  {\n    scope: z.string().optional().describe(\"Specific scope to get stats for\"),\n  },\n  async ({ scope }) => {\n    try {\n      let scopeFilter = scopeManager.getAccessibleScopes();\n      if (scope) {\n        if (scopeManager.isAccessible(scope)) {\n          scopeFilter = [scope];\n        } else {\n          return { content: [{ type: \"text\" as const, text: `Access denied to scope: ${scope}` }] };\n        }\n      }\n\n      const stats = await store.stats(scopeFilter);\n      const scopeManagerStats = scopeManager.getStats();\n      const retrievalConfig = retriever.getConfig();\n\n      const text = [\n        `Memory Statistics:`,\n        `  Total memories: ${stats.totalCount}`,\n        `  Available scopes: ${scopeManagerStats.totalScopes}`,\n        `  Retrieval mode: ${retrievalConfig.mode}`,\n        `  FTS support: ${store.hasFtsSupport ? \"Yes\" : \"No\"}`,\n        ``,\n        `Memories by scope:`,\n        ...Object.entries(stats.scopeCounts).map(\n          ([s, count]) => `  ${s}: ${count}`,\n        ),\n        ``,\n        `Memories by category:`,\n        ...Object.entries(stats.categoryCounts).map(\n          ([c, count]) => `  ${c}: ${count}`,\n        ),\n      ].join(\"\\n\");\n\n      return { content: [{ type: \"text\" as const, text }] };\n    } catch (error) {\n      return { content: [{ type: \"text\" as const, text: `Failed to get memory stats: ${error instanceof Error ? error.message : String(error)}` }] };\n    }\n  },\n);\n\n// ============================================================================\n// Start\n// ============================================================================\n\nasync function main() {\n  const transport = new StdioServerTransport();\n  await server.connect(transport);\n  log.error(\"mnemo MCP server started (stdio)\");\n}\n\nmain().catch((err) => {\n  log.error(\"Fatal:\", err);\n  process.exit(1);\n});\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/src/memory-categories.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Memory Categories — 6-category classification system
+ *
+ * UserMemory: profile, preferences, entities, events
+ * AgentMemory: cases, patterns
+ */
+export declare const MEMORY_CATEGORIES: readonly ["profile", "preferences", "entities", "events", "cases", "patterns"];
+export type MemoryCategory = (typeof MEMORY_CATEGORIES)[number];
+/** Categories that always merge (skip dedup entirely). */
+export declare const ALWAYS_MERGE_CATEGORIES: Set<"profile" | "preferences" | "entities" | "events" | "cases" | "patterns">;
+/** Categories that support MERGE decision from LLM dedup. */
+export declare const MERGE_SUPPORTED_CATEGORIES: Set<"profile" | "preferences" | "entities" | "events" | "cases" | "patterns">;
+/** Categories that are append-only (CREATE or SKIP only, no MERGE). */
+export declare const APPEND_ONLY_CATEGORIES: Set<"profile" | "preferences" | "entities" | "events" | "cases" | "patterns">;
+/** Memory tier levels for lifecycle management. */
+export type MemoryTier = "core" | "working" | "peripheral";
+/** A candidate memory extracted from conversation by LLM. */
+export type CandidateMemory = {
+    category: MemoryCategory;
+    abstract: string;
+    overview: string;
+    content: string;
+};
+/** Dedup decision from LLM. */
+export type DedupDecision = "create" | "merge" | "skip" | "support" | "contextualize" | "contradict";
+export type DedupResult = {
+    decision: DedupDecision;
+    reason: string;
+    matchId?: string;
+    contextLabel?: string;
+};
+export type ExtractionStats = {
+    created: number;
+    merged: number;
+    skipped: number;
+    supported?: number;
+};
+/** Validate and normalize a category string. */
+export declare function normalizeCategory(raw: string): MemoryCategory | null;
+//# sourceMappingURL=memory-categories.d.ts.map

package/dist/src/memory-categories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-categories.d.ts","sourceRoot":"","sources":["../../src/memory-categories.ts"],"names":[],"mappings":"AACA;;;;;GAKG;AAEH,eAAO,MAAM,iBAAiB,gFAOpB,CAAC;AAEX,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEhE,0DAA0D;AAC1D,eAAO,MAAM,uBAAuB,+EAAuC,CAAC;AAE5E,6DAA6D;AAC7D,eAAO,MAAM,0BAA0B,+EAIrC,CAAC;AAEH,uEAAuE;AACvE,eAAO,MAAM,sBAAsB,+EAGjC,CAAC;AAEH,mDAAmD;AACnD,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,SAAS,GAAG,YAAY,CAAC;AAE3D,6DAA6D;AAC7D,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,EAAE,cAAc,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,+BAA+B;AAC/B,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,eAAe,GAAG,YAAY,CAAC;AAErG,MAAM,MAAM,WAAW,GAAG;IACxB,QAAQ,EAAE,aAAa,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,gDAAgD;AAChD,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAMpE"}

package/dist/src/memory-categories.js

@@ -0,0 +1,33 @@
+const MEMORY_CATEGORIES = [
+  "profile",
+  "preferences",
+  "entities",
+  "events",
+  "cases",
+  "patterns"
+];
+const ALWAYS_MERGE_CATEGORIES = /* @__PURE__ */ new Set(["profile"]);
+const MERGE_SUPPORTED_CATEGORIES = /* @__PURE__ */ new Set([
+  "preferences",
+  "entities",
+  "patterns"
+]);
+const APPEND_ONLY_CATEGORIES = /* @__PURE__ */ new Set([
+  "events",
+  "cases"
+]);
+function normalizeCategory(raw) {
+  const lower = raw.toLowerCase().trim();
+  if (MEMORY_CATEGORIES.includes(lower)) {
+    return lower;
+  }
+  return null;
+}
+export {
+  ALWAYS_MERGE_CATEGORIES,
+  APPEND_ONLY_CATEGORIES,
+  MEMORY_CATEGORIES,
+  MERGE_SUPPORTED_CATEGORIES,
+  normalizeCategory
+};
+//# sourceMappingURL=memory-categories.js.map

package/dist/src/memory-categories.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/memory-categories.ts"],
+  "sourcesContent": ["// SPDX-License-Identifier: MIT\n/**\n * Memory Categories \u2014 6-category classification system\n *\n * UserMemory: profile, preferences, entities, events\n * AgentMemory: cases, patterns\n */\n\nexport const MEMORY_CATEGORIES = [\n  \"profile\",\n  \"preferences\",\n  \"entities\",\n  \"events\",\n  \"cases\",\n  \"patterns\",\n] as const;\n\nexport type MemoryCategory = (typeof MEMORY_CATEGORIES)[number];\n\n/** Categories that always merge (skip dedup entirely). */\nexport const ALWAYS_MERGE_CATEGORIES = new Set<MemoryCategory>([\"profile\"]);\n\n/** Categories that support MERGE decision from LLM dedup. */\nexport const MERGE_SUPPORTED_CATEGORIES = new Set<MemoryCategory>([\n  \"preferences\",\n  \"entities\",\n  \"patterns\",\n]);\n\n/** Categories that are append-only (CREATE or SKIP only, no MERGE). */\nexport const APPEND_ONLY_CATEGORIES = new Set<MemoryCategory>([\n  \"events\",\n  \"cases\",\n]);\n\n/** Memory tier levels for lifecycle management. */\nexport type MemoryTier = \"core\" | \"working\" | \"peripheral\";\n\n/** A candidate memory extracted from conversation by LLM. */\nexport type CandidateMemory = {\n  category: MemoryCategory;\n  abstract: string; // L0: one-sentence index\n  overview: string; // L1: structured markdown summary\n  content: string; // L2: full narrative\n};\n\n/** Dedup decision from LLM. */\nexport type DedupDecision = \"create\" | \"merge\" | \"skip\" | \"support\" | \"contextualize\" | \"contradict\";\n\nexport type DedupResult = {\n  decision: DedupDecision;\n  reason: string;\n  matchId?: string; // ID of existing memory to merge with\n  contextLabel?: string; // Optional context label for support/contextualize/contradict\n};\n\nexport type ExtractionStats = {\n  created: number;\n  merged: number;\n  skipped: number;\n  supported?: number; // context-aware support count\n};\n\n/** Validate and normalize a category string. */\nexport function normalizeCategory(raw: string): MemoryCategory | null {\n  const lower = raw.toLowerCase().trim();\n  if ((MEMORY_CATEGORIES as readonly string[]).includes(lower)) {\n    return lower as MemoryCategory;\n  }\n  return null;\n}\n"],
+  "mappings": "AAQO,MAAM,oBAAoB;AAAA,EAC/B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAKO,MAAM,0BAA0B,oBAAI,IAAoB,CAAC,SAAS,CAAC;AAGnE,MAAM,6BAA6B,oBAAI,IAAoB;AAAA,EAChE;AAAA,EACA;AAAA,EACA;AACF,CAAC;AAGM,MAAM,yBAAyB,oBAAI,IAAoB;AAAA,EAC5D;AAAA,EACA;AACF,CAAC;AA+BM,SAAS,kBAAkB,KAAoC;AACpE,QAAM,QAAQ,IAAI,YAAY,EAAE,KAAK;AACrC,MAAK,kBAAwC,SAAS,KAAK,GAAG;AAC5D,WAAO;AAAA,EACT;AACA,SAAO;AACT;",
+  "names": []
+}