webmcp-cli 1.0.0 → 1.2.1

package/dist/llm/providers/openrouter.js

@@ -0,0 +1,321 @@
+/**
+ * OpenRouter LLM Provider
+ *
+ * Uses OpenRouter's OpenAI-compatible API to access various models
+ * including Claude.
+ */
+import { parseJsonObject } from '../json-response.js';
+const OPENROUTER_API_URL = 'https://openrouter.ai/api/v1/chat/completions';
+/**
+ * Default configuration
+ */
+const DEFAULT_CONFIG = {
+    model: 'anthropic/claude-sonnet-4',
+    temperature: 0.1,
+    maxTokens: 2048,
+};
+/**
+ * System prompt for tool description evaluation
+ */
+const EVALUATION_SYSTEM_PROMPT = `You are an expert at evaluating WebMCP tool definitions for AI agent readiness.
+Your task is to analyze tool descriptions and provide specific, actionable feedback.
+Be concise but thorough. Always provide a score from 0-10 and clear reasoning.
+Respond in JSON format only.`;
+/**
+ * OpenRouter LLM Provider implementation
+ */
+export class OpenRouterProvider {
+    name = 'openrouter';
+    config;
+    constructor(config = {}) {
+        const apiKey = config.apiKey || process.env['OPENROUTER_API_KEY'] || '';
+        this.config = {
+            apiKey,
+            model: config.model || DEFAULT_CONFIG.model,
+            baseUrl: config.baseUrl || OPENROUTER_API_URL,
+            temperature: config.temperature ?? DEFAULT_CONFIG.temperature,
+            maxTokens: config.maxTokens ?? DEFAULT_CONFIG.maxTokens,
+        };
+    }
+    /**
+     * Check if the provider has valid credentials
+     */
+    isAvailable() {
+        return Boolean(this.config.apiKey && this.config.apiKey.length > 10);
+    }
+    /**
+     * Send a prompt and get a response
+     */
+    async complete(prompt, systemPrompt) {
+        if (!this.isAvailable()) {
+            throw new Error('OpenRouter API key not configured');
+        }
+        const messages = [];
+        if (systemPrompt) {
+            messages.push({ role: 'system', content: systemPrompt });
+        }
+        messages.push({ role: 'user', content: prompt });
+        const response = await fetch(this.config.baseUrl, {
+            method: 'POST',
+            headers: {
+                'Authorization': `Bearer ${this.config.apiKey}`,
+                'Content-Type': 'application/json',
+                'HTTP-Referer': 'https://agentready.dev',
+                'X-Title': 'AgentReady CLI',
+            },
+            body: JSON.stringify({
+                model: this.config.model,
+                messages,
+                temperature: this.config.temperature,
+                max_tokens: this.config.maxTokens,
+            }),
+        });
+        if (!response.ok) {
+            const error = await response.text();
+            throw new Error(`OpenRouter API error: ${response.status} - ${error}`);
+        }
+        const data = await response.json();
+        return data.choices[0]?.message?.content || '';
+    }
+    /**
+     * Evaluate a specific aspect of a tool description
+     */
+    async evaluateDescription(context) {
+        const prompt = this.buildEvaluationPrompt(context);
+        try {
+            const response = await this.complete(prompt, EVALUATION_SYSTEM_PROMPT);
+            return this.parseEvaluationResponse(response, context.aspect);
+        }
+        catch (error) {
+            return {
+                passed: false,
+                score: 0,
+                reasoning: `Evaluation failed: ${error instanceof Error ? error.message : 'Unknown error'}`,
+                issues: ['LLM evaluation could not be completed'],
+            };
+        }
+    }
+    /**
+     * Get a comprehensive quality report for a tool
+     */
+    async getQualityReport(tool) {
+        const prompt = this.buildQualityReportPrompt(tool);
+        try {
+            const response = await this.complete(prompt, EVALUATION_SYSTEM_PROMPT);
+            return this.parseQualityReport(response, tool);
+        }
+        catch (error) {
+            // Return a default failed report
+            const failedResult = {
+                passed: false,
+                score: 0,
+                reasoning: 'Evaluation failed',
+            };
+            return {
+                overallScore: 0,
+                aspects: {
+                    clarity: failedResult,
+                    specificity: failedResult,
+                    positiveFraming: failedResult,
+                    completeness: failedResult,
+                    steeringPerformance: failedResult,
+                    atomicity: failedResult,
+                },
+                summary: `Quality report generation failed: ${error instanceof Error ? error.message : 'Unknown error'}`,
+                priorityImprovements: ['Unable to generate improvements due to evaluation failure'],
+            };
+        }
+    }
+    /**
+     * Build the evaluation prompt for a specific aspect
+     */
+    buildEvaluationPrompt(context) {
+        const { name, description, inputSchema, aspect } = context;
+        const aspectPrompts = {
+            clarity: `
+Evaluate the CLARITY of this tool description.
+- Is the description unambiguous?
+- Would an AI agent understand exactly what this tool does?
+- Are there any confusing terms or phrases?`,
+            specificity: `
+Evaluate the SPECIFICITY of the tool name and description.
+- Does the name use a specific action verb (search, create, delete, book) vs ambiguous ones (handle, process, do, manage)?
+- Is the description specific about what the tool does?
+Good: "search_flights", "create_booking", "delete_reservation"
+Bad: "handle_request", "process_data", "do_action"`,
+            'positive-framing': `
+Evaluate the POSITIVE FRAMING of this description.
+- Does it use positive instructions ("Returns flight options") vs negative limitations ("Do not use for...", "Don't call when...")?
+- Descriptions should tell the AI what the tool DOES, not what it shouldn't do.
+Check for: "do not", "don't", "never", "avoid", "cannot", "won't"`,
+            completeness: `
+Evaluate the COMPLETENESS of this description.
+- Does it explain WHAT the tool does? (required)
+- Does it explain WHEN to use the tool? (recommended)
+- Does it mention any important constraints or requirements?`,
+            steering: `
+Evaluate the STEERING PERFORMANCE of this description.
+- Will this description help an AI agent choose this tool at the right time?
+- Are there clear indicators of when to use vs not use this tool?
+- Could the description cause the AI to misuse the tool or miss opportunities to use it?
+Consider: Would an AI agent reading only this description and parameters make correct decisions?`,
+            atomicity: `
+Evaluate the ATOMICITY of this tool.
+- Does this tool do ONE thing well, or multiple unrelated things?
+- Is the description trying to cover too many use cases?
+- Would this be better split into multiple tools?
+Signs of non-atomic tools: "and", "or", "also", "additionally", multiple action verbs`,
+            similarity: `
+Analyze if this tool description could be confused with other common tools.
+- Are there standard patterns this description should follow?
+- Could the name/description clash with common tool conventions?`,
+            all: `
+Provide a comprehensive evaluation covering:
+1. Clarity - Is it unambiguous?
+2. Specificity - Uses specific verbs?
+3. Positive framing - Avoids negative language?
+4. Completeness - Explains what and when?
+5. Steering - Will it guide AI correctly?
+6. Atomicity - Does one thing well?`,
+        };
+        return `
+TOOL NAME: ${name}
+TOOL DESCRIPTION: ${description}
+${inputSchema ? `INPUT SCHEMA: ${inputSchema}` : ''}
+
+${aspectPrompts[aspect] || aspectPrompts['all']}
+
+Respond with a JSON object:
+{
+  "passed": boolean,
+  "score": number (0-10),
+  "reasoning": "string explaining your evaluation",
+  "issues": ["array of specific issues found"],
+  "suggestions": ["array of improvement suggestions"]
+}`;
+    }
+    /**
+     * Build the comprehensive quality report prompt
+     */
+    buildQualityReportPrompt(tool) {
+        const schemaStr = tool.inputSchema
+            ? JSON.stringify(tool.inputSchema, null, 2)
+            : 'No schema defined';
+        return `
+Analyze this WebMCP tool definition and provide a comprehensive quality report.
+
+TOOL NAME: ${tool.name}
+TOOL DESCRIPTION: ${tool.description}
+INPUT SCHEMA:
+${schemaStr}
+${tool.annotations ? `ANNOTATIONS: ${JSON.stringify(tool.annotations)}` : ''}
+
+Evaluate the following aspects (score 0-10 each):
+
+1. CLARITY: Is the description unambiguous? Will an AI understand exactly what this does?
+
+2. SPECIFICITY: Does the name use specific action verbs (search, create, delete) vs ambiguous ones (handle, process)?
+
+3. POSITIVE FRAMING: Does it use positive instructions vs negative limitations ("do not", "don't", "never")?
+
+4. COMPLETENESS: Does it explain what the tool does and when to use it?
+
+5. STEERING PERFORMANCE: Will this description help AI agents choose and use this tool correctly?
+   - Consider: routing accuracy (will AI pick this tool at the right time?)
+   - Consider: parameter accuracy (will AI fill parameters correctly?)
+   - Consider: avoiding hallucination (is the description specific enough?)
+
+6. ATOMICITY: Does this tool do one thing well, or is it trying to do too much?
+
+Respond with JSON:
+{
+  "overallScore": number (0-100, weighted average),
+  "aspects": {
+    "clarity": { "passed": boolean, "score": number, "reasoning": "...", "issues": [], "suggestions": [] },
+    "specificity": { "passed": boolean, "score": number, "reasoning": "...", "issues": [], "suggestions": [] },
+    "positiveFraming": { "passed": boolean, "score": number, "reasoning": "...", "issues": [], "suggestions": [] },
+    "completeness": { "passed": boolean, "score": number, "reasoning": "...", "issues": [], "suggestions": [] },
+    "steeringPerformance": { "passed": boolean, "score": number, "reasoning": "...", "issues": [], "suggestions": [] },
+    "atomicity": { "passed": boolean, "score": number, "reasoning": "...", "issues": [], "suggestions": [] }
+  },
+  "summary": "Overall assessment in 2-3 sentences",
+  "priorityImprovements": ["Top 3 most important improvements"],
+  "suggestedDescription": "Optional: A rewritten, improved description"
+}`;
+    }
+    /**
+     * Parse the evaluation response from LLM
+     */
+    parseEvaluationResponse(response, aspect) {
+        try {
+            const parsed = parseJsonObject(response);
+            return {
+                passed: parsed.passed ?? (parsed.score !== undefined && parsed.score >= 7),
+                score: parsed.score ?? 0,
+                reasoning: parsed.reasoning ?? 'No reasoning provided',
+                issues: parsed.issues ?? [],
+                suggestions: parsed.suggestions ?? [],
+                rawResponse: response,
+            };
+        }
+        catch (error) {
+            return {
+                passed: false,
+                score: 0,
+                reasoning: `Failed to parse LLM response for ${aspect}: ${error instanceof Error ? error.message : 'Parse error'}`,
+                issues: ['Response parsing failed'],
+                rawResponse: response,
+            };
+        }
+    }
+    /**
+     * Parse the quality report response from LLM
+     */
+    parseQualityReport(response, _tool) {
+        const defaultResult = {
+            passed: false,
+            score: 0,
+            reasoning: 'Parse error',
+        };
+        try {
+            const parsed = parseJsonObject(response);
+            return {
+                overallScore: parsed.overallScore ?? 0,
+                aspects: {
+                    clarity: parsed.aspects?.clarity ?? defaultResult,
+                    specificity: parsed.aspects?.specificity ?? defaultResult,
+                    positiveFraming: parsed.aspects?.positiveFraming ?? defaultResult,
+                    completeness: parsed.aspects?.completeness ?? defaultResult,
+                    steeringPerformance: parsed.aspects?.steeringPerformance ?? defaultResult,
+                    atomicity: parsed.aspects?.atomicity ?? defaultResult,
+                },
+                summary: parsed.summary ?? 'Unable to generate summary',
+                priorityImprovements: parsed.priorityImprovements ?? [],
+                suggestedDescription: parsed.suggestedDescription,
+            };
+        }
+        catch (error) {
+            return {
+                overallScore: 0,
+                aspects: {
+                    clarity: defaultResult,
+                    specificity: defaultResult,
+                    positiveFraming: defaultResult,
+                    completeness: defaultResult,
+                    steeringPerformance: defaultResult,
+                    atomicity: defaultResult,
+                },
+                summary: `Failed to parse quality report: ${error instanceof Error ? error.message : 'Parse error'}`,
+                priorityImprovements: [],
+            };
+        }
+    }
+}
+/**
+ * Create an OpenRouter provider with environment configuration
+ */
+export function createOpenRouterProvider(config) {
+    return new OpenRouterProvider(config);
+}
+export default OpenRouterProvider;
+//# sourceMappingURL=openrouter.js.map

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

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

