mcp-agent-foundry 1.0.0

package/dist/config/manager.js

@@ -0,0 +1,347 @@
+/**
+ * Configuration Manager for AgentRouter
+ *
+ * Handles loading, merging, validating, and watching configuration files.
+ * Supports multiple config sources with priority-based merging and
+ * environment variable interpolation.
+ */
+import { EventEmitter } from 'events';
+import { watch } from 'fs';
+import { readFile, access, constants } from 'fs/promises';
+import { parse as parseYAML } from 'yaml';
+import { ConfigurationError, } from '../types.js';
+import { DEFAULT_CONFIG, getAllConfigPaths } from './defaults.js';
+import { ConfigMerger } from './merger.js';
+import { ConfigValidator } from './validator.js';
+/**
+ * Configuration manager with hot reload support.
+ * Extends EventEmitter for change notifications.
+ */
+export class ConfigManager extends EventEmitter {
+    config;
+    validator;
+    merger;
+    configPaths;
+    watchers = [];
+    options;
+    loadedPaths = new Set();
+    /**
+     * Private constructor - use static load() method to create instances.
+     */
+    constructor(options = {}) {
+        super();
+        this.validator = new ConfigValidator();
+        this.merger = new ConfigMerger();
+        this.options = {
+            configPath: options.configPath ?? '',
+            watch: options.watch ?? true,
+            allowMissingEnv: options.allowMissingEnv ?? false,
+        };
+        // Build config paths list with CLI override at highest priority
+        const basePaths = getAllConfigPaths();
+        this.configPaths = this.options.configPath
+            ? [this.options.configPath, ...basePaths]
+            : basePaths;
+    }
+    /**
+     * Load configuration and create a ConfigManager instance.
+     * This is the primary way to create a ConfigManager.
+     *
+     * @param options - Configuration options
+     * @returns Promise resolving to initialized ConfigManager
+     * @throws ConfigurationError if config loading fails
+     */
+    static async load(options = {}) {
+        const manager = new ConfigManager(options);
+        await manager.loadConfig();
+        if (manager.options.watch) {
+            manager.watchConfig();
+        }
+        return manager;
+    }
+    /**
+     * Load and merge configuration from all sources.
+     * Config files are loaded in reverse priority order (lowest first)
+     * so that higher priority configs override lower ones.
+     */
+    async loadConfig() {
+        // Start with default config
+        let merged = structuredClone(DEFAULT_CONFIG);
+        this.loadedPaths.clear();
+        // Load configs in reverse priority order (lowest to highest)
+        // System configs first, then user configs, then project configs
+        const reversedPaths = [...this.configPaths].reverse();
+        for (const configPath of reversedPaths) {
+            try {
+                // Check if file exists
+                await access(configPath, constants.R_OK);
+                // Read and parse YAML
+                const content = await readFile(configPath, 'utf-8');
+                const parsed = parseYAML(content);
+                if (parsed === null || parsed === undefined) {
+                    // Empty file, skip
+                    continue;
+                }
+                // Validate as partial config (not all fields required)
+                this.validator.validatePartialConfig(parsed);
+                // Interpolate environment variables
+                const interpolated = this.interpolateEnv(parsed);
+                // Merge into accumulated config
+                merged = this.merger.merge(merged, interpolated);
+                this.loadedPaths.add(configPath);
+            }
+            catch (error) {
+                // ENOENT is expected for non-existent config files
+                if (error.code === 'ENOENT') {
+                    continue;
+                }
+                // For explicitly provided config path, throw error
+                if (configPath === this.options.configPath) {
+                    throw new ConfigurationError(`Failed to load config from ${configPath}: ${error.message}`, error);
+                }
+                // For other paths, log warning but continue
+                console.warn(`Warning: Failed to load config from ${configPath}:`, error.message);
+            }
+        }
+        // Final validation of merged config
+        this.config = this.validator.validate(merged);
+    }
+    /**
+     * Interpolate environment variables in configuration values.
+     * Replaces ${VAR_NAME} patterns with the corresponding env value.
+     *
+     * @param obj - Object to interpolate
+     * @returns Object with interpolated values
+     * @throws ConfigurationError if required env var is missing
+     */
+    interpolateEnv(obj) {
+        if (typeof obj === 'string') {
+            return obj.replace(/\$\{([^}]+)\}/g, (match, envVar) => {
+                const value = process.env[envVar];
+                if (value === undefined) {
+                    if (this.options.allowMissingEnv) {
+                        // Keep the placeholder for missing env vars
+                        return match;
+                    }
+                    throw new ConfigurationError(`Environment variable ${envVar} is not set`);
+                }
+                return value;
+            });
+        }
+        if (Array.isArray(obj)) {
+            return obj.map((item) => this.interpolateEnv(item));
+        }
+        if (typeof obj === 'object' && obj !== null) {
+            return Object.fromEntries(Object.entries(obj).map(([key, value]) => [
+                key,
+                this.interpolateEnv(value),
+            ]));
+        }
+        return obj;
+    }
+    /**
+     * Watch loaded config files for changes.
+     * Emits 'change' event when config is successfully reloaded.
+     * Emits 'error' event when reload fails.
+     */
+    watchConfig() {
+        // Watch all paths that were successfully loaded
+        for (const configPath of this.loadedPaths) {
+            try {
+                const watcher = watch(configPath, async (eventType) => {
+                    if (eventType === 'change') {
+                        console.log(`Config file changed: ${configPath}`);
+                        try {
+                            await this.loadConfig();
+                            this.emit('change', this.config);
+                        }
+                        catch (error) {
+                            console.error('Failed to reload config:', error.message);
+                            this.emit('error', error, configPath);
+                        }
+                    }
+                });
+                this.watchers.push(watcher);
+            }
+            catch {
+                // File might not exist or be watchable, that's okay
+            }
+        }
+        // Also watch paths that didn't exist - they might be created
+        for (const configPath of this.configPaths) {
+            if (this.loadedPaths.has(configPath)) {
+                continue; // Already watching
+            }
+            try {
+                const watcher = watch(configPath, async (eventType) => {
+                    if (eventType === 'rename' || eventType === 'change') {
+                        console.log(`Config file created: ${configPath}`);
+                        try {
+                            await this.loadConfig();
+                            this.emit('change', this.config);
+                            // Restart watchers to include new file
+                            this.stopWatching();
+                            this.watchConfig();
+                        }
+                        catch (error) {
+                            console.error('Failed to reload config:', error.message);
+                            this.emit('error', error, configPath);
+                        }
+                    }
+                });
+                this.watchers.push(watcher);
+            }
+            catch {
+                // File or directory doesn't exist, that's okay
+            }
+        }
+    }
+    /**
+     * Stop watching config files.
+     */
+    stopWatching() {
+        for (const watcher of this.watchers) {
+            watcher.close();
+        }
+        this.watchers = [];
+    }
+    /**
+     * Manually reload configuration.
+     * Useful when programmatically updating config files.
+     *
+     * @returns Promise resolving when reload is complete
+     * @throws ConfigurationError if reload fails
+     */
+    async reload() {
+        await this.loadConfig();
+        this.emit('change', this.config);
+    }
+    /**
+     * Close the ConfigManager and stop watching files.
+     * Should be called when shutting down.
+     */
+    close() {
+        this.stopWatching();
+        this.removeAllListeners();
+    }
+    /**
+     * Get the full configuration object.
+     *
+     * @returns Complete configuration
+     */
+    get() {
+        return this.config;
+    }
+    /**
+     * Get the version string from config.
+     *
+     * @returns Config version
+     */
+    getVersion() {
+        return this.config.version;
+    }
+    /**
+     * Get all role configurations.
+     *
+     * @returns Map of role names to role configs
+     */
+    getRoles() {
+        return this.config.roles;
+    }
+    /**
+     * Get a specific role configuration.
+     *
+     * @param roleName - Name of the role
+     * @returns Role configuration or undefined if not found
+     */
+    getRole(roleName) {
+        return this.config.roles[roleName];
+    }
+    /**
+     * Get all provider configurations.
+     *
+     * @returns Map of provider names to provider configs
+     */
+    getProviders() {
+        return this.config.providers;
+    }
+    /**
+     * Get a specific provider configuration.
+     *
+     * @param providerName - Name of the provider
+     * @returns Provider configuration or undefined if not found
+     */
+    getProvider(providerName) {
+        return this.config.providers[providerName];
+    }
+    /**
+     * Get default configuration values.
+     *
+     * @returns Default config values
+     */
+    getDefaults() {
+        return this.config.defaults;
+    }
+    /**
+     * Get list of available role names.
+     *
+     * @returns Array of role names
+     */
+    getRoleNames() {
+        return Object.keys(this.config.roles);
+    }
+    /**
+     * Get list of available provider names.
+     *
+     * @returns Array of provider names
+     */
+    getProviderNames() {
+        return Object.keys(this.config.providers);
+    }
+    /**
+     * Check if a role exists.
+     *
+     * @param roleName - Name of the role to check
+     * @returns True if role exists
+     */
+    hasRole(roleName) {
+        return roleName in this.config.roles;
+    }
+    /**
+     * Check if a provider exists.
+     *
+     * @param providerName - Name of the provider to check
+     * @returns True if provider exists
+     */
+    hasProvider(providerName) {
+        return providerName in this.config.providers;
+    }
+    /**
+     * Get the paths of all loaded config files.
+     *
+     * @returns Array of loaded config file paths
+     */
+    getLoadedPaths() {
+        return [...this.loadedPaths];
+    }
+    /**
+     * Get all config search paths (including unloaded).
+     *
+     * @returns Array of all config paths that are searched
+     */
+    getSearchPaths() {
+        return [...this.configPaths];
+    }
+}
+/**
+ * Convenience function to load configuration.
+ * Creates a ConfigManager and returns the config object.
+ *
+ * @param options - Configuration options
+ * @returns Promise resolving to the loaded Config
+ */
+export async function loadConfig(options = {}) {
+    const manager = await ConfigManager.load({ ...options, watch: false });
+    return manager.get();
+}
+//# sourceMappingURL=manager.js.map

