@jotx-labs/mcp 2.4.246

package/dist/syntax-guide.js

@@ -0,0 +1,342 @@
+"use strict";
+/**
+ * Syntax Guide — Jotx User Manual content loader
+ *
+ * Provides the Jotx syntax reference for AI consumption.
+ * Can load from a file path (provided by host app) or return
+ * a concise embedded reference.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadSyntaxGuide = loadSyntaxGuide;
+exports.getSyntaxGuideByTopic = getSyntaxGuideByTopic;
+const fs = __importStar(require("fs"));
+/**
+ * Topic sections that can be extracted from the guide
+ */
+const TOPIC_KEYWORDS = {
+    headings: ['heading', 'level 1', 'level 2', 'level 3'],
+    lists: ['list', 'listtype', 'bulleted', 'numbered', 'listitem'],
+    checklists: ['checklist', 'taskitem', 'checked'],
+    code: ['code', 'language', 'codereference'],
+    charts: ['chart', 'charttype', 'json', 'bar', 'line', 'pie'],
+    math: ['math', 'src', 'display', 'LaTeX'],
+    mermaid: ['mermaid', 'flowchart', 'sequence'],
+    tables: ['table', 'columns', 'row', 'cell'],
+    images: ['image', 'floatimage', 'src', 'alt', 'caption'],
+    videos: ['video', 'youtube', 'local'],
+    callouts: ['callout', 'variant', 'info', 'warning', 'success', 'danger'],
+    navigation: ['button', 'gridcard', 'card', 'jotxlink', 'link'],
+    layout: ['columns', 'column', 'cols', 'section', 'toggle'],
+    properties: ['properties', 'property', 'key', 'value'],
+    presentations: ['slideproperties', 'theme', 'transition', 'divider'],
+};
+/**
+ * Embedded concise syntax reference.
+ * Used when no external file path is provided.
+ */
+const EMBEDDED_SYNTAX_REFERENCE = `# Jotx .jot File Syntax Reference
+
+## File Structure
+Every .jot file MUST start with a header definition:
+\`\`\`
+hdef jotx <DocumentId>
+
+  title "Document Title"
+  icon "📄"
+  type root
+\`\`\`
+
+## Block Syntax
+All blocks use the pattern: \`def <blocktype> <unique_id>\`
+Block IDs must be unique within a document (8-char alphanumeric recommended).
+
+## Core Block Types
+
+### Text Blocks
+\`\`\`
+def heading block_1
+  text "My Heading"
+  level 1
+
+def paragraph block_2
+  text "Regular paragraph text with **bold** and *italic*."
+
+def quote block_3
+  text "A blockquote"
+\`\`\`
+
+### Lists
+\`\`\`
+def list block_4
+  listtype bulleted
+  def listitem item_1
+    text "First item"
+  def listitem item_2
+    text "Second item"
+
+def list block_5
+  listtype numbered
+  def listitem item_1
+    text "Step one"
+\`\`\`
+
+### Checklists
+\`\`\`
+def checklist block_6
+  def taskitem task_1
+    checked "false"
+    text "Todo item"
+  def taskitem task_2
+    checked "true"
+    text "Done item"
+\`\`\`
+
+### Code
+\`\`\`
+def code block_7
+  language "typescript"
+  text """function hello() {
+  return "world"
+}"""
+\`\`\`
+
+### Charts
+\`\`\`
+def chart block_8
+  title "Monthly Stats"
+  charttype bar
+  json "{\\"labels\\": [\\"Jan\\", \\"Feb\\"], \\"datasets\\": [{\\"label\\": \\"Events\\", \\"data\\": [12, 39]}]}"
+  showsource "false"
+\`\`\`
+
+### Math (LaTeX)
+\`\`\`
+def math block_9
+  title "Equation"
+  src "E = mc^2"
+  display block
+\`\`\`
+
+### Mermaid Diagrams
+\`\`\`
+def mermaid block_10
+  title "Flow"
+  src """flowchart TD
+    A[Start] --> B[End]"""
+  showsource "false"
+\`\`\`
+
+### Tables
+\`\`\`
+def table block_11
+  columns "Name, Value"
+  def row r1
+    def cell c1
+      def paragraph p1
+        text "Cell content"
+    def cell c2
+      def paragraph p2
+        text "Cell content"
+\`\`\`
+
+### Callouts (4 variants: info, warning, success, danger)
+\`\`\`
+def callout block_12
+  variant info
+  text "ℹ️ This is an info callout"
+\`\`\`
+
+### Images
+\`\`\`
+def image block_13
+  src "https://example.com/image.png"
+  alt "Description"
+  width 500
+  height "auto"
+  align center
+  caption "Image caption"
+\`\`\`
+
+### Navigation
+\`\`\`
+def button block_14
+  label "Next Page"
+  link "./next.jot"
+  style primary
+  align left
+
+def gridcard block_15
+  layout 2x2
+  def card c1
+    title "Dashboard"
+    icon "📊"
+    color teal
+    link "./dashboard.jot"
+    value ""
+\`\`\`
+
+### Toggle & Section (collapsible)
+\`\`\`
+def toggle block_16
+  title "Click to expand"
+  collapsed "false"
+  def paragraph p1
+    text "Hidden content"
+
+def section block_17
+  title "Section Title"
+  collapsed "false"
+  def paragraph p1
+    text "Section content"
+\`\`\`
+
+### Columns Layout
+\`\`\`
+def columns block_18
+  cols "2"
+  def column col1
+    def paragraph p1
+      text "Left column"
+  def column col2
+    def paragraph p2
+      text "Right column"
+\`\`\`
+
+### Divider
+\`\`\`
+def divider block_19
+\`\`\`
+
+### Properties (key-value metadata)
+\`\`\`
+def properties block_20
+  def property p1
+    key "Status"
+    value "Active"
+  def property p2
+    key "Priority"
+    value "High"
+\`\`\`
+
+### Internal Links (jotxlink)
+\`\`\`
+def jotxlink block_21
+  reftype heading
+  refid DocumentId#block_id
+\`\`\`
+
+## Important Rules
+1. Every file starts with \`hdef jotx <DocumentId>\`
+2. Block IDs must be unique within a file
+3. Indentation is 2 spaces per nesting level
+4. String values use double quotes: \`text "hello"\`
+5. Multi-line strings use triple quotes: \`text """line1\\nline2"""\`
+6. Boolean-like properties are strings: \`checked "false"\`, not \`checked false\`
+7. Nested blocks (children) are indented under their parent
+`;
+/**
+ * Load the syntax guide content.
+ * If a file path is provided, reads the full User Manual.
+ * Otherwise, returns the embedded concise reference.
+ */
+function loadSyntaxGuide(filePath) {
+    if (filePath) {
+        try {
+            return fs.readFileSync(filePath, 'utf-8');
+        }
+        catch {
+            // Fall back to embedded reference if file not found
+            return EMBEDDED_SYNTAX_REFERENCE;
+        }
+    }
+    return EMBEDDED_SYNTAX_REFERENCE;
+}
+/**
+ * Get a topic-specific section from the syntax guide.
+ * If topic is not found, returns the full guide.
+ */
+function getSyntaxGuideByTopic(topic, fullGuide) {
+    const topicLower = topic.toLowerCase();
+    const keywords = TOPIC_KEYWORDS[topicLower];
+    if (!keywords) {
+        // Return available topics + full guide
+        const availableTopics = Object.keys(TOPIC_KEYWORDS).join(', ');
+        return `Available topics: ${availableTopics}\n\n${fullGuide}`;
+    }
+    // Extract relevant sections from the guide
+    const lines = fullGuide.split('\n');
+    const relevantLines = [];
+    let inRelevantSection = false;
+    let sectionDepth = 0;
+    for (const line of lines) {
+        const isHeader = line.match(/^#{1,3}\s/);
+        if (isHeader) {
+            const headerLower = line.toLowerCase();
+            const isRelevant = keywords.some(kw => headerLower.includes(kw));
+            if (isRelevant) {
+                inRelevantSection = true;
+                sectionDepth = (line.match(/^#+/) || [''])[0].length;
+            }
+            else if (inRelevantSection) {
+                const currentDepth = (line.match(/^#+/) || [''])[0].length;
+                if (currentDepth <= sectionDepth) {
+                    inRelevantSection = false;
+                }
+            }
+        }
+        if (inRelevantSection) {
+            relevantLines.push(line);
+        }
+    }
+    if (relevantLines.length > 0) {
+        return `# Jotx Syntax: ${topic}\n\n${relevantLines.join('\n')}`;
+    }
+    // Fallback: search for keyword matches in the full guide
+    const codeBlockLines = [];
+    let inCodeBlock = false;
+    for (const line of lines) {
+        if (line.startsWith('```')) {
+            inCodeBlock = !inCodeBlock;
+        }
+        if (inCodeBlock || keywords.some(kw => line.toLowerCase().includes(kw))) {
+            codeBlockLines.push(line);
+        }
+    }
+    return codeBlockLines.length > 0
+        ? `# Jotx Syntax: ${topic}\n\n${codeBlockLines.join('\n')}`
+        : fullGuide;
+}
+//# sourceMappingURL=syntax-guide.js.map

package/dist/syntax-guide.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"syntax-guide.js","sourceRoot":"","sources":["../src/syntax-guide.ts"],"names":[],"mappings":"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"}

package/dist/tools/context-tools.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Context Tools — MCP tools for editor context and error forwarding
+ *
+ * Tools: jotx_get_current_doc, jotx_report_errors
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { JotxMCPConfig } from '../types';
+/**
+ * Register context tools on the MCP server.
+ */
+export declare function registerContextTools(server: McpServer, config: JotxMCPConfig): void;
+//# sourceMappingURL=context-tools.d.ts.map

package/dist/tools/context-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-tools.d.ts","sourceRoot":"","sources":["../../src/tools/context-tools.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AACnE,OAAO,EAAE,aAAa,EAA8B,MAAM,UAAU,CAAA;AAYpE;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,GAAG,IAAI,CA6EnF"}

package/dist/tools/context-tools.js

@@ -0,0 +1,82 @@
+"use strict";
+/**
+ * Context Tools — MCP tools for editor context and error forwarding
+ *
+ * Tools: jotx_get_current_doc, jotx_report_errors
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerContextTools = registerContextTools;
+const zod_1 = require("zod");
+// Define schemas explicitly to avoid TS2589
+const ReportErrorsSchema = {
+    errors: zod_1.z.array(zod_1.z.object({
+        message: zod_1.z.string().describe('The error message'),
+        filePath: zod_1.z.string().optional().describe('File where the error occurred'),
+        line: zod_1.z.number().optional().describe('Line number of the error'),
+        blockId: zod_1.z.string().optional().describe('Block ID where the error occurred'),
+    })).describe('Array of validation errors from the editor'),
+};
+/**
+ * Register context tools on the MCP server.
+ */
+function registerContextTools(server, config) {
+    // ─── jotx_get_current_doc ────────────────────────────────────────
+    server.tool('jotx_get_current_doc', 'Get the full content of the document currently open in the editor. Use this instead of jotx_read_file when the user asks about their current/active document.', {}, async () => {
+        try {
+            const context = config.getCurrentContext?.();
+            if (!context || !context.content) {
+                return {
+                    content: [{
+                            type: 'text',
+                            text: 'No document is currently open in the editor.',
+                        }],
+                };
+            }
+            const info = context.filePath
+                ? `Currently open: ${context.filePath}\n\n`
+                : '';
+            return {
+                content: [{
+                        type: 'text',
+                        text: `${info}${context.content}`,
+                    }],
+            };
+        }
+        catch (err) {
+            return {
+                content: [{ type: 'text', text: `Error getting current document: ${err.message}` }],
+                isError: true,
+            };
+        }
+    });
+    // ─── jotx_report_errors ──────────────────────────────────────────
+    server.registerTool('jotx_report_errors', {
+        description: 'Receive validation errors from the editor. Use these errors to understand what is wrong with the current document and suggest fixes. The errors come from the Jotx parser/validator.',
+        inputSchema: ReportErrorsSchema,
+    }, async (args) => {
+        const editorErrors = args.errors; // Explicit cast for complex object array
+        if (editorErrors.length === 0) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: '✅ No errors reported. The document appears to be valid.',
+                    }],
+            };
+        }
+        const formatted = editorErrors.map((err, i) => {
+            const location = [
+                err.filePath ? `File: ${err.filePath}` : null,
+                err.line ? `Line: ${err.line}` : null,
+                err.blockId ? `Block: ${err.blockId}` : null,
+            ].filter(Boolean).join(', ');
+            return `${i + 1}. ${err.message}${location ? ` (${location})` : ''}`;
+        });
+        return {
+            content: [{
+                    type: 'text',
+                    text: `⚠️ ${editorErrors.length} error(s) reported from the editor:\n\n${formatted.join('\n')}\n\nTo fix these, I can read the affected file(s) with jotx_read_file, make corrections, validate with jotx_validate, and write back with jotx_write_file.`,
+                }],
+        };
+    });
+}
+//# sourceMappingURL=context-tools.js.map

