@mentagen/mcp 0.8.5 → 0.8.6

package/dist/tools/batch-update.js

@@ -1,6 +1,7 @@
 import { z } from 'zod';
 import { nodeColorSchema } from '../utils/colors.js';
 import { formatError } from '../utils/errors.js';
+import { normalizeTextEscapes } from '../utils/normalize.js';
 import { unitsToPixels } from '../utils/units.js';
 import { snapToGrid } from './grid-calc.js';
 import { validateTypeChange } from './update.js';
@@ -83,7 +84,14 @@ function buildNodeUpdateData(data, migrationFields) {
             cleanData[key] = snapToGrid(unitsToPixels(value));
         }
         else if (key === 'todos') {
-            cleanData[key] = value;
+            const todos = value.map(t => ({
+                ...t,
+                text: normalizeTextEscapes(t.text),
+            }));
+            cleanData[key] = todos;
+        }
+        else if (key === 'content') {
+            cleanData[key] = normalizeTextEscapes(value);
         }
         else {
             cleanData[key] = value;

package/dist/tools/create-graph.js

@@ -1,6 +1,7 @@
 import { z } from 'zod';
 import { nodeColorSchema } from '../utils/colors.js';
 import { formatError } from '../utils/errors.js';
+import { normalizeTextEscapes } from '../utils/normalize.js';
 import { pixelsToUnits, unitsToPixels } from '../utils/units.js';
 import { applyExtension, generateId, normalizeTodos } from './create.js';
 import { snapToGrid } from './grid-calc.js';
@@ -81,7 +82,8 @@ async function createNode(client, boardId, nodeInput, idMap) {
     const autoSize = calculateNodeSize(finalName, type);
     const dims = calcNodeDimensions(nodeInput, autoSize);
     const isCodeNode = type === 'code';
-    const nodeContent = nodeInput.content ?? '';
+    const rawContent = nodeInput.content ?? '';
+    const nodeContent = isCodeNode ? rawContent : normalizeTextEscapes(rawContent);
     // Only pass todos for non-code nodes
     const todos = !isCodeNode && nodeInput.todos ? normalizeTodos(nodeInput.todos) : undefined;
     try {

package/dist/tools/create.js

@@ -2,6 +2,7 @@ import { randomUUID } from 'crypto';
 import { z } from 'zod';
 import { nodeColorSchema } from '../utils/colors.js';
 import { formatError } from '../utils/errors.js';
+import { normalizeTextEscapes } from '../utils/normalize.js';
 import { pixelsToUnits, unitsToPixels } from '../utils/units.js';
 import { getNodeUrl } from '../utils/urls.js';
 import { snapToGrid } from './grid-calc.js';
@@ -113,7 +114,7 @@ export function generateId() {
 export function normalizeTodos(todos) {
     return todos.map((todo, index) => ({
         id: randomUUID(),
-        text: todo.text,
+        text: normalizeTextEscapes(todo.text),
         completed: todo.completed ?? false,
         order: index,
     }));
@@ -139,14 +140,14 @@ function buildNodeFields(params, color, position) {
         }
         nodeFields.url = params.url;
         if (params.content) {
-            nodeFields.content = params.content;
+            nodeFields.content = normalizeTextEscapes(params.content);
         }
         if (params.todos) {
             nodeFields.todos = normalizeTodos(params.todos);
         }
     }
     else {
-        nodeFields.content = params.content || '';
+        nodeFields.content = normalizeTextEscapes(params.content || '');
         if (params.todos) {
             nodeFields.todos = normalizeTodos(params.todos);
         }

package/dist/tools/patch-content.js

@@ -1,6 +1,7 @@
 import { z } from 'zod';
 import { NodeType } from '../client/types.js';
 import { formatError } from '../utils/errors.js';
+import { normalizeTextEscapes } from '../utils/normalize.js';
 const replaceOp = z.object({
     type: z.literal('replace'),
     oldString: z.string().min(1),
@@ -68,12 +69,20 @@ export async function handlePatchContent(client, params) {
             nodeId: params.nodeId,
         });
         const { field, text: initialText } = getNodeTextField(node);
+        const isCode = field === 'code';
         let text = initialText;
         const appliedOps = [];
+        /** Normalize escape sequences for non-code content fields. */
+        const normalize = (s) => isCode ? s : normalizeTextEscapes(s);
         for (const op of params.operations) {
             switch (op.type) {
                 case 'replace': {
-                    const { result, error } = applyReplace(text, op);
+                    const normalizedOp = {
+                        ...op,
+                        oldString: normalize(op.oldString),
+                        newString: normalize(op.newString),
+                    };
+                    const { result, error } = applyReplace(text, normalizedOp);
                     if (error) {
                         return {
                             content: [
@@ -95,14 +104,18 @@ export async function handlePatchContent(client, params) {
                     appliedOps.push(`replace: "${truncate(op.oldString, 30)}" → "${truncate(op.newString, 30)}"`);
                     break;
                 }
-                case 'prepend':
-                    text = op.content + text;
-                    appliedOps.push(`prepend: ${op.content.length} chars`);
+                case 'prepend': {
+                    const content = normalize(op.content);
+                    text = content + text;
+                    appliedOps.push(`prepend: ${content.length} chars`);
                     break;
-                case 'append':
-                    text = text + op.content;
-                    appliedOps.push(`append: ${op.content.length} chars`);
+                }
+                case 'append': {
+                    const content = normalize(op.content);
+                    text = text + content;
+                    appliedOps.push(`append: ${content.length} chars`);
                     break;
+                }
             }
         }
         await client.updateNode({

package/dist/tools/todo.js

@@ -1,6 +1,7 @@
 import { randomUUID } from 'crypto';
 import { z } from 'zod';
 import { formatError } from '../utils/errors.js';
+import { normalizeTextEscapes } from '../utils/normalize.js';
 // ─────────────────────────────────────────────────────────────────────────────
 // Schemas
 // ─────────────────────────────────────────────────────────────────────────────
@@ -36,7 +37,7 @@ export async function handleAddTodo(client, params) {
         const existingTodos = node.todos || [];
         const newTodo = {
             id: randomUUID(),
-            text: params.text,
+            text: normalizeTextEscapes(params.text),
             completed: false,
             order: existingTodos.length,
         };

package/dist/tools/update.js

@@ -2,6 +2,7 @@ import { z } from 'zod';
 import { NodeType } from '../client/types.js';
 import { nodeColorSchema } from '../utils/colors.js';
 import { formatError } from '../utils/errors.js';
+import { normalizeTextEscapes } from '../utils/normalize.js';
 import { pixelsToUnits, unitsToPixels } from '../utils/units.js';
 import { snapToGrid } from './grid-calc.js';
 import { calculateNodeSize } from './size-calc.js';
@@ -132,11 +133,11 @@ function addContentFields(data, params, nodeType) {
             data.url = params.url;
         }
         if (params.content !== undefined) {
-            data.content = params.content;
+            data.content = normalizeTextEscapes(params.content);
         }
     }
     else if (params.content !== undefined) {
-        data.content = params.content;
+        data.content = normalizeTextEscapes(params.content);
     }
 }
 /**

package/dist/utils/normalize.js

@@ -0,0 +1,11 @@
+/**
+ * Normalize literal escape sequences commonly produced by LLMs in MCP tool parameters.
+ *
+ * LLMs often write `\n` as two literal characters (backslash + n) instead of
+ * an actual newline character. This converts those sequences for text content fields.
+ *
+ * Should NOT be applied to code fields where escape sequences are intentional.
+ */
+export function normalizeTextEscapes(text) {
+    return text.replaceAll('\\n', '\n').replaceAll('\\t', '\t');
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mentagen/mcp",
-  "version": "0.8.5",
+  "version": "0.8.6",
   "description": "MCP server for Mentagen knowledge base integration with Cursor",
   "type": "module",
   "bin": "dist/index.js",