virlow-mcp 3.14.4 → 3.14.6

package/dist/cli.js

@@ -103,8 +103,38 @@ var VirlowApi = class {
   updateNote(id, body) {
     return this.request("PUT", `/api/notes/${id}`, body);
   }
-  listFolders() {
-    return this.request("GET", "/api/folders");
+  /**
+   * Every folder, not the first page of them.
+   *
+   * `GET /api/folders` is paginated and defaults to 20. This asked for it with
+   * no parameters and treated the answer as the whole set, so on an account
+   * with more folders than that the rest simply did not exist as far as this
+   * client was concerned.
+   *
+   * Nothing about that failed loudly. Folder exposure was computed from a
+   * partial list, so notes in later folders were invisible; and
+   * `resolveMemoryTree` could not find a Memories folder that was really
+   * there, tried to create one, and got a correct 409 "Memories folder already
+   * exists" — permanently, on every memory tool call, for any account past one
+   * page of folders. The recovery path re-listed and found nothing, because
+   * re-listing had the same blind spot.
+   *
+   * 50 is the API's maximum page size, so this is the fewest round trips
+   * available. `pages` comes from the response rather than being inferred from
+   * a short page: a server that clamps the limit would otherwise stop this
+   * after one request with no sign anything was missing.
+   */
+  async listFolders() {
+    const PAGE_SIZE = 50;
+    const folders = [];
+    for (let page = 1; ; page += 1) {
+      const result = await this.request("GET", `/api/folders?page=${page}&limit=${PAGE_SIZE}`);
+      folders.push(...result.folders);
+      const pages = result.pagination?.pages ?? 1;
+      if (page >= pages || result.folders.length === 0)
+        break;
+    }
+    return { folders };
   }
   createFolder(name, parentId, kind) {
     const body = {
@@ -1326,6 +1356,8 @@ function mapError(err) {
     return err.message;
   return String(err);
 }
+var CONTENT_FORMAT = 'CONTENT FORMAT: content is HTML, not Markdown. Virlow renders it in a rich-text editor, so Markdown syntax is stored and displayed literally \u2014 "# Heading" appears as those characters, not as a heading. Use <h1>-<h4>, <p>, <strong>, <em>, <u>, <s>, <mark>, <ul>/<ol>/<li>, <blockquote>, <pre><code>, <a href>, <hr>, <img src>, and <table>/<tr>/<th>/<td>. Task lists are <ul data-type="taskList"> with <li data-checked="true|false">. Wrap every paragraph in <p>; a bare newline is not a paragraph break. STYLE: never use em-dashes (\u2014). Use a comma, a colon, or two sentences.';
+var HTML_FIELD_HINT = "Note body as HTML (not Markdown). Paragraphs in <p>, headings in <h1>-<h4>. See the tool description for the full tag list.";
 function wrap(fn) {
   return async (...args) => {
     try {
@@ -1535,7 +1567,7 @@ page ${pagination.page} of ${pagination.pages} (${pagination.total} total)` + fi
     return textResult(body + notice);
   }));
   server.registerTool("read_note", {
-    description: "Read the full title and content of a note by id. Requires the vault to be unlocked.",
+    description: "Read the full title and content of a note by id. Requires the vault to be unlocked. Content comes back as the HTML the editor stores \u2014 write it back in the same form.",
     inputSchema: {
       id: z.string().min(1)
     }
@@ -1546,10 +1578,10 @@ page ${pagination.page} of ${pagination.pages} (${pagination.total} total)` + fi
 ${note.content}`);
   }));
   server.registerTool("create_note", {
-    description: "Create a new note with a title and content, optionally placed in a folder. Requires the vault to be unlocked.",
+    description: "Create a new note with a title and content, optionally placed in a folder. Requires the vault to be unlocked.\n\n" + CONTENT_FORMAT,
     inputSchema: {
       title: z.string().min(1).max(200),
-      content: z.string().max(5e4).optional(),
+      content: z.string().max(5e4).optional().describe(HTML_FIELD_HINT),
       folderId: z.string().optional(),
       type: z.string().max(50).optional()
     }
@@ -1558,11 +1590,11 @@ ${note.content}`);
     return textResult(`created note ${note.id}`);
   }));
   server.registerTool("update_note", {
-    description: "Update the title and/or content of an existing note by id. Only the provided fields are changed. Requires the vault to be unlocked.",
+    description: "Update the title and/or content of an existing note by id. Only the provided fields are changed. Content replaces the note body entirely \u2014 read the note first if you mean to add to it. Requires the vault to be unlocked.\n\n" + CONTENT_FORMAT,
     inputSchema: {
       id: z.string().min(1),
       title: z.string().min(1).max(200).optional(),
-      content: z.string().max(5e4).optional()
+      content: z.string().max(5e4).optional().describe(HTML_FIELD_HINT)
     }
   }, wrap(async (args) => {
     await notesService.updateNote(args.id, { title: args.title, content: args.content });
@@ -1921,7 +1953,7 @@ function startUnlockServer(api, vault, opts = {}) {
 }
 
 // src/version.ts
-var VERSION = true ? "3.14.4" : "dev";
+var VERSION = true ? "3.14.6" : "dev";
 
 // src/server.ts
 function defaultEmbeddingCacheDir() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "virlow-mcp",
-  "version": "3.14.4",
+  "version": "3.14.6",
   "description": "Local MCP server for Virlow Secure Notes: end-to-end-encrypted AI memories and notes for Cursor, Claude, Codex, and any MCP client.",
   "license": "MIT",
   "type": "module",
@@ -34,9 +34,9 @@
     "esbuild": "^0.25.0",
     "typescript": "^5.8.0",
     "vitest": "^3.0.0",
-    "@batalabs/virlow-crypto": "3.14.4",
-    "@batalabs/virlow-memory": "3.14.4",
-    "@batalabs/virlow-mcp-core": "3.14.4"
+    "@batalabs/virlow-crypto": "3.14.6",
+    "@batalabs/virlow-memory": "3.14.6",
+    "@batalabs/virlow-mcp-core": "3.14.6"
   },
   "scripts": {
     "build": "node build.mjs",