@gala-chain/launchpad-mcp-server 1.13.4 → 1.13.5

package/docs/examples/tool-factory-pattern.md

@@ -1,217 +0,0 @@
-# Tool Factory Pattern Examples
-
-Demonstrates how to use `tool-factory.ts` utilities to eliminate duplication. These examples show the before/after comparison for common tool patterns.
-
-**See**: `src/utils/tool-factory.ts`
-
----
-
-## Example 1: Simple Token Fetch Tool (BEFORE vs AFTER)
-
-### ❌ BEFORE: Manual duplication (22 lines)
-
-```typescript
-export const fetchPoolDetailsToolOLD: MCPTool = {
-  name: 'gala_launchpad_fetch_pool_details',
-  description: 'Get detailed pool state from GalaChain bonding curve',
-  inputSchema: {
-    type: 'object',
-    properties: {
-      tokenName: TOKEN_NAME_SCHEMA,
-    },
-    required: ['tokenName'],
-  },
-  handler: withErrorHandling(async (sdk, args) => {
-    const result = await sdk.fetchPoolDetails(args.tokenName);
-    return formatSuccess(result);
-  }),
-};
-```
-
-### ✅ AFTER: Using factory (6 lines - 73% reduction)
-
-```typescript
-export const fetchPoolDetailsToolNEW = createSimpleTokenFetchTool({
-  name: 'gala_launchpad_fetch_pool_details',
-  description: 'Get detailed pool state from GalaChain bonding curve',
-  handler: (sdk, tokenName) => sdk.fetchPoolDetails(tokenName),
-});
-```
-
----
-
-## Example 2: Boolean Check Tool (BEFORE vs AFTER)
-
-### ❌ BEFORE: Manual duplication (25 lines)
-
-```typescript
-export const checkTokenNameToolOLD: MCPTool = {
-  name: 'gala_launchpad_check_token_name',
-  description: 'Check if token name is available',
-  inputSchema: {
-    type: 'object',
-    properties: {
-      tokenName: {
-        type: 'string',
-        pattern: '^[a-z0-9_-]{2,20}$',
-        description: 'Token name to check',
-      },
-    },
-    required: ['tokenName'],
-  },
-  handler: withErrorHandling(async (sdk, args) => {
-    const available = await sdk.isTokenNameAvailable(args.tokenName);
-    return formatBoolean(
-      available,
-      available ? 'Token name is available' : 'Token name is already taken'
-    );
-  }),
-};
-```
-
-### ✅ AFTER: Using factory (10 lines - 60% reduction)
-
-```typescript
-export const checkTokenNameToolNEW = createBooleanCheckTool({
-  name: 'gala_launchpad_check_token_name',
-  description: 'Check if token name is available',
-  paramName: 'tokenName',
-  paramSchema: TOKEN_NAME_SCHEMA,
-  handler: (sdk, tokenName) => sdk.isTokenNameAvailable(tokenName),
-  messages: {
-    true: 'Token name is available',
-    false: 'Token name is already taken',
-  },
-});
-```
-
----
-
-## Example 3: Resolution Tool (BEFORE vs AFTER)
-
-### ❌ BEFORE: Manual duplication (22 lines)
-
-```typescript
-export const resolveVaultAddressToolOLD: MCPTool = {
-  name: 'gala_launchpad_resolve_vault_address',
-  description: 'Get GalaChain vault address for a token (useful for debugging)',
-  inputSchema: {
-    type: 'object',
-    properties: {
-      tokenName: TOKEN_NAME_SCHEMA,
-    },
-    required: ['tokenName'],
-  },
-  handler: withErrorHandling(async (sdk, args) => {
-    const vaultAddress = await sdk.resolveVaultAddress(args.tokenName);
-    return formatSuccess({ tokenName: args.tokenName, vaultAddress });
-  }),
-};
-```
-
-### ✅ AFTER: Using factory (6 lines - 73% reduction)
-
-```typescript
-export const resolveVaultAddressToolNEW = createResolutionTool({
-  name: 'gala_launchpad_resolve_vault_address',
-  description: 'Get GalaChain vault address for a token (useful for debugging)',
-  resolver: (sdk, tokenName) => sdk.resolveVaultAddress(tokenName),
-  resultKey: 'vaultAddress',
-});
-```
-
----
-
-## Example 4: Complex Fetch Tool with Custom Schema (BEFORE vs AFTER)
-
-### ❌ BEFORE: Manual duplication (28 lines)
-
-```typescript
-export const fetchPoolsToolOLD: MCPTool = {
-  name: 'gala_launchpad_fetch_pools',
-  description: 'Fetch token pools from Gala Launchpad with filtering and pagination',
-  inputSchema: {
-    type: 'object',
-    properties: {
-      type: {
-        type: 'string',
-        enum: Object.values(POOL_TYPES),
-        description: 'Type of pools to fetch (default: recent)',
-      },
-      page: PAGE_SCHEMA,
-      limit: createLimitSchema('pool', 20),
-    },
-  },
-  handler: withErrorHandling(async (sdk, args) => {
-    const result = await sdk.fetchPools({
-      type: args.type || 'recent',
-      page: args.page || 1,
-      limit: args.limit || 20,
-    });
-    return formatSuccess(result);
-  }),
-};
-```
-
-### ✅ AFTER: Using factory (21 lines - 25% reduction)
-
-```typescript
-export const fetchPoolsToolNEW = createFetchTool({
-  name: 'gala_launchpad_fetch_pools',
-  description: 'Fetch token pools from Gala Launchpad with filtering and pagination',
-  inputSchema: {
-    type: 'object',
-    properties: {
-      type: {
-        type: 'string',
-        enum: Object.values(POOL_TYPES),
-        description: 'Type of pools to fetch (default: recent)',
-      },
-      page: PAGE_SCHEMA,
-      limit: createLimitSchema('pool', 20),
-    },
-  },
-  handler: (sdk, args) =>
-    sdk.fetchPools({
-      type: args.type || 'recent',
-      page: args.page || 1,
-      limit: args.limit || 20,
-    }),
-});
-```
-
----
-
-## Summary Statistics
-
-### IMPACT ANALYSIS:
-
-**Tools that can use createSimpleTokenFetchTool (73% reduction):**
-- fetchPoolDetailsTool
-- fetchTokenDistributionTool
-- fetchTokenBadgesTool
-- Total: ~15 tools across the codebase
-
-**Tools that can use createBooleanCheckTool (60% reduction):**
-- checkTokenNameTool
-- checkTokenSymbolTool
-- isTokenGraduatedTool
-- Total: ~3 tools
-
-**Tools that can use createResolutionTool (73% reduction):**
-- resolveVaultAddressTool
-- resolveTokenClassKeyTool
-- Total: ~2 tools
-
-**Tools that can use createFetchTool (25% reduction):**
-- fetchPoolsTool
-- fetchTradesTool
-- fetchTokensHeldTool
-- fetchTokensCreatedTool
-- Total: ~10 tools
-
-### OVERALL IMPACT:
-- ~30 out of 47 tools can use factory pattern
-- Average reduction: 50% fewer lines per tool
-- Total saved: ~500-700 lines of duplicated code
-- Improved maintainability: Changes to error handling, formatting, etc. only need to be made once

