@rekog/mcp-nest 1.9.10 → 2.0.0-alpha.0

package/dist/mcp/services/sse-ping.service.js

@@ -1,99 +0,0 @@
-"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); }
-};
-var SsePingService_1;
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.SsePingService = void 0;
-const common_1 = require("@nestjs/common");
-const mcp_logger_factory_1 = require("../utils/mcp-logger.factory");
-let SsePingService = SsePingService_1 = class SsePingService {
-    constructor(options) {
-        this.pingInterval = null;
-        this.activeConnections = new Map();
-        this.pingIntervalMs = 30000;
-        this.logger = (0, mcp_logger_factory_1.createMcpLogger)(SsePingService_1.name, options);
-    }
-    onModuleInit() {
-        this.logger.log('Initializing SSE ping service');
-    }
-    onModuleDestroy() {
-        this.stopPingInterval();
-        this.logger.log('SSE ping service stopped');
-    }
-    configure(options) {
-        if (options.pingIntervalMs !== undefined) {
-            this.pingIntervalMs = options.pingIntervalMs;
-        }
-        if (options.pingEnabled !== false) {
-            this.startPingInterval();
-        }
-        else {
-            this.stopPingInterval();
-        }
-    }
-    registerConnection(sessionId, transport, res) {
-        this.activeConnections.set(sessionId, { transport, res });
-        this.logger.debug(`SSE connection registered: ${sessionId}`);
-    }
-    removeConnection(sessionId) {
-        this.activeConnections.delete(sessionId);
-        this.logger.debug(`SSE connection removed: ${sessionId}`);
-    }
-    startPingInterval() {
-        if (this.pingInterval) {
-            this.stopPingInterval();
-        }
-        this.logger.log(`Starting SSE ping service (interval: ${this.pingIntervalMs}ms)`);
-        this.pingInterval = setInterval(() => {
-            this.sendPingToAllConnections();
-        }, this.pingIntervalMs);
-    }
-    stopPingInterval() {
-        if (this.pingInterval) {
-            clearInterval(this.pingInterval);
-            this.pingInterval = null;
-            this.logger.log('SSE ping interval stopped');
-        }
-    }
-    sendPingToAllConnections() {
-        const timestamp = Date.now();
-        const connectionCount = this.activeConnections.size;
-        if (connectionCount === 0) {
-            return;
-        }
-        this.logger.debug(`Sending SSE ping to ${connectionCount} connections`);
-        for (const [sessionId, { res }] of this.activeConnections.entries()) {
-            try {
-                if (!res.closed && res.writable) {
-                    res.write(`: ping - ${new Date(timestamp).toISOString()}\n\n`);
-                }
-                else {
-                    this.logger.debug(`Connection ${sessionId} is no longer writable, removing`);
-                    this.removeConnection(sessionId);
-                }
-            }
-            catch (error) {
-                this.logger.error(`Error sending ping to connection ${sessionId}`, error);
-                this.removeConnection(sessionId);
-            }
-        }
-    }
-};
-exports.SsePingService = SsePingService;
-exports.SsePingService = SsePingService = SsePingService_1 = __decorate([
-    (0, common_1.Injectable)(),
-    __param(0, (0, common_1.Optional)()),
-    __param(0, (0, common_1.Inject)('MCP_OPTIONS')),
-    __metadata("design:paramtypes", [Object])
-], SsePingService);
-//# sourceMappingURL=sse-ping.service.js.map

package/dist/mcp/services/sse-ping.service.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"sse-ping.service.js","sourceRoot":"","sources":["../../../src/mcp/services/sse-ping.service.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  Injectable,\n  OnModuleInit,\n  OnModuleDestroy,\n  Logger,\n  Inject,\n  Optional,\n} from '@nestjs/common';\nimport { SSEServerTransport } from '@modelcontextprotocol/sdk/server/sse.js';\nimport { HttpResponse } from '../interfaces/http-adapter.interface';\nimport type { McpOptions } from '../interfaces';\nimport { createMcpLogger } from '../utils/mcp-logger.factory';\n\n/**\n * Service that implements automatic ping for SSE connections\n * This prevents browser/client timeouts for long-lived connections\n */\n@Injectable()\nexport class SsePingService implements OnModuleInit, OnModuleDestroy {\n  private pingInterval: NodeJS.Timeout | null = null;\n  private readonly logger: Logger;\n  private readonly activeConnections = new Map<\n    string,\n    {\n      transport: SSEServerTransport;\n      res: HttpResponse;\n    }\n  >();\n\n  // Default to 30 seconds - this is a reasonable interval for most clients\n  private pingIntervalMs = 30000;\n\n  constructor(@Optional() @Inject('MCP_OPTIONS') options?: McpOptions) {\n    this.logger = createMcpLogger(SsePingService.name, options);\n  }\n\n  onModuleInit() {\n    this.logger.log('Initializing SSE ping service');\n  }\n\n  onModuleDestroy() {\n    this.stopPingInterval();\n    this.logger.log('SSE ping service stopped');\n  }\n\n  /**\n   * Configure the ping service\n   */\n  configure(options: { pingEnabled?: boolean; pingIntervalMs?: number }) {\n    if (options.pingIntervalMs !== undefined) {\n      this.pingIntervalMs = options.pingIntervalMs;\n    }\n\n    if (options.pingEnabled !== false) {\n      this.startPingInterval();\n    } else {\n      this.stopPingInterval();\n    }\n  }\n\n  /**\n   * Register a new SSE connection to receive pings\n   */\n  registerConnection(\n    sessionId: string,\n    transport: SSEServerTransport,\n    res: HttpResponse,\n  ) {\n    this.activeConnections.set(sessionId, { transport, res });\n    this.logger.debug(`SSE connection registered: ${sessionId}`);\n  }\n\n  /**\n   * Remove an SSE connection\n   */\n  removeConnection(sessionId: string) {\n    this.activeConnections.delete(sessionId);\n    this.logger.debug(`SSE connection removed: ${sessionId}`);\n  }\n\n  /**\n   * Start the ping interval timer\n   */\n  private startPingInterval() {\n    if (this.pingInterval) {\n      this.stopPingInterval();\n    }\n\n    this.logger.log(\n      `Starting SSE ping service (interval: ${this.pingIntervalMs}ms)`,\n    );\n    this.pingInterval = setInterval(() => {\n      this.sendPingToAllConnections();\n    }, this.pingIntervalMs);\n  }\n\n  /**\n   * Stop the ping interval timer\n   */\n  private stopPingInterval() {\n    if (this.pingInterval) {\n      clearInterval(this.pingInterval);\n      this.pingInterval = null;\n      this.logger.log('SSE ping interval stopped');\n    }\n  }\n\n  /**\n   * Send a ping to all active connections\n   */\n  private sendPingToAllConnections() {\n    const timestamp = Date.now();\n    const connectionCount = this.activeConnections.size;\n\n    if (connectionCount === 0) {\n      return;\n    }\n\n    this.logger.debug(`Sending SSE ping to ${connectionCount} connections`);\n\n    for (const [sessionId, { res }] of this.activeConnections.entries()) {\n      try {\n        // Send a comment-type SSE message (line starting with ':')\n        // This keeps the connection alive without triggering an event in the client\n        if (!res.closed && res.writable) {\n          res.write(`: ping - ${new Date(timestamp).toISOString()}\\n\\n`);\n        } else {\n          this.logger.debug(\n            `Connection ${sessionId} is no longer writable, removing`,\n          );\n          // TODO: After non writable connections are discovered it'd be useful to cleanup transports/mcp servers\n          // for that connection in  sse.controller.factory.ts\n          this.removeConnection(sessionId);\n        }\n      } catch (error) {\n        this.logger.error(\n          `Error sending ping to connection ${sessionId}`,\n          error,\n        );\n        this.removeConnection(sessionId);\n      }\n    }\n  }\n}\n"]}

