easy-mcp-nest 0.2.1 → 0.4.0

package/dist/adapters/express/http-gateway.service.js

@@ -0,0 +1,102 @@
+"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);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HttpGatewayService = void 0;
+const common_1 = require("@nestjs/common");
+const jsonrpc_interface_1 = require("../../interface/jsonrpc.interface");
+const logger_util_1 = require("../../core/utils/logger.util");
+const sanitize_util_1 = require("../../core/utils/sanitize.util");
+const constants_1 = require("../../config/constants");
+let HttpGatewayService = class HttpGatewayService {
+    mcpServerService;
+    requestContextMap = new Map();
+    constructor() {
+        logger_util_1.logger.info("HttpGatewayService", "HttpGatewayService initialized", {
+            component: "Layer 1: HTTP Interface",
+        });
+    }
+    setMcpServerService(service) {
+        this.mcpServerService = service;
+    }
+    async start() {
+        logger_util_1.logger.info("HttpGatewayService", "HTTP gateway ready (handled by Express)", {
+            component: "Layer 1: HTTP Interface",
+        });
+    }
+    async sendMessage(sessionId, output) {
+        logger_util_1.logger.debug("HttpGatewayService", "sendMessage called", {
+            component: "Layer 1: HTTP Interface",
+            sessionId,
+        });
+    }
+    async handleHttpRequest(req, res, context) {
+        const requestId = req.headers["x-request-id"] || String(Date.now());
+        if (context) {
+            this.requestContextMap.set(String(requestId), context);
+        }
+        try {
+            const contentLength = req.get("content-length");
+            if (contentLength && parseInt(contentLength, 10) > constants_1.MAX_MESSAGE_SIZE_BYTES) {
+                const errorResponse = (0, jsonrpc_interface_1.createJsonRpcError)(null, jsonrpc_interface_1.JsonRpcErrorCode.InvalidRequest, "Request body too large");
+                res.status(413).json(errorResponse);
+                return;
+            }
+            const body = req.body;
+            if (!body || typeof body !== "object") {
+                const errorResponse = (0, jsonrpc_interface_1.createJsonRpcError)(null, jsonrpc_interface_1.JsonRpcErrorCode.InvalidRequest, "Request body must be a valid JSON-RPC request");
+                res.status(400).json(errorResponse);
+                return;
+            }
+            if (!(0, jsonrpc_interface_1.isValidJsonRpcRequest)(body)) {
+                const errorResponse = (0, jsonrpc_interface_1.createJsonRpcError)(body.id || null, jsonrpc_interface_1.JsonRpcErrorCode.InvalidRequest, "Invalid JSON-RPC request structure");
+                res.status(400).json(errorResponse);
+                return;
+            }
+            const request = {
+                ...body,
+                metadata: context ? {
+                    userId: context.userId,
+                    scopes: context.scopes,
+                    buildingIds: context.buildingIds,
+                    sessionId: context.sessionId || String(requestId),
+                    metadata: {
+                        ip: req.ip || req.socket.remoteAddress,
+                        userAgent: req.get("user-agent"),
+                    },
+                } : undefined,
+            };
+            if (!this.mcpServerService) {
+                const errorResponse = (0, jsonrpc_interface_1.createJsonRpcError)(request.id, jsonrpc_interface_1.JsonRpcErrorCode.InternalError, "McpServerService not initialized");
+                res.status(500).json(errorResponse);
+                return;
+            }
+            const response = await this.mcpServerService.handleRequest(request);
+            res.status(200).json(response);
+        }
+        catch (error) {
+            logger_util_1.logger.error("HttpGatewayService", "Error handling HTTP request", {
+                component: "Layer 1: HTTP Interface",
+                error: (0, sanitize_util_1.sanitizeErrorMessage)(error),
+            });
+            const errorResponse = (0, jsonrpc_interface_1.createJsonRpcError)(req.body?.id || null, jsonrpc_interface_1.JsonRpcErrorCode.InternalError, "Internal error during request handling");
+            res.status(500).json(errorResponse);
+        }
+        finally {
+            this.requestContextMap.delete(String(requestId));
+        }
+    }
+};
+exports.HttpGatewayService = HttpGatewayService;
+exports.HttpGatewayService = HttpGatewayService = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [])
+], HttpGatewayService);
+//# sourceMappingURL=http-gateway.service.js.map

package/dist/adapters/express/http-gateway.service.js.map

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

package/dist/adapters/express/index.d.ts

@@ -0,0 +1,3 @@
+export { createMcpExpressRouter } from "./express-adapter";
+export type { CreateMcpExpressRouterOptions, McpAuthMiddleware } from "./types";
+export { HttpGatewayService } from "./http-gateway.service";

