@jotx-labs/mcp 2.4.246

package/dist/__tests__/server.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=server.test.d.ts.map

package/dist/__tests__/server.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/server.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/server.test.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const server_1 = require("../server");
+// Mock dependencies
+const mockFileOps = {
+    listFiles: jest.fn().mockResolvedValue(['file1.jot', 'file2.jot']),
+    readFile: jest.fn().mockResolvedValue('content'),
+    writeFile: jest.fn().mockResolvedValue(undefined),
+    fileExists: jest.fn().mockResolvedValue(true),
+    searchFiles: jest.fn().mockResolvedValue([]),
+};
+const config = {
+    workspacePath: '/mock/workspace',
+    fileOps: mockFileOps,
+};
+describe('createJotxMCPServer', () => {
+    let server;
+    beforeEach(() => {
+        server = (0, server_1.createJotxMCPServer)(config);
+    });
+    test('creates an MCP server instance', () => {
+        expect(server).toBeDefined();
+    });
+    // Note: detailed tool verification would require inspecting private server state
+    // or integration testing the protocol using a client.
+    // For unit tests, we primarily check that the factory runs without error.
+});
+//# sourceMappingURL=server.test.js.map

package/dist/__tests__/server.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.test.js","sourceRoot":"","sources":["../../src/__tests__/server.test.ts"],"names":[],"mappings":";;AAAA,sCAA+C;AAI/C,oBAAoB;AACpB,MAAM,WAAW,GAAY;IACzB,SAAS,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;IAClE,QAAQ,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,SAAS,CAAC;IAChD,SAAS,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,SAAS,CAAC;IACjD,UAAU,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,IAAI,CAAC;IAC7C,WAAW,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,CAAC;CAC/C,CAAA;AAED,MAAM,MAAM,GAAkB;IAC1B,aAAa,EAAE,iBAAiB;IAChC,OAAO,EAAE,WAAW;CACvB,CAAA;AAED,QAAQ,CAAC,qBAAqB,EAAE,GAAG,EAAE;IACjC,IAAI,MAAiB,CAAA;IAErB,UAAU,CAAC,GAAG,EAAE;QACZ,MAAM,GAAG,IAAA,4BAAmB,EAAC,MAAM,CAAC,CAAA;IACxC,CAAC,CAAC,CAAA;IAEF,IAAI,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACxC,MAAM,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAA;IAChC,CAAC,CAAC,CAAA;IAEF,iFAAiF;IACjF,sDAAsD;IACtD,0EAA0E;AAC9E,CAAC,CAAC,CAAA"}

package/dist/__tests__/validation.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=validation.test.d.ts.map

package/dist/__tests__/validation.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/validation.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/validation.test.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+// Mock dependencies
+const mockFileOps = {
+    listFiles: jest.fn(),
+    readFile: jest.fn(),
+    writeFile: jest.fn(),
+    fileExists: jest.fn(),
+    searchFiles: jest.fn(),
+};
+const config = {
+    workspacePath: '/mock/workspace',
+    fileOps: mockFileOps,
+    syntaxGuidePath: '/mock/syntax.jot',
+};
+describe('MCP Validation Tools', () => {
+    // These tests integration-test the validation logic via the server factory
+    // In a real scenario, we'd mock the underlying tool handler or test it cleanly.
+    // Since MCP SDK hides tool handlers, we primarily rely on the fact that
+    // registerValidationTools calls parseAndValidate from core.
+    test('placeholder for validation logic test', () => {
+        expect(true).toBe(true);
+    });
+});
+//# sourceMappingURL=validation.test.js.map

