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

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

@@ -0,0 +1,187 @@
+/**
+ * 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

@@ -0,0 +1,349 @@
+/**
+ * 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);
+    });
+  });
+});