@houtini/lm 1.0.0

package/dist/validation/output-validator.js

@@ -0,0 +1,262 @@
+/**
+ * Output Validation System for Houtini LM MCP
+ * Centralized validation and formatting for all function outputs
+ * Based on Functional Specification v4.0
+ */
+/**
+ * Central Output Validator Class
+ * All functions should use this to ensure consistent output format
+ */
+export class OutputValidator {
+    /**
+     * Create a successful analysis response
+     */
+    static createAnalyzeResponse(data, modelUsed, executionTimeMs) {
+        return {
+            success: true,
+            timestamp: new Date().toISOString(),
+            modelUsed,
+            executionTimeMs: executionTimeMs || (Date.now() - this.startTime),
+            data
+        };
+    }
+    /**
+     * Create a successful generation response
+     */
+    static createGenerateResponse(data, modelUsed, executionTimeMs) {
+        return {
+            success: true,
+            timestamp: new Date().toISOString(),
+            modelUsed,
+            executionTimeMs: executionTimeMs || (Date.now() - this.startTime),
+            data
+        };
+    }
+    /**
+     * Create a successful multi-file response
+     */
+    static createMultiFileResponse(data, modelUsed, executionTimeMs) {
+        return {
+            success: true,
+            timestamp: new Date().toISOString(),
+            modelUsed,
+            executionTimeMs: executionTimeMs || (Date.now() - this.startTime),
+            data
+        };
+    }
+    /**
+     * Create a successful system response
+     */
+    static createSystemResponse(data, modelUsed = 'system', executionTimeMs) {
+        return {
+            success: true,
+            timestamp: new Date().toISOString(),
+            modelUsed,
+            executionTimeMs: executionTimeMs || (Date.now() - this.startTime),
+            data
+        };
+    }
+    /**
+     * Create an error response (for any function type)
+     */
+    static createErrorResponse(errorCode, errorMessage, details, modelUsed = 'unknown', executionTimeMs) {
+        return {
+            success: false,
+            timestamp: new Date().toISOString(),
+            modelUsed,
+            executionTimeMs: executionTimeMs || (Date.now() - this.startTime),
+            error: {
+                code: errorCode,
+                message: errorMessage,
+                details
+            }
+        };
+    }
+    /**
+     * Validate that a response matches the expected schema
+     */
+    static validateResponse(response, expectedType) {
+        // Basic structure validation
+        if (!response || typeof response !== 'object') {
+            return false;
+        }
+        // Required base fields
+        const requiredFields = ['success', 'timestamp', 'modelUsed', 'executionTimeMs'];
+        for (const field of requiredFields) {
+            if (!(field in response)) {
+                return false;
+            }
+        }
+        // Type-specific validation
+        if (response.success && !response.data) {
+            return false;
+        }
+        if (!response.success && !response.error) {
+            return false;
+        }
+        return true;
+    }
+    /**
+     * Set execution start time for timing calculations
+     */
+    static setStartTime() {
+        this.startTime = Date.now();
+    }
+    /**
+     * Get execution time since start
+     */
+    static getExecutionTime() {
+        return Date.now() - this.startTime;
+    }
+}
+OutputValidator.startTime = Date.now();
+/**
+ * Standardize error codes
+ */
+OutputValidator.ErrorCodes = {
+    INVALID_INPUT: 'INVALID_INPUT',
+    FILE_NOT_FOUND: 'FILE_NOT_FOUND',
+    MODEL_ERROR: 'MODEL_ERROR',
+    PARSING_ERROR: 'PARSING_ERROR',
+    VALIDATION_ERROR: 'VALIDATION_ERROR',
+    TIMEOUT: 'TIMEOUT',
+    SYSTEM_ERROR: 'SYSTEM_ERROR'
+};
+// Export specific response parsers for each function category
+export class AnalysisOutputParser {
+    /**
+     * Parse LLM response into structured analysis data
+     */
+    static parseAnalysisResponse(llmResponse, functionName) {
+        try {
+            // Try to parse as JSON first
+            const parsed = JSON.parse(llmResponse);
+            return this.validateAndNormalizeAnalysis(parsed, functionName);
+        }
+        catch {
+            // If not JSON, parse as structured text
+            return this.parseStructuredText(llmResponse, functionName);
+        }
+    }
+    static validateAndNormalizeAnalysis(parsed, functionName) {
+        // Default structure
+        const data = {
+            summary: '',
+            findings: [],
+            suggestions: [],
+            metadata: {}
+        };
+        // Extract summary
+        if (parsed.summary || parsed.analysis) {
+            data.summary = parsed.summary || parsed.analysis;
+        }
+        // Extract findings
+        if (Array.isArray(parsed.findings)) {
+            data.findings = parsed.findings.map(this.normalizeFinding);
+        }
+        else if (Array.isArray(parsed.issues)) {
+            data.findings = parsed.issues.map(this.normalizeFinding);
+        }
+        // Extract suggestions
+        if (Array.isArray(parsed.suggestions)) {
+            data.suggestions = parsed.suggestions;
+        }
+        else if (Array.isArray(parsed.recommendations)) {
+            data.suggestions = parsed.recommendations;
+        }
+        // Function-specific parsing
+        if (functionName === 'analyze_single_file') {
+            data.metadata = {
+                structure: parsed.structure || {},
+                metrics: parsed.metrics || {},
+                patterns: parsed.patterns || []
+            };
+        }
+        return data;
+    }
+    static parseStructuredText(text, functionName) {
+        // Parse structured text responses (fallback)
+        const sections = text.split(/\n\n+/);
+        return {
+            summary: sections[0] || text.substring(0, 200),
+            findings: this.extractFindings(text),
+            suggestions: this.extractSuggestions(text),
+            metadata: { rawResponse: text }
+        };
+    }
+    static normalizeFinding(finding) {
+        return {
+            type: finding.type || 'info',
+            severity: finding.severity || 'medium',
+            message: finding.message || finding.description || '',
+            location: finding.location,
+            recommendation: finding.recommendation || finding.fix
+        };
+    }
+    static extractFindings(text) {
+        const findings = [];
+        // Simple regex-based extraction for common patterns
+        const issuePatterns = [
+            /(?:issue|problem|error):\s*(.+)/gi,
+            /(?:warning|caution):\s*(.+)/gi,
+            /(?:suggestion|improvement):\s*(.+)/gi
+        ];
+        for (const pattern of issuePatterns) {
+            const matches = text.matchAll(pattern);
+            for (const match of matches) {
+                findings.push({
+                    type: 'issue',
+                    severity: 'medium',
+                    message: match[1].trim()
+                });
+            }
+        }
+        return findings;
+    }
+    static extractSuggestions(text) {
+        const suggestions = [];
+        const suggestionPatterns = [
+            /(?:recommend|suggest)(?:ation)?:\s*(.+)/gi,
+            /(?:consider|try):\s*(.+)/gi
+        ];
+        for (const pattern of suggestionPatterns) {
+            const matches = text.matchAll(pattern);
+            for (const match of matches) {
+                suggestions.push(match[1].trim());
+            }
+        }
+        return suggestions;
+    }
+}
+export class GenerationOutputParser {
+    /**
+     * Parse LLM response into structured generation data
+     */
+    static parseGenerationResponse(llmResponse, functionName, language) {
+        const lines = llmResponse.split('\n').length;
+        return {
+            content: llmResponse,
+            metadata: {
+                type: this.getContentType(functionName),
+                language: language || 'javascript',
+                framework: 'auto-detected'
+            },
+            statistics: {
+                linesGenerated: lines,
+                tokensUsed: Math.floor(llmResponse.length / 4) // Rough estimate
+            }
+        };
+    }
+    static getContentType(functionName) {
+        const typeMap = {
+            'generate_unit_tests': 'test-code',
+            'generate_documentation': 'documentation',
+            'generate_wordpress_plugin': 'plugin-code',
+            'generate_responsive_component': 'component-code',
+            'convert_to_typescript': 'typescript-code',
+            'suggest_refactoring': 'refactored-code'
+        };
+        return typeMap[functionName] || 'generated-content';
+    }
+}
+//# sourceMappingURL=output-validator.js.map

