agentic-qe 2.1.0 → 2.1.2

package/dist/mcp/lazy-loader.js

@@ -0,0 +1,327 @@
+"use strict";
+/**
+ * Lazy Tool Loader for Hierarchical MCP Tools
+ * Phase 2 Implementation - Issue #115
+ *
+ * Manages dynamic loading of tool domains to reduce context consumption.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LazyToolLoader = void 0;
+exports.getToolLoader = getToolLoader;
+exports.resetToolLoader = resetToolLoader;
+const tool_categories_js_1 = require("./tool-categories.js");
+const tools_js_1 = require("./tools.js");
+class LazyToolLoader {
+    constructor(enableUsageTracking = true) {
+        this.state = {
+            loadedDomains: new Set(),
+            coreLoaded: false,
+            totalToolsLoaded: 0,
+        };
+        this.toolCache = new Map();
+        this.toolUsageCount = new Map();
+        this.toolLastUsed = new Map();
+        this.domainUsageCount = new Map();
+        this.domainLastLoaded = new Map();
+        this.domainToolUsageCount = new Map();
+        this.usageTrackingEnabled = enableUsageTracking;
+        this.indexTools();
+    }
+    /**
+     * Index all tools for quick lookup
+     */
+    indexTools() {
+        for (const tool of tools_js_1.agenticQETools) {
+            this.toolCache.set(tool.name, tool);
+        }
+    }
+    /**
+     * Get core tools (always loaded)
+     */
+    getCoreTools() {
+        this.state.coreLoaded = true;
+        return tool_categories_js_1.CORE_TOOLS
+            .map(name => this.toolCache.get(name))
+            .filter((tool) => tool !== undefined);
+    }
+    /**
+     * Load a specific domain's tools
+     */
+    loadDomain(domain) {
+        // Track domain usage
+        if (this.usageTrackingEnabled) {
+            const currentCount = this.domainUsageCount.get(domain) || 0;
+            this.domainUsageCount.set(domain, currentCount + 1);
+            this.domainLastLoaded.set(domain, Date.now());
+        }
+        // Check if already loaded
+        if (this.state.loadedDomains.has(domain)) {
+            return {
+                success: true,
+                domain,
+                toolsLoaded: [],
+                alreadyLoaded: true,
+            };
+        }
+        // Get tools for domain
+        const toolNames = domain in tool_categories_js_1.DOMAIN_TOOLS
+            ? tool_categories_js_1.DOMAIN_TOOLS[domain]
+            : tool_categories_js_1.SPECIALIZED_TOOLS[domain] || [];
+        const loadedTools = toolNames.filter(name => this.toolCache.has(name));
+        this.state.loadedDomains.add(domain);
+        this.state.totalToolsLoaded += loadedTools.length;
+        return {
+            success: true,
+            domain,
+            toolsLoaded: loadedTools,
+            alreadyLoaded: false,
+        };
+    }
+    /**
+     * Get tools for a loaded domain
+     */
+    getToolsForDomain(domain) {
+        const toolNames = domain in tool_categories_js_1.DOMAIN_TOOLS
+            ? tool_categories_js_1.DOMAIN_TOOLS[domain]
+            : tool_categories_js_1.SPECIALIZED_TOOLS[domain] || [];
+        return toolNames
+            .map(name => this.toolCache.get(name))
+            .filter((tool) => tool !== undefined);
+    }
+    /**
+     * Auto-detect and load domains based on message content
+     */
+    autoLoadFromMessage(message) {
+        const domains = (0, tool_categories_js_1.detectDomainsFromMessage)(message);
+        return domains.map(domain => this.loadDomain(domain));
+    }
+    /**
+     * Get all currently loaded tools
+     */
+    getLoadedTools() {
+        const tools = [];
+        // Always include core
+        tools.push(...this.getCoreTools());
+        // Add loaded domains
+        for (const domain of this.state.loadedDomains) {
+            tools.push(...this.getToolsForDomain(domain));
+        }
+        return tools;
+    }
+    /**
+     * Get current loader state
+     */
+    getState() {
+        return { ...this.state, loadedDomains: new Set(this.state.loadedDomains) };
+    }
+    /**
+     * Check if a domain is loaded
+     */
+    isDomainLoaded(domain) {
+        return this.state.loadedDomains.has(domain);
+    }
+    /**
+     * Get available domains that haven't been loaded
+     */
+    getAvailableDomains() {
+        const allDomains = [
+            ...Object.keys(tool_categories_js_1.DOMAIN_TOOLS),
+            ...Object.keys(tool_categories_js_1.SPECIALIZED_TOOLS),
+        ];
+        return allDomains.filter(d => !this.state.loadedDomains.has(d));
+    }
+    /**
+     * Get statistics about tool loading
+     */
+    getStats() {
+        const availableDomains = this.getAvailableDomains();
+        return {
+            coreTools: tool_categories_js_1.CORE_TOOLS.length,
+            loadedDomains: Array.from(this.state.loadedDomains),
+            availableDomains,
+            totalLoaded: this.state.totalToolsLoaded + tool_categories_js_1.CORE_TOOLS.length,
+            totalAvailable: this.toolCache.size,
+        };
+    }
+    /**
+     * Reset loader state (useful for testing)
+     */
+    reset() {
+        this.state = {
+            loadedDomains: new Set(),
+            coreLoaded: false,
+            totalToolsLoaded: 0,
+        };
+    }
+    /**
+     * Preload commonly used domain combinations
+     */
+    preloadCommonDomains() {
+        // Testing workflows often need coverage and quality
+        this.loadDomain('coverage');
+        this.loadDomain('quality');
+    }
+    /**
+     * Track tool usage when a tool is called
+     */
+    trackToolUsage(toolName) {
+        if (!this.usageTrackingEnabled)
+            return;
+        const currentCount = this.toolUsageCount.get(toolName) || 0;
+        this.toolUsageCount.set(toolName, currentCount + 1);
+        this.toolLastUsed.set(toolName, Date.now());
+        // Find the domain for this tool and track domain-level usage
+        const domain = this.findDomainForTool(toolName);
+        if (domain) {
+            const currentDomainToolCount = this.domainToolUsageCount.get(domain) || 0;
+            this.domainToolUsageCount.set(domain, currentDomainToolCount + 1);
+        }
+    }
+    /**
+     * Find which domain a tool belongs to
+     */
+    findDomainForTool(toolName) {
+        // Check domain tools
+        for (const [domain, tools] of Object.entries(tool_categories_js_1.DOMAIN_TOOLS)) {
+            if (tools.includes(toolName)) {
+                return domain;
+            }
+        }
+        // Check specialized tools
+        for (const [domain, tools] of Object.entries(tool_categories_js_1.SPECIALIZED_TOOLS)) {
+            if (tools.includes(toolName)) {
+                return domain;
+            }
+        }
+        // Check core tools
+        if (tool_categories_js_1.CORE_TOOLS.includes(toolName)) {
+            return 'core';
+        }
+        return undefined;
+    }
+    /**
+     * Get usage statistics for all tools
+     */
+    getToolUsageStats() {
+        const stats = [];
+        for (const [toolName, callCount] of this.toolUsageCount.entries()) {
+            stats.push({
+                toolName,
+                callCount,
+                lastUsed: this.toolLastUsed.get(toolName) || 0,
+                domain: this.findDomainForTool(toolName),
+            });
+        }
+        // Sort by call count descending
+        return stats.sort((a, b) => b.callCount - a.callCount);
+    }
+    /**
+     * Get usage statistics for domains
+     */
+    getDomainUsageStats() {
+        const stats = [];
+        for (const [domain, loadCount] of this.domainUsageCount.entries()) {
+            const toolUsageCount = this.domainToolUsageCount.get(domain) || 0;
+            stats.push({
+                domain,
+                loadCount,
+                toolUsageCount,
+                lastLoaded: this.domainLastLoaded.get(domain) || 0,
+                averageToolsPerLoad: toolUsageCount / Math.max(loadCount, 1),
+            });
+        }
+        // Sort by tool usage count descending
+        return stats.sort((a, b) => b.toolUsageCount - a.toolUsageCount);
+    }
+    /**
+     * Get top N most frequently used tools
+     */
+    getTopTools(limit = 10) {
+        return this.getToolUsageStats().slice(0, limit);
+    }
+    /**
+     * Get top N most frequently used domains
+     */
+    getTopDomains(limit = 5) {
+        return this.getDomainUsageStats().slice(0, limit);
+    }
+    /**
+     * Preload domains based on usage frequency
+     * Loads the most frequently used domains that aren't already loaded
+     */
+    preloadFrequentDomains(threshold = 5) {
+        const results = [];
+        const domainStats = this.getDomainUsageStats();
+        for (const stat of domainStats) {
+            // Skip if already loaded or below threshold
+            if (this.state.loadedDomains.has(stat.domain) || stat.toolUsageCount < threshold) {
+                continue;
+            }
+            // Load the domain
+            const result = this.loadDomain(stat.domain);
+            results.push(result);
+        }
+        return results;
+    }
+    /**
+     * Export usage statistics as JSON
+     */
+    exportUsageStats() {
+        return {
+            toolStats: this.getToolUsageStats(),
+            domainStats: this.getDomainUsageStats(),
+            exportedAt: Date.now(),
+        };
+    }
+    /**
+     * Import usage statistics from JSON
+     */
+    importUsageStats(data) {
+        // Import tool stats
+        for (const stat of data.toolStats) {
+            this.toolUsageCount.set(stat.toolName, stat.callCount);
+            this.toolLastUsed.set(stat.toolName, stat.lastUsed);
+        }
+        // Import domain stats
+        for (const stat of data.domainStats) {
+            this.domainUsageCount.set(stat.domain, stat.loadCount);
+            this.domainToolUsageCount.set(stat.domain, stat.toolUsageCount);
+            this.domainLastLoaded.set(stat.domain, stat.lastLoaded);
+        }
+    }
+    /**
+     * Clear all usage statistics
+     */
+    clearUsageStats() {
+        this.toolUsageCount.clear();
+        this.toolLastUsed.clear();
+        this.domainUsageCount.clear();
+        this.domainLastLoaded.clear();
+        this.domainToolUsageCount.clear();
+    }
+    /**
+     * Enable or disable usage tracking
+     */
+    setUsageTracking(enabled) {
+        this.usageTrackingEnabled = enabled;
+    }
+    /**
+     * Check if usage tracking is enabled
+     */
+    isUsageTrackingEnabled() {
+        return this.usageTrackingEnabled;
+    }
+}
+exports.LazyToolLoader = LazyToolLoader;
+// Singleton instance for use across the application
+let loaderInstance = null;
+function getToolLoader() {
+    if (!loaderInstance) {
+        loaderInstance = new LazyToolLoader();
+    }
+    return loaderInstance;
+}
+function resetToolLoader() {
+    loaderInstance = null;
+}
+//# sourceMappingURL=lazy-loader.js.map

