@1mcp/agent 0.28.0 → 0.29.0-beta1

package/build/core/filtering/templateFilteringService.js

@@ -0,0 +1,293 @@
+import { TagQueryEvaluator } from '../../domains/preset/parsers/tagQueryEvaluator.js';
+import { TagQueryParser } from '../../domains/preset/parsers/tagQueryParser.js';
+import logger, { debugIf } from '../../logger/logger.js';
+import { normalizeTag } from '../../utils/validation/sanitization.js';
+/**
+ * Service for filtering MCP template configurations based on tags, presets, and advanced expressions
+ * This follows the same patterns as FilteringService but works with template configs instead of connections
+ */
+export class TemplateFilteringService {
+    /**
+     * Filter template configurations based on connection options
+     *
+     * @param templates Array of template configurations
+     * @param config Connection configuration with filter criteria
+     * @returns Filtered array of template configurations
+     */
+    static getMatchingTemplates(templates, config) {
+        debugIf(() => ({
+            message: 'TemplateFilteringService: Filtering templates',
+            meta: {
+                totalTemplates: templates.length,
+                filterMode: config.tagFilterMode,
+                tags: config.tags,
+                hasTagExpression: !!config.tagExpression,
+                hasTagQuery: !!config.tagQuery,
+                presetName: config.presetName,
+            },
+        }));
+        const filterOptions = this.extractFilterOptions(config);
+        // Check for preset name filtering first (highest priority)
+        if (filterOptions.presetName) {
+            debugIf(() => ({
+                message: `TemplateFilteringService: Filtering by preset: ${filterOptions.presetName}`,
+                meta: { presetName: filterOptions.presetName },
+            }));
+            // If we have a tagQuery from the preset, use it instead of simple preset name matching
+            if (config.tagQuery) {
+                debugIf(() => ({
+                    message: `TemplateFilteringService: Using preset tag query for filtering`,
+                    meta: { presetName: filterOptions.presetName, tagQuery: config.tagQuery },
+                }));
+                return this.byTagQuery(config.tagQuery)(templates);
+            }
+            else {
+                // Fallback to simple preset name matching for backward compatibility
+                return this.byPreset(filterOptions.presetName)(templates);
+            }
+        }
+        if (!filterOptions.mode || filterOptions.mode === 'none') {
+            debugIf('TemplateFilteringService: No filtering specified, returning all templates');
+            return templates;
+        }
+        const filter = this.createFilter(filterOptions);
+        const filteredTemplates = filter(templates);
+        debugIf(() => ({
+            message: 'TemplateFilteringService: Filtering completed',
+            meta: {
+                originalCount: templates.length,
+                filteredCount: filteredTemplates.length,
+                removedCount: templates.length - filteredTemplates.length,
+                filteredNames: filteredTemplates.map(([name]) => name),
+            },
+        }));
+        return filteredTemplates;
+    }
+    /**
+     * Extract filter options from connection configuration
+     */
+    static extractFilterOptions(config) {
+        return {
+            presetName: config.presetName,
+            tags: config.tags,
+            tagExpression: config.tagExpression,
+            tagQuery: config.tagQuery,
+            mode: config.tagFilterMode,
+        };
+    }
+    /**
+     * Create a filter function based on filter options
+     */
+    static createFilter(options) {
+        // Preset filtering has highest priority
+        if (options.presetName) {
+            return this.byPreset(options.presetName);
+        }
+        else if (options.mode === 'preset' && options.tagQuery) {
+            return this.byTagQuery(options.tagQuery);
+        }
+        else if (options.mode === 'advanced' && options.tagExpression) {
+            return this.byTagExpression(options.tagExpression);
+        }
+        else if (options.mode === 'simple-or' || options.tags) {
+            return this.byTags(options.tags);
+        }
+        else {
+            // No filtering - return all templates
+            return this.byTags(undefined);
+        }
+    }
+    /**
+     * Filter templates by tags using OR logic (backward compatible)
+     */
+    static byTags(tags) {
+        return (templates) => {
+            debugIf(() => ({
+                message: `TemplateFilteringService.byTags: Filtering for tags: ${tags ? tags.join(', ') : 'none'}`,
+                meta: { tags },
+            }));
+            if (!tags || tags.length === 0) {
+                debugIf('TemplateFilteringService.byTags: No tags specified, returning all templates');
+                return templates;
+            }
+            // Normalize the filter tags for consistent comparison
+            const normalizedFilterTags = tags.map((tag) => normalizeTag(tag));
+            return templates.filter(([name, config]) => {
+                const templateTags = config.tags || [];
+                // Normalize template tags for comparison
+                const normalizedTemplateTags = templateTags.map((tag) => normalizeTag(tag));
+                const hasMatchingTags = normalizedTemplateTags.some((templateTag) => normalizedFilterTags.includes(templateTag));
+                debugIf(() => ({
+                    message: `TemplateFilteringService.byTags: Template ${name}`,
+                    meta: {
+                        templateTags,
+                        normalizedTemplateTags,
+                        requiredTags: tags,
+                        normalizedRequiredTags: normalizedFilterTags,
+                        hasMatchingTags,
+                    },
+                }));
+                return hasMatchingTags;
+            });
+        };
+    }
+    /**
+     * Filter templates by preset name (exact match)
+     */
+    static byPreset(presetName) {
+        return (templates) => {
+            debugIf(() => ({
+                message: `TemplateFilteringService.byPreset: Filtering for preset: ${presetName}`,
+                meta: { presetName },
+            }));
+            return templates.filter(([name, config]) => {
+                const templateTags = config.tags || [];
+                const hasPresetTag = templateTags.includes(presetName);
+                debugIf(() => ({
+                    message: `TemplateFilteringService.byPreset: Template ${name}`,
+                    meta: {
+                        templateTags,
+                        presetName,
+                        hasPresetTag,
+                    },
+                }));
+                return hasPresetTag;
+            });
+        };
+    }
+    /**
+     * Filter templates by advanced tag expression
+     */
+    static byTagExpression(expression) {
+        return (templates) => {
+            debugIf(() => ({
+                message: `TemplateFilteringService.byTagExpression: Filtering with expression: ${expression}`,
+                meta: { expression },
+            }));
+            let parsedExpression;
+            if (typeof expression === 'string') {
+                try {
+                    parsedExpression = TagQueryParser.parseAdvanced(expression);
+                }
+                catch (error) {
+                    logger.warn(`TemplateFilteringService.byTagExpression: Failed to parse expression: ${expression}`, {
+                        error: error instanceof Error ? error.message : 'Unknown error',
+                        expression,
+                    });
+                    return templates; // Return all templates on parse error
+                }
+            }
+            else {
+                parsedExpression = expression; // Use TagExpression directly
+            }
+            return templates.filter(([name, config]) => {
+                const templateTags = config.tags || [];
+                const matches = TagQueryParser.evaluate(parsedExpression, templateTags);
+                debugIf(() => ({
+                    message: `TemplateFilteringService.byTagExpression: Template ${name}`,
+                    meta: {
+                        templateTags,
+                        expression: TagQueryParser.expressionToString(parsedExpression),
+                        matches,
+                    },
+                }));
+                return matches;
+            });
+        };
+    }
+    /**
+     * Filter templates by MongoDB-style tag query
+     */
+    static byTagQuery(query) {
+        return (templates) => {
+            debugIf(() => ({
+                message: 'TemplateFilteringService.byTagQuery: Filtering with tag query',
+                meta: { query },
+            }));
+            return templates.filter(([name, config]) => {
+                const templateTags = config.tags || [];
+                try {
+                    const matches = TagQueryEvaluator.evaluate(query, templateTags);
+                    debugIf(() => ({
+                        message: `TemplateFilteringService.byTagQuery: Template ${name} ${matches ? 'matches' : 'does not match'} query`,
+                        meta: {
+                            templateTags,
+                            query,
+                            matches,
+                        },
+                    }));
+                    return matches;
+                }
+                catch (error) {
+                    logger.warn(`TemplateFilteringService.byTagQuery: Failed to evaluate query for template ${name}`, {
+                        error: error instanceof Error ? error.message : 'Unknown error',
+                        templateTags,
+                        query,
+                    });
+                    return false; // Exclude template on evaluation error
+                }
+            });
+        };
+    }
+    /**
+     * Combine multiple template filters using AND logic
+     */
+    static combineFilters(...filters) {
+        return (templates) => {
+            debugIf(() => ({
+                message: `TemplateFilteringService.combineFilters: Starting with ${templates.length} templates`,
+                meta: {
+                    templateNames: templates.map(([name]) => name),
+                    filterCount: filters.length,
+                },
+            }));
+            const result = filters.reduce((remainingTemplates, filter, index) => {
+                const beforeCount = remainingTemplates.length;
+                const afterFiltering = filter(remainingTemplates);
+                const afterCount = afterFiltering.length;
+                debugIf(() => ({
+                    message: `TemplateFilteringService.combineFilters: Filter ${index} reduced templates from ${beforeCount} to ${afterCount}`,
+                    meta: {
+                        beforeNames: remainingTemplates.map(([name]) => name),
+                        afterNames: afterFiltering.map(([name]) => name),
+                    },
+                }));
+                return afterFiltering;
+            }, templates);
+            debugIf(() => ({
+                message: `TemplateFilteringService.combineFilters: Final result has ${result.length} templates`,
+                meta: {
+                    finalNames: result.map(([name]) => name),
+                },
+            }));
+            return result;
+        };
+    }
+    /**
+     * Get a summary of filtering results for logging and debugging
+     */
+    static getFilteringSummary(originalTemplates, filteredTemplates, options) {
+        const originalNames = originalTemplates.map(([name]) => name);
+        const filteredNames = filteredTemplates.map(([name]) => name);
+        const removedNames = originalNames.filter((name) => !filteredNames.includes(name));
+        let filterType = 'none';
+        if (options.mode === 'preset') {
+            filterType = 'preset';
+        }
+        else if (options.mode === 'advanced') {
+            filterType = 'advanced';
+        }
+        else if (options.mode === 'simple-or' || options.tags) {
+            filterType = 'simple-or';
+        }
+        return {
+            original: originalTemplates.length,
+            filtered: filteredTemplates.length,
+            removed: removedNames.length,
+            filterType,
+            filteredNames: filteredNames.sort(),
+            removedNames: removedNames.sort(),
+        };
+    }
+}
+//# sourceMappingURL=templateFilteringService.js.map

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

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

