@llmnesia/mcp 0.2.5 → 0.2.6

package/dist/{chunk-MTPXE734.js → chunk-HL5QE57W.js}

@@ -3,7 +3,7 @@ import { createRequire as __llmnesiaCreateRequire } from "node:module";
 const require = __llmnesiaCreateRequire(import.meta.url);
 import {
   VERSION
-} from "./chunk-BDR4JVMF.js";
+} from "./chunk-YRK2DRGG.js";
 
 // src/config.ts
 import { readFileSync } from "fs";
@@ -13,14 +13,22 @@ var CORPUS_FORMAT_VERSION = 2;
 function nativeHostConfigPath() {
   return join(homedir(), ".llmnesia", "config.json");
 }
-function readNativeHostCorpusRoot() {
+function readNativeHostConfig() {
   try {
     const parsed = JSON.parse(readFileSync(nativeHostConfigPath(), "utf8"));
-    return typeof parsed.corpusRoot === "string" ? parsed.corpusRoot : void 0;
+    return parsed && typeof parsed === "object" ? parsed : void 0;
   } catch {
     return void 0;
   }
 }
+function readNativeHostCorpusRoot() {
+  const root = readNativeHostConfig()?.corpusRoot;
+  return typeof root === "string" ? root : void 0;
+}
+function readNativeHostViewerExtensionId() {
+  const id = readNativeHostConfig()?.viewerExtensionId;
+  return typeof id === "string" ? id : void 0;
+}
 function resolveCorpusDir(explicit) {
   const raw = explicit ?? process.env.LLMNESIA_CORPUS_DIR ?? readNativeHostCorpusRoot() ?? "~/.llmnesia/corpus";
   return expandHome(raw);
@@ -2063,6 +2071,7 @@ function describeOutcome(outcome) {
 }
 
 export {
+  readNativeHostViewerExtensionId,
   resolveCorpusDir,
   staleIndexFiles,
   Corpus,

package/dist/{chunk-BDR4JVMF.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.5" : "0.0.0-dev";
+var VERSION = true ? "0.2.6" : "0.0.0-dev";
 
 export {
   __require,

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

@@ -17,13 +17,13 @@ import {
   runtimeBinDir,
   staleIndexFiles,
   uninstallRuntime
-} from "./chunk-MTPXE734.js";
+} from "./chunk-HL5QE57W.js";
 import {
   VERSION,
   __commonJS,
   __require,
   __toESM
-} from "./chunk-BDR4JVMF.js";
+} from "./chunk-YRK2DRGG.js";
 
 // ../node_modules/isexe/windows.js
 var require_windows = __commonJS({
@@ -687,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."
@@ -720,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 }
     );
@@ -732,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 }
     );

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-BDR4JVMF.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-OXKBAUBE.js");
+  const { main } = await import("./cli-DRB4DVH3.js");
   return main();
 }
 bootstrap().then((code) => {

package/dist/mcp.js

@@ -8,16 +8,17 @@ import {
   drainInbox,
   openSearchIndex,
   pendingInboxFiles,
+  readNativeHostViewerExtensionId,
   resolveCorpusDir,
   runAutomaticMaintenance,
   scheduleSelfUpdate
-} from "./chunk-MTPXE734.js";
+} from "./chunk-HL5QE57W.js";
 import {
   VERSION,
   __commonJS,
   __export,
   __toESM
-} from "./chunk-BDR4JVMF.js";
+} from "./chunk-YRK2DRGG.js";
 
 // ../node_modules/ajv/dist/compile/codegen/code.js
 var require_code = __commonJS({
@@ -21677,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 });
 }
@@ -21743,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(
@@ -21789,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,
@@ -21807,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'.")
       },
@@ -21824,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,
@@ -21838,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).")
       },
@@ -21861,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,
@@ -21877,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).")
@@ -21902,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.5",
+  "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.5",
+  "version": "0.2.6",
   "packages": [
     {
       "registryType": "npm",
       "registryBaseUrl": "https://registry.npmjs.org",
       "identifier": "@llmnesia/mcp",
-      "version": "0.2.5",
+      "version": "0.2.6",
       "transport": {
         "type": "stdio"
       }