@1mcp/agent 0.22.3 → 0.23.1

package/build/core/filtering/filteringService.js

@@ -0,0 +1,253 @@
+import { ClientStatus } from '../types/client.js';
+import { TagQueryParser } from '../../utils/tagQueryParser.js';
+import { TagQueryEvaluator } from '../../utils/tagQueryEvaluator.js';
+import { normalizeTag } from '../../utils/sanitization.js';
+import logger from '../../logger/logger.js';
+/**
+ * Unified filtering service that consolidates all filtering logic across the application.
+ * This service provides a single source of truth for filtering MCP server connections
+ * based on various criteria including tags, capabilities, and advanced expressions.
+ */
+export class FilteringService {
+    /**
+     * Get filtered connections based on inbound connection configuration
+     * This is the main entry point for filtering and should be used by most components
+     *
+     * @param connections Map of outbound connections to filter
+     * @param config Inbound connection configuration containing filter criteria
+     * @returns Filtered map of connections
+     */
+    static getFilteredConnections(connections, config) {
+        logger.debug('FilteringService: Filtering connections', {
+            totalConnections: connections.size,
+            filterMode: config.tagFilterMode,
+            tags: config.tags,
+            hasTagExpression: !!config.tagExpression,
+            hasTagQuery: !!config.tagQuery,
+        });
+        // Only include connected clients in filtering
+        const connectedClients = new Map();
+        for (const [name, connection] of connections) {
+            if (connection.status === ClientStatus.Connected) {
+                connectedClients.set(name, connection);
+            }
+        }
+        logger.debug('FilteringService: Connected clients', {
+            connectedCount: connectedClients.size,
+            connectedNames: Array.from(connectedClients.keys()),
+        });
+        if (!config.tagFilterMode || config.tagFilterMode === 'none') {
+            logger.debug('FilteringService: No filtering specified, returning all connected clients');
+            return connectedClients;
+        }
+        const filter = this.createFilter(config);
+        const filteredConnections = filter(connectedClients);
+        logger.debug('FilteringService: Filtering completed', {
+            filteredCount: filteredConnections.size,
+            filteredNames: Array.from(filteredConnections.keys()),
+        });
+        return filteredConnections;
+    }
+    /**
+     * Create a filter function based on inbound connection configuration
+     *
+     * @param config Inbound connection configuration
+     * @returns Filter function that can be applied to connections
+     */
+    static createFilter(config) {
+        if (config.tagFilterMode === 'preset' && config.tagQuery) {
+            return this.byTagQuery(config.tagQuery);
+        }
+        else if (config.tagFilterMode === 'advanced' && config.tagExpression) {
+            return this.byTagExpression(config.tagExpression);
+        }
+        else if (config.tagFilterMode === 'simple-or' || config.tags) {
+            return this.byTags(config.tags);
+        }
+        else {
+            // No filtering - return function that passes all clients through
+            return this.byTags(undefined);
+        }
+    }
+    /**
+     * Filter connections by tags using OR logic
+     * If no tags are provided, all connections are returned
+     *
+     * @param tags Array of tags to filter by
+     * @returns Filter function
+     */
+    static byTags(tags) {
+        return (connections) => {
+            logger.debug(`FilteringService.byTags: Filtering for tags: ${tags ? tags.join(', ') : 'none'}`);
+            if (!tags || tags.length === 0) {
+                logger.debug('FilteringService.byTags: No tags specified, returning all connections');
+                return connections;
+            }
+            // Normalize the filter tags for consistent comparison
+            const normalizedFilterTags = tags.map((tag) => normalizeTag(tag));
+            return Array.from(connections.entries()).reduce((filtered, [name, connection]) => {
+                const clientTags = connection.transport.tags || [];
+                // Normalize client tags for comparison
+                const normalizedClientTags = clientTags.map((tag) => normalizeTag(tag));
+                const hasMatchingTags = normalizedClientTags.some((clientTag) => normalizedFilterTags.includes(clientTag));
+                logger.debug(`FilteringService.byTags: Connection ${name}`, {
+                    clientTags,
+                    normalizedClientTags,
+                    requiredTags: tags,
+                    normalizedRequiredTags: normalizedFilterTags,
+                    hasMatchingTags,
+                });
+                if (hasMatchingTags) {
+                    filtered.set(name, connection);
+                }
+                return filtered;
+            }, new Map());
+        };
+    }
+    /**
+     * Filter connections by advanced tag expression
+     *
+     * @param expression Parsed tag expression to evaluate
+     * @returns Filter function
+     */
+    static byTagExpression(expression) {
+        return (connections) => {
+            logger.debug(`FilteringService.byTagExpression: Filtering with expression: ${TagQueryParser.expressionToString(expression)}`);
+            return Array.from(connections.entries()).reduce((filtered, [name, connection]) => {
+                const clientTags = connection.transport.tags || [];
+                const matches = TagQueryParser.evaluate(expression, clientTags);
+                logger.debug(`FilteringService.byTagExpression: Connection ${name}`, {
+                    clientTags,
+                    expression: TagQueryParser.expressionToString(expression),
+                    matches,
+                });
+                if (matches) {
+                    filtered.set(name, connection);
+                }
+                return filtered;
+            }, new Map());
+        };
+    }
+    /**
+     * Filter connections by MongoDB-style tag query
+     *
+     * @param query Tag query to evaluate
+     * @returns Filter function
+     */
+    static byTagQuery(query) {
+        return (connections) => {
+            logger.debug('FilteringService.byTagQuery: Filtering with tag query', { query });
+            const filtered = new Map();
+            for (const [name, connection] of connections.entries()) {
+                if (connection.status !== ClientStatus.Connected) {
+                    continue;
+                }
+                const clientTags = connection.transport.tags || [];
+                try {
+                    if (TagQueryEvaluator.evaluate(query, clientTags)) {
+                        filtered.set(name, connection);
+                        logger.debug(`FilteringService.byTagQuery: Connection ${name} matches query`, {
+                            clientTags,
+                            query,
+                        });
+                    }
+                }
+                catch (error) {
+                    logger.warn(`FilteringService.byTagQuery: Failed to evaluate query for connection ${name}`, {
+                        error: error instanceof Error ? error.message : 'Unknown error',
+                        clientTags,
+                        query,
+                    });
+                }
+            }
+            return filtered;
+        };
+    }
+    /**
+     * Filter connections by server capabilities
+     *
+     * @param requiredCapabilities Capabilities that must be present
+     * @returns Filter function
+     */
+    static byCapabilities(requiredCapabilities) {
+        return (connections) => {
+            const requiredCaps = Object.keys(requiredCapabilities);
+            logger.debug(`FilteringService.byCapabilities: Filtering for capabilities: ${requiredCaps.join(', ')}`);
+            return Array.from(connections.entries()).reduce((filtered, [name, connection]) => {
+                const clientCaps = connection.capabilities ? Object.keys(connection.capabilities) : [];
+                const hasCapabilities = requiredCaps.every((cap) => connection.capabilities && cap in connection.capabilities);
+                logger.debug(`FilteringService.byCapabilities: Connection ${name}`, {
+                    clientCapabilities: clientCaps,
+                    requiredCapabilities: requiredCaps,
+                    hasCapabilities,
+                    clientCapabilitiesObject: connection.capabilities,
+                });
+                if (hasCapabilities) {
+                    filtered.set(name, connection);
+                }
+                return filtered;
+            }, new Map());
+        };
+    }
+    /**
+     * Combine multiple filters using AND logic
+     * All filters must pass for a connection to be included
+     *
+     * @param filters Array of filter functions to combine
+     * @returns Combined filter function
+     */
+    static combineFilters(...filters) {
+        return (connections) => {
+            logger.debug(`FilteringService.combineFilters: Starting with ${connections.size} connections`, {
+                connectionNames: Array.from(connections.keys()),
+                filterCount: filters.length,
+            });
+            const result = filters.reduce((filteredConnections, filter, index) => {
+                const beforeCount = filteredConnections.size;
+                const afterFiltering = filter(filteredConnections);
+                const afterCount = afterFiltering.size;
+                logger.debug(`FilteringService.combineFilters: Filter ${index} reduced connections from ${beforeCount} to ${afterCount}`, {
+                    beforeNames: Array.from(filteredConnections.keys()),
+                    afterNames: Array.from(afterFiltering.keys()),
+                });
+                return afterFiltering;
+            }, connections);
+            logger.debug(`FilteringService.combineFilters: Final result has ${result.size} connections`, {
+                finalNames: Array.from(result.keys()),
+            });
+            return result;
+        };
+    }
+    /**
+     * Get a summary of filtering results for logging and debugging
+     *
+     * @param originalConnections Original connection map before filtering
+     * @param filteredConnections Filtered connection map after filtering
+     * @param config Filter configuration used
+     * @returns Summary object with filtering statistics
+     */
+    static getFilteringSummary(originalConnections, filteredConnections, config) {
+        const originalNames = Array.from(originalConnections.keys());
+        const filteredNames = Array.from(filteredConnections.keys());
+        const removedNames = originalNames.filter((name) => !filteredNames.includes(name));
+        let filterType = 'none';
+        if (config.tagFilterMode === 'preset') {
+            filterType = 'preset';
+        }
+        else if (config.tagFilterMode === 'advanced') {
+            filterType = 'advanced';
+        }
+        else if (config.tagFilterMode === 'simple-or' || config.tags) {
+            filterType = 'simple-or';
+        }
+        return {
+            original: originalConnections.size,
+            filtered: filteredConnections.size,
+            removed: removedNames.length,
+            filterType,
+            filteredNames: filteredNames.sort(),
+            removedNames: removedNames.sort(),
+        };
+    }
+}
+//# sourceMappingURL=filteringService.js.map