package/build/core/filtering/templateIndex.d.ts

@@ -0,0 +1,132 @@
+import { MCPServerParams } from '../../core/types/index.js';
+import { TagQuery } from '../../domains/preset/types/presetTypes.js';
+/**
+ * Template index entry with metadata
+ */
+interface TemplateIndexEntry {
+    name: string;
+    config: MCPServerParams;
+    tags: Set<string>;
+    normalizedTags: Set<string>;
+    tagCount: number;
+}
+/**
+ * Index statistics
+ */
+export interface IndexStats {
+    totalTemplates: number;
+    totalTags: number;
+    uniqueTags: number;
+    averageTagsPerTemplate: number;
+    mostPopularTag: {
+        tag: string;
+        count: number;
+    } | null;
+    indexSize: number;
+    buildTime: number;
+}
+/**
+ * High-performance index for template filtering operations
+ * Provides O(1) tag lookups and optimized expression evaluation
+ */
+export declare class TemplateIndex {
+    private templates;
+    private tagIndex;
+    private built;
+    private buildTime;
+    constructor();
+    /**
+     * Build index from template configurations
+     */
+    buildIndex(templates: Record<string, MCPServerParams>): void;
+    /**
+     * Get templates by tag (O(1) lookup)
+     */
+    getTemplatesByTag(tag: string): string[];
+    /**
+     * Get templates by multiple tags (OR logic)
+     */
+    getTemplatesByTags(tags: string[]): string[];
+    /**
+     * Get templates matching all specified tags (AND logic)
+     */
+    getTemplatesByAllTags(tags: string[]): string[];
+    /**
+     * Evaluate advanced tag expression against indexed templates
+     * Optimized evaluation using index lookups where possible
+     */
+    evaluateExpression(expression: string): string[];
+    /**
+     * Evaluate MongoDB-style tag query against indexed templates
+     */
+    evaluateTagQuery(query: TagQuery): string[];
+    /**
+     * Get template entry with full information
+     */
+    getTemplate(name: string): TemplateIndexEntry | null;
+    /**
+     * Check if template exists in index
+     */
+    hasTemplate(name: string): boolean;
+    /**
+     * Get all template names
+     */
+    getAllTemplateNames(): string[];
+    /**
+     * Get all unique tags
+     */
+    getAllTags(): string[];
+    /**
+     * Get popular tags (most frequently used)
+     */
+    getPopularTags(limit?: number): Array<{
+        tag: string;
+        count: number;
+    }>;
+    /**
+     * Get index statistics
+     */
+    getStats(): IndexStats;
+    /**
+     * Check if index is built and ready
+     */
+    isBuilt(): boolean;
+    /**
+     * Add a single template to the index
+     */
+    private addTemplate;
+    /**
+     * Build popular tags list sorted by frequency
+     */
+    private buildPopularTags;
+    /**
+     * Evaluate parsed expression using optimized index lookups
+     */
+    private evaluateParsedExpression;
+    /**
+     * Clear index
+     */
+    private clear;
+    /**
+     * Optimize index for memory usage
+     */
+    optimize(): void;
+    /**
+     * Get detailed debugging information
+     */
+    getDebugInfo(): {
+        templates: Array<{
+            name: string;
+            tagCount: number;
+            tags: string[];
+        }>;
+        tagDistribution: Array<{
+            tag: string;
+            count: number;
+            templates: string[];
+        }>;
+        stats: IndexStats;
+    };
+}
+export {};
+//# sourceMappingURL=templateIndex.d.ts.map

