webmcp-cli 1.0.0 → 1.2.1

package/dist/llm/json-response.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Shared helpers for extracting JSON payloads from LLM responses.
+ */
+/**
+ * Extract the first JSON object from an LLM response.
+ *
+ * Supports:
+ * - fenced code blocks: ```json ... ```
+ * - plain text responses containing a JSON object
+ */
+export declare function extractJsonObject(response: string): string;
+export declare function parseJsonObject<T>(response: string): T;

package/dist/llm/json-response.js

@@ -0,0 +1,67 @@
+/**
+ * Shared helpers for extracting JSON payloads from LLM responses.
+ */
+/**
+ * Extract the first JSON object from an LLM response.
+ *
+ * Supports:
+ * - fenced code blocks: ```json ... ```
+ * - plain text responses containing a JSON object
+ */
+export function extractJsonObject(response) {
+    const codeBlockMatch = response.match(/```(?:json)?\s*([\s\S]*?)```/i);
+    const candidate = codeBlockMatch?.[1]?.trim() ?? response;
+    let depth = 0;
+    let start = -1;
+    let end = -1;
+    let inString = false;
+    let isEscaped = false;
+    for (let i = 0; i < candidate.length; i++) {
+        const char = candidate[i];
+        if (!char)
+            continue;
+        if (inString) {
+            if (isEscaped) {
+                isEscaped = false;
+                continue;
+            }
+            if (char === '\\') {
+                isEscaped = true;
+                continue;
+            }
+            if (char === '"') {
+                inString = false;
+            }
+            continue;
+        }
+        if (char === '"') {
+            inString = true;
+            continue;
+        }
+        if (char === '{') {
+            if (depth === 0) {
+                start = i;
+            }
+            depth++;
+            continue;
+        }
+        if (char === '}') {
+            if (depth > 0) {
+                depth--;
+                if (depth === 0 && start !== -1) {
+                    end = i + 1;
+                    break;
+                }
+            }
+        }
+    }
+    if (start === -1 || end === -1) {
+        throw new Error('No JSON object found in response');
+    }
+    return candidate.substring(start, end);
+}
+export function parseJsonObject(response) {
+    const json = extractJsonObject(response);
+    return JSON.parse(json);
+}
+//# sourceMappingURL=json-response.js.map

package/dist/llm/json-response.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-response.js","sourceRoot":"","sources":["../../src/llm/json-response.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAAC,QAAgB;IAChD,MAAM,cAAc,GAAG,QAAQ,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAC;IACvE,MAAM,SAAS,GAAG,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,QAAQ,CAAC;IAE1D,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC;IACf,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC;IACb,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,IAAI,SAAS,GAAG,KAAK,CAAC;IAEtB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC1C,MAAM,IAAI,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;QAC1B,IAAI,CAAC,IAAI;YAAE,SAAS;QAEpB,IAAI,QAAQ,EAAE,CAAC;YACb,IAAI,SAAS,EAAE,CAAC;gBACd,SAAS,GAAG,KAAK,CAAC;gBAClB,SAAS;YACX,CAAC;YACD,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;gBAClB,SAAS,GAAG,IAAI,CAAC;gBACjB,SAAS;YACX,CAAC;YACD,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;gBACjB,QAAQ,GAAG,KAAK,CAAC;YACnB,CAAC;YACD,SAAS;QACX,CAAC;QAED,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;YACjB,QAAQ,GAAG,IAAI,CAAC;YAChB,SAAS;QACX,CAAC;QAED,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;YACjB,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;gBAChB,KAAK,GAAG,CAAC,CAAC;YACZ,CAAC;YACD,KAAK,EAAE,CAAC;YACR,SAAS;QACX,CAAC;QAED,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;YACjB,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;gBACd,KAAK,EAAE,CAAC;gBACR,IAAI,KAAK,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC;oBAChC,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;oBACZ,MAAM;gBACR,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,IAAI,KAAK,KAAK,CAAC,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;IACtD,CAAC;IAED,OAAO,SAAS,CAAC,SAAS,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,eAAe,CAAI,QAAgB;IACjD,MAAM,IAAI,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IACzC,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAM,CAAC;AAC/B,CAAC"}