package/dist/config/manager.js.map

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

package/dist/config/merger.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Configuration Merger for AgentRouter
+ *
+ * Provides utilities for deep merging configuration objects.
+ * Used by ConfigManager to combine configs from multiple sources.
+ */
+import type { Config } from '../types.js';
+/**
+ * Configuration merger utility class.
+ * Handles deep merging of configuration objects with specific merge rules.
+ */
+export declare class ConfigMerger {
+    /**
+     * Deep merge two configuration objects.
+     * Source values override target values.
+     * Objects are merged recursively, arrays are replaced.
+     *
+     * @param target - Base configuration
+     * @param source - Configuration to merge on top
+     * @returns Merged configuration
+     */
+    merge(target: Config, source: Partial<Config>): Config;
+    /**
+     * Merge default configuration values.
+     *
+     * @param target - Base defaults
+     * @param source - Defaults to merge
+     * @returns Merged defaults
+     */
+    private mergeDefaults;
+    /**
+     * Merge role configurations.
+     * Roles from source are merged into target.
+     * Individual role properties are deep merged.
+     *
+     * @param target - Base roles
+     * @param source - Roles to merge
+     * @returns Merged roles
+     */
+    private mergeRoles;
+    /**
+     * Merge a single role configuration.
+     *
+     * @param target - Base role config
+     * @param source - Role config to merge
+     * @returns Merged role config
+     */
+    private mergeRoleConfig;
+    /**
+     * Merge provider configurations.
+     * Providers from source are merged into target.
+     * Individual provider properties are deep merged.
+     *
+     * @param target - Base providers
+     * @param source - Providers to merge
+     * @returns Merged providers
+     */
+    private mergeProviders;
+    /**
+     * Merge a single provider configuration.
+     *
+     * @param target - Base provider config
+     * @param source - Provider config to merge
+     * @returns Merged provider config
+     */
+    private mergeProviderConfig;
+}
+/**
+ * Convenience function to merge two configs.
+ *
+ * @param target - Base configuration
+ * @param source - Configuration to merge on top
+ * @returns Merged configuration
+ */
+export declare function mergeConfigs(target: Config, source: Partial<Config>): Config;
+//# sourceMappingURL=merger.d.ts.map

