@gala-chain/launchpad-mcp-server 1.4.0 → 1.5.1

package/dist/utils/tool-registry.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Tool Registry System
+ *
+ * Enhanced tool registration with auto-validation, metadata, and search capabilities.
+ * Provides runtime validation and developer-friendly tool discovery.
+ *
+ * @see Phase 3.1 of refactoring plan
+ */
+import type { MCPTool } from '../types/mcp.js';
+/**
+ * Tool category metadata
+ */
+export interface ToolCategory {
+    name: string;
+    description: string;
+    tools: MCPTool[];
+    count: number;
+}
+/**
+ * Tool registry with metadata and search capabilities
+ */
+export interface ToolRegistry {
+    tools: MCPTool[];
+    categories: Map<string, ToolCategory>;
+    totalCount: number;
+    expectedCount: number;
+    isValid: boolean;
+    errors: string[];
+}
+/**
+ * Tool validation result
+ */
+export interface ToolValidationResult {
+    isValid: boolean;
+    errors: string[];
+    warnings: string[];
+}
+/**
+ * Validates a single tool definition
+ */
+export declare function validateTool(tool: MCPTool): ToolValidationResult;
+/**
+ * Validates all tools in a registry
+ */
+export declare function validateTools(tools: MCPTool[]): ToolValidationResult;
+/**
+ * Creates a tool registry with metadata and validation
+ */
+export declare function createToolRegistry(categories: Array<{
+    name: string;
+    description: string;
+    tools: MCPTool[];
+}>, expectedCount?: number): ToolRegistry;
+/**
+ * Finds a tool by name
+ */
+export declare function findTool(registry: ToolRegistry, name: string): MCPTool | undefined;
+/**
+ * Finds tools by category
+ */
+export declare function findToolsByCategory(registry: ToolRegistry, categoryName: string): MCPTool[];
+/**
+ * Searches tools by name pattern
+ */
+export declare function searchTools(registry: ToolRegistry, pattern: string): MCPTool[];
+/**
+ * Gets tool statistics by category
+ */
+export declare function getToolStatistics(registry: ToolRegistry): {
+    total: number;
+    byCategory: Record<string, number>;
+};
+/**
+ * Logs tool registry statistics
+ */
+export declare function logToolRegistry(registry: ToolRegistry): void;
+/**
+ * Generates markdown documentation for tool registry
+ */
+export declare function generateToolDocumentation(registry: ToolRegistry): string;
+export declare const toolRegistry: {
+    createToolRegistry: typeof createToolRegistry;
+    validateTool: typeof validateTool;
+    validateTools: typeof validateTools;
+    findTool: typeof findTool;
+    findToolsByCategory: typeof findToolsByCategory;
+    searchTools: typeof searchTools;
+    getToolStatistics: typeof getToolStatistics;
+    logToolRegistry: typeof logToolRegistry;
+    generateToolDocumentation: typeof generateToolDocumentation;
+};
+//# sourceMappingURL=tool-registry.d.ts.map

package/dist/utils/tool-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-registry.d.ts","sourceRoot":"","sources":["../../src/utils/tool-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAM/C;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,OAAO,EAAE,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,OAAO,EAAE,CAAC;IACjB,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAMD;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,oBAAoB,CA6ChE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,oBAAoB,CA+BpE;AAMD;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,EAAE,CAAA;CAAE,CAAC,EAC1E,aAAa,CAAC,EAAE,MAAM,GACrB,YAAY,CAyCd;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAElF;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,YAAY,EACtB,YAAY,EAAE,MAAM,GACnB,OAAO,EAAE,CAGX;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,EAAE,CAG9E;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,YAAY,GAAG;IACzD,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACpC,CAWA;AAMD;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI,CAgB5D;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,YAAY,GAAG,MAAM,CAiBxE;AAMD,eAAO,MAAM,YAAY;;;;;;;;;;CAUxB,CAAC"}

package/dist/utils/tool-registry.js

