remnote-mcp-server 0.5.0 → 0.6.0

package/dist/tools/index.d.ts

@@ -45,6 +45,19 @@ export declare const SEARCH_TOOL: {
                 description: string;
             };
             includeContent: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            depth: {
+                type: string;
+                description: string;
+            };
+            childLimit: {
+                type: string;
+                description: string;
+            };
+            maxContentLength: {
                 type: string;
                 description: string;
             };
@@ -68,8 +81,23 @@ export declare const SEARCH_TOOL: {
                             type: string;
                             description: string;
                         };
-                        detail: {
+                        headline: {
+                            type: string;
+                            description: string;
+                        };
+                        parentRemId: {
+                            type: string;
+                            description: string;
+                        };
+                        parentTitle: {
+                            type: string;
+                            description: string;
+                        };
+                        aliases: {
                             type: string;
+                            items: {
+                                type: string;
+                            };
                             description: string;
                         };
                         remType: {
@@ -84,6 +112,218 @@ export declare const SEARCH_TOOL: {
                             type: string;
                             description: string;
                         };
+                        contentStructured: {
+                            type: string;
+                            description: string;
+                            items: {
+                                type: string;
+                                properties: {
+                                    remId: {
+                                        type: string;
+                                        description: string;
+                                    };
+                                    title: {
+                                        type: string;
+                                        description: string;
+                                    };
+                                    headline: {
+                                        type: string;
+                                        description: string;
+                                    };
+                                    aliases: {
+                                        type: string;
+                                        items: {
+                                            type: string;
+                                        };
+                                        description: string;
+                                    };
+                                    remType: {
+                                        type: string;
+                                        description: string;
+                                    };
+                                    cardDirection: {
+                                        type: string;
+                                        description: string;
+                                    };
+                                    children: {
+                                        type: string;
+                                        description: string;
+                                        items: {
+                                            type: string;
+                                        };
+                                    };
+                                };
+                                required: string[];
+                            };
+                        };
+                        contentProperties: {
+                            type: string;
+                            description: string;
+                            properties: {
+                                childrenRendered: {
+                                    type: string;
+                                    description: string;
+                                };
+                                childrenTotal: {
+                                    type: string;
+                                    description: string;
+                                };
+                                contentTruncated: {
+                                    type: string;
+                                    description: string;
+                                };
+                            };
+                        };
+                    };
+                };
+            };
+        };
+    };
+};
+export declare const SEARCH_BY_TAG_TOOL: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            tag: {
+                type: string;
+                description: string;
+            };
+            limit: {
+                type: string;
+                description: string;
+            };
+            includeContent: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            depth: {
+                type: string;
+                description: string;
+            };
+            childLimit: {
+                type: string;
+                description: string;
+            };
+            maxContentLength: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+    outputSchema: {
+        type: "object";
+        properties: {
+            results: {
+                type: string;
+                description: string;
+                items: {
+                    type: string;
+                    properties: {
+                        remId: {
+                            type: string;
+                            description: string;
+                        };
+                        title: {
+                            type: string;
+                            description: string;
+                        };
+                        headline: {
+                            type: string;
+                            description: string;
+                        };
+                        parentRemId: {
+                            type: string;
+                            description: string;
+                        };
+                        parentTitle: {
+                            type: string;
+                            description: string;
+                        };
+                        aliases: {
+                            type: string;
+                            items: {
+                                type: string;
+                            };
+                            description: string;
+                        };
+                        remType: {
+                            type: string;
+                            description: string;
+                        };
+                        cardDirection: {
+                            type: string;
+                            description: string;
+                        };
+                        content: {
+                            type: string;
+                            description: string;
+                        };
+                        contentStructured: {
+                            type: string;
+                            description: string;
+                            items: {
+                                type: string;
+                                properties: {
+                                    remId: {
+                                        type: string;
+                                        description: string;
+                                    };
+                                    title: {
+                                        type: string;
+                                        description: string;
+                                    };
+                                    headline: {
+                                        type: string;
+                                        description: string;
+                                    };
+                                    aliases: {
+                                        type: string;
+                                        items: {
+                                            type: string;
+                                        };
+                                        description: string;
+                                    };
+                                    remType: {
+                                        type: string;
+                                        description: string;
+                                    };
+                                    cardDirection: {
+                                        type: string;
+                                        description: string;
+                                    };
+                                    children: {
+                                        type: string;
+                                        description: string;
+                                        items: {
+                                            type: string;
+                                        };
+                                    };
+                                };
+                                required: string[];
+                            };
+                        };
+                        contentProperties: {
+                            type: string;
+                            description: string;
+                            properties: {
+                                childrenRendered: {
+                                    type: string;
+                                    description: string;
+                                };
+                                childrenTotal: {
+                                    type: string;
+                                    description: string;
+                                };
+                                contentTruncated: {
+                                    type: string;
+                                    description: string;
+                                };
+                            };
+                        };
                     };
                 };
             };
@@ -104,6 +344,19 @@ export declare const READ_NOTE_TOOL: {
                 type: string;
                 description: string;
             };
+            includeContent: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            childLimit: {
+                type: string;
+                description: string;
+            };
+            maxContentLength: {
+                type: string;
+                description: string;
+            };
         };
         required: string[];
     };