package/dist/mcp/lazy-loader.js.map

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

package/dist/mcp/server-instructions.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Server Instructions for Agentic QE MCP Server
+ * Phase 2 Implementation - Issue #115
+ *
+ * These instructions are shown to Claude once per session to guide tool usage.
+ */
+export declare const SERVER_INSTRUCTIONS = "\n# Agentic QE Fleet - MCP Tool Guide\n\n## Overview\nAgentic QE provides 96 specialized quality engineering tools organized into a hierarchical system for efficient context usage.\n\n## Quick Start\n1. **Discover available tools:** Use `tools_discover` to see all domains\n2. **Load domain tools:** Use `tools_load_domain` to load specialized tools\n3. **Auto-loading:** Domain tools auto-load when relevant keywords are detected\n\n---\n\n## Core Tools (Always Available - 14 tools)\n\n### Fleet Management\n- `fleet_init` - Initialize QE fleet with topology\n- `agent_spawn` - Spawn specialized QE agent\n- `fleet_status` - Get fleet and agent status\n\n### Testing\n- `test_generate_enhanced` - AI test generation with pattern recognition\n- `test_execute_parallel` - Parallel test execution with retry\n- `test_report_comprehensive` - Multi-format test reports\n\n### Memory & Coordination\n- `memory_store` - Store data with TTL & namespacing\n- `memory_retrieve` - Retrieve stored data\n- `memory_query` - Pattern-based memory search\n\n### Quality & Orchestration\n- `quality_analyze` - Analyze quality metrics\n- `task_orchestrate` - Orchestrate tasks across agents\n- `task_status` - Check task progress\n\n### Discovery\n- `tools_discover` - List available tool domains\n- `tools_load_domain` - Load tools for a domain\n\n---\n\n## Domain Tools (Load as Needed)\n\n| Domain | Keywords | Tools | Use Case |\n|--------|----------|-------|----------|\n| **Security** | security, vulnerability, audit, owasp | 4 tools | Security scanning, vulnerability detection |\n| **Performance** | benchmark, bottleneck, profiling | 4 tools | Performance testing, bottleneck analysis |\n| **Coverage** | coverage, gap, uncovered | 5 tools | Coverage analysis, gap detection |\n| **Quality** | quality gate, deploy, release | 6 tools | Quality gates, deployment readiness |\n| **Flaky** | flaky, unstable, retry | 3 tools | Flaky test detection and stabilization |\n| **Visual** | screenshot, accessibility, wcag | 3 tools | Visual regression, accessibility testing |\n| **Requirements** | bdd, gherkin, acceptance | 2 tools | Requirements validation, BDD generation |\n\n### Loading Domain Tools\n```\n# Explicit load\ntools_load_domain({ domain: 'security' })\n\n# Auto-load: Just mention keywords in your request\n\"I need to run a security scan\" \u2192 Security tools auto-load\n```\n\n---\n\n## Specialized Tools (Expert Use)\n\n### Learning Domain (4 tools)\nFor persistent learning and pattern storage across sessions.\nLoad with: `tools_load_domain({ domain: 'learning' })`\n\n### Advanced Domain (7 tools)\nFor mutation testing, API contract validation, production incident replay.\nLoad with: `tools_load_domain({ domain: 'advanced' })`\n\n---\n\n## Best Practices\n\n1. **Start with core tools** - They handle 80% of use cases\n2. **Let auto-load work** - Mention keywords naturally\n3. **Use tools_discover** - When unsure what's available\n4. **Batch operations** - Use parallel execution for speed\n5. **Check fleet_status** - Monitor agent health\n\n---\n\n## Common Workflows\n\n### Test Generation & Execution\n1. `test_generate_enhanced` - Generate tests\n2. `test_execute_parallel` - Run tests\n3. `test_report_comprehensive` - Generate report\n\n### Quality Gate Check\n1. Load quality domain if not auto-loaded\n2. `quality_analyze` - Analyze metrics\n3. `qe_qualitygate_evaluate` - Make go/no-go decision\n\n### Security Audit\n1. `tools_load_domain({ domain: 'security' })`\n2. `qe_security_scan_comprehensive` - Full scan\n3. `qe_security_detect_vulnerabilities` - Detailed analysis\n\n---\n\n## Tool Naming Convention\nAll tools follow: `mcp__agentic_qe__<tool_name>`\n\nExample: `mcp__agentic_qe__test_generate_enhanced`\n";
+export declare const SERVER_NAME = "agentic-qe";
+export declare const SERVER_VERSION = "2.2.0";
+/**
+ * Get formatted server info for MCP initialization
+ */
+export declare function getServerInfo(): {
+    name: string;
+    version: string;
+    instructions: string;
+};
+//# sourceMappingURL=server-instructions.d.ts.map