package/dist/adapters/express/index.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HttpGatewayService = exports.createMcpExpressRouter = void 0;
+var express_adapter_1 = require("./express-adapter");
+Object.defineProperty(exports, "createMcpExpressRouter", { enumerable: true, get: function () { return express_adapter_1.createMcpExpressRouter; } });
+var http_gateway_service_1 = require("./http-gateway.service");
+Object.defineProperty(exports, "HttpGatewayService", { enumerable: true, get: function () { return http_gateway_service_1.HttpGatewayService; } });
+//# sourceMappingURL=index.js.map

package/dist/adapters/express/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/adapters/express/index.ts"],"names":[],"mappings":";;;AAAA,qDAA2D;AAAlD,yHAAA,sBAAsB,OAAA;AAE/B,+DAA4D;AAAnD,0HAAA,kBAAkB,OAAA"}

package/dist/adapters/express/types.d.ts

@@ -0,0 +1,15 @@
+import { Request, Response, NextFunction } from "express";
+import { OAuthProviderConfig } from "../../auth/oauth/oauth-config.interface";
+export type McpAuthMiddleware = (req: Request, res: Response, next: NextFunction) => void | Promise<void>;
+export interface CreateMcpExpressRouterOptions {
+    tools?: any[];
+    resources?: any[];
+    prompts?: any[];
+    auth?: McpAuthMiddleware;
+    oauth?: OAuthProviderConfig;
+    serverInfo?: {
+        name: string;
+        version: string;
+    };
+    pathPrefix?: string;
+}

package/dist/adapters/express/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/adapters/express/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/adapters/express/types.ts"],"names":[],"mappings":""}

package/dist/app.module.js

@@ -15,6 +15,7 @@ const constants_1 = require("./config/constants");
 const interface_module_1 = require("./interface/interface.module");
 const resource_module_1 = require("./resources/resource.module");
 const prompt_module_1 = require("./prompts/prompt.module");
+const context_provider_service_1 = require("./core/context/context-provider.service");
 let AppModule = class AppModule {
 };
 exports.AppModule = AppModule;
