@frontmcp/plugins 0.4.1 → 0.5.1

package/src/codecall/services/synonym-expansion.service.js

@@ -0,0 +1,374 @@
+"use strict";
+// file: libs/plugins/src/codecall/services/synonym-expansion.service.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SynonymExpansionService = void 0;
+/**
+ * Universal Synonym groups for MCP Tool searching.
+ *
+ * DESIGN PRINCIPLE:
+ * These groups bridge the gap between "User Intent" (Natural Language)
+ * and "System Function" (API/Tool Names).
+ *
+ * STRUCTURE:
+ * 1. Core Data Operations (CRUD+)
+ * 2. State & Lifecycle
+ * 3. Transfer & IO
+ * 4. DevOps & Technical
+ * 5. Commerce & Business Logic
+ * 6. Communication & Social
+ * 7. Universal Entities (Nouns)
+ */
+const DEFAULT_SYNONYM_GROUPS = [
+    // ===========================================================================
+    // 1. CORE DATA OPERATIONS (CRUD+)
+    // ===========================================================================
+    // Creation / Instantiation
+    [
+        'create',
+        'add',
+        'new',
+        'insert',
+        'make',
+        'append',
+        'register',
+        'generate',
+        'produce',
+        'build',
+        'construct',
+        'provision',
+        'instantiate',
+        'define',
+        'compose',
+        'draft',
+    ],
+    // Destructive Removal
+    [
+        'delete',
+        'remove',
+        'destroy',
+        'drop',
+        'erase',
+        'clear',
+        'purge',
+        'discard',
+        'eliminate',
+        'nuke',
+        'unbind',
+        'unregister',
+    ],
+    // Retrieval / Access
+    ['get', 'fetch', 'retrieve', 'read', 'obtain', 'load', 'pull', 'access', 'grab', 'snag', 'receive'],
+    // Modification
+    [
+        'update',
+        'edit',
+        'modify',
+        'change',
+        'patch',
+        'alter',
+        'revise',
+        'refresh',
+        'correct',
+        'amend',
+        'adjust',
+        'tweak',
+        'rectify',
+        'refine',
+    ],
+    // Viewing / Listing
+    [
+        'list',
+        'show',
+        'display',
+        'enumerate',
+        'browse',
+        'view',
+        'peek',
+        'index',
+        'catalog',
+        'survey',
+        'inspect',
+        'ls',
+        'dir',
+    ],
+    // Searching / Discovery
+    [
+        'find',
+        'search',
+        'lookup',
+        'query',
+        'locate',
+        'filter',
+        'scan',
+        'explore',
+        'investigate',
+        'detect',
+        'scout',
+        'seek',
+    ],
+    // Soft Delete / Archival
+    ['archive', 'shelve', 'retire', 'hide', 'suppress', 'mute'],
+    ['unarchive', 'restore', 'recover', 'undelete', 'unhide'],
+    // ===========================================================================
+    // 2. STATE & LIFECYCLE
+    // ===========================================================================
+    // Activation
+    [
+        'enable',
+        'activate',
+        'start',
+        'turn on',
+        'switch on',
+        'boot',
+        'init',
+        'initialize',
+        'setup',
+        'spin up',
+        'resume',
+        'unpause',
+    ],
+    // Deactivation
+    [
+        'disable',
+        'deactivate',
+        'stop',
+        'turn off',
+        'switch off',
+        'shutdown',
+        'halt',
+        'kill',
+        'terminate',
+        'suspend',
+        'pause',
+        'cease',
+    ],
+    // Execution
+    ['run', 'execute', 'invoke', 'trigger', 'launch', 'call', 'perform', 'operate', 'handle', 'process', 'fire'],
+    // Reset cycles
+    ['restart', 'reboot', 'reset', 'reload', 'bounce', 'recycle', 'refresh'],
+    // Validation & Check
+    ['validate', 'verify', 'check', 'confirm', 'assert', 'test', 'audit', 'assess', 'healthcheck', 'ping'],
+    // Analysis & Math
+    [
+        'analyze',
+        'interpret',
+        'diagnose',
+        'evaluate',
+        'review',
+        'summarize',
+        'count',
+        'calculate',
+        'compute',
+        'measure',
+        'aggregate',
+        'summarise',
+    ],
+    // ===========================================================================
+    // 3. TRANSFER, IO & MANIPULATION
+    // ===========================================================================
+    // Duplication
+    ['copy', 'duplicate', 'clone', 'replicate', 'mirror', 'fork', 'repro'],
+    // Movement
+    ['move', 'transfer', 'migrate', 'relocate', 'rename', 'shift', 'mv', 'slide'],
+    // Persistence
+    ['save', 'store', 'write', 'persist', 'commit', 'stash', 'record', 'log'],
+    // Synchronization
+    ['sync', 'synchronize', 'resync', 'reconcile', 'align', 'pair'],
+    // Import/Export
+    ['import', 'ingest', 'upload', 'push', 'feed'],
+    ['export', 'download', 'dump', 'backup', 'extract'],
+    // Connection
+    ['connect', 'link', 'bind', 'attach', 'join', 'bridge', 'associate', 'mount', 'map'],
+    ['disconnect', 'unlink', 'unbind', 'detach', 'leave', 'dissociate', 'unmount', 'unmap'],
+    // ===========================================================================
+    // 4. DEVOPS, SECURITY & TECHNICAL
+    // ===========================================================================
+    // Auth
+    ['login', 'log in', 'sign in', 'authenticate', 'auth'],
+    ['logout', 'log out', 'sign out', 'disconnect'],
+    // Permissions
+    ['approve', 'authorize', 'grant', 'permit', 'allow', 'sanction', 'whitelist'],
+    ['deny', 'reject', 'revoke', 'forbid', 'block', 'ban', 'blacklist'],
+    // Encryption
+    ['encrypt', 'secure', 'lock', 'seal', 'protect', 'scramble', 'hash'],
+    ['decrypt', 'unlock', 'unseal', 'reveal', 'decode'],
+    // Deployment
+    ['deploy', 'release', 'ship', 'publish', 'roll out', 'promote', 'distribute', 'install'],
+    // Development
+    ['debug', 'troubleshoot', 'fix', 'repair', 'resolve', 'trace'],
+    ['compile', 'transpile', 'build', 'assemble', 'package', 'bundle', 'minify'],
+    // ===========================================================================
+    // 5. COMMERCE & BUSINESS LOGIC
+    // ===========================================================================
+    // Financial Transactions
+    ['buy', 'purchase', 'order', 'pay', 'checkout', 'spend'],
+    ['sell', 'refund', 'reimburse', 'charge', 'invoice', 'bill'],
+    ['subscribe', 'upgrade', 'upsell'],
+    ['unsubscribe', 'cancel', 'downgrade'],
+    // Scheduling
+    ['schedule', 'book', 'appoint', 'reserve', 'plan', 'calendar'],
+    ['reschedule', 'postpone', 'delay', 'defer'],
+    // ===========================================================================
+    // 6. COMMUNICATION & SOCIAL
+    // ===========================================================================
+    // Outbound
+    [
+        'send',
+        'dispatch',
+        'deliver',
+        'transmit',
+        'post',
+        'broadcast',
+        'notify',
+        'alert',
+        'email',
+        'text',
+        'message',
+        'chat',
+    ],
+    // Social Interactions
+    ['reply', 'respond', 'answer', 'retort'],
+    ['share', 'forward', 'retweet', 'repost'],
+    ['like', 'favorite', 'star', 'upvote', 'heart'],
+    ['dislike', 'downvote'],
+    ['follow', 'watch', 'track'],
+    ['unfollow', 'ignore', 'mute'],
+    // ===========================================================================
+    // 7. COMMON ENTITIES (NOUNS)
+    // ===========================================================================
+    // Users & Roles
+    [
+        'user',
+        'account',
+        'member',
+        'profile',
+        'identity',
+        'customer',
+        'principal',
+        'admin',
+        'operator',
+        'client',
+        'employee',
+        'staff',
+    ],
+    ['role', 'group', 'team', 'squad', 'unit', 'department'],
+    // Data Artifacts
+    ['file', 'document', 'attachment', 'blob', 'asset', 'object', 'resource', 'content', 'media'],
+    ['image', 'picture', 'photo', 'screenshot'],
+    ['video', 'clip', 'recording', 'footage'],
+    // System Artifacts
+    ['message', 'notification', 'alert', 'event', 'signal', 'webhook', 'ping'],
+    ['log', 'trace', 'metric', 'telemetry', 'audit trail', 'history'],
+    ['settings', 'config', 'configuration', 'preferences', 'options', 'params', 'env', 'environment', 'variables'],
+    ['permission', 'privilege', 'access right', 'policy', 'rule', 'scope'],
+    // Business Artifacts
+    ['organization', 'company', 'tenant', 'workspace', 'org', 'project', 'repo', 'repository'],
+    ['product', 'item', 'sku', 'inventory', 'stock'],
+    ['task', 'ticket', 'issue', 'bug', 'story', 'epic', 'todo', 'job', 'workitem'],
+    // Identification
+    ['id', 'identifier', 'key', 'uuid', 'guid', 'token', 'hash', 'fingerprint'],
+];
+/**
+ * Lightweight synonym expansion service for improving TF-IDF search relevance.
+ * Zero dependencies, synchronous, and easily extensible.
+ *
+ * This service provides query-time synonym expansion to help TF-IDF-based
+ * search understand that semantically similar terms (like "add" and "create")
+ * should match the same tools.
+ */
+class SynonymExpansionService {
+    synonymMap;
+    maxExpansions;
+    constructor(config = {}) {
+        this.maxExpansions = config.maxExpansionsPerTerm ?? 5;
+        // Build synonym map from groups
+        const groups = config.replaceDefaults
+            ? config.additionalSynonyms || []
+            : [...DEFAULT_SYNONYM_GROUPS, ...(config.additionalSynonyms || [])];
+        this.synonymMap = this.buildSynonymMap(groups);
+    }
+    /**
+     * Build a bidirectional synonym map from groups.
+     * Each term maps to all other terms in its group(s).
+     */
+    buildSynonymMap(groups) {
+        const map = new Map();
+        for (const group of groups) {
+            const normalizedGroup = group.map((term) => term.toLowerCase());
+            for (const term of normalizedGroup) {
+                if (!map.has(term)) {
+                    map.set(term, new Set());
+                }
+                const synonyms = map.get(term);
+                // Add all other terms in the group as synonyms
+                for (const synonym of normalizedGroup) {
+                    if (synonym !== term) {
+                        synonyms.add(synonym);
+                    }
+                }
+            }
+        }
+        return map;
+    }
+    /**
+     * Get synonyms for a single term.
+     * Returns empty array if no synonyms found.
+     *
+     * @example
+     * getSynonyms('add') // ['create', 'new', 'insert', 'make']
+     */
+    getSynonyms(term) {
+        const normalized = term.toLowerCase();
+        const synonyms = this.synonymMap.get(normalized);
+        if (!synonyms) {
+            return [];
+        }
+        // Return limited synonyms to prevent query explosion
+        return Array.from(synonyms).slice(0, this.maxExpansions);
+    }
+    /**
+     * Expand a query string by adding synonyms for each term.
+     * Returns the expanded query string with original terms and their synonyms.
+     *
+     * @example
+     * expandQuery('add user') // 'add create new insert make user account member profile'
+     */
+    expandQuery(query) {
+        const terms = query
+            .toLowerCase()
+            .split(/\s+/)
+            .filter((term) => term.length > 1);
+        const expandedTerms = [];
+        for (const term of terms) {
+            // Always include the original term first
+            expandedTerms.push(term);
+            // Add synonyms
+            const synonyms = this.getSynonyms(term);
+            expandedTerms.push(...synonyms);
+        }
+        return expandedTerms.join(' ');
+    }
+    /**
+     * Check if synonym expansion is available for any term in the query.
+     */
+    hasExpansions(query) {
+        const terms = query.toLowerCase().split(/\s+/);
+        return terms.some((term) => this.synonymMap.has(term));
+    }
+    /**
+     * Get statistics about the synonym dictionary.
+     */
+    getStats() {
+        const termCount = this.synonymMap.size;
+        let totalSynonyms = 0;
+        for (const synonyms of this.synonymMap.values()) {
+            totalSynonyms += synonyms.size;
+        }
+        return {
+            termCount,
+            avgSynonymsPerTerm: termCount > 0 ? totalSynonyms / termCount : 0,
+        };
+    }
+}
+exports.SynonymExpansionService = SynonymExpansionService;
+//# sourceMappingURL=synonym-expansion.service.js.map

