@houtini/lm 1.0.0

package/dist/system/function-registry.js

@@ -0,0 +1,136 @@
+import { readdirSync, readFileSync } from 'fs';
+import { join, basename, dirname } from 'path';
+import { fileURLToPath } from 'url';
+// ES module equivalent of __dirname
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+/**
+ * Discover all available Houtini LM functions by scanning prompt directories
+ */
+export async function discoverAvailableFunctions() {
+    const functions = [];
+    const promptsDir = join(__dirname, '../prompts');
+    // Known prompt categories
+    const categories = ['analyze', 'generate', 'system', 'custom', 'fun'];
+    for (const category of categories) {
+        const categoryPath = join(promptsDir, category);
+        try {
+            const files = readdirSync(categoryPath);
+            for (const file of files) {
+                if (file.endsWith('.js') && !file.includes('legacy') && !file.includes('.d.ts')) {
+                    try {
+                        const functionInfo = await extractFunctionInfo(categoryPath, file, category);
+                        if (functionInfo) {
+                            functions.push(functionInfo);
+                        }
+                    }
+                    catch (error) {
+                        // Skip files that can't be analyzed
+                        console.warn(`Could not analyze ${file}:`, error.message);
+                    }
+                }
+            }
+        }
+        catch (error) {
+            // Category directory doesn't exist or can't be read, skip
+            console.warn(`Could not read category ${category}:`, error.message);
+        }
+    }
+    return functions.sort((a, b) => a.name.localeCompare(b.name));
+}
+/**
+ * Extract function information from a compiled plugin file
+ */
+async function extractFunctionInfo(categoryPath, file, category) {
+    const filePath = join(categoryPath, file);
+    try {
+        const content = readFileSync(filePath, 'utf8');
+        // Extract function name (look for name = 'function_name' pattern)
+        const nameMatch = content.match(/name\s*=\s*['"']([^'"]+)['"']/);
+        const functionName = nameMatch ? nameMatch[1] : basename(file, '.js').replace(/-/g, '_');
+        // Extract description (look for description = 'text' pattern)
+        const descMatch = content.match(/description\s*=\s*['"']([^'"]+)['"']/);
+        const description = descMatch ? descMatch[1] : `${category} function`;
+        // Detect supported modes by looking for mode detection logic
+        const supportedModes = detectSupportedModes(content);
+        const primaryMode = determinePrimaryMode(content, category);
+        // Generate example usage
+        const exampleUsage = generateExampleUsage(functionName, supportedModes);
+        return {
+            name: functionName,
+            category,
+            file,
+            description,
+            supportedModes,
+            primaryMode,
+            exampleUsage
+        };
+    }
+    catch (error) {
+        console.warn(`Error reading ${file}:`, error.message);
+        return null;
+    }
+}
+/**
+ * Detect which modes a function supports by analyzing its code
+ */
+function detectSupportedModes(content) {
+    const modes = [];
+    // Check for single-file support
+    if (content.includes('getSingleFile') || content.includes("'single-file'") || content.includes('params.code') || content.includes('params.filePath')) {
+        modes.push('single-file');
+    }
+    // Check for multi-file support  
+    if (content.includes('getMultiFile') || content.includes("'multi-file'") || content.includes('params.projectPath') || content.includes('params.files')) {
+        modes.push('multi-file');
+    }
+    // Default if we can't detect
+    if (modes.length === 0) {
+        modes.push('single-file'); // Conservative default
+    }
+    return modes;
+}
+/**
+ * Determine the primary mode based on function purpose and defaults
+ */
+function determinePrimaryMode(content, category) {
+    // Look for explicit default return in detectAnalysisMode
+    const defaultMatch = content.match(/return\s+['"'](single-file|multi-file)['"'];?\s*$/m);
+    if (defaultMatch) {
+        return defaultMatch[1];
+    }
+    // Category-based heuristics
+    if (category === 'system') {
+        return 'multi-file'; // System functions typically work on projects
+    }
+    if (category === 'generate') {
+        return 'single-file'; // Generation typically creates single items
+    }
+    // Default fallback
+    return 'single-file';
+}
+/**
+ * Generate helpful example usage for different modes
+ */
+function generateExampleUsage(functionName, supportedModes) {
+    const examples = {};
+    if (supportedModes.includes('single-file')) {
+        examples.singleFile = `houtini-lm:${functionName} filePath="C:/project/src/file.ts"`;
+    }
+    if (supportedModes.includes('multi-file')) {
+        examples.multiFile = `houtini-lm:${functionName} projectPath="C:/project/src"`;
+    }
+    return examples;
+}
+/**
+ * Get function categories with counts
+ */
+export async function getFunctionCategories() {
+    const functions = await discoverAvailableFunctions();
+    const categories = {};
+    functions.forEach(func => {
+        categories[func.category] = (categories[func.category] || 0) + 1;
+    });
+    return categories;
+}
+//# sourceMappingURL=function-registry.js.map

package/dist/system/function-registry.js.map

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

package/dist/system/health-check.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Health Check Plugin - Modern v4.2 Pattern
+ * Checks if LM Studio is running and responding
+ */
+import { BasePlugin } from '../plugins/base-plugin.js';
+import { IPromptPlugin } from '../prompts/shared/types.js';
+import { PromptStages } from '../types/prompt-stages.js';
+export declare class HealthCheckPlugin extends BasePlugin implements IPromptPlugin {
+    name: string;
+    category: "system";
+    description: string;
+    parameters: {
+        detailed: {
+            type: "boolean";
+            description: string;
+            default: boolean;
+            required: boolean;
+        };
+    };
+    execute(params: any, llmClient: any): Promise<import("../validation/schemas.js").HealthCheckResponse>;
+    /**
+     * MODERN v4.2: 3-stage prompt architecture
+     * Note: Health check is a system utility that doesn't use prompts
+     */
+    getPromptStages(params: any): PromptStages;
+    /**
+     * LEGACY: Backwards compatibility
+     * DEPRECATED: Will be removed in v5.0
+     */
+    getPrompt(params: any): string;
+}
+export default HealthCheckPlugin;
+//# sourceMappingURL=health-check.d.ts.map

package/dist/system/health-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health-check.d.ts","sourceRoot":"","sources":["../../src/system/health-check.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAG3D,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAIzD,qBAAa,iBAAkB,SAAQ,UAAW,YAAW,aAAa;IACxE,IAAI,SAAkB;IACtB,QAAQ,EAAG,QAAQ,CAAU;IAC7B,WAAW,SAAkD;IAE7D,UAAU;;;;;;;MAOR;IAEI,OAAO,CAAC,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG;IAkEzC;;;OAGG;IACH,eAAe,CAAC,MAAM,EAAE,GAAG,GAAG,YAAY;IAQ1C;;;OAGG;IACH,SAAS,CAAC,MAAM,EAAE,GAAG,GAAG,MAAM;CAI/B;AAED,eAAe,iBAAiB,CAAC"}

package/dist/system/health-check.js

@@ -0,0 +1,98 @@
+/**
+ * Health Check Plugin - Modern v4.2 Pattern
+ * Checks if LM Studio is running and responding
+ */
+import { BasePlugin } from '../plugins/base-plugin.js';
+import { ResponseFactory } from '../validation/response-factory.js';
+import { withSecurity } from '../security/integration-helpers.js';
+import { LMStudioClient } from '@lmstudio/sdk';
+import { config } from '../config.js';
+export class HealthCheckPlugin extends BasePlugin {
+    constructor() {
+        super(...arguments);
+        this.name = 'health_check';
+        this.category = 'system';
+        this.description = 'Check if LM Studio is running and responding';
+        this.parameters = {
+            detailed: {
+                type: 'boolean',
+                description: 'Include detailed information about the loaded model and server status',
+                default: false,
+                required: false
+            }
+        };
+    }
+    async execute(params, llmClient) {
+        return await withSecurity(this, params, llmClient, async (secureParams) => {
+            try {
+                const client = new LMStudioClient({
+                    baseUrl: config.lmStudioUrl || 'ws://localhost:1234',
+                });
+                // Try to connect and get basic info
+                const models = await client.llm.listLoaded();
+                // Get context length from the active model if available
+                let contextLength = undefined;
+                if (models.length > 0) {
+                    try {
+                        const activeModel = models[0];
+                        // Try to get context length using LM Studio SDK
+                        contextLength = await activeModel.getContextLength();
+                    }
+                    catch (error) {
+                        // If getContextLength fails, try alternative method or leave undefined
+                        console.warn('Could not retrieve context length from model:', error);
+                    }
+                }
+                // Use ResponseFactory for consistent, spec-compliant output
+                ResponseFactory.setStartTime();
+                return ResponseFactory.createHealthCheckResponse('healthy', 'established', config.lmStudioUrl || 'ws://localhost:1234', undefined, undefined, secureParams.detailed ? {
+                    loadedModels: models.map(model => ({
+                        path: model.path,
+                        identifier: model.identifier,
+                        architecture: model.architecture || 'unknown',
+                        contextLength: contextLength // Will be the same for all models since we only check the first one
+                    })),
+                    modelCount: models.length,
+                    hasActiveModel: models.length > 0,
+                    contextLength: contextLength, // Add context length to response
+                    serverInfo: {
+                        url: config.lmStudioUrl,
+                        protocol: 'websocket'
+                    },
+                    activeModel: models.length > 0 ? {
+                        path: models[0].path,
+                        identifier: models[0].identifier,
+                        architecture: models[0].architecture || 'unknown',
+                        contextLength: contextLength // Add context length to active model
+                    } : undefined
+                } : undefined, // Don't provide details in non-detailed mode
+                contextLength // Pass contextLength as separate parameter
+                );
+            }
+            catch (error) {
+                return ResponseFactory.createHealthCheckResponse('unhealthy', 'failed', config.lmStudioUrl || 'ws://localhost:1234', error.message || 'Failed to connect to LM Studio', 'Please ensure LM Studio is running and a model is loaded');
+            }
+        });
+    }
+    /**
+     * MODERN v4.2: 3-stage prompt architecture
+     * Note: Health check is a system utility that doesn't use prompts
+     */
+    getPromptStages(params) {
+        return {
+            systemAndContext: 'Health check system utility - no prompt required',
+            dataPayload: 'Checking LM Studio connection and model status',
+            outputInstructions: 'Return connection status and model information'
+        };
+    }
+    /**
+     * LEGACY: Backwards compatibility
+     * DEPRECATED: Will be removed in v5.0
+     */
+    getPrompt(params) {
+        // Health check is a utility function, no prompt needed
+        return 'Health check - no prompt required for system utilities';
+    }
+}
+export default HealthCheckPlugin;
+//# sourceMappingURL=health-check.js.map

package/dist/system/health-check.js.map

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

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

@@ -0,0 +1,55 @@
+/**
+ * Path Resolution Plugin - Smart path analysis for MCP usage
+ * Helps users understand file vs directory paths and suggests correct parameters
+ */
+import { BasePlugin } from '../plugins/base-plugin.js';
+import { IPromptPlugin } from '../prompts/shared/types.js';
+export declare class PathResolverPlugin extends BasePlugin implements IPromptPlugin {
+    name: string;
+    category: "system";
+    description: string;
+    parameters: {
+        path: {
+            type: "string";
+            description: string;
+            required: boolean;
+        };
+        suggestions: {
+            type: "boolean";
+            description: string;
+            default: boolean;
+            required: boolean;
+        };
+    };
+    execute(params: any, llmClient: any): Promise<{
+        success: boolean;
+        timestamp: string;
+        modelUsed: string;
+        executionTimeMs: number;
+        data: {
+            content: any;
+            metadata: {
+                functionName: string;
+                parsedAt: string;
+                responseLength: number;
+            };
+        };
+        error?: undefined;
+    } | {
+        success: boolean;
+        timestamp: string;
+        modelUsed: string;
+        executionTimeMs: number;
+        error: {
+            code: string;
+            message: any;
+            details: {
+                originalError: any;
+            };
+        };
+        data?: undefined;
+    }>;
+    getPromptStages(params: any): any;
+}
+export default PathResolverPlugin;
+//# sourceMappingURL=path-resolver.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"path-resolver.d.ts","sourceRoot":"","sources":["../../src/system/path-resolver.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAI3D,qBAAa,kBAAmB,SAAQ,UAAW,YAAW,aAAa;IACzE,IAAI,SAAkB;IACtB,QAAQ,EAAG,QAAQ,CAAU;IAC7B,WAAW,SAAmE;IAE9E,UAAU;;;;;;;;;;;;MAYR;IAEI,OAAO,CAAC,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAwDzC,eAAe,CAAC,MAAM,EAAE,GAAG,GAAG,GAAG;CAOlC;AAGD,eAAe,kBAAkB,CAAC"}

package/dist/system/path-resolver.js

@@ -0,0 +1,90 @@
+/**
+ * Path Resolution Plugin - Smart path analysis for MCP usage
+ * Helps users understand file vs directory paths and suggests correct parameters
+ */
+import { BasePlugin } from '../plugins/base-plugin.js';
+import { withSecurity } from '../security/integration-helpers.js';
+import { analyzePathForMCP } from '../utils/path-resolver.js';
+export class PathResolverPlugin extends BasePlugin {
+    constructor() {
+        super(...arguments);
+        this.name = 'resolve_path';
+        this.category = 'system';
+        this.description = 'Analyze a file system path and suggest correct MCP parameters';
+        this.parameters = {
+            path: {
+                type: 'string',
+                description: 'File system path to analyze (file or directory)',
+                required: true
+            },
+            suggestions: {
+                type: 'boolean',
+                description: 'Include parameter suggestions and usage examples',
+                default: true,
+                required: false
+            }
+        };
+    }
+    async execute(params, llmClient) {
+        return await withSecurity(this, params, llmClient, async (secureParams) => {
+            try {
+                const pathAnalysis = await analyzePathForMCP(secureParams.path);
+                const result = {
+                    path: secureParams.path,
+                    analysis: pathAnalysis,
+                    timestamp: new Date().toISOString()
+                };
+                // Add usage suggestions if requested
+                if (secureParams.suggestions !== false) {
+                    result.suggestions = {
+                        recommendedParameter: pathAnalysis.suggestedParameter,
+                        exampleUsage: pathAnalysis.type === 'directory'
+                            ? `houtini-lm:count_files projectPath="${secureParams.path}"`
+                            : `houtini-lm:analyze_single_file filePath="${secureParams.path}"`,
+                        alternativeUsage: pathAnalysis.type === 'directory'
+                            ? `houtini-lm:security_audit projectPath="${secureParams.path}"`
+                            : `houtini-lm:generate_unit_tests filePath="${secureParams.path}"`
+                    };
+                }
+                return {
+                    success: true,
+                    timestamp: new Date().toISOString(),
+                    modelUsed: 'system-utility',
+                    executionTimeMs: 0,
+                    data: {
+                        content: result,
+                        metadata: {
+                            functionName: 'resolve_path',
+                            parsedAt: new Date().toISOString(),
+                            responseLength: JSON.stringify(result).length
+                        }
+                    }
+                };
+            }
+            catch (error) {
+                return {
+                    success: false,
+                    timestamp: new Date().toISOString(),
+                    modelUsed: 'system-utility',
+                    executionTimeMs: 0,
+                    error: {
+                        code: 'PATH_RESOLUTION_ERROR',
+                        message: error.message || 'Failed to analyze path',
+                        details: { originalError: error.message }
+                    }
+                };
+            }
+        });
+    }
+    // Not used for system functions, but required by interface
+    getPromptStages(params) {
+        return {
+            systemAndContext: 'Path resolution system function',
+            dataPayload: `Path: ${params.path}`,
+            outputInstructions: 'Return path analysis and suggestions'
+        };
+    }
+}
+// Export as default for plugin loader
+export default PathResolverPlugin;
+//# sourceMappingURL=path-resolver.js.map

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

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

package/dist/templates/plugin-template.d.ts

@@ -0,0 +1,121 @@
+/**
+ * Plugin Template - Modern v4.2 (Single Source of Truth)
+ *
+ * Universal template that intelligently handles both single-file and multi-file analysis
+ * Automatically detects analysis type based on provided parameters
+ *
+ * Copy this template for creating any new plugin - it adapts to your needs
+ *
+ * ⚠️  CRITICAL: OUTPUT INSTRUCTIONS MUST USE NATURAL LANGUAGE, NOT JSON SCHEMAS! ⚠️
+ *
+ * The ResponseFactory automatically handles all JSON formatting. If you put JSON schemas
+ * in outputInstructions, you'll get double-processing and escaped content. Always use
+ * natural language instructions that describe WHAT you want, not HOW to format it.
+ *
+ * ✅ GOOD: "Provide a comprehensive analysis including structure, quality metrics..."
+ * ❌ BAD:  '{ "summary": "...", "structure": {...} }' (causes escaping issues)
+ */
+import { BasePlugin } from '../plugins/base-plugin.js';
+import { IPromptPlugin } from '../prompts/shared/types.js';
+import { PromptStages } from '../types/prompt-stages.js';
+export declare class TEMPLATE_UniversalPlugin extends BasePlugin implements IPromptPlugin {
+    name: string;
+    category: "analyze";
+    description: string;
+    parameters: {
+        code: {
+            type: "string";
+            description: string;
+            required: boolean;
+        };
+        filePath: {
+            type: "string";
+            description: string;
+            required: boolean;
+        };
+        projectPath: {
+            type: "string";
+            description: string;
+            required: boolean;
+        };
+        files: {
+            type: "array";
+            description: string;
+            required: boolean;
+            items: {
+                type: "string";
+            };
+        };
+        maxDepth: {
+            type: "number";
+            description: string;
+            required: boolean;
+            default: number;
+        };
+        language: {
+            type: "string";
+            description: string;
+            required: boolean;
+            default: string;
+        };
+        analysisDepth: {
+            type: "string";
+            description: string;
+            enum: string[];
+            default: string;
+            required: boolean;
+        };
+        analysisType: {
+            type: "string";
+            description: string;
+            enum: string[];
+            default: string;
+            required: boolean;
+        };
+    };
+    private analysisCache;
+    private multiFileAnalysis;
+    constructor();
+    execute(params: any, llmClient: any): Promise<any>;
+    /**
+     * Auto-detect whether this is single-file or multi-file analysis
+     *
+     * DETECTION GUIDE:
+     * Single-file: code, filePath provided → analyze individual file
+     * Multi-file: projectPath, files, maxDepth provided → analyze project/multiple files
+     * Default: Choose based on your plugin's primary use case
+     */
+    private detectAnalysisMode;
+    /**
+     * Validate parameters based on detected analysis mode
+     */
+    private validateParameters;
+    /**
+     * Execute single-file analysis
+     */
+    private executeSingleFileAnalysis;
+    /**
+     * Execute multi-file analysis
+     */
+    private executeMultiFileAnalysis;
+    /**
+     * TEMPLATE: Implement your single-file prompt stages
+     */
+    private getSingleFilePromptStages;
+    /**
+     * TEMPLATE: Implement your multi-file prompt stages
+     */
+    private getMultiFilePromptStages;
+    /**
+     * TEMPLATE: Implement for backwards compatibility
+     * The system still expects this method, so we intelligently route to the appropriate stages
+     */
+    getPromptStages(params: any): PromptStages;
+    private discoverRelevantFiles;
+    private performMultiFileAnalysis;
+    private analyzeIndividualFile;
+    private getFileExtensions;
+    private generateCacheKey;
+}
+export default TEMPLATE_UniversalPlugin;
+//# sourceMappingURL=plugin-template.d.ts.map

package/dist/templates/plugin-template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-template.d.ts","sourceRoot":"","sources":["../../src/templates/plugin-template.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AASH,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAE3D,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAgBzD,qBAAa,wBAAyB,SAAQ,UAAW,YAAW,aAAa;IAC/E,IAAI,SAA4B;IAChC,QAAQ,EAAG,SAAS,CAAU;IAC9B,WAAW,SAAmF;IAG9F,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAqDR;IAEF,OAAO,CAAC,aAAa,CAAsB;IAC3C,OAAO,CAAC,iBAAiB,CAA2B;;IAO9C,OAAO,CAAC,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG;IAyBzC;;;;;;;OAOG;IACH,OAAO,CAAC,kBAAkB;IAiB1B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAa1B;;OAEG;YACW,yBAAyB;IA0CvC;;OAEG;YACW,wBAAwB;IA0CtC;;OAEG;IACH,OAAO,CAAC,yBAAyB;IAyDjC;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAwDhC;;;OAGG;IACH,eAAe,CAAC,MAAM,EAAE,GAAG,GAAG,YAAY;YAW5B,qBAAqB;YASrB,wBAAwB;YAyCxB,qBAAqB;IAenC,OAAO,CAAC,iBAAiB;IAiBzB,OAAO,CAAC,gBAAgB;CAKzB;AAED,eAAe,wBAAwB,CAAC"}