@jablum/weather-mcp 1.7.0

package/dist/config/cache.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Cache configuration for weather data
+ *
+ * TTL (Time To Live) values are set based on data volatility:
+ * - Historical data: Never changes once recorded
+ * - Geographic data: Static (grid coordinates, station locations)
+ * - Forecasts: Updated approximately hourly
+ * - Current conditions: Observations typically update every 20-60 minutes
+ */
+export declare const CacheConfig: {
+    readonly enabled: boolean;
+    readonly maxSize: number;
+    readonly apiTimeoutMs: number;
+    readonly ttl: {
+        readonly gridCoordinates: number;
+        readonly stations: number;
+        readonly forecast: number;
+        readonly currentConditions: number;
+        readonly alerts: number;
+        readonly recentHistorical: number;
+        readonly historicalData: number;
+        readonly serviceStatus: number;
+    };
+};
+/**
+ * Determine appropriate TTL for historical weather data based on date
+ * @param startDate Start date of the historical query
+ * @returns TTL in milliseconds
+ */
+export declare function getHistoricalDataTTL(startDate: string | Date): number;
+//# sourceMappingURL=cache.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/config/cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAkDH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;CA8Cd,CAAC;AAEX;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAYrE"}

package/dist/config/cache.js

@@ -0,0 +1,108 @@
+/**
+ * Cache configuration for weather data
+ *
+ * TTL (Time To Live) values are set based on data volatility:
+ * - Historical data: Never changes once recorded
+ * - Geographic data: Static (grid coordinates, station locations)
+ * - Forecasts: Updated approximately hourly
+ * - Current conditions: Observations typically update every 20-60 minutes
+ */
+// Time constants in milliseconds
+const MINUTE = 60 * 1000;
+const HOUR = 60 * MINUTE;
+const DAY = 24 * HOUR;
+/**
+ * Parse a boolean environment variable
+ * @param key Environment variable key
+ * @param defaultValue Default value if not set
+ * @returns Boolean value
+ */
+function getEnvBoolean(key, defaultValue) {
+    const value = process.env[key];
+    if (value === undefined)
+        return defaultValue;
+    return value !== 'false' && value !== '0';
+}
+/**
+ * Parse a number environment variable with validation
+ * @param key Environment variable key
+ * @param defaultValue Default value if not set or invalid
+ * @param min Minimum allowed value (optional)
+ * @param max Maximum allowed value (optional)
+ * @returns Validated number value
+ */
+function getEnvNumber(key, defaultValue, min, max) {
+    const value = process.env[key];
+    if (value === undefined)
+        return defaultValue;
+    const parsed = parseInt(value, 10);
+    if (isNaN(parsed)) {
+        console.warn(`Invalid ${key}: "${value}". Using default: ${defaultValue}`);
+        return defaultValue;
+    }
+    if (min !== undefined && parsed < min) {
+        console.warn(`${key} too low: ${parsed}. Using minimum: ${min}`);
+        return min;
+    }
+    if (max !== undefined && parsed > max) {
+        console.warn(`${key} too high: ${parsed}. Using maximum: ${max}`);
+        return max;
+    }
+    return parsed;
+}
+export const CacheConfig = {
+    // Enable/disable caching globally
+    enabled: getEnvBoolean('CACHE_ENABLED', true),
+    // Maximum number of entries in cache before LRU eviction
+    // Min: 100, Max: 10000, Default: 1000
+    maxSize: getEnvNumber('CACHE_MAX_SIZE', 1000, 100, 10000),
+    // API timeout configuration
+    // Min: 5000ms (5 seconds), Max: 120000ms (2 minutes), Default: 30000ms (30 seconds)
+    apiTimeoutMs: getEnvNumber('API_TIMEOUT_MS', 30000, 5000, 120000),
+    // TTL values for different data types
+    ttl: {
+        // Grid coordinate lookups (lat/lon -> grid mapping)
+        // These are geographic and never change
+        gridCoordinates: Infinity,
+        // Weather station lists
+        // Stations rarely change
+        stations: 24 * HOUR,
+        // 7-day forecasts
+        // NOAA updates forecasts approximately hourly
+        forecast: 2 * HOUR,
+        // Current weather conditions
+        // Observations typically update every 20-60 minutes
+        currentConditions: 15 * MINUTE,
+        // Weather alerts
+        // Alerts can change rapidly, cache for shorter period
+        alerts: 5 * MINUTE,
+        // Recent historical data (< 7 days old)
+        // Recent data may still be updated/corrected
+        recentHistorical: 1 * HOUR,
+        // Historical data (> 1 day old from current time)
+        // Historical data beyond 1 day is finalized and won't change
+        historicalData: Infinity,
+        // Service health check status
+        // Check freshness periodically
+        serviceStatus: 5 * MINUTE,
+    },
+};
+/**
+ * Determine appropriate TTL for historical weather data based on date
+ * @param startDate Start date of the historical query
+ * @returns TTL in milliseconds
+ */
+export function getHistoricalDataTTL(startDate) {
+    const start = typeof startDate === 'string' ? new Date(startDate) : startDate;
+    const now = new Date();
+    const daysDiff = (now.getTime() - start.getTime()) / DAY;
+    if (daysDiff > 1) {
+        // Data is more than 1 day old - it's finalized and won't change
+        return CacheConfig.ttl.historicalData;
+    }
+    else {
+        // Recent data may still be updated
+        return CacheConfig.ttl.recentHistorical;
+    }
+}
+//# sourceMappingURL=cache.js.map