package/dist/__tests__/validation.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.test.js","sourceRoot":"","sources":["../../src/__tests__/validation.test.ts"],"names":[],"mappings":";;AAGA,oBAAoB;AACpB,MAAM,WAAW,GAAY;IACzB,SAAS,EAAE,IAAI,CAAC,EAAE,EAAE;IACpB,QAAQ,EAAE,IAAI,CAAC,EAAE,EAAE;IACnB,SAAS,EAAE,IAAI,CAAC,EAAE,EAAE;IACpB,UAAU,EAAE,IAAI,CAAC,EAAE,EAAE;IACrB,WAAW,EAAE,IAAI,CAAC,EAAE,EAAE;CACzB,CAAA;AAED,MAAM,MAAM,GAAkB;IAC1B,aAAa,EAAE,iBAAiB;IAChC,OAAO,EAAE,WAAW;IACpB,eAAe,EAAE,kBAAkB;CACtC,CAAA;AAED,QAAQ,CAAC,sBAAsB,EAAE,GAAG,EAAE;IAClC,2EAA2E;IAC3E,gFAAgF;IAChF,wEAAwE;IACxE,4DAA4D;IAE5D,IAAI,CAAC,uCAAuC,EAAE,GAAG,EAAE;QAC/C,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAC3B,CAAC,CAAC,CAAA;AACN,CAAC,CAAC,CAAA"}

package/dist/index.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @jotx-labs/mcp — Jotx Model Context Protocol Server
+ *
+ * Expose Jotx workspaces via MCP for AI tool integration.
+ * Platform-agnostic — works with Electron, VS Code, and web.
+ *
+ * @module @jotx-labs/mcp
+ *
+ * @example
+ * ```typescript
+ * import { createJotxMCPServer } from '@jotx-labs/mcp'
+ *
+ * const server = createJotxMCPServer({
+ *   workspacePath: '/path/to/workspace',
+ *   fileOps: { readFile, writeFile, listFiles, searchFiles, fileExists },
+ *   nodeManager: optionalNodeManager,
+ * })
+ * ```
+ */
+export { createJotxMCPServer } from './server';
+export type { JotxMCPConfig, FileOps, SearchResult, ValidationError, ValidationResult, EditorError, } from './types';
+export { loadSyntaxGuide, getSyntaxGuideByTopic } from './syntax-guide';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAA;AAG9C,YAAY,EACR,aAAa,EACb,OAAO,EACP,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,WAAW,GACd,MAAM,SAAS,CAAA;AAGhB,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAA"}

package/dist/index.js