@@ -0,0 +1,227 @@
+"use strict";
+/**
+ * Tool Registry System
+ *
+ * Enhanced tool registration with auto-validation, metadata, and search capabilities.
+ * Provides runtime validation and developer-friendly tool discovery.
+ *
+ * @see Phase 3.1 of refactoring plan
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toolRegistry = void 0;
+exports.validateTool = validateTool;
+exports.validateTools = validateTools;
+exports.createToolRegistry = createToolRegistry;
+exports.findTool = findTool;
+exports.findToolsByCategory = findToolsByCategory;
+exports.searchTools = searchTools;
+exports.getToolStatistics = getToolStatistics;
+exports.logToolRegistry = logToolRegistry;
+exports.generateToolDocumentation = generateToolDocumentation;
+// =============================================================================
+// Validation Functions
+// =============================================================================
+/**
+ * Validates a single tool definition
+ */
+function validateTool(tool) {
+    const errors = [];
+    const warnings = [];
+    // Required fields
+    if (!tool.name) {
+        errors.push('Tool name is required');
+    }
+    else if (typeof tool.name !== 'string') {
+        errors.push('Tool name must be a string');
+    }
+    else if (!tool.name.startsWith('gala_launchpad_')) {
+        warnings.push(`Tool name "${tool.name}" should start with "gala_launchpad_"`);
+    }
+    if (!tool.description) {
+        errors.push('Tool description is required');
+    }
+    else if (typeof tool.description !== 'string') {
+        errors.push('Tool description must be a string');
+    }
+    if (!tool.inputSchema) {
+        errors.push('Tool inputSchema is required');
+    }
+    else {
+        // Validate input schema structure
+        if (tool.inputSchema.type !== 'object') {
+            errors.push('inputSchema.type must be "object"');
+        }
+        if (!tool.inputSchema.properties) {
+            warnings.push('inputSchema.properties is empty');
+        }
+        if (tool.inputSchema.required && !Array.isArray(tool.inputSchema.required)) {
+            errors.push('inputSchema.required must be an array');
+        }
+    }
+    if (!tool.handler) {
+        errors.push('Tool handler is required');
+    }
+    else if (typeof tool.handler !== 'function') {
+        errors.push('Tool handler must be a function');
+    }
+    return {
+        isValid: errors.length === 0,
+        errors,
+        warnings,
+    };
+}
+/**
+ * Validates all tools in a registry
+ */
+function validateTools(tools) {
+    const allErrors = [];
+    const allWarnings = [];
+    const toolNames = new Set();
+    tools.forEach((tool, index) => {
+        const result = validateTool(tool);
+        // Collect errors with tool context
+        result.errors.forEach((error) => {
+            allErrors.push(`Tool #${index + 1} (${tool.name || 'unknown'}): ${error}`);
+        });
+        result.warnings.forEach((warning) => {
+            allWarnings.push(`Tool #${index + 1} (${tool.name || 'unknown'}): ${warning}`);
+        });
+        // Check for duplicate names
+        if (tool.name) {
+            if (toolNames.has(tool.name)) {
+                allErrors.push(`Duplicate tool name: ${tool.name}`);
+            }
+            toolNames.add(tool.name);
+        }
+    });
+    return {
+        isValid: allErrors.length === 0,
+        errors: allErrors,
+        warnings: allWarnings,
+    };
+}
+// =============================================================================
+// Registry Functions
+// =============================================================================
+/**
+ * Creates a tool registry with metadata and validation
+ */
+function createToolRegistry(categories, expectedCount) {
+    const allTools = [];
+    const categoryMap = new Map();
+    const registryErrors = [];
+    // Process each category
+    categories.forEach((category) => {
+        const toolCategory = {
+            name: category.name,
+            description: category.description,
+            tools: category.tools,
+            count: category.tools.length,
+        };
+        categoryMap.set(category.name, toolCategory);
+        allTools.push(...category.tools);
+    });
+    // Validate all tools
+    const validation = validateTools(allTools);
+    registryErrors.push(...validation.errors);
+    // Check expected count
+    const actualCount = allTools.length;
+    const hasExpectedCount = expectedCount !== undefined;
+    const countMatches = hasExpectedCount ? actualCount === expectedCount : true;
+    if (hasExpectedCount && !countMatches) {
+        registryErrors.push(`Tool count mismatch: expected ${expectedCount}, got ${actualCount}`);
+    }
+    return {
+        tools: allTools,
+        categories: categoryMap,
+        totalCount: actualCount,
+        expectedCount: expectedCount ?? actualCount,
+        isValid: registryErrors.length === 0,
+        errors: registryErrors,
+    };
+}
+/**
+ * Finds a tool by name
+ */
+function findTool(registry, name) {
+    return registry.tools.find((tool) => tool.name === name);
+}
+/**
+ * Finds tools by category
+ */
+function findToolsByCategory(registry, categoryName) {
+    const category = registry.categories.get(categoryName);
+    return category ? category.tools : [];
+}
+/**
+ * Searches tools by name pattern
+ */
+function searchTools(registry, pattern) {
+    const regex = new RegExp(pattern, 'i');
+    return registry.tools.filter((tool) => regex.test(tool.name));
+}
+/**
+ * Gets tool statistics by category
+ */
+function getToolStatistics(registry) {
+    const byCategory = {};
+    registry.categories.forEach((category, name) => {
+        byCategory[name] = category.count;
+    });
+    return {
+        total: registry.totalCount,
+        byCategory,
+    };
+}
+// =============================================================================
+// Logging and Reporting
+// =============================================================================
+/**
+ * Logs tool registry statistics
+ */
+function logToolRegistry(registry) {
+    console.log('\n📦 Tool Registry Statistics:');
+    console.log(`   Total Tools: ${registry.totalCount}/${registry.expectedCount}`);
+    console.log(`   Valid: ${registry.isValid ? '✅' : '❌'}`);
+    if (!registry.isValid && registry.errors.length > 0) {
+        console.log('\n❌ Validation Errors:');
+        registry.errors.forEach((error) => console.log(`   - ${error}`));
+    }
+    console.log('\n📂 Categories:');
+    registry.categories.forEach((category) => {
+        console.log(`   ${category.name}: ${category.count} tools`);
+    });
+    console.log('');
+}
+/**
+ * Generates markdown documentation for tool registry
+ */
+function generateToolDocumentation(registry) {
+    let doc = '# MCP Tool Registry\n\n';
+    doc += `**Total Tools**: ${registry.totalCount}\n\n`;
+    doc += '## Categories\n\n';
+    registry.categories.forEach((category) => {
+        doc += `### ${category.name} (${category.count} tools)\n\n`;
+        doc += `${category.description}\n\n`;
+        category.tools.forEach((tool) => {
+            doc += `- **${tool.name}**: ${tool.description}\n`;
+        });
+        doc += '\n';
+    });
+    return doc;
+}
+// =============================================================================
+// Export All
+// =============================================================================
+exports.toolRegistry = {
+    createToolRegistry,
+    validateTool,
+    validateTools,
+    findTool,
+    findToolsByCategory,
+    searchTools,
+    getToolStatistics,
+    logToolRegistry,
+    generateToolDocumentation,
+};
+//# sourceMappingURL=tool-registry.js.map