package/dist/tools/context-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-tools.js","sourceRoot":"","sources":["../../src/tools/context-tools.ts"],"names":[],"mappings":"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"}

package/dist/tools/file-tools.d.ts

@@ -0,0 +1,12 @@
+/**
+ * File Tools — MCP tools for file operations
+ *
+ * Tools: jotx_list_files, jotx_read_file, jotx_write_file
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { JotxMCPConfig } from '../types';
+/**
+ * Register file operation tools on the MCP server.
+ */
+export declare function registerFileTools(server: McpServer, config: JotxMCPConfig): void;
+//# sourceMappingURL=file-tools.d.ts.map

package/dist/tools/file-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-tools.d.ts","sourceRoot":"","sources":["../../src/tools/file-tools.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AACnE,OAAO,EAAE,aAAa,EAAiB,MAAM,UAAU,CAAA;AAgBvD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,GAAG,IAAI,CA0IhF"}

package/dist/tools/file-tools.js

@@ -0,0 +1,150 @@
+"use strict";
+/**
+ * File Tools — MCP tools for file operations
+ *
+ * Tools: jotx_list_files, jotx_read_file, jotx_write_file
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerFileTools = registerFileTools;
+const zod_1 = require("zod");
+// Define schemas explicitly to avoid TS2589
+const ListFilesSchema = {
+    directory: zod_1.z.string().optional().describe('Optional subdirectory to list. If empty, lists the entire workspace.'),
+};
+const ReadFileSchema = {
+    filePath: zod_1.z.string().describe('Path to the file, relative to the workspace root.'),
+};
+const WriteFileSchema = {
+    filePath: zod_1.z.string().describe('Path for the file, relative to workspace root. Must end in .jot'),
+    content: zod_1.z.string().describe('The full .jot file content to write. Must be valid Jotx format.'),
+};
+/**
+ * Register file operation tools on the MCP server.
+ */
+function registerFileTools(server, config) {
+    const { fileOps, workspacePath } = config;
+    // ─── jotx_list_files ─────────────────────────────────────────────
+    server.registerTool('jotx_list_files', {
+        description: 'List all .jot files in the workspace directory recursively. Returns file paths relative to the workspace root.',
+        inputSchema: ListFilesSchema,
+    }, async (args) => {
+        const { directory } = args;
+        try {
+            const files = await fileOps.listFiles(directory);
+            if (files.length === 0) {
+                return {
+                    content: [{ type: 'text', text: 'No .jot files found in the workspace.' }],
+                };
+            }
+            // Get file sizes if available
+            const fileEntries = [];
+            for (const file of files) {
+                if (fileOps.getFileSize) {
+                    try {
+                        const size = await fileOps.getFileSize(file);
+                        fileEntries.push(`  - ${file} (${formatBytes(size)})`);
+                    }
+                    catch {
+                        fileEntries.push(`  - ${file}`);
+                    }
+                }
+                else {
+                    fileEntries.push(`  - ${file}`);
+                }
+            }
+            return {
+                content: [{
+                        type: 'text',
+                        text: `Found ${files.length} .jot file(s) in ${workspacePath}:\n${fileEntries.join('\n')}`,
+                    }],
+            };
+        }
+        catch (err) {
+            return {
+                content: [{ type: 'text', text: `Error listing files: ${err.message}` }],
+                isError: true,
+            };
+        }
+    });
+    // ─── jotx_read_file ──────────────────────────────────────────────
+    server.registerTool('jotx_read_file', {
+        description: 'Read the full contents of a .jot file in the workspace. Use this to understand existing documents before modifying them.',
+        inputSchema: ReadFileSchema,
+    }, async (args) => {
+        const { filePath } = args;
+        try {
+            // Security: validate path doesn't escape workspace
+            if (filePath.includes('..') || filePath.startsWith('/')) {
+                return {
+                    content: [{ type: 'text', text: 'Error: Cannot read files outside the workspace.' }],
+                    isError: true,
+                };
+            }
+            const exists = await fileOps.fileExists(filePath);
+            if (!exists) {
+                return {
+                    content: [{ type: 'text', text: `Error: File not found: ${filePath}` }],
+                    isError: true,
+                };
+            }
+            const content = await fileOps.readFile(filePath);
+            const byteCount = Buffer.byteLength(content, 'utf-8');
+            return {
+                content: [{
+                        type: 'text',
+                        text: `File: ${filePath} (${formatBytes(byteCount)})\n\n${content}`,
+                    }],
+            };
+        }
+        catch (err) {
+            return {
+                content: [{ type: 'text', text: `Error reading file: ${err.message}` }],
+                isError: true,
+            };
+        }
+    });
+    // ─── jotx_write_file ─────────────────────────────────────────────
+    server.registerTool('jotx_write_file', {
+        description: 'Create a new .jot file or overwrite an existing one. The content MUST be valid Jotx .jot format (use jotx_validate first to check). File path must end in .jot.',
+        inputSchema: WriteFileSchema,
+    }, async (args) => {
+        const { filePath, content } = args;
+        try {
+            // Security: validate path
+            if (filePath.includes('..') || filePath.startsWith('/')) {
+                return {
+                    content: [{ type: 'text', text: 'Error: Cannot write files outside the workspace.' }],
+                    isError: true,
+                };
+            }
+            if (!filePath.endsWith('.jot')) {
+                return {
+                    content: [{ type: 'text', text: 'Error: File path must end in .jot' }],
+                    isError: true,
+                };
+            }
+            await fileOps.writeFile(filePath, content);
+            return {
+                content: [{
+                        type: 'text',
+                        text: `✅ File written successfully: ${filePath}`,
+                    }],
+            };
+        }
+        catch (err) {
+            return {
+                content: [{ type: 'text', text: `Error writing file: ${err.message}` }],
+                isError: true,
+            };
+        }
+    });
+}
+// ─── Helpers ─────────────────────────────────────────────────────────
+function formatBytes(bytes) {
+    if (bytes < 1024)
+        return `${bytes} B`;
+    if (bytes < 1024 * 1024)
+        return `${(bytes / 1024).toFixed(1)} KB`;
+    return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
+}
+//# sourceMappingURL=file-tools.js.map

package/dist/tools/file-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-tools.js","sourceRoot":"","sources":["../../src/tools/file-tools.ts"],"names":[],"mappings":"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"}

package/dist/tools/graph-tools.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Graph Tools — MCP tools for knowledge graph and workspace structure
+ *
+ * Tools: jotx_get_graph, jotx_get_document_info, jotx_get_workspace_stats, jotx_get_backlinks
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { JotxMCPConfig } from '../types';
+/**
+ * Register graph tools on the MCP server.
+ */
+export declare function registerGraphTools(server: McpServer, config: JotxMCPConfig): void;
+//# sourceMappingURL=graph-tools.d.ts.map

package/dist/tools/graph-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-tools.d.ts","sourceRoot":"","sources":["../../src/tools/graph-tools.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAEnE,OAAO,EAAE,aAAa,EAAiB,MAAM,UAAU,CAAA;AAkBvD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,GAAG,IAAI,CA0OjF"}