@houtini/lm 1.0.0

package/dist/types.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Core Types for Houtini LM MCP Server v1.0
+ * Modern plugin architecture - no legacy prompt handling
+ */
+export interface Config {
+    lmStudioUrl: string;
+    modelName: string;
+    temperature: number;
+    maxTokens: number;
+    topP: number;
+    timeout: number;
+    maxFileSize: number;
+    supportedFileTypes: string[];
+    security?: {
+        enableSanitisation: boolean;
+        enableInjectionDetection: boolean;
+        enableOutputEncoding: boolean;
+        injectionThreshold: number;
+        allowedDirectories: string[];
+        maxInputSize: Record<string, number>;
+    };
+}
+/**
+ * LM Studio Client Configuration
+ */
+export interface LMStudioConfig {
+    baseUrl: string;
+    timeout?: number;
+}
+/**
+ * Plugin execution context
+ */
+export interface PluginContext {
+    modelUsed?: string;
+    executionTimeMs?: number;
+    contextLength?: number;
+}
+/**
+ * Security validation result
+ */
+export interface SecurityResult {
+    blocked: boolean;
+    sanitised: any;
+    warnings: string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,MAAM;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,QAAQ,CAAC,EAAE;QACT,kBAAkB,EAAE,OAAO,CAAC;QAC5B,wBAAwB,EAAE,OAAO,CAAC;QAClC,oBAAoB,EAAE,OAAO,CAAC;QAC9B,kBAAkB,EAAE,MAAM,CAAC;QAC3B,kBAAkB,EAAE,MAAM,EAAE,CAAC;QAC7B,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KACtC,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,GAAG,CAAC;IACf,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB"}

package/dist/types.js

@@ -0,0 +1,6 @@
+/**
+ * Core Types for Houtini LM MCP Server v1.0
+ * Modern plugin architecture - no legacy prompt handling
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/utils/css-parser.d.ts

@@ -0,0 +1,26 @@
+export interface SimpleSelector {
+    selector: string;
+    file: string;
+    line?: number;
+    mediaQuery?: string;
+}
+export declare class CssParser {
+    /**
+     * Extract all CSS selectors from content with basic metadata
+     */
+    static extractSelectors(cssContent: string, fileName?: string): SimpleSelector[];
+    /**
+     * Fallback simple selector extraction using regex
+     */
+    private static extractSelectorsSimple;
+    /**
+     * Get CSS file size in KB for reporting
+     */
+    static getFileSizeKB(cssContent: string): number;
+    /**
+     * Basic framework detection (just names, let LLM do the analysis)
+     */
+    static detectBasicFrameworks(cssContent: string): string[];
+}
+export default CssParser;
+//# sourceMappingURL=css-parser.d.ts.map

package/dist/utils/css-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"css-parser.d.ts","sourceRoot":"","sources":["../../src/utils/css-parser.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,qBAAa,SAAS;IAEpB;;OAEG;IACH,MAAM,CAAC,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAW,GAAG,cAAc,EAAE;IA0DpF;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,sBAAsB;IAiCrC;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM;IAIhD;;OAEG;IACH,MAAM,CAAC,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE;CAqB3D;AAED,eAAe,SAAS,CAAC"}

package/dist/utils/css-parser.js

