@1mcp/agent 0.22.3 → 0.23.0

package/build/core/instructions/instructionAggregator.js

@@ -0,0 +1,385 @@
+import { EventEmitter } from 'events';
+import Handlebars from 'handlebars';
+import { LRUCache } from 'lru-cache';
+import logger from '../../logger/logger.js';
+import { FilteringService } from '../filtering/filteringService.js';
+import { DEFAULT_TEMPLATE_CONFIG, DEFAULT_INSTRUCTION_TEMPLATE, } from './templateTypes.js';
+/**
+ * Aggregates instructions from multiple MCP servers into a single instruction string.
+ * Provides both simple concatenation and filtered instructions with educational templates.
+ * The aggregator acts as an educational prompt to help LLMs understand 1MCP better.
+ *
+ * @example
+ * ```typescript
+ * const aggregator = new InstructionAggregator();
+ * aggregator.on('instructions-changed', () => {
+ *   // Server instructions have changed
+ * });
+ *
+ * // When server comes online
+ * aggregator.setInstructions('server1', 'Server 1 instructions');
+ *
+ * // Get filtered instructions for a client
+ * const filtered = aggregator.getFilteredInstructions(config, connections);
+ * ```
+ */
+export class InstructionAggregator extends EventEmitter {
+    serverInstructions = new Map();
+    isInitialized = false;
+    templateCache;
+    constructor() {
+        super();
+        this.setMaxListeners(50);
+        // Initialize LRU cache with reasonable limits
+        this.templateCache = new LRUCache({
+            max: 100, // Maximum 100 compiled templates
+            maxSize: 10 * 1024 * 1024, // 10MB total size limit
+            sizeCalculation: (template, key) => {
+                // Estimate size based on template string length (key) plus overhead
+                return key.length + 1024; // Template overhead estimate
+            },
+            ttl: 1000 * 60 * 60, // 1 hour TTL to prevent indefinite growth
+        });
+        // Set up cache invalidation on instruction changes
+        this.on('instructions-changed', () => {
+            this.invalidateTemplateCache('instructions-changed');
+        });
+    }
+    /**
+     * Set or update instructions for a specific server
+     * @param serverName The name of the server
+     * @param instructions The instruction string from the server, or undefined to remove
+     */
+    setInstructions(serverName, instructions) {
+        const previousInstructions = this.serverInstructions.get(serverName);
+        const hasChanges = previousInstructions !== instructions;
+        if (instructions?.trim()) {
+            this.serverInstructions.set(serverName, instructions.trim());
+            logger.debug(`Updated instructions for server: ${serverName}`);
+        }
+        else {
+            this.serverInstructions.delete(serverName);
+            logger.debug(`Removed instructions for server: ${serverName}`);
+        }
+        if (!this.isInitialized) {
+            this.isInitialized = true;
+            logger.debug('InstructionAggregator initialized');
+        }
+        if (hasChanges) {
+            logger.info(`Instructions changed. Total servers with instructions: ${this.serverInstructions.size}`);
+            this.emit('instructions-changed');
+        }
+    }
+    /**
+     * Remove instructions for a specific server
+     * @param serverName The name of the server to remove
+     */
+    removeServer(serverName) {
+        const hadInstructions = this.serverInstructions.has(serverName);
+        this.serverInstructions.delete(serverName);
+        if (hadInstructions) {
+            logger.info(`Removed server instructions: ${serverName}. Remaining servers: ${this.serverInstructions.size}`);
+            this.emit('instructions-changed');
+        }
+    }
+    /**
+     * Get filtered instructions for a specific client based on their configuration
+     * This is the main method that should be used by server connections
+     *
+     * @param config Client's inbound connection configuration
+     * @param connections All available outbound connections
+     * @returns Formatted instruction string with educational template or custom template
+     */
+    getFilteredInstructions(config, connections) {
+        logger.debug('InstructionAggregator: Getting filtered instructions', {
+            filterMode: config.tagFilterMode,
+            totalConnections: connections.size,
+            totalInstructions: this.serverInstructions.size,
+            hasCustomTemplate: !!config.customTemplate,
+        });
+        // Filter connections based on client configuration
+        const filteredConnections = FilteringService.getFilteredConnections(connections, config);
+        // Get filtering summary for logging
+        const filteringSummary = FilteringService.getFilteringSummary(connections, filteredConnections, config);
+        logger.info('InstructionAggregator: Filtering applied', filteringSummary);
+        // Use custom template if provided, otherwise use default template
+        const template = config.customTemplate || DEFAULT_INSTRUCTION_TEMPLATE;
+        return this.renderCustomTemplate(template, filteredConnections, config);
+    }
+    /**
+     * Get the number of servers that have provided instructions
+     * @returns The count of servers with instructions
+     */
+    getServerCount() {
+        return this.serverInstructions.size;
+    }
+    /**
+     * Get a list of server names that have provided instructions
+     * @returns Array of server names
+     */
+    getServerNames() {
+        return Array.from(this.serverInstructions.keys()).sort();
+    }
+    /**
+     * Check if a specific server has instructions
+     * @param serverName The server name to check
+     * @returns True if the server has instructions
+     */
+    hasInstructions(serverName) {
+        return this.serverInstructions.has(serverName);
+    }
+    /**
+     * Get instructions for a specific server
+     * @param serverName The server name
+     * @returns The instructions for the server, or undefined if not found
+     */
+    getServerInstructions(serverName) {
+        return this.serverInstructions.get(serverName);
+    }
+    /**
+     * Clear all instructions (useful for testing)
+     */
+    clear() {
+        const hadInstructions = this.serverInstructions.size > 0;
+        this.serverInstructions.clear();
+        if (hadInstructions) {
+            logger.debug('Cleared all server instructions');
+            this.emit('instructions-changed');
+        }
+    }
+    /**
+     * Get filter context description for the template
+     */
+    getFilterContext(config) {
+        if (!config.tagFilterMode || config.tagFilterMode === 'none') {
+            return '';
+        }
+        if (config.tagFilterMode === 'simple-or' && config.tags?.length) {
+            return ` (filtered by tags: ${config.tags.join(', ')})`;
+        }
+        if (config.tagFilterMode === 'advanced' && config.tagExpression) {
+            return ' (filtered by advanced expression)';
+        }
+        if (config.tagFilterMode === 'preset') {
+            return ' (filtered by preset)';
+        }
+        return ' (filtered)';
+    }
+    /**
+     * Get a summary of current instruction state for logging
+     */
+    getSummary() {
+        const serverCount = this.serverInstructions.size;
+        const serverNames = this.getServerNames();
+        return `${serverCount} servers with instructions: ${serverNames.join(', ')}`;
+    }
+    /**
+     * Render a custom Handlebars template with template variables
+     * @param template Custom template string
+     * @param filteredConnections Filtered server connections
+     * @param config Client configuration
+     * @returns Rendered template string
+     */
+    renderCustomTemplate(template, filteredConnections, config) {
+        try {
+            // Get or compile template
+            const compiledTemplate = this.getCompiledTemplate(template);
+            // Generate template variables
+            const variables = this.generateTemplateVariables(filteredConnections, config);
+            // Render template
+            const rendered = compiledTemplate(variables);
+            logger.debug('InstructionAggregator: Custom template rendered successfully', {
+                templateLength: template.length,
+                variableCount: Object.keys(variables).length,
+                renderedLength: rendered.length,
+            });
+            return rendered;
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+            logger.error('InstructionAggregator: Failed to render custom template', {
+                error: errorMessage,
+                templateLength: template.length,
+            });
+            // Provide actionable guidance for template errors
+            logger.warn('InstructionAggregator: Template rendering failed, returning error instructions with guidance');
+            const serverCount = Array.from(filteredConnections.keys()).filter((name) => this.serverInstructions.has(name)).length;
+            // Generate helpful error message with troubleshooting steps
+            return `# 1MCP - Template Rendering Error
+
+⚠️  **Template rendering failed:** ${errorMessage}
+
+## Available Resources
+- **${serverCount} server(s)** are connected and have instructions
+- **Built-in template** is available as fallback
+
+## Troubleshooting Steps
+
+1. **Check Template Syntax**:
+   - Verify all Handlebars expressions use correct syntax: \`{{variable}}\`
+   - Ensure block helpers are properly closed: \`{{#if}}...{{/if}}\`
+   - Check for unmatched braces or quotes
+
+2. **Validate Template Variables**:
+   - Use only supported variables: \`serverCount\`, \`serverNames\`, \`hasServers\`, etc.
+   - Check template documentation for full variable list
+
+3. **Test Template**:
+   - Start with a simple template: \`# {{title}}\\n{{serverCount}} servers available\`
+   - Add complexity gradually
+
+4. **Get Help**:
+   - Remove custom template to use built-in version
+   - Check server logs for detailed error information
+   - Consult 1MCP documentation for template examples
+
+---
+*To restore normal operation, remove or fix the custom template file*`;
+        }
+    }
+    /**
+     * Get or compile a Handlebars template with caching
+     * @param template Template string
+     * @returns Compiled template function
+     */
+    getCompiledTemplate(template) {
+        // Validate template size before processing
+        if (template.length > 1024 * 1024) {
+            // 1MB limit per template
+            const sizeMB = (template.length / 1024 / 1024).toFixed(1);
+            throw new Error(`Template too large: ${sizeMB}MB (max 1.0MB). ` +
+                'Consider splitting into smaller files or removing unnecessary content. ' +
+                'Large templates can cause memory issues and slow performance.');
+        }
+        // Use template string as cache key (first 500 chars + hash for uniqueness)
+        const cacheKey = template.length > 500
+            ? template.substring(0, 500) + '_' + template.length + '_' + this.hashString(template)
+            : template;
+        // Check cache first
+        let compiledTemplate = this.templateCache.get(cacheKey);
+        if (!compiledTemplate) {
+            // Compile and cache template
+            compiledTemplate = Handlebars.compile(template, { noEscape: true });
+            this.templateCache.set(cacheKey, compiledTemplate);
+            logger.debug('InstructionAggregator: Compiled and cached new template', {
+                templateLength: template.length,
+                cacheSize: this.templateCache.size,
+                cacheKeyLength: cacheKey.length,
+            });
+        }
+        return compiledTemplate;
+    }
+    /**
+     * Generate template variables for rendering
+     * @param filteredConnections Filtered server connections
+     * @param config Client configuration
+     * @returns Template variables object
+     */
+    generateTemplateVariables(filteredConnections, config) {
+        // Get server data for both arrays and individual server objects
+        const availableServers = [];
+        const serverInstructionSections = [];
+        const servers = [];
+        // Sort filtered connections by name for consistent output
+        const sortedConnections = Array.from(filteredConnections.entries()).sort(([a], [b]) => a.localeCompare(b));
+        for (const [serverName, _connection] of sortedConnections) {
+            const serverInstructions = this.serverInstructions.get(serverName);
+            if (serverInstructions?.trim()) {
+                availableServers.push(serverName);
+                serverInstructionSections.push(`<${serverName}>\n${serverInstructions.trim()}\n</${serverName}>`);
+                // Add individual server data for iteration
+                servers.push({
+                    name: serverName,
+                    instructions: serverInstructions.trim(),
+                    hasInstructions: true,
+                });
+            }
+        }
+        const serverCount = availableServers.length;
+        const hasServers = serverCount > 0;
+        // Merge configuration with defaults
+        const templateConfig = {
+            ...DEFAULT_TEMPLATE_CONFIG,
+            title: config.title || DEFAULT_TEMPLATE_CONFIG.title,
+            toolPattern: config.toolPattern || DEFAULT_TEMPLATE_CONFIG.toolPattern,
+            examples: config.examples || DEFAULT_TEMPLATE_CONFIG.examples,
+        };
+        return {
+            // Server state
+            serverCount,
+            hasServers,
+            serverList: availableServers.join('\n'),
+            serverNames: availableServers,
+            servers,
+            pluralServers: serverCount === 1 ? 'server' : 'servers',
+            isAre: serverCount === 1 ? 'is' : 'are',
+            // Content
+            instructions: serverInstructionSections.join('\n\n'),
+            filterContext: this.getFilterContext(config),
+            // Configuration
+            toolPattern: templateConfig.toolPattern,
+            title: templateConfig.title,
+            examples: templateConfig.examples,
+        };
+    }
+    /**
+     * Clear template cache (useful for testing)
+     */
+    clearTemplateCache() {
+        this.templateCache.clear();
+        logger.debug('InstructionAggregator: Template cache cleared');
+    }
+    /**
+     * Get template cache statistics for monitoring
+     */
+    getTemplateCacheStats() {
+        return {
+            size: this.templateCache.size,
+            maxSize: this.templateCache.max,
+            calculatedSize: this.templateCache.calculatedSize || 0,
+        };
+    }
+    /**
+     * Invalidate template cache with reason logging
+     * @param reason Reason for cache invalidation
+     */
+    invalidateTemplateCache(reason) {
+        const sizeBefore = this.templateCache.size;
+        this.templateCache.clear();
+        logger.debug(`InstructionAggregator: Template cache invalidated due to ${reason}`, {
+            clearedTemplates: sizeBefore,
+        });
+    }
+    /**
+     * Force template cache invalidation (for external triggers)
+     * @param reason Reason for forced invalidation
+     */
+    forceTemplateCacheInvalidation(reason = 'external-trigger') {
+        this.invalidateTemplateCache(reason);
+    }
+    /**
+     * Cryptographically secure hash function for template cache keys
+     * Uses SHA-256 to prevent collision attacks
+     */
+    hashString(str) {
+        const crypto = require('crypto');
+        return crypto.createHash('sha256').update(str, 'utf8').digest('hex').substring(0, 16);
+    }
+    /**
+     * Cleanup method to remove all event listeners and clear caches
+     * Should be called when the aggregator is no longer needed
+     */
+    cleanup() {
+        logger.debug('InstructionAggregator: Starting cleanup');
+        // Clear all event listeners
+        this.removeAllListeners();
+        // Clear template cache
+        this.templateCache.clear();
+        // Clear server instructions
+        this.serverInstructions.clear();
+        // Reset initialization state
+        this.isInitialized = false;
+        logger.info('InstructionAggregator: Cleanup completed - all listeners and caches cleared');
+    }
+}
+//# sourceMappingURL=instructionAggregator.js.map