package/src/codecall/services/synonym-expansion.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"synonym-expansion.service.js","sourceRoot":"","sources":["../../../../src/codecall/services/synonym-expansion.service.ts"],"names":[],"mappings":"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","sourcesContent":["// file: libs/plugins/src/codecall/services/synonym-expansion.service.ts\n\n/**\n * Universal Synonym groups for MCP Tool searching.\n *\n * DESIGN PRINCIPLE:\n * These groups bridge the gap between \"User Intent\" (Natural Language)\n * and \"System Function\" (API/Tool Names).\n *\n * STRUCTURE:\n * 1. Core Data Operations (CRUD+)\n * 2. State & Lifecycle\n * 3. Transfer & IO\n * 4. DevOps & Technical\n * 5. Commerce & Business Logic\n * 6. Communication & Social\n * 7. Universal Entities (Nouns)\n */\nconst DEFAULT_SYNONYM_GROUPS: ReadonlyArray<ReadonlyArray<string>> = [\n  // ===========================================================================\n  // 1. CORE DATA OPERATIONS (CRUD+)\n  // ===========================================================================\n\n  // Creation / Instantiation\n  [\n    'create',\n    'add',\n    'new',\n    'insert',\n    'make',\n    'append',\n    'register',\n    'generate',\n    'produce',\n    'build',\n    'construct',\n    'provision',\n    'instantiate',\n    'define',\n    'compose',\n    'draft',\n  ],\n\n  // Destructive Removal\n  [\n    'delete',\n    'remove',\n    'destroy',\n    'drop',\n    'erase',\n    'clear',\n    'purge',\n    'discard',\n    'eliminate',\n    'nuke',\n    'unbind',\n    'unregister',\n  ],\n\n  // Retrieval / Access\n  ['get', 'fetch', 'retrieve', 'read', 'obtain', 'load', 'pull', 'access', 'grab', 'snag', 'receive'],\n\n  // Modification\n  [\n    'update',\n    'edit',\n    'modify',\n    'change',\n    'patch',\n    'alter',\n    'revise',\n    'refresh',\n    'correct',\n    'amend',\n    'adjust',\n    'tweak',\n    'rectify',\n    'refine',\n  ],\n\n  // Viewing / Listing\n  [\n    'list',\n    'show',\n    'display',\n    'enumerate',\n    'browse',\n    'view',\n    'peek',\n    'index',\n    'catalog',\n    'survey',\n    'inspect',\n    'ls',\n    'dir',\n  ],\n\n  // Searching / Discovery\n  [\n    'find',\n    'search',\n    'lookup',\n    'query',\n    'locate',\n    'filter',\n    'scan',\n    'explore',\n    'investigate',\n    'detect',\n    'scout',\n    'seek',\n  ],\n\n  // Soft Delete / Archival\n  ['archive', 'shelve', 'retire', 'hide', 'suppress', 'mute'],\n  ['unarchive', 'restore', 'recover', 'undelete', 'unhide'],\n\n  // ===========================================================================\n  // 2. STATE & LIFECYCLE\n  // ===========================================================================\n\n  // Activation\n  [\n    'enable',\n    'activate',\n    'start',\n    'turn on',\n    'switch on',\n    'boot',\n    'init',\n    'initialize',\n    'setup',\n    'spin up',\n    'resume',\n    'unpause',\n  ],\n\n  // Deactivation\n  [\n    'disable',\n    'deactivate',\n    'stop',\n    'turn off',\n    'switch off',\n    'shutdown',\n    'halt',\n    'kill',\n    'terminate',\n    'suspend',\n    'pause',\n    'cease',\n  ],\n\n  // Execution\n  ['run', 'execute', 'invoke', 'trigger', 'launch', 'call', 'perform', 'operate', 'handle', 'process', 'fire'],\n\n  // Reset cycles\n  ['restart', 'reboot', 'reset', 'reload', 'bounce', 'recycle', 'refresh'],\n\n  // Validation & Check\n  ['validate', 'verify', 'check', 'confirm', 'assert', 'test', 'audit', 'assess', 'healthcheck', 'ping'],\n\n  // Analysis & Math\n  [\n    'analyze',\n    'interpret',\n    'diagnose',\n    'evaluate',\n    'review',\n    'summarize',\n    'count',\n    'calculate',\n    'compute',\n    'measure',\n    'aggregate',\n    'summarise',\n  ],\n\n  // ===========================================================================\n  // 3. TRANSFER, IO & MANIPULATION\n  // ===========================================================================\n\n  // Duplication\n  ['copy', 'duplicate', 'clone', 'replicate', 'mirror', 'fork', 'repro'],\n\n  // Movement\n  ['move', 'transfer', 'migrate', 'relocate', 'rename', 'shift', 'mv', 'slide'],\n\n  // Persistence\n  ['save', 'store', 'write', 'persist', 'commit', 'stash', 'record', 'log'],\n\n  // Synchronization\n  ['sync', 'synchronize', 'resync', 'reconcile', 'align', 'pair'],\n\n  // Import/Export\n  ['import', 'ingest', 'upload', 'push', 'feed'],\n  ['export', 'download', 'dump', 'backup', 'extract'],\n\n  // Connection\n  ['connect', 'link', 'bind', 'attach', 'join', 'bridge', 'associate', 'mount', 'map'],\n  ['disconnect', 'unlink', 'unbind', 'detach', 'leave', 'dissociate', 'unmount', 'unmap'],\n\n  // ===========================================================================\n  // 4. DEVOPS, SECURITY & TECHNICAL\n  // ===========================================================================\n\n  // Auth\n  ['login', 'log in', 'sign in', 'authenticate', 'auth'],\n  ['logout', 'log out', 'sign out', 'disconnect'],\n\n  // Permissions\n  ['approve', 'authorize', 'grant', 'permit', 'allow', 'sanction', 'whitelist'],\n  ['deny', 'reject', 'revoke', 'forbid', 'block', 'ban', 'blacklist'],\n\n  // Encryption\n  ['encrypt', 'secure', 'lock', 'seal', 'protect', 'scramble', 'hash'],\n  ['decrypt', 'unlock', 'unseal', 'reveal', 'decode'],\n\n  // Deployment\n  ['deploy', 'release', 'ship', 'publish', 'roll out', 'promote', 'distribute', 'install'],\n\n  // Development\n  ['debug', 'troubleshoot', 'fix', 'repair', 'resolve', 'trace'],\n  ['compile', 'transpile', 'build', 'assemble', 'package', 'bundle', 'minify'],\n\n  // ===========================================================================\n  // 5. COMMERCE & BUSINESS LOGIC\n  // ===========================================================================\n\n  // Financial Transactions\n  ['buy', 'purchase', 'order', 'pay', 'checkout', 'spend'],\n  ['sell', 'refund', 'reimburse', 'charge', 'invoice', 'bill'],\n  ['subscribe', 'upgrade', 'upsell'],\n  ['unsubscribe', 'cancel', 'downgrade'],\n\n  // Scheduling\n  ['schedule', 'book', 'appoint', 'reserve', 'plan', 'calendar'],\n  ['reschedule', 'postpone', 'delay', 'defer'],\n\n  // ===========================================================================\n  // 6. COMMUNICATION & SOCIAL\n  // ===========================================================================\n\n  // Outbound\n  [\n    'send',\n    'dispatch',\n    'deliver',\n    'transmit',\n    'post',\n    'broadcast',\n    'notify',\n    'alert',\n    'email',\n    'text',\n    'message',\n    'chat',\n  ],\n\n  // Social Interactions\n  ['reply', 'respond', 'answer', 'retort'],\n  ['share', 'forward', 'retweet', 'repost'],\n  ['like', 'favorite', 'star', 'upvote', 'heart'],\n  ['dislike', 'downvote'],\n  ['follow', 'watch', 'track'],\n  ['unfollow', 'ignore', 'mute'],\n\n  // ===========================================================================\n  // 7. COMMON ENTITIES (NOUNS)\n  // ===========================================================================\n\n  // Users & Roles\n  [\n    'user',\n    'account',\n    'member',\n    'profile',\n    'identity',\n    'customer',\n    'principal',\n    'admin',\n    'operator',\n    'client',\n    'employee',\n    'staff',\n  ],\n  ['role', 'group', 'team', 'squad', 'unit', 'department'],\n\n  // Data Artifacts\n  ['file', 'document', 'attachment', 'blob', 'asset', 'object', 'resource', 'content', 'media'],\n  ['image', 'picture', 'photo', 'screenshot'],\n  ['video', 'clip', 'recording', 'footage'],\n\n  // System Artifacts\n  ['message', 'notification', 'alert', 'event', 'signal', 'webhook', 'ping'],\n  ['log', 'trace', 'metric', 'telemetry', 'audit trail', 'history'],\n  ['settings', 'config', 'configuration', 'preferences', 'options', 'params', 'env', 'environment', 'variables'],\n  ['permission', 'privilege', 'access right', 'policy', 'rule', 'scope'],\n\n  // Business Artifacts\n  ['organization', 'company', 'tenant', 'workspace', 'org', 'project', 'repo', 'repository'],\n  ['product', 'item', 'sku', 'inventory', 'stock'],\n  ['task', 'ticket', 'issue', 'bug', 'story', 'epic', 'todo', 'job', 'workitem'],\n\n  // Identification\n  ['id', 'identifier', 'key', 'uuid', 'guid', 'token', 'hash', 'fingerprint'],\n];\n\n/**\n * Configuration for the SynonymExpansionService\n */\nexport interface SynonymExpansionConfig {\n  /**\n   * Additional synonym groups to include beyond defaults.\n   * Each group is an array of related terms.\n   */\n  additionalSynonyms?: ReadonlyArray<ReadonlyArray<string>>;\n\n  /**\n   * If true, completely replace default synonyms with additionalSynonyms.\n   * @default false\n   */\n  replaceDefaults?: boolean;\n\n  /**\n   * Maximum number of expanded terms per input term.\n   * Prevents query explosion.\n   * @default 5\n   */\n  maxExpansionsPerTerm?: number;\n}\n\n/**\n * Lightweight synonym expansion service for improving TF-IDF search relevance.\n * Zero dependencies, synchronous, and easily extensible.\n *\n * This service provides query-time synonym expansion to help TF-IDF-based\n * search understand that semantically similar terms (like \"add\" and \"create\")\n * should match the same tools.\n */\nexport class SynonymExpansionService {\n  private synonymMap: Map<string, Set<string>>;\n  private maxExpansions: number;\n\n  constructor(config: SynonymExpansionConfig = {}) {\n    this.maxExpansions = config.maxExpansionsPerTerm ?? 5;\n\n    // Build synonym map from groups\n    const groups = config.replaceDefaults\n      ? config.additionalSynonyms || []\n      : [...DEFAULT_SYNONYM_GROUPS, ...(config.additionalSynonyms || [])];\n\n    this.synonymMap = this.buildSynonymMap(groups);\n  }\n\n  /**\n   * Build a bidirectional synonym map from groups.\n   * Each term maps to all other terms in its group(s).\n   */\n  private buildSynonymMap(groups: ReadonlyArray<ReadonlyArray<string>>): Map<string, Set<string>> {\n    const map = new Map<string, Set<string>>();\n\n    for (const group of groups) {\n      const normalizedGroup = group.map((term) => term.toLowerCase());\n\n      for (const term of normalizedGroup) {\n        if (!map.has(term)) {\n          map.set(term, new Set());\n        }\n        const synonyms = map.get(term)!;\n\n        // Add all other terms in the group as synonyms\n        for (const synonym of normalizedGroup) {\n          if (synonym !== term) {\n            synonyms.add(synonym);\n          }\n        }\n      }\n    }\n\n    return map;\n  }\n\n  /**\n   * Get synonyms for a single term.\n   * Returns empty array if no synonyms found.\n   *\n   * @example\n   * getSynonyms('add') // ['create', 'new', 'insert', 'make']\n   */\n  getSynonyms(term: string): string[] {\n    const normalized = term.toLowerCase();\n    const synonyms = this.synonymMap.get(normalized);\n\n    if (!synonyms) {\n      return [];\n    }\n\n    // Return limited synonyms to prevent query explosion\n    return Array.from(synonyms).slice(0, this.maxExpansions);\n  }\n\n  /**\n   * Expand a query string by adding synonyms for each term.\n   * Returns the expanded query string with original terms and their synonyms.\n   *\n   * @example\n   * expandQuery('add user') // 'add create new insert make user account member profile'\n   */\n  expandQuery(query: string): string {\n    const terms = query\n      .toLowerCase()\n      .split(/\\s+/)\n      .filter((term) => term.length > 1);\n\n    const expandedTerms: string[] = [];\n\n    for (const term of terms) {\n      // Always include the original term first\n      expandedTerms.push(term);\n\n      // Add synonyms\n      const synonyms = this.getSynonyms(term);\n      expandedTerms.push(...synonyms);\n    }\n\n    return expandedTerms.join(' ');\n  }\n\n  /**\n   * Check if synonym expansion is available for any term in the query.\n   */\n  hasExpansions(query: string): boolean {\n    const terms = query.toLowerCase().split(/\\s+/);\n    return terms.some((term) => this.synonymMap.has(term));\n  }\n\n  /**\n   * Get statistics about the synonym dictionary.\n   */\n  getStats(): { termCount: number; avgSynonymsPerTerm: number } {\n    const termCount = this.synonymMap.size;\n    let totalSynonyms = 0;\n\n    for (const synonyms of this.synonymMap.values()) {\n      totalSynonyms += synonyms.size;\n    }\n\n    return {\n      termCount,\n      avgSynonymsPerTerm: termCount > 0 ? totalSynonyms / termCount : 0,\n    };\n  }\n}\n"]}