@@ -25,6 +26,7 @@ exports.AppModule = AppModule = __decorate([
             mcp_server_service_1.McpServerService,
             tool_registry_service_1.ToolRegistryService,
             config_holder_service_1.ConfigHolderService,
+            context_provider_service_1.ContextProviderService,
             {
                 provide: constants_1.CONFIG_TOKEN,
                 useExisting: config_holder_service_1.ConfigHolderService,

package/dist/app.module.js.map

@@ -1 +1 @@
-{"version":3,"file":"app.module.js","sourceRoot":"","sources":["../src/app.module.ts"],"names":[],"mappings":";;;;;;;;;AAEA,2CAAwC;AACxC,6EAAwE;AACxE,yFAAoF;AACpF,0EAAqE;AACrE,kDAAkD;AAClD,mEAA+D;AAC/D,iEAA6D;AAC7D,2DAAuD;AAsBhD,IAAM,SAAS,GAAf,MAAM,SAAS;CAAG,CAAA;AAAZ,8BAAS;oBAAT,SAAS;IAhBrB,IAAA,eAAM,EAAC;QACN,OAAO,EAAE,CAAC,kCAAe,EAAE,gCAAc,EAAE,4BAAY,CAAC;QACxD,SAAS,EAAE;YAET,qCAAgB;YAEhB,2CAAmB;YACnB,2CAAmB;YAEnB;gBACE,OAAO,EAAE,wBAAY;gBACrB,WAAW,EAAE,2CAAmB;aACjC;SACF;QACD,OAAO,EAAE,CAAC,qCAAgB,CAAC;KAC5B,CAAC;GACW,SAAS,CAAG"}
+{"version":3,"file":"app.module.js","sourceRoot":"","sources":["../src/app.module.ts"],"names":[],"mappings":";;;;;;;;;AAEA,2CAAwC;AACxC,6EAAwE;AACxE,yFAAoF;AACpF,0EAAqE;AACrE,kDAAkD;AAClD,mEAA+D;AAC/D,iEAA6D;AAC7D,2DAAuD;AACvD,sFAAiF;AAwB1E,IAAM,SAAS,GAAf,MAAM,SAAS;CAAG,CAAA;AAAZ,8BAAS;oBAAT,SAAS;IAlBrB,IAAA,eAAM,EAAC;QACN,OAAO,EAAE,CAAC,kCAAe,EAAE,gCAAc,EAAE,4BAAY,CAAC;QACxD,SAAS,EAAE;YAET,qCAAgB;YAEhB,2CAAmB;YACnB,2CAAmB;YAEnB,iDAAsB;YAEtB;gBACE,OAAO,EAAE,wBAAY;gBACrB,WAAW,EAAE,2CAAmB;aACjC;SACF;QACD,OAAO,EAAE,CAAC,qCAAgB,CAAC;KAC5B,CAAC;GACW,SAAS,CAAG"}

package/dist/auth/oauth/index.d.ts

@@ -0,0 +1,3 @@
+export { OAuthProviderService } from "./oauth-provider.service";
+export { createOAuthMiddleware } from "./oauth-middleware";
+export type { OAuthProviderConfig, OAuthConfig, OAuthTokenValidator, OAuthContextExtractor, } from "./oauth-config.interface";

package/dist/auth/oauth/index.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createOAuthMiddleware = exports.OAuthProviderService = void 0;
+var oauth_provider_service_1 = require("./oauth-provider.service");
+Object.defineProperty(exports, "OAuthProviderService", { enumerable: true, get: function () { return oauth_provider_service_1.OAuthProviderService; } });
+var oauth_middleware_1 = require("./oauth-middleware");
+Object.defineProperty(exports, "createOAuthMiddleware", { enumerable: true, get: function () { return oauth_middleware_1.createOAuthMiddleware; } });
+//# sourceMappingURL=index.js.map

package/dist/auth/oauth/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/auth/oauth/index.ts"],"names":[],"mappings":";;;AAAA,mEAAgE;AAAvD,8HAAA,oBAAoB,OAAA;AAC7B,uDAA2D;AAAlD,yHAAA,qBAAqB,OAAA"}

package/dist/auth/oauth/oauth-config.interface.d.ts

@@ -0,0 +1,12 @@
+import { McpContext } from "../../core/context/mcp-context.interface";
+export type OAuthTokenValidator = (token: string) => Promise<any> | any;
+export type OAuthContextExtractor = (payload: any) => McpContext;
+export interface OAuthProviderConfig {
+    provider: string;
+    validateToken: OAuthTokenValidator;
+    extractContext: OAuthContextExtractor;
+    extractToken?: (req: any) => string | null;
+}
+export interface OAuthConfig {
+    oauth: OAuthProviderConfig;
+}

package/dist/auth/oauth/oauth-config.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=oauth-config.interface.js.map

package/dist/auth/oauth/oauth-config.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"oauth-config.interface.js","sourceRoot":"","sources":["../../../src/auth/oauth/oauth-config.interface.ts"],"names":[],"mappings":""}

package/dist/auth/oauth/oauth-middleware.d.ts

@@ -0,0 +1,3 @@
+import { Request, Response, NextFunction } from "express";
+import { OAuthProviderService } from "./oauth-provider.service";
+export declare function createOAuthMiddleware(oauthProvider: OAuthProviderService): (req: Request, res: Response, next: NextFunction) => Promise<void>;

package/dist/auth/oauth/oauth-middleware.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createOAuthMiddleware = createOAuthMiddleware;
+const logger_util_1 = require("../../core/utils/logger.util");
+const sanitize_util_1 = require("../../core/utils/sanitize.util");
+function createOAuthMiddleware(oauthProvider) {
+    return async (req, res, next) => {
+        const requestId = req.headers["x-request-id"] || req.body?.id || null;
+        const clientIp = req.ip || req.socket.remoteAddress || "unknown";
+        try {
+            const token = oauthProvider.extractTokenFromRequest(req);
+            if (!token) {
+                logger_util_1.logger.audit("OAuthMiddleware", "oauth/authenticate", "failure", {
+                    reason: "No token provided",
+                    clientIp,
+                }, requestId, clientIp);
+                res.status(401).json({
+                    jsonrpc: "2.0",
+                    id: null,
+                    error: {
+                        code: -32000,
+                        message: "Unauthorized: No token provided",
+                    },
+                });
+                return;
+            }
+            const context = await oauthProvider.validateAndExtractContext(token);
+            const actorId = (0, sanitize_util_1.sanitizeActorId)(context.sessionId || context.userId || undefined);
+            logger_util_1.logger.audit("OAuthMiddleware", "oauth/authenticate", "success", {
+                clientIp,
+            }, requestId, actorId);
+            req.mcpContext = context;
+            next();
+        }
+        catch (error) {
+            logger_util_1.logger.error("OAuthMiddleware", "Token validation failed", {
+                error: (0, sanitize_util_1.sanitizeErrorMessage)(error),
+            });
+            logger_util_1.logger.audit("OAuthMiddleware", "oauth/authenticate", "failure", {
+                reason: "Token validation failed",
+                clientIp,
+            }, requestId, clientIp);
+            res.status(401).json({
+                jsonrpc: "2.0",
+                id: null,
+                error: {
+                    code: -32000,
+                    message: "Unauthorized: Invalid token",
+                },
+            });
+        }
+    };
+}
+//# sourceMappingURL=oauth-middleware.js.map

package/dist/auth/oauth/oauth-middleware.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"oauth-middleware.js","sourceRoot":"","sources":["../../../src/auth/oauth/oauth-middleware.ts"],"names":[],"mappings":";;AAkBA,sDAuFC;AAtGD,8DAAsD;AACtD,kEAAuF;AAcvF,SAAgB,qBAAqB,CACnC,aAAmC;IAEnC,OAAO,KAAK,EAAE,GAAY,EAAE,GAAa,EAAE,IAAkB,EAAE,EAAE;QAE/D,MAAM,SAAS,GAAG,GAAG,CAAC,OAAO,CAAC,cAAc,CAAC,IAAI,GAAG,CAAC,IAAI,EAAE,EAAE,IAAI,IAAI,CAAC;QACtE,MAAM,QAAQ,GAAG,GAAG,CAAC,EAAE,IAAI,GAAG,CAAC,MAAM,CAAC,aAAa,IAAI,SAAS,CAAC;QAEjE,IAAI,CAAC;YAEH,MAAM,KAAK,GAAG,aAAa,CAAC,uBAAuB,CAAC,GAAG,CAAC,CAAC;YAEzD,IAAI,CAAC,KAAK,EAAE,CAAC;gBAEX,oBAAM,CAAC,KAAK,CACV,iBAAiB,EACjB,oBAAoB,EACpB,SAAS,EACT;oBACE,MAAM,EAAE,mBAAmB;oBAC3B,QAAQ;iBACT,EACD,SAAS,EACT,QAAQ,CACT,CAAC;gBAEF,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;oBACnB,OAAO,EAAE,KAAK;oBACd,EAAE,EAAE,IAAI;oBACR,KAAK,EAAE;wBACL,IAAI,EAAE,CAAC,KAAK;wBACZ,OAAO,EAAE,iCAAiC;qBAC3C;iBACF,CAAC,CAAC;gBACH,OAAO;YACT,CAAC;YAGD,MAAM,OAAO,GAAG,MAAM,aAAa,CAAC,yBAAyB,CAAC,KAAK,CAAC,CAAC;YAGrE,MAAM,OAAO,GAAG,IAAA,+BAAe,EAAC,OAAO,CAAC,SAAS,IAAI,OAAO,CAAC,MAAM,IAAI,SAAS,CAAC,CAAC;YAGlF,oBAAM,CAAC,KAAK,CACV,iBAAiB,EACjB,oBAAoB,EACpB,SAAS,EACT;gBACE,QAAQ;aACT,EACD,SAAS,EACT,OAAO,CACR,CAAC;YAGD,GAAW,CAAC,UAAU,GAAG,OAAO,CAAC;YAElC,IAAI,EAAE,CAAC;QACT,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,oBAAM,CAAC,KAAK,CAAC,iBAAiB,EAAE,yBAAyB,EAAE;gBACzD,KAAK,EAAE,IAAA,oCAAoB,EAAC,KAAK,CAAC;aACnC,CAAC,CAAC;YAGH,oBAAM,CAAC,KAAK,CACV,iBAAiB,EACjB,oBAAoB,EACpB,SAAS,EACT;gBACE,MAAM,EAAE,yBAAyB;gBACjC,QAAQ;aACT,EACD,SAAS,EACT,QAAQ,CACT,CAAC;YAEF,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;gBACnB,OAAO,EAAE,KAAK;gBACd,EAAE,EAAE,IAAI;gBACR,KAAK,EAAE;oBACL,IAAI,EAAE,CAAC,KAAK;oBACZ,OAAO,EAAE,6BAA6B;iBACvC;aACF,CAAC,CAAC;QACL,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}

package/dist/auth/oauth/oauth-provider.service.d.ts

@@ -0,0 +1,8 @@
+import { OAuthProviderConfig } from "./oauth-config.interface";
+import { McpContext } from "../../core/context/mcp-context.interface";
+export declare class OAuthProviderService {
+    private config;
+    setConfig(config: OAuthProviderConfig): void;
+    validateAndExtractContext(token: string): Promise<McpContext>;
+    extractTokenFromRequest(req: any): string | null;
+}

package/dist/auth/oauth/oauth-provider.service.js

@@ -0,0 +1,63 @@
+"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;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OAuthProviderService = void 0;
+const common_1 = require("@nestjs/common");
+const logger_util_1 = require("../../core/utils/logger.util");
+const sanitize_util_1 = require("../../core/utils/sanitize.util");
+let OAuthProviderService = class OAuthProviderService {
+    config = null;
+    setConfig(config) {
+        this.config = config;
+        logger_util_1.logger.info("OAuthProviderService", `OAuth provider configured: ${config.provider}`, {
+            component: "OAuth",
+        });
+    }
+    async validateAndExtractContext(token) {
+        if (!this.config) {
+            throw new Error("OAuth provider not configured");
+        }
+        try {
+            const payload = await this.config.validateToken(token);
+            const context = this.config.extractContext(payload);
+            logger_util_1.logger.debug("OAuthProviderService", "Token validated and context extracted", {
+                component: "OAuth",
+            });
+            return context;
+        }
+        catch (error) {
+            logger_util_1.logger.error("OAuthProviderService", "Token validation failed", {
+                component: "OAuth",
+                error: (0, sanitize_util_1.sanitizeErrorMessage)(error),
+            });
+            throw error;
+        }
+    }
+    extractTokenFromRequest(req) {
+        if (!this.config) {
+            return null;
+        }
+        if (this.config.extractToken) {
+            return this.config.extractToken(req);
+        }
+        const authHeader = req.get?.("Authorization") || req.headers?.authorization || req.headers?.Authorization;
+        if (!authHeader) {
+            return null;
+        }
+        const parts = String(authHeader).split(" ");
+        if (parts.length === 2 && parts[0] === "Bearer") {
+            return parts[1];
+        }
+        return null;
+    }
+};
+exports.OAuthProviderService = OAuthProviderService;
+exports.OAuthProviderService = OAuthProviderService = __decorate([
+    (0, common_1.Injectable)()
+], OAuthProviderService);
+//# sourceMappingURL=oauth-provider.service.js.map

package/dist/auth/oauth/oauth-provider.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"oauth-provider.service.js","sourceRoot":"","sources":["../../../src/auth/oauth/oauth-provider.service.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAA4C;AAG5C,8DAAsD;AACtD,kEAAsE;AAM/D,IAAM,oBAAoB,GAA1B,MAAM,oBAAoB;IACvB,MAAM,GAA+B,IAAI,CAAC;IAKlD,SAAS,CAAC,MAA2B;QACnC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,oBAAM,CAAC,IAAI,CAAC,sBAAsB,EAAE,8BAA8B,MAAM,CAAC,QAAQ,EAAE,EAAE;YACnF,SAAS,EAAE,OAAO;SACnB,CAAC,CAAC;IACL,CAAC;IAQD,KAAK,CAAC,yBAAyB,CAAC,KAAa;QAC3C,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;QACnD,CAAC;QAED,IAAI,CAAC;YAEH,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;YAGvD,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;YAEpD,oBAAM,CAAC,KAAK,CAAC,sBAAsB,EAAE,uCAAuC,EAAE;gBAC5E,SAAS,EAAE,OAAO;aAEnB,CAAC,CAAC;YAEH,OAAO,OAAO,CAAC;QACjB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,oBAAM,CAAC,KAAK,CAAC,sBAAsB,EAAE,yBAAyB,EAAE;gBAC9D,SAAS,EAAE,OAAO;gBAClB,KAAK,EAAE,IAAA,oCAAoB,EAAC,KAAK,CAAC;aACnC,CAAC,CAAC;YACH,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAKD,uBAAuB,CAAC,GAAQ;QAC9B,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,OAAO,IAAI,CAAC;QACd,CAAC;QAGD,IAAI,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC;YAC7B,OAAO,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;QACvC,CAAC;QAGD,MAAM,UAAU,GAAG,GAAG,CAAC,GAAG,EAAE,CAAC,eAAe,CAAC,IAAI,GAAG,CAAC,OAAO,EAAE,aAAa,IAAI,GAAG,CAAC,OAAO,EAAE,aAAa,CAAC;QAC1G,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,OAAO,IAAI,CAAC;QACd,CAAC;QAGD,MAAM,KAAK,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC5C,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,QAAQ,EAAE,CAAC;YAChD,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAGD,OAAO,IAAI,CAAC;IACd,CAAC;CACF,CAAA;AA1EY,oDAAoB;+BAApB,oBAAoB;IADhC,IAAA,mBAAU,GAAE;GACA,oBAAoB,CA0EhC"}

package/dist/config/mcp-config.interface.d.ts

@@ -1,5 +1,5 @@
 export interface JsonSchema2020_12 {
-    type: "object" | "string" | "number" | "integer" | "boolean" | "array";
+    type?: "object" | "string" | "number" | "integer" | "boolean" | "array" | "null";
     properties?: Record<string, JsonSchema2020_12>;
     items?: JsonSchema2020_12 | JsonSchema2020_12[];
     required?: string[];

package/dist/core/batch/batch-executor.service.d.ts

@@ -0,0 +1,21 @@
+import { ToolRegistryService } from "../../tooling/tool-registry/tool-registry.service";
+import { CancellationToken } from "../../tooling/tool.interface";
+import { McpContext } from "../context/mcp-context.interface";
+import { ProgressCallback } from "../progress/progress-notifier.service";
+export interface BatchToolRequest {
+    tool: string;
+    args: Record<string, any>;
+}
+export interface BatchToolResult {
+    tool: string;
+    success: boolean;
+    result?: any;
+    error?: string;
+}
+export declare class BatchExecutorService {
+    private readonly toolRegistry;
+    private static readonly MAX_BATCH_SIZE;
+    private static readonly MAX_CONCURRENCY;
+    constructor(toolRegistry: ToolRegistryService);
+    executeBatch(requests: BatchToolRequest[], cancellationToken?: CancellationToken, context?: McpContext, progress?: ProgressCallback): Promise<BatchToolResult[]>;
+}

package/dist/core/batch/batch-executor.service.js

@@ -0,0 +1,101 @@
+"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 BatchExecutorService_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BatchExecutorService = void 0;
+const common_1 = require("@nestjs/common");
+const tool_registry_service_1 = require("../../tooling/tool-registry/tool-registry.service");
+const logger_util_1 = require("../utils/logger.util");
+const sanitize_util_1 = require("../utils/sanitize.util");
+let BatchExecutorService = class BatchExecutorService {
+    static { BatchExecutorService_1 = this; }
+    toolRegistry;
+    static MAX_BATCH_SIZE = 100;
+    static MAX_CONCURRENCY = 10;
+    constructor(toolRegistry) {
+        this.toolRegistry = toolRegistry;
+    }
+    async executeBatch(requests, cancellationToken, context, progress) {
+        if (requests.length === 0) {
+            return [];
+        }
+        if (requests.length > BatchExecutorService_1.MAX_BATCH_SIZE) {
+            logger_util_1.logger.warn("BatchExecutorService", `Batch size ${requests.length} exceeds maximum ${BatchExecutorService_1.MAX_BATCH_SIZE}`, {
+                component: "Batch",
+                batchSize: requests.length,
+                maxBatchSize: BatchExecutorService_1.MAX_BATCH_SIZE,
+            });
+            return requests.slice(0, BatchExecutorService_1.MAX_BATCH_SIZE).map((request) => ({
+                tool: request.tool,
+                success: false,
+                error: "Batch size limit exceeded",
+            }));
+        }
+        progress?.({ progress: 0, message: `Executing ${requests.length} tools...` });
+        const results = [];
+        const concurrency = Math.min(BatchExecutorService_1.MAX_CONCURRENCY, requests.length);
+        for (let i = 0; i < requests.length; i += concurrency) {
+            const batch = requests.slice(i, i + concurrency);
+            const batchPromises = batch.map(async (request, batchIndex) => {
+                const index = i + batchIndex;
+                if (cancellationToken?.isCancelled) {
+                    return {
+                        tool: request.tool,
+                        success: false,
+                        error: "Batch cancelled",
+                    };
+                }
+                try {
+                    const result = await this.toolRegistry.executeTool(request.tool, request.args, cancellationToken, context, progress
+                        ? (p) => {
+                            const baseProgress = index / requests.length;
+                            const toolProgress = p.progress / requests.length;
+                            progress({
+                                progress: baseProgress + toolProgress,
+                                message: p.message || `Executing ${request.tool}...`,
+                            });
+                        }
+                        : undefined);
+                    return {
+                        tool: request.tool,
+                        success: true,
+                        result,
+                    };
+                }
+                catch (error) {
+                    const sanitizedError = (0, sanitize_util_1.sanitizeErrorMessage)(error);
+                    logger_util_1.logger.error("BatchExecutorService", `Batch tool execution failed: ${request.tool}`, {
+                        component: "Batch",
+                        tool: request.tool,
+                        error: sanitizedError,
+                    });
+                    return {
+                        tool: request.tool,
+                        success: false,
+                        error: "Tool execution failed",
+                    };
+                }
+            });
+            const batchResults = await Promise.all(batchPromises);
+            results.push(...batchResults);
+            const currentProgress = Math.min((i + batch.length) / requests.length, 1);
+            progress?.({ progress: currentProgress, message: `Executing ${requests.length} tools...` });
+        }
+        progress?.({ progress: 1, message: `Completed ${requests.length} tools` });
+        return results;
+    }
+};
+exports.BatchExecutorService = BatchExecutorService;
+exports.BatchExecutorService = BatchExecutorService = BatchExecutorService_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [tool_registry_service_1.ToolRegistryService])
+], BatchExecutorService);
+//# sourceMappingURL=batch-executor.service.js.map

