@llmnesia/mcp 0.2.6 → 0.2.8

package/README.md

@@ -24,12 +24,19 @@ Claude Desktop step on Windows:
 
 1. Install LLMnesia and import the chat history you want available.
 2. Open **Full settings → Connect desktop AI**.
-3. Follow every step shown for your computer, including fully quitting and
-   reopening the browser and connected AI app when instructed.
+3. Run the exact connector command shown there.
+4. Fully quit and reopen the browser.
+5. Return to **Connect desktop AI** and enable automatic sync.
+
+> **Installing the npm package is not setup.** Running
+> `npm install @llmnesia/mcp` only downloads package files; it does not register
+> the native browser connector or configure desktop AI apps. Use the exact
+> `npx -y @llmnesia/mcp@latest install` command below (or `npx.cmd` on Windows),
+> including the final `install` argument.
 
 The commands below are the connector-install step from that guided flow. They
-are also provided as a reference for technical users; running one by itself is
-not the complete LLMnesia setup.
+are also provided as a reference for technical users; the browser restart and
+permission step are still required afterward.
 
 ### Connector command
 
@@ -64,7 +71,7 @@ The installer:
    corpus,
 2. copies the server into `~/.llmnesia/bin` so it has a permanent home,
 3. sets up the supported desktop AI apps (Claude Code, Cursor,
-   and Codex/ChatGPT), and
+   Codex/ChatGPT, and ZCode), and
 4. registers that copy using the client's own CLI where available, or with an
    automatic backup before editing its documented user config. It prepares all
    of those standard config paths, so an app installed later does not require
@@ -205,6 +212,7 @@ received data — check it before concluding a chat does not exist.
 | Claude Desktop | macOS uses the working local JSON registration. On Windows, run `install` for browser sync, then install the official `llmnesia.mcpb` once in Claude Desktop; Claude exposes no supported external installation API for custom desktop extensions. |
 | Cursor | Edits `~/.cursor/mcp.json`, preparing it in advance if Cursor is installed later. |
 | Codex / ChatGPT desktop | Runs `codex mcp add` with the absolute runtime paths when available. If the bundled CLI is unavailable, the installer safely edits `~/.codex/config.toml` itself and backs up existing settings first, including preparing it for a later installation. Read-only LLMnesia tools are configured to run without repeated approval prompts; writes still ask. |
+| ZCode | Edits the user-scope `~/.zcode/cli/config.json`, adding the server under ZCode's nested `mcp.servers` key with a backup first, and prepares that file in advance if ZCode is installed later. ZCode validates this file strictly and connects servers from it automatically at session start. |
 | Others (Windsurf, Zed, LM Studio, …) | Prints the generic stdio block for you to paste. |
 
 **Cloud-only clients cannot reach a local stdio server** (web ChatGPT, Lovable,

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

@@ -3,7 +3,7 @@ import { createRequire as __llmnesiaCreateRequire } from "node:module";
 const require = __llmnesiaCreateRequire(import.meta.url);
 import {
   VERSION
-} from "./chunk-YRK2DRGG.js";
+} from "./chunk-RJJRIPHA.js";
 
 // src/config.ts
 import { readFileSync } from "fs";
