@carlonicora/nestjs-neo4jsonapi 1.110.3 → 1.112.0

package/dist/mcp/services/mcp.tool.registry.js

@@ -0,0 +1,72 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.McpToolRegistry = void 0;
+const common_1 = require("@nestjs/common");
+const mcp_tool_interface_1 = require("../interfaces/mcp.tool.interface");
+const mcp_generic_tools_service_1 = require("./mcp.generic.tools.service");
+const mcp_promoted_tools_factory_1 = require("./mcp.promoted.tools.factory");
+/**
+ * Composes the MCP tool set for a single authenticated request:
+ * - the generic tools (graph reads, document retrieval, entity writes)
+ * - the config-promoted per-entity tools
+ * - any app-contributed factories registered under the MCP_TOOLS token,
+ *   built per request with the same user context as the built-ins
+ */
+let McpToolRegistry = class McpToolRegistry {
+    constructor(generic, promoted, contributed) {
+        this.generic = generic;
+        this.promoted = promoted;
+        this.contributed = contributed;
+    }
+    /** RBAC-filtered tool list for this user; throws on duplicate tool names. */
+    build(ctx) {
+        const tools = [
+            ...this.generic.build(ctx),
+            ...this.promoted.build(ctx),
+            ...(this.contributed ?? []).flatMap((c) => c.build(ctx)),
+        ];
+        // Guard against name collisions: a contributed tool named like a built-in
+        // would otherwise silently shadow it in tools/call dispatch.
+        const seen = new Set();
+        for (const tool of tools) {
+            if (seen.has(tool.name)) {
+                throw new Error(`McpToolRegistry: duplicate MCP tool name: ${tool.name}. ` +
+                    `A contributed MCP_TOOLS contribution must not reuse the name of a built-in or another contributed tool.`);
+            }
+            seen.add(tool.name);
+        }
+        return tools;
+    }
+    /** Routes a tools/call to the named tool; unknown names return a flat error payload. */
+    async call(name, input, ctx) {
+        const tool = this.build(ctx).find((t) => t.name === name);
+        if (!tool) {
+            return {
+                isError: true,
+                content: [{ type: "text", text: JSON.stringify({ code: "unknown_type", message: `Unknown tool: ${name}` }) }],
+            };
+        }
+        return tool.execute(input, ctx);
+    }
+};
+exports.McpToolRegistry = McpToolRegistry;
+exports.McpToolRegistry = McpToolRegistry = __decorate([
+    (0, common_1.Injectable)(),
+    __param(2, (0, common_1.Optional)()),
+    __param(2, (0, common_1.Inject)(mcp_tool_interface_1.MCP_TOOLS)),
+    __metadata("design:paramtypes", [mcp_generic_tools_service_1.McpGenericToolsService,
+        mcp_promoted_tools_factory_1.McpPromotedToolsFactory, Array])
+], McpToolRegistry);
+//# sourceMappingURL=mcp.tool.registry.js.map

package/dist/mcp/services/mcp.tool.registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.tool.registry.js","sourceRoot":"","sources":["../../../src/mcp/services/mcp.tool.registry.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,2CAA8D;AAC9D,yEAM0C;AAC1C,2EAAqE;AACrE,6EAAuE;AAEvE;;;;;;GAMG;AAEI,IAAM,eAAe,GAArB,MAAM,eAAe;IAC1B,YACmB,OAA+B,EAC/B,QAAiC,EACF,WAAmC;QAFlE,YAAO,GAAP,OAAO,CAAwB;QAC/B,aAAQ,GAAR,QAAQ,CAAyB;QACF,gBAAW,GAAX,WAAW,CAAwB;IAClF,CAAC;IAEJ,6EAA6E;IAC7E,KAAK,CAAC,GAAmB;QACvB,MAAM,KAAK,GAAG;YACZ,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC;YAC1B,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC;YAC3B,GAAG,CAAC,IAAI,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;SACzD,CAAC;QAEF,0EAA0E;QAC1E,6DAA6D;QAC7D,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;QAC/B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBACxB,MAAM,IAAI,KAAK,CACb,6CAA6C,IAAI,CAAC,IAAI,IAAI;oBACxD,yGAAyG,CAC5G,CAAC;YACJ,CAAC;YACD,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtB,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,wFAAwF;IACxF,KAAK,CAAC,IAAI,CAAC,IAAY,EAAE,KAA8B,EAAE,GAAmB;QAC1E,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;QAC1D,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,iBAAiB,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC;aAC9G,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAClC,CAAC;CACF,CAAA;AAzCY,0CAAe;0BAAf,eAAe;IAD3B,IAAA,mBAAU,GAAE;IAKR,WAAA,IAAA,iBAAQ,GAAE,CAAA;IAAE,WAAA,IAAA,eAAM,EAAC,8BAAS,CAAC,CAAA;qCAFJ,kDAAsB;QACrB,oDAAuB;GAHzC,eAAe,CAyC3B"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@carlonicora/nestjs-neo4jsonapi",
-  "version": "1.110.3",
+  "version": "1.112.0",
   "description": "NestJS foundation package with JSON:API, Neo4j, Redis, LangChain agents, and common utilities",
   "author": "Carlo Nicora",
   "license": "GPL-3.0-or-later",
