@1mcp/agent 0.20.3 → 0.22.0

package/build/utils/presetNotificationService.js

@@ -0,0 +1,214 @@
+import { EventEmitter } from 'events';
+import logger from '../logger/logger.js';
+/**
+ * PresetNotificationService manages client tracking and notifications
+ * when presets are modified. Sends listChanged notifications to affected clients.
+ */
+export class PresetNotificationService extends EventEmitter {
+    static instance;
+    clientsByPreset = new Map();
+    clientsById = new Map();
+    constructor() {
+        super();
+    }
+    static getInstance() {
+        if (!PresetNotificationService.instance) {
+            PresetNotificationService.instance = new PresetNotificationService();
+        }
+        return PresetNotificationService.instance;
+    }
+    /**
+     * Track a client connection with its associated preset
+     */
+    trackClient(client, presetName) {
+        // Store client by ID for quick lookup
+        this.clientsById.set(client.id, client);
+        if (presetName) {
+            // Track client by preset
+            if (!this.clientsByPreset.has(presetName)) {
+                this.clientsByPreset.set(presetName, new Set());
+            }
+            const clientSet = this.clientsByPreset.get(presetName);
+            clientSet.add(client);
+            // Update client's preset association
+            client.presetName = presetName;
+            logger.debug('Client tracked for preset', {
+                clientId: client.id,
+                presetName,
+                totalClientsForPreset: clientSet.size,
+            });
+        }
+        else {
+            logger.debug('Client tracked without preset', { clientId: client.id });
+        }
+        this.emit('client_tracked', { client, presetName });
+    }
+    /**
+     * Untrack a client connection
+     */
+    untrackClient(clientId) {
+        const client = this.clientsById.get(clientId);
+        if (!client) {
+            return;
+        }
+        // Remove from clients by ID
+        this.clientsById.delete(clientId);
+        // Remove from preset tracking if associated
+        if (client.presetName) {
+            const clientSet = this.clientsByPreset.get(client.presetName);
+            if (clientSet) {
+                clientSet.delete(client);
+                // Clean up empty preset sets
+                if (clientSet.size === 0) {
+                    this.clientsByPreset.delete(client.presetName);
+                }
+                logger.debug('Client untracked from preset', {
+                    clientId,
+                    presetName: client.presetName,
+                    remainingClientsForPreset: clientSet.size,
+                });
+            }
+        }
+        this.emit('client_untracked', { clientId, presetName: client.presetName });
+    }
+    /**
+     * Update a client's preset association
+     */
+    updateClientPreset(clientId, newPresetName) {
+        const client = this.clientsById.get(clientId);
+        if (!client) {
+            logger.warn('Attempted to update preset for unknown client', { clientId });
+            return;
+        }
+        const oldPresetName = client.presetName;
+        // Remove from old preset tracking
+        if (oldPresetName) {
+            const oldClientSet = this.clientsByPreset.get(oldPresetName);
+            if (oldClientSet) {
+                oldClientSet.delete(client);
+                if (oldClientSet.size === 0) {
+                    this.clientsByPreset.delete(oldPresetName);
+                }
+            }
+        }
+        // Add to new preset tracking
+        if (newPresetName) {
+            if (!this.clientsByPreset.has(newPresetName)) {
+                this.clientsByPreset.set(newPresetName, new Set());
+            }
+            this.clientsByPreset.get(newPresetName).add(client);
+        }
+        // Update client association
+        client.presetName = newPresetName;
+        logger.debug('Client preset updated', {
+            clientId,
+            oldPresetName,
+            newPresetName,
+        });
+        this.emit('client_preset_updated', { clientId, oldPresetName, newPresetName });
+    }
+    /**
+     * Send listChanged notifications to all clients using a specific preset
+     */
+    async notifyPresetChange(presetName) {
+        const clients = this.clientsByPreset.get(presetName) || new Set();
+        if (clients.size === 0) {
+            logger.debug('No clients to notify for preset change', { presetName });
+            return;
+        }
+        logger.info('Sending preset change notifications', {
+            presetName,
+            clientCount: clients.size,
+        });
+        // Send notifications in parallel
+        const notifications = Array.from(clients).map(async (client) => {
+            if (!client.isConnected()) {
+                logger.debug('Skipping disconnected client', {
+                    clientId: client.id,
+                    presetName,
+                });
+                return;
+            }
+            try {
+                // Send all three types of listChanged notifications
+                await Promise.all([
+                    client.sendNotification('notifications/tools/listChanged'),
+                    client.sendNotification('notifications/resources/listChanged'),
+                    client.sendNotification('notifications/prompts/listChanged'),
+                ]);
+                logger.debug('Preset change notifications sent to client', {
+                    clientId: client.id,
+                    presetName,
+                });
+            }
+            catch (error) {
+                logger.error('Failed to send preset change notification to client', {
+                    clientId: client.id,
+                    presetName,
+                    error,
+                });
+                // If client is no longer reachable, untrack it
+                if (error instanceof Error && (error.message.includes('connection') || error.message.includes('closed'))) {
+                    this.untrackClient(client.id);
+                }
+            }
+        });
+        await Promise.allSettled(notifications);
+        logger.info('Preset change notifications completed', {
+            presetName,
+            clientCount: clients.size,
+        });
+        this.emit('preset_notifications_sent', { presetName, clientCount: clients.size });
+    }
+    /**
+     * Get statistics about tracked clients
+     */
+    getStats() {
+        const clientsByPreset = {};
+        for (const [presetName, clientSet] of this.clientsByPreset) {
+            clientsByPreset[presetName] = clientSet.size;
+        }
+        return {
+            totalClients: this.clientsById.size,
+            presetCount: this.clientsByPreset.size,
+            clientsByPreset,
+        };
+    }
+    /**
+     * Clean up disconnected clients
+     */
+    async cleanup() {
+        let removedCount = 0;
+        for (const [clientId, client] of this.clientsById) {
+            if (!client.isConnected()) {
+                this.untrackClient(clientId);
+                removedCount++;
+            }
+        }
+        if (removedCount > 0) {
+            logger.info('Cleaned up disconnected clients', { removedCount });
+        }
+        return removedCount;
+    }
+    /**
+     * Get clients for a specific preset
+     */
+    getClientsForPreset(presetName) {
+        const clientSet = this.clientsByPreset.get(presetName);
+        return clientSet ? Array.from(clientSet) : [];
+    }
+    /**
+     * Check if a preset has any tracked clients
+     */
+    hasClientsForPreset(presetName) {
+        const clientSet = this.clientsByPreset.get(presetName);
+        return !!(clientSet && clientSet.size > 0);
+    }
+    /**
+     * Get all tracked preset names
+     */
+    getTrackedPresets() {
+        return Array.from(this.clientsByPreset.keys());
+    }
+}
+//# sourceMappingURL=presetNotificationService.js.map