package/dist/mcp/transport/sse.controller.factory.d.ts

@@ -1,14 +0,0 @@
-import { CanActivate, Logger, Type } from '@nestjs/common';
-import type { McpOptions } from '../interfaces';
-import { McpSseService } from '../services/mcp-sse.service';
-export declare function createSseController(sseEndpoint: string, messagesEndpoint: string, apiPrefix: string, guards?: Type<CanActivate>[], decorators?: ClassDecorator[], options?: McpOptions): {
-    new (mcpOptions: McpOptions, mcpSseService: McpSseService): {
-        readonly logger: Logger;
-        readonly mcpOptions: McpOptions;
-        readonly mcpSseService: McpSseService;
-        onModuleInit(): void;
-        sse(rawReq: any, rawRes: any): Promise<void>;
-        messages(rawReq: any, rawRes: any, body: unknown): Promise<void>;
-    };
-};
-//# sourceMappingURL=sse.controller.factory.d.ts.map

package/dist/mcp/transport/sse.controller.factory.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"sse.controller.factory.d.ts","sourceRoot":"","sources":["../../../src/mcp/transport/sse.controller.factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,WAAW,EAIX,MAAM,EAKN,IAAI,EAIL,MAAM,gBAAgB,CAAC;AAExB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAO5D,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,MAAM,EACnB,gBAAgB,EAAE,MAAM,EACxB,SAAS,EAAE,MAAM,EACjB,MAAM,GAAE,IAAI,CAAC,WAAW,CAAC,EAAO,EAChC,UAAU,GAAE,cAAc,EAAO,EACjC,OAAO,CAAC,EAAE,UAAU;qBAUmC,UAAU,iBAC9B,aAAa;yBAJ7B,MAAM;6BAG8B,UAAU;gCAC9B,aAAa;;oBAiBrB,GAAG,UAAiB,GAAG;yBAe/B,GAAG,UACH,GAAG,QACJ,OAAO,GACpB,OAAO,CAAC,IAAI,CAAC;;EAMnB"}

package/dist/mcp/transport/sse.controller.factory.js

@@ -1,67 +0,0 @@
-"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.createSseController = createSseController;
-const common_1 = require("@nestjs/common");
-const mcp_sse_service_1 = require("../services/mcp-sse.service");
-const normalize_endpoint_1 = require("../utils/normalize-endpoint");
-const mcp_logger_factory_1 = require("../utils/mcp-logger.factory");
-function createSseController(sseEndpoint, messagesEndpoint, apiPrefix, guards = [], decorators = [], options) {
-    var SseController_1;
-    let SseController = SseController_1 = class SseController {
-        constructor(mcpOptions, mcpSseService) {
-            this.mcpOptions = mcpOptions;
-            this.mcpSseService = mcpSseService;
-            this.logger = (0, mcp_logger_factory_1.createMcpLogger)(SseController_1.name, options || mcpOptions);
-        }
-        onModuleInit() {
-            this.mcpSseService.initialize();
-        }
-        async sse(rawReq, rawRes) {
-            return this.mcpSseService.createSseConnection(rawReq, rawRes, messagesEndpoint, apiPrefix);
-        }
-        async messages(rawReq, rawRes, body) {
-            await this.mcpSseService.handleMessage(rawReq, rawRes, body);
-        }
-    };
-    __decorate([
-        (0, common_1.Get)((0, normalize_endpoint_1.normalizeEndpoint)(`${apiPrefix}/${sseEndpoint}`)),
-        (0, common_1.UseGuards)(...guards),
-        __param(0, (0, common_1.Req)()),
-        __param(1, (0, common_1.Res)()),
-        __metadata("design:type", Function),
-        __metadata("design:paramtypes", [Object, Object]),
-        __metadata("design:returntype", Promise)
-    ], SseController.prototype, "sse", null);
-    __decorate([
-        (0, common_1.Post)((0, normalize_endpoint_1.normalizeEndpoint)(`${apiPrefix}/${messagesEndpoint}`)),
-        (0, common_1.UseGuards)(...guards),
-        __param(0, (0, common_1.Req)()),
-        __param(1, (0, common_1.Res)()),
-        __param(2, (0, common_1.Body)()),
-        __metadata("design:type", Function),
-        __metadata("design:paramtypes", [Object, Object, Object]),
-        __metadata("design:returntype", Promise)
-    ], SseController.prototype, "messages", null);
-    SseController = SseController_1 = __decorate([
-        (0, common_1.Controller)({
-            version: common_1.VERSION_NEUTRAL,
-        }),
-        (0, common_1.applyDecorators)(...decorators),
-        __param(0, (0, common_1.Inject)('MCP_OPTIONS')),
-        __metadata("design:paramtypes", [Object, mcp_sse_service_1.McpSseService])
-    ], SseController);
-    return SseController;
-}
-//# sourceMappingURL=sse.controller.factory.js.map