package/dist/config/merger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merger.d.ts","sourceRoot":"","sources":["../../src/config/merger.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,MAAM,EAA6C,MAAM,aAAa,CAAC;AAErF;;;GAGG;AACH,qBAAa,YAAY;IACvB;;;;;;;;OAQG;IACH,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM;IAStD;;;;;;OAMG;IACH,OAAO,CAAC,aAAa;IAarB;;;;;;;;OAQG;IACH,OAAO,CAAC,UAAU;IAsBlB;;;;;;OAMG;IACH,OAAO,CAAC,eAAe;IAqCvB;;;;;;;;OAQG;IACH,OAAO,CAAC,cAAc;IAsBtB;;;;;;OAMG;IACH,OAAO,CAAC,mBAAmB;CA0C5B;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM,CAG5E"}

package/dist/config/merger.js

@@ -0,0 +1,189 @@
+/**
+ * Configuration Merger for AgentRouter
+ *
+ * Provides utilities for deep merging configuration objects.
+ * Used by ConfigManager to combine configs from multiple sources.
+ */
+/**
+ * Configuration merger utility class.
+ * Handles deep merging of configuration objects with specific merge rules.
+ */
+export class ConfigMerger {
+    /**
+     * Deep merge two configuration objects.
+     * Source values override target values.
+     * Objects are merged recursively, arrays are replaced.
+     *
+     * @param target - Base configuration
+     * @param source - Configuration to merge on top
+     * @returns Merged configuration
+     */
+    merge(target, source) {
+        return {
+            version: source.version ?? target.version,
+            defaults: this.mergeDefaults(target.defaults, source.defaults),
+            roles: this.mergeRoles(target.roles, source.roles),
+            providers: this.mergeProviders(target.providers, source.providers),
+        };
+    }
+    /**
+     * Merge default configuration values.
+     *
+     * @param target - Base defaults
+     * @param source - Defaults to merge
+     * @returns Merged defaults
+     */
+    mergeDefaults(target, source) {
+        if (!source) {
+            return { ...target };
+        }
+        return {
+            temperature: source.temperature ?? target.temperature,
+            max_tokens: source.max_tokens ?? target.max_tokens,
+            timeout_ms: source.timeout_ms ?? target.timeout_ms,
+        };
+    }
+    /**
+     * Merge role configurations.
+     * Roles from source are merged into target.
+     * Individual role properties are deep merged.
+     *
+     * @param target - Base roles
+     * @param source - Roles to merge
+     * @returns Merged roles
+     */
+    mergeRoles(target, source) {
+        if (!source) {
+            return { ...target };
+        }
+        const result = { ...target };
+        for (const [roleName, roleConfig] of Object.entries(source)) {
+            const existingRole = result[roleName];
+            if (existingRole) {
+                // Merge existing role
+                result[roleName] = this.mergeRoleConfig(existingRole, roleConfig);
+            }
+            else {
+                // Add new role
+                result[roleName] = { ...roleConfig };
+            }
+        }
+        return result;
+    }
+    /**
+     * Merge a single role configuration.
+     *
+     * @param target - Base role config
+     * @param source - Role config to merge
+     * @returns Merged role config
+     */
+    mergeRoleConfig(target, source) {
+        const result = {
+            provider: source.provider ?? target.provider,
+            model: source.model ?? target.model,
+        };
+        // Optional fields - only set if defined in either source or target
+        const systemPrompt = source.system_prompt ?? target.system_prompt;
+        if (systemPrompt !== undefined) {
+            result.system_prompt = systemPrompt;
+        }
+        const temperature = source.temperature ?? target.temperature;
+        if (temperature !== undefined) {
+            result.temperature = temperature;
+        }
+        const maxTokens = source.max_tokens ?? target.max_tokens;
+        if (maxTokens !== undefined) {
+            result.max_tokens = maxTokens;
+        }
+        const timeoutMs = source.timeout_ms ?? target.timeout_ms;
+        if (timeoutMs !== undefined) {
+            result.timeout_ms = timeoutMs;
+        }
+        // Fallback config - replace entirely if provided
+        if (source.fallback !== undefined) {
+            result.fallback = { ...source.fallback };
+        }
+        else if (target.fallback !== undefined) {
+            result.fallback = { ...target.fallback };
+        }
+        return result;
+    }
+    /**
+     * Merge provider configurations.
+     * Providers from source are merged into target.
+     * Individual provider properties are deep merged.
+     *
+     * @param target - Base providers
+     * @param source - Providers to merge
+     * @returns Merged providers
+     */
+    mergeProviders(target, source) {
+        if (!source) {
+            return { ...target };
+        }
+        const result = { ...target };
+        for (const [providerName, providerConfig] of Object.entries(source)) {
+            const existingProvider = result[providerName];
+            if (existingProvider) {
+                // Merge existing provider
+                result[providerName] = this.mergeProviderConfig(existingProvider, providerConfig);
+            }
+            else {
+                // Add new provider
+                result[providerName] = { ...providerConfig };
+            }
+        }
+        return result;
+    }
+    /**
+     * Merge a single provider configuration.
+     *
+     * @param target - Base provider config
+     * @param source - Provider config to merge
+     * @returns Merged provider config
+     */
+    mergeProviderConfig(target, source) {
+        const result = {};
+        // Merge all optional fields - only set if defined
+        const apiKey = source.api_key ?? target.api_key;
+        if (apiKey !== undefined) {
+            result.api_key = apiKey;
+        }
+        const baseUrl = source.base_url ?? target.base_url;
+        if (baseUrl !== undefined) {
+            result.base_url = baseUrl;
+        }
+        const organization = source.organization ?? target.organization;
+        if (organization !== undefined) {
+            result.organization = organization;
+        }
+        const project = source.project ?? target.project;
+        if (project !== undefined) {
+            result.project = project;
+        }
+        const location = source.location ?? target.location;
+        if (location !== undefined) {
+            result.location = location;
+        }
+        // Headers are merged (source overrides target keys)
+        if (source.headers || target.headers) {
+            result.headers = {
+                ...target.headers,
+                ...source.headers,
+            };
+        }
+        return result;
+    }
+}
+/**
+ * Convenience function to merge two configs.
+ *
+ * @param target - Base configuration
+ * @param source - Configuration to merge on top
+ * @returns Merged configuration
+ */
+export function mergeConfigs(target, source) {
+    const merger = new ConfigMerger();
+    return merger.merge(target, source);
+}
+//# sourceMappingURL=merger.js.map