package/build/core/filtering/filteringService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filteringService.js","sourceRoot":"","sources":["../../../src/core/filtering/filteringService.ts"],"names":[],"mappings":"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"}

package/build/core/instructions/instructionAggregator.d.ts

@@ -0,0 +1,107 @@
+import { EventEmitter } from 'events';
+import { OutboundConnections, InboundConnectionConfig } from '../types/index.js';
+/**
+ * Events emitted by InstructionAggregator
+ */
+export interface InstructionAggregatorEvents {
+    'instructions-changed': () => void;
+}
+/**
+ * Aggregates instructions from multiple MCP servers into a single instruction string.
+ * Provides both simple concatenation and filtered instructions with educational templates.
+ * The aggregator acts as an educational prompt to help LLMs understand 1MCP better.
+ *
+ * @example
+ * ```typescript
+ * const aggregator = new InstructionAggregator();
+ * aggregator.on('instructions-changed', () => {
+ *   // Server instructions have changed
+ * });
+ *
+ * // When server comes online
+ * aggregator.setInstructions('server1', 'Server 1 instructions');
+ *
+ * // Get filtered instructions for a client
+ * const filtered = aggregator.getFilteredInstructions(config, connections);
+ * ```
+ */
+export declare class InstructionAggregator extends EventEmitter {
+    private serverInstructions;
+    private isInitialized;
+    constructor();
+    /**
+     * Set or update instructions for a specific server
+     * @param serverName The name of the server
+     * @param instructions The instruction string from the server, or undefined to remove
+     */
+    setInstructions(serverName: string, instructions: string | undefined): void;
+    /**
+     * Remove instructions for a specific server
+     * @param serverName The name of the server to remove
+     */
+    removeServer(serverName: string): void;
+    /**
+     * Get filtered instructions for a specific client based on their configuration
+     * This is the main method that should be used by server connections
+     *
+     * @param config Client's inbound connection configuration
+     * @param connections All available outbound connections
+     * @returns Formatted instruction string with educational template or custom template
+     */
+    getFilteredInstructions(config: InboundConnectionConfig, connections: OutboundConnections): string;
+    /**
+     * Get the number of servers that have provided instructions
+     * @returns The count of servers with instructions
+     */
+    getServerCount(): number;
+    /**
+     * Get a list of server names that have provided instructions
+     * @returns Array of server names
+     */
+    getServerNames(): string[];
+    /**
+     * Check if a specific server has instructions
+     * @param serverName The server name to check
+     * @returns True if the server has instructions
+     */
+    hasInstructions(serverName: string): boolean;
+    /**
+     * Get instructions for a specific server
+     * @param serverName The server name
+     * @returns The instructions for the server, or undefined if not found
+     */
+    getServerInstructions(serverName: string): string | undefined;
+    /**
+     * Clear all instructions (useful for testing)
+     */
+    clear(): void;
+    /**
+     * Get filter context description for the template
+     */
+    private getFilterContext;
+    /**
+     * Get a summary of current instruction state for logging
+     */
+    getSummary(): string;
+    /**
+     * Render a Handlebars template with template variables
+     * @param template Template string (custom or default)
+     * @param filteredConnections Filtered server connections
+     * @param config Client configuration
+     * @returns Rendered template string
+     */
+    private renderTemplate;
+    /**
+     * Generate template variables for rendering
+     * @param filteredConnections Filtered server connections
+     * @param config Client configuration
+     * @returns Template variables object
+     */
+    private generateTemplateVariables;
+    /**
+     * Cleanup method to remove all event listeners
+     * Should be called when the aggregator is no longer needed
+     */
+    cleanup(): void;
+}
+//# sourceMappingURL=instructionAggregator.d.ts.map