package/dist/mcp/transport/sse.controller.factory.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"sse.controller.factory.js","sourceRoot":"","sources":["../../../src/mcp/transport/sse.controller.factory.ts"],"names":[],"mappings":";;;;;;;;;;;;;;AAyBA,kDA0DC;AAnFD,2CAewB;AAGxB,iEAA4D;AAC5D,oEAAgE;AAChE,oEAA8D;AAK9D,SAAgB,mBAAmB,CACjC,WAAmB,EACnB,gBAAwB,EACxB,SAAiB,EACjB,SAA8B,EAAE,EAChC,aAA+B,EAAE,EACjC,OAAoB;;IAEpB,IAIM,aAAa,qBAJnB,MAIM,aAAa;QAGjB,YACyC,UAAsB,EAC7C,aAA4B;YADL,eAAU,GAAV,UAAU,CAAY;YAC7C,kBAAa,GAAb,aAAa,CAAe;YAE5C,IAAI,CAAC,MAAM,GAAG,IAAA,oCAAe,EAAC,eAAa,CAAC,IAAI,EAAE,OAAO,IAAI,UAAU,CAAC,CAAC;QAC3E,CAAC;QAKD,YAAY;YACV,IAAI,CAAC,aAAa,CAAC,UAAU,EAAE,CAAC;QAClC,CAAC;QAOK,AAAN,KAAK,CAAC,GAAG,CAAQ,MAAW,EAAS,MAAW;YAC9C,OAAO,IAAI,CAAC,aAAa,CAAC,mBAAmB,CAC3C,MAAM,EACN,MAAM,EACN,gBAAgB,EAChB,SAAS,CACV,CAAC;QACJ,CAAC;QAOK,AAAN,KAAK,CAAC,QAAQ,CACL,MAAW,EACX,MAAW,EACV,IAAa;YAErB,MAAM,IAAI,CAAC,aAAa,CAAC,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;QAC/D,CAAC;KACF,CAAA;IArBO;QAFL,IAAA,YAAG,EAAC,IAAA,sCAAiB,EAAC,GAAG,SAAS,IAAI,WAAW,EAAE,CAAC,CAAC;QACrD,IAAA,kBAAS,EAAC,GAAG,MAAM,CAAC;QACV,WAAA,IAAA,YAAG,GAAE,CAAA;QAAe,WAAA,IAAA,YAAG,GAAE,CAAA;;;;4CAOnC;IAOK;QAFL,IAAA,aAAI,EAAC,IAAA,sCAAiB,EAAC,GAAG,SAAS,IAAI,gBAAgB,EAAE,CAAC,CAAC;QAC3D,IAAA,kBAAS,EAAC,GAAG,MAAM,CAAC;QAElB,WAAA,IAAA,YAAG,GAAE,CAAA;QACL,WAAA,IAAA,YAAG,GAAE,CAAA;QACL,WAAA,IAAA,aAAI,GAAE,CAAA;;;;iDAGR;IA1CG,aAAa;QAJlB,IAAA,mBAAU,EAAC;YACV,OAAO,EAAE,wBAAe;SACzB,CAAC;QACD,IAAA,wBAAe,EAAC,GAAG,UAAU,CAAC;QAK1B,WAAA,IAAA,eAAM,EAAC,aAAa,CAAC,CAAA;iDACS,+BAAa;OAL1C,aAAa,CA2ClB;IAED,OAAO,aAAa,CAAC;AACvB,CAAC","sourcesContent":["import {\n  Body,\n  CanActivate,\n  Controller,\n  Get,\n  Inject,\n  Logger,\n  OnModuleInit,\n  Post,\n  Req,\n  Res,\n  Type,\n  UseGuards,\n  VERSION_NEUTRAL,\n  applyDecorators,\n} from '@nestjs/common';\n\nimport type { McpOptions } from '../interfaces';\nimport { McpSseService } from '../services/mcp-sse.service';\nimport { normalizeEndpoint } from '../utils/normalize-endpoint';\nimport { createMcpLogger } from '../utils/mcp-logger.factory';\n\n/**\n * Creates a controller for handling SSE connections and tool executions\n */\nexport function createSseController(\n  sseEndpoint: string,\n  messagesEndpoint: string,\n  apiPrefix: string,\n  guards: Type<CanActivate>[] = [],\n  decorators: ClassDecorator[] = [],\n  options?: McpOptions,\n) {\n  @Controller({\n    version: VERSION_NEUTRAL,\n  })\n  @applyDecorators(...decorators)\n  class SseController implements OnModuleInit {\n    readonly logger: Logger;\n\n    constructor(\n      @Inject('MCP_OPTIONS') public readonly mcpOptions: McpOptions,\n      public readonly mcpSseService: McpSseService,\n    ) {\n      this.logger = createMcpLogger(SseController.name, options || mcpOptions);\n    }\n\n    /**\n     * Initialize the controller and configure SSE service\n     */\n    onModuleInit() {\n      this.mcpSseService.initialize();\n    }\n\n    /**\n     * SSE connection endpoint\n     */\n    @Get(normalizeEndpoint(`${apiPrefix}/${sseEndpoint}`))\n    @UseGuards(...guards)\n    async sse(@Req() rawReq: any, @Res() rawRes: any) {\n      return this.mcpSseService.createSseConnection(\n        rawReq,\n        rawRes,\n        messagesEndpoint,\n        apiPrefix,\n      );\n    }\n\n    /**\n     * Tool execution endpoint - protected by the provided guards\n     */\n    @Post(normalizeEndpoint(`${apiPrefix}/${messagesEndpoint}`))\n    @UseGuards(...guards)\n    async messages(\n      @Req() rawReq: any,\n      @Res() rawRes: any,\n      @Body() body: unknown,\n    ): Promise<void> {\n      await this.mcpSseService.handleMessage(rawReq, rawRes, body);\n    }\n  }\n\n  return SseController;\n}\n"]}

package/dist/mcp/transport/stdio.service.d.ts

@@ -1,14 +0,0 @@
-import { OnApplicationBootstrap } from '@nestjs/common';
-import { ModuleRef } from '@nestjs/core';
-import type { McpOptions } from '../interfaces';
-import { McpRegistryDiscoveryService } from '../services/mcp-registry-discovery.service';
-export declare class StdioService implements OnApplicationBootstrap {
-    private readonly options;
-    private readonly mcpModuleId;
-    private readonly moduleRef;
-    private readonly toolRegistry;
-    private readonly logger;
-    constructor(options: McpOptions, mcpModuleId: string, moduleRef: ModuleRef, toolRegistry: McpRegistryDiscoveryService);
-    onApplicationBootstrap(): Promise<void>;
-}
-//# sourceMappingURL=stdio.service.d.ts.map

package/dist/mcp/transport/stdio.service.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"stdio.service.d.ts","sourceRoot":"","sources":["../../../src/mcp/transport/stdio.service.ts"],"names":[],"mappings":"AACA,OAAO,EAIL,sBAAsB,EACvB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAoB,SAAS,EAAE,MAAM,cAAc,CAAC;AAE3D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEhD,OAAO,EAAE,2BAA2B,EAAE,MAAM,4CAA4C,CAAC;AAIzF,qBACa,YAAa,YAAW,sBAAsB;IAIhC,OAAO,CAAC,QAAQ,CAAC,OAAO;IACtB,OAAO,CAAC,QAAQ,CAAC,WAAW;IACrD,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,YAAY;IAN/B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAGU,OAAO,EAAE,UAAU,EACjB,WAAW,EAAE,MAAM,EAC5C,SAAS,EAAE,SAAS,EACpB,YAAY,EAAE,2BAA2B;IAKtD,sBAAsB;CA8C7B"}

package/dist/mcp/transport/stdio.service.js