package/build/core/filtering/templateIndex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"templateIndex.d.ts","sourceRoot":"","sources":["../../../src/core/filtering/templateIndex.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAG3D,OAAO,EAAE,QAAQ,EAAE,MAAM,0CAA0C,CAAC;AAIpE;;GAEG;AACH,UAAU,kBAAkB;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,eAAe,CAAC;IACxB,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAClB,cAAc,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAWD;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,sBAAsB,EAAE,MAAM,CAAC;IAC/B,cAAc,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACtD,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,SAAS,CAAyC;IAC1D,OAAO,CAAC,QAAQ,CAAW;IAC3B,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,SAAS,CAAK;;IAUtB;;OAEG;IACI,UAAU,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,GAAG,IAAI;IAkCnE;;OAEG;IACI,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE;IAW/C;;OAEG;IACI,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE;IAiBnD;;OAEG;IACI,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE;IA8BtD;;;OAGG;IACI,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE;IAkBvD;;OAEG;IACI,gBAAgB,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,EAAE;IA0BlD;;OAEG;IACI,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,GAAG,IAAI;IAI3D;;OAEG;IACI,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIzC;;OAEG;IACI,mBAAmB,IAAI,MAAM,EAAE;IAItC;;OAEG;IACI,UAAU,IAAI,MAAM,EAAE;IAI7B;;OAEG;IACI,cAAc,CAAC,KAAK,GAAE,MAAW,GAAG,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAIhF;;OAEG;IACI,QAAQ,IAAI,UAAU;IAuB7B;;OAEG;IACI,OAAO,IAAI,OAAO;IAIzB;;OAEG;IACH,OAAO,CAAC,WAAW;IAgCnB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAcxB;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAyEhC;;OAEG;IACH,OAAO,CAAC,KAAK;IASb;;OAEG;IACI,QAAQ,IAAI,IAAI;IAkBvB;;OAEG;IACI,YAAY,IAAI;QACrB,SAAS,EAAE,KAAK,CAAC;YACf,IAAI,EAAE,MAAM,CAAC;YACb,QAAQ,EAAE,MAAM,CAAC;YACjB,IAAI,EAAE,MAAM,EAAE,CAAC;SAChB,CAAC,CAAC;QACH,eAAe,EAAE,KAAK,CAAC;YACrB,GAAG,EAAE,MAAM,CAAC;YACZ,KAAK,EAAE,MAAM,CAAC;YACd,SAAS,EAAE,MAAM,EAAE,CAAC;SACrB,CAAC,CAAC;QACH,KAAK,EAAE,UAAU,CAAC;KACnB;CAmBF"}