package/build/utils/presetNotificationService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"presetNotificationService.js","sourceRoot":"","sources":["../../src/utils/presetNotificationService.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,MAAM,MAAM,qBAAqB,CAAC;AAYzC;;;GAGG;AACH,MAAM,OAAO,yBAA0B,SAAQ,YAAY;IACjD,MAAM,CAAC,QAAQ,CAA4B;IAC3C,eAAe,GAAG,IAAI,GAAG,EAAiC,CAAC;IAC3D,WAAW,GAAG,IAAI,GAAG,EAA4B,CAAC;IAE1D;QACE,KAAK,EAAE,CAAC;IACV,CAAC;IAEM,MAAM,CAAC,WAAW;QACvB,IAAI,CAAC,yBAAyB,CAAC,QAAQ,EAAE,CAAC;YACxC,yBAAyB,CAAC,QAAQ,GAAG,IAAI,yBAAyB,EAAE,CAAC;QACvE,CAAC;QACD,OAAO,yBAAyB,CAAC,QAAQ,CAAC;IAC5C,CAAC;IAED;;OAEG;IACI,WAAW,CAAC,MAAwB,EAAE,UAAmB;QAC9D,sCAAsC;QACtC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;QAExC,IAAI,UAAU,EAAE,CAAC;YACf,yBAAyB;YACzB,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;gBAC1C,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;YAClD,CAAC;YAED,MAAM,SAAS,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,UAAU,CAAE,CAAC;YACxD,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YAEtB,qCAAqC;YACrC,MAAM,CAAC,UAAU,GAAG,UAAU,CAAC;YAE/B,MAAM,CAAC,KAAK,CAAC,2BAA2B,EAAE;gBACxC,QAAQ,EAAE,MAAM,CAAC,EAAE;gBACnB,UAAU;gBACV,qBAAqB,EAAE,SAAS,CAAC,IAAI;aACtC,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,KAAK,CAAC,+BAA+B,EAAE,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC;QACzE,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;IACtD,CAAC;IAED;;OAEG;IACI,aAAa,CAAC,QAAgB;QACnC,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC9C,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO;QACT,CAAC;QAED,4BAA4B;QAC5B,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAElC,4CAA4C;QAC5C,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;YACtB,MAAM,SAAS,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;YAC9D,IAAI,SAAS,EAAE,CAAC;gBACd,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;gBAEzB,6BAA6B;gBAC7B,IAAI,SAAS,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;oBACzB,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;gBACjD,CAAC;gBAED,MAAM,CAAC,KAAK,CAAC,8BAA8B,EAAE;oBAC3C,QAAQ;oBACR,UAAU,EAAE,MAAM,CAAC,UAAU;oBAC7B,yBAAyB,EAAE,SAAS,CAAC,IAAI;iBAC1C,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,kBAAkB,EAAE,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;IAC7E,CAAC;IAED;;OAEG;IACI,kBAAkB,CAAC,QAAgB,EAAE,aAAsB;QAChE,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC9C,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,CAAC,IAAI,CAAC,+CAA+C,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;YAC3E,OAAO;QACT,CAAC;QAED,MAAM,aAAa,GAAG,MAAM,CAAC,UAAU,CAAC;QAExC,kCAAkC;QAClC,IAAI,aAAa,EAAE,CAAC;YAClB,MAAM,YAAY,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;YAC7D,IAAI,YAAY,EAAE,CAAC;gBACjB,YAAY,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;gBAC5B,IAAI,YAAY,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;oBAC5B,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;gBAC7C,CAAC;YACH,CAAC;QACH,CAAC;QAED,6BAA6B;QAC7B,IAAI,aAAa,EAAE,CAAC;YAClB,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,aAAa,CAAC,EAAE,CAAC;gBAC7C,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,aAAa,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;YACrD,CAAC;YACD,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,aAAa,CAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACvD,CAAC;QAED,4BAA4B;QAC5B,MAAM,CAAC,UAAU,GAAG,aAAa,CAAC;QAElC,MAAM,CAAC,KAAK,CAAC,uBAAuB,EAAE;YACpC,QAAQ;YACR,aAAa;YACb,aAAa;SACd,CAAC,CAAC;QAEH,IAAI,CAAC,IAAI,CAAC,uBAAuB,EAAE,EAAE,QAAQ,EAAE,aAAa,EAAE,aAAa,EAAE,CAAC,CAAC;IACjF,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,kBAAkB,CAAC,UAAkB;QAChD,MAAM,OAAO,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,IAAI,GAAG,EAAE,CAAC;QAElE,IAAI,OAAO,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;YACvB,MAAM,CAAC,KAAK,CAAC,wCAAwC,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC;YACvE,OAAO;QACT,CAAC;QAED,MAAM,CAAC,IAAI,CAAC,qCAAqC,EAAE;YACjD,UAAU;YACV,WAAW,EAAE,OAAO,CAAC,IAAI;SAC1B,CAAC,CAAC;QAEH,iCAAiC;QACjC,MAAM,aAAa,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE;YAC7D,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,EAAE,CAAC;gBAC1B,MAAM,CAAC,KAAK,CAAC,8BAA8B,EAAE;oBAC3C,QAAQ,EAAE,MAAM,CAAC,EAAE;oBACnB,UAAU;iBACX,CAAC,CAAC;gBACH,OAAO;YACT,CAAC;YAED,IAAI,CAAC;gBACH,oDAAoD;gBACpD,MAAM,OAAO,CAAC,GAAG,CAAC;oBAChB,MAAM,CAAC,gBAAgB,CAAC,iCAAiC,CAAC;oBAC1D,MAAM,CAAC,gBAAgB,CAAC,qCAAqC,CAAC;oBAC9D,MAAM,CAAC,gBAAgB,CAAC,mCAAmC,CAAC;iBAC7D,CAAC,CAAC;gBAEH,MAAM,CAAC,KAAK,CAAC,4CAA4C,EAAE;oBACzD,QAAQ,EAAE,MAAM,CAAC,EAAE;oBACnB,UAAU;iBACX,CAAC,CAAC;YACL,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,CAAC,KAAK,CAAC,qDAAqD,EAAE;oBAClE,QAAQ,EAAE,MAAM,CAAC,EAAE;oBACnB,UAAU;oBACV,KAAK;iBACN,CAAC,CAAC;gBAEH,+CAA+C;gBAC/C,IAAI,KAAK,YAAY,KAAK,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC;oBACzG,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;gBAChC,CAAC;YACH,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,MAAM,OAAO,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;QAExC,MAAM,CAAC,IAAI,CAAC,uCAAuC,EAAE;YACnD,UAAU;YACV,WAAW,EAAE,OAAO,CAAC,IAAI;SAC1B,CAAC,CAAC;QAEH,IAAI,CAAC,IAAI,CAAC,2BAA2B,EAAE,EAAE,UAAU,EAAE,WAAW,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IACpF,CAAC;IAED;;OAEG;IACI,QAAQ;QAKb,MAAM,eAAe,GAA2B,EAAE,CAAC;QAEnD,KAAK,MAAM,CAAC,UAAU,EAAE,SAAS,CAAC,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;YAC3D,eAAe,CAAC,UAAU,CAAC,GAAG,SAAS,CAAC,IAAI,CAAC;QAC/C,CAAC;QAED,OAAO;YACL,YAAY,EAAE,IAAI,CAAC,WAAW,CAAC,IAAI;YACnC,WAAW,EAAE,IAAI,CAAC,eAAe,CAAC,IAAI;YACtC,eAAe;SAChB,CAAC;IACJ,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,OAAO;QAClB,IAAI,YAAY,GAAG,CAAC,CAAC;QAErB,KAAK,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YAClD,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,EAAE,CAAC;gBAC1B,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;gBAC7B,YAAY,EAAE,CAAC;YACjB,CAAC;QACH,CAAC;QAED,IAAI,YAAY,GAAG,CAAC,EAAE,CAAC;YACrB,MAAM,CAAC,IAAI,CAAC,iCAAiC,EAAE,EAAE,YAAY,EAAE,CAAC,CAAC;QACnE,CAAC;QAED,OAAO,YAAY,CAAC;IACtB,CAAC;IAED;;OAEG;IACI,mBAAmB,CAAC,UAAkB;QAC3C,MAAM,SAAS,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QACvD,OAAO,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAChD,CAAC;IAED;;OAEG;IACI,mBAAmB,CAAC,UAAkB;QAC3C,MAAM,SAAS,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QACvD,OAAO,CAAC,CAAC,CAAC,SAAS,IAAI,SAAS,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC;IAC7C,CAAC;IAED;;OAEG;IACI,iBAAiB;QACtB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,IAAI,EAAE,CAAC,CAAC;IACjD,CAAC;CACF"}