@@ -0,0 +1,30 @@
+"use strict";
+/**
+ * @jotx-labs/mcp — Jotx Model Context Protocol Server
+ *
+ * Expose Jotx workspaces via MCP for AI tool integration.
+ * Platform-agnostic — works with Electron, VS Code, and web.
+ *
+ * @module @jotx-labs/mcp
+ *
+ * @example
+ * ```typescript
+ * import { createJotxMCPServer } from '@jotx-labs/mcp'
+ *
+ * const server = createJotxMCPServer({
+ *   workspacePath: '/path/to/workspace',
+ *   fileOps: { readFile, writeFile, listFiles, searchFiles, fileExists },
+ *   nodeManager: optionalNodeManager,
+ * })
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getSyntaxGuideByTopic = exports.loadSyntaxGuide = exports.createJotxMCPServer = void 0;
+// ─── Main API ────────────────────────────────────────────────────────
+var server_1 = require("./server");
+Object.defineProperty(exports, "createJotxMCPServer", { enumerable: true, get: function () { return server_1.createJotxMCPServer; } });
+// ─── Utilities (for advanced usage) ──────────────────────────────────
+var syntax_guide_1 = require("./syntax-guide");
+Object.defineProperty(exports, "loadSyntaxGuide", { enumerable: true, get: function () { return syntax_guide_1.loadSyntaxGuide; } });
+Object.defineProperty(exports, "getSyntaxGuideByTopic", { enumerable: true, get: function () { return syntax_guide_1.getSyntaxGuideByTopic; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;GAkBG;;;AAEH,wEAAwE;AACxE,mCAA8C;AAArC,6GAAA,mBAAmB,OAAA;AAY5B,wEAAwE;AACxE,+CAAuE;AAA9D,+GAAA,eAAe,OAAA;AAAE,qHAAA,qBAAqB,OAAA"}

package/dist/server.d.ts

@@ -0,0 +1,35 @@
+/**
+ * @jotx-labs/mcp — MCP Server Factory
+ *
+ * Creates a Jotx MCP server with all tools and resources registered.
+ * Platform-agnostic — host apps inject file I/O via the FileOps interface.
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { JotxMCPConfig } from './types';
+/**
+ * Create a Jotx MCP server with all tools and resources.
+ *
+ * @param config - Platform-specific configuration
+ * @returns A configured McpServer ready to connect via transport
+ *
+ * @example
+ * ```typescript
+ * // In Electron main process:
+ * import { createJotxMCPServer } from '@jotx-labs/mcp'
+ * import * as fs from 'fs'
+ *
+ * const server = createJotxMCPServer({
+ *   workspacePath: '/path/to/workspace',
+ *   nodeManager: workspaceIndexer.getNodeManager(),
+ *   fileOps: {
+ *     readFile: (p) => fs.promises.readFile(path.join(workspace, p), 'utf-8'),
+ *     writeFile: (p, c) => fs.promises.writeFile(path.join(workspace, p), c),
+ *     listFiles: async () => collectJotFiles(workspace),
+ *     searchFiles: async (q) => searchIn(workspace, q),
+ *     fileExists: (p) => fs.existsSync(path.join(workspace, p)),
+ *   }
+ * })
+ * ```
+ */
+export declare function createJotxMCPServer(config: JotxMCPConfig): McpServer;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAGnE,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAWvC;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,aAAa,GAAG,SAAS,CAsBpE"}

package/dist/server.js

