@daniel.stefan/metalink 1.3.1

package/packages/core/dist/config/loader.d.ts

@@ -0,0 +1,269 @@
+import { MetalinkConfig, ServerConfig, DaemonConfig } from './schema.js';
+/**
+ * ConfigLoader - Handles loading and validation of metalink configurations
+ * Supports YAML and JSON formats with environment variable interpolation
+ */
+export declare class ConfigLoader {
+    private configPath;
+    private config;
+    constructor(configPath?: string);
+    /**
+     * Finds default config location
+     * Tries: ./metalink.config.yaml, ./metalink.config.json, ~/.config/metalink/config.yaml
+     */
+    private findDefaultConfigPath;
+    /**
+     * Load configuration from file
+     */
+    load(): Promise<MetalinkConfig>;
+    /**
+     * Load config synchronously
+     */
+    loadSync(): MetalinkConfig;
+    /**
+     * Load base_servers from mcp-registry.json and merge into config
+     * v1.3.59: Registry is source of truth for base_servers
+     */
+    private loadBaseServersFromRegistry;
+    /**
+     * Interpolate environment variables in config
+     * Supports ${VAR_NAME} and ${secret:KEY} syntax
+     */
+    private interpolateEnv;
+    /**
+     * Get specific server configuration by name
+     */
+    getServer(name: string): ServerConfig | undefined;
+    /**
+     * Get daemon configuration
+     */
+    getDaemon(): DaemonConfig;
+    /**
+     * Get all available servers (including those not currently exposed)
+     */
+    getAllServers(): ServerConfig[];
+    /**
+     * Get all servers from registry
+     * v1.3.58: Removed expose_servers/disable_servers filtering - all servers in registry are available
+     * Use base_servers config to control which servers auto-start on daemon init
+     */
+    getServers(): ServerConfig[];
+    /**
+     * Get configuration by profile name
+     */
+    getProfile(profileName: string): {
+        name: string;
+        servers: ({
+            name: string;
+            transport: "stdio";
+            command: string;
+            args: string[];
+            env: Record<string, string>;
+            healthCheck: {
+                enabled: boolean;
+                interval: number;
+                timeout: number;
+            };
+            cwd?: string | undefined;
+            safety?: "safe" | "risky" | "default" | undefined;
+        } | {
+            name: string;
+            transport: "http" | "sse" | "sse-first" | "http-stream";
+            env: Record<string, string>;
+            healthCheck: {
+                enabled: boolean;
+                interval: number;
+                timeout: number;
+            };
+            url: string;
+            requestTimeoutMs: number;
+            streamTimeoutMs: number;
+            connectTimeoutMs: number;
+            safety?: "safe" | "risky" | "default" | undefined;
+            auth?: {
+                type: "bearer" | "oauth2" | "api-key";
+                headerName: string;
+                token?: string | undefined;
+                clientId?: string | undefined;
+                clientSecret?: string | undefined;
+            } | undefined;
+            session?: {
+                enabled: boolean;
+                headerName: string;
+                allowClientTermination: boolean;
+            } | undefined;
+            cors?: {
+                enabled: boolean;
+                allowOrigin: string;
+            } | undefined;
+        })[];
+        environment: Record<string, string>;
+        description?: string | undefined;
+        daemon?: {
+            auth: {
+                enabled: boolean;
+                type: "bearer" | "api-key";
+                secret?: string | undefined;
+            };
+            port: number;
+            host: string;
+            logLevel: "debug" | "info" | "warn" | "error";
+            rateLimit: {
+                enabled: boolean;
+                windowMs: number;
+                max: number;
+                keyGenerator: "ip" | "user";
+            };
+        } | undefined;
+    } | undefined;
+    /**
+     * Set current config (useful for testing)
+     */
+    setConfig(config: MetalinkConfig): void;
+    /**
+     * Get currently loaded config
+     */
+    getConfig(): MetalinkConfig;
+    /**
+     * Get base servers (read from config, never hardcoded)
+     * These servers are directly exposed in tools/list and auto-started on daemon init
+     */
+    getBaseServers(): string[];
+    /**
+     * Get tool safety classification rules
+     * Used to determine if a tool requires execute_tool (safe) or execute_tool_confirm (risky)
+     * Reads from mcp-registry.json tool_safety section (NOT from config file)
+     */
+    getToolSafetyRules(): any;
+    /**
+     * Set tool safety rules in registry with atomic write and backup
+     * Phase 1: Core persistence method
+     */
+    setToolSafetyRules(rules: {
+        safePatterns?: string[];
+        riskyPatterns?: string[];
+        safeToolOverrides?: string[];
+        riskyToolOverrides?: string[];
+        argumentInspectionRules?: Array<{
+            tool: string;
+            argumentField: string;
+            whitelistMode?: boolean;
+            optionalField?: boolean;
+            safeCommandPatterns?: string[];
+            riskyCommandPatterns?: string[];
+        }>;
+    }): Promise<void>;
+    /**
+     * Add a safe tool override
+     */
+    addSafeToolOverride(tool: string): Promise<void>;
+    /**
+     * Remove a safe tool override
+     */
+    removeSafeToolOverride(tool: string): Promise<void>;
+    /**
+     * Add a risky tool override
+     */
+    addRiskyToolOverride(tool: string): Promise<void>;
+    /**
+     * Remove a risky tool override
+     */
+    removeRiskyToolOverride(tool: string): Promise<void>;
+    /**
+     * Add a safe pattern
+     */
+    addSafePattern(pattern: string): Promise<void>;
+    /**
+     * Remove a safe pattern
+     */
+    removeSafePattern(pattern: string): Promise<void>;
+    /**
+     * Add a risky pattern
+     */
+    addRiskyPattern(pattern: string): Promise<void>;
+    /**
+     * Remove a risky pattern
+     */
+    removeRiskyPattern(pattern: string): Promise<void>;
+    /**
+     * Reset safety rules to defaults
+     */
+    resetToDefaults(): Promise<void>;
+    /**
+     * Validate tool format (server:tool or server:*)
+     */
+    private validateToolFormat;
+    /**
+     * Validate regex pattern (try to compile it)
+     */
+    private validateRegexPattern;
+    /**
+     * Reload configuration
+     */
+    reload(): Promise<MetalinkConfig>;
+    /**
+     * Invalidate config cache and reload
+     * Used after registry changes to ensure fresh config
+     */
+    invalidateCache(): void;
+    /**
+     * Get the persistent registry file path
+     * Defaults to ~/.config/metalink/mcp-registry.json
+     * Respects METALINK_CONFIG_DIR environment variable if set
+     */
+    private getRegistryPath;
+    /**
+     * Migrate registry from old location (current dir) to persistent location if needed
+     * This is called on first run to preserve user-added servers
+     */
+    private migrateRegistry;
+    /**
+     * Save a new server to the registry file
+     * Automatically invalidates config cache to force reload
+     */
+    saveServerToRegistry(config: ServerConfig, options?: {
+        allowAnyCommand?: boolean;
+        timeout?: number;
+    }): Promise<ServerConfig>;
+    /**
+     * Remove a server from the registry file
+     * Automatically invalidates config cache to force reload
+     */
+    removeServerFromRegistry(name: string, options?: {
+        timeout?: number;
+    }): Promise<void>;
+    /**
+     * Create config from object (useful for testing)
+     */
+    static fromObject(obj: MetalinkConfig): ConfigLoader;
+    /**
+     * Create and load config from file path
+     */
+    static loadFrom(filePath: string): Promise<ConfigLoader>;
+    /**
+     * Create and load config from file path synchronously
+     */
+    static loadFromSync(filePath: string): ConfigLoader;
+    /**
+     * Load from environment variables (fallback mechanism)
+     * Uses METALINK_* prefixed env vars
+     */
+    static fromEnv(): MetalinkConfig;
+}
+/**
+ * Initialize global config
+ */
+export declare function initializeConfig(configPath?: string): Promise<MetalinkConfig>;
+/**
+ * Initialize config synchronously
+ */
+export declare function initializeConfigSync(configPath?: string): MetalinkConfig;
+/**
+ * Get global config instance
+ */
+export declare function getConfigLoader(): ConfigLoader;
+/**
+ * Get global config
+ */
+export declare function getConfig(): MetalinkConfig;
+//# sourceMappingURL=loader.d.ts.map

package/packages/core/dist/config/loader.d.ts.map

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