@dxheroes/local-mcp-backend 0.4.0 → 0.5.0

package/dist/modules/proxy/proxy.module.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/modules/proxy/proxy.module.ts"],"sourcesContent":["/**\n * Proxy Module\n *\n * Handles MCP proxy endpoints for profiles.\n */\n\nimport { Module } from '@nestjs/common';\nimport { DebugModule } from '../debug/debug.module.js';\nimport { McpModule } from '../mcp/mcp.module.js';\nimport { ProxyController } from './proxy.controller.js';\nimport { ProxyService } from './proxy.service.js';\n\n@Module({\n  imports: [McpModule, DebugModule],\n  controllers: [ProxyController],\n  providers: [ProxyService],\n  exports: [ProxyService],\n})\nexport class ProxyModule {}\n"],"names":["Module","DebugModule","McpModule","ProxyController","ProxyService","ProxyModule","imports","controllers","providers","exports"],"mappings":";;;;;;AAAA;;;;CAIC,GAED,SAASA,MAAM,QAAQ,iBAAiB;AACxC,SAASC,WAAW,QAAQ,2BAA2B;AACvD,SAASC,SAAS,QAAQ,uBAAuB;AACjD,SAASC,eAAe,QAAQ,wBAAwB;AACxD,SAASC,YAAY,QAAQ,qBAAqB;AAQlD,OAAO,MAAMC;AAAa;;;QALxBC,SAAS;YAACJ;YAAWD;SAAY;QACjCM,aAAa;YAACJ;SAAgB;QAC9BK,WAAW;YAACJ;SAAa;QACzBK,SAAS;YAACL;SAAa"}
+{"version":3,"sources":["../../../src/modules/proxy/proxy.module.ts"],"sourcesContent":["/**\n * Proxy Module\n *\n * Handles MCP proxy endpoints for profiles.\n * Supports SSE notifications for MCP Streamable HTTP transport.\n */\n\nimport { Module } from '@nestjs/common';\nimport { DebugModule } from '../debug/debug.module.js';\nimport { McpModule } from '../mcp/mcp.module.js';\nimport { SettingsModule } from '../settings/settings.module.js';\nimport { ProxyController } from './proxy.controller.js';\nimport { ProxyService } from './proxy.service.js';\n\n@Module({\n  imports: [McpModule, DebugModule, SettingsModule],\n  controllers: [ProxyController],\n  providers: [ProxyService],\n  exports: [ProxyService],\n})\nexport class ProxyModule {}\n"],"names":["Module","DebugModule","McpModule","SettingsModule","ProxyController","ProxyService","ProxyModule","imports","controllers","providers","exports"],"mappings":";;;;;;AAAA;;;;;CAKC,GAED,SAASA,MAAM,QAAQ,iBAAiB;AACxC,SAASC,WAAW,QAAQ,2BAA2B;AACvD,SAASC,SAAS,QAAQ,uBAAuB;AACjD,SAASC,cAAc,QAAQ,iCAAiC;AAChE,SAASC,eAAe,QAAQ,wBAAwB;AACxD,SAASC,YAAY,QAAQ,qBAAqB;AAQlD,OAAO,MAAMC;AAAa;;;QALxBC,SAAS;YAACL;YAAWD;YAAaE;SAAe;QACjDK,aAAa;YAACJ;SAAgB;QAC9BK,WAAW;YAACJ;SAAa;QACzBK,SAAS;YAACL;SAAa"}

package/dist/modules/settings/settings.constants.js

@@ -0,0 +1,18 @@
+/**
+ * Settings Constants
+ *
+ * Defines setting keys, defaults, and reserved profile names.
+ */ // Setting keys
+export const SETTING_KEYS = {
+    DEFAULT_GATEWAY_PROFILE: 'default_gateway_profile'
+};
+// Default values for settings
+export const SETTING_DEFAULTS = {
+    [SETTING_KEYS.DEFAULT_GATEWAY_PROFILE]: 'default'
+};
+// Reserved profile names that cannot be created by users
+export const RESERVED_PROFILE_NAMES = [
+    'gateway'
+];
+
+//# sourceMappingURL=settings.constants.js.map