@@ -47,6 +47,10 @@
     "./bootstrap": {
       "types": "./dist/bootstrap/index.d.ts",
       "default": "./dist/bootstrap/index.js"
+    },
+    "./mcp": {
+      "types": "./dist/mcp/index.d.ts",
+      "default": "./dist/mcp/index.js"
     }
   },
   "scripts": {
@@ -68,9 +72,8 @@
     "@aws-sdk/lib-storage": "^3.1075.0",
     "@aws-sdk/s3-request-presigner": "^3.1053.0",
     "@azure/storage-blob": "^12.31.0",
-    "@kenjiuno/msgreader": "^1.28.0",
-    "mailparser": "^3.9.11",
     "@getbrevo/brevo": "^5.0.4",
+    "@kenjiuno/msgreader": "^1.28.0",
     "@langchain/community": "^1.1.28",
     "@langchain/core": "^1.1.48",
     "@langchain/google-vertexai": "^2.1.31",
@@ -78,7 +81,7 @@
     "@langchain/langgraph-checkpoint-redis": "^1.0.7",
     "@langchain/openai": "^1.4.7",
     "@langchain/textsplitters": "^1.0.1",
-    "langsmith": "^0.7.5",
+    "@modelcontextprotocol/sdk": "^1.29.0",
     "@opentelemetry/api": "^1.9.1",
     "@opentelemetry/exporter-trace-otlp-http": "^0.218.0",
     "@opentelemetry/instrumentation-http": "^0.218.0",
@@ -89,13 +92,6 @@
     "@sendgrid/mail": "^8.1.6",
     "@simplewebauthn/server": "^13.3.0",
     "adm-zip": "^0.5.17",
-    "gray-matter": "^4.0.3",
-    "mdast-util-mdx": "^3.0.0",
-    "mdast-util-to-markdown": "^2.1.2",
-    "remark-mdx": "^3.1.1",
-    "remark-parse": "^11.0.0",
-    "unified": "^11.0.5",
-    "uuid": "^14.0.0",
     "ai": "^6.0.5",
     "axios": "^1.16.1",
     "bcrypt": "^6.0.0",
@@ -108,14 +104,19 @@
     "docx-templates": "^4.15.0",
     "fast-xml-parser": "^5.8.0",
     "fastify": "^5.8.5",
+    "gray-matter": "^4.0.3",
     "handlebars": "^4.7.9",
     "ioredis": "^5.10.1",
     "js-yaml": "^4.1.1",
     "jszip": "^3.10.1",
+    "langsmith": "^0.7.5",
     "libreoffice-convert": "^1.8.1",
     "lodash": "^4.18.1",
+    "mailparser": "^3.9.11",
     "marked": "^18.0.4",
     "mathjs": "^15.2.0",
+    "mdast-util-mdx": "^3.0.0",
+    "mdast-util-to-markdown": "^2.1.2",
     "natural": "^8.1.1",
     "necord": "^6.14.0",
     "neo4j-driver": "^6.0.1",
@@ -136,12 +137,16 @@
     "qrcode": "^1.5.4",
     "qs": "^6.15.2",
     "reflect-metadata": "^0.2.2",
+    "remark-mdx": "^3.1.1",
+    "remark-parse": "^11.0.0",
     "rxjs": "^7.8.2",
     "sharp": "^0.34.5",
     "socket.io": "^4.8.3",
     "stripe": "^20.3.1",
     "tslib": "^2.8.1",
     "turndown": "^7.2.4",
+    "unified": "^11.0.5",
+    "uuid": "^14.0.0",
     "web-push": "^3.6.7",
     "xlsx-republish": "^0.20.3",
     "zod": "^4.4.3"
@@ -161,12 +166,12 @@
     "@types/mailparser": "^3.4.6",
     "@types/mdast": "^4.0.4",
     "@types/node": "^25.9.1",
-    "@types/uuid": "^10.0.0",
     "@types/nodemailer": "^8.0.0",
     "@types/passport-jwt": "^4.0.1",
     "@types/qrcode": "^1.5.6",
     "@types/qs": "^6.15.1",
     "@types/turndown": "^5.0.6",
+    "@types/uuid": "^10.0.0",
     "@typescript-eslint/eslint-plugin": "^8.59.4",
     "@typescript-eslint/parser": "^8.59.4",
     "@vitest/coverage-v8": "^4.1.7",