@pasko70/pibo 1.9.7 → 1.9.9

package/dist/mcp/config.js

@@ -1,473 +0,0 @@
-/**
- * MCP-CLI Configuration Types and Loader
- */
-import { createHash } from 'node:crypto';
-import { existsSync } from 'node:fs';
-import { mkdir, readFile, writeFile } from 'node:fs/promises';
-import { homedir } from 'node:os';
-import { dirname, join, resolve } from 'node:path';
-import { ErrorCode, configInvalidJsonError, configMissingFieldError, configNotFoundError, configSearchError, formatCliError, serverNotFoundError, } from './errors.js';
-export const DEFAULT_MCP_CONFIG_FILE = 'mcp_servers.json';
-// ============================================================================
-// Tool Filtering
-// ============================================================================
-/**
- * Simple glob pattern matcher for tool names
- * Supports * (any characters) and ? (single character)
- */
-function matchesPattern(name, pattern) {
-    // Convert glob pattern to regex
-    const regexPattern = pattern
-        .replace(/[.+^${}()|[\]\\]/g, '\\$&') // Escape special regex chars
-        .replace(/\*/g, '.*') // * matches any characters
-        .replace(/\?/g, '.'); // ? matches single character
-    return new RegExp(`^${regexPattern}$`, 'i').test(name);
-}
-/**
- * Check if a tool name matches any of the given patterns
- */
-function matchesAnyPattern(name, patterns) {
-    return patterns.some((pattern) => matchesPattern(name, pattern));
-}
-/**
- * Filter tools based on allowedTools and disabledTools configuration
- *
- * Rules:
- * - If allowedTools is specified, only tools matching those patterns are available
- * - If disabledTools is specified, tools matching those patterns are excluded
- * - disabledTools takes precedence over allowedTools
- *
- * @param tools - Array of tools with name property
- * @param config - Server config with optional allowedTools/disabledTools
- * @returns Filtered array of tools
- */
-export function filterTools(tools, config) {
-    const { allowedTools, disabledTools } = config;
-    return tools.filter((tool) => {
-        // First check if tool is in disabledTools (takes precedence)
-        if (disabledTools && disabledTools.length > 0) {
-            if (matchesAnyPattern(tool.name, disabledTools)) {
-                return false;
-            }
-        }
-        // Then check if allowedTools is specified
-        if (allowedTools && allowedTools.length > 0) {
-            return matchesAnyPattern(tool.name, allowedTools);
-        }
-        // No filtering specified, allow all
-        return true;
-    });
-}
-/**
- * Check if a specific tool is allowed by the config
- *
- * @param toolName - Name of the tool to check
- * @param config - Server config with optional allowedTools/disabledTools
- * @returns true if tool is allowed, false otherwise
- */
-export function isToolAllowed(toolName, config) {
-    const { allowedTools, disabledTools } = config;
-    // First check if tool is in disabledTools (takes precedence)
-    if (disabledTools && disabledTools.length > 0) {
-        if (matchesAnyPattern(toolName, disabledTools)) {
-            return false;
-        }
-    }
-    // Then check if allowedTools is specified
-    if (allowedTools && allowedTools.length > 0) {
-        return matchesAnyPattern(toolName, allowedTools);
-    }
-    // No filtering specified, allow all
-    return true;
-}
-/**
- * Check if a server config is HTTP-based
- */
-export function isHttpServer(config) {
-    return 'url' in config;
-}
-/**
- * Check if a server config is stdio-based
- */
-export function isStdioServer(config) {
-    return 'command' in config;
-}
-// ============================================================================
-// Environment Variables & Runtime Configuration
-// ============================================================================
-/**
- * Default configuration values - centralized to avoid inline magic numbers
- */
-export const DEFAULT_TIMEOUT_SECONDS = 1800; // 30 minutes
-export const DEFAULT_TIMEOUT_MS = DEFAULT_TIMEOUT_SECONDS * 1000;
-export const DEFAULT_CONCURRENCY = 5;
-export const DEFAULT_MAX_RETRIES = 3;
-export const DEFAULT_RETRY_DELAY_MS = 1000; // 1 second base delay
-export const DEFAULT_DAEMON_TIMEOUT_SECONDS = 60; // 60 seconds idle timeout
-export const DEFAULT_DAEMON_REQUEST_TIMEOUT_SECONDS = 60;
-/**
- * Debug logging utility - only logs when MCP_DEBUG is set
- */
-export function debug(message) {
-    if (process.env.MCP_DEBUG) {
-        console.error(`[pibo mcp] ${message}`);
-    }
-}
-/**
- * Get configured timeout in milliseconds
- * @env MCP_TIMEOUT - timeout in seconds (default: 1800 = 30 minutes)
- */
-export function getTimeoutMs() {
-    const envTimeout = process.env.MCP_TIMEOUT;
-    if (envTimeout) {
-        const seconds = Number.parseInt(envTimeout, 10);
-        if (!Number.isNaN(seconds) && seconds > 0) {
-            return seconds * 1000;
-        }
-    }
-    return DEFAULT_TIMEOUT_MS;
-}
-/**
- * Get concurrency limit for parallel server connections
- * @env MCP_CONCURRENCY - max parallel connections (default: 5)
- */
-export function getConcurrencyLimit() {
-    const envConcurrency = process.env.MCP_CONCURRENCY;
-    if (envConcurrency) {
-        const limit = Number.parseInt(envConcurrency, 10);
-        if (!Number.isNaN(limit) && limit > 0) {
-            return limit;
-        }
-    }
-    return DEFAULT_CONCURRENCY;
-}
-/**
- * Get max retry attempts for transient failures
- * @env MCP_MAX_RETRIES - max retry attempts (default: 3, use 0 to disable retries)
- */
-export function getMaxRetries() {
-    const envRetries = process.env.MCP_MAX_RETRIES;
-    if (envRetries) {
-        const retries = Number.parseInt(envRetries, 10);
-        if (!Number.isNaN(retries) && retries >= 0) {
-            return retries;
-        }
-    }
-    return DEFAULT_MAX_RETRIES;
-}
-/**
- * Get base delay for retry backoff in milliseconds
- * @env MCP_RETRY_DELAY - base delay in milliseconds (default: 1000)
- */
-export function getRetryDelayMs() {
-    const envDelay = process.env.MCP_RETRY_DELAY;
-    if (envDelay) {
-        const delay = Number.parseInt(envDelay, 10);
-        if (!Number.isNaN(delay) && delay > 0) {
-            return delay;
-        }
-    }
-    return DEFAULT_RETRY_DELAY_MS;
-}
-// ============================================================================
-// Daemon Configuration
-// ============================================================================
-/**
- * Check if daemon mode is enabled
- * @env MCP_NO_DAEMON - set to "1" to disable daemon, force fresh connections
- */
-export function isDaemonEnabled() {
-    return process.env.MCP_NO_DAEMON !== '1';
-}
-/**
- * Get daemon idle timeout in milliseconds
- * @env MCP_DAEMON_TIMEOUT - timeout in seconds (default: 60)
- */
-export function getDaemonTimeoutMs() {
-    const envTimeout = process.env.MCP_DAEMON_TIMEOUT;
-    if (envTimeout) {
-        const seconds = Number.parseInt(envTimeout, 10);
-        if (!Number.isNaN(seconds) && seconds > 0) {
-            return seconds * 1000;
-        }
-    }
-    return DEFAULT_DAEMON_TIMEOUT_SECONDS * 1000;
-}
-/**
- * Get daemon request timeout in milliseconds
- * @env MCP_DAEMON_REQUEST_TIMEOUT - timeout in seconds (default: 60)
- */
-export function getDaemonRequestTimeoutMs() {
-    const envTimeout = process.env.MCP_DAEMON_REQUEST_TIMEOUT;
-    if (envTimeout) {
-        const seconds = Number.parseInt(envTimeout, 10);
-        if (!Number.isNaN(seconds) && seconds > 0) {
-            return seconds * 1000;
-        }
-    }
-    return DEFAULT_DAEMON_REQUEST_TIMEOUT_SECONDS * 1000;
-}
-/**
- * Get the socket directory for daemon connections
- * Uses platform-appropriate temp directory
- */
-export function getSocketDir() {
-    const uid = process.getuid?.() ?? 'unknown';
-    // macOS uses /var/folders which is auto-cleaned, Linux uses /tmp
-    const base = process.platform === 'darwin' ? '/tmp' : '/tmp';
-    return join(base, `mcp-cli-${uid}`);
-}
-/**
- * Get socket path for a specific server
- */
-export function getSocketPath(serverName) {
-    return join(getSocketDir(), `${serverName}.sock`);
-}
-/**
- * Get PID file path for a specific server daemon
- */
-export function getPidPath(serverName) {
-    return join(getSocketDir(), `${serverName}.pid`);
-}
-/**
- * Generate a hash of server config for stale detection
- * Returns consistent hash for identical configs
- */
-export function getConfigHash(config) {
-    const str = JSON.stringify(config, Object.keys(config).sort());
-    return createHash('sha256').update(str).digest('hex').slice(0, 16);
-}
-/**
- * Check if strict environment variable mode is enabled
- * @env MCP_STRICT_ENV - set to "false" to warn instead of error (default: true)
- */
-function isStrictEnvMode() {
-    const value = process.env.MCP_STRICT_ENV?.toLowerCase();
-    return value !== 'false' && value !== '0';
-}
-/**
- * Substitute environment variables in a string
- * Supports ${VAR_NAME} syntax
- *
- * By default (strict mode), throws an error when referenced env var is not set.
- * Set MCP_STRICT_ENV=false to warn instead of error.
- */
-function substituteEnvVars(value) {
-    const missingVars = [];
-    const result = value.replace(/\$\{([^}]+)\}/g, (match, varName) => {
-        const envValue = process.env[varName];
-        if (envValue === undefined) {
-            missingVars.push(varName);
-            return '';
-        }
-        return envValue;
-    });
-    if (missingVars.length > 0) {
-        const varList = missingVars.map((v) => `\${${v}}`).join(', ');
-        const message = `Missing environment variable${missingVars.length > 1 ? 's' : ''}: ${varList}`;
-        if (isStrictEnvMode()) {
-            throw new Error(formatCliError({
-                code: ErrorCode.CLIENT_ERROR,
-                type: 'MISSING_ENV_VAR',
-                message: message,
-                details: 'Referenced in config but not set in environment',
-                suggestion: `Set the variable(s) before running: export ${missingVars[0]}="value" or set MCP_STRICT_ENV=false to use empty values`,
-            }));
-        }
-        // Non-strict mode: warn but continue
-        console.error(`[pibo mcp] Warning: ${message}`);
-    }
-    return result;
-}
-/**
- * Recursively substitute environment variables in an object
- */
-function substituteEnvVarsInObject(obj) {
-    if (typeof obj === 'string') {
-        return substituteEnvVars(obj);
-    }
-    if (Array.isArray(obj)) {
-        return obj.map(substituteEnvVarsInObject);
-    }
-    if (obj && typeof obj === 'object') {
-        const result = {};
-        for (const [key, value] of Object.entries(obj)) {
-            result[key] = substituteEnvVarsInObject(value);
-        }
-        return result;
-    }
-    return obj;
-}
-/**
- * Get default config search paths
- */
-export function getDefaultConfigPaths() {
-    const paths = [];
-    const home = homedir();
-    // Current directory
-    paths.push(resolve(DEFAULT_MCP_CONFIG_FILE));
-    // Home directory variants
-    paths.push(join(home, '.mcp_servers.json'));
-    paths.push(join(home, '.config', 'mcp', 'mcp_servers.json'));
-    return paths;
-}
-export function getConfigSearchPaths(explicitPath) {
-    const paths = [];
-    if (explicitPath) {
-        paths.push(resolve(explicitPath));
-    }
-    if (process.env.MCP_CONFIG_PATH) {
-        paths.push(resolve(process.env.MCP_CONFIG_PATH));
-    }
-    paths.push(...getDefaultConfigPaths());
-    return [...new Set(paths)];
-}
-export function getPreferredConfigPath(explicitPath) {
-    if (explicitPath) {
-        return resolve(explicitPath);
-    }
-    if (process.env.MCP_CONFIG_PATH) {
-        return resolve(process.env.MCP_CONFIG_PATH);
-    }
-    return resolve(DEFAULT_MCP_CONFIG_FILE);
-}
-export function findConfigPath(explicitPath) {
-    if (explicitPath) {
-        const resolvedPath = resolve(explicitPath);
-        return existsSync(resolvedPath) ? resolvedPath : undefined;
-    }
-    if (process.env.MCP_CONFIG_PATH) {
-        const resolvedPath = resolve(process.env.MCP_CONFIG_PATH);
-        return existsSync(resolvedPath) ? resolvedPath : undefined;
-    }
-    return getDefaultConfigPaths().find((path) => existsSync(path));
-}
-export async function ensureConfigExists(explicitPath) {
-    const existingPath = findConfigPath(explicitPath);
-    if (existingPath) {
-        return existingPath;
-    }
-    const configPath = getPreferredConfigPath(explicitPath);
-    await mkdir(dirname(configPath), { recursive: true });
-    await writeFile(configPath, `${JSON.stringify({ mcpServers: {} }, null, 2)}\n`);
-    return configPath;
-}
-async function readRawConfig(configPath) {
-    const content = await readFile(configPath, 'utf-8');
-    let config;
-    try {
-        config = JSON.parse(content);
-    }
-    catch (e) {
-        throw new Error(formatCliError(configInvalidJsonError(configPath, e.message)));
-    }
-    if (!config.mcpServers || typeof config.mcpServers !== 'object') {
-        throw new Error(formatCliError(configMissingFieldError(configPath)));
-    }
-    return config;
-}
-function validateServerConfig(serverName, serverConfig) {
-    if (!serverConfig || typeof serverConfig !== 'object') {
-        throw new Error(formatCliError({
-            code: ErrorCode.CLIENT_ERROR,
-            type: 'CONFIG_INVALID_SERVER',
-            message: `Invalid server configuration for "${serverName}"`,
-            details: 'Server config must be an object',
-            suggestion: `Use { "command": "..." } for stdio or { "url": "..." } for HTTP`,
-        }));
-    }
-    const hasCommand = 'command' in serverConfig;
-    const hasUrl = 'url' in serverConfig;
-    if (!hasCommand && !hasUrl) {
-        throw new Error(formatCliError({
-            code: ErrorCode.CLIENT_ERROR,
-            type: 'CONFIG_INVALID_SERVER',
-            message: `Server "${serverName}" missing required field`,
-            details: `Must have either "command" (for stdio) or "url" (for HTTP)`,
-            suggestion: `Add "command": "npx ..." for local servers or "url": "https://..." for remote servers`,
-        }));
-    }
-    if (hasCommand && hasUrl) {
-        throw new Error(formatCliError({
-            code: ErrorCode.CLIENT_ERROR,
-            type: 'CONFIG_INVALID_SERVER',
-            message: `Server "${serverName}" has both "command" and "url"`,
-            details: 'A server must be either stdio (command) or HTTP (url), not both',
-            suggestion: `Remove one of "command" or "url"`,
-        }));
-    }
-}
-/**
- * Load and merge MCP servers configuration.
- * More specific paths appear first and win server-name conflicts.
- */
-export async function loadConfig(explicitPath) {
-    const explicitOrEnvPath = explicitPath
-        ? resolve(explicitPath)
-        : process.env.MCP_CONFIG_PATH
-            ? resolve(process.env.MCP_CONFIG_PATH)
-            : undefined;
-    if (explicitOrEnvPath && !existsSync(explicitOrEnvPath)) {
-        throw new Error(formatCliError(configNotFoundError(explicitOrEnvPath)));
-    }
-    const existingPaths = getConfigSearchPaths(explicitPath).filter((path) => existsSync(path));
-    if (existingPaths.length === 0) {
-        throw new Error(formatCliError(configSearchError()));
-    }
-    const merged = { mcpServers: {} };
-    for (const configPath of existingPaths) {
-        const config = await readRawConfig(configPath);
-        for (const [serverName, serverConfig] of Object.entries(config.mcpServers)) {
-            if (!(serverName in merged.mcpServers)) {
-                merged.mcpServers[serverName] = serverConfig;
-            }
-        }
-    }
-    for (const [serverName, serverConfig] of Object.entries(merged.mcpServers)) {
-        validateServerConfig(serverName, serverConfig);
-    }
-    return substituteEnvVarsInObject(merged);
-}
-export async function getConfigSourceSummaries(explicitPath) {
-    const summaries = [];
-    for (const configPath of getConfigSearchPaths(explicitPath)) {
-        if (!existsSync(configPath)) {
-            summaries.push({ path: configPath, exists: false, servers: [] });
-            continue;
-        }
-        const config = await readRawConfig(configPath);
-        summaries.push({
-            path: configPath,
-            exists: true,
-            servers: Object.keys(config.mcpServers),
-        });
-    }
-    return summaries;
-}
-export function formatConfigSourceSummaries(summaries) {
-    return summaries
-        .map((summary) => {
-        const serverList = summary.exists
-            ? summary.servers.join(', ') || '(none)'
-            : '(not found)';
-        return `  - ${summary.path}: ${serverList}`;
-    })
-        .join('\n');
-}
-/**
- * Get a specific server config by name
- */
-export function getServerConfig(config, serverName) {
-    const server = config.mcpServers[serverName];
-    if (!server) {
-        const available = Object.keys(config.mcpServers);
-        throw new Error(formatCliError(serverNotFoundError(serverName, available)));
-    }
-    return server;
-}
-/**
- * List all server names
- */
-export function listServerNames(config) {
-    return Object.keys(config.mcpServers);
-}