@@ -1,66 +0,0 @@
-"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); }
-};
-var StdioService_1;
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.StdioService = void 0;
-const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
-const common_1 = require("@nestjs/common");
-const core_1 = require("@nestjs/core");
-const interfaces_1 = require("../interfaces");
-const mcp_executor_service_1 = require("../services/mcp-executor.service");
-const mcp_registry_discovery_service_1 = require("../services/mcp-registry-discovery.service");
-const mcp_logger_factory_1 = require("../utils/mcp-logger.factory");
-const mcp_server_factory_1 = require("../utils/mcp-server.factory");
-let StdioService = StdioService_1 = class StdioService {
-    constructor(options, mcpModuleId, moduleRef, toolRegistry) {
-        this.options = options;
-        this.mcpModuleId = mcpModuleId;
-        this.moduleRef = moduleRef;
-        this.toolRegistry = toolRegistry;
-        this.logger = (0, mcp_logger_factory_1.createMcpLogger)(StdioService_1.name, this.options);
-    }
-    async onApplicationBootstrap() {
-        const transports = Array.isArray(this.options.transport)
-            ? this.options.transport
-            : [this.options.transport];
-        if (!transports.includes(interfaces_1.McpTransportType.STDIO))
-            return;
-        this.logger.log('Bootstrapping MCP STDIO...');
-        const toolsWithGuards = this.toolRegistry
-            .getTools(this.mcpModuleId)
-            .filter((tool) => tool.metadata.guards && tool.metadata.guards.length > 0);
-        if (toolsWithGuards.length > 0) {
-            const toolNames = toolsWithGuards.map((t) => t.metadata.name).join(', ');
-            this.logger.warn(`@ToolGuards() are not supported with STDIO transport. ` +
-                `The following tools have guards configured and will be hidden: ${toolNames}. ` +
-                `Consider using HTTP transport.`);
-        }
-        const mcpServer = (0, mcp_server_factory_1.createMcpServer)(this.mcpModuleId, this.toolRegistry, this.options, this.logger);
-        const contextId = core_1.ContextIdFactory.create();
-        const executor = await this.moduleRef.resolve(mcp_executor_service_1.McpExecutorService, contextId, { strict: false });
-        executor.registerRequestHandlers(mcpServer, {});
-        const transport = new stdio_js_1.StdioServerTransport();
-        await mcpServer.connect(transport);
-        this.logger.log('MCP STDIO ready');
-    }
-};
-exports.StdioService = StdioService;
-exports.StdioService = StdioService = StdioService_1 = __decorate([
-    (0, common_1.Injectable)(),
-    __param(0, (0, common_1.Inject)('MCP_OPTIONS')),
-    __param(1, (0, common_1.Inject)('MCP_MODULE_ID')),
-    __metadata("design:paramtypes", [Object, String, core_1.ModuleRef,
-        mcp_registry_discovery_service_1.McpRegistryDiscoveryService])
-], StdioService);
-//# sourceMappingURL=stdio.service.js.map

package/dist/mcp/transport/stdio.service.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"stdio.service.js","sourceRoot":"","sources":["../../../src/mcp/transport/stdio.service.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,wEAAiF;AACjF,2CAKwB;AACxB,uCAA2D;AAC3D,8CAAiD;AAEjD,2EAAsE;AACtE,+FAAyF;AACzF,oEAA8D;AAC9D,oEAA8D;AAGvD,IAAM,YAAY,oBAAlB,MAAM,YAAY;IAGvB,YAC0C,OAAmB,EACjB,WAAmB,EAC5C,SAAoB,EACpB,YAAyC;QAHlB,YAAO,GAAP,OAAO,CAAY;QACjB,gBAAW,GAAX,WAAW,CAAQ;QAC5C,cAAS,GAAT,SAAS,CAAW;QACpB,iBAAY,GAAZ,YAAY,CAA6B;QAE1D,IAAI,CAAC,MAAM,GAAG,IAAA,oCAAe,EAAC,cAAY,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IACjE,CAAC;IAED,KAAK,CAAC,sBAAsB;QAC1B,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC;YACtD,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS;YACxB,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAC7B,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,6BAAgB,CAAC,KAAK,CAAC;YAAE,OAAO;QAEzD,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC;QAG9C,MAAM,eAAe,GAAG,IAAI,CAAC,YAAY;aACtC,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC;aAC1B,MAAM,CACL,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAClE,CAAC;QAEJ,IAAI,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC/B,MAAM,SAAS,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACzE,IAAI,CAAC,MAAM,CAAC,IAAI,CACd,wDAAwD;gBACtD,kEAAkE,SAAS,IAAI;gBAC/E,gCAAgC,CACnC,CAAC;QACJ,CAAC;QAED,MAAM,SAAS,GAAG,IAAA,oCAAe,EAC/B,IAAI,CAAC,WAAW,EAChB,IAAI,CAAC,YAAY,EACjB,IAAI,CAAC,OAAO,EACZ,IAAI,CAAC,MAAM,CACZ,CAAC;QAEF,MAAM,SAAS,GAAG,uBAAgB,CAAC,MAAM,EAAE,CAAC;QAC5C,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,CAC3C,yCAAkB,EAClB,SAAS,EACT,EAAE,MAAM,EAAE,KAAK,EAAE,CAClB,CAAC;QAGF,QAAQ,CAAC,uBAAuB,CAAC,SAAS,EAAE,EAAS,CAAC,CAAC;QAEvD,MAAM,SAAS,GAAG,IAAI,+BAAoB,EAAE,CAAC;QAC7C,MAAM,SAAS,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAEnC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;IACrC,CAAC;CACF,CAAA;AA1DY,oCAAY;uBAAZ,YAAY;IADxB,IAAA,mBAAU,GAAE;IAKR,WAAA,IAAA,eAAM,EAAC,aAAa,CAAC,CAAA;IACrB,WAAA,IAAA,eAAM,EAAC,eAAe,CAAC,CAAA;qDACI,gBAAS;QACN,4DAA2B;GAPjD,YAAY,CA0DxB","sourcesContent":["import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';\nimport {\n  Inject,\n  Injectable,\n  Logger,\n  OnApplicationBootstrap,\n} from '@nestjs/common';\nimport { ContextIdFactory, ModuleRef } from '@nestjs/core';\nimport { McpTransportType } from '../interfaces';\nimport type { McpOptions } from '../interfaces';\nimport { McpExecutorService } from '../services/mcp-executor.service';\nimport { McpRegistryDiscoveryService } from '../services/mcp-registry-discovery.service';\nimport { createMcpLogger } from '../utils/mcp-logger.factory';\nimport { createMcpServer } from '../utils/mcp-server.factory';\n\n@Injectable()\nexport class StdioService implements OnApplicationBootstrap {\n  private readonly logger: Logger;\n\n  constructor(\n    @Inject('MCP_OPTIONS') private readonly options: McpOptions,\n    @Inject('MCP_MODULE_ID') private readonly mcpModuleId: string,\n    private readonly moduleRef: ModuleRef,\n    private readonly toolRegistry: McpRegistryDiscoveryService,\n  ) {\n    this.logger = createMcpLogger(StdioService.name, this.options);\n  }\n\n  async onApplicationBootstrap() {\n    const transports = Array.isArray(this.options.transport)\n      ? this.options.transport\n      : [this.options.transport];\n    if (!transports.includes(McpTransportType.STDIO)) return;\n\n    this.logger.log('Bootstrapping MCP STDIO...');\n\n    // Warn about tools with @ToolGuards() - they require HTTP context\n    const toolsWithGuards = this.toolRegistry\n      .getTools(this.mcpModuleId)\n      .filter(\n        (tool) => tool.metadata.guards && tool.metadata.guards.length > 0,\n      );\n\n    if (toolsWithGuards.length > 0) {\n      const toolNames = toolsWithGuards.map((t) => t.metadata.name).join(', ');\n      this.logger.warn(\n        `@ToolGuards() are not supported with STDIO transport. ` +\n          `The following tools have guards configured and will be hidden: ${toolNames}. ` +\n          `Consider using HTTP transport.`,\n      );\n    }\n\n    const mcpServer = createMcpServer(\n      this.mcpModuleId,\n      this.toolRegistry,\n      this.options,\n      this.logger,\n    );\n\n    const contextId = ContextIdFactory.create();\n    const executor = await this.moduleRef.resolve(\n      McpExecutorService,\n      contextId,\n      { strict: false },\n    );\n\n    // eslint-disable-next-line @typescript-eslint/no-unsafe-argument\n    executor.registerRequestHandlers(mcpServer, {} as any);\n\n    const transport = new StdioServerTransport();\n    await mcpServer.connect(transport);\n\n    this.logger.log('MCP STDIO ready');\n  }\n}\n"]}