package/build/core/instructions/instructionAggregator.js.map

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

package/build/core/instructions/templateTypes.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Individual server data for template iteration
+ */
+export interface ServerData {
+    /** Server name (e.g., "api-server") */
+    name: string;
+    /** Server instructions content */
+    instructions: string;
+    /** Whether this server has instructions */
+    hasInstructions: boolean;
+}
+/**
+ * Template variables available for custom instruction templates
+ * These variables are provided by 1MCP and can be used in Handlebars templates
+ */
+export interface TemplateVariables {
+    /** Number of connected servers (e.g., 3) */
+    serverCount: number;
+    /** Boolean indicating if any servers are connected */
+    hasServers: boolean;
+    /** Newline-separated list of server names */
+    serverList: string;
+    /** Array of server names for iteration with {{#each}} */
+    serverNames: string[];
+    /** Array of server objects for detailed iteration with {{#each}} */
+    servers: ServerData[];
+    /** "server" or "servers" based on count */
+    pluralServers: string;
+    /** "is" or "are" based on count */
+    isAre: string;
+    /** All server instructions wrapped in XML-like tags */
+    instructions: string;
+    /** Filter description (e.g., " (filtered by tags: backend)") or empty string */
+    filterContext: string;
+    /** Tool naming pattern (default: "{server}_1mcp_{tool}") */
+    toolPattern: string;
+    /** Title for the template (default: "1MCP - Model Context Protocol Proxy") */
+    title: string;
+    /** Array of tool examples for documentation */
+    examples: TemplateExample[];
+}
+/**
+ * Tool example for template documentation
+ */
+export interface TemplateExample {
+    /** Tool name with pattern applied (e.g., "filesystem_1mcp_read_file") */
+    name: string;
+    /** Description of what the tool does */
+    description: string;
+}
+/**
+ * Template configuration options
+ */
+export interface TemplateConfig {
+    /** Custom Handlebars template string */
+    customTemplate?: string;
+    /** Override default title */
+    title?: string;
+    /** Override default tool pattern */
+    toolPattern?: string;
+    /** Custom tool examples */
+    examples?: TemplateExample[];
+}
+/**
+ * Default template examples
+ */
+export declare const DEFAULT_TEMPLATE_EXAMPLES: TemplateExample[];
+/**
+ * Default template configuration values
+ */
+export declare const DEFAULT_TEMPLATE_CONFIG: Required<Omit<TemplateConfig, 'customTemplate'>>;
+/**
+ * Default instruction template using Handlebars syntax
+ * This template is used when no custom template is provided
+ */
+export declare const DEFAULT_INSTRUCTION_TEMPLATE = "# {{title}}\n\n{{#if hasServers}}\nYou are interacting with 1MCP, a proxy server that aggregates capabilities from multiple MCP (Model Context Protocol) servers. 1MCP acts as a unified gateway, allowing you to access tools and resources from various specialized MCP servers through a single connection.\n\n## How 1MCP Works\n\n- **Unified Access**: Connect to multiple MCP servers through one proxy\n- **Tool Aggregation**: All tools are available with the naming pattern `{{toolPattern}}`\n- **Resource Sharing**: Access files, data, and capabilities across different servers\n- **Intelligent Routing**: Your requests are automatically routed to the appropriate servers\n\n## Currently Connected Servers\n\n{{serverCount}} MCP {{pluralServers}} {{isAre}} currently available{{filterContext}}:\n\n{{serverList}}\n\n## Available Capabilities\n\nAll tools from connected servers are accessible using the format: `{{toolPattern}}`\n\nExamples:\n{{#each examples}}\n- `{{name}}` - {{description}}\n{{/each}}\n\n## Server-Specific Instructions\n\nThe following sections contain instructions from each connected MCP server. Each server's instructions are wrapped in XML-like tags (e.g., `<server-name>instructions</server-name>`) to clearly identify their source and scope.\n\n{{#each servers}}\n{{#if hasInstructions}}\n<{{name}}>\n{{instructions}}\n</{{name}}>\n\n{{/if}}\n{{/each}}\n\n## Tips for Using 1MCP\n\n- Tools are namespaced by server to avoid conflicts\n\n{{else}}\nYou are interacting with 1MCP, a proxy server that aggregates capabilities from multiple MCP (Model Context Protocol) servers.\n\n## Current Status\n\nNo MCP servers are currently connected. 1MCP is ready to connect to servers and provide unified access to their capabilities once they become available.\n\n## What 1MCP Provides\n\n- **Unified Access**: Connect to multiple MCP servers through one proxy\n- **Tool Aggregation**: Access tools using the pattern `{{toolPattern}}`\n- **Resource Sharing**: Share files, data, and capabilities across servers\n- **Intelligent Routing**: Automatic request routing to appropriate servers\n\n1MCP will automatically detect and connect to available MCP servers. Once connected, their tools and capabilities will become available through the unified interface.\n{{/if}}";
+//# sourceMappingURL=templateTypes.d.ts.map