package/dist/utils/tool-registry.js.map

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

package/dist/utils/validation.d.ts

@@ -0,0 +1,162 @@
+/**
+ * Validation Utilities for MCP Prompts
+ *
+ * Input validation functions for slash command arguments.
+ * Prevents malformed inputs and provides clear error messages.
+ */
+/**
+ * Validation error class for better error handling
+ */
+export declare class ValidationError extends Error {
+    field: string;
+    constructor(field: string, message: string);
+}
+/**
+ * Validate token name format
+ *
+ * Token names must be 2-20 characters, alphanumeric with hyphens and underscores.
+ *
+ * @param name - Token name to validate
+ * @param fieldName - Field name for error messages (default: 'tokenName')
+ * @throws {ValidationError} If token name is invalid
+ *
+ * @example
+ * ```typescript
+ * validateTokenName('anime'); // ✅ Valid
+ * validateTokenName('test-123'); // ✅ Valid
+ * validateTokenName('my_token'); // ✅ Valid
+ * validateTokenName('a'); // ❌ Throws: too short
+ * validateTokenName('token@#$'); // ❌ Throws: invalid characters
+ * ```
+ */
+export declare function validateTokenName(name: string, fieldName?: string): void;
+/**
+ * Validate numeric amount
+ *
+ * Amounts must be positive numbers (integers or decimals).
+ *
+ * @param amount - Amount to validate (string or number)
+ * @param fieldName - Field name for error messages
+ * @throws {ValidationError} If amount is invalid
+ *
+ * @example
+ * ```typescript
+ * validateNumericAmount('100', 'galaAmount'); // ✅ Valid
+ * validateNumericAmount('99.5', 'tokenAmount'); // ✅ Valid
+ * validateNumericAmount('-5', 'amount'); // ❌ Throws: negative
+ * validateNumericAmount('abc', 'amount'); // ❌ Throws: not a number
+ * ```
+ */
+export declare function validateNumericAmount(amount: string | number, fieldName: string): void;
+/**
+ * Validate slippage tolerance percentage
+ *
+ * Slippage must be between 0.01% and 100%.
+ *
+ * @param slippage - Slippage percentage to validate
+ * @param fieldName - Field name for error messages (default: 'slippage')
+ * @throws {ValidationError} If slippage is invalid
+ *
+ * @example
+ * ```typescript
+ * validateSlippage('1'); // ✅ Valid (1%)
+ * validateSlippage('0.5'); // ✅ Valid (0.5%)
+ * validateSlippage('50'); // ✅ Valid (50%)
+ * validateSlippage('0'); // ❌ Throws: too low
+ * validateSlippage('150'); // ❌ Throws: too high
+ * ```
+ */
+export declare function validateSlippage(slippage: string | number, fieldName?: string): void;
+/**
+ * Validate wallet address format
+ *
+ * Supports both GalaChain format (eth|0x...) and standard Ethereum format (0x...).
+ *
+ * @param address - Wallet address to validate
+ * @param fieldName - Field name for error messages (default: 'address')
+ * @throws {ValidationError} If address is invalid
+ *
+ * @example
+ * ```typescript
+ * validateAddress('eth|0x1234567890abcdef1234567890abcdef12345678'); // ✅ Valid
+ * validateAddress('0x1234567890abcdef1234567890abcdef12345678'); // ✅ Valid
+ * validateAddress('invalid'); // ❌ Throws: invalid format
+ * ```
+ */
+export declare function validateAddress(address: string, fieldName?: string): void;
+/**
+ * Validate token symbol format
+ *
+ * Symbols must be 1-8 uppercase letters.
+ *
+ * @param symbol - Token symbol to validate
+ * @param fieldName - Field name for error messages (default: 'symbol')
+ * @throws {ValidationError} If symbol is invalid
+ *
+ * @example
+ * ```typescript
+ * validateTokenSymbol('GALA'); // ✅ Valid
+ * validateTokenSymbol('TEST'); // ✅ Valid
+ * validateTokenSymbol('test'); // ❌ Throws: must be uppercase
+ * validateTokenSymbol('TOOLONG123'); // ❌ Throws: too long
+ * ```
+ */
+export declare function validateTokenSymbol(symbol: string, fieldName?: string): void;
+/**
+ * Validate pagination limit
+ *
+ * Limits must be positive integers within reasonable range (1-100).
+ *
+ * @param limit - Pagination limit to validate
+ * @param max - Maximum allowed limit (default: 100)
+ * @param fieldName - Field name for error messages (default: 'limit')
+ * @throws {ValidationError} If limit is invalid
+ *
+ * @example
+ * ```typescript
+ * validatePaginationLimit('20'); // ✅ Valid
+ * validatePaginationLimit('1'); // ✅ Valid
+ * validatePaginationLimit('0'); // ❌ Throws: too low
+ * validatePaginationLimit('150'); // ❌ Throws: too high
+ * ```
+ */
+export declare function validatePaginationLimit(limit: string | number, max?: number, fieldName?: string): void;
+/**
+ * Validate comma-separated token list
+ *
+ * For batch operations that accept multiple token names.
+ *
+ * @param tokens - Comma-separated token names
+ * @param fieldName - Field name for error messages (default: 'tokens')
+ * @throws {ValidationError} If token list is invalid
+ *
+ * @example
+ * ```typescript
+ * validateTokenList('anime,test,dragon'); // ✅ Valid
+ * validateTokenList('token1'); // ✅ Valid (single token)
+ * validateTokenList(''); // ❌ Throws: empty list
+ * validateTokenList('token1,invalid@#$'); // ❌ Throws: invalid token name
+ * ```
+ */
+export declare function validateTokenList(tokens: string, fieldName?: string): string[];
+/**
+ * Safe validation wrapper that doesn't throw
+ *
+ * Useful for non-critical validation where you want to continue with a warning.
+ *
+ * @param validationFn - Validation function to execute
+ * @returns Object with success flag and optional error
+ *
+ * @example
+ * ```typescript
+ * const result = safeValidate(() => validateTokenName('anime'));
+ * if (!result.success) {
+ *   console.warn('Validation warning:', result.error);
+ * }
+ * ```
+ */
+export declare function safeValidate(validationFn: () => void): {
+    success: boolean;
+    error?: string;
+};
+//# sourceMappingURL=validation.d.ts.map

package/dist/utils/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/utils/validation.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,qBAAa,eAAgB,SAAQ,KAAK;IAE/B,KAAK,EAAE,MAAM;gBAAb,KAAK,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM;CAKlB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,SAAc,GAAG,IAAI,CAmB7E;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,MAAM,GAAG,MAAM,EACvB,SAAS,EAAE,MAAM,GAChB,IAAI,CAqBN;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,GAAG,MAAM,EACzB,SAAS,SAAa,GACrB,IAAI,CAoBN;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,SAAY,GAAG,IAAI,CAgB5E;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,SAAW,GAAG,IAAI,CAmB9E;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,MAAM,GAAG,MAAM,EACtB,GAAG,SAAM,EACT,SAAS,SAAU,GAClB,IAAI,CAoBN;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,SAAW,GAAG,MAAM,EAAE,CA2BhF;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,YAAY,CAC1B,YAAY,EAAE,MAAM,IAAI,GACvB;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAUtC"}