@llmnesia/mcp 0.2.4 → 0.2.6

package/dist/{chunk-JSNSTAFD.js → chunk-YRK2DRGG.js}

@@ -38,7 +38,7 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 ));
 
 // src/version.ts
-var VERSION = true ? "0.2.4" : "0.0.0-dev";
+var VERSION = true ? "0.2.6" : "0.0.0-dev";
 
 export {
   __require,

package/dist/{cli-ZEA7WTVW.js → cli-DRB4DVH3.js}

@@ -4,23 +4,26 @@ const require = __llmnesiaCreateRequire(import.meta.url);
 import {
   Corpus,
   SearchIndex,
+  compactCorpus,
   deleteIndexDb,
   drainInbox,
   ingestFile,
+  inspectCorpusStorage,
   installRuntime,
   isSelfUpdateDisabled,
   openSearchIndex,
+  readAutomaticMaintenanceState,
   resolveCorpusDir,
   runtimeBinDir,
   staleIndexFiles,
   uninstallRuntime
-} from "./chunk-NSVHWVEK.js";
+} from "./chunk-HL5QE57W.js";
 import {
   VERSION,
   __commonJS,
   __require,
   __toESM
-} from "./chunk-JSNSTAFD.js";
+} from "./chunk-YRK2DRGG.js";
 
 // ../node_modules/isexe/windows.js
 var require_windows = __commonJS({
@@ -28,7 +31,7 @@ var require_windows = __commonJS({
     "use strict";
     module.exports = isexe;
     isexe.sync = sync;
-    var fs2 = __require("fs");
+    var fs = __require("fs");
     function checkPathExt(path, options) {
       var pathext = options.pathExt !== void 0 ? options.pathExt : process.env.PATHEXT;
       if (!pathext) {
@@ -53,12 +56,12 @@ var require_windows = __commonJS({
       return checkPathExt(path, options);
     }
     function isexe(path, options, cb) {
-      fs2.stat(path, function(er, stat6) {
+      fs.stat(path, function(er, stat6) {
         cb(er, er ? false : checkStat(stat6, path, options));
       });
     }
     function sync(path, options) {
-      return checkStat(fs2.statSync(path), path, options);
+      return checkStat(fs.statSync(path), path, options);
     }
   }
 });
@@ -69,14 +72,14 @@ var require_mode = __commonJS({
     "use strict";
     module.exports = isexe;
     isexe.sync = sync;
-    var fs2 = __require("fs");
+    var fs = __require("fs");
     function isexe(path, options, cb) {
-      fs2.stat(path, function(er, stat6) {
+      fs.stat(path, function(er, stat6) {
         cb(er, er ? false : checkStat(stat6, options));
       });
     }
     function sync(path, options) {
-      return checkStat(fs2.statSync(path), options);
+      return checkStat(fs.statSync(path), options);
     }
     function checkStat(stat6, options) {
       return stat6.isFile() && checkMode(stat6, options);
@@ -101,7 +104,7 @@ var require_mode = __commonJS({
 var require_isexe = __commonJS({
   "../node_modules/isexe/index.js"(exports, module) {
     "use strict";
-    var fs2 = __require("fs");
+    var fs = __require("fs");
     var core;
     if (process.platform === "win32" || global.TESTING_WINDOWS) {
       core = require_windows();
@@ -366,16 +369,16 @@ var require_shebang_command = __commonJS({
 var require_readShebang = __commonJS({
   "../node_modules/cross-spawn/lib/util/readShebang.js"(exports, module) {
     "use strict";
-    var fs2 = __require("fs");
+    var fs = __require("fs");
     var shebangCommand = require_shebang_command();
     function readShebang(command) {
       const size = 150;
       const buffer = Buffer.alloc(size);
       let fd;
       try {
-        fd = fs2.openSync(command, "r");
-        fs2.readSync(fd, buffer, 0, size, 0);
-        fs2.closeSync(fd);
+        fd = fs.openSync(command, "r");
+        fs.readSync(fd, buffer, 0, size, 0);
+        fs.closeSync(fd);
       } catch (e) {
       }
       return shebangCommand(buffer.toString());
@@ -525,7 +528,7 @@ var require_cross_spawn = __commonJS({
 
 // src/cli.ts
 import { createInterface } from "readline/promises";
-import { join as join7 } from "path";
+import { join as join6 } from "path";
 
 // ../packages/native-host/install.mjs
 import { execFile } from "child_process";
@@ -684,6 +687,7 @@ async function installNativeHost({ ids = [], corpus, codexHome, force = false, q
   }
   const allIds = [.../* @__PURE__ */ new Set([STORE_EXTENSION_ID, ...ids])];
   const allowedOrigins = allIds.map((id) => `chrome-extension://${id}/`);
+  const viewerExtensionId = ids[0] ?? STORE_EXTENSION_ID;
   if (await supportedBrowserCount(isWindows2) === 0) {
     throw new Error(
       "LLMnesia couldn't find Chrome, Brave, Edge, or Chromium. Open your browser once so it creates a profile, then retry. Safari and Firefox are not supported yet. Nothing was installed."
@@ -717,7 +721,7 @@ async function installNativeHost({ ids = [], corpus, codexHome, force = false, q
     corpusRootChanged = false;
     await writeFile(
       configPath,
-      `${JSON.stringify({ ...existing, corpusRoot: existingRoot, codexHome: resolvedCodexHome }, null, 2)}
+      `${JSON.stringify({ ...existing, corpusRoot: existingRoot, codexHome: resolvedCodexHome, viewerExtensionId }, null, 2)}
 `,
       { encoding: "utf8", mode: 384 }
     );
@@ -729,7 +733,7 @@ async function installNativeHost({ ids = [], corpus, codexHome, force = false, q
   } else {
     await writeFile(
       configPath,
-      `${JSON.stringify({ ...existing ?? {}, corpusRoot, codexHome: resolvedCodexHome }, null, 2)}
+      `${JSON.stringify({ ...existing ?? {}, corpusRoot, codexHome: resolvedCodexHome, viewerExtensionId }, null, 2)}
 `,
       { encoding: "utf8", mode: 384 }
     );
@@ -3749,157 +3753,6 @@ function formatDoctorReport(report) {
   return report.checks.map((c) => `${icon[c.status]} ${c.name}: ${c.detail}`).join("\n");
 }
 
-// src/storageMaintenance.ts
-import { promises as fs } from "fs";
-import { join as join6 } from "path";
-async function inspectCorpusStorage(corpus) {
-  const conversations = await corpus.conversationStorageStats();
-  const processed = await directoryFiles(corpus.paths.processedDir);
-  const quarantine = await directoryFiles(corpus.paths.quarantineDir);
-  const activeNames = [
-    corpus.paths.indexDbFile,
-    `${corpus.paths.indexDbFile}-wal`,
-    `${corpus.paths.indexDbFile}-shm`
-  ];
-  const activeIndex = await explicitFiles(activeNames);
-  const staleNames = await staleIndexFiles(corpus.paths.indexDir);
-  const stalePaths = staleNames.flatMap((name) => {
-    const base = join6(corpus.paths.indexDir, name);
-    return [base, `${base}-wal`, `${base}-shm`];
-  });
-  const staleIndexes = await explicitFiles(stalePaths);
-  const root = await directoryFiles(corpus.paths.root);
-  const classifiedBytes = conversations.legacyBytes + conversations.compressedBytes + processed.bytes + quarantine.bytes + activeIndex.bytes + staleIndexes.bytes;
-  const classifiedFiles = conversations.legacyFiles + conversations.compressedFiles + processed.files + quarantine.files + activeIndex.files + staleIndexes.files;
-  const other = {
-    files: Math.max(0, root.files - classifiedFiles),
-    bytes: Math.max(0, root.bytes - classifiedBytes)
-  };
-  return {
-    root: corpus.paths.root,
-    conversations,
-    processed,
-    quarantine,
-    activeIndex,
-    staleIndexes,
-    other,
-    totalBytes: root.bytes,
-    immediatelyReclaimableBytes: processed.bytes + staleIndexes.bytes
-  };
-}
-async function compactCorpus(corpus, options = {}) {
-  const dryRun = options.dryRun === true;
-  const before = await inspectCorpusStorage(corpus);
-  if (dryRun) {
-    const compression = await corpus.migrateLegacyConversations({ dryRun: true });
-    const compressionSavings = Math.max(
-      0,
-      compression.legacyBytes + compression.compressedBytes - compression.projectedCompressedBytes
-    );
-    return {
-      dryRun: true,
-      before,
-      compression,
-      processedRemoved: before.processed,
-      staleIndexesRemoved: before.staleIndexes,
-      after: null,
-      reclaimedBytes: before.immediatelyReclaimableBytes + compressionSavings
-    };
-  }
-  await corpus.init();
-  const processedRemoved = await removeDirectoryFiles(corpus.paths.processedDir);
-  const index = await openSearchIndex(corpus);
-  try {
-    index.compact();
-  } finally {
-    index.close();
-  }
-  const appliedCompression = await corpus.migrateLegacyConversations();
-  if (appliedCompression.failures.length > 0) {
-    throw new Error(
-      `Corpus compression left ${appliedCompression.failures.length} legacy file(s) untouched; stale indexes were preserved. Run compact again after fixing the reported files.`
-    );
-  }
-  const staleIndexesRemoved = await removeStaleIndexes(corpus);
-  const after = await inspectCorpusStorage(corpus);
-  return {
-    dryRun: false,
-    before,
-    compression: appliedCompression,
-    processedRemoved,
-    staleIndexesRemoved,
-    after,
-    reclaimedBytes: Math.max(0, before.totalBytes - after.totalBytes)
-  };
-}
-async function removeStaleIndexes(corpus) {
-  const names = await staleIndexFiles(corpus.paths.indexDir);
-  const paths2 = names.flatMap((name) => {
-    const base = join6(corpus.paths.indexDir, name);
-    return [base, `${base}-wal`, `${base}-shm`];
-  });
-  const before = await explicitFiles(paths2);
-  for (const name of names) {
-    await deleteIndexDb(join6(corpus.paths.indexDir, name));
-  }
-  return before;
-}
-async function removeDirectoryFiles(dir) {
-  const before = await directoryFiles(dir);
-  await removeFilesRecursively(dir);
-  return before;
-}
-async function removeFilesRecursively(dir) {
-  let entries;
-  try {
-    entries = await fs.readdir(dir, { withFileTypes: true });
-  } catch {
-    return;
-  }
-  for (const entry of entries) {
-    const path = join6(dir, entry.name);
-    if (entry.isDirectory()) await removeFilesRecursively(path);
-    else if (entry.isFile()) await fs.rm(path, { force: true });
-  }
-}
-async function explicitFiles(files) {
-  let count = 0;
-  let bytes = 0;
-  for (const file of files) {
-    try {
-      const stat6 = await fs.stat(file);
-      if (stat6.isFile()) {
-        count += 1;
-        bytes += stat6.size;
-      }
-    } catch {
-    }
-  }
-  return { files: count, bytes };
-}
-async function directoryFiles(dir) {
-  let entries;
-  try {
-    entries = await fs.readdir(dir, { withFileTypes: true });
-  } catch {
-    return { files: 0, bytes: 0 };
-  }
-  let files = 0;
-  let bytes = 0;
-  for (const entry of entries) {
-    const path = join6(dir, entry.name);
-    if (entry.isDirectory()) {
-      const nested = await directoryFiles(path);
-      files += nested.files;
-      bytes += nested.bytes;
-    } else if (entry.isFile()) {
-      files += 1;
-      bytes += (await fs.stat(path)).size;
-    }
-  }
-  return { files, bytes };
-}
-
 // src/cli.ts
 var USAGE = `llmnesia-mcp ${VERSION}
 
@@ -4168,6 +4021,7 @@ async function main() {
     case "stats": {
       const stats = await corpus.stats();
       const storage = await inspectCorpusStorage(corpus);
+      const maintenance = await readAutomaticMaintenanceState(corpus);
       const platforms = Object.entries(stats.byPlatform).sort((a, b) => b[1] - a[1]).map(([p, n]) => `    ${p}: ${n}`).join("\n");
       process.stdout.write(
         `Corpus: ${root}
@@ -4181,7 +4035,8 @@ ${platforms}
     processed:     ${formatBytes(storage.processed.bytes)} (${storage.processed.files} reclaimable files)
     stale indexes: ${formatBytes(storage.staleIndexes.bytes)}
     quarantine:    ${formatBytes(storage.quarantine.bytes)}
-`
+` + (maintenance ? `  maintenance:   ${formatMaintenanceState(maintenance)}
+` : "")
       );
       return 0;
     }
@@ -4220,7 +4075,7 @@ Corpus now uses ${formatBytes(result.after?.totalBytes ?? 0)}.
       }
       const stale = await staleIndexFiles(corpus.paths.indexDir);
       for (const name of stale) {
-        await deleteIndexDb(join7(corpus.paths.indexDir, name));
+        await deleteIndexDb(join6(corpus.paths.indexDir, name));
       }
       if (stale.length > 0) {
         process.stdout.write(
@@ -4287,6 +4142,18 @@ function formatBytes(bytes) {
   }
   return `${value.toFixed(value >= 10 ? 1 : 2)} ${unit}`;
 }
+function formatMaintenanceState(state) {
+  if (state.status === "complete") {
+    return `complete${state.completedAt ? ` (${new Date(state.completedAt).toISOString()})` : ""}`;
+  }
+  if (state.status === "waiting" && state.nextEligibleAt) {
+    return `automatic cleanup scheduled after ${new Date(state.nextEligibleAt).toISOString()}`;
+  }
+  if (state.status === "failed" && state.nextEligibleAt) {
+    return `will retry after ${new Date(state.nextEligibleAt).toISOString()}`;
+  }
+  return state.status;
+}
 function formatCompactPreview(result) {
   const { before, compression } = result;
   const compressionSavings = Math.max(

package/dist/cli.js

@@ -3,7 +3,7 @@ import { createRequire as __llmnesiaCreateRequire } from "node:module";
 const require = __llmnesiaCreateRequire(import.meta.url);
 import {
   VERSION
-} from "./chunk-JSNSTAFD.js";
+} from "./chunk-YRK2DRGG.js";
 
 // src/nodeDownload.ts
 var NODE_DOWNLOAD_URLS = {
@@ -141,7 +141,7 @@ async function bootstrap() {
     await guideUnsupportedNodeVersion(process.versions.node);
     return 1;
   }
-  const { main } = await import("./cli-ZEA7WTVW.js");
+  const { main } = await import("./cli-DRB4DVH3.js");
   return main();
 }
 bootstrap().then((code) => {

package/dist/mcp.js

@@ -2,20 +2,23 @@
 import { createRequire as __llmnesiaCreateRequire } from "node:module";
 const require = __llmnesiaCreateRequire(import.meta.url);
 import {
+  AUTO_MAINTENANCE_RECHECK_MS,
   Corpus,
   describeOutcome,
   drainInbox,
   openSearchIndex,
   pendingInboxFiles,
+  readNativeHostViewerExtensionId,
   resolveCorpusDir,
+  runAutomaticMaintenance,
   scheduleSelfUpdate
-} from "./chunk-NSVHWVEK.js";
+} from "./chunk-HL5QE57W.js";
 import {
   VERSION,
   __commonJS,
   __export,
   __toESM
-} from "./chunk-JSNSTAFD.js";
+} from "./chunk-YRK2DRGG.js";
 
 // ../node_modules/ajv/dist/compile/codegen/code.js
 var require_code = __commonJS({
@@ -21393,6 +21396,9 @@ function describeIssues(error2) {
 
 // src/service.ts
 var STALE_AFTER_HOURS = 48;
+var AUTO_MAINTENANCE_START_DELAY_MS = 6e4;
+var AUTO_MAINTENANCE_IDLE_MS = 3e4;
+var AUTO_MAINTENANCE_BUSY_RETRY_MS = 3e4;
 var CompanionService = class _CompanionService {
   constructor(corpus, index, onDrainError, memoryWriteCap) {
     this.corpus = corpus;
@@ -21409,6 +21415,10 @@ var CompanionService = class _CompanionService {
   refreshChain = Promise.resolve();
   /** Memories written since this process started; the per-session cap counts these. */
   memoriesWritten = 0;
+  activeOperations = 0;
+  lastOperationAt = Date.now();
+  maintenanceTimer;
+  closed = false;
   static async open(root, options = {}) {
     const corpus = new Corpus(root);
     const index = await openSearchIndex(corpus);
@@ -21419,8 +21429,71 @@ var CompanionService = class _CompanionService {
       options.memoryWriteCap ?? DEFAULT_MEMORY_WRITE_CAP
     );
     await service.refresh();
+    if (options.automaticMaintenance) {
+      service.scheduleAutomaticMaintenance(options.automaticMaintenance);
+    }
     return service;
   }
+  /** Let the MCP wrapper expose activity to the idle-only maintenance scheduler. */
+  async runWithActivity(operation) {
+    this.activeOperations += 1;
+    this.lastOperationAt = Date.now();
+    try {
+      return await operation();
+    } finally {
+      this.activeOperations -= 1;
+      this.lastOperationAt = Date.now();
+    }
+  }
+  scheduleAutomaticMaintenance(options) {
+    const {
+      delayMs = AUTO_MAINTENANCE_START_DELAY_MS,
+      idleMs = AUTO_MAINTENANCE_IDLE_MS,
+      busyRetryMs = AUTO_MAINTENANCE_BUSY_RETRY_MS,
+      onOutcome,
+      ...runOptions
+    } = options;
+    const schedule = (delay) => {
+      if (this.closed) return;
+      this.maintenanceTimer = setTimeout(
+        attempt,
+        Math.max(0, Math.min(delay, 2147483647))
+      );
+      this.maintenanceTimer.unref?.();
+    };
+    const attempt = () => {
+      this.maintenanceTimer = void 0;
+      if (this.closed) return;
+      const idleFor = Date.now() - this.lastOperationAt;
+      if (this.activeOperations > 0 || idleFor < idleMs) {
+        schedule(Math.max(busyRetryMs, idleMs - idleFor));
+        return;
+      }
+      void runAutomaticMaintenance(this.corpus, this.index, runOptions).then(
+        (outcome) => {
+          onOutcome?.(outcome);
+          const current = Date.now();
+          if (outcome.action === "deferred") schedule(outcome.until - current);
+          else if (outcome.action === "failed") schedule(outcome.retryAt - current);
+          else if (outcome.action === "locked") schedule(busyRetryMs);
+          else if (outcome.action === "recently-checked") {
+            schedule(outcome.completedAt + (runOptions.recheckMs ?? AUTO_MAINTENANCE_RECHECK_MS) - current);
+          } else if (outcome.action === "compacted" || outcome.action === "no-work") {
+            schedule(runOptions.recheckMs ?? AUTO_MAINTENANCE_RECHECK_MS);
+          }
+        },
+        (error2) => {
+          onOutcome?.({
+            action: "failed",
+            error: error2 instanceof Error ? error2.message : String(error2),
+            retryAt: Date.now() + busyRetryMs
+          });
+          schedule(busyRetryMs);
+        }
+      );
+    };
+    schedule(delayMs);
+  }
   /**
    * Ingest whatever is waiting in `inbox/`. Never throws: a corrupt or
    * unreadable delta is reported and skipped rather than failing the read.
@@ -21547,6 +21620,9 @@ var CompanionService = class _CompanionService {
     };
   }
   close() {
+    this.closed = true;
+    if (this.maintenanceTimer) clearTimeout(this.maintenanceTimer);
+    this.maintenanceTimer = void 0;
     this.index.close();
   }
 };
@@ -21602,7 +21678,20 @@ var LazyResource = class {
 function jsonResult(payload) {
   return { content: [{ type: "text", text: JSON.stringify(payload, null, 2) }] };
 }
-var SOURCE_LINK_INSTRUCTION = "When answering from these conversations, always include a Sources section with a clickable Markdown link to every original chat you relied on whose `url` is non-empty. Do this automatically; do not wait for the user to ask for links.";
+var SOURCE_LINK_INSTRUCTION = "When answering from these conversations, always include a Sources section with a clickable Markdown link to every chat you relied on. Link its `sourceUrl`: this is the original chat URL when available, otherwise its local LLMnesia Viewer URL. Do this automatically; do not wait for the user to ask for links.";
+var STORE_EXTENSION_ID = "leekfgbdojiaabifbjbbgiiclannjdkf";
+var EXTENSION_ID_RE = /^[a-p]{32}$/;
+function viewerExtensionId() {
+  const configured = process.env.LLMNESIA_VIEWER_EXTENSION_ID?.trim() ?? readNativeHostViewerExtensionId();
+  return configured && EXTENSION_ID_RE.test(configured) ? configured : STORE_EXTENSION_ID;
+}
+function viewerUrl(docId) {
+  return `chrome-extension://${viewerExtensionId()}/viewer.html?docId=${encodeURIComponent(docId)}`;
+}
+function sourceLinks(docId, originalUrl) {
+  const localViewerUrl = viewerUrl(docId);
+  return originalUrl ? { viewerUrl: localViewerUrl, sourceUrl: originalUrl, sourceKind: "original" } : { viewerUrl: localViewerUrl, sourceUrl: localViewerUrl, sourceKind: "viewer" };
+}
 function sourcedJsonResult(payload) {
   return jsonResult({ responseInstruction: SOURCE_LINK_INSTRUCTION, ...payload });
 }
@@ -21636,12 +21725,28 @@ async function runServe() {
       onDrainError: (error2) => process.stderr.write(
         `llmnesia: inbox drain failed, serving the existing index: ${error2 instanceof Error ? error2.message : String(error2)}
 `
-      )
+      ),
+      automaticMaintenance: {
+        onOutcome: (outcome) => {
+          if (outcome.action === "failed") {
+            process.stderr.write(
+              `llmnesia: automatic storage maintenance will retry later: ${outcome.error}
+`
+            );
+          } else if (outcome.action === "compacted" && outcome.report.reclaimedBytes > 0) {
+            process.stderr.write(
+              `llmnesia: automatic storage maintenance reclaimed ${outcome.report.reclaimedBytes} bytes
+`
+            );
+          }
+        }
+      }
     })
   );
   const withService = async (operation) => {
     try {
-      return await operation(await service.get(5e3));
+      const ready = await service.get(5e3);
+      return await ready.runWithActivity(() => operation(ready));
     } catch (err) {
       if (err instanceof ResourcePreparingError) {
         return errorResult("LLMnesia is still preparing the local conversation index. Retry this tool shortly.");
@@ -21652,14 +21757,14 @@ async function runServe() {
   const server = new McpServer(
     { name: "llmnesia", version: VERSION },
     {
-      instructions: "LLMnesia is the user's searchable archive of past AI chats. Whenever the user asks about 'my chats', 'my conversations', or anything they previously said, discussed, decided, or worked on, use LLMnesia before built-in task/thread lists, local file scans, or memory, unless they explicitly ask only about Codex tasks. Use list_conversations with sort='oldest' for their earliest chat, search_conversations to find relevant prior chats, get_conversation to read a full transcript, and list_recent to see what they worked on lately. Search and list results carry a `corpus` block saying when the corpus last received data; if a chat the user expects is missing, check corpus_status before concluding it does not exist. Whenever you answer using LLMnesia, always include a Sources section with clickable links to the original chats you used when their `url` fields are non-empty; never wait for the user to ask."
+      instructions: "LLMnesia is the user's searchable archive of past AI chats. Whenever the user asks about 'my chats', 'my conversations', or anything they previously said, discussed, decided, or worked on, use LLMnesia before built-in task/thread lists, local file scans, or memory, unless they explicitly ask only about Codex tasks. Use list_conversations with sort='oldest' for their earliest chat, search_conversations to find relevant prior chats, get_conversation to read a full transcript, and list_recent to see what they worked on lately. Search and list results carry a `corpus` block saying when the corpus last received data; if a chat the user expects is missing, check corpus_status before concluding it does not exist. Whenever you answer using LLMnesia, always include a Sources section with clickable links to the chats you used. Link each result's `sourceUrl`, which is its original URL when available or its local LLMnesia Viewer URL otherwise; never wait for the user to ask."
     }
   );
   server.registerTool(
     "search_conversations",
     {
       title: "Search conversations",
-      description: "Full-text search across the user's past AI conversations. Call this whenever the user asks what they said, thought, discussed, decided, or worked on previously \u2014 even if the question doesn't say 'search' \u2014 rather than answering from conversation memory alone or claiming no record exists. Returns matching conversations with a highlighted snippet, ranked by relevance. Defaults to recall-first matching (any term); pass match_mode to answer questions where a wrong hit matters, such as whether or how often something was discussed. Every result includes its original-chat URL when available; always link the chats used in the answer.",
+      description: "Full-text search across the user's past AI conversations. Call this whenever the user asks what they said, thought, discussed, decided, or worked on previously \u2014 even if the question doesn't say 'search' \u2014 rather than answering from conversation memory alone or claiming no record exists. Returns matching conversations with a highlighted snippet, ranked by relevance. Defaults to recall-first matching (any term); pass match_mode to answer questions where a wrong hit matters, such as whether or how often something was discussed. Every result includes `sourceUrl`: the original chat URL when available, otherwise its local LLMnesia Viewer URL. Always link the chats used in the answer.",
       inputSchema: {
         query: external_exports.string().describe("Search terms (natural words; FTS operators are not needed)."),
         match_mode: external_exports.enum(["any", "all", "phrase"]).optional().describe(
@@ -21698,6 +21803,7 @@ async function runServe() {
             title: h.title,
             platform: h.platform,
             url: h.url,
+            ...sourceLinks(h.docId, h.url),
             createdAt: h.createdAt,
             score: Number(h.score.toFixed(4)),
             snippet: h.snippet,
@@ -21716,7 +21822,7 @@ async function runServe() {
     "get_conversation",
     {
       title: "Get conversation",
-      description: "Return the full transcript of one conversation by its id (the `id` from search results). The conversation includes its original-chat URL when available; always link it in an answer based on this transcript.",
+      description: "Return the full transcript of one conversation by its id (the `id` from search results). The conversation includes `sourceUrl`: its original-chat URL when available, otherwise its local LLMnesia Viewer URL. Always link it in an answer based on this transcript.",
       inputSchema: {
         id: external_exports.string().describe("The conversation id (docId), e.g. 'claude:abc-123'.")
       },
@@ -21733,7 +21839,10 @@ async function runServe() {
         return errorResult(`No conversation found with id '${args.id}'.`);
       }
       return sourcedJsonResult({
-        conversation: record2.conversation,
+        conversation: {
+          ...record2.conversation,
+          ...sourceLinks(record2.conversation.docId, record2.conversation.url)
+        },
         messages: record2.messages.map((m) => ({
           index: m.msgIndex,
           role: m.role,
@@ -21747,7 +21856,7 @@ async function runServe() {
     "list_recent",
     {
       title: "List recent conversations",
-      description: "List the user's most recently updated conversations (title + summary + original-chat URL), newest first. Always link the chats used in the answer.",
+      description: "List the user's most recently updated conversations (title + summary + source URL), newest first. `sourceUrl` is the original chat URL when available, otherwise its local LLMnesia Viewer URL. Always link the chats used in the answer.",
       inputSchema: {
         limit: external_exports.number().int().min(1).max(100).optional().describe("How many to return (default 10).")
       },
@@ -21770,6 +21879,7 @@ async function runServe() {
             title: e.title,
             platform: e.platform,
             url: e.url,
+            ...sourceLinks(e.docId, e.url),
             updatedAt: e.updatedAt,
             messageCount: e.messageCount,
             pinned: e.pinned,
@@ -21786,7 +21896,7 @@ async function runServe() {
     "list_conversations",
     {
       title: "List conversations by date",
-      description: "List conversation metadata in chronological order. Use sort='oldest' for the user's earliest or oldest chat, sort='newest' for most recently created chats, and sort='recent' for most recently updated chats. This is the complete corpus chronology, so do not scan LLMnesia's private files with shell commands. Entries include original-chat URLs when available; always link the chats used in the answer.",
+      description: "List conversation metadata in chronological order. Use sort='oldest' for the user's earliest or oldest chat, sort='newest' for most recently created chats, and sort='recent' for most recently updated chats. This is the complete corpus chronology, so do not scan LLMnesia's private files with shell commands. Entries include `sourceUrl`: the original chat URL when available, otherwise the local LLMnesia Viewer URL. Always link the chats used in the answer.",
       inputSchema: {
         sort: external_exports.enum(["recent", "oldest", "newest"]).optional().describe("Chronology: recent (default, updated), oldest (created), or newest (created)."),
         limit: external_exports.number().int().min(1).max(100).optional().describe("How many to return (default 10).")
@@ -21811,6 +21921,7 @@ async function runServe() {
             title: e.title,
             platform: e.platform,
             url: e.url,
+            ...sourceLinks(e.docId, e.url),
             createdAt: e.createdAt,
             updatedAt: e.updatedAt,
             messageCount: e.messageCount,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@llmnesia/mcp",
-  "version": "0.2.4",
+  "version": "0.2.6",
   "private": false,
   "type": "module",
   "comment:mcpName": "The MCP Registry's ownership marker: it must equal server.json's `name`, and the namespace must match how you authenticate with mcp-publisher. `com.llmnesia/...` requires DNS auth (a TXT record on llmnesia.com) — see docs/MCP_INSTALLER_BOARD.md.",

package/server.json

@@ -3,13 +3,13 @@
   "name": "com.llmnesia/mcp",
   "title": "LLMnesia",
   "description": "Search your AI chat history from Claude, Cursor, Codex, and other MCP clients.",
-  "version": "0.2.4",
+  "version": "0.2.6",
   "packages": [
     {
       "registryType": "npm",
       "registryBaseUrl": "https://registry.npmjs.org",
       "identifier": "@llmnesia/mcp",
-      "version": "0.2.4",
+      "version": "0.2.6",
       "transport": {
         "type": "stdio"
       }