package/dist/modules/settings/settings.constants.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/modules/settings/settings.constants.ts"],"sourcesContent":["/**\n * Settings Constants\n *\n * Defines setting keys, defaults, and reserved profile names.\n */\n\n// Setting keys\nexport const SETTING_KEYS = {\n  DEFAULT_GATEWAY_PROFILE: 'default_gateway_profile',\n} as const;\n\n// Default values for settings\nexport const SETTING_DEFAULTS: Record<string, string> = {\n  [SETTING_KEYS.DEFAULT_GATEWAY_PROFILE]: 'default',\n};\n\n// Reserved profile names that cannot be created by users\nexport const RESERVED_PROFILE_NAMES = ['gateway'] as const;\n\nexport type SettingKey = (typeof SETTING_KEYS)[keyof typeof SETTING_KEYS];\n"],"names":["SETTING_KEYS","DEFAULT_GATEWAY_PROFILE","SETTING_DEFAULTS","RESERVED_PROFILE_NAMES"],"mappings":"AAAA;;;;CAIC,GAED,eAAe;AACf,OAAO,MAAMA,eAAe;IAC1BC,yBAAyB;AAC3B,EAAW;AAEX,8BAA8B;AAC9B,OAAO,MAAMC,mBAA2C;IACtD,CAACF,aAAaC,uBAAuB,CAAC,EAAE;AAC1C,EAAE;AAEF,yDAAyD;AACzD,OAAO,MAAME,yBAAyB;IAAC;CAAU,CAAU"}

package/dist/modules/settings/settings.controller.js

@@ -0,0 +1,89 @@
+function _ts_decorate(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;
+}
+function _ts_metadata(k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+}
+function _ts_param(paramIndex, decorator) {
+    return function(target, key) {
+        decorator(target, key, paramIndex);
+    };
+}
+/**
+ * Settings Controller
+ *
+ * REST API endpoints for gateway settings management.
+ */ import { Body, Controller, Get, Put } from "@nestjs/common";
+import { IsNotEmpty, IsString, MaxLength } from "class-validator";
+import { SettingsService } from "./settings.service.js";
+export class UpdateDefaultGatewayProfileDto {
+}
+_ts_decorate([
+    IsString(),
+    IsNotEmpty({
+        message: 'Profile name cannot be empty'
+    }),
+    MaxLength(100, {
+        message: 'Profile name must be at most 100 characters'
+    }),
+    _ts_metadata("design:type", String)
+], UpdateDefaultGatewayProfileDto.prototype, "profileName", void 0);
+export class SettingsController {
+    constructor(settingsService){
+        this.settingsService = settingsService;
+    }
+    /**
+   * Get all gateway settings
+   */ async getAllSettings() {
+        return this.settingsService.getAllSettings();
+    }
+    /**
+   * Get the default gateway profile setting
+   */ async getDefaultGatewayProfile() {
+        const profileName = await this.settingsService.getDefaultGatewayProfile();
+        return {
+            profileName
+        };
+    }
+    /**
+   * Set the default gateway profile
+   */ async setDefaultGatewayProfile(dto) {
+        await this.settingsService.setDefaultGatewayProfile(dto.profileName);
+        return {
+            profileName: dto.profileName
+        };
+    }
+}
+_ts_decorate([
+    Get(),
+    _ts_metadata("design:type", Function),
+    _ts_metadata("design:paramtypes", []),
+    _ts_metadata("design:returntype", Promise)
+], SettingsController.prototype, "getAllSettings", null);
+_ts_decorate([
+    Get('default-gateway-profile'),
+    _ts_metadata("design:type", Function),
+    _ts_metadata("design:paramtypes", []),
+    _ts_metadata("design:returntype", Promise)
+], SettingsController.prototype, "getDefaultGatewayProfile", null);
+_ts_decorate([
+    Put('default-gateway-profile'),
+    _ts_param(0, Body()),
+    _ts_metadata("design:type", Function),
+    _ts_metadata("design:paramtypes", [
+        typeof UpdateDefaultGatewayProfileDto === "undefined" ? Object : UpdateDefaultGatewayProfileDto
+    ]),
+    _ts_metadata("design:returntype", Promise)
+], SettingsController.prototype, "setDefaultGatewayProfile", null);
+SettingsController = _ts_decorate([
+    Controller('settings'),
+    _ts_metadata("design:type", Function),
+    _ts_metadata("design:paramtypes", [
+        typeof SettingsService === "undefined" ? Object : SettingsService
+    ])
+], SettingsController);
+
+//# sourceMappingURL=settings.controller.js.map