package/dist/core/batch/batch-executor.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch-executor.service.js","sourceRoot":"","sources":["../../../src/core/batch/batch-executor.service.ts"],"names":[],"mappings":";;;;;;;;;;;;;AAAA,2CAA4C;AAC5C,6FAAwF;AAIxF,sDAA8C;AAC9C,0DAA8D;AAwBvD,IAAM,oBAAoB,GAA1B,MAAM,oBAAoB;;IAMF;IAJrB,MAAM,CAAU,cAAc,GAAG,GAAG,CAAC;IAErC,MAAM,CAAU,eAAe,GAAG,EAAE,CAAC;IAE7C,YAA6B,YAAiC;QAAjC,iBAAY,GAAZ,YAAY,CAAqB;IAAG,CAAC;IAKlE,KAAK,CAAC,YAAY,CAChB,QAA4B,EAC5B,iBAAqC,EACrC,OAAoB,EACpB,QAA2B;QAE3B,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1B,OAAO,EAAE,CAAC;QACZ,CAAC;QAGD,IAAI,QAAQ,CAAC,MAAM,GAAG,sBAAoB,CAAC,cAAc,EAAE,CAAC;YAC1D,oBAAM,CAAC,IAAI,CAAC,sBAAsB,EAAE,cAAc,QAAQ,CAAC,MAAM,oBAAoB,sBAAoB,CAAC,cAAc,EAAE,EAAE;gBAC1H,SAAS,EAAE,OAAO;gBAClB,SAAS,EAAE,QAAQ,CAAC,MAAM;gBAC1B,YAAY,EAAE,sBAAoB,CAAC,cAAc;aAClD,CAAC,CAAC;YACH,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,sBAAoB,CAAC,cAAc,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;gBAC9E,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,2BAA2B;aACnC,CAAC,CAAC,CAAC;QACN,CAAC;QAGD,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,OAAO,EAAE,aAAa,QAAQ,CAAC,MAAM,WAAW,EAAE,CAAC,CAAC;QAG9E,MAAM,OAAO,GAAsB,EAAE,CAAC;QACtC,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,sBAAoB,CAAC,eAAe,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;QAEpF,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,WAAW,EAAE,CAAC;YACtD,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,WAAW,CAAC,CAAC;YACjD,MAAM,aAAa,GAAG,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,EAAE;gBAC5D,MAAM,KAAK,GAAG,CAAC,GAAG,UAAU,CAAC;gBAE7B,IAAI,iBAAiB,EAAE,WAAW,EAAE,CAAC;oBACnC,OAAO;wBACL,IAAI,EAAE,OAAO,CAAC,IAAI;wBAClB,OAAO,EAAE,KAAK;wBACd,KAAK,EAAE,iBAAiB;qBACN,CAAC;gBACvB,CAAC;gBACD,IAAI,CAAC;oBACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,WAAW,CAChD,OAAO,CAAC,IAAI,EACZ,OAAO,CAAC,IAAI,EACZ,iBAAiB,EACjB,OAAO,EACP,QAAQ;wBACN,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE;4BAEJ,MAAM,YAAY,GAAG,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC;4BAC7C,MAAM,YAAY,GAAG,CAAC,CAAC,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC;4BAClD,QAAQ,CAAC;gCACP,QAAQ,EAAE,YAAY,GAAG,YAAY;gCACrC,OAAO,EAAE,CAAC,CAAC,OAAO,IAAI,aAAa,OAAO,CAAC,IAAI,KAAK;6BACrD,CAAC,CAAC;wBACL,CAAC;wBACH,CAAC,CAAC,SAAS,CACd,CAAC;oBAEF,OAAO;wBACL,IAAI,EAAE,OAAO,CAAC,IAAI;wBAClB,OAAO,EAAE,IAAI;wBACb,MAAM;qBACY,CAAC;gBACvB,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBAEf,MAAM,cAAc,GAAG,IAAA,oCAAoB,EAAC,KAAK,CAAC,CAAC;oBACnD,oBAAM,CAAC,KAAK,CAAC,sBAAsB,EAAE,gCAAgC,OAAO,CAAC,IAAI,EAAE,EAAE;wBACnF,SAAS,EAAE,OAAO;wBAClB,IAAI,EAAE,OAAO,CAAC,IAAI;wBAClB,KAAK,EAAE,cAAc;qBACtB,CAAC,CAAC;oBAGH,OAAO;wBACL,IAAI,EAAE,OAAO,CAAC,IAAI;wBAClB,OAAO,EAAE,KAAK;wBACd,KAAK,EAAE,uBAAuB;qBACZ,CAAC;gBACvB,CAAC;YACH,CAAC,CAAC,CAAC;YAEH,MAAM,YAAY,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;YACtD,OAAO,CAAC,IAAI,CAAC,GAAG,YAAY,CAAC,CAAC;YAG9B,MAAM,eAAe,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;YAC1E,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,eAAe,EAAE,OAAO,EAAE,aAAa,QAAQ,CAAC,MAAM,WAAW,EAAE,CAAC,CAAC;QAC9F,CAAC;QAGD,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,OAAO,EAAE,aAAa,QAAQ,CAAC,MAAM,QAAQ,EAAE,CAAC,CAAC;QAE3E,OAAO,OAAO,CAAC;IACjB,CAAC;;AA5GU,oDAAoB;+BAApB,oBAAoB;IADhC,IAAA,mBAAU,GAAE;qCAOgC,2CAAmB;GANnD,oBAAoB,CA6GhC"}

