@mseep/ai-tech-app-agent 1.0.0

package/dist/config/llm.config.js

@@ -0,0 +1,158 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PromptTemplates = void 0;
+exports.getPromptTemplate = getPromptTemplate;
+exports.validateLLMConfig = validateLLMConfig;
+exports.getProviderConfig = getProviderConfig;
+const dotenv_1 = __importDefault(require("dotenv"));
+dotenv_1.default.config();
+const llmConfig = {
+    provider: process.env.LLM_PROVIDER || 'ollama',
+    connection: {
+        baseUrl: process.env.OLLAMA_BASE_URL || process.env.LLM_BASE_URL || 'http://localhost:11434',
+        timeout: parseInt(process.env.LLM_TIMEOUT || '60000'),
+        retryAttempts: parseInt(process.env.LLM_RETRY_ATTEMPTS || '3'),
+        retryDelay: parseInt(process.env.LLM_RETRY_DELAY || '2000'),
+    },
+    model: {
+        name: process.env.LLM_MODEL || 'llama3.2:3b',
+        temperature: parseFloat(process.env.LLM_TEMPERATURE || '0.1'),
+        maxTokens: parseInt(process.env.LLM_MAX_TOKENS || '2000'),
+        topP: parseFloat(process.env.LLM_TOP_P || '0.9'),
+        topK: parseInt(process.env.LLM_TOP_K || '40'),
+        frequencyPenalty: parseFloat(process.env.LLM_FREQUENCY_PENALTY || '0.0'),
+        presencePenalty: parseFloat(process.env.LLM_PRESENCE_PENALTY || '0.0'),
+    },
+    prompt: {
+        systemMessage: process.env.LLM_SYSTEM_MESSAGE ||
+            'You are an expert mobile test automation agent specialized in Appium automation.',
+        includeAppContext: process.env.LLM_INCLUDE_APP_CONTEXT !== 'false',
+        includeUIContext: process.env.LLM_INCLUDE_UI_CONTEXT !== 'false',
+        maxUIElements: parseInt(process.env.LLM_MAX_UI_ELEMENTS || '30'),
+        maxContextTokens: parseInt(process.env.LLM_MAX_CONTEXT_TOKENS || '4000'),
+        includeReasoningInResponse: process.env.LLM_INCLUDE_REASONING !== 'false',
+        strictJsonMode: process.env.LLM_STRICT_JSON_MODE !== 'false',
+    },
+    performance: {
+        cachingEnabled: process.env.LLM_CACHING_ENABLED === 'true',
+        cacheTTL: parseInt(process.env.LLM_CACHE_TTL || '3600'),
+        batchRequests: process.env.LLM_BATCH_REQUESTS === 'true',
+        maxBatchSize: parseInt(process.env.LLM_MAX_BATCH_SIZE || '5'),
+        streamResponse: process.env.LLM_STREAM_RESPONSE === 'true',
+    },
+    fallback: {
+        enabled: process.env.LLM_FALLBACK_ENABLED === 'true',
+        fallbackModel: process.env.LLM_FALLBACK_MODEL,
+        maxFallbackAttempts: parseInt(process.env.LLM_FALLBACK_ATTEMPTS || '1'),
+    },
+};
+// Predefined prompt templates
+exports.PromptTemplates = {
+    actionPlanning: `You are an expert mobile test automation agent. Your task is to generate precise Appium actions to accomplish a test step.
+
+**Your Capabilities:**
+- Analyze mobile app UI hierarchies (XML format)
+- Identify the best element selectors (text, id, accessibility-id, xpath, class)
+- Generate reliable action sequences (tap, type, scroll, swipe, wait, assert)
+- Handle both Android and iOS platforms
+- Adapt to different screen sizes and device configurations
+
+**Priority for Element Selection:**
+1. Text content (exact or partial match)
+2. Accessibility ID or Content Description
+3. Resource ID (Android) or Name (iOS)
+4. Class name with additional attributes
+5. XPath (only when necessary)
+6. Coordinates (last resort)
+
+**Action Types Available:**
+- tap: Click/tap on an element
+- type: Enter text into an input field
+- scroll: Scroll in a direction (up, down, left, right)
+- swipe: Swipe gesture in a direction
+- wait: Wait for a duration or element
+- assert: Verify element state (exists, visible, text, enabled)
+- screenshot: Capture screen state`,
+    contextAnalysis: `Analyze the current UI context and identify key interactive elements that are relevant for accomplishing the given test step.
+
+**Focus on:**
+- Interactive elements (buttons, inputs, links)
+- Navigation elements (tabs, back buttons)
+- Text labels and headers for context
+- Error messages or alerts
+- Permission dialogs
+- Loading indicators`,
+    errorRecovery: `The previous action attempt failed. Analyze the current UI state and suggest alternative approaches.
+
+**Consider:**
+- Is the target element visible and enabled?
+- Are there any blocking dialogs or overlays?
+- Is the app in an unexpected state?
+- Are there alternative selectors for the same element?
+- Should we wait for animations or transitions to complete?`,
+    assertionGeneration: `Generate appropriate assertions to verify the expected outcome of the test step.
+
+**Common Assertions:**
+- Element exists on screen
+- Element is visible and enabled
+- Text content matches expected value
+- Specific screen or activity is displayed
+- No error messages are present`,
+};
+// Helper function to get appropriate template
+function getPromptTemplate(type) {
+    return exports.PromptTemplates[type];
+}
+// Validation
+function validateLLMConfig() {
+    const errors = [];
+    // Check base URL
+    if (!llmConfig.connection.baseUrl) {
+        errors.push('LLM_BASE_URL or OLLAMA_BASE_URL is required');
+    }
+    // Validate model name
+    if (!llmConfig.model.name) {
+        errors.push('LLM_MODEL is required');
+    }
+    // Validate temperature range
+    if (llmConfig.model.temperature < 0 || llmConfig.model.temperature > 2) {
+        errors.push('LLM_TEMPERATURE must be between 0 and 2');
+    }
+    // Validate max tokens
+    if (llmConfig.model.maxTokens < 100 || llmConfig.model.maxTokens > 100000) {
+        errors.push('LLM_MAX_TOKENS must be between 100 and 100000');
+    }
+    // Validate timeout
+    if (llmConfig.connection.timeout < 5000) {
+        errors.push('LLM_TIMEOUT must be at least 5000ms');
+    }
+    if (errors.length > 0) {
+        throw new Error(`LLM configuration validation failed:\n${errors.join('\n')}`);
+    }
+}
+// Get configuration for specific provider
+function getProviderConfig(provider) {
+    const configs = {
+        ollama: {
+            endpoint: '/api/generate',
+            healthEndpoint: '/api/tags',
+            format: 'ollama',
+        },
+        openai: {
+            endpoint: '/v1/chat/completions',
+            healthEndpoint: '/v1/models',
+            format: 'openai',
+        },
+        anthropic: {
+            endpoint: '/v1/messages',
+            healthEndpoint: '/v1/models',
+            format: 'anthropic',
+        },
+    };
+    return configs[provider] || configs.ollama;
+}
+exports.default = llmConfig;
+//# sourceMappingURL=llm.config.js.map