package/build/core/instructions/instructionAggregator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instructionAggregator.d.ts","sourceRoot":"","sources":["../../../src/core/instructions/instructionAggregator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAItC,OAAO,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAQjF;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,sBAAsB,EAAE,MAAM,IAAI,CAAC;CACpC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,qBAAsB,SAAQ,YAAY;IACrD,OAAO,CAAC,kBAAkB,CAA6B;IACvD,OAAO,CAAC,aAAa,CAAkB;;IAOvC;;;;OAIG;IACI,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAuBlF;;;OAGG;IACI,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAU7C;;;;;;;OAOG;IACI,uBAAuB,CAAC,MAAM,EAAE,uBAAuB,EAAE,WAAW,EAAE,mBAAmB,GAAG,MAAM;IAsCzG;;;OAGG;IACI,cAAc,IAAI,MAAM;IAI/B;;;OAGG;IACI,cAAc,IAAI,MAAM,EAAE;IAIjC;;;;OAIG;IACI,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAInD;;;;OAIG;IACI,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAIpE;;OAEG;IACI,KAAK,IAAI,IAAI;IAUpB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAoBxB;;OAEG;IACI,UAAU,IAAI,MAAM;IAM3B;;;;;;OAMG;IACH,OAAO,CAAC,cAAc;IAoCtB;;;;;OAKG;IACH,OAAO,CAAC,yBAAyB;IA2DjC;;;OAGG;IACI,OAAO,IAAI,IAAI;CAcvB"}