package/dist/mcp/transport/streamable-http.controller.factory.d.ts

@@ -1,14 +0,0 @@
-import { CanActivate, Logger, Type } from '@nestjs/common';
-import type { McpOptions } from '../interfaces';
-import { McpStreamableHttpService } from '../services/mcp-streamable-http.service';
-export declare function createStreamableHttpController(endpoint: string, apiPrefix: string, guards?: Type<CanActivate>[], decorators?: ClassDecorator[], options?: McpOptions): {
-    new (mcpOptions: McpOptions, mcpStreamableHttpService: McpStreamableHttpService): {
-        readonly logger: Logger;
-        readonly mcpOptions: McpOptions;
-        readonly mcpStreamableHttpService: McpStreamableHttpService;
-        handlePostRequest(req: any, res: any, body: unknown): Promise<void>;
-        handleGetRequest(req: any, res: any): Promise<void>;
-        handleDeleteRequest(req: any, res: any): Promise<void>;
-    };
-};
-//# sourceMappingURL=streamable-http.controller.factory.d.ts.map

package/dist/mcp/transport/streamable-http.controller.factory.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"streamable-http.controller.factory.d.ts","sourceRoot":"","sources":["../../../src/mcp/transport/streamable-http.controller.factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,WAAW,EAKX,MAAM,EAIN,IAAI,EAGL,MAAM,gBAAgB,CAAC;AAExB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,wBAAwB,EAAE,MAAM,yCAAyC,CAAC;AAOnF,wBAAgB,8BAA8B,CAC5C,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,MAAM,GAAE,IAAI,CAAC,WAAW,CAAC,EAAO,EAChC,UAAU,GAAE,cAAc,EAAO,EACjC,OAAO,CAAC,EAAE,UAAU;qBAQmC,UAAU,4BACnB,wBAAwB;yBAJ5C,MAAM;6BAGuB,UAAU;2CACnB,wBAAwB;+BActD,GAAG,OACH,GAAG,QACD,OAAO,GACpB,OAAO,CAAC,IAAI,CAAC;8BASmB,GAAG,OAAc,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;iCASjC,GAAG,OAAc,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;;EAM7E"}

package/dist/mcp/transport/streamable-http.controller.factory.js

@@ -1,74 +0,0 @@
-"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.createStreamableHttpController = createStreamableHttpController;
-const common_1 = require("@nestjs/common");
-const mcp_streamable_http_service_1 = require("../services/mcp-streamable-http.service");
-const normalize_endpoint_1 = require("../utils/normalize-endpoint");
-const mcp_logger_factory_1 = require("../utils/mcp-logger.factory");
-function createStreamableHttpController(endpoint, apiPrefix, guards = [], decorators = [], options) {
-    var StreamableHttpController_1;
-    let StreamableHttpController = StreamableHttpController_1 = class StreamableHttpController {
-        constructor(mcpOptions, mcpStreamableHttpService) {
-            this.mcpOptions = mcpOptions;
-            this.mcpStreamableHttpService = mcpStreamableHttpService;
-            this.logger = (0, mcp_logger_factory_1.createMcpLogger)(StreamableHttpController_1.name, options || mcpOptions);
-        }
-        async handlePostRequest(req, res, body) {
-            await this.mcpStreamableHttpService.handlePostRequest(req, res, body);
-        }
-        async handleGetRequest(req, res) {
-            await this.mcpStreamableHttpService.handleGetRequest(req, res);
-        }
-        async handleDeleteRequest(req, res) {
-            await this.mcpStreamableHttpService.handleDeleteRequest(req, res);
-        }
-    };
-    __decorate([
-        (0, common_1.Post)(`${(0, normalize_endpoint_1.normalizeEndpoint)(`${apiPrefix}/${endpoint}`)}`),
-        (0, common_1.UseGuards)(...guards),
-        __param(0, (0, common_1.Req)()),
-        __param(1, (0, common_1.Res)()),
-        __param(2, (0, common_1.Body)()),
-        __metadata("design:type", Function),
-        __metadata("design:paramtypes", [Object, Object, Object]),
-        __metadata("design:returntype", Promise)
-    ], StreamableHttpController.prototype, "handlePostRequest", null);
-    __decorate([
-        (0, common_1.Get)(`${(0, normalize_endpoint_1.normalizeEndpoint)(`${apiPrefix}/${endpoint}`)}`),
-        (0, common_1.UseGuards)(...guards),
-        __param(0, (0, common_1.Req)()),
-        __param(1, (0, common_1.Res)()),
-        __metadata("design:type", Function),
-        __metadata("design:paramtypes", [Object, Object]),
-        __metadata("design:returntype", Promise)
-    ], StreamableHttpController.prototype, "handleGetRequest", null);
-    __decorate([
-        (0, common_1.Delete)(`${(0, normalize_endpoint_1.normalizeEndpoint)(`${apiPrefix}/${endpoint}`)}`),
-        (0, common_1.UseGuards)(...guards),
-        __param(0, (0, common_1.Req)()),
-        __param(1, (0, common_1.Res)()),
-        __metadata("design:type", Function),
-        __metadata("design:paramtypes", [Object, Object]),
-        __metadata("design:returntype", Promise)
-    ], StreamableHttpController.prototype, "handleDeleteRequest", null);
-    StreamableHttpController = StreamableHttpController_1 = __decorate([
-        (0, common_1.Controller)(),
-        (0, common_1.applyDecorators)(...decorators),
-        __param(0, (0, common_1.Inject)('MCP_OPTIONS')),
-        __metadata("design:paramtypes", [Object, mcp_streamable_http_service_1.McpStreamableHttpService])
-    ], StreamableHttpController);
-    return StreamableHttpController;
-}
-//# sourceMappingURL=streamable-http.controller.factory.js.map