package/build/core/instructions/templateTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"templateTypes.d.ts","sourceRoot":"","sources":["../../../src/core/instructions/templateTypes.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAC;IAEb,kCAAkC;IAClC,YAAY,EAAE,MAAM,CAAC;IAErB,2CAA2C;IAC3C,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAEhC,4CAA4C;IAC5C,WAAW,EAAE,MAAM,CAAC;IAEpB,sDAAsD;IACtD,UAAU,EAAE,OAAO,CAAC;IAEpB,6CAA6C;IAC7C,UAAU,EAAE,MAAM,CAAC;IAEnB,yDAAyD;IACzD,WAAW,EAAE,MAAM,EAAE,CAAC;IAEtB,oEAAoE;IACpE,OAAO,EAAE,UAAU,EAAE,CAAC;IAEtB,2CAA2C;IAC3C,aAAa,EAAE,MAAM,CAAC;IAEtB,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAC;IAGd,uDAAuD;IACvD,YAAY,EAAE,MAAM,CAAC;IAErB,gFAAgF;IAChF,aAAa,EAAE,MAAM,CAAC;IAGtB,4DAA4D;IAC5D,WAAW,EAAE,MAAM,CAAC;IAEpB,8EAA8E;IAC9E,KAAK,EAAE,MAAM,CAAC;IAEd,+CAA+C;IAC/C,QAAQ,EAAE,eAAe,EAAE,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,yEAAyE;IACzE,IAAI,EAAE,MAAM,CAAC;IAEb,wCAAwC;IACxC,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,wCAAwC;IACxC,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,6BAA6B;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,oCAAoC;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,2BAA2B;IAC3B,QAAQ,CAAC,EAAE,eAAe,EAAE,CAAC;CAC9B;AAED;;GAEG;AACH,eAAO,MAAM,yBAAyB,EAAE,eAAe,EAatD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,uBAAuB,EAAE,QAAQ,CAAC,IAAI,CAAC,cAAc,EAAE,gBAAgB,CAAC,CAIpF,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,4BAA4B,+uEA2DjC,CAAC"}