@@ -47,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`;
 }
@@ -198,6 +198,8 @@ function canonicalConversationDoc(c) {
     indexLevel: c.indexLevel,
     estimatedBytes: c.estimatedBytes
   };
+  assignIfDefined(out, "localTitle", c.localTitle);
+  assignIfDefined(out, "localTitleUpdatedAt", c.localTitleUpdatedAt);
   assignIfDefined(out, "searchDocLength", c.searchDocLength);
   assignIfDefined(out, "contentHash", c.contentHash);
   assignIfDefined(out, "truncated", c.truncated);
@@ -208,6 +210,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,
@@ -227,6 +231,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;
@@ -904,6 +909,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) {
@@ -1008,7 +1016,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);
@@ -1082,8 +1091,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(
@@ -1127,14 +1136,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;
     });
   }
@@ -1199,9 +1210,14 @@ var SearchIndex = class {
   // transaction() helper for single upserts, or rebuildFrom's manual one).
   writeRecord(rec) {
     const { conversation, messages } = rec;
+    const displayTitle = conversation.localTitle?.trim() || conversation.title;
     this.deleteFtsRows(conversation.docId);
     this.stmts.deleteConversation.run(conversation.docId);
-    const titleText = [conversation.title, conversation.preview].filter(Boolean).join("\n");
+    const titleText = [
+      ...conversation.localTitle ? [conversation.localTitle, conversation.localTitle] : [],
+      conversation.title,
+      conversation.preview
+    ].filter(Boolean).join("\n");
     if (titleText.trim()) {
       this.insertFtsRow(conversation.docId, TITLE_ROW_INDEX, TITLE_ROLE, titleText);
     }
@@ -1213,7 +1229,7 @@ var SearchIndex = class {
     this.stmts.insertConversation.run({
       docId: conversation.docId,
       platform: conversation.platform,
-      title: conversation.title,
+      title: displayTitle,
       url: conversation.url,
       createdAt: conversation.createdAt,
       updatedAt: conversation.updatedAt ?? conversation.contentUpdatedAt ?? 0,
@@ -1221,7 +1237,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) {
@@ -1286,7 +1303,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
@@ -1322,6 +1339,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;
@@ -1338,7 +1357,11 @@ var SearchIndex = class {
   }
   hydrateSnippet(row, match) {
     const record = this.corpus?.getFromPlatformSync(row.platform, row.docId);
-    const source = row.msgIndex === TITLE_ROW_INDEX ? [record?.conversation.title ?? row.title, record?.conversation.preview ?? row.preview].filter(Boolean).join("\n") : record?.messages.find((message) => message.msgIndex === row.msgIndex)?.text ?? row.preview;
+    const source = row.msgIndex === TITLE_ROW_INDEX ? [
+      record?.conversation.localTitle,
+      record?.conversation.title ?? row.title,
+      record?.conversation.preview ?? row.preview
+    ].filter(Boolean).join("\n") : record?.messages.find((message) => message.msgIndex === row.msgIndex)?.text ?? row.preview;
     this.stmts.clearSnippetFts.run();
     try {
       this.stmts.insertSnippetFts.run(source);
@@ -1402,6 +1425,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";

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

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

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

@@ -17,13 +17,13 @@ import {
   runtimeBinDir,
   staleIndexFiles,
   uninstallRuntime
-} from "./chunk-HL5QE57W.js";
+} from "./chunk-FIH7ZNYH.js";
 import {
   VERSION,
   __commonJS,
   __require,
   __toESM
-} from "./chunk-YRK2DRGG.js";
+} from "./chunk-RJJRIPHA.js";
 
 // ../node_modules/isexe/windows.js
 var require_windows = __commonJS({
@@ -2841,7 +2841,8 @@ function paths(home2, osPlatform2, appData) {
     claudeCode: join4(claudeCodeRoot, ".claude.json"),
     claudeDesktop,
     cursor: join4(home2, ".cursor", "mcp.json"),
-    codex: join4(home2, ".codex", "config.toml")
+    codex: join4(home2, ".codex", "config.toml"),
+    zcode: join4(home2, ".zcode", "cli", "config.json")
   };
 }
 async function readJsonFile(path) {
@@ -2873,6 +2874,38 @@ function mcpServersOf(data, configPath) {
   }
   return data.mcpServers;
 }
+function nestedMcpServersOf(data, configPath) {
+  if (data.mcp === void 0) {
+    return {};
+  }
+  if (!data.mcp || typeof data.mcp !== "object" || Array.isArray(data.mcp)) {
+    throw new Error(`Could not update ${configPath}: "mcp" must be a JSON object. The file was left unchanged.`);
+  }
+  const mcp = data.mcp;
+  if (mcp.servers === void 0) {
+    return {};
+  }
+  if (!mcp.servers || typeof mcp.servers !== "object" || Array.isArray(mcp.servers)) {
+    throw new Error(
+      `Could not update ${configPath}: "mcp.servers" must be a JSON object. The file was left unchanged.`
+    );
+  }
+  return mcp.servers;
+}
+function asObject(value) {
+  return value && typeof value === "object" && !Array.isArray(value) ? value : {};
+}
+var topLevelServers = {
+  read: (data, configPath) => mcpServersOf(data, configPath),
+  merge: (data, servers) => ({ ...data, mcpServers: servers }),
+  preview: (entry) => JSON.stringify({ mcpServers: { [SERVER_NAME]: entry } }, null, 2)
+};
+var zcodeNestedServers = {
+  read: (data, configPath) => nestedMcpServersOf(data, configPath),
+  // Keep any other settings ZCode stores beside `servers` inside its `mcp` key.
+  merge: (data, servers) => ({ ...data, mcp: { ...asObject(data.mcp), servers } }),
+  preview: (entry) => JSON.stringify({ mcp: { servers: { [SERVER_NAME]: entry } } }, null, 2)
+};
 function isErrnoException(value) {
   return value instanceof Error && "code" in value;
 }
@@ -3091,7 +3124,7 @@ codex mcp add ${SERVER_NAME} -- ${serve.command} ${serve.args.join(" ")}`
     detail: `Ran: codex mcp add ${SERVER_NAME} -- ${serve.command} ${serve.args.join(" ")}`
   };
 }
