@gala-chain/launchpad-mcp-server 1.24.1 → 1.25.0

package/src/prompts/__tests__/promptStructure.test.ts

@@ -1,187 +0,0 @@
-/**
- * Prompt Structure Tests
- *
- * Validates that all prompts conform to MCP protocol specification
- */
-
-import { prompts } from '../index';
-
-describe('Prompt Structure', () => {
-  // Helper to generate valid args for each prompt type
-  function getValidArgsForPrompt(promptName: string): Record<string, string> {
-    if (promptName.includes('analyze-token') || promptName.includes('pool-details')) {
-      return { tokenName: 'anime' };
-    }
-    if (promptName.includes('buy-tokens')) {
-      return { tokenName: 'anime', galaAmount: '100' };
-    }
-    if (promptName.includes('sell-tokens')) {
-      return { tokenName: 'anime', tokenAmount: '1000' };
-    }
-    if (promptName.includes('graduate-token')) {
-      return { tokenName: 'anime' };
-    }
-    if (promptName.includes('create-token')) {
-      return {
-        tokenName: 'mytoken',
-        tokenSymbol: 'MTK',
-        description: 'Test token description',
-        websiteUrl: 'https://example.com',
-      };
-    }
-    if (promptName.includes('discover-tokens')) {
-      return { type: 'recent', limit: '10' };
-    }
-    if (promptName.includes('compare-tokens')) {
-      return { token1: 'anime', token2: 'test' };
-    }
-    if (promptName.includes('graduation-status') || promptName.includes('spot-prices')) {
-      return { tokens: 'anime,test,dragon' };
-    }
-    if (promptName.includes('dex-swap')) {
-      return { fromToken: 'GALA', toToken: 'GUSDC', amount: '100' };
-    }
-    if (promptName.includes('add-liquidity')) {
-      return { token0: 'GALA', token1: 'GUSDC', amount0: '1000', amount1: '1000' };
-    }
-    if (promptName.includes('remove-liquidity')) {
-      return { positionId: 'position-123', amount0: '500', amount1: '500' };
-    }
-    if (promptName.includes('collect-fees')) {
-      return { positionId: 'position-123' };
-    }
-    // Pool prompts requiring tokenName
-    if (promptName.includes('token-distribution') ||
-        promptName.includes('token-badges') ||
-        promptName.includes('volume-data') ||
-        promptName.includes('token-spot-price') ||
-        promptName.includes('check-token-name') ||
-        promptName.includes('resolve-vault-address') ||
-        promptName.includes('resolve-token-class-key') ||
-        promptName.includes('upload-token-image') ||
-        promptName.includes('post-comment') ||
-        promptName.includes('fetch-comments')) {
-      return { tokenName: 'anime' };
-    }
-    // Trading calculation prompts
-    if (promptName.includes('calculate-buy-amount') ||
-        promptName.includes('calculate-sell-amount') ||
-        promptName.includes('calculate-graduation-cost') ||
-        promptName.includes('is-token-graduated')) {
-      return { tokenName: 'anime', amount: '100' };
-    }
-    if (promptName.includes('calculate-initial-buy')) {
-      return { tokenName: 'anime', amount: '100', priceUsd: '1.0' };
-    }
-    // Balance prompts
-    if (promptName.includes('token-balance') || promptName.includes('tokens-created')) {
-      return { address: 'eth|0x1234567890123456789012345678901234567890', tokenName: 'anime' };
-    }
-    // Transfer prompts
-    if (promptName.includes('transfer-gala')) {
-      return { recipientAddress: 'eth|0x1234567890123456789012345678901234567890', amount: '100' };
-    }
-    if (promptName.includes('transfer-token')) {
-      return { to: 'eth|0x1234567890123456789012345678901234567890', tokenName: 'anime', amount: '100' };
-    }
-    // Wallet prompts
-    if (promptName.includes('set-wallet')) {
-      return { privateKey: '0x1234567890123456789012345678901234567890123456789012345678901234' };
-    }
-    if (promptName.includes('get-url-by-token-name')) {
-      return { tokenName: 'anime' };
-    }
-    if (promptName.includes('explain-sdk-usage')) {
-      return { topic: 'buy-tokens' };
-    }
-    if (promptName.includes('fetch-price-history') || promptName.includes('fetch-all-price-history')) {
-      return { tokenId: 'Token|Unit|GUSDC|eth:0x1234567890123456789012345678901234567890' };
-    }
-    if (promptName.includes('fetch-token-details')) {
-      return { tokenId: 'Token|Unit|GUSDC|eth:0x1234567890123456789012345678901234567890' };
-    }
-    return {}; // For prompts with no required args (portfolio, balance, my-positions, version, etc.)
-  }
-
-  describe('MCP Protocol Compliance', () => {
-    it.each(prompts)('$name should have required fields', (prompt) => {
-      expect(prompt).toHaveProperty('name');
-      expect(prompt).toHaveProperty('description');
-      expect(prompt).toHaveProperty('handler');
-      expect(typeof prompt.name).toBe('string');
-      expect(typeof prompt.description).toBe('string');
-      expect(typeof prompt.handler).toBe('function');
-    });
-
-    it.each(prompts)('$name should have valid argument structure', (prompt) => {
-      if (prompt.arguments) {
-        expect(Array.isArray(prompt.arguments)).toBe(true);
-        prompt.arguments.forEach((arg) => {
-          expect(arg).toHaveProperty('name');
-          expect(arg).toHaveProperty('description');
-          expect(arg).toHaveProperty('required');
-          expect(typeof arg.name).toBe('string');
-          expect(typeof arg.description).toBe('string');
-          expect(typeof arg.required).toBe('boolean');
-        });
-      }
-    });
-
-    it.each(prompts)('$name handler should return PromptMessage array', (prompt) => {
-      const args = getValidArgsForPrompt(prompt.name);
-      const messages = prompt.handler(args);
-      expect(Array.isArray(messages)).toBe(true);
-      expect(messages.length).toBeGreaterThan(0);
-    });
-
-    it.each(prompts)('$name messages should have valid structure', (prompt) => {
-      const args = getValidArgsForPrompt(prompt.name);
-      const messages = prompt.handler(args);
-      messages.forEach((msg) => {
-        expect(msg).toHaveProperty('role');
-        expect(msg).toHaveProperty('content');
-        expect(['user', 'assistant']).toContain(msg.role);
-        expect(msg.content).toHaveProperty('type');
-        expect(['text', 'image', 'resource']).toContain(msg.content.type);
-      });
-    });
-  });
-
-  describe('Handler Execution', () => {
-    it('analyze-token handler should accept tokenName', () => {
-      const prompt = prompts.find((p) => p.name === 'galachain-launchpad:analyze-token');
-      expect(() => prompt?.handler({ tokenName: 'anime' })).not.toThrow();
-    });
-
-    it('buy-tokens handler should accept required args', () => {
-      const prompt = prompts.find((p) => p.name === 'galachain-launchpad:buy-tokens');
-      expect(() => prompt?.handler({ tokenName: 'anime', galaAmount: '100' })).not.toThrow();
-    });
-
-    it('graduate-token handler should accept optional slippage', () => {
-      const prompt = prompts.find((p) => p.name === 'galachain-launchpad:graduate-token');
-      expect(() => prompt?.handler({ tokenName: 'anime', slippage: '2' })).not.toThrow();
-    });
-  });
-
-  describe('Message Content', () => {
-    it.each(prompts)('$name should generate non-empty text content', (prompt) => {
-      const args = getValidArgsForPrompt(prompt.name);
-      const messages = prompt.handler(args);
-      messages.forEach((msg) => {
-        if (msg.content.type === 'text') {
-          expect(msg.content.text).toBeDefined();
-          expect(msg.content.text!.length).toBeGreaterThan(10);
-        }
-      });
-    });
-
-    it.each(prompts)('$name should reference MCP tools in instructions', (prompt) => {
-      const args = getValidArgsForPrompt(prompt.name);
-      const messages = prompt.handler(args);
-      const text = messages[0].content.text || '';
-      // Should contain at least one tool reference
-      expect(text).toMatch(/gala_launchpad_/);
-    });
-  });
-});