package/dist/llm/providers/mock.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Mock LLM Provider
+ *
+ * For testing and when no API key is available.
+ * Returns static/heuristic-based responses.
+ */
+import type { LLMProvider, EvaluationResult, DescriptionEvalContext, DescriptionQualityReport } from '../types.js';
+import type { DetectedTool } from '../../core/types/tool.js';
+/**
+ * Mock LLM Provider implementation
+ */
+export declare class MockProvider implements LLMProvider {
+    name: string;
+    isAvailable(): boolean;
+    complete(prompt: string, _systemPrompt?: string): Promise<string>;
+    evaluateDescription(context: DescriptionEvalContext): Promise<EvaluationResult>;
+    getQualityReport(tool: DetectedTool): Promise<DescriptionQualityReport>;
+    private evaluateSpecificity;
+    private evaluatePositiveFraming;
+    private evaluateCompleteness;
+    private evaluateClarity;
+    private evaluateSteering;
+    private evaluateAtomicity;
+}
+/**
+ * Create a mock provider
+ */
+export declare function createMockProvider(): MockProvider;
+export default MockProvider;

package/dist/llm/providers/mock.js

@@ -0,0 +1,324 @@
+/**
+ * Mock LLM Provider
+ *
+ * For testing and when no API key is available.
+ * Returns static/heuristic-based responses.
+ */
+/**
+ * Ambiguous verbs to flag
+ */
+const AMBIGUOUS_VERBS = ['handle', 'process', 'do', 'manage', 'execute', 'run', 'perform'];
+/**
+ * Specific/good verbs
+ */
+const SPECIFIC_VERBS = [
+    'search', 'find', 'get', 'fetch', 'retrieve', 'list',
+    'create', 'add', 'insert', 'book', 'reserve', 'submit',
+    'update', 'edit', 'modify', 'change',
+    'delete', 'remove', 'cancel',
+    'send', 'upload', 'download', 'export', 'import',
+];
+/**
+ * Negative framing patterns
+ */
+const NEGATIVE_PATTERNS = [
+    /\bdo not\b/i,
+    /\bdon't\b/i,
+    /\bnever\b/i,
+    /\bavoid\b/i,
+    /\bcannot\b/i,
+    /\bwon't\b/i,
+    /\bshould not\b/i,
+    /\bshouldn't\b/i,
+];
+/**
+ * Non-atomic patterns
+ */
+const NON_ATOMIC_PATTERNS = [
+    /\band\b.*\band\b/i, // Multiple "and"
+    /\b(also|additionally)\b/i, // Adding more functions
+    /\bor\b.*\bor\b/i, // Multiple "or"
+];
+/**
+ * Mock LLM Provider implementation
+ */
+export class MockProvider {
+    name = 'mock';
+    isAvailable() {
+        return true; // Always available
+    }
+    async complete(prompt, _systemPrompt) {
+        // Return a simple mock response
+        return JSON.stringify({
+            passed: true,
+            score: 7,
+            reasoning: 'Mock evaluation - LLM not available',
+            issues: [],
+            suggestions: ['Configure OPENROUTER_API_KEY for detailed LLM analysis'],
+        });
+    }
+    async evaluateDescription(context) {
+        const { name, description, aspect } = context;
+        const textToAnalyze = `${name} ${description}`;
+        switch (aspect) {
+            case 'specificity':
+                return this.evaluateSpecificity(name, description);
+            case 'positive-framing':
+                return this.evaluatePositiveFraming(description);
+            case 'completeness':
+                return this.evaluateCompleteness(description);
+            case 'clarity':
+                return this.evaluateClarity(description);
+            case 'steering':
+                return this.evaluateSteering(name, description);
+            case 'atomicity':
+                return this.evaluateAtomicity(textToAnalyze);
+            default:
+                return {
+                    passed: true,
+                    score: 5,
+                    reasoning: 'Mock evaluation - aspect not implemented',
+                    suggestions: ['Use LLM for detailed evaluation'],
+                };
+        }
+    }
+    async getQualityReport(tool) {
+        const specificity = await this.evaluateSpecificity(tool.name, tool.description);
+        const positiveFraming = await this.evaluatePositiveFraming(tool.description);
+        const completeness = await this.evaluateCompleteness(tool.description);
+        const clarity = await this.evaluateClarity(tool.description);
+        const steering = await this.evaluateSteering(tool.name, tool.description);
+        const atomicity = await this.evaluateAtomicity(`${tool.name} ${tool.description}`);
+        // Calculate weighted average
+        const weights = {
+            clarity: 20,
+            specificity: 15,
+            positiveFraming: 10,
+            completeness: 20,
+            steeringPerformance: 25,
+            atomicity: 10,
+        };
+        const overallScore = Math.round((clarity.score * weights.clarity +
+            specificity.score * weights.specificity +
+            positiveFraming.score * weights.positiveFraming +
+            completeness.score * weights.completeness +
+            steering.score * weights.steeringPerformance +
+            atomicity.score * weights.atomicity) / 10);
+        const allIssues = [];
+        [specificity, positiveFraming, completeness, clarity, steering, atomicity].forEach((result) => {
+            if (result.issues)
+                allIssues.push(...result.issues);
+        });
+        return {
+            overallScore,
+            aspects: {
+                clarity,
+                specificity,
+                positiveFraming,
+                completeness,
+                steeringPerformance: steering,
+                atomicity,
+            },
+            summary: `Heuristic analysis of "${tool.name}". Score: ${overallScore}/100. Configure OPENROUTER_API_KEY for AI-powered analysis.`,
+            priorityImprovements: allIssues.slice(0, 3),
+        };
+    }
+    evaluateSpecificity(name, description) {
+        const lowerName = name.toLowerCase();
+        const issues = [];
+        const suggestions = [];
+        // Check for ambiguous verbs
+        const hasAmbiguous = AMBIGUOUS_VERBS.some((verb) => lowerName.includes(verb));
+        const hasSpecific = SPECIFIC_VERBS.some((verb) => lowerName.includes(verb));
+        let score = 7;
+        if (hasAmbiguous) {
+            score -= 3;
+            issues.push(`Tool name uses ambiguous verb pattern`);
+            suggestions.push('Use specific verbs like search, create, delete, book');
+        }
+        if (!hasSpecific && !hasAmbiguous) {
+            score -= 1;
+            issues.push('Tool name could be more action-oriented');
+        }
+        if (description.length < 20) {
+            score -= 2;
+            issues.push('Description is too short to be specific');
+        }
+        return {
+            passed: score >= 7,
+            score: Math.max(0, score),
+            reasoning: hasSpecific
+                ? 'Tool name uses specific action verb'
+                : hasAmbiguous
+                    ? 'Tool name uses ambiguous verb (handle/process/do)'
+                    : 'Tool name could be more descriptive',
+            issues,
+            suggestions,
+        };
+    }
+    evaluatePositiveFraming(description) {
+        const issues = [];
+        const suggestions = [];
+        let score = 10;
+        for (const pattern of NEGATIVE_PATTERNS) {
+            if (pattern.test(description)) {
+                score -= 2;
+                issues.push(`Description contains negative framing: "${description.match(pattern)?.[0]}"`);
+            }
+        }
+        if (issues.length > 0) {
+            suggestions.push('Rewrite using positive instructions (what it DOES, not what it doesn\'t)');
+        }
+        return {
+            passed: score >= 7,
+            score: Math.max(0, score),
+            reasoning: issues.length === 0
+                ? 'Description uses positive framing'
+                : 'Description contains negative language patterns',
+            issues,
+            suggestions,
+        };
+    }
+    evaluateCompleteness(description) {
+        const issues = [];
+        const suggestions = [];
+        let score = 10;
+        if (description.length < 20) {
+            score -= 3;
+            issues.push('Description is too short');
+            suggestions.push('Expand description to at least 20 characters');
+        }
+        if (description.length < 50) {
+            score -= 1;
+            issues.push('Description could be more detailed');
+        }
+        // Check for "what" indicators
+        const hasWhat = /\b(returns?|provides?|gets?|fetches?|searches?|creates?|deletes?)\b/i.test(description);
+        if (!hasWhat) {
+            score -= 2;
+            issues.push('Description doesn\'t clearly state what the tool does');
+            suggestions.push('Start with an action verb explaining what the tool does');
+        }
+        // Check for "when" indicators
+        const hasWhen = /\b(when|for|to|if)\b/i.test(description);
+        if (!hasWhen) {
+            score -= 1;
+            issues.push('Description doesn\'t explain when to use the tool');
+        }
+        return {
+            passed: score >= 7,
+            score: Math.max(0, score),
+            reasoning: issues.length === 0
+                ? 'Description is complete'
+                : `Description has ${issues.length} completeness issue(s)`,
+            issues,
+            suggestions,
+        };
+    }
+    evaluateClarity(description) {
+        const issues = [];
+        let score = 10;
+        // Very short descriptions are unclear
+        if (description.length < 10) {
+            score -= 4;
+            issues.push('Description is too short to be clear');
+        }
+        // Check for technical jargon without explanation
+        const jargonPatterns = [
+            /\bAPI\b(?![^a-z]*(?:endpoint|call|request))/i,
+            /\bJSON\b/i,
+            /\bREST\b/i,
+            /\bGRPC\b/i,
+        ];
+        for (const pattern of jargonPatterns) {
+            if (pattern.test(description)) {
+                score -= 1;
+                issues.push('Description contains technical jargon');
+                break;
+            }
+        }
+        return {
+            passed: score >= 7,
+            score: Math.max(0, score),
+            reasoning: issues.length === 0
+                ? 'Description is clear and understandable'
+                : `Description has clarity issues: ${issues.join(', ')}`,
+            issues,
+            suggestions: issues.length > 0 ? ['Write for AI agents, not developers'] : [],
+        };
+    }
+    evaluateSteering(name, description) {
+        const issues = [];
+        const suggestions = [];
+        let score = 10;
+        // Good steering needs:
+        // 1. Clear action verb in name
+        // 2. Sufficient description length
+        // 3. Specific use case indicators
+        const hasActionVerb = SPECIFIC_VERBS.some((v) => name.toLowerCase().includes(v));
+        if (!hasActionVerb) {
+            score -= 2;
+            issues.push('Name lacks clear action verb for AI routing');
+        }
+        if (description.length < 30) {
+            score -= 2;
+            issues.push('Description too short for good AI steering');
+            suggestions.push('Provide more context for AI to understand when to use this tool');
+        }
+        // Check for parameter hints in description
+        const hasParamHints = /\b(with|using|by|specify|provide)\b/i.test(description);
+        if (!hasParamHints && description.length > 20) {
+            score -= 1;
+            issues.push('Description could mention key parameters');
+        }
+        return {
+            passed: score >= 7,
+            score: Math.max(0, score),
+            reasoning: issues.length === 0
+                ? 'Description provides good steering for AI agents'
+                : 'Description could better guide AI agents',
+            issues,
+            suggestions,
+        };
+    }
+    evaluateAtomicity(text) {
+        const issues = [];
+        let score = 10;
+        for (const pattern of NON_ATOMIC_PATTERNS) {
+            if (pattern.test(text)) {
+                score -= 2;
+                issues.push('Tool may be doing multiple things');
+                break;
+            }
+        }
+        // Count action verbs
+        let verbCount = 0;
+        for (const verb of SPECIFIC_VERBS) {
+            if (text.toLowerCase().includes(verb))
+                verbCount++;
+        }
+        if (verbCount > 2) {
+            score -= 2;
+            issues.push(`Tool description mentions ${verbCount} different actions`);
+        }
+        return {
+            passed: score >= 7,
+            score: Math.max(0, score),
+            reasoning: issues.length === 0
+                ? 'Tool appears to be atomic (single function)'
+                : 'Tool may be trying to do too many things',
+            issues,
+            suggestions: issues.length > 0
+                ? ['Consider splitting into multiple focused tools']
+                : [],
+        };
+    }
+}
+/**
+ * Create a mock provider
+ */
+export function createMockProvider() {
+    return new MockProvider();
+}
+export default MockProvider;
+//# sourceMappingURL=mock.js.map