package/dist/mcp/transport/streamable-http.controller.factory.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"streamable-http.controller.factory.js","sourceRoot":"","sources":["../../../src/mcp/transport/streamable-http.controller.factory.ts"],"names":[],"mappings":";;;;;;;;;;;;;;AAwBA,wEAuDC;AA/ED,2CAcwB;AAGxB,yFAAmF;AACnF,oEAAgE;AAChE,oEAA8D;AAK9D,SAAgB,8BAA8B,CAC5C,QAAgB,EAChB,SAAiB,EACjB,SAA8B,EAAE,EAChC,aAA+B,EAAE,EACjC,OAAoB;;IAEpB,IAEM,wBAAwB,gCAF9B,MAEM,wBAAwB;QAG5B,YACyC,UAAsB,EAC7C,wBAAkD;YAD3B,eAAU,GAAV,UAAU,CAAY;YAC7C,6BAAwB,GAAxB,wBAAwB,CAA0B;YAElE,IAAI,CAAC,MAAM,GAAG,IAAA,oCAAe,EAC3B,0BAAwB,CAAC,IAAI,EAC7B,OAAO,IAAI,UAAU,CACtB,CAAC;QACJ,CAAC;QAOK,AAAN,KAAK,CAAC,iBAAiB,CACd,GAAQ,EACR,GAAQ,EACP,IAAa;YAErB,MAAM,IAAI,CAAC,wBAAwB,CAAC,iBAAiB,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;QACxE,CAAC;QAOK,AAAN,KAAK,CAAC,gBAAgB,CAAQ,GAAQ,EAAS,GAAQ;YACrD,MAAM,IAAI,CAAC,wBAAwB,CAAC,gBAAgB,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QACjE,CAAC;QAOK,AAAN,KAAK,CAAC,mBAAmB,CAAQ,GAAQ,EAAS,GAAQ;YACxD,MAAM,IAAI,CAAC,wBAAwB,CAAC,mBAAmB,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QACpE,CAAC;KACF,CAAA;IAzBO;QAFL,IAAA,aAAI,EAAC,GAAG,IAAA,sCAAiB,EAAC,GAAG,SAAS,IAAI,QAAQ,EAAE,CAAC,EAAE,CAAC;QACxD,IAAA,kBAAS,EAAC,GAAG,MAAM,CAAC;QAElB,WAAA,IAAA,YAAG,GAAE,CAAA;QACL,WAAA,IAAA,YAAG,GAAE,CAAA;QACL,WAAA,IAAA,aAAI,GAAE,CAAA;;;;qEAGR;IAOK;QAFL,IAAA,YAAG,EAAC,GAAG,IAAA,sCAAiB,EAAC,GAAG,SAAS,IAAI,QAAQ,EAAE,CAAC,EAAE,CAAC;QACvD,IAAA,kBAAS,EAAC,GAAG,MAAM,CAAC;QACG,WAAA,IAAA,YAAG,GAAE,CAAA;QAAY,WAAA,IAAA,YAAG,GAAE,CAAA;;;;oEAE7C;IAOK;QAFL,IAAA,eAAM,EAAC,GAAG,IAAA,sCAAiB,EAAC,GAAG,SAAS,IAAI,QAAQ,EAAE,CAAC,EAAE,CAAC;QAC1D,IAAA,kBAAS,EAAC,GAAG,MAAM,CAAC;QACM,WAAA,IAAA,YAAG,GAAE,CAAA;QAAY,WAAA,IAAA,YAAG,GAAE,CAAA;;;;uEAEhD;IA1CG,wBAAwB;QAF7B,IAAA,mBAAU,GAAE;QACZ,IAAA,wBAAe,EAAC,GAAG,UAAU,CAAC;QAK1B,WAAA,IAAA,eAAM,EAAC,aAAa,CAAC,CAAA;iDACoB,sDAAwB;OALhE,wBAAwB,CA2C7B;IAED,OAAO,wBAAwB,CAAC;AAClC,CAAC","sourcesContent":["import {\n  Body,\n  CanActivate,\n  Controller,\n  Delete,\n  Get,\n  Inject,\n  Logger,\n  Post,\n  Req,\n  Res,\n  Type,\n  UseGuards,\n  applyDecorators,\n} from '@nestjs/common';\n\nimport type { McpOptions } from '../interfaces';\nimport { McpStreamableHttpService } from '../services/mcp-streamable-http.service';\nimport { normalizeEndpoint } from '../utils/normalize-endpoint';\nimport { createMcpLogger } from '../utils/mcp-logger.factory';\n\n/**\n * Creates a controller for handling Streamable HTTP connections and tool executions\n */\nexport function createStreamableHttpController(\n  endpoint: string,\n  apiPrefix: string,\n  guards: Type<CanActivate>[] = [],\n  decorators: ClassDecorator[] = [],\n  options?: McpOptions,\n) {\n  @Controller()\n  @applyDecorators(...decorators)\n  class StreamableHttpController {\n    public readonly logger: Logger;\n\n    constructor(\n      @Inject('MCP_OPTIONS') public readonly mcpOptions: McpOptions,\n      public readonly mcpStreamableHttpService: McpStreamableHttpService,\n    ) {\n      this.logger = createMcpLogger(\n        StreamableHttpController.name,\n        options || mcpOptions,\n      );\n    }\n\n    /**\n     * Main HTTP endpoint for both initialization and subsequent requests\n     */\n    @Post(`${normalizeEndpoint(`${apiPrefix}/${endpoint}`)}`)\n    @UseGuards(...guards)\n    async handlePostRequest(\n      @Req() req: any,\n      @Res() res: any,\n      @Body() body: unknown,\n    ): Promise<void> {\n      await this.mcpStreamableHttpService.handlePostRequest(req, res, body);\n    }\n\n    /**\n     * GET endpoint for SSE streams - not supported in stateless mode\n     */\n    @Get(`${normalizeEndpoint(`${apiPrefix}/${endpoint}`)}`)\n    @UseGuards(...guards)\n    async handleGetRequest(@Req() req: any, @Res() res: any): Promise<void> {\n      await this.mcpStreamableHttpService.handleGetRequest(req, res);\n    }\n\n    /**\n     * DELETE endpoint for terminating sessions - not supported in stateless mode\n     */\n    @Delete(`${normalizeEndpoint(`${apiPrefix}/${endpoint}`)}`)\n    @UseGuards(...guards)\n    async handleDeleteRequest(@Req() req: any, @Res() res: any): Promise<void> {\n      await this.mcpStreamableHttpService.handleDeleteRequest(req, res);\n    }\n  }\n\n  return StreamableHttpController;\n}\n"]}

package/dist/mcp/utils/capabilities-builder.d.ts