package/dist/config/llm.config.js.map

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

package/dist/config/mcp.config.d.ts

@@ -0,0 +1,175 @@
+export interface MCPConfig {
+    server: {
+        type: 'mcp-appium' | 'mobile-mcp' | 'custom';
+        host: string;
+        port: number;
+        protocol: 'http' | 'https' | 'stdio';
+        timeout: number;
+    };
+    appium: {
+        serverUrl: string;
+        sessionId?: string;
+        capabilities: {
+            platformName?: string;
+            platformVersion?: string;
+            deviceName?: string;
+            automationName?: string;
+            app?: string;
+            appPackage?: string;
+            appActivity?: string;
+            bundleId?: string;
+        };
+    };
+    tools: {
+        enabledTools: string[];
+        customTools?: Record<string, any>;
+    };
+    uiContext: {
+        capturePageSource: boolean;
+        parseXML: boolean;
+        includeInvisibleElements: boolean;
+        maxElementDepth: number;
+        elementFilters: {
+            excludeClasses: string[];
+            includeOnlyInteractive: boolean;
+            minTextLength: number;
+        };
+    };
+    actions: {
+        tapStrategy: 'center' | 'visible-center' | 'coordinates';
+        typeStrategy: 'native' | 'adb' | 'auto';
+        scrollStrategy: 'uiautomator' | 'gesture' | 'auto';
+        swipeStrategy: 'touch-action' | 'gesture' | 'auto';
+        waitStrategy: 'implicit' | 'explicit' | 'smart';
+    };
+    errorHandling: {
+        retryOnStaleElement: boolean;
+        retryOnNoSuchElement: boolean;
+        retryAttempts: number;
+        retryDelay: number;
+        captureScreenshotOnError: boolean;
+        capturePageSourceOnError: boolean;
+    };
+    performance: {
+        cacheUIContext: boolean;
+        cacheDuration: number;
+        parallelActions: boolean;
+        throttleActions: number;
+    };
+}
+declare const mcpConfig: MCPConfig;
+export declare const MCPTools: {
+    find_element: {
+        name: string;
+        description: string;
+        parameters: {
+            strategy: string[];
+            value: string;
+            multiple: string;
+        };
+    };
+    tap: {
+        name: string;
+        description: string;
+        parameters: {
+            selector: string;
+            x: string;
+            y: string;
+            duration: string;
+        };
+    };
+    type: {
+        name: string;
+        description: string;
+        parameters: {
+            selector: string;
+            text: string;
+            clear: string;
+        };
+    };
+    scroll: {
+        name: string;
+        description: string;
+        parameters: {
+            direction: string[];
+            percentage: string;
+            element: string;
+        };
+    };
+    swipe: {
+        name: string;
+        description: string;
+        parameters: {
+            direction: string[];
+            startX: string;
+            startY: string;
+            endX: string;
+            endY: string;
+            duration: string;
+        };
+    };
+    get_page_source: {
+        name: string;
+        description: string;
+        parameters: {};
+    };
+    take_screenshot: {
+        name: string;
+        description: string;
+        parameters: {
+            path: string;
+        };
+    };
+    wait: {
+        name: string;
+        description: string;
+        parameters: {
+            selector: string;
+            condition: string[];
+            timeout: string;
+            duration: string;
+        };
+    };
+    get_current_activity: {
+        name: string;
+        description: string;
+        parameters: {};
+    };
+    press_key: {
+        name: string;
+        description: string;
+        parameters: {
+            key: string[];
+        };
+    };
+};
+export declare const SelectorPriority: string[];
+export declare const PlatformConfig: {
+    android: {
+        automationName: string;
+        defaultTimeout: number;
+        keyboardStrategy: string;
+        preferredSelectors: string[];
+    };
+    ios: {
+        automationName: string;
+        defaultTimeout: number;
+        keyboardStrategy: string;
+        preferredSelectors: string[];
+    };
+};
+export declare function validateMCPConfig(): void;
+export declare function getPlatformConfig(platform: 'android' | 'ios'): {
+    automationName: string;
+    defaultTimeout: number;
+    keyboardStrategy: string;
+    preferredSelectors: string[];
+} | {
+    automationName: string;
+    defaultTimeout: number;
+    keyboardStrategy: string;
+    preferredSelectors: string[];
+};
+export declare function isToolEnabled(toolName: string): boolean;
+export default mcpConfig;
+//# sourceMappingURL=mcp.config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.config.d.ts","sourceRoot":"","sources":["../../src/config/mcp.config.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE;QACN,IAAI,EAAE,YAAY,GAAG,YAAY,GAAG,QAAQ,CAAC;QAC7C,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;QACrC,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IAEF,MAAM,EAAE;QACN,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,YAAY,EAAE;YACZ,YAAY,CAAC,EAAE,MAAM,CAAC;YACtB,eAAe,CAAC,EAAE,MAAM,CAAC;YACzB,UAAU,CAAC,EAAE,MAAM,CAAC;YACpB,cAAc,CAAC,EAAE,MAAM,CAAC;YACxB,GAAG,CAAC,EAAE,MAAM,CAAC;YACb,UAAU,CAAC,EAAE,MAAM,CAAC;YACpB,WAAW,CAAC,EAAE,MAAM,CAAC;YACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;SACnB,CAAC;KACH,CAAC;IAEF,KAAK,EAAE;QACL,YAAY,EAAE,MAAM,EAAE,CAAC;QACvB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;KACnC,CAAC;IAEF,SAAS,EAAE;QACT,iBAAiB,EAAE,OAAO,CAAC;QAC3B,QAAQ,EAAE,OAAO,CAAC;QAClB,wBAAwB,EAAE,OAAO,CAAC;QAClC,eAAe,EAAE,MAAM,CAAC;QACxB,cAAc,EAAE;YACd,cAAc,EAAE,MAAM,EAAE,CAAC;YACzB,sBAAsB,EAAE,OAAO,CAAC;YAChC,aAAa,EAAE,MAAM,CAAC;SACvB,CAAC;KACH,CAAC;IAEF,OAAO,EAAE;QACP,WAAW,EAAE,QAAQ,GAAG,gBAAgB,GAAG,aAAa,CAAC;QACzD,YAAY,EAAE,QAAQ,GAAG,KAAK,GAAG,MAAM,CAAC;QACxC,cAAc,EAAE,aAAa,GAAG,SAAS,GAAG,MAAM,CAAC;QACnD,aAAa,EAAE,cAAc,GAAG,SAAS,GAAG,MAAM,CAAC;QACnD,YAAY,EAAE,UAAU,GAAG,UAAU,GAAG,OAAO,CAAC;KACjD,CAAC;IAEF,aAAa,EAAE;QACb,mBAAmB,EAAE,OAAO,CAAC;QAC7B,oBAAoB,EAAE,OAAO,CAAC;QAC9B,aAAa,EAAE,MAAM,CAAC;QACtB,UAAU,EAAE,MAAM,CAAC;QACnB,wBAAwB,EAAE,OAAO,CAAC;QAClC,wBAAwB,EAAE,OAAO,CAAC;KACnC,CAAC;IAEF,WAAW,EAAE;QACX,cAAc,EAAE,OAAO,CAAC;QACxB,aAAa,EAAE,MAAM,CAAC;QACtB,eAAe,EAAE,OAAO,CAAC;QACzB,eAAe,EAAE,MAAM,CAAC;KACzB,CAAC;CACH;AAED,QAAA,MAAM,SAAS,EAAE,SAkEhB,CAAC;AAGF,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoFpB,CAAC;AAGF,eAAO,MAAM,gBAAgB,UAO5B,CAAC;AAGF,eAAO,MAAM,cAAc;;;;;;;;;;;;;CAa1B,CAAC;AAGF,wBAAgB,iBAAiB,IAAI,IAAI,CA0BxC;AAGD,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,SAAS,GAAG,KAAK;;;;;;;;;;EAE5D;AAGD,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEvD;AAED,eAAe,SAAS,CAAC"}