@@ -118,10 +371,25 @@ export declare const READ_NOTE_TOOL: {
                 type: string;
                 description: string;
             };
-            detail: {
+            headline: {
+                type: string;
+                description: string;
+            };
+            parentRemId: {
                 type: string;
                 description: string;
             };
+            parentTitle: {
+                type: string;
+                description: string;
+            };
+            aliases: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
             remType: {
                 type: string;
                 description: string;
@@ -134,21 +402,21 @@ export declare const READ_NOTE_TOOL: {
                 type: string;
                 description: string;
             };
-            children: {
+            contentProperties: {
                 type: string;
                 description: string;
-                items: {
-                    type: string;
-                    properties: {
-                        remId: {
-                            type: string;
-                        };
-                        text: {
-                            type: string;
-                        };
-                        children: {
-                            type: string;
-                        };
+                properties: {
+                    childrenRendered: {
+                        type: string;
+                        description: string;
+                    };
+                    childrenTotal: {
+                        type: string;
+                        description: string;
+                    };
+                    contentTruncated: {
+                        type: string;
+                        description: string;
                     };
                 };
             };

package/dist/tools/index.js

@@ -1,9 +1,11 @@
 import { CallToolRequestSchema, ListToolsRequestSchema } from '@modelcontextprotocol/sdk/types.js';
 import { CreateNoteSchema } from '../schemas/remnote-schemas.js';
 import { SearchSchema } from '../schemas/remnote-schemas.js';
+import { SearchByTagSchema } from '../schemas/remnote-schemas.js';
 import { ReadNoteSchema } from '../schemas/remnote-schemas.js';
 import { UpdateNoteSchema } from '../schemas/remnote-schemas.js';
 import { AppendJournalSchema } from '../schemas/remnote-schemas.js';
+import { checkVersionCompatibility } from '../version-compat.js';
 export const CREATE_NOTE_TOOL = {
     name: 'remnote_create_note',
     description: 'Create a new note in RemNote with optional content, parent, and tags',
@@ -20,15 +22,28 @@ export const CREATE_NOTE_TOOL = {
 };
 export const SEARCH_TOOL = {
     name: 'remnote_search',
-    description: 'Search the RemNote knowledge base. Results are sorted by type: documents first, then concepts, descriptors, portals, and plain text.',
+    description: 'Search the RemNote knowledge base. Results are sorted by type: documents first, then concepts, descriptors, portals, and plain text. Use includeContent: "markdown" for indented markdown previews or "structured" for nested child objects with remIds.',
     inputSchema: {
         type: 'object',
         properties: {
             query: { type: 'string', description: 'Search query text' },
             limit: { type: 'number', description: 'Maximum results (1-150, default: 50)' },
             includeContent: {
-                type: 'boolean',
-                description: 'Include first child bullets as content (default: false)',
+                type: 'string',
+                enum: ['none', 'markdown', 'structured'],
+                description: 'Content rendering mode: "none" omits content (default), "markdown" renders child subtree as indented markdown, "structured" returns nested child objects with remIds',
+            },
+            depth: {
+                type: 'number',
+                description: 'Depth of child hierarchy to render for markdown/structured content (0-10, default: 1)',
+            },
+            childLimit: {
+                type: 'number',
+                description: 'Maximum children per level (1-500, default: 20)',
+            },
+            maxContentLength: {
+                type: 'number',
+                description: 'Maximum character length for rendered content (default: 3000)',
             },
         },
         required: ['query'],
@@ -44,9 +59,22 @@ export const SEARCH_TOOL = {
                     properties: {
                         remId: { type: 'string', description: 'Unique Rem ID' },
                         title: { type: 'string', description: 'Rendered title with markdown formatting' },
-                        detail: {
+                        headline: {
+                            type: 'string',
+                            description: 'Display-oriented full line: title + type-aware delimiter + detail (e.g. "Term :: Definition")',
+                        },
+                        parentRemId: {
                             type: 'string',
-                            description: 'Back text for CDF/flashcard Rems (omitted if none)',
+                            description: 'Direct parent Rem ID (omitted for top-level Rems)',
+                        },
+                        parentTitle: {
+                            type: 'string',
+                            description: 'Direct parent title/front text (omitted for top-level Rems)',
+                        },
+                        aliases: {
+                            type: 'array',
+                            items: { type: 'string' },
+                            description: 'Alternate names for the Rem (omitted if none)',
                         },
                         remType: {
                             type: 'string',
@@ -58,7 +86,59 @@ export const SEARCH_TOOL = {
                         },
                         content: {
                             type: 'string',
-                            description: 'Child content (only when includeContent=true)',
+                            description: 'Rendered markdown content of child subtree (only when includeContent="markdown")',
+                        },
+                        contentStructured: {
+                            type: 'array',
+                            description: 'Structured child subtree with nested remIds and metadata (only when includeContent="structured")',
+                            items: {
+                                type: 'object',
+                                properties: {
+                                    remId: { type: 'string', description: 'Child Rem ID' },
+                                    title: { type: 'string', description: 'Rendered child title' },
+                                    headline: {
+                                        type: 'string',
+                                        description: 'Display-oriented child line with type-aware delimiter',
+                                    },
+                                    aliases: {
+                                        type: 'array',
+                                        items: { type: 'string' },
+                                        description: 'Alternate names for the child Rem (omitted if none)',
+                                    },
+                                    remType: {
+                                        type: 'string',
+                                        description: 'Child Rem classification: document, dailyDocument, concept, descriptor, portal, or text',
+                                    },
+                                    cardDirection: {
+                                        type: 'string',
+                                        description: 'Child flashcard direction: forward, reverse, or bidirectional (omitted if not a flashcard)',
+                                    },
+                                    children: {
+                                        type: 'array',
+                                        description: 'Nested child nodes (same shape recursively)',
+                                        items: { type: 'object' },
+                                    },
+                                },
+                                required: ['remId', 'title', 'headline', 'remType', 'children'],
+                            },
+                        },
+                        contentProperties: {
+                            type: 'object',
+                            description: 'Metadata about rendered content',
+                            properties: {
+                                childrenRendered: {
+                                    type: 'number',
+                                    description: 'Number of children included in rendered content',
+                                },
+                                childrenTotal: {
+                                    type: 'number',
+                                    description: 'Total children in subtree (capped at 2000)',
+                                },
+                                contentTruncated: {
+                                    type: 'boolean',
+                                    description: 'Whether content was truncated by maxContentLength',
+                                },
+                            },
                         },
                     },
                 },
@@ -66,14 +146,63 @@ export const SEARCH_TOOL = {
         },
     },
 };
+export const SEARCH_BY_TAG_TOOL = {
+    name: 'remnote_search_by_tag',
+    description: 'Find notes by tag and return resolved ancestor context targets (nearest document/daily document when available, otherwise nearest non-document ancestor). Supports the same includeContent modes as remnote_search.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            tag: {
+                type: 'string',
+                description: 'Tag name to search (with or without # prefix)',
+            },
+            limit: { type: 'number', description: 'Maximum results (1-150, default: 50)' },
+            includeContent: {
+                type: 'string',
+                enum: ['none', 'markdown', 'structured'],
+                description: 'Content rendering mode: "none" omits content (default), "markdown" renders child subtree as indented markdown, "structured" returns nested child objects with remIds',
+            },
+            depth: {
+                type: 'number',
+                description: 'Depth of child hierarchy to render for markdown/structured content (0-10, default: 1)',
+            },
+            childLimit: {
+                type: 'number',
+                description: 'Maximum children per level (1-500, default: 20)',
+            },
+            maxContentLength: {
+                type: 'number',
+                description: 'Maximum character length for rendered content (default: 3000)',
+            },
+        },
+        required: ['tag'],
+    },
+    outputSchema: SEARCH_TOOL.outputSchema,
+};
 export const READ_NOTE_TOOL = {
     name: 'remnote_read_note',
-    description: 'Read a specific note from RemNote by its Rem ID, including type classification and flashcard metadata',
+    description: 'Read a specific note from RemNote by its Rem ID. Returns metadata and rendered markdown content of the child subtree. Use includeContent: "none" to skip content rendering.',
     inputSchema: {
         type: 'object',
         properties: {
             remId: { type: 'string', description: 'The Rem ID to read' },
-            depth: { type: 'number', description: 'Depth of children to include (0-10, default: 3)' },
+            depth: {
+                type: 'number',
+                description: 'Depth of child hierarchy to render (0-10, default: 5)',
+            },
+            includeContent: {
+                type: 'string',
+                enum: ['none', 'markdown'],
+                description: 'Content rendering mode: "markdown" renders child subtree (default), "none" omits content',
+            },
+            childLimit: {
+                type: 'number',
+                description: 'Maximum children per level (1-500, default: 100)',
+            },
+            maxContentLength: {
+                type: 'number',
+                description: 'Maximum character length for rendered content (default: 100000)',
+            },
         },
         required: ['remId'],
     },
@@ -82,9 +211,22 @@ export const READ_NOTE_TOOL = {
         properties: {
             remId: { type: 'string', description: 'Unique Rem ID' },
             title: { type: 'string', description: 'Rendered title with markdown formatting' },
-            detail: {
+            headline: {
+                type: 'string',
+                description: 'Display-oriented full line: title + type-aware delimiter + detail (e.g. "Term :: Definition")',
+            },
+            parentRemId: {
+                type: 'string',
+                description: 'Direct parent Rem ID (omitted for top-level Rems)',
+            },
+            parentTitle: {
                 type: 'string',
-                description: 'Back text for CDF/flashcard Rems (omitted if none)',
+                description: 'Direct parent title/front text (omitted for top-level Rems)',
+            },
+            aliases: {
+                type: 'array',
+                items: { type: 'string' },
+                description: 'Alternate names for the Rem (omitted if none)',
             },
             remType: {
                 type: 'string',
@@ -94,16 +236,25 @@ export const READ_NOTE_TOOL = {
                 type: 'string',
                 description: 'Flashcard direction: forward, reverse, or bidirectional (omitted if not a flashcard)',
             },
-            content: { type: 'string', description: 'Rendered title text (same as title)' },
-            children: {
-                type: 'array',
-                description: 'Child Rems up to requested depth',
-                items: {
-                    type: 'object',
-                    properties: {
-                        remId: { type: 'string' },
-                        text: { type: 'string' },
-                        children: { type: 'array' },
+            content: {
+                type: 'string',
+                description: 'Rendered markdown content of child subtree (when includeContent="markdown", which is the default)',
+            },
+            contentProperties: {
+                type: 'object',
+                description: 'Metadata about rendered content',
+                properties: {
+                    childrenRendered: {
+                        type: 'number',
+                        description: 'Number of children included in rendered content',
+                    },
+                    childrenTotal: {
+                        type: 'number',
+                        description: 'Total children in subtree (capped at 2000)',
+                    },
+                    contentTruncated: {
+                        type: 'boolean',
+                        description: 'Whether content was truncated by maxContentLength',
                     },
                 },
             },
@@ -165,6 +316,11 @@ export function registerAllTools(server, wsServer, logger) {
                     result = await wsServer.sendRequest('search', args);
                     break;
                 }
+                case 'remnote_search_by_tag': {
+                    const args = SearchByTagSchema.parse(request.params.arguments);
+                    result = await wsServer.sendRequest('search_by_tag', args);
+                    break;
+                }
                 case 'remnote_read_note': {
                     const args = ReadNoteSchema.parse(request.params.arguments);
                     result = await wsServer.sendRequest('read_note', args);
@@ -182,12 +338,27 @@ export function registerAllTools(server, wsServer, logger) {
                 }
                 case 'remnote_status': {
                     const connected = wsServer.isConnected();
+                    const serverVersion = wsServer.getServerVersion();
+                    const bridgeVersion = wsServer.getBridgeVersion();
                     if (!connected) {
-                        result = { connected: false, message: 'RemNote plugin not connected' };
+                        result = { connected: false, serverVersion, message: 'RemNote plugin not connected' };
                     }
                     else {
                         const statusResult = await wsServer.sendRequest('get_status', {});
-                        result = { connected: true, ...(typeof statusResult === 'object' ? statusResult : {}) };
+                        const statusObj = typeof statusResult === 'object' && statusResult !== null
+                            ? statusResult
+                            : {};
+                        const fallbackBridgeVersion = typeof statusObj.pluginVersion === 'string' ? statusObj.pluginVersion : null;
+                        const effectiveBridgeVersion = bridgeVersion ?? fallbackBridgeVersion;
+                        const versionWarning = effectiveBridgeVersion
+                            ? checkVersionCompatibility(serverVersion, effectiveBridgeVersion)
+                            : null;
+                        result = {
+                            connected: true,
+                            serverVersion,
+                            ...statusObj,
+                            ...(versionWarning ? { version_warning: versionWarning } : {}),
+                        };
                     }
                     break;
                 }
@@ -225,6 +396,7 @@ export function registerAllTools(server, wsServer, logger) {
             tools: [
                 CREATE_NOTE_TOOL,
                 SEARCH_TOOL,
+                SEARCH_BY_TAG_TOOL,
                 READ_NOTE_TOOL,
                 UPDATE_NOTE_TOOL,
                 APPEND_JOURNAL_TOOL,