package/jest.config.js

@@ -1,94 +0,0 @@
-/**
- * Jest Configuration for Gala Launchpad MCP Server
- *
- * TypeScript-first testing configuration with comprehensive coverage thresholds
- */
-
-module.exports = {
-  // Use ts-jest for TypeScript support
-  preset: 'ts-jest',
-
-  // Node.js environment (MCP server is server-side)
-  testEnvironment: 'node',
-
-  // Test file location patterns
-  roots: ['<rootDir>/src'],
-  testMatch: [
-    '**/__tests__/**/*.test.ts',
-    '**/__tests__/**/*.spec.ts',
-  ],
-
-  // Coverage collection
-  collectCoverageFrom: [
-    'src/**/*.ts',
-    '!src/**/__tests__/**',
-    '!src/**/*.d.ts',
-    '!src/index.ts', // Entry point - covered by integration tests
-  ],
-
-  // Coverage thresholds disabled for mixed codebase
-  // Note: New code has 92%+ coverage (validation.ts, prompt refactoring)
-  // Existing tools (47 MCP tools) are tested via integration, not unit tests
-  // This is intentional - unit testing tools would require mocking entire SDK
-  //
-  // Coverage Summary:
-  // - validation.ts: 92% branches, 100% functions, 91% lines (EXCELLENT)
-  // - Prompt tests: 119/119 passing with comprehensive edge cases
-  // - Overall: 30% due to untested tools (tested via real SDK integration)
-  //
-  // Uncomment below to enforce thresholds when tool coverage is added:
-  // coverageThreshold: {
-  //   global: { branches: 80, functions: 80, lines: 80, statements: 80 },
-  // },
-
-  // Coverage reporters
-  coverageReporters: ['text', 'text-summary', 'html', 'lcov'],
-
-  // Module path aliases and extension mapping
-  moduleNameMapper: {
-    '^@/(.*)$': '<rootDir>/src/$1',
-    '^(\\.{1,2}/.*)\\.js$': '$1', // Map .js imports to .ts files
-  },
-
-  // Transform files with ts-jest
-  transform: {
-    '^.+\\.ts$': ['ts-jest', {
-      tsconfig: {
-        // Use ES modules
-        module: 'commonjs',
-        // Ensure strict type checking in tests
-        strict: true,
-        esModuleInterop: true,
-        skipLibCheck: true,
-      },
-    }],
-  },
-
-  // File extensions to consider
-  moduleFileExtensions: ['ts', 'tsx', 'js', 'jsx', 'json'],
-
-  // Ignore patterns
-  testPathIgnorePatterns: [
-    '/node_modules/',
-    '/dist/',
-    '/.history/',
-    '/integration/', // Integration tests have their own config
-  ],
-
-  // Transform ESM packages in node_modules
-  transformIgnorePatterns: [
-    'node_modules/(?!(uuid|@gala-chain)/)',
-  ],
-
-  // Setup files (if needed for global test setup)
-  // setupFilesAfterEnv: ['<rootDir>/src/__tests__/setup.ts'],
-
-  // Clear mocks between tests
-  clearMocks: true,
-
-  // Verbose output
-  verbose: true,
-
-  // Maximum worker threads (optimize for CI/CD)
-  maxWorkers: '50%',
-};