package/build/utils/presetServerChangeDetector.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Utility for detecting changes in preset server lists
+ * Compares before/after server lists to determine if notifications are needed
+ */
+export interface ServerListChange {
+    hasChanged: boolean;
+    added: string[];
+    removed: string[];
+    unchanged: string[];
+}
+export declare class PresetServerChangeDetector {
+    private previousServerLists;
+    /**
+     * Detect changes between previous and current server lists for a preset
+     */
+    detectChanges(presetName: string, currentServers: string[]): ServerListChange;
+    /**
+     * Update the stored server list for a preset
+     */
+    updateServerList(presetName: string, servers: string[]): void;
+    /**
+     * Get the previously stored server list for a preset
+     */
+    getPreviousServerList(presetName: string): string[];
+    /**
+     * Check if we have stored data for a preset
+     */
+    hasPreset(presetName: string): boolean;
+    /**
+     * Remove tracking for a preset (cleanup when preset is deleted)
+     */
+    removePreset(presetName: string): void;
+    /**
+     * Get all tracked preset names
+     */
+    getTrackedPresets(): string[];
+    /**
+     * Clear all stored server lists (useful for testing)
+     */
+    clear(): void;
+    /**
+     * Get statistics about tracked presets
+     */
+    getStats(): {
+        totalPresets: number;
+        totalUniqueServers: number;
+        serverCounts: Record<string, number>;
+    };
+}
+//# sourceMappingURL=presetServerChangeDetector.d.ts.map