package/dist/core/context/context-provider.service.d.ts

@@ -0,0 +1,8 @@
+import { McpContext } from "./mcp-context.interface";
+import { JsonRpcRequest } from "../../interface/jsonrpc.interface";
+export declare class ContextProviderService {
+    private contextExtractors;
+    registerExtractor(extractor: (request: JsonRpcRequest) => Partial<McpContext>): void;
+    extractContext(request: JsonRpcRequest): McpContext;
+    createDefaultExtractor(): (request: JsonRpcRequest) => Partial<McpContext>;
+}

package/dist/core/context/context-provider.service.js

@@ -0,0 +1,55 @@
+"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;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ContextProviderService = void 0;
+const common_1 = require("@nestjs/common");
+let ContextProviderService = class ContextProviderService {
+    contextExtractors = [];
+    registerExtractor(extractor) {
+        this.contextExtractors.push(extractor);
+    }
+    extractContext(request) {
+        let context = {};
+        for (const extractor of this.contextExtractors) {
+            const partialContext = extractor(request);
+            context = { ...context, ...partialContext };
+        }
+        if (!context.sessionId && request.id !== null && request.id !== undefined) {
+            context.sessionId = String(request.id);
+        }
+        return context;
+    }
+    createDefaultExtractor() {
+        return (request) => {
+            const context = {};
+            if (request.metadata) {
+                if (request.metadata.userId) {
+                    context.userId = request.metadata.userId;
+                }
+                if (request.metadata.scopes) {
+                    context.scopes = request.metadata.scopes;
+                }
+                if (request.metadata.buildingIds) {
+                    context.buildingIds = request.metadata.buildingIds;
+                }
+                if (request.metadata.sessionId) {
+                    context.sessionId = request.metadata.sessionId;
+                }
+                if (request.metadata.metadata) {
+                    context.metadata = request.metadata.metadata;
+                }
+            }
+            return context;
+        };
+    }
+};
+exports.ContextProviderService = ContextProviderService;
+exports.ContextProviderService = ContextProviderService = __decorate([
+    (0, common_1.Injectable)()
+], ContextProviderService);
+//# sourceMappingURL=context-provider.service.js.map