-async function registerJsonClient(clientLabel, configPath, serve, confirm, now, prepareMissing = false, prepareWhenConfigAbsent = false, includeTransportType = true) {
+async function registerJsonClient(clientLabel, configPath, serve, confirm, now, prepareMissing = false, prepareWhenConfigAbsent = false, includeTransportType = true, layout = topLevelServers) {
   const configDirExists = await clientDirExists(configPath);
   if (!configDirExists && !prepareMissing) {
     return {
@@ -3117,7 +3150,7 @@ async function registerJsonClient(clientLabel, configPath, serve, confirm, now,
   }
   let servers;
   try {
-    servers = mcpServersOf(data, configPath);
+    servers = layout.read(data, configPath);
   } catch (err) {
     return { client: clientLabel, action: "error", detail: errorMessage(err) };
   }
@@ -3126,7 +3159,7 @@ async function registerJsonClient(clientLabel, configPath, serve, confirm, now,
   if (already && JSON.stringify(already) === JSON.stringify(nextEntry)) {
     return { client: clientLabel, action: "skipped", detail: `Already registered at ${configPath}.` };
   }
-  const preview = JSON.stringify({ mcpServers: { [SERVER_NAME]: nextEntry } }, null, 2);
+  const preview = layout.preview(nextEntry);
   const message = existed ? `${clientLabel}: update ${configPath} to add the "${SERVER_NAME}" MCP server? Existing servers and settings are preserved.
 Add:
 ${preview}` : `${clientLabel}: create ${configPath} with the "${SERVER_NAME}" MCP server?
@@ -3140,7 +3173,7 @@ ${preview}`;
       const backupPath = `${configPath}.bak-${now()}`;
       await writeFile2(backupPath, raw ?? JSON.stringify(data, null, 2), "utf8");
     }
-    const nextData = { ...data, mcpServers: { ...servers, [SERVER_NAME]: nextEntry } };
+    const nextData = layout.merge(data, { ...servers, [SERVER_NAME]: nextEntry });
     await writeFile2(configPath, `${JSON.stringify(nextData, null, 2)}
 `, "utf8");
     return {
@@ -3245,7 +3278,7 @@ async function registerClients(options) {
   const osPlatform2 = options.osPlatform ?? platform2();
   const now = options.now ?? (() => Date.now());
   const prepareMissing = options.prepareMissingDesktopApps === true;
-  const { claudeCode, claudeDesktop, cursor, codex } = paths(home2, osPlatform2, options.appData);
+  const { claudeCode, claudeDesktop, cursor, codex, zcode } = paths(home2, osPlatform2, options.appData);
   const results = [];
   const safe = async (client, fn) => {
     try {
@@ -3292,6 +3325,22 @@ async function registerClients(options) {
       () => registerCodex(options.serve, options.codexCli ?? realCodexCli, codex, options.confirm, now, prepareMissing)
     )
   );
+  results.push(
+    await safe(
+      "ZCode",
+      () => registerJsonClient(
+        "ZCode",
+        zcode,
+        options.serve,
+        options.confirm,
+        now,
+        prepareMissing,
+        false,
+        true,
+        zcodeNestedServers
+      )
+    )
+  );
   results.push({
     client: "Other MCP clients (Windsurf, Zed, LM Studio, ...)",
     action: "printed",
@@ -3368,7 +3417,7 @@ async function unregisterCodex(cli, configPath, now) {
     return { client: "Codex", action: "error", detail: `codex mcp remove failed: ${errorMessage(err)}` };
   }
 }
-async function unregisterJsonClient(clientLabel, configPath, now) {
+async function unregisterJsonClient(clientLabel, configPath, now, layout = topLevelServers) {
   let data;
   let existed;
   let raw;
@@ -3382,7 +3431,7 @@ async function unregisterJsonClient(clientLabel, configPath, now) {
   }
   let servers;
   try {
-    servers = mcpServersOf(data, configPath);
+    servers = layout.read(data, configPath);
   } catch (err) {
     return { client: clientLabel, action: "error", detail: errorMessage(err) };
   }
@@ -3393,7 +3442,7 @@ async function unregisterJsonClient(clientLabel, configPath, now) {
   try {
     await writeFile2(backupPath, raw ?? JSON.stringify(data, null, 2), "utf8");
     const { [SERVER_NAME]: _removed, ...rest } = servers;
-    const nextData = { ...data, mcpServers: rest };
+    const nextData = layout.merge(data, rest);
     await writeFile2(configPath, `${JSON.stringify(nextData, null, 2)}
 `, "utf8");
     return { client: clientLabel, action: "registered", detail: `Removed from ${configPath} (backup: ${backupPath}).` };
@@ -3405,7 +3454,7 @@ async function unregisterClients(options = {}) {
   const home2 = options.home ?? homedir2();
   const osPlatform2 = options.osPlatform ?? platform2();
   const now = options.now ?? (() => Date.now());
-  const { claudeDesktop, cursor, codex } = paths(home2, osPlatform2);
+  const { claudeDesktop, cursor, codex, zcode } = paths(home2, osPlatform2);
   const safe = async (client, fn) => {
     try {
       return await fn();
@@ -3421,6 +3470,7 @@ async function unregisterClients(options = {}) {
   }
   results.push(await safe("Cursor", () => unregisterJsonClient("Cursor", cursor, now)));
   results.push(await safe("Codex", () => unregisterCodex(options.codexCli ?? realCodexCli, codex, now)));
+  results.push(await safe("ZCode", () => unregisterJsonClient("ZCode", zcode, now, zcodeNestedServers)));
   results.push({
     client: "Other MCP clients",
     action: "skipped",
@@ -3592,7 +3642,7 @@ function checkAutoUpdate(home2, env) {
   const latest = state.lastSeenVersion ? `; latest published ${state.lastSeenVersion}` : "";
   return { name, status: "ok", detail: `On. Last checked ${checkedAt}${latest}.` };
 }
-async function checkJsonClient(label, configPath) {
+async function checkJsonClient(label, configPath, nestedServers = false) {
   if (!existsSync(dirname5(configPath))) {
     return { name: label, status: "warn", detail: `Not installed (no ${dirname5(configPath)}).` };
   }
@@ -3605,7 +3655,8 @@ async function checkJsonClient(label, configPath) {
   }
   try {
     const data = JSON.parse(readFileSync(configPath, "utf8"));
-    const entry = data.mcpServers?.[SERVER_NAME];
+    const servers = nestedServers ? data.mcp?.servers : data.mcpServers;
+    const entry = servers?.[SERVER_NAME];
     if (!entry) {
       return {
         name: label,
@@ -3741,6 +3792,7 @@ async function runDoctor(options = {}) {
   await run("Cursor", () => checkJsonClient("Cursor", join5(home2, ".cursor", "mcp.json")));
   await run("Claude Code", () => checkClaudeCode(claudeCli));
   await run("Codex", () => checkCodex(home2, codexCli));
+  await run("ZCode", () => checkJsonClient("ZCode", join5(home2, ".zcode", "cli", "config.json"), true));
   checks.push({
     name: "Reminder",
     status: "warn",
@@ -3760,7 +3812,8 @@ Usage: llmnesia-mcp <command> [options]
 
 Setup:
   install [ext-id...]  Install the native host + register this MCP server with
-                        detected clients (Claude Code/Desktop, Cursor, Codex, ...)
+                        detected clients (Claude Code/Desktop, Cursor, Codex,
+                        ZCode, ...)
   doctor                Diagnose: host installed? corpus present? clients wired?
   uninstall             Remove native host + client registrations (never deletes
                         your corpus \u2014 see the printed path if you want that too)

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

package/dist/mcp.js

@@ -12,13 +12,13 @@ import {
   resolveCorpusDir,
   runAutomaticMaintenance,
   scheduleSelfUpdate
-} from "./chunk-HL5QE57W.js";
+} from "./chunk-FIH7ZNYH.js";
 import {
   VERSION,
   __commonJS,
   __export,
   __toESM
-} from "./chunk-YRK2DRGG.js";
+} from "./chunk-RJJRIPHA.js";
 
 // ../node_modules/ajv/dist/compile/codegen/code.js
 var require_code = __commonJS({
@@ -21678,19 +21678,26 @@ 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 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 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 viewerUrl(docId) {
-  return `chrome-extension://${viewerExtensionId()}/viewer.html?docId=${encodeURIComponent(docId)}`;
+function viewerSourceUrl(docId, extensionId) {
+  const fragment = new URLSearchParams({ docId, extensionId });
+  return `${VIEWER_HANDOFF_URL}#${fragment.toString()}`;
 }
 function sourceLinks(docId, originalUrl) {
-  const localViewerUrl = viewerUrl(docId);
-  return originalUrl ? { viewerUrl: localViewerUrl, sourceUrl: originalUrl, sourceKind: "original" } : { viewerUrl: localViewerUrl, sourceUrl: localViewerUrl, sourceKind: "viewer" };
+  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 });
@@ -21757,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 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."
+      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 `sourceUrl`: the original chat URL when available, otherwise its local LLMnesia Viewer URL. 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(
@@ -21813,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;
         })
       });
@@ -21822,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 `sourceUrl`: its original-chat URL when available, otherwise its local LLMnesia Viewer URL. 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'.")
       },
@@ -21846,6 +21854,7 @@ async function runServe() {
         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
         }))
@@ -21856,7 +21865,7 @@ async function runServe() {
     "list_recent",
     {
       title: "List recent conversations",
-      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.",
+      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).")
       },
@@ -21887,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;
         })
       });
@@ -21896,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 `sourceUrl`: the original chat URL when available, otherwise the local LLMnesia Viewer URL. 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).")
@@ -21930,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.6",
+  "version": "0.2.8",
   "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.6",
+  "version": "0.2.8",
   "packages": [
     {
       "registryType": "npm",
       "registryBaseUrl": "https://registry.npmjs.org",
       "identifier": "@llmnesia/mcp",
-      "version": "0.2.6",
+      "version": "0.2.8",
       "transport": {
         "type": "stdio"
       }