package/build/utils/presetServerChangeDetector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presetServerChangeDetector.d.ts","sourceRoot":"","sources":["../../src/utils/presetServerChangeDetector.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,OAAO,CAAC;IACpB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,qBAAa,0BAA0B;IACrC,OAAO,CAAC,mBAAmB,CAA+B;IAE1D;;OAEG;IACI,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,GAAG,gBAAgB;IA8CpF;;OAEG;IACI,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI;IAIpE;;OAEG;IACI,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE;IAI1D;;OAEG;IACI,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAI7C;;OAEG;IACI,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAI7C;;OAEG;IACI,iBAAiB,IAAI,MAAM,EAAE;IAIpC;;OAEG;IACI,KAAK,IAAI,IAAI;IAIpB;;OAEG;IACI,QAAQ,IAAI;QACjB,YAAY,EAAE,MAAM,CAAC;QACrB,kBAAkB,EAAE,MAAM,CAAC;QAC3B,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KACtC;CAiBF"}

package/build/utils/presetServerChangeDetector.js

@@ -0,0 +1,100 @@
+export class PresetServerChangeDetector {
+    previousServerLists = new Map();
+    /**
+     * Detect changes between previous and current server lists for a preset
+     */
+    detectChanges(presetName, currentServers) {
+        const previousServers = this.previousServerLists.get(presetName);
+        // If no previous data exists, consider it as initialization (no change)
+        if (!previousServers) {
+            return {
+                hasChanged: false,
+                added: [],
+                removed: [],
+                unchanged: [...currentServers].sort(),
+            };
+        }
+        const previousSet = new Set(previousServers);
+        const currentSet = new Set(currentServers);
+        const added = [];
+        const removed = [];
+        const unchanged = [];
+        // Find added servers
+        for (const server of currentServers) {
+            if (!previousSet.has(server)) {
+                added.push(server);
+            }
+            else {
+                unchanged.push(server);
+            }
+        }
+        // Find removed servers
+        for (const server of previousServers) {
+            if (!currentSet.has(server)) {
+                removed.push(server);
+            }
+        }
+        const hasChanged = added.length > 0 || removed.length > 0;
+        return {
+            hasChanged,
+            added: added.sort(),
+            removed: removed.sort(),
+            unchanged: unchanged.sort(),
+        };
+    }
+    /**
+     * Update the stored server list for a preset
+     */
+    updateServerList(presetName, servers) {
+        this.previousServerLists.set(presetName, [...servers].sort());
+    }
+    /**
+     * Get the previously stored server list for a preset
+     */
+    getPreviousServerList(presetName) {
+        return [...(this.previousServerLists.get(presetName) || [])];
+    }
+    /**
+     * Check if we have stored data for a preset
+     */
+    hasPreset(presetName) {
+        return this.previousServerLists.has(presetName);
+    }
+    /**
+     * Remove tracking for a preset (cleanup when preset is deleted)
+     */
+    removePreset(presetName) {
+        this.previousServerLists.delete(presetName);
+    }
+    /**
+     * Get all tracked preset names
+     */
+    getTrackedPresets() {
+        return Array.from(this.previousServerLists.keys()).sort();
+    }
+    /**
+     * Clear all stored server lists (useful for testing)
+     */
+    clear() {
+        this.previousServerLists.clear();
+    }
+    /**
+     * Get statistics about tracked presets
+     */
+    getStats() {
+        const allServers = new Set();
+        const serverCounts = {};
+        for (const [presetName, servers] of this.previousServerLists) {
+            serverCounts[presetName] = servers.length;
+            for (const server of servers) {
+                allServers.add(server);
+            }
+        }
+        return {
+            totalPresets: this.previousServerLists.size,
+            totalUniqueServers: allServers.size,
+            serverCounts,
+        };
+    }
+}
+//# sourceMappingURL=presetServerChangeDetector.js.map