@@ -0,0 +1,131 @@
+"use strict";
+/**
+ * @jotx-labs/mcp — MCP Server Factory
+ *
+ * Creates a Jotx MCP server with all tools and resources registered.
+ * Platform-agnostic — host apps inject file I/O via the FileOps interface.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createJotxMCPServer = createJotxMCPServer;
+const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
+const registry_1 = require("@jotx-labs/registry");
+const standard_lib_1 = require("@jotx-labs/standard-lib");
+const file_tools_1 = require("./tools/file-tools");
+const search_tools_1 = require("./tools/search-tools");
+const context_tools_1 = require("./tools/context-tools");
+const graph_tools_1 = require("./tools/graph-tools");
+const validation_tools_1 = require("./tools/validation-tools");
+const syntax_guide_1 = require("./syntax-guide");
+// Package version — kept in sync with package.json
+const PACKAGE_VERSION = '2.4.245';
+/**
+ * Create a Jotx MCP server with all tools and resources.
+ *
+ * @param config - Platform-specific configuration
+ * @returns A configured McpServer ready to connect via transport
+ *
+ * @example
+ * ```typescript
+ * // In Electron main process:
+ * import { createJotxMCPServer } from '@jotx-labs/mcp'
+ * import * as fs from 'fs'
+ *
+ * const server = createJotxMCPServer({
+ *   workspacePath: '/path/to/workspace',
+ *   nodeManager: workspaceIndexer.getNodeManager(),
+ *   fileOps: {
+ *     readFile: (p) => fs.promises.readFile(path.join(workspace, p), 'utf-8'),
+ *     writeFile: (p, c) => fs.promises.writeFile(path.join(workspace, p), c),
+ *     listFiles: async () => collectJotFiles(workspace),
+ *     searchFiles: async (q) => searchIn(workspace, q),
+ *     fileExists: (p) => fs.existsSync(path.join(workspace, p)),
+ *   }
+ * })
+ * ```
+ */
+function createJotxMCPServer(config) {
+    // Ensure standard blocks are registered for validation and schema tools
+    (0, standard_lib_1.registerStandardBlocks)();
+    const server = new mcp_js_1.McpServer({
+        name: 'jotx',
+        version: PACKAGE_VERSION,
+    });
+    // ─── Register All Tools ──────────────────────────────────────────
+    (0, file_tools_1.registerFileTools)(server, config);
+    (0, search_tools_1.registerSearchTools)(server, config);
+    (0, context_tools_1.registerContextTools)(server, config);
+    (0, graph_tools_1.registerGraphTools)(server, config);
+    (0, validation_tools_1.registerValidationTools)(server, config);
+    // ─── Register MCP Resources ──────────────────────────────────────
+    registerResources(server, config);
+    return server;
+}
+// ─── MCP Resources ───────────────────────────────────────────────────
+function registerResources(server, config) {
+    const { nodeManager, fileOps } = config;
+    // Resource: Workspace Summary
+    server.resource('workspace-summary', 'jotx://workspace/summary', async (uri) => {
+        const files = await fileOps.listFiles();
+        const summary = {
+            workspacePath: config.workspacePath,
+            fileCount: files.length,
+            files: files.slice(0, 30),
+        };
+        if (nodeManager) {
+            const stats = nodeManager.getStats();
+            summary.graph = {
+                documents: stats.documents,
+                blocks: stats.blocks,
+                edges: stats.edges,
+            };
+        }
+        return {
+            contents: [{
+                    uri: uri.href,
+                    mimeType: 'application/json',
+                    text: JSON.stringify(summary, null, 2),
+                }],
+        };
+    });
+    // Resource: Block Types
+    server.resource('block-types', 'jotx://block-types', async (uri) => {
+        const registry = registry_1.BlockRegistry.getInstance();
+        const allBlocks = registry.getAll();
+        const blockTypes = allBlocks.map(block => ({
+            type: block.type,
+            keyword: block.syntax.keyword || block.type,
+            hasChildren: block.syntax.hasChildren || false,
+            hasText: block.syntax.hasText || false,
+            properties: Object.entries(block.schema.properties).map(([name, prop]) => ({
+                name,
+                type: prop.type,
+                required: prop.required || false,
+                ...(prop.options ? { options: prop.options } : {}),
+                ...(prop.description ? { description: prop.description } : {}),
+                ...(prop.default !== undefined ? { default: prop.default } : {}),
+            })),
+            ...(block.ui?.label ? { label: block.ui.label } : {}),
+            ...(block.ui?.description ? { description: block.ui.description } : {}),
+            ...(block.ui?.icon ? { icon: block.ui.icon } : {}),
+        }));
+        return {
+            contents: [{
+                    uri: uri.href,
+                    mimeType: 'application/json',
+                    text: JSON.stringify({ blockTypes, count: blockTypes.length }, null, 2),
+                }],
+        };
+    });
+    // Resource: Syntax Guide
+    server.resource('syntax-guide', 'jotx://syntax-guide', async (uri) => {
+        const guide = (0, syntax_guide_1.loadSyntaxGuide)(config.syntaxGuidePath);
+        return {
+            contents: [{
+                    uri: uri.href,
+                    mimeType: 'text/plain',
+                    text: guide,
+                }],
+        };
+    });
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/dist/syntax-guide.d.ts

@@ -0,0 +1,19 @@
+/**
+ * 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.
+ */
+/**
+ * Load the syntax guide content.
+ * If a file path is provided, reads the full User Manual.
+ * Otherwise, returns the embedded concise reference.
+ */
+export declare function loadSyntaxGuide(filePath?: string): string;
+/**
+ * Get a topic-specific section from the syntax guide.
+ * If topic is not found, returns the full guide.
+ */
+export declare function getSyntaxGuideByTopic(topic: string, fullGuide: string): string;
+//# sourceMappingURL=syntax-guide.d.ts.map

package/dist/syntax-guide.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"syntax-guide.d.ts","sourceRoot":"","sources":["../src/syntax-guide.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAsOH;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAUzD;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAwD9E"}