package/dist/core/context/context-provider.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-provider.service.js","sourceRoot":"","sources":["../../../src/core/context/context-provider.service.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAA4C;AASrC,IAAM,sBAAsB,GAA5B,MAAM,sBAAsB;IACzB,iBAAiB,GAA4D,EAAE,CAAC;IAMxF,iBAAiB,CAAC,SAA2D;QAC3E,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACzC,CAAC;IAMD,cAAc,CAAC,OAAuB;QACpC,IAAI,OAAO,GAAe,EAAE,CAAC;QAG7B,KAAK,MAAM,SAAS,IAAI,IAAI,CAAC,iBAAiB,EAAE,CAAC;YAC/C,MAAM,cAAc,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;YAC1C,OAAO,GAAG,EAAE,GAAG,OAAO,EAAE,GAAG,cAAc,EAAE,CAAC;QAC9C,CAAC;QAGD,IAAI,CAAC,OAAO,CAAC,SAAS,IAAI,OAAO,CAAC,EAAE,KAAK,IAAI,IAAI,OAAO,CAAC,EAAE,KAAK,SAAS,EAAE,CAAC;YAC1E,OAAO,CAAC,SAAS,GAAG,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QACzC,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAKD,sBAAsB;QACpB,OAAO,CAAC,OAAuB,EAAE,EAAE;YACjC,MAAM,OAAO,GAAwB,EAAE,CAAC;YAGxC,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;gBACrB,IAAI,OAAO,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;oBAC5B,OAAO,CAAC,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;gBAC3C,CAAC;gBACD,IAAI,OAAO,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;oBAC5B,OAAO,CAAC,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;gBAC3C,CAAC;gBACD,IAAI,OAAO,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;oBACjC,OAAO,CAAC,WAAW,GAAG,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC;gBACrD,CAAC;gBACD,IAAI,OAAO,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC;oBAC/B,OAAO,CAAC,SAAS,GAAG,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC;gBACjD,CAAC;gBACD,IAAI,OAAO,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC;oBAC9B,OAAO,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC;gBAC/C,CAAC;YACH,CAAC;YAED,OAAO,OAAO,CAAC;QACjB,CAAC,CAAC;IACJ,CAAC;CACF,CAAA;AA7DY,wDAAsB;iCAAtB,sBAAsB;IADlC,IAAA,mBAAU,GAAE;GACA,sBAAsB,CA6DlC"}

package/dist/core/context/mcp-context.interface.d.ts

@@ -0,0 +1,12 @@
+export interface McpContext {
+    userId?: string;
+    scopes?: string[];
+    buildingIds?: string[];
+    sessionId?: string;
+    metadata?: {
+        ip?: string;
+        userAgent?: string;
+        [key: string]: any;
+    };
+    [key: string]: any;
+}

package/dist/core/context/mcp-context.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=mcp-context.interface.js.map

package/dist/core/context/mcp-context.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-context.interface.js","sourceRoot":"","sources":["../../../src/core/context/mcp-context.interface.ts"],"names":[],"mappings":""}

package/dist/core/documentation/openapi-generator.service.d.ts

@@ -0,0 +1,13 @@
+import { ToolRegistryService } from "../../tooling/tool-registry/tool-registry.service";
+export declare class OpenApiGeneratorService {
+    private readonly toolRegistry;
+    constructor(toolRegistry: ToolRegistryService);
+    generateOpenApiSpec(info: {
+        title: string;
+        version: string;
+    }): any;
+    generateMarkdownDocs(info: {
+        title: string;
+        version: string;
+    }): string;
+}