package/dist/config/cache.js.map

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

package/dist/config/displayThresholds.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Display thresholds and constants for weather data formatting
+ *
+ * These values determine when certain weather metrics are shown or highlighted
+ */
+export declare const DisplayThresholds: {
+    /**
+     * Temperature thresholds (in Fahrenheit)
+     */
+    readonly temperature: {
+        /** Show heat index when temperature is above this value */
+        readonly showHeatIndex: 80;
+        /** Show wind chill when temperature is below this value */
+        readonly showWindChill: 50;
+    };
+    /**
+     * Wind thresholds
+     */
+    readonly wind: {
+        /** Show gusts if they are this ratio higher than sustained wind speed (1.2 = 20% higher) */
+        readonly gustSignificanceRatio: 1.2;
+    };
+    /**
+     * Visibility thresholds (in miles)
+     */
+    readonly visibility: {
+        /** Dense fog */
+        readonly denseFog: 0.25;
+        /** Fog */
+        readonly fog: 1;
+        /** Haze or mist */
+        readonly hazeMist: 3;
+        /** Clear visibility */
+        readonly clear: 10;
+    };
+    /**
+     * Precipitation thresholds
+     */
+    readonly precipitation: {
+        /** Light precipitation (inches per hour) */
+        readonly light: 0.1;
+        /** Moderate precipitation (inches per hour) */
+        readonly moderate: 0.3;
+        /** Heavy precipitation (inches per hour) */
+        readonly heavy: 0.5;
+    };
+};
+/**
+ * API-related constants
+ */
+export declare const ApiConstants: {
+    /**
+     * Historical data threshold (in days)
+     * Data older than this uses archival API instead of recent observations
+     */
+    readonly historicalDataThresholdDays: 7;
+    /**
+     * Maximum date range for hourly historical data (in days)
+     */
+    readonly maxHourlyHistoricalDays: 31;
+};
+/**
+ * Formatting constants
+ */
+export declare const FormatConstants: {
+    /**
+     * Default forecast periods to show
+     */
+    readonly defaultForecastDays: 7;
+    /**
+     * Maximum forecast days (Open-Meteo supports up to 16 days)
+     */
+    readonly maxForecastDays: 16;
+    /**
+     * Default observation limit for historical data
+     */
+    readonly defaultHistoricalLimit: 168;
+    /**
+     * Maximum observations to return
+     */
+    readonly maxHistoricalLimit: 500;
+};
+//# sourceMappingURL=displayThresholds.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"displayThresholds.d.ts","sourceRoot":"","sources":["../../src/config/displayThresholds.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,eAAO,MAAM,iBAAiB;IAC5B;;OAEG;;QAED,2DAA2D;;QAE3D,2DAA2D;;;IAI7D;;OAEG;;QAED,4FAA4F;;;IAI9F;;OAEG;;QAED,gBAAgB;;QAEhB,UAAU;;QAEV,mBAAmB;;QAEnB,uBAAuB;;;IAIzB;;OAEG;;QAED,4CAA4C;;QAE5C,+CAA+C;;QAE/C,4CAA4C;;;CAGtC,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,YAAY;IACvB;;;OAGG;;IAGH;;OAEG;;CAEK,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,eAAe;IAC1B;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;CAEK,CAAC"}