package/src/prompts/__tests__/registry.test.ts

@@ -1,349 +0,0 @@
-/**
- * Prompt Registry Tests
- *
- * Tests for prompt registration, lookup, and utility functions
- * Updated to validate 72 total slash commands with 1:1 tool mapping
- */
-
-import {
-  prompts,
-  getPrompt,
-  getPromptNames,
-  hasPrompt,
-  getPromptsByCategory,
-  getPromptCount,
-} from '../index';
-
-describe('Prompt Registry', () => {
-  describe('prompts array', () => {
-    it('should contain exactly 74 prompts (1:1 tool-to-command mapping)', () => {
-      expect(prompts).toHaveLength(74);
-    });
-
-    it('should have all unique prompt names', () => {
-      const names = prompts.map((p) => p.name);
-      const uniqueNames = new Set(names);
-      expect(uniqueNames.size).toBe(names.length);
-      expect(uniqueNames.size).toBe(74);
-    });
-
-    it('should have all prompts with galachain-launchpad prefix', () => {
-      prompts.forEach((prompt) => {
-        expect(prompt.name).toMatch(/^galachain-launchpad:/);
-      });
-    });
-  });
-
-  describe('getPrompt()', () => {
-    it('should return prompt for valid name', () => {
-      const prompt = getPrompt('galachain-launchpad:analyze-token');
-      expect(prompt).toBeDefined();
-      expect(prompt?.name).toBe('galachain-launchpad:analyze-token');
-    });
-
-    it('should return undefined for invalid name', () => {
-      const prompt = getPrompt('non-existent-prompt');
-      expect(prompt).toBeUndefined();
-    });
-
-    it('should find new trading calculation prompts', () => {
-      const calculationPrompts = [
-        'galachain-launchpad:calculate-buy-amount',
-        'galachain-launchpad:calculate-sell-amount',
-        'galachain-launchpad:calculate-graduation-cost',
-        'galachain-launchpad:calculate-buy-amount-local',
-        'galachain-launchpad:calculate-buy-amount-external',
-        'galachain-launchpad:calculate-sell-amount-local',
-        'galachain-launchpad:calculate-sell-amount-external',
-      ];
-
-      calculationPrompts.forEach((name) => {
-        const prompt = getPrompt(name);
-        expect(prompt).toBeDefined();
-        expect(prompt?.name).toBe(name);
-      });
-    });
-
-    it('should find new pool management prompts', () => {
-      const poolPrompts = [
-        'galachain-launchpad:fetch-pools',
-        'galachain-launchpad:fetch-pool-details-for-calculation',
-        'galachain-launchpad:fetch-token-details',
-        'galachain-launchpad:fetch-token-distribution',
-        'galachain-launchpad:fetch-token-badges',
-        'galachain-launchpad:fetch-volume-data',
-        'galachain-launchpad:fetch-gala-spot-price',
-        'galachain-launchpad:fetch-price-history',
-        'galachain-launchpad:fetch-all-price-history',
-        'galachain-launchpad:check-token-name',
-        'galachain-launchpad:check-token-symbol',
-        'galachain-launchpad:resolve-vault-address',
-        'galachain-launchpad:resolve-token-class-key',
-      ];
-
-      poolPrompts.forEach((name) => {
-        const prompt = getPrompt(name);
-        expect(prompt).toBeDefined();
-        expect(prompt?.name).toBe(name);
-      });
-    });
-
-    it('should find new balance prompts', () => {
-      const balancePrompts = [
-        'galachain-launchpad:fetch-gala-balance',
-        'galachain-launchpad:fetch-token-balance',
-        'galachain-launchpad:fetch-tokens-created',
-        'galachain-launchpad:update-profile',
-      ];
-
-      balancePrompts.forEach((name) => {
-        const prompt = getPrompt(name);
-        expect(prompt).toBeDefined();
-        expect(prompt?.name).toBe(name);
-      });
-    });
-
-    it('should find new utility tool prompts', () => {
-      const utilityPrompts = [
-        'galachain-launchpad:create-wallet',
-        'galachain-launchpad:get-address',
-        'galachain-launchpad:get-ethereum-address',
-        'galachain-launchpad:get-config',
-        'galachain-launchpad:get-url-by-token-name',
-        'galachain-launchpad:explain-sdk-usage',
-        'galachain-launchpad:get-cache-info',
-        'galachain-launchpad:clear-cache',
-        'galachain-launchpad:has-wallet',
-        'galachain-launchpad:get-wallet',
-        'galachain-launchpad:set-wallet',
-        'galachain-launchpad:get-environment',
-      ];
-
-      utilityPrompts.forEach((name) => {
-        const prompt = getPrompt(name);
-        expect(prompt).toBeDefined();
-        expect(prompt?.name).toBe(name);
-      });
-    });
-
-    it('should find new social prompts', () => {
-      const socialPrompts = [
-        'galachain-launchpad:post-comment',
-        'galachain-launchpad:fetch-comments',
-      ];
-
-      socialPrompts.forEach((name) => {
-        const prompt = getPrompt(name);
-        expect(prompt).toBeDefined();
-        expect(prompt?.name).toBe(name);
-      });
-    });
-
-    it('should find new transfer prompts', () => {
-      const transferPrompts = [
-        'galachain-launchpad:transfer-gala',
-        'galachain-launchpad:transfer-token',
-      ];
-
-      transferPrompts.forEach((name) => {
-        const prompt = getPrompt(name);
-        expect(prompt).toBeDefined();
-        expect(prompt?.name).toBe(name);
-      });
-    });
-
-    it('should find new creation utility prompts', () => {
-      const creationPrompts = [
-        'galachain-launchpad:upload-profile-image',
-        'galachain-launchpad:fetch-launch-token-fee',
-      ];
-
-      creationPrompts.forEach((name) => {
-        const prompt = getPrompt(name);
-        expect(prompt).toBeDefined();
-        expect(prompt?.name).toBe(name);
-      });
-    });
-
-    it('should use O(1) Map lookup (performance test)', () => {
-      const iterations = 10000;
-      const start = Date.now();
-
-      for (let i = 0; i < iterations; i++) {
-        getPrompt('galachain-launchpad:analyze-token');
-      }
-
-      const duration = Date.now() - start;
-      // Should complete 10k lookups in under 100ms (Map is O(1))
-      expect(duration).toBeLessThan(100);
-    });
-  });
-
-  describe('getPromptNames()', () => {
-    it('should return array of 74 prompt names', () => {
-      const names = getPromptNames();
-      expect(names).toHaveLength(74);
-    });
-
-    it('should contain all original 24 prompts', () => {
-      const names = getPromptNames();
-      const originalPrompts = [
-        'galachain-launchpad:analyze-token',
-        'galachain-launchpad:buy-tokens',
-        'galachain-launchpad:sell-tokens',
-        'galachain-launchpad:graduate-token',
-        'galachain-launchpad:portfolio',
-        'galachain-launchpad:tokens-held',
-        'galachain-launchpad:tokens-created',
-        'galachain-launchpad:balance',
-        'galachain-launchpad:profile',
-        'galachain-launchpad:compare-tokens',
-        'galachain-launchpad:graduation-status',
-        'galachain-launchpad:spot-prices',
-        'galachain-launchpad:pool-details',
-        'galachain-launchpad:trade-history',
-        'galachain-launchpad:fetch-all-pools',
-        'galachain-launchpad:create-token',
-        'galachain-launchpad:discover-tokens',
-        'galachain-launchpad:dex-swap',
-        'galachain-launchpad:my-positions',
-        'galachain-launchpad:add-liquidity',
-        'galachain-launchpad:remove-liquidity',
-        'galachain-launchpad:collect-fees',
-        'galachain-launchpad:version',
-        'galachain-launchpad:switch-environment',
-      ];
-
-      originalPrompts.forEach((name) => {
-        expect(names).toContain(name);
-      });
-    });
-
-    it('should contain all pool management and trading prompts', () => {
-      const names = getPromptNames();
-      const poolManagementPrompts = [
-        // Pool management (14)
-        'galachain-launchpad:fetch-pools',
-        'galachain-launchpad:fetch-pool-details-for-calculation',
-        'galachain-launchpad:fetch-token-details',
-        'galachain-launchpad:fetch-token-distribution',
-        'galachain-launchpad:fetch-token-badges',
-        'galachain-launchpad:fetch-volume-data',
-        'galachain-launchpad:fetch-gala-spot-price',
-        'galachain-launchpad:fetch-price-history',
-        'galachain-launchpad:fetch-all-price-history',
-        'galachain-launchpad:check-token-name',
-        'galachain-launchpad:check-token-symbol',
-        'galachain-launchpad:resolve-vault-address',
-        'galachain-launchpad:resolve-token-class-key',
-        // Trading calculations (11)
-        'galachain-launchpad:calculate-buy-amount',
-        'galachain-launchpad:calculate-sell-amount',
-        'galachain-launchpad:fetch-trades',
-        'galachain-launchpad:calculate-initial-buy',
-        'galachain-launchpad:get-bundler-transaction-result',
-        'galachain-launchpad:calculate-graduation-cost',
-        'galachain-launchpad:calculate-buy-amount-local',
-        'galachain-launchpad:calculate-buy-amount-external',
-        'galachain-launchpad:calculate-sell-amount-local',
-        'galachain-launchpad:calculate-sell-amount-external',
-        'galachain-launchpad:is-token-graduated',
-        // Balance queries (4)
-        'galachain-launchpad:fetch-gala-balance',
-        'galachain-launchpad:fetch-token-balance',
-        'galachain-launchpad:fetch-tokens-created',
-        'galachain-launchpad:update-profile',
-        // Social (2)
-        'galachain-launchpad:post-comment',
-        'galachain-launchpad:fetch-comments',
-        // Transfers (2)
-        'galachain-launchpad:transfer-gala',
-        'galachain-launchpad:transfer-token',
-        // DEX Pool Discovery (2) - NEW
-        'galachain-launchpad:fetch-dex-pools',
-        'galachain-launchpad:fetch-all-dex-pools',
-      ];
-
-      poolManagementPrompts.forEach((name) => {
-        expect(names).toContain(name);
-      });
-    });
-
-    it('should return names in consistent order', () => {
-      const names1 = getPromptNames();
-      const names2 = getPromptNames();
-      expect(names1).toEqual(names2);
-    });
-  });
-
-  describe('hasPrompt()', () => {
-    it('should return true for existing prompts', () => {
-      expect(hasPrompt('galachain-launchpad:analyze-token')).toBe(true);
-      expect(hasPrompt('galachain-launchpad:buy-tokens')).toBe(true);
-      expect(hasPrompt('galachain-launchpad:calculate-buy-amount')).toBe(true);
-      expect(hasPrompt('galachain-launchpad:fetch-pools')).toBe(true);
-    });
-
-    it('should return false for non-existent prompts', () => {
-      expect(hasPrompt('invalid-prompt')).toBe(false);
-      expect(hasPrompt('')).toBe(false);
-    });
-  });
-
-  describe('getPromptsByCategory()', () => {
-    it('should return trading prompts (4 original)', () => {
-      const trading = getPromptsByCategory('trading');
-      expect(trading.length).toBeGreaterThanOrEqual(4);
-    });
-
-    it('should return portfolio prompts (5)', () => {
-      const portfolio = getPromptsByCategory('portfolio');
-      expect(portfolio).toHaveLength(5);
-    });
-
-    it('should return analysis prompts (6)', () => {
-      const analysis = getPromptsByCategory('analysis');
-      expect(analysis).toHaveLength(6);
-    });
-
-    it('should return creation prompts (1 - create-token)', () => {
-      const creation = getPromptsByCategory('creation');
-      expect(creation).toHaveLength(1);
-      expect(creation[0]?.name).toBe('galachain-launchpad:create-token');
-    });
-
-    it('should return discovery prompts (1 original + 2 new = 3)', () => {
-      const discovery = getPromptsByCategory('discovery');
-      expect(discovery).toHaveLength(3);
-    });
-
-    it('should return dex trading prompts (1)', () => {
-      const dex = getPromptsByCategory('dex');
-      expect(dex).toHaveLength(1);
-    });
-
-    it('should return liquidity position prompts (4)', () => {
-      const liquidity = getPromptsByCategory('liquidity');
-      expect(liquidity).toHaveLength(4);
-    });
-
-    it('should return utility prompts (version + switch-environment)', () => {
-      const utility = getPromptsByCategory('utility');
-      expect(utility).toHaveLength(2);
-      const utilityNames = utility.map(u => u.name);
-      expect(utilityNames).toContain('galachain-launchpad:version');
-      expect(utilityNames).toContain('galachain-launchpad:switch-environment');
-    });
-
-    it('should return empty array for invalid category', () => {
-      const result = getPromptsByCategory('invalid' as any);
-      expect(result).toEqual([]);
-    });
-  });
-
-  describe('getPromptCount()', () => {
-    it('should return 74 (1:1 tool-to-command mapping)', () => {
-      expect(getPromptCount()).toBe(74);
-    });
-  });
-});