package/dist/mcp/server-instructions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-instructions.d.ts","sourceRoot":"","sources":["../../src/mcp/server-instructions.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,eAAO,MAAM,mBAAmB,oqHA6G/B,CAAC;AAEF,eAAO,MAAM,WAAW,eAAe,CAAC;AACxC,eAAO,MAAM,cAAc,UAAU,CAAC;AAEtC;;GAEG;AACH,wBAAgB,aAAa,IAAI;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAMvF"}

package/dist/mcp/server-instructions.js

@@ -0,0 +1,133 @@
+"use strict";
+/**
+ * Server Instructions for Agentic QE MCP Server
+ * Phase 2 Implementation - Issue #115
+ *
+ * These instructions are shown to Claude once per session to guide tool usage.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SERVER_VERSION = exports.SERVER_NAME = exports.SERVER_INSTRUCTIONS = void 0;
+exports.getServerInfo = getServerInfo;
+exports.SERVER_INSTRUCTIONS = `
+# Agentic QE Fleet - MCP Tool Guide
+
+## Overview
+Agentic QE provides 96 specialized quality engineering tools organized into a hierarchical system for efficient context usage.
+
+## Quick Start
+1. **Discover available tools:** Use \`tools_discover\` to see all domains
+2. **Load domain tools:** Use \`tools_load_domain\` to load specialized tools
+3. **Auto-loading:** Domain tools auto-load when relevant keywords are detected
+
+---
+
+## Core Tools (Always Available - 14 tools)
+
+### Fleet Management
+- \`fleet_init\` - Initialize QE fleet with topology
+- \`agent_spawn\` - Spawn specialized QE agent
+- \`fleet_status\` - Get fleet and agent status
+
+### Testing
+- \`test_generate_enhanced\` - AI test generation with pattern recognition
+- \`test_execute_parallel\` - Parallel test execution with retry
+- \`test_report_comprehensive\` - Multi-format test reports
+
+### Memory & Coordination
+- \`memory_store\` - Store data with TTL & namespacing
+- \`memory_retrieve\` - Retrieve stored data
+- \`memory_query\` - Pattern-based memory search
+
+### Quality & Orchestration
+- \`quality_analyze\` - Analyze quality metrics
+- \`task_orchestrate\` - Orchestrate tasks across agents
+- \`task_status\` - Check task progress
+
+### Discovery
+- \`tools_discover\` - List available tool domains
+- \`tools_load_domain\` - Load tools for a domain
+
+---
+
+## Domain Tools (Load as Needed)
+
+| Domain | Keywords | Tools | Use Case |
+|--------|----------|-------|----------|
+| **Security** | security, vulnerability, audit, owasp | 4 tools | Security scanning, vulnerability detection |
+| **Performance** | benchmark, bottleneck, profiling | 4 tools | Performance testing, bottleneck analysis |
+| **Coverage** | coverage, gap, uncovered | 5 tools | Coverage analysis, gap detection |
+| **Quality** | quality gate, deploy, release | 6 tools | Quality gates, deployment readiness |
+| **Flaky** | flaky, unstable, retry | 3 tools | Flaky test detection and stabilization |
+| **Visual** | screenshot, accessibility, wcag | 3 tools | Visual regression, accessibility testing |
+| **Requirements** | bdd, gherkin, acceptance | 2 tools | Requirements validation, BDD generation |
+
+### Loading Domain Tools
+\`\`\`
+# Explicit load
+tools_load_domain({ domain: 'security' })
+
+# Auto-load: Just mention keywords in your request
+"I need to run a security scan" → Security tools auto-load
+\`\`\`
+
+---
+
+## Specialized Tools (Expert Use)
+
+### Learning Domain (4 tools)
+For persistent learning and pattern storage across sessions.
+Load with: \`tools_load_domain({ domain: 'learning' })\`
+
+### Advanced Domain (7 tools)
+For mutation testing, API contract validation, production incident replay.
+Load with: \`tools_load_domain({ domain: 'advanced' })\`
+
+---
+
+## Best Practices
+
+1. **Start with core tools** - They handle 80% of use cases
+2. **Let auto-load work** - Mention keywords naturally
+3. **Use tools_discover** - When unsure what's available
+4. **Batch operations** - Use parallel execution for speed
+5. **Check fleet_status** - Monitor agent health
+
+---
+
+## Common Workflows
+
+### Test Generation & Execution
+1. \`test_generate_enhanced\` - Generate tests
+2. \`test_execute_parallel\` - Run tests
+3. \`test_report_comprehensive\` - Generate report
+
+### Quality Gate Check
+1. Load quality domain if not auto-loaded
+2. \`quality_analyze\` - Analyze metrics
+3. \`qe_qualitygate_evaluate\` - Make go/no-go decision
+
+### Security Audit
+1. \`tools_load_domain({ domain: 'security' })\`
+2. \`qe_security_scan_comprehensive\` - Full scan
+3. \`qe_security_detect_vulnerabilities\` - Detailed analysis
+
+---
+
+## Tool Naming Convention
+All tools follow: \`mcp__agentic_qe__<tool_name>\`
+
+Example: \`mcp__agentic_qe__test_generate_enhanced\`
+`;
+exports.SERVER_NAME = 'agentic-qe';
+exports.SERVER_VERSION = '2.2.0';
+/**
+ * Get formatted server info for MCP initialization
+ */
+function getServerInfo() {
+    return {
+        name: exports.SERVER_NAME,
+        version: exports.SERVER_VERSION,
+        instructions: exports.SERVER_INSTRUCTIONS,
+    };
+}
+//# sourceMappingURL=server-instructions.js.map