package/dist/llm/providers/mock.js.map

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

package/dist/llm/providers/openrouter.d.ts

@@ -0,0 +1,53 @@
+/**
+ * OpenRouter LLM Provider
+ *
+ * Uses OpenRouter's OpenAI-compatible API to access various models
+ * including Claude.
+ */
+import type { LLMProvider, LLMConfig, EvaluationResult, DescriptionEvalContext, DescriptionQualityReport } from '../types.js';
+import type { DetectedTool } from '../../core/types/tool.js';
+/**
+ * OpenRouter LLM Provider implementation
+ */
+export declare class OpenRouterProvider implements LLMProvider {
+    name: string;
+    private config;
+    constructor(config?: Partial<LLMConfig>);
+    /**
+     * Check if the provider has valid credentials
+     */
+    isAvailable(): boolean;
+    /**
+     * Send a prompt and get a response
+     */
+    complete(prompt: string, systemPrompt?: string): Promise<string>;
+    /**
+     * Evaluate a specific aspect of a tool description
+     */
+    evaluateDescription(context: DescriptionEvalContext): Promise<EvaluationResult>;
+    /**
+     * Get a comprehensive quality report for a tool
+     */
+    getQualityReport(tool: DetectedTool): Promise<DescriptionQualityReport>;
+    /**
+     * Build the evaluation prompt for a specific aspect
+     */
+    private buildEvaluationPrompt;
+    /**
+     * Build the comprehensive quality report prompt
+     */
+    private buildQualityReportPrompt;
+    /**
+     * Parse the evaluation response from LLM
+     */
+    private parseEvaluationResponse;
+    /**
+     * Parse the quality report response from LLM
+     */
+    private parseQualityReport;
+}
+/**
+ * Create an OpenRouter provider with environment configuration
+ */
+export declare function createOpenRouterProvider(config?: Partial<LLMConfig>): OpenRouterProvider;
+export default OpenRouterProvider;