package/dist/validation/output-validator.js.map

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

package/dist/validation/response-factory.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Response Factory for Houtini LM MCP Functions
+ * Makes it incredibly easy to create correctly formatted responses
+ * Usage: ResponseFactory.createAnalyzeSingleFileResponse(data, modelId)
+ */
+import { FunctionName, FunctionResponse, AnalyzeSingleFileResponse, SecurityAuditResponse, GenerateUnitTestsResponse, GenerateDocumentationResponse, HealthCheckResponse } from './schemas.js';
+export declare class ResponseFactory {
+    private static startTime;
+    /**
+     * Set execution start time
+     */
+    static setStartTime(): void;
+    /**
+     * Get execution time since start
+     */
+    private static getExecutionTime;
+    static createAnalyzeSingleFileResponse(summary: string, structure: AnalyzeSingleFileResponse['data']['structure'], metrics: AnalyzeSingleFileResponse['data']['metrics'], findings: AnalyzeSingleFileResponse['data']['findings'], patterns: string[], suggestions: string[], modelUsed: string): AnalyzeSingleFileResponse;
+    static createSecurityAuditResponse(summary: SecurityAuditResponse['data']['summary'], vulnerabilities: SecurityAuditResponse['data']['vulnerabilities'], recommendations: string[], passedChecks: string[], dependencies: SecurityAuditResponse['data']['dependencies'] | undefined, modelUsed: string): SecurityAuditResponse;
+    static createGenerateUnitTestsResponse(tests: string, coverage: GenerateUnitTestsResponse['data']['coverage'], testCount: number, testTypes: GenerateUnitTestsResponse['data']['testTypes'], mocks: string[], setupRequired: string[], modelUsed: string): GenerateUnitTestsResponse;
+    static createGenerateDocumentationResponse(documentation: string, sections: GenerateDocumentationResponse['data']['sections'], metadata: GenerateDocumentationResponse['data']['metadata'], modelUsed: string): GenerateDocumentationResponse;
+    static createSystemResponse(data: {
+        status: string;
+        details: Record<string, any>;
+    }, modelUsed?: string, executionTimeMs?: number): any;
+    static createHealthCheckResponse(status: "healthy" | "unhealthy", connection: "established" | "failed", lmStudioUrl: string, error?: string, suggestion?: string, details?: HealthCheckResponse['data']['details'], contextLength?: number): HealthCheckResponse;
+    static createErrorResponse(functionName: FunctionName, errorCode: string, errorMessage: string, details?: any, modelUsed?: string): {
+        success: boolean;
+        timestamp: string;
+        modelUsed: string;
+        executionTimeMs: number;
+        error: {
+            code: string;
+            message: string;
+            details: any;
+        };
+    };
+    /**
+     * Universal response parser for all MCP functions
+     * Works with the universal template architecture - no function-specific switch statements needed!
+     */
+    static parseAndCreateResponse<T extends FunctionName>(functionName: T, llmResponse: string, modelUsed: string, additionalData?: any): FunctionResponse<T>;
+    private static parseHealthCheck;
+}
+//# sourceMappingURL=response-factory.d.ts.map