@@ -1,5 +0,0 @@
-import { ServerCapabilities } from '@modelcontextprotocol/sdk/types.js';
-import { McpRegistryDiscoveryService } from '../services/mcp-registry-discovery.service';
-import type { McpOptions } from '../interfaces';
-export declare function buildMcpCapabilities(mcpModuleId: string, registry: McpRegistryDiscoveryService, options: McpOptions): ServerCapabilities;
-//# sourceMappingURL=capabilities-builder.d.ts.map

package/dist/mcp/utils/capabilities-builder.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"capabilities-builder.d.ts","sourceRoot":"","sources":["../../../src/mcp/utils/capabilities-builder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AACxE,OAAO,EAAE,2BAA2B,EAAE,MAAM,4CAA4C,CAAC;AACzF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAMhD,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,2BAA2B,EACrC,OAAO,EAAE,UAAU,GAClB,kBAAkB,CA8BpB"}

package/dist/mcp/utils/capabilities-builder.js

@@ -1,25 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.buildMcpCapabilities = buildMcpCapabilities;
-function buildMcpCapabilities(mcpModuleId, registry, options) {
-    const baseCapabilities = options.capabilities || {};
-    const capabilities = { ...baseCapabilities };
-    if (registry.getTools(mcpModuleId).length > 0) {
-        capabilities.tools = capabilities.tools || {
-            listChanged: true,
-        };
-    }
-    if (registry.getResources(mcpModuleId).length > 0 ||
-        registry.getResourceTemplates(mcpModuleId).length > 0) {
-        capabilities.resources = capabilities.resources || {
-            listChanged: true,
-        };
-    }
-    if (registry.getPrompts(mcpModuleId).length > 0) {
-        capabilities.prompts = capabilities.prompts || {
-            listChanged: true,
-        };
-    }
-    return capabilities;
-}
-//# sourceMappingURL=capabilities-builder.js.map

package/dist/mcp/utils/capabilities-builder.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"capabilities-builder.js","sourceRoot":"","sources":["../../../src/mcp/utils/capabilities-builder.ts"],"names":[],"mappings":";;AAQA,oDAkCC;AAlCD,SAAgB,oBAAoB,CAClC,WAAmB,EACnB,QAAqC,EACrC,OAAmB;IAGnB,MAAM,gBAAgB,GAAG,OAAO,CAAC,YAAY,IAAI,EAAE,CAAC;IAEpD,MAAM,YAAY,GAAuB,EAAE,GAAG,gBAAgB,EAAE,CAAC;IAGjE,IAAI,QAAQ,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9C,YAAY,CAAC,KAAK,GAAG,YAAY,CAAC,KAAK,IAAI;YACzC,WAAW,EAAE,IAAI;SAClB,CAAC;IACJ,CAAC;IAED,IACE,QAAQ,CAAC,YAAY,CAAC,WAAW,CAAC,CAAC,MAAM,GAAG,CAAC;QAC7C,QAAQ,CAAC,oBAAoB,CAAC,WAAW,CAAC,CAAC,MAAM,GAAG,CAAC,EACrD,CAAC;QACD,YAAY,CAAC,SAAS,GAAG,YAAY,CAAC,SAAS,IAAI;YACjD,WAAW,EAAE,IAAI;SAClB,CAAC;IACJ,CAAC;IAGD,IAAI,QAAQ,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChD,YAAY,CAAC,OAAO,GAAG,YAAY,CAAC,OAAO,IAAI;YAC7C,WAAW,EAAE,IAAI;SAClB,CAAC;IACJ,CAAC;IAED,OAAO,YAAY,CAAC;AACtB,CAAC","sourcesContent":["import { ServerCapabilities } from '@modelcontextprotocol/sdk/types.js';\nimport { McpRegistryDiscoveryService } from '../services/mcp-registry-discovery.service';\nimport type { McpOptions } from '../interfaces';\n\n/**\n * Utility function to build MCP server capabilities dynamically based on\n * discovered tools, resources, and prompts\n */\nexport function buildMcpCapabilities(\n  mcpModuleId: string,\n  registry: McpRegistryDiscoveryService,\n  options: McpOptions,\n): ServerCapabilities {\n  // Start with user-provided capabilities or empty object\n  const baseCapabilities = options.capabilities || {};\n\n  const capabilities: ServerCapabilities = { ...baseCapabilities };\n\n  // Add tools capability if tools are discovered\n  if (registry.getTools(mcpModuleId).length > 0) {\n    capabilities.tools = capabilities.tools || {\n      listChanged: true,\n    };\n  }\n\n  if (\n    registry.getResources(mcpModuleId).length > 0 ||\n    registry.getResourceTemplates(mcpModuleId).length > 0\n  ) {\n    capabilities.resources = capabilities.resources || {\n      listChanged: true,\n    };\n  }\n\n  // Add prompts capability if prompts are discovered\n  if (registry.getPrompts(mcpModuleId).length > 0) {\n    capabilities.prompts = capabilities.prompts || {\n      listChanged: true,\n    };\n  }\n\n  return capabilities;\n}\n"]}

package/dist/mcp/utils/mcp-server.factory.d.ts

@@ -1,6 +0,0 @@
-import { McpOptions } from '../interfaces';
-import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import { McpRegistryDiscoveryService } from '../services/mcp-registry-discovery.service';
-import { Logger } from '@nestjs/common';
-export declare function createMcpServer(mcpModuleId: string, registry: McpRegistryDiscoveryService, options: McpOptions, logger: Logger): McpServer;
-//# sourceMappingURL=mcp-server.factory.d.ts.map

package/dist/mcp/utils/mcp-server.factory.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"mcp-server.factory.d.ts","sourceRoot":"","sources":["../../../src/mcp/utils/mcp-server.factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,2BAA2B,EAAE,MAAM,4CAA4C,CAAC;AACzF,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAExC,wBAAgB,eAAe,CAC7B,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,2BAA2B,EACrC,OAAO,EAAE,UAAU,EACnB,MAAM,EAAE,MAAM,GACb,SAAS,CAqBX"}

package/dist/mcp/utils/mcp-server.factory.js

@@ -1,22 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createMcpServer = createMcpServer;
-const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
-const capabilities_builder_1 = require("./capabilities-builder");
-function createMcpServer(mcpModuleId, registry, options, logger) {
-    const capabilities = (0, capabilities_builder_1.buildMcpCapabilities)(mcpModuleId, registry, options);
-    logger.debug(`Built MCP capabilities: ${JSON.stringify(capabilities)}`);
-    const mcpServer = new mcp_js_1.McpServer({
-        name: options.name,
-        version: options.version,
-        ...(options.title && { title: options.title }),
-        ...(options.description && { description: options.description }),
-        ...(options.websiteUrl && { websiteUrl: options.websiteUrl }),
-        ...(options.icons && { icons: options.icons }),
-    }, {
-        capabilities,
-        instructions: options.instructions || '',
-    });
-    return options.serverMutator ? options.serverMutator(mcpServer) : mcpServer;
-}
-//# sourceMappingURL=mcp-server.factory.js.map

