@llmnesia/mcp 0.2.5 → 0.2.7

package/dist/{chunk-BDR4JVMF.js → chunk-CMQHGLAD.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.7" : "0.0.0-dev";
 
 export {
   __require,

package/dist/{chunk-MTPXE734.js → chunk-O34A5U2L.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-CMQHGLAD.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);
@@ -39,7 +47,7 @@ function expandHome(p) {
 import { join as join2 } from "path";
 import { readdir } from "fs/promises";
 import { createHash } from "crypto";
-var INDEX_FORMAT_VERSION = 3;
+var INDEX_FORMAT_VERSION = 4;
 function indexDbFilename(version) {
   return version === 1 ? "llmnesia.db" : `llmnesia-v${version}.db`;
 }
@@ -200,6 +208,8 @@ function canonicalConversationDoc(c) {
   assignIfDefined(out, "origin", c.origin);
   assignIfDefined(out, "accountId", c.accountId);
   assignIfDefined(out, "accountLabel", c.accountLabel);
+  if (c.models && c.models.length > 0) out.models = [...c.models];
+  assignIfDefined(out, "modelMetadataUpdatedAt", c.modelMetadataUpdatedAt);
   if (c.summary) {
     out.summary = {
       text: c.summary.text,
@@ -219,6 +229,7 @@ function canonicalMessageDoc(m) {
     text: m.text
   };
   assignIfDefined(out, "formattedText", m.formattedText);
+  assignIfDefined(out, "model", m.model);
   out.createdAt = m.createdAt;
   out.updatedAt = m.updatedAt;
   out.contentHash = m.contentHash;
@@ -896,6 +907,9 @@ function coerceMessage(docId, value) {
   if (typeof m.formattedText === "string") {
     message.formattedText = m.formattedText;
   }
+  if (typeof m.model === "string" && m.model.trim()) {
+    message.model = m.model.trim();
+  }
   if (typeof m.platformMessageId === "string") {
     message.platformMessageId = m.platformMessageId;
   } else if (m.platformMessageId === null) {
@@ -1000,7 +1014,8 @@ CREATE TABLE IF NOT EXISTS conversations (
   preview TEXT NOT NULL,
   pinned INTEGER NOT NULL,
   accountId TEXT,
-  accountLabel TEXT
+  accountLabel TEXT,
+  models TEXT
 );
 CREATE INDEX IF NOT EXISTS idx_conversations_platform ON conversations(platform);
 CREATE INDEX IF NOT EXISTS idx_conversations_createdAt ON conversations(createdAt);
@@ -1074,8 +1089,8 @@ var SearchIndex = class {
       deleteConversation: this.db.prepare("DELETE FROM conversations WHERE docId = ?"),
       insertConversation: this.db.prepare(
         `INSERT INTO conversations
-           (docId, platform, title, url, createdAt, updatedAt, messageCount, preview, pinned, accountId, accountLabel)
-         VALUES (@docId, @platform, @title, @url, @createdAt, @updatedAt, @messageCount, @preview, @pinned, @accountId, @accountLabel)`
+           (docId, platform, title, url, createdAt, updatedAt, messageCount, preview, pinned, accountId, accountLabel, models)
+         VALUES (@docId, @platform, @title, @url, @createdAt, @updatedAt, @messageCount, @preview, @pinned, @accountId, @accountLabel, @models)`
       ),
       deleteMemoryFts: this.db.prepare("DELETE FROM memories_fts WHERE memoryId = ?"),
       insertMemoryFts: this.db.prepare(
@@ -1119,14 +1134,16 @@ var SearchIndex = class {
     const orderBy = sort === "oldest" ? "createdAt ASC, updatedAt ASC" : sort === "newest" ? "createdAt DESC, updatedAt DESC" : "updatedAt DESC, createdAt DESC";
     const rows = this.db.prepare(
       `SELECT docId, platform, title, url, createdAt, updatedAt, messageCount, preview, pinned,
-                accountId, accountLabel
+                accountId, accountLabel, models
          FROM conversations ORDER BY ${orderBy} LIMIT ?`
     ).all(limit);
     return rows.map((r) => {
-      const { accountId, accountLabel, ...rest } = r;
+      const { accountId, accountLabel, models, ...rest } = r;
       const entry = { ...rest, pinned: r.pinned === 1 };
       if (accountId) entry.accountId = accountId;
       if (accountLabel) entry.accountLabel = accountLabel;
+      const parsedModels = parseModels(models);
+      if (parsedModels.length > 0) entry.models = parsedModels;
       return entry;
     });
   }
@@ -1213,7 +1230,8 @@ var SearchIndex = class {
       preview: conversation.preview ?? "",
       pinned: conversation.pinned ? 1 : 0,
       accountId: conversation.accountId ?? null,
-      accountLabel: conversation.accountLabel ?? null
+      accountLabel: conversation.accountLabel ?? null,
+      models: conversation.models?.length ? JSON.stringify(conversation.models) : null
     });
   }
   insertFtsRow(docId, msgIndex, role, text) {
@@ -1278,7 +1296,7 @@ var SearchIndex = class {
     const sql = `
       SELECT
         c.docId, c.platform, c.title, c.url, c.createdAt, c.updatedAt,
-        c.messageCount, c.preview, c.pinned, c.accountId, c.accountLabel,
+        c.messageCount, c.preview, c.pinned, c.accountId, c.accountLabel, c.models,
         m.msgIndex AS msgIndex, m.role AS role,
         bm25(messages_fts) AS bm25
       FROM messages_fts
@@ -1314,6 +1332,8 @@ var SearchIndex = class {
       };
       if (row.accountId) hit.accountId = row.accountId;
       if (row.accountLabel) hit.accountLabel = row.accountLabel;
+      const models = parseModels(row.models);
+      if (models.length > 0) hit.models = models;
       hits.push(hit);
       if (hits.length >= limit) {
         break;
@@ -1394,6 +1414,15 @@ function normalizeMatchRole(role) {
   }
   return role === "assistant" || role === "user" || role === "system" ? role : "unknown";
 }
+function parseModels(value) {
+  if (!value) return [];
+  try {
+    const parsed = JSON.parse(value);
+    return Array.isArray(parsed) ? parsed.filter((model) => typeof model === "string" && model.trim().length > 0) : [];
+  } catch {
+    return [];
+  }
+}
 
 // src/storageMaintenance.ts
 import { promises as fs4 } from "fs";
@@ -2063,6 +2092,7 @@ function describeOutcome(outcome) {
 }
 
 export {
+  readNativeHostViewerExtensionId,
   resolveCorpusDir,
   staleIndexFiles,
   Corpus,

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

@@ -17,13 +17,13 @@ import {
   runtimeBinDir,
   staleIndexFiles,
   uninstallRuntime
-} from "./chunk-MTPXE734.js";
+} from "./chunk-O34A5U2L.js";
 import {
   VERSION,
   __commonJS,
   __require,
   __toESM
-} from "./chunk-BDR4JVMF.js";
+} from "./chunk-CMQHGLAD.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-CMQHGLAD.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-XQUMZ3BU.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-O34A5U2L.js";
 import {
   VERSION,
   __commonJS,
   __export,
   __toESM
-} from "./chunk-BDR4JVMF.js";
+} from "./chunk-CMQHGLAD.js";
 
 // ../node_modules/ajv/dist/compile/codegen/code.js
 var require_code = __commonJS({
@@ -21677,7 +21678,27 @@ 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 an HTTPS hand-off that opens the local LLMnesia Viewer without sending the conversation id to the website. 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}$/;
+var VIEWER_HANDOFF_URL = "https://llmnesia.com/open";
+function viewerExtensionId() {
+  const configured = process.env.LLMNESIA_VIEWER_EXTENSION_ID?.trim() ?? readNativeHostViewerExtensionId();
+  return configured && EXTENSION_ID_RE.test(configured) ? configured : STORE_EXTENSION_ID;
+}
+function viewerSourceUrl(docId, extensionId) {
+  const fragment = new URLSearchParams({ docId, extensionId });
+  return `${VIEWER_HANDOFF_URL}#${fragment.toString()}`;
+}
+function sourceLinks(docId, originalUrl) {
+  const extensionId = viewerExtensionId();
+  const localViewerUrl = `chrome-extension://${extensionId}/viewer.html?docId=${encodeURIComponent(docId)}`;
+  return originalUrl ? { viewerUrl: localViewerUrl, sourceUrl: originalUrl, sourceKind: "original" } : {
+    viewerUrl: localViewerUrl,
+    sourceUrl: viewerSourceUrl(docId, extensionId),
+    sourceKind: "viewer"
+  };
+}
 function sourcedJsonResult(payload) {
   return jsonResult({ responseInstruction: SOURCE_LINK_INSTRUCTION, ...payload });
 }
@@ -21743,14 +21764,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 a clickable HTTPS hand-off to its local LLMnesia Viewer 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 a clickable HTTPS hand-off to its local LLMnesia Viewer. 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 +21810,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,
@@ -21798,6 +21820,7 @@ async function runServe() {
           };
           if (h.accountId) entry.accountId = h.accountId;
           if (h.accountLabel) entry.accountLabel = h.accountLabel;
+          if (h.models?.length) entry.models = h.models;
           return entry;
         })
       });
@@ -21807,7 +21830,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 a clickable HTTPS hand-off to its local LLMnesia Viewer. 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,10 +21847,14 @@ 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,
+          ...m.model ? { model: m.model } : {},
           // Prefer the block-formatted copy; fall back to the search-collapsed text.
           text: m.formattedText ?? m.text
         }))
@@ -21838,7 +21865,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 a clickable HTTPS hand-off to its local LLMnesia Viewer. 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 +21888,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,
@@ -21868,6 +21896,7 @@ async function runServe() {
           };
           if (e.accountId) entry.accountId = e.accountId;
           if (e.accountLabel) entry.accountLabel = e.accountLabel;
+          if (e.models?.length) entry.models = e.models;
           return entry;
         })
       });
@@ -21877,7 +21906,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 a clickable HTTPS hand-off to the local LLMnesia Viewer. 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 +21931,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,
@@ -21910,6 +21940,7 @@ async function runServe() {
           };
           if (e.accountId) entry.accountId = e.accountId;
           if (e.accountLabel) entry.accountLabel = e.accountLabel;
+          if (e.models?.length) entry.models = e.models;
           return entry;
         })
       });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@llmnesia/mcp",
-  "version": "0.2.5",
+  "version": "0.2.7",
   "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.7",
   "packages": [
     {
       "registryType": "npm",
       "registryBaseUrl": "https://registry.npmjs.org",
       "identifier": "@llmnesia/mcp",
-      "version": "0.2.5",
+      "version": "0.2.7",
       "transport": {
         "type": "stdio"
       }