package/build/utils/presetServerChangeDetector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"presetServerChangeDetector.js","sourceRoot":"","sources":["../../src/utils/presetServerChangeDetector.ts"],"names":[],"mappings":"AAWA,MAAM,OAAO,0BAA0B;IAC7B,mBAAmB,GAAG,IAAI,GAAG,EAAoB,CAAC;IAE1D;;OAEG;IACI,aAAa,CAAC,UAAkB,EAAE,cAAwB;QAC/D,MAAM,eAAe,GAAG,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAEjE,wEAAwE;QACxE,IAAI,CAAC,eAAe,EAAE,CAAC;YACrB,OAAO;gBACL,UAAU,EAAE,KAAK;gBACjB,KAAK,EAAE,EAAE;gBACT,OAAO,EAAE,EAAE;gBACX,SAAS,EAAE,CAAC,GAAG,cAAc,CAAC,CAAC,IAAI,EAAE;aACtC,CAAC;QACJ,CAAC;QAED,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,eAAe,CAAC,CAAC;QAC7C,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,cAAc,CAAC,CAAC;QAE3C,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,MAAM,OAAO,GAAa,EAAE,CAAC;QAC7B,MAAM,SAAS,GAAa,EAAE,CAAC;QAE/B,qBAAqB;QACrB,KAAK,MAAM,MAAM,IAAI,cAAc,EAAE,CAAC;YACpC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC7B,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACrB,CAAC;iBAAM,CAAC;gBACN,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACzB,CAAC;QACH,CAAC;QAED,uBAAuB;QACvB,KAAK,MAAM,MAAM,IAAI,eAAe,EAAE,CAAC;YACrC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC5B,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACvB,CAAC;QACH,CAAC;QAED,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;QAE1D,OAAO;YACL,UAAU;YACV,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE;YACnB,OAAO,EAAE,OAAO,CAAC,IAAI,EAAE;YACvB,SAAS,EAAE,SAAS,CAAC,IAAI,EAAE;SAC5B,CAAC;IACJ,CAAC;IAED;;OAEG;IACI,gBAAgB,CAAC,UAAkB,EAAE,OAAiB;QAC3D,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,UAAU,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAChE,CAAC;IAED;;OAEG;IACI,qBAAqB,CAAC,UAAkB;QAC7C,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IAC/D,CAAC;IAED;;OAEG;IACI,SAAS,CAAC,UAAkB;QACjC,OAAO,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IAClD,CAAC;IAED;;OAEG;IACI,YAAY,CAAC,UAAkB;QACpC,IAAI,CAAC,mBAAmB,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAC9C,CAAC;IAED;;OAEG;IACI,iBAAiB;QACtB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,mBAAmB,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC5D,CAAC;IAED;;OAEG;IACI,KAAK;QACV,IAAI,CAAC,mBAAmB,CAAC,KAAK,EAAE,CAAC;IACnC,CAAC;IAED;;OAEG;IACI,QAAQ;QAKb,MAAM,UAAU,GAAG,IAAI,GAAG,EAAU,CAAC;QACrC,MAAM,YAAY,GAA2B,EAAE,CAAC;QAEhD,KAAK,MAAM,CAAC,UAAU,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC,mBAAmB,EAAE,CAAC;YAC7D,YAAY,CAAC,UAAU,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;YAC1C,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;gBAC7B,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YACzB,CAAC;QACH,CAAC;QAED,OAAO;YACL,YAAY,EAAE,IAAI,CAAC,mBAAmB,CAAC,IAAI;YAC3C,kBAAkB,EAAE,UAAU,CAAC,IAAI;YACnC,YAAY;SACb,CAAC;IACJ,CAAC;CACF"}