package/src/__tests__/integration/poolTools.integration.test.ts

@@ -1,185 +0,0 @@
-/**
- * Integration Tests for Pool Tools
- *
- * These tests use real SDK instances and make actual API calls.
- * Requires valid PRIVATE_KEY environment variable.
- *
- * Run with: npm run test:integration
- */
-
-import { AgentConfig } from '@gala-chain/launchpad-sdk';
-import { fetchPoolsTool, fetchPoolDetailsTool } from '../../tools/pools/index.js';
-
-describe('Pool Tools Integration', () => {
-  let sdk: any;
-
-  beforeAll(async () => {
-    // Skip tests if no private key available
-    if (!process.env.PRIVATE_KEY) {
-      console.warn('⚠️  Skipping integration tests: PRIVATE_KEY environment variable not set');
-      return;
-    }
-
-    // Initialize SDK with AgentConfig
-    const { sdk: initializedSdk } = await AgentConfig.quickSetup({
-      environment: (process.env.ENVIRONMENT as any) || 'development',
-      privateKey: process.env.PRIVATE_KEY,
-      timeout: 30000,
-      debug: false,
-      autoValidate: false,
-    });
-
-    sdk = initializedSdk;
-  });
-
-  afterAll(() => {
-    if (sdk) {
-      sdk.cleanup();
-    }
-  });
-
-  describe('fetchPoolsTool', () => {
-    it('should fetch recent pools successfully', async () => {
-      if (!sdk) {
-        return; // Skip if SDK not initialized
-      }
-
-      const result = await fetchPoolsTool.handler(sdk, {
-        type: 'recent',
-        limit: 5,
-        page: 1,
-      });
-
-      expect(result).toBeDefined();
-      expect(result.content).toBeDefined();
-      expect(Array.isArray(result.content)).toBe(true);
-      expect(result.content.length).toBeGreaterThan(0);
-
-      const response = JSON.parse(result.content[0].text!);
-      expect(response).toHaveProperty('pools');
-      expect(Array.isArray(response.pools)).toBe(true);
-      expect(response.pools.length).toBeLessThanOrEqual(5);
-    });
-
-    it('should fetch popular pools successfully', async () => {
-      if (!sdk) {
-        return;
-      }
-
-      const result = await fetchPoolsTool.handler(sdk, {
-        type: 'popular',
-        limit: 3,
-        page: 1,
-      });
-
-      expect(result).toBeDefined();
-      const response = JSON.parse(result.content[0].text!);
-      expect(response).toHaveProperty('pools');
-      expect(response.pools.length).toBeLessThanOrEqual(3);
-    });
-
-    it('should handle pagination correctly', async () => {
-      if (!sdk) {
-        return;
-      }
-
-      const page1 = await fetchPoolsTool.handler(sdk, {
-        type: 'recent',
-        limit: 2,
-        page: 1,
-      });
-
-      const page2 = await fetchPoolsTool.handler(sdk, {
-        type: 'recent',
-        limit: 2,
-        page: 2,
-      });
-
-      const response1 = JSON.parse(page1.content[0].text!);
-      const response2 = JSON.parse(page2.content[0].text!);
-
-      expect(response1.page).toBe(1);
-      expect(response2.page).toBe(2);
-
-      // Different pools on different pages
-      if (response1.pools.length > 0 && response2.pools.length > 0) {
-        expect(response1.pools[0].name).not.toBe(response2.pools[0].name);
-      }
-    });
-  });
-
-  describe('fetchPoolDetailsTool', () => {
-    it('should fetch pool details for a known token', async () => {
-      if (!sdk) {
-        return;
-      }
-
-      // First get a pool name from recent pools
-      const pools = await fetchPoolsTool.handler(sdk, {
-        type: 'recent',
-        limit: 1,
-        page: 1,
-      });
-
-      const poolsResponse = JSON.parse(pools.content[0].text!);
-
-      if (poolsResponse.pools.length === 0) {
-        console.warn('⚠️  No pools available for testing');
-        return;
-      }
-
-      const tokenName = poolsResponse.pools[0].name;
-
-      // Fetch details for that token
-      const result = await fetchPoolDetailsTool.handler(sdk, {
-        tokenName,
-      });
-
-      expect(result).toBeDefined();
-      const response = JSON.parse(result.content[0].text!);
-
-      expect(response).toHaveProperty('name', tokenName);
-      expect(response).toHaveProperty('symbol');
-      expect(response).toHaveProperty('saleStatus');
-      expect(response).toHaveProperty('currentSupply');
-      expect(response).toHaveProperty('maxSupply');
-    });
-
-    it('should handle non-existent token gracefully', async () => {
-      if (!sdk) {
-        return;
-      }
-
-      const result = await fetchPoolDetailsTool.handler(sdk, {
-        tokenName: 'nonexistenttoken123456',
-      });
-
-      // Should return error response
-      expect(result).toBeDefined();
-      expect(result.isError).toBe(true);
-    });
-  });
-
-  describe('MCP Response Format', () => {
-    it('should return valid MCP response structure', async () => {
-      if (!sdk) {
-        return;
-      }
-
-      const result = await fetchPoolsTool.handler(sdk, {
-        type: 'recent',
-        limit: 1,
-        page: 1,
-      });
-
-      // Validate MCP response structure
-      expect(result).toHaveProperty('content');
-      expect(Array.isArray(result.content)).toBe(true);
-      expect(result.content[0]).toHaveProperty('type', 'text');
-      expect(result.content[0]).toHaveProperty('text');
-
-      // Validate JSON parseable
-      expect(() => JSON.parse(result.content[0].text!)).not.toThrow();
-    });
-  });
-});