package/build/core/instructions/templateTypes.js

@@ -0,0 +1,90 @@
+/**
+ * Default template examples
+ */
+export const DEFAULT_TEMPLATE_EXAMPLES = [
+    {
+        name: 'filesystem_1mcp_read_file',
+        description: 'Read files through filesystem server',
+    },
+    {
+        name: 'web_1mcp_search',
+        description: 'Search the web through web server',
+    },
+    {
+        name: 'database_1mcp_query',
+        description: 'Query databases through database server',
+    },
+];
+/**
+ * Default template configuration values
+ */
+export const DEFAULT_TEMPLATE_CONFIG = {
+    title: '1MCP - Model Context Protocol Proxy',
+    toolPattern: '{server}_1mcp_{tool}',
+    examples: DEFAULT_TEMPLATE_EXAMPLES,
+};
+/**
+ * Default instruction template using Handlebars syntax
+ * This template is used when no custom template is provided
+ */
+export const DEFAULT_INSTRUCTION_TEMPLATE = `# {{title}}
+
+{{#if hasServers}}
+You are interacting with 1MCP, a proxy server that aggregates capabilities from multiple MCP (Model Context Protocol) servers. 1MCP acts as a unified gateway, allowing you to access tools and resources from various specialized MCP servers through a single connection.
+
+## How 1MCP Works
+
+- **Unified Access**: Connect to multiple MCP servers through one proxy
+- **Tool Aggregation**: All tools are available with the naming pattern \`{{toolPattern}}\`
+- **Resource Sharing**: Access files, data, and capabilities across different servers
+- **Intelligent Routing**: Your requests are automatically routed to the appropriate servers
+
+## Currently Connected Servers
+
+{{serverCount}} MCP {{pluralServers}} {{isAre}} currently available{{filterContext}}:
+
+{{serverList}}
+
+## Available Capabilities
+
+All tools from connected servers are accessible using the format: \`{{toolPattern}}\`
+
+Examples:
+{{#each examples}}
+- \`{{name}}\` - {{description}}
+{{/each}}
+
+## Server-Specific Instructions
+
+The following sections contain instructions from each connected MCP server. Each server's instructions are wrapped in XML-like tags (e.g., \`<server-name>instructions</server-name>\`) to clearly identify their source and scope.
+
+{{#each servers}}
+{{#if hasInstructions}}
+<{{name}}>
+{{instructions}}
+</{{name}}>
+
+{{/if}}
+{{/each}}
+
+## Tips for Using 1MCP
+
+- Tools are namespaced by server to avoid conflicts
+
+{{else}}
+You are interacting with 1MCP, a proxy server that aggregates capabilities from multiple MCP (Model Context Protocol) servers.
+
+## Current Status
+
+No MCP servers are currently connected. 1MCP is ready to connect to servers and provide unified access to their capabilities once they become available.
+
+## What 1MCP Provides
+
+- **Unified Access**: Connect to multiple MCP servers through one proxy
+- **Tool Aggregation**: Access tools using the pattern \`{{toolPattern}}\`
+- **Resource Sharing**: Share files, data, and capabilities across servers
+- **Intelligent Routing**: Automatic request routing to appropriate servers
+
+1MCP will automatically detect and connect to available MCP servers. Once connected, their tools and capabilities will become available through the unified interface.
+{{/if}}`;
+//# sourceMappingURL=templateTypes.js.map