package/dist/config/merger.js.map

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

package/dist/config/schema.d.ts

@@ -0,0 +1,20 @@
+/**
+ * JSON Schema Export for AgentRouter Configuration
+ *
+ * Re-exports the configuration JSON Schema for external use,
+ * such as IDE validation, documentation generation, or schema.json files.
+ */
+import { configSchema } from './validator.js';
+/**
+ * JSON Schema for AgentRouter configuration.
+ * Can be used for:
+ * - IDE validation (VS Code, JetBrains)
+ * - Documentation generation
+ * - External tooling
+ */
+export { configSchema };
+/**
+ * Export as default for direct import.
+ */
+export default configSchema;
+//# sourceMappingURL=schema.d.ts.map

package/dist/config/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/config/schema.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C;;;;;;GAMG;AACH,OAAO,EAAE,YAAY,EAAE,CAAC;AAExB;;GAEG;AACH,eAAe,YAAY,CAAC"}

package/dist/config/schema.js

@@ -0,0 +1,20 @@
+/**
+ * JSON Schema Export for AgentRouter Configuration
+ *
+ * Re-exports the configuration JSON Schema for external use,
+ * such as IDE validation, documentation generation, or schema.json files.
+ */
+import { configSchema } from './validator.js';
+/**
+ * JSON Schema for AgentRouter configuration.
+ * Can be used for:
+ * - IDE validation (VS Code, JetBrains)
+ * - Documentation generation
+ * - External tooling
+ */
+export { configSchema };
+/**
+ * Export as default for direct import.
+ */
+export default configSchema;
+//# sourceMappingURL=schema.js.map

package/dist/config/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/config/schema.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C;;;;;;GAMG;AACH,OAAO,EAAE,YAAY,EAAE,CAAC;AAExB;;GAEG;AACH,eAAe,YAAY,CAAC"}