@@ -0,0 +1,117 @@
+import * as csstree from 'css-tree';
+export class CssParser {
+    /**
+     * Extract all CSS selectors from content with basic metadata
+     */
+    static extractSelectors(cssContent, fileName = '') {
+        const selectors = [];
+        try {
+            const ast = csstree.parse(cssContent, {
+                onParseError: (error) => {
+                    console.warn(`CSS parse warning in ${fileName}: ${error.message}`);
+                }
+            });
+            csstree.walk(ast, (node, item, list) => {
+                if (node.type === 'Rule') {
+                    const selectorList = node.prelude;
+                    if (selectorList && selectorList.type === 'SelectorList') {
+                        selectorList.children.forEach((selector) => {
+                            const selectorText = csstree.generate(selector);
+                            selectors.push({
+                                selector: selectorText,
+                                file: fileName,
+                                line: node.loc?.start.line
+                            });
+                        });
+                    }
+                }
+                // Handle @media rules
+                if (node.type === 'Atrule' && node.name === 'media') {
+                    const mediaQuery = csstree.generate(node.prelude);
+                    if (node.block) {
+                        csstree.walk(node.block, (innerNode) => {
+                            if (innerNode.type === 'Rule') {
+                                const selectorList = innerNode.prelude;
+                                if (selectorList && selectorList.type === 'SelectorList') {
+                                    selectorList.children.forEach((selector) => {
+                                        const selectorText = csstree.generate(selector);
+                                        selectors.push({
+                                            selector: selectorText,
+                                            file: fileName,
+                                            line: innerNode.loc?.start.line,
+                                            mediaQuery: mediaQuery
+                                        });
+                                    });
+                                }
+                            }
+                        });
+                    }
+                }
+            });
+        }
+        catch (error) {
+            console.warn(`Failed to parse CSS in ${fileName}: ${error}`);
+            // Fallback to simple regex parsing
+            return this.extractSelectorsSimple(cssContent, fileName);
+        }
+        return selectors;
+    }
+    /**
+     * Fallback simple selector extraction using regex
+     */
+    static extractSelectorsSimple(css, fileName) {
+        const selectors = [];
+        // Remove comments and clean up
+        css = css.replace(/\/\*[\s\S]*?\*\//g, '');
+        // Simple rule matching
+        const ruleRegex = /([^{}]+)\s*{[^{}]*}/g;
+        let match;
+        let lineNumber = 1;
+        while ((match = ruleRegex.exec(css)) !== null) {
+            const selectorPart = match[1].trim();
+            if (selectorPart && !selectorPart.startsWith('@')) {
+                const multiSelectors = selectorPart.split(',');
+                multiSelectors.forEach(sel => {
+                    const trimmed = sel.trim();
+                    if (trimmed) {
+                        selectors.push({
+                            selector: trimmed,
+                            file: fileName,
+                            line: lineNumber
+                        });
+                    }
+                });
+            }
+            // Rough line counting
+            lineNumber += (match[0].match(/\n/g) || []).length;
+        }
+        return selectors;
+    }
+    /**
+     * Get CSS file size in KB for reporting
+     */
+    static getFileSizeKB(cssContent) {
+        return Math.round(Buffer.byteLength(cssContent, 'utf8') / 1024);
+    }
+    /**
+     * Basic framework detection (just names, let LLM do the analysis)
+     */
+    static detectBasicFrameworks(cssContent) {
+        const frameworks = [];
+        if (/\.(btn|col|row|container|d-|text-|bg-|border-)/g.test(cssContent)) {
+            frameworks.push('Bootstrap');
+        }
+        if (/@tailwind|@apply|\.(w-|h-|p-|m-|flex|grid)/g.test(cssContent)) {
+            frameworks.push('Tailwind');
+        }
+        if (/\.(wp-|block-|aligncenter|alignleft|sticky)/g.test(cssContent)) {
+            frameworks.push('WordPress');
+        }
+        if (/\.(foundation|grid-|cell|grid-x)/g.test(cssContent)) {
+            frameworks.push('Foundation');
+        }
+        return frameworks;
+    }
+}
+export default CssParser;
+//# sourceMappingURL=css-parser.js.map

package/dist/utils/css-parser.js.map

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

package/dist/utils/path-resolver.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Analyze a path for MCP usage and provide intelligent suggestions
+ */
+export declare function analyzePathForMCP(path: string): Promise<any>;
+/**
+ * Enhanced validation helper with path intelligence
+ */
+export declare function validatePathWithHints(params: any, pathParam: 'filePath' | 'projectPath'): Promise<any>;
+/**
+ * Smart path suggestion helper
+ */
+export declare function suggestParameterForPath(pathString: string): 'filePath' | 'projectPath';
+//# sourceMappingURL=path-resolver.d.ts.map

package/dist/utils/path-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-resolver.d.ts","sourceRoot":"","sources":["../../src/utils/path-resolver.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,gBAkCnD;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,UAAU,GAAG,aAAa,gBA0B7F;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,MAAM,GAAG,UAAU,GAAG,aAAa,CAgBtF"}

package/dist/utils/path-resolver.js

@@ -0,0 +1,78 @@
+import { stat } from 'fs/promises';
+import { extname, basename } from 'path';
+/**
+ * Analyze a path for MCP usage and provide intelligent suggestions
+ */
+export async function analyzePathForMCP(path) {
+    try {
+        const stats = await stat(path);
+        const result = {
+            exists: true,
+            type: stats.isDirectory() ? 'directory' : 'file',
+            suggestedParameter: stats.isDirectory() ? 'projectPath' : 'filePath',
+            size: stats.size,
+            canRead: true,
+            lastModified: stats.mtime,
+            extension: stats.isFile() ? extname(path) : null,
+            basename: basename(path)
+        };
+        // Add helpful hints based on analysis
+        if (stats.isDirectory()) {
+            result.hint = `This is a directory. Use 'projectPath' parameter for multi-file analysis.`;
+        }
+        else {
+            result.hint = `This is a file (${result.extension || 'no extension'}). Use 'filePath' parameter for single-file analysis.`;
+        }
+        return result;
+    }
+    catch (error) {
+        return {
+            exists: false,
+            type: 'unknown',
+            error: error.message,
+            suggestedParameter: 'filePath', // default guess
+            hint: `Path not found or inaccessible. Check the path exists and you have permissions.`,
+            canRead: false
+        };
+    }
+}
+/**
+ * Enhanced validation helper with path intelligence
+ */
+export async function validatePathWithHints(params, pathParam) {
+    const path = params[pathParam];
+    if (!path)
+        return null;
+    const analysis = await analyzePathForMCP(path);
+    if (!analysis.exists) {
+        throw new Error(`Path not found: ${path}. ${analysis.hint}`);
+    }
+    // Check for parameter mismatch
+    if (pathParam === 'filePath' && analysis.type === 'directory') {
+        throw new Error(`Parameter mismatch: '${path}' is a directory, but you used 'filePath'. ` +
+            `Try using 'projectPath' instead for directory analysis.`);
+    }
+    if (pathParam === 'projectPath' && analysis.type === 'file') {
+        throw new Error(`Parameter mismatch: '${path}' is a file, but you used 'projectPath'. ` +
+            `Try using 'filePath' instead for single-file analysis.`);
+    }
+    return analysis;
+}
+/**
+ * Smart path suggestion helper
+ */
+export function suggestParameterForPath(pathString) {
+    // Quick heuristics before filesystem check
+    const hasExtension = extname(pathString).length > 0;
+    const endsWithSrc = pathString.endsWith('src') || pathString.endsWith('src/');
+    const containsWildcard = pathString.includes('*');
+    if (containsWildcard || endsWithSrc) {
+        return 'projectPath';
+    }
+    if (hasExtension) {
+        return 'filePath';
+    }
+    // Default to projectPath for ambiguous cases
+    return 'projectPath';
+}
+//# sourceMappingURL=path-resolver.js.map

package/dist/utils/path-resolver.js.map

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

package/dist/utils/plugin-utilities.d.ts

@@ -0,0 +1,171 @@
+/**
+ * Plugin Execution Utilities - Modern v4.2
+ *
+ * Shared utilities to reduce code duplication across plugins
+ * Common patterns for model setup, token calculation, and response processing
+ */
+import { PromptStages } from '../types/prompt-stages.js';
+/**
+ * Model setup and validation utility
+ * Handles common model loading and context length detection
+ */
+export declare class ModelSetup {
+    static getReadyModel(llmClient: any): Promise<{
+        model: any;
+        contextLength: number;
+    }>;
+}
+/**
+ * Dynamic token calculation utility
+ * Calculates optimal maxTokens based on content size and context window
+ */
+export declare class TokenCalculator {
+    /**
+     * Calculate optimal maxTokens for single-stage execution
+     */
+    static calculateForDirect(stages: PromptStages, contextLength: number, options?: {
+        minTokens?: number;
+        maxTokens?: number;
+        bufferTokens?: number;
+    }): number;
+    /**
+     * Calculate optimal maxTokens for chunked execution
+     */
+    static calculateForChunked(messages: Array<{
+        content: string;
+    }>, contextLength: number, options?: {
+        minTokens?: number;
+        maxTokens?: number;
+        bufferTokens?: number;
+    }): number;
+    /**
+     * Calculate optimal maxTokens for multi-file analysis
+     */
+    static calculateForMultiFile(messages: Array<{
+        content: string;
+    }>, contextLength: number, options?: {
+        minTokens?: number;
+        maxTokens?: number;
+        bufferTokens?: number;
+    }): number;
+}
+/**
+ * LM Studio response processing utility
+ * Handles streaming response collection with consistent patterns
+ */
+export declare class ResponseProcessor {
+    /**
+     * Stream and collect response from LM Studio model
+     */
+    static collectStreamingResponse(prediction: AsyncIterable<any>): Promise<string>;
+    /**
+     * Execute direct model call with standard settings
+     */
+    static executeDirect(stages: PromptStages, model: any, contextLength: number, functionName: string, options?: {
+        temperature?: number;
+        tokenOptions?: {
+            minTokens?: number;
+            maxTokens?: number;
+            bufferTokens?: number;
+        };
+    }): Promise<any>;
+    /**
+     * Execute chunked model call with standard settings
+     */
+    static executeChunked(messages: Array<{
+        role: string;
+        content: string;
+    }>, model: any, contextLength: number, functionName: string, analysisType?: 'single' | 'multifile', options?: {
+        temperature?: number;
+        tokenOptions?: {
+            minTokens?: number;
+            maxTokens?: number;
+            bufferTokens?: number;
+        };
+    }): Promise<any>;
+}
+/**
+ * Common parameter validation utility
+ * Standard validation patterns used across plugins
+ */
+export declare class ParameterValidator {
+    /**
+     * Validate code/filePath parameter pattern
+     */
+    static validateCodeOrFile(params: any, parameterName?: string): void;
+    /**
+     * Validate project path for multi-file operations
+     */
+    static validateProjectPath(params: any): void;
+    /**
+     * Validate depth parameter range
+     */
+    static validateDepth(params: any, min?: number, max?: number): void;
+    /**
+     * Validate enum parameter
+     */
+    static validateEnum(params: any, paramName: string, allowedValues: string[]): void;
+}
+/**
+ * Error response utility
+ * Consistent error handling patterns
+ */
+export declare class ErrorHandler {
+    /**
+     * Create standardized error response
+     */
+    static createExecutionError(functionName: string, error: any, operation?: string): {
+        success: boolean;
+        timestamp: string;
+        modelUsed: string;
+        executionTimeMs: number;
+        error: {
+            code: string;
+            message: string;
+            details: any;
+        };
+    };
+    /**
+     * Create parameter validation error response
+     */
+    static createValidationError(functionName: string, error: any): {
+        success: boolean;
+        timestamp: string;
+        modelUsed: string;
+        executionTimeMs: number;
+        error: {
+            code: string;
+            message: string;
+            details: any;
+        };
+    };
+    /**
+     * Create model error response
+     */
+    static createModelError(functionName: string, error: any): {
+        success: boolean;
+        timestamp: string;
+        modelUsed: string;
+        executionTimeMs: number;
+        error: {
+            code: string;
+            message: string;
+            details: any;
+        };
+    };
+}
+/**
+ * Multi-file analysis utility
+ * Handles file discovery, batching, and processing for cross-file analysis
+ */
+export declare class MultiFileAnalysis {
+    /**
+     * Discover files in a project directory with filtering
+     */
+    discoverFiles(projectPath: string, extensions: string[], maxDepth?: number): Promise<string[]>;
+    /**
+     * Process files in batches with a callback function
+     */
+    analyzeBatch<T>(files: string[], analyzeFunction: (file: string) => Promise<T>, contextLength: number, batchSize?: number): Promise<T[]>;
+}
+//# sourceMappingURL=plugin-utilities.d.ts.map

package/dist/utils/plugin-utilities.d.ts.map

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