package/dist/config/mcp.config.js

@@ -0,0 +1,215 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PlatformConfig = exports.SelectorPriority = exports.MCPTools = void 0;
+exports.validateMCPConfig = validateMCPConfig;
+exports.getPlatformConfig = getPlatformConfig;
+exports.isToolEnabled = isToolEnabled;
+const dotenv_1 = __importDefault(require("dotenv"));
+dotenv_1.default.config();
+const mcpConfig = {
+    server: {
+        type: process.env.MCP_SERVER_TYPE || 'mcp-appium',
+        host: process.env.MCP_SERVER_HOST || 'localhost',
+        port: parseInt(process.env.MCP_SERVER_PORT || '3000'),
+        protocol: process.env.MCP_PROTOCOL || 'http',
+        timeout: parseInt(process.env.MCP_TIMEOUT || '30000'),
+    },
+    appium: {
+        serverUrl: process.env.APPIUM_SERVER_URL || 'http://localhost:4723',
+        sessionId: process.env.APPIUM_SESSION_ID,
+        capabilities: {
+            platformName: process.env.PLATFORM_NAME,
+            platformVersion: process.env.PLATFORM_VERSION,
+            deviceName: process.env.DEVICE_NAME,
+            automationName: process.env.AUTOMATION_NAME,
+            app: process.env.APP_PATH,
+            appPackage: process.env.APP_PACKAGE,
+            appActivity: process.env.APP_ACTIVITY,
+            bundleId: process.env.BUNDLE_ID,
+        },
+    },
+    tools: {
+        enabledTools: (process.env.MCP_ENABLED_TOOLS ||
+            'find_element,tap,type,scroll,swipe,get_page_source,take_screenshot').split(','),
+        customTools: {},
+    },
+    uiContext: {
+        capturePageSource: process.env.MCP_CAPTURE_PAGE_SOURCE !== 'false',
+        parseXML: process.env.MCP_PARSE_XML !== 'false',
+        includeInvisibleElements: process.env.MCP_INCLUDE_INVISIBLE === 'true',
+        maxElementDepth: parseInt(process.env.MCP_MAX_ELEMENT_DEPTH || '10'),
+        elementFilters: {
+            excludeClasses: (process.env.MCP_EXCLUDE_CLASSES ||
+                'android.view.ViewGroup,android.widget.LinearLayout,UIView').split(','),
+            includeOnlyInteractive: process.env.MCP_ONLY_INTERACTIVE === 'true',
+            minTextLength: parseInt(process.env.MCP_MIN_TEXT_LENGTH || '1'),
+        },
+    },
+    actions: {
+        tapStrategy: process.env.MCP_TAP_STRATEGY || 'center',
+        typeStrategy: process.env.MCP_TYPE_STRATEGY || 'native',
+        scrollStrategy: process.env.MCP_SCROLL_STRATEGY || 'auto',
+        swipeStrategy: process.env.MCP_SWIPE_STRATEGY || 'auto',
+        waitStrategy: process.env.MCP_WAIT_STRATEGY || 'smart',
+    },
+    errorHandling: {
+        retryOnStaleElement: process.env.MCP_RETRY_STALE !== 'false',
+        retryOnNoSuchElement: process.env.MCP_RETRY_NO_ELEMENT === 'true',
+        retryAttempts: parseInt(process.env.MCP_ERROR_RETRY_ATTEMPTS || '2'),
+        retryDelay: parseInt(process.env.MCP_ERROR_RETRY_DELAY || '1000'),
+        captureScreenshotOnError: process.env.MCP_SCREENSHOT_ON_ERROR !== 'false',
+        capturePageSourceOnError: process.env.MCP_PAGE_SOURCE_ON_ERROR === 'true',
+    },
+    performance: {
+        cacheUIContext: process.env.MCP_CACHE_UI_CONTEXT === 'true',
+        cacheDuration: parseInt(process.env.MCP_CACHE_DURATION || '5000'),
+        parallelActions: process.env.MCP_PARALLEL_ACTIONS === 'true',
+        throttleActions: parseInt(process.env.MCP_THROTTLE_ACTIONS || '0'),
+    },
+};
+// MCP Tool definitions
+exports.MCPTools = {
+    find_element: {
+        name: 'find_element',
+        description: 'Find an element on the screen using various selector strategies',
+        parameters: {
+            strategy: ['id', 'xpath', 'accessibility-id', 'text', 'class'],
+            value: 'string',
+            multiple: 'boolean',
+        },
+    },
+    tap: {
+        name: 'tap',
+        description: 'Tap/click on an element',
+        parameters: {
+            selector: 'object',
+            x: 'number (optional)',
+            y: 'number (optional)',
+            duration: 'number (optional)',
+        },
+    },
+    type: {
+        name: 'type',
+        description: 'Type text into an element',
+        parameters: {
+            selector: 'object',
+            text: 'string',
+            clear: 'boolean (optional)',
+        },
+    },
+    scroll: {
+        name: 'scroll',
+        description: 'Scroll the screen',
+        parameters: {
+            direction: ['up', 'down', 'left', 'right'],
+            percentage: 'number (optional)',
+            element: 'object (optional)',
+        },
+    },
+    swipe: {
+        name: 'swipe',
+        description: 'Perform swipe gesture',
+        parameters: {
+            direction: ['up', 'down', 'left', 'right'],
+            startX: 'number (optional)',
+            startY: 'number (optional)',
+            endX: 'number (optional)',
+            endY: 'number (optional)',
+            duration: 'number (optional)',
+        },
+    },
+    get_page_source: {
+        name: 'get_page_source',
+        description: 'Get the current page source (XML hierarchy)',
+        parameters: {},
+    },
+    take_screenshot: {
+        name: 'take_screenshot',
+        description: 'Capture a screenshot',
+        parameters: {
+            path: 'string (optional)',
+        },
+    },
+    wait: {
+        name: 'wait',
+        description: 'Wait for element or duration',
+        parameters: {
+            selector: 'object (optional)',
+            condition: ['exists', 'visible', 'enabled', 'clickable'],
+            timeout: 'number (optional)',
+            duration: 'number (optional)',
+        },
+    },
+    get_current_activity: {
+        name: 'get_current_activity',
+        description: 'Get current activity (Android) or bundle ID (iOS)',
+        parameters: {},
+    },
+    press_key: {
+        name: 'press_key',
+        description: 'Press device key',
+        parameters: {
+            key: ['home', 'back', 'enter', 'menu', 'volume_up', 'volume_down'],
+        },
+    },
+};
+// Selector strategies priority
+exports.SelectorPriority = [
+    'accessibility-id',
+    'id',
+    'text',
+    'class',
+    'xpath',
+    'coordinates',
+];
+// Platform-specific configurations
+exports.PlatformConfig = {
+    android: {
+        automationName: 'UiAutomator2',
+        defaultTimeout: 30000,
+        keyboardStrategy: 'adb',
+        preferredSelectors: ['resource-id', 'content-desc', 'text'],
+    },
+    ios: {
+        automationName: 'XCUITest',
+        defaultTimeout: 30000,
+        keyboardStrategy: 'native',
+        preferredSelectors: ['accessibility-id', 'name', 'label'],
+    },
+};
+// Validation
+function validateMCPConfig() {
+    const errors = [];
+    // Check Appium server URL
+    if (!mcpConfig.appium.serverUrl) {
+        errors.push('APPIUM_SERVER_URL is required');
+    }
+    // Validate server port
+    if (mcpConfig.server.port < 1 || mcpConfig.server.port > 65535) {
+        errors.push('MCP_SERVER_PORT must be between 1 and 65535');
+    }
+    // Validate timeout
+    if (mcpConfig.server.timeout < 1000) {
+        errors.push('MCP_TIMEOUT must be at least 1000ms');
+    }
+    // Validate element depth
+    if (mcpConfig.uiContext.maxElementDepth < 1 || mcpConfig.uiContext.maxElementDepth > 20) {
+        errors.push('MCP_MAX_ELEMENT_DEPTH must be between 1 and 20');
+    }
+    if (errors.length > 0) {
+        throw new Error(`MCP configuration validation failed:\n${errors.join('\n')}`);
+    }
+}
+// Helper to get platform-specific config
+function getPlatformConfig(platform) {
+    return exports.PlatformConfig[platform];
+}
+// Helper to check if tool is enabled
+function isToolEnabled(toolName) {
+    return mcpConfig.tools.enabledTools.includes(toolName);
+}
+exports.default = mcpConfig;
+//# sourceMappingURL=mcp.config.js.map

package/dist/config/mcp.config.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}