package/build/core/instructions/instructionAggregator.js

@@ -0,0 +1,277 @@
+import { EventEmitter } from 'events';
+import Handlebars from 'handlebars';
+import logger from '../../logger/logger.js';
+import { FilteringService } from '../filtering/filteringService.js';
+import { DEFAULT_TEMPLATE_CONFIG, DEFAULT_INSTRUCTION_TEMPLATE, } from './templateTypes.js';
+/**
+ * Aggregates instructions from multiple MCP servers into a single instruction string.
+ * Provides both simple concatenation and filtered instructions with educational templates.
+ * The aggregator acts as an educational prompt to help LLMs understand 1MCP better.
+ *
+ * @example
+ * ```typescript
+ * const aggregator = new InstructionAggregator();
+ * aggregator.on('instructions-changed', () => {
+ *   // Server instructions have changed
+ * });
+ *
+ * // When server comes online
+ * aggregator.setInstructions('server1', 'Server 1 instructions');
+ *
+ * // Get filtered instructions for a client
+ * const filtered = aggregator.getFilteredInstructions(config, connections);
+ * ```
+ */
+export class InstructionAggregator extends EventEmitter {
+    serverInstructions = new Map();
+    isInitialized = false;
+    constructor() {
+        super();
+        this.setMaxListeners(50);
+    }
+    /**
+     * Set or update instructions for a specific server
+     * @param serverName The name of the server
+     * @param instructions The instruction string from the server, or undefined to remove
+     */
+    setInstructions(serverName, instructions) {
+        const previousInstructions = this.serverInstructions.get(serverName);
+        const hasChanges = previousInstructions !== instructions;
+        if (instructions?.trim()) {
+            this.serverInstructions.set(serverName, instructions.trim());
+            logger.debug(`Updated instructions for server: ${serverName}`);
+        }
+        else {
+            this.serverInstructions.delete(serverName);
+            logger.debug(`Removed instructions for server: ${serverName}`);
+        }
+        if (!this.isInitialized) {
+            this.isInitialized = true;
+            logger.debug('InstructionAggregator initialized');
+        }
+        if (hasChanges) {
+            logger.info(`Instructions changed. Total servers with instructions: ${this.serverInstructions.size}`);
+            this.emit('instructions-changed');
+        }
+    }
+    /**
+     * Remove instructions for a specific server
+     * @param serverName The name of the server to remove
+     */
+    removeServer(serverName) {
+        const hadInstructions = this.serverInstructions.has(serverName);
+        this.serverInstructions.delete(serverName);
+        if (hadInstructions) {
+            logger.info(`Removed server instructions: ${serverName}. Remaining servers: ${this.serverInstructions.size}`);
+            this.emit('instructions-changed');
+        }
+    }
+    /**
+     * Get filtered instructions for a specific client based on their configuration
+     * This is the main method that should be used by server connections
+     *
+     * @param config Client's inbound connection configuration
+     * @param connections All available outbound connections
+     * @returns Formatted instruction string with educational template or custom template
+     */
+    getFilteredInstructions(config, connections) {
+        logger.debug('InstructionAggregator: Getting filtered instructions', {
+            filterMode: config.tagFilterMode,
+            totalConnections: connections.size,
+            totalInstructions: this.serverInstructions.size,
+            hasCustomTemplate: !!config.customTemplate,
+        });
+        // Filter connections based on client configuration
+        const filteredConnections = FilteringService.getFilteredConnections(connections, config);
+        // Get filtering summary for logging
+        const filteringSummary = FilteringService.getFilteringSummary(connections, filteredConnections, config);
+        logger.info('InstructionAggregator: Filtering applied', filteringSummary);
+        // Try custom template first, fall back to default if it fails
+        if (config.customTemplate) {
+            logger.info('InstructionAggregator: Trying custom template', { templateLength: config.customTemplate.length });
+            try {
+                return this.renderTemplate(config.customTemplate, filteredConnections, config);
+            }
+            catch (error) {
+                const errorMessage = error instanceof Error ? error.message : String(error);
+                // Log detailed error for debugging
+                logger.error('InstructionAggregator: Custom template failed, falling back to default template', {
+                    error: errorMessage,
+                    templateLength: config.customTemplate.length,
+                });
+                // Fall back to default template
+                return this.renderTemplate(DEFAULT_INSTRUCTION_TEMPLATE, filteredConnections, config);
+            }
+        }
+        else {
+            // Use default template directly
+            return this.renderTemplate(DEFAULT_INSTRUCTION_TEMPLATE, filteredConnections, config);
+        }
+    }
+    /**
+     * Get the number of servers that have provided instructions
+     * @returns The count of servers with instructions
+     */
+    getServerCount() {
+        return this.serverInstructions.size;
+    }
+    /**
+     * Get a list of server names that have provided instructions
+     * @returns Array of server names
+     */
+    getServerNames() {
+        return Array.from(this.serverInstructions.keys()).sort();
+    }
+    /**
+     * Check if a specific server has instructions
+     * @param serverName The server name to check
+     * @returns True if the server has instructions
+     */
+    hasInstructions(serverName) {
+        return this.serverInstructions.has(serverName);
+    }
+    /**
+     * Get instructions for a specific server
+     * @param serverName The server name
+     * @returns The instructions for the server, or undefined if not found
+     */
+    getServerInstructions(serverName) {
+        return this.serverInstructions.get(serverName);
+    }
+    /**
+     * Clear all instructions (useful for testing)
+     */
+    clear() {
+        const hadInstructions = this.serverInstructions.size > 0;
+        this.serverInstructions.clear();
+        if (hadInstructions) {
+            logger.debug('Cleared all server instructions');
+            this.emit('instructions-changed');
+        }
+    }
+    /**
+     * Get filter context description for the template
+     */
+    getFilterContext(config) {
+        if (!config.tagFilterMode || config.tagFilterMode === 'none') {
+            return '';
+        }
+        if (config.tagFilterMode === 'simple-or' && config.tags?.length) {
+            return ` (filtered by tags: ${config.tags.join(', ')})`;
+        }
+        if (config.tagFilterMode === 'advanced' && config.tagExpression) {
+            return ' (filtered by advanced expression)';
+        }
+        if (config.tagFilterMode === 'preset') {
+            return ' (filtered by preset)';
+        }
+        return ' (filtered)';
+    }
+    /**
+     * Get a summary of current instruction state for logging
+     */
+    getSummary() {
+        const serverCount = this.serverInstructions.size;
+        const serverNames = this.getServerNames();
+        return `${serverCount} servers with instructions: ${serverNames.join(', ')}`;
+    }
+    /**
+     * Render a Handlebars template with template variables
+     * @param template Template string (custom or default)
+     * @param filteredConnections Filtered server connections
+     * @param config Client configuration
+     * @returns Rendered template string
+     */
+    renderTemplate(template, filteredConnections, config) {
+        // Validate template size before processing
+        // Priority: config > default
+        const templateSizeLimit = config.templateSizeLimit || DEFAULT_TEMPLATE_CONFIG.templateSizeLimit;
+        if (template.length > templateSizeLimit) {
+            const sizeMB = (template.length / 1024 / 1024).toFixed(1);
+            const limitMB = (templateSizeLimit / 1024 / 1024).toFixed(1);
+            throw new Error(`Template too large: ${sizeMB}MB (max ${limitMB}MB). ` +
+                'Consider splitting into smaller files or removing unnecessary content. ' +
+                'Large templates can cause memory issues and slow performance.');
+        }
+        // Compile template directly
+        const compiledTemplate = Handlebars.compile(template, { noEscape: true });
+        // Generate template variables
+        const variables = this.generateTemplateVariables(filteredConnections, config);
+        // Render template
+        const rendered = compiledTemplate(variables);
+        logger.debug('InstructionAggregator: Template rendered successfully', {
+            templateLength: template.length,
+            variableCount: Object.keys(variables).length,
+            renderedLength: rendered.length,
+        });
+        return rendered;
+    }
+    /**
+     * Generate template variables for rendering
+     * @param filteredConnections Filtered server connections
+     * @param config Client configuration
+     * @returns Template variables object
+     */
+    generateTemplateVariables(filteredConnections, config) {
+        // Get server data for both arrays and individual server objects
+        const availableServers = [];
+        const serverInstructionSections = [];
+        const servers = [];
+        // Sort filtered connections by name for consistent output
+        const sortedConnections = Array.from(filteredConnections.entries()).sort(([a], [b]) => a.localeCompare(b));
+        for (const [serverName, _connection] of sortedConnections) {
+            const serverInstructions = this.serverInstructions.get(serverName);
+            if (serverInstructions?.trim()) {
+                availableServers.push(serverName);
+                serverInstructionSections.push(`<${serverName}>\n${serverInstructions.trim()}\n</${serverName}>`);
+                // Add individual server data for iteration
+                servers.push({
+                    name: serverName,
+                    instructions: serverInstructions.trim(),
+                    hasInstructions: true,
+                });
+            }
+        }
+        const serverCount = availableServers.length;
+        const hasServers = serverCount > 0;
+        // Merge configuration with defaults
+        const templateConfig = {
+            ...DEFAULT_TEMPLATE_CONFIG,
+            title: config.title || DEFAULT_TEMPLATE_CONFIG.title,
+            toolPattern: config.toolPattern || DEFAULT_TEMPLATE_CONFIG.toolPattern,
+            examples: config.examples || DEFAULT_TEMPLATE_CONFIG.examples,
+        };
+        return {
+            // Server state
+            serverCount,
+            hasServers,
+            serverList: availableServers.join('\n'),
+            serverNames: availableServers,
+            servers,
+            pluralServers: serverCount === 1 ? 'server' : 'servers',
+            isAre: serverCount === 1 ? 'is' : 'are',
+            // Content
+            instructions: serverInstructionSections.join('\n\n'),
+            filterContext: this.getFilterContext(config),
+            // Configuration
+            toolPattern: templateConfig.toolPattern,
+            title: templateConfig.title,
+            examples: templateConfig.examples,
+        };
+    }
+    /**
+     * Cleanup method to remove all event listeners
+     * Should be called when the aggregator is no longer needed
+     */
+    cleanup() {
+        logger.debug('InstructionAggregator: Starting cleanup');
+        // Clear all event listeners
+        this.removeAllListeners();
+        // Clear server instructions
+        this.serverInstructions.clear();
+        // Reset initialization state
+        this.isInitialized = false;
+        logger.info('InstructionAggregator: Cleanup completed - all listeners cleared');
+    }
+}
+//# sourceMappingURL=instructionAggregator.js.map

package/build/core/instructions/instructionAggregator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instructionAggregator.js","sourceRoot":"","sources":["../../../src/core/instructions/instructionAggregator.ts"],"names":[],"mappings":"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"}