package/dist/llm/request-cache.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Universal LLM Request Cache
+ *
+ * Caches OpenRouter API responses by full request body hash.
+ * Ensures identical requests never hit the API twice.
+ */
+export declare class LLMRequestCache {
+    private cache;
+    constructor();
+    getCacheKey(requestBody: object): string;
+    get(requestBody: object): string | null;
+    set(requestBody: object, response: string, model: string): void;
+    has(requestBody: object): boolean;
+    private loadCache;
+    private saveCache;
+    /**
+     * Get cache statistics
+     */
+    getStats(): {
+        entries: number;
+        sizeBytes: number;
+    };
+    /**
+     * Clear expired entries
+     */
+    cleanup(): number;
+}
+export declare function getRequestCache(): LLMRequestCache;

package/dist/llm/request-cache.js

@@ -0,0 +1,99 @@
+/**
+ * Universal LLM Request Cache
+ *
+ * Caches OpenRouter API responses by full request body hash.
+ * Ensures identical requests never hit the API twice.
+ */
+import { createHash } from 'crypto';
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'fs';
+import { homedir } from 'os';
+import { join } from 'path';
+const CACHE_DIR = join(homedir(), '.webmcp', 'cache');
+const REQUEST_CACHE_FILE = join(CACHE_DIR, 'llm-requests.json');
+const CACHE_TTL = 30 * 24 * 60 * 60 * 1000; // 30 days
+export class LLMRequestCache {
+    cache;
+    constructor() {
+        this.cache = this.loadCache();
+    }
+    getCacheKey(requestBody) {
+        const normalized = JSON.stringify(requestBody);
+        return createHash('sha256').update(normalized).digest('hex');
+    }
+    get(requestBody) {
+        const key = this.getCacheKey(requestBody);
+        const entry = this.cache.entries[key];
+        if (!entry)
+            return null;
+        if (Date.now() - entry.timestamp > CACHE_TTL) {
+            delete this.cache.entries[key];
+            this.saveCache();
+            return null;
+        }
+        return entry.response;
+    }
+    set(requestBody, response, model) {
+        const key = this.getCacheKey(requestBody);
+        this.cache.entries[key] = {
+            response,
+            timestamp: Date.now(),
+            model,
+        };
+        this.saveCache();
+    }
+    has(requestBody) {
+        return this.get(requestBody) !== null;
+    }
+    loadCache() {
+        try {
+            if (existsSync(REQUEST_CACHE_FILE)) {
+                return JSON.parse(readFileSync(REQUEST_CACHE_FILE, 'utf-8'));
+            }
+        }
+        catch { /* ignore */ }
+        return { version: 1, entries: {} };
+    }
+    saveCache() {
+        try {
+            if (!existsSync(CACHE_DIR)) {
+                mkdirSync(CACHE_DIR, { recursive: true });
+            }
+            writeFileSync(REQUEST_CACHE_FILE, JSON.stringify(this.cache, null, 2));
+        }
+        catch { /* ignore */ }
+    }
+    /**
+     * Get cache statistics
+     */
+    getStats() {
+        const entries = Object.keys(this.cache.entries).length;
+        const sizeBytes = JSON.stringify(this.cache).length;
+        return { entries, sizeBytes };
+    }
+    /**
+     * Clear expired entries
+     */
+    cleanup() {
+        const now = Date.now();
+        let removed = 0;
+        for (const [key, entry] of Object.entries(this.cache.entries)) {
+            if (now - entry.timestamp > CACHE_TTL) {
+                delete this.cache.entries[key];
+                removed++;
+            }
+        }
+        if (removed > 0) {
+            this.saveCache();
+        }
+        return removed;
+    }
+}
+// Singleton instance
+let instance = null;
+export function getRequestCache() {
+    if (!instance) {
+        instance = new LLMRequestCache();
+    }
+    return instance;
+}
+//# sourceMappingURL=request-cache.js.map

package/dist/llm/request-cache.js.map

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