@1mcp/agent 0.22.3 → 0.23.1

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

@@ -0,0 +1,79 @@
+/**
+ * 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[];
+    /** Maximum template size in bytes (default: 1MB) */
+    templateSizeLimit?: number;
+}
+/**
+ * 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;IAE7B,oDAAoD;IACpD,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;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,CAKpF,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,4BAA4B,+uEA2DjC,CAAC"}

package/build/core/instructions/templateTypes.js

@@ -0,0 +1,91 @@
+/**
+ * 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,
+    templateSizeLimit: 1024 * 1024, // 1MB default
+};
+/**
+ * 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":"AA0FA;;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;IACnC,iBAAiB,EAAE,IAAI,GAAG,IAAI,EAAE,cAAc;CAC/C,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QA2DpC,CAAC"}

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

@@ -0,0 +1,82 @@
+/**
+ * Types of template errors for better categorization
+ */
+export declare enum TemplateErrorType {
+    /** Handlebars syntax errors (unmatched braces, invalid expressions) */
+    SYNTAX = "SYNTAX",
+    /** Template compilation errors (missing helpers, invalid helper usage) */
+    COMPILATION = "COMPILATION",
+    /** Template size exceeds allowed limit */
+    SIZE_LIMIT = "SIZE_LIMIT",
+    /** Template contains potentially unsafe content */
+    UNSAFE_CONTENT = "UNSAFE_CONTENT",
+    /** Runtime errors during template rendering */
+    RUNTIME = "RUNTIME"
+}
+/**
+ * Template validation result with error details if invalid
+ */
+export interface TemplateValidationResult {
+    valid: boolean;
+    error?: string;
+    errorType?: TemplateErrorType;
+    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[];
+/**
+ * Categorize template errors based on error message patterns
+ * @param errorMessage Error message from Handlebars compilation
+ * @returns Template error type
+ */
+export declare function categorizeTemplateError(errorMessage: string): TemplateErrorType;
+/**
+ * Get specific suggestions based on error type
+ * @param errorType Type of template error
+ * @param errorMessage Original error message
+ * @returns Array of suggestions
+ */
+export declare function getErrorSuggestions(errorType: TemplateErrorType, errorMessage: string): string[];
+/**
+ * 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,oBAAY,iBAAiB;IAC3B,uEAAuE;IACvE,MAAM,WAAW;IACjB,0EAA0E;IAC1E,WAAW,gBAAgB;IAC3B,0CAA0C;IAC1C,UAAU,eAAe;IACzB,mDAAmD;IACnD,cAAc,mBAAmB;IACjC,+CAA+C;IAC/C,OAAO,YAAY;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,iBAAiB,CAAC;IAC9B,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;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,YAAY,EAAE,MAAM,GAAG,iBAAiB,CA2B/E;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,EAAE,CAkDhG;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,eAAe,EAAE,MAAM,EACvB,YAAY,CAAC,EAAE,MAAM,EACrB,MAAM,GAAE,wBAA6B,GACpC,wBAAwB,CA6E1B;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"}

package/build/core/instructions/templateValidator.js

@@ -0,0 +1,244 @@
+import Handlebars from 'handlebars';
+/**
+ * Types of template errors for better categorization
+ */
+export var TemplateErrorType;
+(function (TemplateErrorType) {
+    /** Handlebars syntax errors (unmatched braces, invalid expressions) */
+    TemplateErrorType["SYNTAX"] = "SYNTAX";
+    /** Template compilation errors (missing helpers, invalid helper usage) */
+    TemplateErrorType["COMPILATION"] = "COMPILATION";
+    /** Template size exceeds allowed limit */
+    TemplateErrorType["SIZE_LIMIT"] = "SIZE_LIMIT";
+    /** Template contains potentially unsafe content */
+    TemplateErrorType["UNSAFE_CONTENT"] = "UNSAFE_CONTENT";
+    /** Runtime errors during template rendering */
+    TemplateErrorType["RUNTIME"] = "RUNTIME";
+})(TemplateErrorType || (TemplateErrorType = {}));
+/**
+ * Default validation configuration
+ */
+export const DEFAULT_TEMPLATE_VALIDATION_CONFIG = {
+    maxSizeBytes: 1024 * 1024, // 1MB
+    allowUnsafeContent: false,
+    customDangerousPatterns: [],
+};
+/**
+ * Built-in dangerous patterns for template content
+ */
+export const DANGEROUS_TEMPLATE_PATTERNS = [
+    /<script[^>]*>/i,
+    /javascript:/i,
+    /on\w+\s*=/i, // event handlers like onclick=
+];
+/**
+ * Categorize template errors based on error message patterns
+ * @param errorMessage Error message from Handlebars compilation
+ * @returns Template error type
+ */
+export function categorizeTemplateError(errorMessage) {
+    const message = errorMessage.toLowerCase();
+    // Check for syntax errors
+    if (message.includes('parse error') ||
+        message.includes('expecting') ||
+        message.includes('unexpected token') ||
+        message.includes('unterminated') ||
+        message.includes('unmatched') ||
+        message.includes("doesn't match")) {
+        return TemplateErrorType.SYNTAX;
+    }
+    // Check for compilation errors
+    if (message.includes('missing helper') ||
+        message.includes('must pass iterator') ||
+        message.includes('helper not found') ||
+        message.includes('invalid helper')) {
+        return TemplateErrorType.COMPILATION;
+    }
+    // Default to compilation error for other Handlebars errors
+    return TemplateErrorType.COMPILATION;
+}
+/**
+ * Get specific suggestions based on error type
+ * @param errorType Type of template error
+ * @param errorMessage Original error message
+ * @returns Array of suggestions
+ */
+export function getErrorSuggestions(errorType, errorMessage) {
+    switch (errorType) {
+        case TemplateErrorType.SYNTAX:
+            return [
+                'Check for unmatched braces {{ }}',
+                'Ensure all Handlebars expressions are properly closed',
+                'Verify nested expressions have correct syntax',
+                'Look for unterminated block helpers like {{#if}} without {{/if}}',
+            ];
+        case TemplateErrorType.COMPILATION:
+            if (errorMessage.includes('Must pass iterator')) {
+                return [
+                    'Use {{#each serverNames}} instead of {{#each}}',
+                    'Ensure iterator variable is provided for #each helpers',
+                    'Check available template variables in documentation',
+                ];
+            }
+            return [
+                'Use only built-in Handlebars helpers',
+                'Check available template variables in documentation',
+                'Verify helper names are spelled correctly',
+                'Ensure block helpers like {{#if}} have matching {{/if}}',
+            ];
+        case TemplateErrorType.SIZE_LIMIT:
+            return [
+                'Consider splitting the template into smaller files',
+                'Remove unnecessary content or comments',
+                'Use template partials for repeated sections',
+                'Increase template size limit if necessary',
+            ];
+        case TemplateErrorType.UNSAFE_CONTENT:
+            return [
+                'Remove script tags and event handlers',
+                'Use safe template variables only',
+                'Consider using triple braces {{{content}}} only for trusted content',
+                'Review template security best practices',
+            ];
+        case TemplateErrorType.RUNTIME:
+            return [
+                'Check template variables are correctly defined',
+                'Verify data passed to template matches expected structure',
+                'Test template with sample data',
+            ];
+        default:
+            return [
+                'Check Handlebars documentation for proper syntax',
+                'Test template with a simple Handlebars validator',
+                'Start with a minimal template and add complexity gradually',
+            ];
+    }
+}
+/**
+ * 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 function validateTemplateContent(templateContent, templatePath, config = {}) {
+    const validationConfig = { ...DEFAULT_TEMPLATE_VALIDATION_CONFIG, ...config };
+    const pathInfo = templatePath ? ` at ${templatePath}` : '';
+    // Check template size
+    if (templateContent.length > validationConfig.maxSizeBytes) {
+        return {
+            valid: false,
+            error: `Template file too large${pathInfo}: ${templateContent.length} bytes (max ${Math.round(validationConfig.maxSizeBytes / 1024 / 1024)}MB)`,
+            errorType: TemplateErrorType.SIZE_LIMIT,
+            suggestions: getErrorSuggestions(TemplateErrorType.SIZE_LIMIT, ''),
+        };
+    }
+    // Check for potentially dangerous content (unless explicitly allowed)
+    if (!validationConfig.allowUnsafeContent) {
+        const allPatterns = [...DANGEROUS_TEMPLATE_PATTERNS, ...validationConfig.customDangerousPatterns];
+        for (const pattern of allPatterns) {
+            if (pattern.test(templateContent)) {
+                return {
+                    valid: false,
+                    error: `Template contains potentially unsafe content${pathInfo}: ${pattern.source}`,
+                    errorType: TemplateErrorType.UNSAFE_CONTENT,
+                    suggestions: getErrorSuggestions(TemplateErrorType.UNSAFE_CONTENT, ''),
+                };
+            }
+        }
+    }
+    // Validate Handlebars syntax by attempting compilation and rendering
+    try {
+        const compiledTemplate = Handlebars.compile(templateContent, { noEscape: true });
+        // Try rendering with sample data to catch runtime errors
+        try {
+            compiledTemplate({
+                serverCount: 0,
+                hasServers: false,
+                serverList: '',
+                serverNames: [],
+                servers: [],
+                pluralServers: 'servers',
+                isAre: 'are',
+                instructions: '',
+                filterContext: '',
+                toolPattern: '{server}_1mcp_{tool}',
+                title: 'Test Title',
+                examples: [],
+            });
+        }
+        catch (renderError) {
+            // If rendering fails, it's a compilation/runtime error
+            const errorMessage = renderError instanceof Error ? renderError.message : String(renderError);
+            const errorType = categorizeTemplateError(errorMessage);
+            const suggestions = getErrorSuggestions(errorType, errorMessage);
+            return {
+                valid: false,
+                error: `Template syntax error${pathInfo}: ${errorMessage}`,
+                errorType,
+                suggestions,
+            };
+        }
+        return { valid: true };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        const errorType = categorizeTemplateError(errorMessage);
+        const suggestions = getErrorSuggestions(errorType, errorMessage);
+        return {
+            valid: false,
+            error: `Template syntax error${pathInfo}: ${errorMessage}`,
+            errorType,
+            suggestions,
+        };
+    }
+}
+/**
+ * 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 function isTemplateSizeAcceptable(filePath, maxSizeBytes = DEFAULT_TEMPLATE_VALIDATION_CONFIG.maxSizeBytes) {
+    try {
+        const fs = require('fs');
+        const stats = fs.statSync(filePath);
+        return stats.size <= maxSizeBytes;
+    }
+    catch {
+        return false; // File doesn't exist or can't be accessed
+    }
+}
+/**
+ * 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 function isTemplateContentSafe(templateContent, config = {}) {
+    const validationConfig = { ...DEFAULT_TEMPLATE_VALIDATION_CONFIG, ...config };
+    if (!validationConfig.allowUnsafeContent) {
+        const allPatterns = [...DANGEROUS_TEMPLATE_PATTERNS, ...validationConfig.customDangerousPatterns];
+        return !allPatterns.some((pattern) => pattern.test(templateContent));
+    }
+    return true;
+}
+/**
+ * Get human-readable validation error message with suggestions
+ * @param result Validation result from validateTemplateContent
+ * @returns Formatted error message with suggestions
+ */
+export function formatValidationError(result) {
+    if (result.valid) {
+        return '';
+    }
+    let message = result.error || 'Template validation failed';
+    if (result.suggestions && result.suggestions.length > 0) {
+        message += '\n\nSuggestions:';
+        result.suggestions.forEach((suggestion, index) => {
+            message += `\n  ${index + 1}. ${suggestion}`;
+        });
+    }
+    return message;
+}
+//# sourceMappingURL=templateValidator.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"templateValidator.js","sourceRoot":"","sources":["../../../src/core/instructions/templateValidator.ts"],"names":[],"mappings":"AAAA,OAAO,UAAU,MAAM,YAAY,CAAC;AAEpC;;GAEG;AACH,MAAM,CAAN,IAAY,iBAWX;AAXD,WAAY,iBAAiB;IAC3B,uEAAuE;IACvE,sCAAiB,CAAA;IACjB,0EAA0E;IAC1E,gDAA2B,CAAA;IAC3B,0CAA0C;IAC1C,8CAAyB,CAAA;IACzB,mDAAmD;IACnD,sDAAiC,CAAA;IACjC,+CAA+C;IAC/C,wCAAmB,CAAA;AACrB,CAAC,EAXW,iBAAiB,KAAjB,iBAAiB,QAW5B;AAqBD;;GAEG;AACH,MAAM,CAAC,MAAM,kCAAkC,GAAuC;IACpF,YAAY,EAAE,IAAI,GAAG,IAAI,EAAE,MAAM;IACjC,kBAAkB,EAAE,KAAK;IACzB,uBAAuB,EAAE,EAAE;CAC5B,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAa;IACnD,gBAAgB;IAChB,cAAc;IACd,YAAY,EAAE,+BAA+B;CAC9C,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,uBAAuB,CAAC,YAAoB;IAC1D,MAAM,OAAO,GAAG,YAAY,CAAC,WAAW,EAAE,CAAC;IAE3C,0BAA0B;IAC1B,IACE,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC;QAC/B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC;QAC7B,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAC;QACpC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC;QAChC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC;QAC7B,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC,EACjC,CAAC;QACD,OAAO,iBAAiB,CAAC,MAAM,CAAC;IAClC,CAAC;IAED,+BAA+B;IAC/B,IACE,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC;QAClC,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAC;QACtC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAC;QACpC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC,EAClC,CAAC;QACD,OAAO,iBAAiB,CAAC,WAAW,CAAC;IACvC,CAAC;IAED,2DAA2D;IAC3D,OAAO,iBAAiB,CAAC,WAAW,CAAC;AACvC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,SAA4B,EAAE,YAAoB;IACpF,QAAQ,SAAS,EAAE,CAAC;QAClB,KAAK,iBAAiB,CAAC,MAAM;YAC3B,OAAO;gBACL,kCAAkC;gBAClC,uDAAuD;gBACvD,+CAA+C;gBAC/C,kEAAkE;aACnE,CAAC;QACJ,KAAK,iBAAiB,CAAC,WAAW;YAChC,IAAI,YAAY,CAAC,QAAQ,CAAC,oBAAoB,CAAC,EAAE,CAAC;gBAChD,OAAO;oBACL,gDAAgD;oBAChD,wDAAwD;oBACxD,qDAAqD;iBACtD,CAAC;YACJ,CAAC;YACD,OAAO;gBACL,sCAAsC;gBACtC,qDAAqD;gBACrD,2CAA2C;gBAC3C,yDAAyD;aAC1D,CAAC;QACJ,KAAK,iBAAiB,CAAC,UAAU;YAC/B,OAAO;gBACL,oDAAoD;gBACpD,wCAAwC;gBACxC,6CAA6C;gBAC7C,2CAA2C;aAC5C,CAAC;QACJ,KAAK,iBAAiB,CAAC,cAAc;YACnC,OAAO;gBACL,uCAAuC;gBACvC,kCAAkC;gBAClC,qEAAqE;gBACrE,yCAAyC;aAC1C,CAAC;QACJ,KAAK,iBAAiB,CAAC,OAAO;YAC5B,OAAO;gBACL,gDAAgD;gBAChD,2DAA2D;gBAC3D,gCAAgC;aACjC,CAAC;QACJ;YACE,OAAO;gBACL,kDAAkD;gBAClD,kDAAkD;gBAClD,4DAA4D;aAC7D,CAAC;IACN,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,uBAAuB,CACrC,eAAuB,EACvB,YAAqB,EACrB,SAAmC,EAAE;IAErC,MAAM,gBAAgB,GAAG,EAAE,GAAG,kCAAkC,EAAE,GAAG,MAAM,EAAE,CAAC;IAC9E,MAAM,QAAQ,GAAG,YAAY,CAAC,CAAC,CAAC,OAAO,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAE3D,sBAAsB;IACtB,IAAI,eAAe,CAAC,MAAM,GAAG,gBAAgB,CAAC,YAAY,EAAE,CAAC;QAC3D,OAAO;YACL,KAAK,EAAE,KAAK;YACZ,KAAK,EAAE,0BAA0B,QAAQ,KAAK,eAAe,CAAC,MAAM,eAAe,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,YAAY,GAAG,IAAI,GAAG,IAAI,CAAC,KAAK;YAC/I,SAAS,EAAE,iBAAiB,CAAC,UAAU;YACvC,WAAW,EAAE,mBAAmB,CAAC,iBAAiB,CAAC,UAAU,EAAE,EAAE,CAAC;SACnE,CAAC;IACJ,CAAC;IAED,sEAAsE;IACtE,IAAI,CAAC,gBAAgB,CAAC,kBAAkB,EAAE,CAAC;QACzC,MAAM,WAAW,GAAG,CAAC,GAAG,2BAA2B,EAAE,GAAG,gBAAgB,CAAC,uBAAuB,CAAC,CAAC;QAElG,KAAK,MAAM,OAAO,IAAI,WAAW,EAAE,CAAC;YAClC,IAAI,OAAO,CAAC,IAAI,CAAC,eAAe,CAAC,EAAE,CAAC;gBAClC,OAAO;oBACL,KAAK,EAAE,KAAK;oBACZ,KAAK,EAAE,+CAA+C,QAAQ,KAAK,OAAO,CAAC,MAAM,EAAE;oBACnF,SAAS,EAAE,iBAAiB,CAAC,cAAc;oBAC3C,WAAW,EAAE,mBAAmB,CAAC,iBAAiB,CAAC,cAAc,EAAE,EAAE,CAAC;iBACvE,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAED,qEAAqE;IACrE,IAAI,CAAC;QACH,MAAM,gBAAgB,GAAG,UAAU,CAAC,OAAO,CAAC,eAAe,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;QAEjF,yDAAyD;QACzD,IAAI,CAAC;YACH,gBAAgB,CAAC;gBACf,WAAW,EAAE,CAAC;gBACd,UAAU,EAAE,KAAK;gBACjB,UAAU,EAAE,EAAE;gBACd,WAAW,EAAE,EAAE;gBACf,OAAO,EAAE,EAAE;gBACX,aAAa,EAAE,SAAS;gBACxB,KAAK,EAAE,KAAK;gBACZ,YAAY,EAAE,EAAE;gBAChB,aAAa,EAAE,EAAE;gBACjB,WAAW,EAAE,sBAAsB;gBACnC,KAAK,EAAE,YAAY;gBACnB,QAAQ,EAAE,EAAE;aACb,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,WAAW,EAAE,CAAC;YACrB,uDAAuD;YACvD,MAAM,YAAY,GAAG,WAAW,YAAY,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;YAC9F,MAAM,SAAS,GAAG,uBAAuB,CAAC,YAAY,CAAC,CAAC;YACxD,MAAM,WAAW,GAAG,mBAAmB,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;YAEjE,OAAO;gBACL,KAAK,EAAE,KAAK;gBACZ,KAAK,EAAE,wBAAwB,QAAQ,KAAK,YAAY,EAAE;gBAC1D,SAAS;gBACT,WAAW;aACZ,CAAC;QACJ,CAAC;QAED,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IACzB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC5E,MAAM,SAAS,GAAG,uBAAuB,CAAC,YAAY,CAAC,CAAC;QACxD,MAAM,WAAW,GAAG,mBAAmB,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;QAEjE,OAAO;YACL,KAAK,EAAE,KAAK;YACZ,KAAK,EAAE,wBAAwB,QAAQ,KAAK,YAAY,EAAE;YAC1D,SAAS;YACT,WAAW;SACZ,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,wBAAwB,CACtC,QAAgB,EAChB,eAAuB,kCAAkC,CAAC,YAAY;IAEtE,IAAI,CAAC;QACH,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QACzB,MAAM,KAAK,GAAG,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACpC,OAAO,KAAK,CAAC,IAAI,IAAI,YAAY,CAAC;IACpC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC,CAAC,0CAA0C;IAC1D,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CAAC,eAAuB,EAAE,SAAmC,EAAE;IAClG,MAAM,gBAAgB,GAAG,EAAE,GAAG,kCAAkC,EAAE,GAAG,MAAM,EAAE,CAAC;IAE9E,IAAI,CAAC,gBAAgB,CAAC,kBAAkB,EAAE,CAAC;QACzC,MAAM,WAAW,GAAG,CAAC,GAAG,2BAA2B,EAAE,GAAG,gBAAgB,CAAC,uBAAuB,CAAC,CAAC;QAClG,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC;IACvE,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CAAC,MAAgC;IACpE,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QACjB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,IAAI,OAAO,GAAG,MAAM,CAAC,KAAK,IAAI,4BAA4B,CAAC;IAE3D,IAAI,MAAM,CAAC,WAAW,IAAI,MAAM,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxD,OAAO,IAAI,kBAAkB,CAAC;QAC9B,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,UAAU,EAAE,KAAK,EAAE,EAAE;YAC/C,OAAO,IAAI,OAAO,KAAK,GAAG,CAAC,KAAK,UAAU,EAAE,CAAC;QAC/C,CAAC,CAAC,CAAC;IACL,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/build/core/server/serverManager.d.ts

@@ -1,6 +1,7 @@
 import { Transport } from '@modelcontextprotocol/sdk/shared/transport.js';
 import { OutboundConnections, InboundConnection, InboundConnectionConfig, OperationOptions } from '../types/index.js';
 import type { OutboundConnection } from '../types/client.js';
+import { InstructionAggregator } from '../instructions/instructionAggregator.js';
 export declare class ServerManager {
     private static instance;
     private inboundConns;
@@ -10,6 +11,7 @@ export declare class ServerManager {
     private transports;
     private connectionSemaphore;
     private disconnectingIds;
+    private instructionAggregator?;
     private constructor();
     static getOrCreateInstance(config: {
         name: string;
@@ -19,6 +21,15 @@ export declare class ServerManager {
     }, outboundConns: OutboundConnections, transports: Record<string, Transport>): ServerManager;
     static get current(): ServerManager;
     static resetInstance(): void;
+    /**
+     * Set the instruction aggregator instance
+     * @param aggregator The instruction aggregator to use
+     */
+    setInstructionAggregator(aggregator: InstructionAggregator): void;
+    /**
+     * Update all server instances with new aggregated instructions
+     */
+    private updateServerInstructions;
     connectTransport(transport: Transport, sessionId: string, opts: InboundConnectionConfig): Promise<void>;
     private performConnection;
     private doConnect;

package/build/core/server/serverManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"serverManager.d.ts","sourceRoot":"","sources":["../../../src/core/server/serverManager.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,+CAA+C,CAAC;AAM1E,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,uBAAuB,EACvB,gBAAgB,EAEjB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAG7D,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAA4B;IACnD,OAAO,CAAC,YAAY,CAA6C;IACjE,OAAO,CAAC,YAAY,CAAoC;IACxD,OAAO,CAAC,kBAAkB,CAA4C;IAEtE,OAAO,CAAC,aAAa,CAA8D;IACnF,OAAO,CAAC,UAAU,CAAiC;IACnD,OAAO,CAAC,mBAAmB,CAAyC;IACpE,OAAO,CAAC,gBAAgB,CAA0B;IAElD,OAAO;WAYO,mBAAmB,CAC/B,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EACzC,YAAY,EAAE;QAAE,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,EACvD,aAAa,EAAE,mBAAmB,EAClC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GACpC,aAAa;IAOhB,WAAkB,OAAO,IAAI,aAAa,CAKzC;WAGa,aAAa,IAAI,IAAI;IAatB,gBAAgB,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC;YA2BtG,iBAAiB;YA2BjB,SAAS;IAmEhB,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,GAAE,OAAe,GAAG,IAAI;IAsCzE,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAItD,aAAa,IAAI,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC;IAUvC,mBAAmB,IAAI,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC;IAIhD,UAAU,IAAI,mBAAmB;IAIxC;;;OAGG;IACI,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS;IAI7D,wBAAwB,IAAI,MAAM;IAIlC,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS;IAI3D,qBAAqB,IAAI,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC;IAIvD,0BAA0B,CAAC,UAAU,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,IAAI;IAKlH;;;;;OAKG;IACU,sBAAsB,CAAC,CAAC,EACnC,WAAW,EAAE,iBAAiB,EAC9B,SAAS,EAAE,CAAC,WAAW,EAAE,iBAAiB,KAAK,OAAO,CAAC,CAAC,CAAC,EACzD,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,CAAC,CAAC;CAQd"}
+{"version":3,"file":"serverManager.d.ts","sourceRoot":"","sources":["../../../src/core/server/serverManager.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,+CAA+C,CAAC;AAM1E,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,uBAAuB,EACvB,gBAAgB,EAEjB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAE7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,0CAA0C,CAAC;AAEjF,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAA4B;IACnD,OAAO,CAAC,YAAY,CAA6C;IACjE,OAAO,CAAC,YAAY,CAAoC;IACxD,OAAO,CAAC,kBAAkB,CAA4C;IAEtE,OAAO,CAAC,aAAa,CAA8D;IACnF,OAAO,CAAC,UAAU,CAAiC;IACnD,OAAO,CAAC,mBAAmB,CAAyC;IACpE,OAAO,CAAC,gBAAgB,CAA0B;IAClD,OAAO,CAAC,qBAAqB,CAAC,CAAwB;IAEtD,OAAO;WAYO,mBAAmB,CAC/B,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EACzC,YAAY,EAAE;QAAE,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,EACvD,aAAa,EAAE,mBAAmB,EAClC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GACpC,aAAa;IAOhB,WAAkB,OAAO,IAAI,aAAa,CAKzC;WAGa,aAAa,IAAI,IAAI;IAanC;;;OAGG;IACI,wBAAwB,CAAC,UAAU,EAAE,qBAAqB,GAAG,IAAI;IAWxE;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAenB,gBAAgB,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC;YA2BtG,iBAAiB;YA2BjB,SAAS;IA4EhB,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,GAAE,OAAe,GAAG,IAAI;IAsCzE,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAItD,aAAa,IAAI,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC;IAUvC,mBAAmB,IAAI,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC;IAIhD,UAAU,IAAI,mBAAmB;IAIxC;;;OAGG;IACI,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS;IAI7D,wBAAwB,IAAI,MAAM;IAIlC,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS;IAI3D,qBAAqB,IAAI,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC;IAIvD,0BAA0B,CAAC,UAAU,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,IAAI;IAKlH;;;;;OAKG;IACU,sBAAsB,CAAC,CAAC,EACnC,WAAW,EAAE,iBAAiB,EAC9B,SAAS,EAAE,CAAC,WAAW,EAAE,iBAAiB,KAAK,OAAO,CAAC,CAAC,CAAC,EACzD,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,CAAC,CAAC;CAQd"}

package/build/core/server/serverManager.js

@@ -15,6 +15,7 @@ export class ServerManager {
     transports = {};
     connectionSemaphore = new Map();
     disconnectingIds = new Set();
+    instructionAggregator;
     constructor(config, capabilities, outboundConns, transports) {
         this.serverConfig = config;
         this.serverCapabilities = capabilities;
@@ -46,6 +47,35 @@ export class ServerManager {
         }
         ServerManager.instance = undefined;
     }
+    /**
+     * Set the instruction aggregator instance
+     * @param aggregator The instruction aggregator to use
+     */
+    setInstructionAggregator(aggregator) {
+        this.instructionAggregator = aggregator;
+        // Listen for instruction changes and update existing server instances
+        aggregator.on('instructions-changed', () => {
+            this.updateServerInstructions();
+        });
+        logger.debug('Instruction aggregator set for ServerManager');
+    }
+    /**
+     * Update all server instances with new aggregated instructions
+     */
+    updateServerInstructions() {
+        logger.info(`Server instructions have changed. Active sessions: ${this.inboundConns.size}`);
+        for (const [sessionId, _inboundConn] of this.inboundConns) {
+            try {
+                // Note: The MCP SDK doesn't provide a direct way to update instructions
+                // on an existing server instance. Instructions are set during server construction.
+                // For now, we'll log this for future server instances.
+                logger.debug(`Instructions changed notification for session ${sessionId}`);
+            }
+            catch (error) {
+                logger.warn(`Failed to process instruction change for session ${sessionId}: ${error}`);
+            }
+        }
+    }
     async connectTransport(transport, sessionId, opts) {
         // Check if a connection is already in progress for this session
         const existingConnection = this.connectionSemaphore.get(sessionId);
@@ -91,8 +121,15 @@ export class ServerManager {
         }
     }
     async doConnect(transport, sessionId, opts) {
+        // Get filtered instructions based on client's filter criteria using InstructionAggregator
+        const filteredInstructions = this.instructionAggregator?.getFilteredInstructions(opts, this.outboundConns) || '';
+        // Create server capabilities with filtered instructions
+        const serverOptionsWithInstructions = {
+            ...this.serverCapabilities,
+            instructions: filteredInstructions || undefined,
+        };
         // Create a new server instance for this transport
-        const server = new Server(this.serverConfig, this.serverCapabilities);
+        const server = new Server(this.serverConfig, serverOptionsWithInstructions);
         // Create server info object first
         const serverInfo = {
             server,