package/dist/validation/response-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-factory.d.ts","sourceRoot":"","sources":["../../src/validation/response-factory.ts"],"names":[],"mappings":"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"}

package/dist/validation/response-factory.js

@@ -0,0 +1,202 @@
+/**
+ * Response Factory for Houtini LM MCP Functions
+ * Makes it incredibly easy to create correctly formatted responses
+ * Usage: ResponseFactory.createAnalyzeSingleFileResponse(data, modelId)
+ */
+import { OutputValidator } from './output-validator.js';
+export class ResponseFactory {
+    /**
+     * Set execution start time
+     */
+    static setStartTime() {
+        this.startTime = Date.now();
+    }
+    /**
+     * Get execution time since start
+     */
+    static getExecutionTime() {
+        return Date.now() - this.startTime;
+    }
+    // ====================
+    // ANALYSIS FUNCTIONS
+    // ====================
+    static createAnalyzeSingleFileResponse(summary, structure, metrics, findings, patterns, suggestions, modelUsed) {
+        return {
+            success: true,
+            timestamp: new Date().toISOString(),
+            modelUsed,
+            executionTimeMs: this.getExecutionTime(),
+            data: {
+                summary,
+                structure,
+                metrics,
+                findings,
+                patterns,
+                suggestions
+            }
+        };
+    }
+    static createSecurityAuditResponse(summary, vulnerabilities, recommendations, passedChecks, dependencies, modelUsed) {
+        return {
+            success: true,
+            timestamp: new Date().toISOString(),
+            modelUsed,
+            executionTimeMs: this.getExecutionTime(),
+            data: {
+                summary,
+                vulnerabilities,
+                dependencies,
+                recommendations,
+                passedChecks
+            }
+        };
+    }
+    // ====================
+    // GENERATION FUNCTIONS  
+    // ====================
+    static createGenerateUnitTestsResponse(tests, coverage, testCount, testTypes, mocks, setupRequired, modelUsed) {
+        return {
+            success: true,
+            timestamp: new Date().toISOString(),
+            modelUsed,
+            executionTimeMs: this.getExecutionTime(),
+            data: {
+                tests,
+                coverage,
+                testCount,
+                testTypes,
+                mocks,
+                setupRequired
+            }
+        };
+    }
+    static createGenerateDocumentationResponse(documentation, sections, metadata, modelUsed) {
+        return {
+            success: true,
+            timestamp: new Date().toISOString(),
+            modelUsed,
+            executionTimeMs: this.getExecutionTime(),
+            data: {
+                documentation,
+                sections,
+                metadata
+            }
+        };
+    }
+    // ====================
+    // SYSTEM FUNCTIONS
+    // ====================
+    static createSystemResponse(data, modelUsed = 'system', executionTimeMs) {
+        return {
+            success: true,
+            timestamp: new Date().toISOString(),
+            modelUsed,
+            executionTimeMs: executionTimeMs || this.getExecutionTime(),
+            data
+        };
+    }
+    static createHealthCheckResponse(status, connection, lmStudioUrl, error, suggestion, details, contextLength) {
+        return {
+            success: status === "healthy",
+            timestamp: new Date().toISOString(),
+            modelUsed: details?.activeModel?.identifier || 'none',
+            executionTimeMs: this.getExecutionTime(),
+            data: {
+                status,
+                connection,
+                lmStudioUrl,
+                timestamp: new Date().toISOString(),
+                error,
+                suggestion,
+                contextLength,
+                details
+            }
+        };
+    }
+    // ====================
+    // ERROR RESPONSES
+    // ====================
+    static createErrorResponse(functionName, errorCode, errorMessage, details, modelUsed = 'unknown') {
+        return {
+            success: false,
+            timestamp: new Date().toISOString(),
+            modelUsed,
+            executionTimeMs: this.getExecutionTime(),
+            error: {
+                code: errorCode,
+                message: errorMessage,
+                details
+            }
+        };
+    }
+    // ====================
+    // SMART PARSING HELPERS
+    // ====================
+    /**
+     * Universal response parser for all MCP functions
+     * Works with the universal template architecture - no function-specific switch statements needed!
+     */
+    static parseAndCreateResponse(functionName, llmResponse, modelUsed, additionalData = {}) {
+        this.setStartTime();
+        try {
+            // Handle special case for health_check which needs additionalData
+            if (functionName === 'health_check') {
+                return this.parseHealthCheck(llmResponse, modelUsed, additionalData);
+            }
+            // Universal JSON parsing with markdown code block handling
+            let parsed;
+            try {
+                // Strip markdown JSON code blocks if present
+                let cleanedResponse = llmResponse.trim();
+                if (cleanedResponse.startsWith('```json') && cleanedResponse.endsWith('```')) {
+                    cleanedResponse = cleanedResponse.slice(7, -3).trim();
+                }
+                else if (cleanedResponse.startsWith('```') && cleanedResponse.endsWith('```')) {
+                    // Handle generic code blocks that might contain JSON
+                    cleanedResponse = cleanedResponse.slice(3, -3).trim();
+                }
+                parsed = JSON.parse(cleanedResponse);
+                // If it's valid JSON, return it properly structured
+                return {
+                    success: true,
+                    timestamp: new Date().toISOString(),
+                    modelUsed,
+                    executionTimeMs: this.getExecutionTime(),
+                    data: parsed
+                };
+            }
+            catch {
+                // If not JSON, fall back to content wrapping
+                return {
+                    success: true,
+                    timestamp: new Date().toISOString(),
+                    modelUsed,
+                    executionTimeMs: this.getExecutionTime(),
+                    data: {
+                        content: llmResponse,
+                        metadata: {
+                            functionName,
+                            parsedAt: new Date().toISOString(),
+                            responseLength: llmResponse.length
+                        }
+                    }
+                };
+            }
+        }
+        catch (error) {
+            return this.createErrorResponse(functionName, OutputValidator.ErrorCodes.PARSING_ERROR, `Failed to parse LLM response: ${error.message}`, { originalResponse: llmResponse.substring(0, 500) }, modelUsed);
+        }
+    }
+    // ====================
+    // HEALTH CHECK SPECIAL CASE  
+    // ====================
+    // HEALTH CHECK SPECIAL CASE  
+    // ====================
+    static parseHealthCheck(llmResponse, modelUsed, additionalData) {
+        // health_check is a special case - it doesn't return JSON from LLM, 
+        // but instead gets structured data from additionalData
+        return this.createHealthCheckResponse(additionalData.status || 'healthy', additionalData.connection || 'established', additionalData.lmStudioUrl || 'ws://localhost:1234', additionalData.error, additionalData.suggestion, additionalData.details);
+    }
+}
+ResponseFactory.startTime = Date.now();
+//# sourceMappingURL=response-factory.js.map

package/dist/validation/response-factory.js.map

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