@llmnesia/mcp 0.2.0 → 0.2.2

package/README.md

@@ -16,7 +16,22 @@ steps when the installed version is too old. If that happens in an interactive
 terminal, it offers the official Node.js installer through an OS-specific
 LLMnesia download link for you.
 
-## Install
+## Recommended setup
+
+Start in the LLMnesia browser extension so you do not miss the browser
+permission, Node.js requirement, OS-specific command, restart, or the extra
+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.
+
+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.
+
+### Connector command
 
 On macOS or Linux:
 

package/dist/{chunk-ACIWPSVH.js → chunk-5ZRNGUJL.js}

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

package/dist/{chunk-53KPHHH2.js → chunk-LPGVZ7XY.js}

@@ -3,7 +3,7 @@ import { createRequire as __llmnesiaCreateRequire } from "node:module";
 const require = __llmnesiaCreateRequire(import.meta.url);
 import {
   VERSION
-} from "./chunk-ACIWPSVH.js";
+} from "./chunk-5ZRNGUJL.js";
 
 // src/config.ts
 import { readFileSync } from "fs";

package/dist/{cli-VB4QKSGH.js → cli-SLGWH5Y2.js}

@@ -14,13 +14,13 @@ import {
   runtimeBinDir,
   staleIndexFiles,
   uninstallRuntime
-} from "./chunk-53KPHHH2.js";
+} from "./chunk-LPGVZ7XY.js";
 import {
   VERSION,
   __commonJS,
   __require,
   __toESM
-} from "./chunk-ACIWPSVH.js";
+} from "./chunk-5ZRNGUJL.js";
 
 // ../node_modules/isexe/windows.js
 var require_windows = __commonJS({

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-ACIWPSVH.js";
+} from "./chunk-5ZRNGUJL.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-VB4QKSGH.js");
+  const { main } = await import("./cli-SLGWH5Y2.js");
   return main();
 }
 bootstrap().then((code) => {

package/dist/mcp.js

@@ -9,13 +9,13 @@ import {
   pendingInboxFiles,
   resolveCorpusDir,
   scheduleSelfUpdate
-} from "./chunk-53KPHHH2.js";
+} from "./chunk-LPGVZ7XY.js";
 import {
   VERSION,
   __commonJS,
   __export,
   __toESM
-} from "./chunk-ACIWPSVH.js";
+} from "./chunk-5ZRNGUJL.js";
 
 // ../node_modules/ajv/dist/compile/codegen/code.js
 var require_code = __commonJS({
@@ -21602,6 +21602,10 @@ 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.";
+function sourcedJsonResult(payload) {
+  return jsonResult({ responseInstruction: SOURCE_LINK_INSTRUCTION, ...payload });
+}
 function errorResult(message) {
   return { content: [{ type: "text", text: message }], isError: true };
 }
@@ -21648,14 +21652,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."
+      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."
     }
   );
   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.",
+      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.",
       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(
@@ -21685,7 +21689,7 @@ async function runServe() {
       };
       const hits = await service2.search(args.query, filters);
       const status = await service2.corpusStatus({ refresh: false });
-      return jsonResult({
+      return sourcedJsonResult({
         count: hits.length,
         corpus: corpusField(status),
         results: hits.map((h) => {
@@ -21712,7 +21716,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).",
+      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.",
       inputSchema: {
         id: external_exports.string().describe("The conversation id (docId), e.g. 'claude:abc-123'.")
       },
@@ -21728,7 +21732,7 @@ async function runServe() {
       if (!record2) {
         return errorResult(`No conversation found with id '${args.id}'.`);
       }
-      return jsonResult({
+      return sourcedJsonResult({
         conversation: record2.conversation,
         messages: record2.messages.map((m) => ({
           index: m.msgIndex,
@@ -21743,7 +21747,7 @@ async function runServe() {
     "list_recent",
     {
       title: "List recent conversations",
-      description: "List the user's most recently updated conversations (title + summary), newest first.",
+      description: "List the user's most recently updated conversations (title + summary + original-chat URL), newest first. 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).")
       },
@@ -21757,7 +21761,7 @@ async function runServe() {
     async (args) => withService(async (service2) => {
       const entries = await service2.listRecent(args.limit ?? 10);
       const status = await service2.corpusStatus({ refresh: false });
-      return jsonResult({
+      return sourcedJsonResult({
         count: entries.length,
         corpus: corpusField(status),
         conversations: entries.map((e) => {
@@ -21765,6 +21769,7 @@ async function runServe() {
             id: e.docId,
             title: e.title,
             platform: e.platform,
+            url: e.url,
             updatedAt: e.updatedAt,
             messageCount: e.messageCount,
             pinned: e.pinned,
@@ -21781,7 +21786,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.",
+      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.",
       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).")
@@ -21796,7 +21801,7 @@ async function runServe() {
     async (args) => withService(async (service2) => {
       const entries = await service2.listConversations(args.limit ?? 10, args.sort ?? "recent");
       const status = await service2.corpusStatus({ refresh: false });
-      return jsonResult({
+      return sourcedJsonResult({
         count: entries.length,
         sort: args.sort ?? "recent",
         corpus: corpusField(status),
@@ -21805,6 +21810,7 @@ async function runServe() {
             id: e.docId,
             title: e.title,
             platform: e.platform,
+            url: e.url,
             createdAt: e.createdAt,
             updatedAt: e.updatedAt,
             messageCount: e.messageCount,

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "@llmnesia/mcp",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "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.",
   "mcpName": "com.llmnesia/mcp",
-  "description": "LLMnesia MCP server + installer: search your own AI chat history from Claude Desktop, Claude Code, Cursor, Codex, and other MCP clients. Local-first, one command to set up.",
+  "description": "Search your LLMnesia chat history from Claude Desktop, Claude Code, Cursor, Codex, and other MCP clients. Local-first guided setup.",
   "keywords": [
     "mcp",
     "model-context-protocol",

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