package/dist/config/displayThresholds.js

@@ -0,0 +1,83 @@
+/**
+ * Display thresholds and constants for weather data formatting
+ *
+ * These values determine when certain weather metrics are shown or highlighted
+ */
+export const DisplayThresholds = {
+    /**
+     * Temperature thresholds (in Fahrenheit)
+     */
+    temperature: {
+        /** Show heat index when temperature is above this value */
+        showHeatIndex: 80,
+        /** Show wind chill when temperature is below this value */
+        showWindChill: 50,
+    },
+    /**
+     * Wind thresholds
+     */
+    wind: {
+        /** Show gusts if they are this ratio higher than sustained wind speed (1.2 = 20% higher) */
+        gustSignificanceRatio: 1.2,
+    },
+    /**
+     * Visibility thresholds (in miles)
+     */
+    visibility: {
+        /** Dense fog */
+        denseFog: 0.25,
+        /** Fog */
+        fog: 1.0,
+        /** Haze or mist */
+        hazeMist: 3.0,
+        /** Clear visibility */
+        clear: 10.0,
+    },
+    /**
+     * Precipitation thresholds
+     */
+    precipitation: {
+        /** Light precipitation (inches per hour) */
+        light: 0.1,
+        /** Moderate precipitation (inches per hour) */
+        moderate: 0.3,
+        /** Heavy precipitation (inches per hour) */
+        heavy: 0.5,
+    },
+};
+/**
+ * API-related constants
+ */
+export const ApiConstants = {
+    /**
+     * Historical data threshold (in days)
+     * Data older than this uses archival API instead of recent observations
+     */
+    historicalDataThresholdDays: 7,
+    /**
+     * Maximum date range for hourly historical data (in days)
+     */
+    maxHourlyHistoricalDays: 31,
+};
+/**
+ * Formatting constants
+ */
+export const FormatConstants = {
+    /**
+     * Default forecast periods to show
+     */
+    defaultForecastDays: 7,
+    /**
+     * Maximum forecast days (Open-Meteo supports up to 16 days)
+     */
+    maxForecastDays: 16,
+    /**
+     * Default observation limit for historical data
+     */
+    defaultHistoricalLimit: 168, // One week of hourly data
+    /**
+     * Maximum observations to return
+     */
+    maxHistoricalLimit: 500,
+};
+//# sourceMappingURL=displayThresholds.js.map

package/dist/config/displayThresholds.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"displayThresholds.js","sourceRoot":"","sources":["../../src/config/displayThresholds.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B;;OAEG;IACH,WAAW,EAAE;QACX,2DAA2D;QAC3D,aAAa,EAAE,EAAE;QACjB,2DAA2D;QAC3D,aAAa,EAAE,EAAE;KAClB;IAED;;OAEG;IACH,IAAI,EAAE;QACJ,4FAA4F;QAC5F,qBAAqB,EAAE,GAAG;KAC3B;IAED;;OAEG;IACH,UAAU,EAAE;QACV,gBAAgB;QAChB,QAAQ,EAAE,IAAI;QACd,UAAU;QACV,GAAG,EAAE,GAAG;QACR,mBAAmB;QACnB,QAAQ,EAAE,GAAG;QACb,uBAAuB;QACvB,KAAK,EAAE,IAAI;KACZ;IAED;;OAEG;IACH,aAAa,EAAE;QACb,4CAA4C;QAC5C,KAAK,EAAE,GAAG;QACV,+CAA+C;QAC/C,QAAQ,EAAE,GAAG;QACb,4CAA4C;QAC5C,KAAK,EAAE,GAAG;KACX;CACO,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B;;;OAGG;IACH,2BAA2B,EAAE,CAAC;IAE9B;;OAEG;IACH,uBAAuB,EAAE,EAAE;CACnB,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B;;OAEG;IACH,mBAAmB,EAAE,CAAC;IAEtB;;OAEG;IACH,eAAe,EAAE,EAAE;IAEnB;;OAEG;IACH,sBAAsB,EAAE,GAAG,EAAE,0BAA0B;IAEvD;;OAEG;IACH,kBAAkB,EAAE,GAAG;CACf,CAAC"}