package/dist/mcp/utils/mcp-server.factory.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"mcp-server.factory.js","sourceRoot":"","sources":["../../../src/mcp/utils/mcp-server.factory.ts"],"names":[],"mappings":";;AAMA,0CA0BC;AA/BD,oEAAoE;AACpE,iEAA8D;AAI9D,SAAgB,eAAe,CAC7B,WAAmB,EACnB,QAAqC,EACrC,OAAmB,EACnB,MAAc;IAEd,MAAM,YAAY,GAAG,IAAA,2CAAoB,EAAC,WAAW,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;IAE1E,MAAM,CAAC,KAAK,CAAC,2BAA2B,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;IAExE,MAAM,SAAS,GAAG,IAAI,kBAAS,CAC7B;QACE,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,GAAG,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC;QAC9C,GAAG,CAAC,OAAO,CAAC,WAAW,IAAI,EAAE,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE,CAAC;QAChE,GAAG,CAAC,OAAO,CAAC,UAAU,IAAI,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC;QAC7D,GAAG,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC;KAC/C,EACD;QACE,YAAY;QACZ,YAAY,EAAE,OAAO,CAAC,YAAY,IAAI,EAAE;KACzC,CACF,CAAC;IAEF,OAAO,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAC9E,CAAC","sourcesContent":["import { McpOptions } from '../interfaces';\nimport { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport { buildMcpCapabilities } from './capabilities-builder';\nimport { McpRegistryDiscoveryService } from '../services/mcp-registry-discovery.service';\nimport { Logger } from '@nestjs/common';\n\nexport function createMcpServer(\n  mcpModuleId: string,\n  registry: McpRegistryDiscoveryService,\n  options: McpOptions,\n  logger: Logger,\n): McpServer {\n  const capabilities = buildMcpCapabilities(mcpModuleId, registry, options);\n\n  logger.debug(`Built MCP capabilities: ${JSON.stringify(capabilities)}`);\n\n  const mcpServer = new McpServer(\n    {\n      name: options.name,\n      version: options.version,\n      ...(options.title && { title: options.title }),\n      ...(options.description && { description: options.description }),\n      ...(options.websiteUrl && { websiteUrl: options.websiteUrl }),\n      ...(options.icons && { icons: options.icons }),\n    },\n    {\n      capabilities,\n      instructions: options.instructions || '',\n    },\n  );\n\n  return options.serverMutator ? options.serverMutator(mcpServer) : mcpServer;\n}\n"]}

package/src/authz/guards/jwt-auth.guard.ts

@@ -1,127 +0,0 @@
-import {
-  Injectable,
-  CanActivate,
-  ExecutionContext,
-  UnauthorizedException,
-  Inject,
-  Optional,
-} from '@nestjs/common';
-import { ModuleRef } from '@nestjs/core';
-import { Request } from 'express';
-import { JwtPayload, JwtTokenService } from '../services/jwt-token.service';
-import type { IOAuthStore } from '../stores/oauth-store.interface';
-import type { McpOptions } from '../../mcp';
-
-export interface AuthenticatedRequest extends Request {
-  user: JwtPayload;
-}
-
-@Injectable()
-export class McpAuthJwtGuard implements CanActivate {
-  constructor(
-    @Optional() private readonly jwtTokenService: JwtTokenService | null,
-    @Optional()
-    @Inject('IOAuthStore')
-    private readonly store: IOAuthStore | null,
-    private readonly moduleRef: ModuleRef,
-    @Optional()
-    @Inject('MCP_OPTIONS')
-    private readonly options?: McpOptions,
-  ) {}
-
-  async canActivate(context: ExecutionContext): Promise<boolean> {
-    const request = context.switchToHttp().getRequest<AuthenticatedRequest>();
-    const token = this.extractTokenFromHeader(request);
-
-    // Check if unauthenticated access is allowed
-    const allowUnauthenticated =
-      this.options?.allowUnauthenticatedAccess ?? false;
-
-    if (!token) {
-      if (allowUnauthenticated) {
-        // Allow unauthenticated sessions
-        // Per-tool authorization will decide what's accessible (@PublicTool() tools only)
-        return true;
-      } else {
-        // Standard OAuth flow: Reject and trigger authorization
-        throw new UnauthorizedException('Access token required');
-      }
-    }
-
-    // Resolve services dynamically if not injected directly
-    const jwtTokenService =
-      this.jwtTokenService ||
-      this.moduleRef.get(JwtTokenService, { strict: false });
-    const store =
-      this.store ||
-      this.moduleRef.get<IOAuthStore>('IOAuthStore', { strict: false });
-
-    if (!jwtTokenService || !store) {
-      throw new UnauthorizedException('Authentication service not available');
-    }
-
-    // If a token is provided, it must be valid
-    const payload = jwtTokenService.validateToken(token);
-
-    if (!payload) {
-      throw new UnauthorizedException('Invalid or expired access token');
-    }
-
-    // Enrich request.user with friendly fields for tools
-    const enriched: any = { ...payload };
-    try {
-      if (!enriched.user_data && enriched.user_profile_id) {
-        const profile = await store.getUserProfileById(
-          enriched.user_profile_id,
-        );
-        if (profile) {
-          enriched.user_data = profile;
-        }
-      }
-      const ud = enriched.user_data || {};
-      // Provide convenient top-level fields commonly used by tools
-      enriched.username =
-        enriched.username || ud.username || ud.id || enriched.sub;
-      enriched.email = enriched.email || ud.email;
-      enriched.displayName = enriched.displayName || ud.displayName;
-      enriched.avatarUrl = enriched.avatarUrl || ud.avatarUrl;
-      enriched.name =
-        enriched.name ||
-        ud.displayName ||
-        ud.username ||
-        ud.email ||
-        enriched.sub;
-
-      // Parse scopes: OAuth 2.0 standard is space-delimited string in 'scope' field
-      if (enriched.scope && typeof enriched.scope === 'string') {
-        enriched.scopes = enriched.scope
-          .split(' ')
-          .filter((s: string) => s.length > 0);
-      } else if (!enriched.scopes) {
-        enriched.scopes = [];
-      }
-
-      // Extract roles from user_data if present
-      if (!enriched.roles && ud.roles && Array.isArray(ud.roles)) {
-        enriched.roles = ud.roles;
-      } else if (!enriched.roles) {
-        enriched.roles = [];
-      }
-    } catch {
-      // Non-fatal; proceed with raw payload
-    }
-
-    request.user = enriched as JwtPayload;
-    return true;
-  }
-
-  private extractTokenFromHeader(request: Request): string | undefined {
-    const authHeader = request.headers.authorization;
-    if (!authHeader) {
-      return undefined;
-    }
-
-    const [type, token] = authHeader.split(' ');
-    return type === 'Bearer' ? token : undefined;
-  }
-}