package/build/utils/presetTypes.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Type definitions for the dynamic preset system
+ */
+export type PresetStrategy = 'or' | 'and' | 'advanced';
+/**
+ * JSON-based tag query for MongoDB-like queries
+ * Examples:
+ * - { "tag": "web" } - servers with "web" tag
+ * - { "$or": [{ "tag": "web" }, { "tag": "api" }] } - servers with "web" OR "api"
+ * - { "$and": [{ "tag": "web" }, { "tag": "secure" }] } - servers with BOTH "web" AND "secure"
+ * - { "tag": { "$in": ["web", "api", "database"] } } - servers with any of these tags
+ */
+export interface TagQuery {
+    tag?: string;
+    $or?: TagQuery[];
+    $and?: TagQuery[];
+    $not?: TagQuery;
+    $in?: string[];
+    [key: string]: any;
+}
+export interface PresetConfig {
+    name: string;
+    description?: string;
+    strategy: PresetStrategy;
+    tagQuery: TagQuery;
+    created: string;
+    lastModified: string;
+    lastUsed?: string;
+}
+export interface PresetStorage {
+    presets: Record<string, PresetConfig>;
+    version?: string;
+}
+export interface PresetValidationResult {
+    isValid: boolean;
+    errors: string[];
+    warnings: string[];
+}
+export interface PresetUsageStats {
+    name: string;
+    serverCount: number;
+    lastUsed?: string;
+    usageFrequency: number;
+}
+export interface PresetListItem {
+    name: string;
+    description?: string;
+    strategy: PresetStrategy;
+    lastUsed?: string;
+    tagQuery: TagQuery;
+}
+//# sourceMappingURL=presetTypes.d.ts.map