package/build/core/instructions/templateTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"templateTypes.js","sourceRoot":"","sources":["../../../src/core/instructions/templateTypes.ts"],"names":[],"mappings":"AAuFA;;GAEG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAsB;IAC1D;QACE,IAAI,EAAE,2BAA2B;QACjC,WAAW,EAAE,sCAAsC;KACpD;IACD;QACE,IAAI,EAAE,iBAAiB;QACvB,WAAW,EAAE,mCAAmC;KACjD;IACD;QACE,IAAI,EAAE,qBAAqB;QAC3B,WAAW,EAAE,yCAAyC;KACvD;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAqD;IACvF,KAAK,EAAE,qCAAqC;IAC5C,WAAW,EAAE,sBAAsB;IACnC,QAAQ,EAAE,yBAAyB;CACpC,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QA2DpC,CAAC"}

package/build/core/instructions/templateValidator.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Template validation result with error details if invalid
+ */
+export interface TemplateValidationResult {
+    valid: boolean;
+    error?: string;
+    suggestions?: string[];
+}
+/**
+ * Configuration for template validation
+ */
+export interface TemplateValidationConfig {
+    maxSizeBytes?: number;
+    allowUnsafeContent?: boolean;
+    customDangerousPatterns?: RegExp[];
+}
+/**
+ * Default validation configuration
+ */
+export declare const DEFAULT_TEMPLATE_VALIDATION_CONFIG: Required<TemplateValidationConfig>;
+/**
+ * Built-in dangerous patterns for template content
+ */
+export declare const DANGEROUS_TEMPLATE_PATTERNS: RegExp[];
+/**
+ * Validate Handlebars template content for safety and syntax
+ * @param templateContent Template content to validate
+ * @param templatePath Path for error reporting (optional)
+ * @param config Validation configuration (optional)
+ * @returns Validation result with error details if invalid
+ */
+export declare function validateTemplateContent(templateContent: string, templatePath?: string, config?: TemplateValidationConfig): TemplateValidationResult;
+/**
+ * Validate template file size before reading
+ * @param filePath Path to template file
+ * @param maxSizeBytes Maximum allowed file size in bytes
+ * @returns True if file size is acceptable
+ */
+export declare function isTemplateSizeAcceptable(filePath: string, maxSizeBytes?: number): boolean;
+/**
+ * Quick validation for template content safety (without compilation)
+ * @param templateContent Template content to check
+ * @param config Validation configuration
+ * @returns True if content appears safe
+ */
+export declare function isTemplateContentSafe(templateContent: string, config?: TemplateValidationConfig): boolean;
+/**
+ * Get human-readable validation error message with suggestions
+ * @param result Validation result from validateTemplateContent
+ * @returns Formatted error message with suggestions
+ */
+export declare function formatValidationError(result: TemplateValidationResult): string;
+//# sourceMappingURL=templateValidator.d.ts.map

package/build/core/instructions/templateValidator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"templateValidator.d.ts","sourceRoot":"","sources":["../../../src/core/instructions/templateValidator.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,uBAAuB,CAAC,EAAE,MAAM,EAAE,CAAC;CACpC;AAED;;GAEG;AACH,eAAO,MAAM,kCAAkC,EAAE,QAAQ,CAAC,wBAAwB,CAIjF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,2BAA2B,EAAE,MAAM,EAI/C,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,eAAe,EAAE,MAAM,EACvB,YAAY,CAAC,EAAE,MAAM,EACrB,MAAM,GAAE,wBAA6B,GACpC,wBAAwB,CA0E1B;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,MAAM,EAChB,YAAY,GAAE,MAAwD,GACrE,OAAO,CAQT;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,eAAe,EAAE,MAAM,EAAE,MAAM,GAAE,wBAA6B,GAAG,OAAO,CAS7G;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,wBAAwB,GAAG,MAAM,CAe9E"}