package/dist/config/tools.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Tool configuration for Weather MCP Server
+ *
+ * Supports both presets and individual tool control for flexible configuration.
+ *
+ * Usage examples:
+ * - ENABLED_TOOLS=basic                    # Only basic weather tools
+ * - ENABLED_TOOLS=full                     # All tools except experimental
+ * - ENABLED_TOOLS=basic,+air_quality       # Basic tools + air quality
+ * - ENABLED_TOOLS=all,-marine              # All tools except marine
+ * - ENABLED_TOOLS=forecast,alerts,search  # Specific tools only
+ */
+/**
+ * Available tool names in the Weather MCP Server
+ */
+export type ToolName = 'get_forecast' | 'get_alerts' | 'get_historical_weather' | 'check_service_status' | 'search_location' | 'get_air_quality' | 'get_marine_conditions' | 'get_weather_imagery' | 'get_lightning_activity' | 'get_river_conditions' | 'get_wildfire_info' | 'save_location' | 'list_saved_locations' | 'get_saved_location' | 'remove_saved_location';
+/**
+ * Tool configuration singleton
+ */
+declare class ToolConfig {
+    private enabledTools;
+    constructor();
+    /**
+     * Check if a specific tool is enabled
+     */
+    isEnabled(tool: ToolName): boolean;
+    /**
+     * Get all enabled tools
+     */
+    getEnabledTools(): ToolName[];
+    /**
+     * Get available presets
+     */
+    static getPresets(): Record<string, ToolName[]>;
+    /**
+     * Get available tool aliases
+     */
+    static getAliases(): Record<string, ToolName>;
+}
+export declare const toolConfig: ToolConfig;
+export declare const PRESETS: Record<string, ToolName[]>;
+export declare const ALIASES: Record<string, ToolName>;
+export {};
+//# sourceMappingURL=tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/config/tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH;;GAEG;AACH,MAAM,MAAM,QAAQ,GAChB,cAAc,GACd,YAAY,GACZ,wBAAwB,GACxB,sBAAsB,GACtB,iBAAiB,GACjB,iBAAiB,GACjB,uBAAuB,GACvB,qBAAqB,GACrB,wBAAwB,GACxB,sBAAsB,GACtB,mBAAmB,GACnB,eAAe,GACf,sBAAsB,GACtB,oBAAoB,GACpB,uBAAuB,CAAC;AAiO5B;;GAEG;AACH,cAAM,UAAU;IACd,OAAO,CAAC,YAAY,CAAgB;;IAapC;;OAEG;IACH,SAAS,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO;IAIlC;;OAEG;IACH,eAAe,IAAI,QAAQ,EAAE;IAI7B;;OAEG;IACH,MAAM,CAAC,UAAU,IAAI,MAAM,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC;IAI/C;;OAEG;IACH,MAAM,CAAC,UAAU,IAAI,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC;CAG9C;AAGD,eAAO,MAAM,UAAU,YAAmB,CAAC;AAG3C,eAAO,MAAM,OAAO,4BAAe,CAAC;AACpC,eAAO,MAAM,OAAO,0BAAe,CAAC"}

package/dist/config/tools.js