package/build/utils/presetTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presetTypes.d.ts","sourceRoot":"","sources":["../../src/utils/presetTypes.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,cAAc,GAAG,IAAI,GAAG,KAAK,GAAG,UAAU,CAAC;AAEvD;;;;;;;GAOG;AACH,MAAM,WAAW,QAAQ;IACvB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,QAAQ,EAAE,CAAC;IACjB,IAAI,CAAC,EAAE,QAAQ,EAAE,CAAC;IAClB,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;IACf,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,cAAc,CAAC;IACzB,QAAQ,EAAE,QAAQ,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,cAAc,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,QAAQ,CAAC;CACpB"}

package/build/utils/presetTypes.js

@@ -0,0 +1,5 @@
+/**
+ * Type definitions for the dynamic preset system
+ */
+export {};
+//# sourceMappingURL=presetTypes.js.map

package/build/utils/presetTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"presetTypes.js","sourceRoot":"","sources":["../../src/utils/presetTypes.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/build/utils/tagQueryEvaluator.d.ts

@@ -0,0 +1,68 @@
+/**
+ * JSON-based tag query evaluator for MongoDB-like queries
+ * Supports three-state tag selection: empty, selected, not selected
+ */
+import { TagQuery } from './presetTypes.js';
+/**
+ * Three-state tag selection states
+ */
+export type TagState = 'empty' | 'selected' | 'not-selected';
+/**
+ * Tag selection entry for three-state system
+ */
+export interface TagSelection {
+    tag: string;
+    state: TagState;
+    servers: string[];
+}
+export declare class TagQueryEvaluator {
+    /**
+     * Evaluate a JSON tag query against a set of server tags
+     */
+    static evaluate(query: TagQuery, serverTags: string[]): boolean;
+    /**
+     * Convert string-based tag expression to JSON query
+     * For backward compatibility with existing presets
+     */
+    static stringToQuery(tagExpression: string, strategy?: 'or' | 'and' | 'advanced'): TagQuery;
+    /**
+     * Convert JSON query to human-readable string
+     */
+    static queryToString(query: TagQuery): string;
+    /**
+     * Validate JSON query structure
+     */
+    static validateQuery(query: TagQuery): {
+        isValid: boolean;
+        errors: string[];
+    };
+    /**
+     * Build tag-to-servers mapping from MCP configuration
+     */
+    static buildTagServerMap(servers: Record<string, any>): Map<string, string[]>;
+    /**
+     * Convert three-state tag selections to TagQuery
+     */
+    static buildQueryFromSelections(selections: TagSelection[], strategy?: 'or' | 'and' | 'advanced'): TagQuery;
+    /**
+     * Get servers that match the current tag selections
+     */
+    static getMatchingServers(selections: TagSelection[], servers: Record<string, any>, strategy?: 'or' | 'and' | 'advanced'): string[];
+    /**
+     * Format server list for display (e.g., "server1, server2 +3 more")
+     */
+    static formatServerList(servers: string[], maxDisplay?: number): string;
+    /**
+     * Cycle tag state: empty -> selected -> not-selected -> empty
+     */
+    static cycleTagState(currentState: TagState): TagState;
+    /**
+     * Get display symbol for tag state
+     */
+    static getTagStateSymbol(state: TagState): string;
+    /**
+     * Get display color for tag state (for terminals that support colors)
+     */
+    static getTagStateColor(state: TagState): string;
+}
+//# sourceMappingURL=tagQueryEvaluator.d.ts.map

package/build/utils/tagQueryEvaluator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tagQueryEvaluator.d.ts","sourceRoot":"","sources":["../../src/utils/tagQueryEvaluator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE5C;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,UAAU,GAAG,cAAc,CAAC;AAE7D;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,QAAQ,CAAC;IAChB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,qBAAa,iBAAiB;IAC5B;;OAEG;WACW,QAAQ,CAAC,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,OAAO;IA0DtE;;;OAGG;WACW,aAAa,CAAC,aAAa,EAAE,MAAM,EAAE,QAAQ,GAAE,IAAI,GAAG,KAAK,GAAG,UAAiB,GAAG,QAAQ;IAqCxG;;OAEG;WACW,aAAa,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM;IAkDpD;;OAEG;WACW,aAAa,CAAC,KAAK,EAAE,QAAQ,GAAG;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE;IAoCpF;;OAEG;WACW,iBAAiB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;IAgBpF;;OAEG;WACW,wBAAwB,CACpC,UAAU,EAAE,YAAY,EAAE,EAC1B,QAAQ,GAAE,IAAI,GAAG,KAAK,GAAG,UAAiB,GACzC,QAAQ;IAqCX;;OAEG;WACW,kBAAkB,CAC9B,UAAU,EAAE,YAAY,EAAE,EAC1B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC5B,QAAQ,GAAE,IAAI,GAAG,KAAK,GAAG,UAAiB,GACzC,MAAM,EAAE;IAWX;;OAEG;WACW,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,UAAU,GAAE,MAAU,GAAG,MAAM;IAcjF;;OAEG;WACW,aAAa,CAAC,YAAY,EAAE,QAAQ,GAAG,QAAQ;IAa7D;;OAEG;WACW,iBAAiB,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM;IAaxD;;OAEG;WACW,gBAAgB,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM;CAYxD"}