package/src/codecall/services/tool-search.service.d.ts

@@ -0,0 +1,175 @@
+import { ToolEntry, ScopeEntry } from '@frontmcp/sdk';
+import type { EmbeddingStrategy, CodeCallEmbeddingOptions, CodeCallMode } from '../codecall.types';
+import type { ToolSearch, ToolSearchResult as SymbolToolSearchResult, ToolSearchOptions as SymbolToolSearchOptions } from '../codecall.symbol';
+import { SynonymExpansionConfig } from './synonym-expansion.service';
+/**
+ * Search result for tool search
+ */
+export interface SearchResult {
+    tool: ToolEntry<any, any>;
+    score: number;
+    toolName: string;
+    qualifiedName: string;
+    appId?: string;
+}
+/**
+ * Search options for tool search
+ */
+export interface SearchOptions {
+    topK?: number;
+    appIds?: string[];
+    excludeToolNames?: string[];
+    minScore?: number;
+}
+/**
+ * Filter function type for including tools
+ */
+export type IncludeToolsFilter = (info: {
+    name: string;
+    appId?: string;
+    source?: string;
+    description?: string;
+    tags?: string[];
+}) => boolean;
+/**
+ * Configuration for tool search service
+ */
+export interface ToolSearchServiceConfig {
+    /**
+     * Embedding strategy to use
+     * @default 'tfidf'
+     */
+    strategy?: EmbeddingStrategy;
+    /**
+     * Full embedding options (alternative to just strategy)
+     */
+    embeddingOptions?: CodeCallEmbeddingOptions;
+    /**
+     * Default number of results to return
+     * @default 8
+     */
+    defaultTopK?: number;
+    /**
+     * Default similarity threshold
+     * @default 0.0
+     */
+    defaultSimilarityThreshold?: number;
+    /**
+     * CodeCall mode for filtering tools
+     * @default 'codecall_only'
+     */
+    mode?: CodeCallMode;
+    /**
+     * Optional filter function for including tools in the search index
+     */
+    includeTools?: IncludeToolsFilter;
+    /**
+     * Synonym expansion configuration.
+     * When enabled, queries are expanded with synonyms to improve search relevance.
+     * For example, "add user" will also match tools containing "create user".
+     * Only applies when strategy is 'tfidf' (ML already handles semantic similarity).
+     *
+     * Set to false to disable, or provide a config object to customize.
+     * @default { enabled: true } when strategy is 'tfidf'
+     */
+    synonymExpansion?: false | (SynonymExpansionConfig & {
+        enabled?: boolean;
+    });
+}
+/**
+ * Service that maintains a searchable index of tools from the ToolRegistry
+ * Supports both TF-IDF (lightweight, synchronous) and ML-based (semantic) embeddings
+ * Implements the ToolSearch interface for dependency injection
+ */
+export declare class ToolSearchService implements ToolSearch {
+    private static readonly MAX_SUBSCRIPTION_RETRIES;
+    private vectorDB;
+    private strategy;
+    private initialized;
+    private mlInitialized;
+    private subscriptionRetries;
+    private config;
+    private scope;
+    private unsubscribe?;
+    private synonymService;
+    constructor(config: ToolSearchServiceConfig | undefined, scope: ScopeEntry);
+    /**
+     * Sets up subscription to tool changes. Handles the case where scope.tools
+     * may not be available yet during plugin initialization.
+     */
+    private setupSubscription;
+    /**
+     * Handles tool change events by reindexing all tools from the snapshot
+     */
+    private handleToolChange;
+    /**
+     * Determines if a tool should be indexed in the search database.
+     * Filters based on:
+     * - Excludes codecall:* meta-tools (they should not be searchable)
+     * - Mode-based filtering (codecall_only, codecall_opt_in, metadata_driven)
+     * - Per-tool metadata.codecall.enabledInCodeCall
+     * - Custom includeTools filter function
+     */
+    private shouldIndexTool;
+    /**
+     * Extract CodeCall-specific metadata from a tool.
+     */
+    private getCodeCallMetadata;
+    /**
+     * Initializes the search service by indexing all tools from the registry.
+     * NOTE: This method is now a no-op. Initialization is handled reactively
+     * via subscription to tool change events in the constructor.
+     * This method exists for interface compatibility.
+     */
+    initialize(): Promise<void>;
+    /**
+     * Cleanup subscription when service is destroyed
+     */
+    dispose(): void;
+    /**
+     * Extracts searchable text from a tool instance.
+     * Uses term weighting to improve relevance:
+     * - Description terms are heavily weighted (most important for semantic matching)
+     * - Tool name parts are tokenized and weighted
+     * - Tags provide additional context
+     */
+    private extractSearchableText;
+    /**
+     * Checks if a word is a common stop word that should not receive extra weighting.
+     * Uses module-level STOP_WORDS constant to avoid recreating the Set on each call.
+     */
+    private isStopWord;
+    /**
+     * Extracts app ID from tool's owner lineage
+     */
+    private extractAppId;
+    /**
+     * Searches for tools matching the query
+     * Implements the ToolSearch interface
+     */
+    search(query: string, options?: SymbolToolSearchOptions): Promise<SymbolToolSearchResult[]>;
+    /**
+     * Gets all indexed tool names
+     */
+    getAllToolNames(): string[];
+    /**
+     * Gets the total number of indexed tools
+     */
+    getTotalCount(): number;
+    /**
+     * Checks if a tool exists in the index
+     */
+    hasTool(toolName: string): boolean;
+    /**
+     * Clears the entire index
+     */
+    clear(): void;
+    /**
+     * Get the current embedding strategy
+     */
+    getStrategy(): EmbeddingStrategy;
+    /**
+     * Check if the service is initialized
+     */
+    isInitialized(): boolean;
+}