@@ -0,0 +1,269 @@
+/**
+ * Tool configuration for Weather MCP Server
+ *
+ * Supports both presets and individual tool control for flexible configuration.
+ *
+ * Usage examples:
+ * - ENABLED_TOOLS=basic                    # Only basic weather tools
+ * - ENABLED_TOOLS=full                     # All tools except experimental
+ * - ENABLED_TOOLS=basic,+air_quality       # Basic tools + air quality
+ * - ENABLED_TOOLS=all,-marine              # All tools except marine
+ * - ENABLED_TOOLS=forecast,alerts,search  # Specific tools only
+ */
+/**
+ * Tool presets for easy configuration
+ */
+const TOOL_PRESETS = {
+    // Essential weather tools - minimal overhead
+    basic: [
+        'get_forecast',
+        'get_alerts',
+        'search_location',
+        'check_service_status',
+        'save_location',
+        'list_saved_locations',
+        'get_saved_location',
+        'remove_saved_location'
+    ],
+    // Basic + historical data
+    standard: [
+        'get_forecast',
+        'get_alerts',
+        'get_historical_weather',
+        'search_location',
+        'check_service_status',
+        'save_location',
+        'list_saved_locations',
+        'get_saved_location',
+        'remove_saved_location'
+    ],
+    // Standard + environmental data
+    full: [
+        'get_forecast',
+        'get_alerts',
+        'get_historical_weather',
+        'search_location',
+        'check_service_status',
+        'get_air_quality',
+        'save_location',
+        'list_saved_locations',
+        'get_saved_location',
+        'remove_saved_location'
+    ],
+    // All available tools
+    all: [
+        'get_forecast',
+        'get_alerts',
+        'get_historical_weather',
+        'check_service_status',
+        'search_location',
+        'get_air_quality',
+        'get_marine_conditions',
+        'get_weather_imagery',
+        'get_lightning_activity',
+        'get_river_conditions',
+        'get_wildfire_info',
+        'save_location',
+        'list_saved_locations',
+        'get_saved_location',
+        'remove_saved_location'
+    ]
+};
+/**
+ * Tool aliases for convenience (short names)
+ */
+const TOOL_ALIASES = {
+    'forecast': 'get_forecast',
+    'alerts': 'get_alerts',
+    'warnings': 'get_alerts',
+    'historical': 'get_historical_weather',
+    'history': 'get_historical_weather',
+    'status': 'check_service_status',
+    'location': 'search_location',
+    'search': 'search_location',
+    'air_quality': 'get_air_quality',
+    'aqi': 'get_air_quality',
+    'marine': 'get_marine_conditions',
+    'ocean': 'get_marine_conditions',
+    'waves': 'get_marine_conditions',
+    'imagery': 'get_weather_imagery',
+    'radar': 'get_weather_imagery',
+    'satellite': 'get_weather_imagery',
+    'lightning': 'get_lightning_activity',
+    'strikes': 'get_lightning_activity',
+    'thunderstorm': 'get_lightning_activity',
+    'river': 'get_river_conditions',
+    'rivers': 'get_river_conditions',
+    'flood': 'get_river_conditions',
+    'streamflow': 'get_river_conditions',
+    'wildfire': 'get_wildfire_info',
+    'wildfires': 'get_wildfire_info',
+    'fire': 'get_wildfire_info',
+    'fires': 'get_wildfire_info',
+    'smoke': 'get_wildfire_info'
+};
+/**
+ * Parse the ENABLED_TOOLS environment variable
+ *
+ * Supports:
+ * - Presets: "basic", "standard", "full", "all"
+ * - Individual tools: "forecast,current,alerts"
+ * - Adding to presets: "basic,+air_quality"
+ * - Removing from presets: "all,-marine"
+ * - Combinations: "standard,+air_quality,-alerts"
+ *
+ * @param envValue The ENABLED_TOOLS environment variable value
+ * @returns Set of enabled tool names
+ */
+function parseEnabledTools(envValue) {
+    // Default to "basic" preset if not specified
+    if (!envValue) {
+        return new Set(TOOL_PRESETS.basic);
+    }
+    const parts = envValue.toLowerCase().split(',').map(s => s.trim()).filter(Boolean);
+    let enabledTools = new Set();
+    let hasBaseSet = false;
+    for (const part of parts) {
+        // Handle additions (+tool)
+        if (part.startsWith('+')) {
+            const toolName = part.slice(1);
+            const resolvedTool = resolveToolName(toolName);
+            if (resolvedTool) {
+                enabledTools.add(resolvedTool);
+            }
+            else {
+                console.warn(`Unknown tool to add: "${toolName}"`);
+            }
+            continue;
+        }
+        // Handle removals (-tool)
+        if (part.startsWith('-')) {
+            const toolName = part.slice(1);
+            const resolvedTool = resolveToolName(toolName);
+            if (resolvedTool) {
+                enabledTools.delete(resolvedTool);
+            }
+            else {
+                console.warn(`Unknown tool to remove: "${toolName}"`);
+            }
+            continue;
+        }
+        // Handle presets
+        if (part in TOOL_PRESETS) {
+            if (!hasBaseSet) {
+                // First preset replaces the default
+                enabledTools = new Set(TOOL_PRESETS[part]);
+                hasBaseSet = true;
+            }
+            else {
+                // Additional presets merge with existing
+                for (const tool of TOOL_PRESETS[part]) {
+                    enabledTools.add(tool);
+                }
+            }
+            continue;
+        }
+        // Handle individual tools
+        const resolvedTool = resolveToolName(part);
+        if (resolvedTool) {
+            if (!hasBaseSet) {
+                // First individual tool creates a new set
+                enabledTools = new Set([resolvedTool]);
+                hasBaseSet = true;
+            }
+            else {
+                enabledTools.add(resolvedTool);
+            }
+        }
+        else {
+            console.warn(`Unknown tool or preset: "${part}"`);
+        }
+    }
+    return enabledTools;
+}
+/**
+ * Resolve a tool name or alias to the canonical tool name
+ * @param name Tool name or alias
+ * @returns Canonical tool name or undefined if not found
+ */
+function resolveToolName(name) {
+    const normalized = name.toLowerCase();
+    // Check if it's already a canonical name
+    if (isToolName(normalized)) {
+        return normalized;
+    }
+    // Check aliases
+    if (normalized in TOOL_ALIASES) {
+        return TOOL_ALIASES[normalized];
+    }
+    return undefined;
+}
+/**
+ * Type guard to check if a string is a valid ToolName
+ */
+function isToolName(name) {
+    const validTools = [
+        'get_forecast',
+        'get_alerts',
+        'get_historical_weather',
+        'check_service_status',
+        'search_location',
+        'get_air_quality',
+        'get_marine_conditions',
+        'get_weather_imagery',
+        'get_lightning_activity',
+        'get_river_conditions',
+        'get_wildfire_info',
+        'save_location',
+        'list_saved_locations',
+        'get_saved_location',
+        'remove_saved_location'
+    ];
+    return validTools.includes(name);
+}
+/**
+ * Tool configuration singleton
+ */
+class ToolConfig {
+    enabledTools;
+    constructor() {
+        this.enabledTools = parseEnabledTools(process.env.ENABLED_TOOLS);
+        // Log enabled tools for debugging
+        if (this.enabledTools.size > 0) {
+            console.error(`[ToolConfig] Enabled tools (${this.enabledTools.size}): ${Array.from(this.enabledTools).join(', ')}`);
+        }
+        else {
+            console.error('[ToolConfig] Warning: No tools enabled!');
+        }
+    }
+    /**
+     * Check if a specific tool is enabled
+     */
+    isEnabled(tool) {
+        return this.enabledTools.has(tool);
+    }
+    /**
+     * Get all enabled tools
+     */
+    getEnabledTools() {
+        return Array.from(this.enabledTools);
+    }
+    /**
+     * Get available presets
+     */
+    static getPresets() {
+        return { ...TOOL_PRESETS };
+    }
+    /**
+     * Get available tool aliases
+     */
+    static getAliases() {
+        return { ...TOOL_ALIASES };
+    }
+}
+// Export singleton instance
+export const toolConfig = new ToolConfig();
+// Export preset definitions for documentation
+export const PRESETS = TOOL_PRESETS;
+export const ALIASES = TOOL_ALIASES;
+//# sourceMappingURL=tools.js.map

package/dist/config/tools.js.map

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