package/src/constants/mcpToolNames.ts

@@ -1,141 +0,0 @@
-/**
- * MCP Tool Name Constants
- *
- * Centralized constants for all Gala Launchpad MCP tool names.
- * Use these constants instead of hardcoded strings to prevent typos
- * and enable IDE autocomplete.
- *
- * Total: 48 tools across 7 categories
- */
-
-/**
- * Pool Management & Pricing Tools (13 tools)
- */
-export const POOL_TOOLS = {
-  FETCH_POOLS: 'gala_launchpad_fetch_pools',
-  FETCH_ALL_POOLS: 'gala_launchpad_fetch_all_pools',
-  FETCH_POOL_DETAILS: 'gala_launchpad_fetch_pool_details',
-  FETCH_POOL_DETAILS_FOR_CALCULATION: 'gala_launchpad_fetch_pool_details_for_calculation',
-  FETCH_TOKEN_DISTRIBUTION: 'gala_launchpad_fetch_token_distribution',
-  FETCH_TOKEN_BADGES: 'gala_launchpad_fetch_token_badges',
-  FETCH_VOLUME_DATA: 'gala_launchpad_fetch_volume_data',
-  FETCH_GALA_SPOT_PRICE: 'gala_launchpad_fetch_gala_spot_price',
-  FETCH_TOKEN_SPOT_PRICE: 'gala_launchpad_fetch_token_spot_price',
-  FETCH_LAUNCHPAD_TOKEN_SPOT_PRICE: 'gala_launchpad_fetch_launchpad_token_spot_price',
-  CHECK_TOKEN_NAME: 'gala_launchpad_check_token_name',
-  CHECK_TOKEN_SYMBOL: 'gala_launchpad_check_token_symbol',
-  IS_TOKEN_GRADUATED: 'gala_launchpad_is_token_graduated',
-} as const;
-
-/**
- * Trading Operations Tools (9 tools)
- */
-export const TRADING_TOOLS = {
-  CALCULATE_BUY_AMOUNT: 'gala_launchpad_calculate_buy_amount',
-  CALCULATE_BUY_AMOUNT_LOCAL: 'gala_launchpad_calculate_buy_amount_local',
-  CALCULATE_BUY_AMOUNT_EXTERNAL: 'gala_launchpad_calculate_buy_amount_external',
-  CALCULATE_SELL_AMOUNT: 'gala_launchpad_calculate_sell_amount',
-  CALCULATE_SELL_AMOUNT_LOCAL: 'gala_launchpad_calculate_sell_amount_local',
-  CALCULATE_SELL_AMOUNT_EXTERNAL: 'gala_launchpad_calculate_sell_amount_external',
-  CALCULATE_BUY_AMOUNT_FOR_GRADUATION: 'gala_launchpad_calculate_buy_amount_for_graduation',
-  BUY_TOKENS: 'gala_launchpad_buy_tokens',
-  SELL_TOKENS: 'gala_launchpad_sell_tokens',
-  GRADUATE_TOKEN: 'gala_launchpad_graduate_token',
-  FETCH_TRADES: 'gala_launchpad_fetch_trades',
-  GET_BUNDLER_TRANSACTION_RESULT: 'gala_launchpad_get_bundler_transaction_result',
-} as const;
-
-/**
- * Balance & Portfolio Tools (6 tools)
- */
-export const BALANCE_TOOLS = {
-  FETCH_GALA_BALANCE: 'gala_launchpad_fetch_gala_balance',
-  FETCH_TOKEN_BALANCE: 'gala_launchpad_fetch_token_balance',
-  FETCH_TOKENS_HELD: 'gala_launchpad_fetch_tokens_held',
-  FETCH_TOKENS_CREATED: 'gala_launchpad_fetch_tokens_created',
-  FETCH_PROFILE: 'gala_launchpad_fetch_profile',
-  UPDATE_PROFILE: 'gala_launchpad_update_profile',
-} as const;
-
-/**
- * Token Creation Tools (4 tools)
- */
-export const CREATION_TOOLS = {
-  LAUNCH_TOKEN: 'gala_launchpad_launch_token',
-  UPLOAD_TOKEN_IMAGE: 'gala_launchpad_upload_token_image',
-  UPLOAD_PROFILE_IMAGE: 'gala_launchpad_upload_profile_image',
-  FETCH_LAUNCH_TOKEN_FEE: 'gala_launchpad_fetch_launch_token_fee',
-  CALCULATE_INITIAL_BUY: 'gala_launchpad_calculate_initial_buy',
-} as const;
-
-/**
- * Social & Comments Tools (2 tools)
- */
-export const SOCIAL_TOOLS = {
-  POST_COMMENT: 'gala_launchpad_post_comment',
-  FETCH_COMMENTS: 'gala_launchpad_fetch_comments',
-} as const;
-
-/**
- * Token Transfer Tools (2 tools)
- */
-export const TRANSFER_TOOLS = {
-  TRANSFER_GALA: 'gala_launchpad_transfer_gala',
-  TRANSFER_TOKEN: 'gala_launchpad_transfer_token',
-} as const;
-
-/**
- * Utility Tools (6 tools)
- */
-export const UTILITY_TOOLS = {
-  CREATE_WALLET: 'gala_launchpad_create_wallet',
-  GET_ADDRESS: 'gala_launchpad_get_address',
-  GET_ETHEREUM_ADDRESS: 'gala_launchpad_get_ethereum_address',
-  GET_CONFIG: 'gala_launchpad_get_config',
-  GET_URL_BY_TOKEN_NAME: 'gala_launchpad_get_url_by_token_name',
-  RESOLVE_TOKEN_CLASS_KEY: 'gala_launchpad_resolve_token_class_key',
-  RESOLVE_VAULT_ADDRESS: 'gala_launchpad_resolve_vault_address',
-  EXPLAIN_SDK_USAGE: 'gala_launchpad_explain_sdk_usage',
-} as const;
-
-/**
- * All MCP Tools - Flat structure for easy access
- *
- * Use specific category constants above for better organization,
- * or use this flat object for backwards compatibility.
- */
-export const MCP_TOOLS = {
-  // Pool Management & Pricing
-  ...POOL_TOOLS,
-  // Trading Operations
-  ...TRADING_TOOLS,
-  // Balance & Portfolio
-  ...BALANCE_TOOLS,
-  // Token Creation
-  ...CREATION_TOOLS,
-  // Social & Comments
-  ...SOCIAL_TOOLS,
-  // Token Transfers
-  ...TRANSFER_TOOLS,
-  // Utilities
-  ...UTILITY_TOOLS,
-} as const;
-
-/**
- * Type helper for tool names
- */
-export type MCPToolName = (typeof MCP_TOOLS)[keyof typeof MCP_TOOLS];
-
-/**
- * Get all tool names as an array
- */
-export function getAllToolNames(): string[] {
-  return Object.values(MCP_TOOLS);
-}
-
-/**
- * Check if a string is a valid MCP tool name
- */
-export function isValidToolName(name: string): name is MCPToolName {
-  return getAllToolNames().includes(name);
-}

package/src/index.ts

@@ -1,19 +0,0 @@
-#!/usr/bin/env node
-/**
- * Gala Launchpad MCP Server Entry Point
- */
-
-import { LaunchpadMCPServer } from './server.js';
-
-async function main() {
-  const server = new LaunchpadMCPServer();
-
-  try {
-    await server.start();
-  } catch (error) {
-    console.error('[MCP Server] Fatal error:', error);
-    process.exit(1);
-  }
-}
-
-main();