package/dist/mcp/server-instructions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-instructions.js","sourceRoot":"","sources":["../../src/mcp/server-instructions.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAuHH,sCAMC;AA3HY,QAAA,mBAAmB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6GlC,CAAC;AAEW,QAAA,WAAW,GAAG,YAAY,CAAC;AAC3B,QAAA,cAAc,GAAG,OAAO,CAAC;AAEtC;;GAEG;AACH,SAAgB,aAAa;IAC3B,OAAO;QACL,IAAI,EAAE,mBAAW;QACjB,OAAO,EAAE,sBAAc;QACvB,YAAY,EAAE,2BAAmB;KAClC,CAAC;AACJ,CAAC"}

package/dist/mcp/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAkGjF;;;;;GAKG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAmB;IACnC,OAAO,CAAC,QAAQ,CAAgB;IAChC,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,WAAW,CAAmB;IACtC,OAAO,CAAC,UAAU,CAAqB;IACvC,OAAO,CAAC,SAAS,CAAmB;IACpC,OAAO,CAAC,QAAQ,CAAe;IAC/B,OAAO,CAAC,gBAAgB,CAA+B;;IA+CvD;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAuJ1B;;;;;;;OAOG;IACH,OAAO,CAAC,0BAA0B;IAmClC;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAuW5B;;OAEG;IACG,KAAK,CAAC,SAAS,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;IAY5D;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ3B;;OAEG;IACH,SAAS,IAAI,MAAM;IAInB;;OAEG;IACH,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAIR;;OAEG;IACH,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;CAGxC;AAED;;GAEG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,kBAAkB,CAAC,CAIzE;AAED;;GAEG;AACH,wBAAsB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAuB1C"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AA6GjF;;;;;GAKG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAmB;IACnC,OAAO,CAAC,QAAQ,CAAgB;IAChC,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,WAAW,CAAmB;IACtC,OAAO,CAAC,UAAU,CAAqB;IACvC,OAAO,CAAC,SAAS,CAAmB;IACpC,OAAO,CAAC,QAAQ,CAAe;IAC/B,OAAO,CAAC,gBAAgB,CAA+B;;IA+CvD;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAiJ1B;;;;;;;OAOG;IACH,OAAO,CAAC,0BAA0B;IAmClC;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAmlB5B;;OAEG;IACG,KAAK,CAAC,SAAS,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;IAY5D;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ3B;;OAEG;IACH,SAAS,IAAI,MAAM;IAInB;;OAEG;IACH,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAIR;;OAEG;IACH,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;CAGxC;AAED;;GAEG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,kBAAkB,CAAC,CAIzE;AAED;;GAEG;AACH,wBAAsB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAuB1C"}