package/dist/modules/settings/settings.controller.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/modules/settings/settings.controller.ts"],"sourcesContent":["/**\n * Settings Controller\n *\n * REST API endpoints for gateway settings management.\n */\n\nimport { Body, Controller, Get, Put } from '@nestjs/common';\nimport { IsNotEmpty, IsString, MaxLength } from 'class-validator';\nimport { SettingsService } from './settings.service.js';\n\nexport class UpdateDefaultGatewayProfileDto {\n  @IsString()\n  @IsNotEmpty({ message: 'Profile name cannot be empty' })\n  @MaxLength(100, { message: 'Profile name must be at most 100 characters' })\n  profileName: string;\n}\n\n@Controller('settings')\nexport class SettingsController {\n  constructor(private readonly settingsService: SettingsService) {}\n\n  /**\n   * Get all gateway settings\n   */\n  @Get()\n  async getAllSettings() {\n    return this.settingsService.getAllSettings();\n  }\n\n  /**\n   * Get the default gateway profile setting\n   */\n  @Get('default-gateway-profile')\n  async getDefaultGatewayProfile() {\n    const profileName = await this.settingsService.getDefaultGatewayProfile();\n    return { profileName };\n  }\n\n  /**\n   * Set the default gateway profile\n   */\n  @Put('default-gateway-profile')\n  async setDefaultGatewayProfile(@Body() dto: UpdateDefaultGatewayProfileDto) {\n    await this.settingsService.setDefaultGatewayProfile(dto.profileName);\n    return { profileName: dto.profileName };\n  }\n}\n"],"names":["Body","Controller","Get","Put","IsNotEmpty","IsString","MaxLength","SettingsService","UpdateDefaultGatewayProfileDto","message","SettingsController","settingsService","getAllSettings","getDefaultGatewayProfile","profileName","setDefaultGatewayProfile","dto"],"mappings":";;;;;;;;;;;;;;AAAA;;;;CAIC,GAED,SAASA,IAAI,EAAEC,UAAU,EAAEC,GAAG,EAAEC,GAAG,QAAQ,iBAAiB;AAC5D,SAASC,UAAU,EAAEC,QAAQ,EAAEC,SAAS,QAAQ,kBAAkB;AAClE,SAASC,eAAe,QAAQ,wBAAwB;AAExD,OAAO,MAAMC;AAKb;;;;QAHgBC,SAAS;;;QACLA,SAAS;;;;AAK7B,OAAO,MAAMC;IACX,YAAY,AAAiBC,eAAgC,CAAE;aAAlCA,kBAAAA;IAAmC;IAEhE;;GAEC,GACD,MACMC,iBAAiB;QACrB,OAAO,IAAI,CAACD,eAAe,CAACC,cAAc;IAC5C;IAEA;;GAEC,GACD,MACMC,2BAA2B;QAC/B,MAAMC,cAAc,MAAM,IAAI,CAACH,eAAe,CAACE,wBAAwB;QACvE,OAAO;YAAEC;QAAY;IACvB;IAEA;;GAEC,GACD,MACMC,yBAAyB,AAAQC,GAAmC,EAAE;QAC1E,MAAM,IAAI,CAACL,eAAe,CAACI,wBAAwB,CAACC,IAAIF,WAAW;QACnE,OAAO;YAAEA,aAAaE,IAAIF,WAAW;QAAC;IACxC;AACF"}

package/dist/modules/settings/settings.module.js

@@ -0,0 +1,30 @@
+function _ts_decorate(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;
+}
+/**
+ * Settings Module
+ *
+ * Handles gateway configuration settings.
+ */ import { Module } from "@nestjs/common";
+import { SettingsController } from "./settings.controller.js";
+import { SettingsService } from "./settings.service.js";
+export class SettingsModule {
+}
+SettingsModule = _ts_decorate([
+    Module({
+        controllers: [
+            SettingsController
+        ],
+        providers: [
+            SettingsService
+        ],
+        exports: [
+            SettingsService
+        ]
+    })
+], SettingsModule);
+
+//# sourceMappingURL=settings.module.js.map

package/dist/modules/settings/settings.module.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/modules/settings/settings.module.ts"],"sourcesContent":["/**\n * Settings Module\n *\n * Handles gateway configuration settings.\n */\n\nimport { Module } from '@nestjs/common';\nimport { SettingsController } from './settings.controller.js';\nimport { SettingsService } from './settings.service.js';\n\n@Module({\n  controllers: [SettingsController],\n  providers: [SettingsService],\n  exports: [SettingsService],\n})\nexport class SettingsModule {}\n"],"names":["Module","SettingsController","SettingsService","SettingsModule","controllers","providers","exports"],"mappings":";;;;;;AAAA;;;;CAIC,GAED,SAASA,MAAM,QAAQ,iBAAiB;AACxC,SAASC,kBAAkB,QAAQ,2BAA2B;AAC9D,SAASC,eAAe,QAAQ,wBAAwB;AAOxD,OAAO,MAAMC;AAAgB;;;QAJ3BC,aAAa;YAACH;SAAmB;QACjCI,WAAW;YAACH;SAAgB;QAC5BI,SAAS;YAACJ;SAAgB"}

package/dist/modules/settings/settings.service.js

@@ -0,0 +1,110 @@
+function _ts_decorate(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;
+}
+function _ts_metadata(k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+}
+/**
+ * Settings Service
+ *
+ * Business logic for gateway settings management.
+ * Emits events when gateway settings change for SSE notifications.
+ */ import { BadRequestException, Injectable, NotFoundException } from "@nestjs/common";
+import { EventEmitter2 } from "@nestjs/event-emitter";
+import { PrismaService } from "../database/prisma.service.js";
+import { SETTING_DEFAULTS, SETTING_KEYS } from "./settings.constants.js";
+/** Event name for gateway profile changes */ export const GATEWAY_PROFILE_CHANGED = 'gateway.profile.changed';
+export class SettingsService {
+    constructor(prisma, eventEmitter){
+        this.prisma = prisma;
+        this.eventEmitter = eventEmitter;
+    }
+    /**
+   * Get a setting value by key, returns default if not set
+   */ async getSetting(key) {
+        const setting = await this.prisma.gatewaySetting.findUnique({
+            where: {
+                key
+            }
+        });
+        return setting?.value ?? SETTING_DEFAULTS[key];
+    }
+    /**
+   * Set a setting value
+   */ async setSetting(key, value) {
+        const setting = await this.prisma.gatewaySetting.upsert({
+            where: {
+                key
+            },
+            update: {
+                value
+            },
+            create: {
+                key,
+                value
+            }
+        });
+        return {
+            key: setting.key,
+            value: setting.value
+        };
+    }
+    /**
+   * Get the default gateway profile name
+   */ async getDefaultGatewayProfile() {
+        return this.getSetting(SETTING_KEYS.DEFAULT_GATEWAY_PROFILE);
+    }
+    /**
+   * Set the default gateway profile
+   * Validates that the profile exists before setting.
+   * Emits GATEWAY_PROFILE_CHANGED event for SSE subscribers.
+   */ async setDefaultGatewayProfile(profileName) {
+        // Input sanitization
+        const trimmedName = profileName?.trim();
+        if (!trimmedName) {
+            throw new BadRequestException('Profile name cannot be empty');
+        }
+        // Validate that profile exists
+        const profile = await this.prisma.profile.findUnique({
+            where: {
+                name: trimmedName
+            }
+        });
+        if (!profile) {
+            throw new NotFoundException(`Profile "${trimmedName}" not found`);
+        }
+        const result = await this.setSetting(SETTING_KEYS.DEFAULT_GATEWAY_PROFILE, trimmedName);
+        // Emit event for SSE subscribers (MCP Streamable HTTP notifications)
+        this.eventEmitter.emit(GATEWAY_PROFILE_CHANGED, {
+            profileName: trimmedName
+        });
+        return result;
+    }
+    /**
+   * Get all settings with their current values
+   */ async getAllSettings() {
+        const settings = await this.prisma.gatewaySetting.findMany();
+        // Start with defaults
+        const result = {
+            ...SETTING_DEFAULTS
+        };
+        // Override with stored values
+        for (const setting of settings){
+            result[setting.key] = setting.value;
+        }
+        return result;
+    }
+}
+SettingsService = _ts_decorate([
+    Injectable(),
+    _ts_metadata("design:type", Function),
+    _ts_metadata("design:paramtypes", [
+        typeof PrismaService === "undefined" ? Object : PrismaService,
+        typeof EventEmitter2 === "undefined" ? Object : EventEmitter2
+    ])
+], SettingsService);
+
+//# sourceMappingURL=settings.service.js.map

package/dist/modules/settings/settings.service.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/modules/settings/settings.service.ts"],"sourcesContent":["/**\n * Settings Service\n *\n * Business logic for gateway settings management.\n * Emits events when gateway settings change for SSE notifications.\n */\n\nimport { BadRequestException, Injectable, NotFoundException } from '@nestjs/common';\nimport { EventEmitter2 } from '@nestjs/event-emitter';\nimport { PrismaService } from '../database/prisma.service.js';\nimport { SETTING_DEFAULTS, SETTING_KEYS, type SettingKey } from './settings.constants.js';\n\n/** Event name for gateway profile changes */\nexport const GATEWAY_PROFILE_CHANGED = 'gateway.profile.changed';\n\n@Injectable()\nexport class SettingsService {\n  constructor(\n    private readonly prisma: PrismaService,\n    private readonly eventEmitter: EventEmitter2\n  ) {}\n\n  /**\n   * Get a setting value by key, returns default if not set\n   */\n  async getSetting(key: SettingKey): Promise<string> {\n    const setting = await this.prisma.gatewaySetting.findUnique({\n      where: { key },\n    });\n\n    return setting?.value ?? SETTING_DEFAULTS[key];\n  }\n\n  /**\n   * Set a setting value\n   */\n  async setSetting(key: SettingKey, value: string): Promise<{ key: string; value: string }> {\n    const setting = await this.prisma.gatewaySetting.upsert({\n      where: { key },\n      update: { value },\n      create: { key, value },\n    });\n\n    return { key: setting.key, value: setting.value };\n  }\n\n  /**\n   * Get the default gateway profile name\n   */\n  async getDefaultGatewayProfile(): Promise<string> {\n    return this.getSetting(SETTING_KEYS.DEFAULT_GATEWAY_PROFILE);\n  }\n\n  /**\n   * Set the default gateway profile\n   * Validates that the profile exists before setting.\n   * Emits GATEWAY_PROFILE_CHANGED event for SSE subscribers.\n   */\n  async setDefaultGatewayProfile(profileName: string): Promise<{ key: string; value: string }> {\n    // Input sanitization\n    const trimmedName = profileName?.trim();\n    if (!trimmedName) {\n      throw new BadRequestException('Profile name cannot be empty');\n    }\n\n    // Validate that profile exists\n    const profile = await this.prisma.profile.findUnique({\n      where: { name: trimmedName },\n    });\n\n    if (!profile) {\n      throw new NotFoundException(`Profile \"${trimmedName}\" not found`);\n    }\n\n    const result = await this.setSetting(SETTING_KEYS.DEFAULT_GATEWAY_PROFILE, trimmedName);\n\n    // Emit event for SSE subscribers (MCP Streamable HTTP notifications)\n    this.eventEmitter.emit(GATEWAY_PROFILE_CHANGED, { profileName: trimmedName });\n\n    return result;\n  }\n\n  /**\n   * Get all settings with their current values\n   */\n  async getAllSettings(): Promise<Record<string, string>> {\n    const settings = await this.prisma.gatewaySetting.findMany();\n\n    // Start with defaults\n    const result: Record<string, string> = { ...SETTING_DEFAULTS };\n\n    // Override with stored values\n    for (const setting of settings) {\n      result[setting.key] = setting.value;\n    }\n\n    return result;\n  }\n}\n"],"names":["BadRequestException","Injectable","NotFoundException","EventEmitter2","PrismaService","SETTING_DEFAULTS","SETTING_KEYS","GATEWAY_PROFILE_CHANGED","SettingsService","prisma","eventEmitter","getSetting","key","setting","gatewaySetting","findUnique","where","value","setSetting","upsert","update","create","getDefaultGatewayProfile","DEFAULT_GATEWAY_PROFILE","setDefaultGatewayProfile","profileName","trimmedName","trim","profile","name","result","emit","getAllSettings","settings","findMany"],"mappings":";;;;;;;;;AAAA;;;;;CAKC,GAED,SAASA,mBAAmB,EAAEC,UAAU,EAAEC,iBAAiB,QAAQ,iBAAiB;AACpF,SAASC,aAAa,QAAQ,wBAAwB;AACtD,SAASC,aAAa,QAAQ,gCAAgC;AAC9D,SAASC,gBAAgB,EAAEC,YAAY,QAAyB,0BAA0B;AAE1F,2CAA2C,GAC3C,OAAO,MAAMC,0BAA0B,0BAA0B;AAGjE,OAAO,MAAMC;IACX,YACE,AAAiBC,MAAqB,EACtC,AAAiBC,YAA2B,CAC5C;aAFiBD,SAAAA;aACAC,eAAAA;IAChB;IAEH;;GAEC,GACD,MAAMC,WAAWC,GAAe,EAAmB;QACjD,MAAMC,UAAU,MAAM,IAAI,CAACJ,MAAM,CAACK,cAAc,CAACC,UAAU,CAAC;YAC1DC,OAAO;gBAAEJ;YAAI;QACf;QAEA,OAAOC,SAASI,SAASZ,gBAAgB,CAACO,IAAI;IAChD;IAEA;;GAEC,GACD,MAAMM,WAAWN,GAAe,EAAEK,KAAa,EAA2C;QACxF,MAAMJ,UAAU,MAAM,IAAI,CAACJ,MAAM,CAACK,cAAc,CAACK,MAAM,CAAC;YACtDH,OAAO;gBAAEJ;YAAI;YACbQ,QAAQ;gBAAEH;YAAM;YAChBI,QAAQ;gBAAET;gBAAKK;YAAM;QACvB;QAEA,OAAO;YAAEL,KAAKC,QAAQD,GAAG;YAAEK,OAAOJ,QAAQI,KAAK;QAAC;IAClD;IAEA;;GAEC,GACD,MAAMK,2BAA4C;QAChD,OAAO,IAAI,CAACX,UAAU,CAACL,aAAaiB,uBAAuB;IAC7D;IAEA;;;;GAIC,GACD,MAAMC,yBAAyBC,WAAmB,EAA2C;QAC3F,qBAAqB;QACrB,MAAMC,cAAcD,aAAaE;QACjC,IAAI,CAACD,aAAa;YAChB,MAAM,IAAI1B,oBAAoB;QAChC;QAEA,+BAA+B;QAC/B,MAAM4B,UAAU,MAAM,IAAI,CAACnB,MAAM,CAACmB,OAAO,CAACb,UAAU,CAAC;YACnDC,OAAO;gBAAEa,MAAMH;YAAY;QAC7B;QAEA,IAAI,CAACE,SAAS;YACZ,MAAM,IAAI1B,kBAAkB,CAAC,SAAS,EAAEwB,YAAY,WAAW,CAAC;QAClE;QAEA,MAAMI,SAAS,MAAM,IAAI,CAACZ,UAAU,CAACZ,aAAaiB,uBAAuB,EAAEG;QAE3E,qEAAqE;QACrE,IAAI,CAAChB,YAAY,CAACqB,IAAI,CAACxB,yBAAyB;YAAEkB,aAAaC;QAAY;QAE3E,OAAOI;IACT;IAEA;;GAEC,GACD,MAAME,iBAAkD;QACtD,MAAMC,WAAW,MAAM,IAAI,CAACxB,MAAM,CAACK,cAAc,CAACoB,QAAQ;QAE1D,sBAAsB;QACtB,MAAMJ,SAAiC;YAAE,GAAGzB,gBAAgB;QAAC;QAE7D,8BAA8B;QAC9B,KAAK,MAAMQ,WAAWoB,SAAU;YAC9BH,MAAM,CAACjB,QAAQD,GAAG,CAAC,GAAGC,QAAQI,KAAK;QACrC;QAEA,OAAOa;IACT;AACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dxheroes/local-mcp-backend",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "NestJS API server providing MCP proxy, server aggregation, OAuth 2.1, and profile management",
   "license": "Elastic-2.0",
   "type": "module",
@@ -10,6 +10,7 @@
     "@nestjs/common": "^11.1.11",
     "@nestjs/config": "^4.0.2",
     "@nestjs/core": "^11.1.11",
+    "@nestjs/event-emitter": "^3.0.1",
     "@nestjs/platform-express": "^11.1.11",
     "@nestjs/throttler": "^6.5.0",
     "class-transformer": "^0.5.1",
@@ -19,9 +20,9 @@
     "reflect-metadata": "^0.2.2",
     "rxjs": "^7.8.2",
     "zod": "^4.3.5",
-    "@dxheroes/local-mcp-core": "0.3.3",
-    "@dxheroes/mcp-gemini-deep-research": "0.3.3",
-    "@dxheroes/local-mcp-database": "0.3.3"
+    "@dxheroes/local-mcp-core": "0.4.0",
+    "@dxheroes/mcp-gemini-deep-research": "0.4.0",
+    "@dxheroes/local-mcp-database": "0.4.0"
   },
   "devDependencies": {
     "@nestjs/cli": "^11.0.14",
@@ -34,7 +35,7 @@
     "@types/node": "^25.0.6",
     "typescript": "^5.9.3",
     "vitest": "^4.0.17",
-    "@dxheroes/local-mcp-config": "0.3.3"
+    "@dxheroes/local-mcp-config": "0.4.0"
   },
   "scripts": {
     "build": "nest build",

package/src/AGENTS.md

@@ -0,0 +1,23 @@
+# Backend Source Directory
+
+## Description
+
+Root source directory for the NestJS backend application. Contains the main entry point, app module, configuration, common utilities, and all feature modules.
+
+## Contents
+
+- `main.ts` - NestJS bootstrap and server initialization
+- `app.module.ts` - Root module that imports all feature modules
+
+## Subdirectories
+
+- **[config/](config/AGENTS.md)** - Application and database configuration
+- **[common/](common/AGENTS.md)** - Shared utilities (filters, interceptors, decorators, pipes)
+- **[modules/](modules/AGENTS.md)** - Feature modules (mcp, profiles, proxy, oauth, etc.)
+
+## Key Concepts
+
+- NestJS follows modular architecture with dependency injection
+- Each feature has its own module with controller, service, and DTOs
+- Global modules (database) are imported in app.module.ts
+- Configuration is loaded via @nestjs/config

package/src/app.module.ts

@@ -7,6 +7,7 @@
 
 import { Module } from '@nestjs/common';
 import { ConfigModule } from '@nestjs/config';
+import { EventEmitterModule } from '@nestjs/event-emitter';
 import { ThrottlerModule } from '@nestjs/throttler';
 import appConfig from './config/app.config.js';
 import databaseConfig from './config/database.config.js';
@@ -17,6 +18,7 @@ import { McpModule } from './modules/mcp/mcp.module.js';
 import { OAuthModule } from './modules/oauth/oauth.module.js';
 import { ProfilesModule } from './modules/profiles/profiles.module.js';
 import { ProxyModule } from './modules/proxy/proxy.module.js';
+import { SettingsModule } from './modules/settings/settings.module.js';
 
 @Module({
   imports: [
@@ -27,6 +29,9 @@ import { ProxyModule } from './modules/proxy/proxy.module.js';
       envFilePath: ['../../.env', '.env.local', '.env'],
     }),
 
+    // Event emitter for SSE notifications
+    EventEmitterModule.forRoot(),
+
     // Rate limiting
     ThrottlerModule.forRoot([
       {
@@ -51,6 +56,7 @@ import { ProxyModule } from './modules/proxy/proxy.module.js';
     McpModule,
     ProfilesModule,
     OAuthModule, // For OAuth MCP servers, not user authentication
+    SettingsModule, // Gateway settings
     ProxyModule,
     HealthModule,
     DebugModule,

package/src/common/AGENTS.md

@@ -0,0 +1,19 @@
+# Common Directory
+
+## Description
+
+Shared utilities and cross-cutting concerns for the NestJS backend. Contains reusable decorators, filters, interceptors, and pipes.
+
+## Subdirectories
+
+- `decorators/` - Custom decorators for route handlers
+- `filters/` - Exception filters for error handling
+- `interceptors/` - Request/response interceptors (logging, timeout)
+- `pipes/` - Validation pipes for input transformation
+
+## Key Concepts
+
+- Common utilities are used across all modules
+- Filters handle uncaught exceptions globally
+- Interceptors can modify request/response flow
+- Pipes validate and transform incoming data

package/src/config/AGENTS.md

@@ -0,0 +1,17 @@
+# Config Directory
+
+## Description
+
+Application configuration files using @nestjs/config. Provides type-safe configuration for the NestJS backend.
+
+## Contents
+
+- `app.config.ts` - General application configuration (port, environment)
+- `database.config.ts` - Database/Prisma configuration (SQLite path)
+
+## Key Concepts
+
+- Configuration is loaded at application startup
+- Uses environment variables with defaults
+- Database path defaults to `~/.local-mcp-gateway-data/local-mcp-gateway.db`
+- Configuration is injected via ConfigService

package/src/modules/AGENTS.md

@@ -0,0 +1,31 @@
+# Modules Directory
+
+## Description
+
+NestJS feature modules organized by domain. Each module encapsulates related functionality with its own controller, service, and DTOs.
+
+## Subdirectories
+
+- **[database/](database/AGENTS.md)** - Prisma database service (global module)
+- **[debug/](debug/AGENTS.md)** - Debug logging for MCP traffic
+- **[health/](health/AGENTS.md)** - Health check endpoints
+- **[mcp/](mcp/AGENTS.md)** - MCP server management, discovery, and registry
+- **[oauth/](oauth/AGENTS.md)** - OAuth 2.1 authentication for MCP servers
+- **[profiles/](profiles/AGENTS.md)** - Profile CRUD operations
+- **[proxy/](proxy/AGENTS.md)** - MCP proxy endpoints (HTTP/SSE)
+- **[settings/](settings/AGENTS.md)** - Application settings management
+
+## Module Structure Pattern
+
+Each module typically contains:
+- `*.module.ts` - Module definition with imports/providers/controllers
+- `*.controller.ts` - REST API endpoints
+- `*.service.ts` - Business logic and data access
+- `dto/` - Data transfer objects (optional)
+
+## Key Concepts
+
+- Modules are self-contained units with clear boundaries
+- Services use Prisma for database access
+- Controllers handle HTTP requests and validation
+- Dependency injection connects all components

package/src/modules/database/AGENTS.md

@@ -0,0 +1,30 @@
+# Database Module
+
+## Description
+
+Global database module providing Prisma ORM access to all other modules. Handles SQLite database connection and lifecycle.
+
+## Contents
+
+- `database.module.ts` - Global module definition
+- `prisma.service.ts` - Prisma client wrapper with lifecycle hooks
+
+## Key Concepts
+
+- **Global Module**: Imported once in AppModule, available everywhere
+- **PrismaService**: Extends PrismaClient with NestJS lifecycle integration
+- **Connection Management**: Handles connect/disconnect on app start/stop
+- **SQLite**: Default database stored in `~/.local-mcp-gateway-data/`
+
+## Usage
+
+```typescript
+@Injectable()
+export class MyService {
+  constructor(private readonly prisma: PrismaService) {}
+
+  async findAll() {
+    return this.prisma.myModel.findMany();
+  }
+}
+```

package/src/modules/debug/AGENTS.md

@@ -0,0 +1,30 @@
+# Debug Module
+
+## Description
+
+Debug logging module for capturing and querying MCP traffic. Records all requests/responses between AI clients and MCP servers.
+
+## Contents
+
+- `debug.module.ts` - Module definition
+- `debug.controller.ts` - REST API for debug log queries
+- `debug.service.ts` - Debug log storage and retrieval
+
+## Key Endpoints
+
+- `GET /api/debug/logs` - Query debug logs with filters
+- `DELETE /api/debug/logs` - Clear debug logs
+
+## Key Concepts
+
+- **Log Capture**: Records MCP requests and responses
+- **Filtering**: Query by profile, server, type, status
+- **Auto-Cleanup**: Configurable log retention
+- **Real-time**: Supports polling for live monitoring
+
+## Debug Log Fields
+
+- Profile and MCP server identification
+- Request/response payloads
+- Duration and status
+- Timestamps

package/src/modules/health/AGENTS.md

@@ -0,0 +1,22 @@
+# Health Module
+
+## Description
+
+Health check endpoints for monitoring application status. Used by container orchestrators and load balancers.
+
+## Contents
+
+- `health.module.ts` - Module definition
+- `health.controller.ts` - Health check endpoints
+
+## Key Endpoints
+
+- `GET /health` - Basic health check
+- `GET /health/ready` - Readiness probe (database connection)
+
+## Key Concepts
+
+- **Liveness**: Application is running
+- **Readiness**: Application can serve traffic
+- **Docker**: Used by Docker health checks
+- **Kubernetes**: Compatible with K8s probes

package/src/modules/mcp/AGENTS.md

@@ -0,0 +1,38 @@
+# MCP Module
+
+## Description
+
+Core MCP server management module. Handles MCP server CRUD, auto-discovery of MCP packages, and the in-memory registry.
+
+## Contents
+
+- `mcp.module.ts` - Module definition with all MCP services
+- `mcp.controller.ts` - REST API for MCP server management
+- `mcp.service.ts` - MCP server CRUD and connection management
+- `mcp-discovery.service.ts` - Auto-discovery of MCP packages from `mcp-servers/`
+- `mcp-registry.ts` - In-memory registry of discovered MCP packages
+- `mcp-seed.service.ts` - Database seeding for discovered packages
+- `dto/` - Data transfer objects for API validation
+
+## Key Endpoints
+
+- `GET /api/mcp-servers` - List all MCP servers
+- `POST /api/mcp-servers` - Create new MCP server
+- `GET /api/mcp-servers/:id` - Get MCP server details
+- `PUT /api/mcp-servers/:id` - Update MCP server
+- `DELETE /api/mcp-servers/:id` - Delete MCP server
+
+## Key Concepts
+
+- **Server Types**: builtin, custom, remote_http, remote_sse, external
+- **Auto-Discovery**: Scans `mcp-servers/` for packages with `mcpPackage: true`
+- **Registry**: In-memory store of discovered package metadata
+- **Seeding**: Creates database records for discovered packages on startup
+
+## MCP Package Discovery Flow
+
+1. `McpDiscoveryService.onModuleInit()` - Scan dependencies
+2. Filter packages with `mcpPackage: true` in package.json
+3. Import and validate McpPackage interface
+4. Register in `McpRegistry`
+5. `McpSeedService` creates database records

package/src/modules/oauth/AGENTS.md

@@ -0,0 +1,32 @@
+# OAuth Module
+
+## Description
+
+OAuth 2.1 authentication module for MCP servers. Handles authorization flows for MCP servers that require OAuth credentials.
+
+## Contents
+
+- `oauth.module.ts` - Module definition
+- `oauth.controller.ts` - OAuth callback and token endpoints
+- `oauth.service.ts` - OAuth flow management and token storage
+
+## Key Endpoints
+
+- `GET /api/oauth/authorize/:serverId` - Initiate OAuth flow
+- `GET /api/oauth/callback` - OAuth callback handler
+- `POST /api/oauth/refresh/:serverId` - Refresh access token
+
+## Key Concepts
+
+- **OAuth 2.1**: Modern OAuth with PKCE support
+- **DCR**: Dynamic Client Registration for MCP servers
+- **Token Storage**: Encrypted token storage in database
+- **Auto-Refresh**: Automatic token refresh before expiry
+
+## OAuth Flow
+
+1. User initiates authorization for MCP server
+2. Redirect to provider's authorization endpoint
+3. Callback receives authorization code
+4. Exchange code for access/refresh tokens
+5. Store tokens for future MCP calls

package/src/modules/profiles/AGENTS.md

@@ -0,0 +1,33 @@
+# Profiles Module
+
+## Description
+
+Profile management module. Profiles are logical groupings of MCP servers that can be accessed via a single endpoint.
+
+## Contents
+
+- `profiles.module.ts` - Module definition
+- `profiles.controller.ts` - REST API for profile CRUD
+- `profiles.service.ts` - Profile business logic and tool aggregation
+
+## Key Endpoints
+
+- `GET /api/profiles` - List all profiles
+- `POST /api/profiles` - Create new profile
+- `GET /api/profiles/:id` - Get profile details with MCP servers
+- `PUT /api/profiles/:id` - Update profile
+- `DELETE /api/profiles/:id` - Delete profile
+
+## Key Concepts
+
+- **Profile**: Named collection of MCP servers
+- **Endpoint**: Each profile gets `/api/mcp/{slug}` endpoint
+- **Tool Aggregation**: Combines tools from all servers in profile
+- **AI Prompt**: Generates TOON/Markdown prompts for AI integration
+- **Default Profile**: System creates "default" profile on first run
+
+## Profile-MCP Relationship
+
+- Profile has many MCP servers (many-to-many via ProfileMcpServer)
+- Each assignment has order, enabled status, and tool filters
+- Tools can be individually enabled/disabled per profile