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

package/dist/utils/error-templates.js

@@ -0,0 +1,244 @@
+"use strict";
+/**
+ * Error Message Templates
+ *
+ * Centralized error messages with AI-friendly tips for common error patterns.
+ * Eliminates duplication and ensures consistent error messaging.
+ *
+ * @see Phase 3.3 of refactoring plan
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.errorTemplates = exports.ERROR_TEMPLATES = exports.GENERIC_VALIDATION_ERROR = exports.SOCIAL_URL_ERROR = exports.TRADE_TYPE_ERROR = exports.SLIPPAGE_ERROR = exports.TRADE_TIMEOUT_ERROR = exports.ADDRESS_FORMAT_ERROR = exports.TOKEN_SYMBOL_ERROR = exports.TOKEN_NAME_ERROR = exports.LIMIT_ERRORS = void 0;
+exports.findErrorTemplate = findErrorTemplate;
+exports.getErrorTip = getErrorTip;
+exports.enhanceErrorMessage = enhanceErrorMessage;
+exports.getErrorCategory = getErrorCategory;
+// =============================================================================
+// Validation Error Templates
+// =============================================================================
+/**
+ * Limit validation errors
+ */
+exports.LIMIT_ERRORS = {
+    trade: {
+        pattern: /Limit must be.*20/,
+        tip: `💡 AI TIP: Trade and user operations have a maximum limit of 20. Use:
+- gala_launchpad_fetch_trades: limit ≤ 20
+- gala_launchpad_fetch_tokens_held: limit ≤ 20
+- gala_launchpad_fetch_tokens_created: limit ≤ 20
+
+See docs/CONSTRAINTS-REFERENCE.md for details.`,
+        category: 'validation',
+    },
+    comment: {
+        pattern: /Limit must be.*50/,
+        tip: `💡 AI TIP: Comment operations have a maximum limit of 50. Use:
+- gala_launchpad_fetch_comments: limit ≤ 50
+
+See docs/CONSTRAINTS-REFERENCE.md for details.`,
+        category: 'validation',
+    },
+    pool: {
+        pattern: /Limit must be.*100/,
+        tip: `💡 AI TIP: Pool operations have a maximum limit of 100. Use:
+- gala_launchpad_fetch_pools: limit ≤ 100
+
+See docs/CONSTRAINTS-REFERENCE.md for details.`,
+        category: 'validation',
+    },
+};
+/**
+ * Token name validation errors
+ */
+exports.TOKEN_NAME_ERROR = {
+    pattern: /token name.*(invalid|validation)/i,
+    tip: `💡 AI TIP: Token names must match pattern ^[a-z0-9_-]{2,20}$:
+- Lowercase letters and numbers only
+- Dashes and underscores allowed
+- Length: 2-20 characters
+- Valid examples: 'mytoken', 'test-token', 'token_123'
+- Invalid: 'MyToken' (uppercase), 'a' (too short), 'my token' (space)`,
+    category: 'validation',
+};
+/**
+ * Token symbol validation errors
+ */
+exports.TOKEN_SYMBOL_ERROR = {
+    pattern: /token symbol.*(invalid|validation)/i,
+    tip: `💡 AI TIP: Token symbols must match pattern ^[A-Z0-9]{2,10}$:
+- Uppercase letters and numbers only
+- No special characters
+- Length: 2-10 characters
+- Valid examples: 'MTK', 'TEST123', 'ABC'
+- Invalid: 'mtk' (lowercase), 'A' (too short), 'MY-TOKEN' (dash)`,
+    category: 'validation',
+};
+/**
+ * Wallet address format errors
+ */
+exports.ADDRESS_FORMAT_ERROR = {
+    pattern: /address.*(format|validation)/i,
+    tip: `💡 AI TIP: Wallet addresses must use format:
+- Backend API: 'eth|{40-hex-chars}' (e.g., 'eth|abc123...')
+- Convert from standard: address.startsWith('0x') ? \`eth|\${address.slice(2)}\` : address
+- Most MCP tools expect 'eth|...' format`,
+    category: 'format',
+};
+// =============================================================================
+// Trading Error Templates
+// =============================================================================
+/**
+ * WebSocket/trade timeout errors
+ */
+exports.TRADE_TIMEOUT_ERROR = {
+    pattern: /(timeout|WebSocket)/i,
+    tip: `💡 AI TIP: Trade execution timeouts often indicate incorrect expectedAmount parameter.
+
+✅ CORRECT WORKFLOW:
+1. Call calculate_buy_amount() or calculate_sell_amount()
+2. Extract result.amount from response (e.g., "16843.7579794843252")
+3. Use result.amount as expectedAmount in buy() or sell()
+
+❌ WRONG: Using your input amount as expectedAmount
+✅ RIGHT: Using calculated result.amount as expectedAmount
+
+See docs/AI-AGENT-PATTERNS.md section "Gotcha #1" for examples.`,
+    category: 'timeout',
+};
+/**
+ * Slippage/amount errors
+ */
+exports.SLIPPAGE_ERROR = {
+    pattern: /(slippage|amount.*expected)/i,
+    tip: `💡 AI TIP: expectedAmount must be the calculated output from calculate functions, NOT your input amount.
+
+Example:
+const calc = await calculateBuyAmount({ amount: '10', type: 'native', ... });
+// calc.amount = "16843.7579794843252" <- Use THIS as expectedAmount
+await buy({ amount: '10', expectedAmount: calc.amount, ... });
+
+See docs/AI-AGENT-PATTERNS.md for complete trading workflow.`,
+    category: 'business-logic',
+};
+/**
+ * Type parameter confusion
+ */
+exports.TRADE_TYPE_ERROR = {
+    pattern: /type.*(native|token)/i,
+    tip: `💡 AI TIP: Trading type parameter:
+- 'native': You specify GALA amount (most common)
+  Example: "I want to spend 10 GALA" → type: 'native', amount: '10'
+- 'exact': You specify exact token amount
+  Example: "I want to buy exactly 1000 tokens" → type: 'exact', amount: '1000'
+
+See docs/AI-AGENT-PATTERNS.md section "Gotcha #3" for details.`,
+    category: 'validation',
+};
+// =============================================================================
+// Token Creation Error Templates
+// =============================================================================
+/**
+ * Social URL requirement errors
+ */
+exports.SOCIAL_URL_ERROR = {
+    pattern: /(social|URL.*required)/i,
+    tip: `💡 AI TIP: Token launch requires at least ONE social URL:
+- websiteUrl (e.g., 'https://mytoken.com')
+- twitterUrl (e.g., 'https://twitter.com/mytoken')
+- telegramUrl (e.g., 'https://t.me/mytoken')
+
+Provide at least one in launchToken() call.`,
+    category: 'validation',
+};
+// =============================================================================
+// Generic Error Templates
+// =============================================================================
+/**
+ * Generic validation error
+ */
+exports.GENERIC_VALIDATION_ERROR = {
+    pattern: /(validation|invalid)/i,
+    tip: `💡 AI TIP: Check parameter formats in docs/AI-AGENT-PATTERNS.md
+Common validation rules:
+- tokenName: ^[a-z0-9_-]{2,20}$ (lowercase, 2-20 chars)
+- tokenSymbol: ^[A-Z0-9]{2,10}$ (uppercase, 2-10 chars)
+- address: 'eth|...' or '0x...' format (auto-normalized)
+- amount: ^[0-9.]+$ (decimal string)
+- limits: See CONSTRAINTS-REFERENCE.md`,
+    category: 'validation',
+};
+// =============================================================================
+// Error Template Registry
+// =============================================================================
+/**
+ * All error templates in priority order (checked sequentially)
+ */
+exports.ERROR_TEMPLATES = [
+    // Specific errors first (higher priority)
+    exports.LIMIT_ERRORS.trade,
+    exports.LIMIT_ERRORS.comment,
+    exports.LIMIT_ERRORS.pool,
+    exports.TOKEN_NAME_ERROR,
+    exports.TOKEN_SYMBOL_ERROR,
+    exports.ADDRESS_FORMAT_ERROR,
+    exports.TRADE_TIMEOUT_ERROR,
+    exports.SLIPPAGE_ERROR,
+    exports.TRADE_TYPE_ERROR,
+    exports.SOCIAL_URL_ERROR,
+    // Generic errors last (lower priority)
+    exports.GENERIC_VALIDATION_ERROR,
+];
+// =============================================================================
+// Template Matching Functions
+// =============================================================================
+/**
+ * Finds the best matching error template for a message
+ */
+function findErrorTemplate(message) {
+    for (const template of exports.ERROR_TEMPLATES) {
+        const pattern = template.pattern;
+        if (typeof pattern === 'string') {
+            if (message.includes(pattern)) {
+                return template;
+            }
+        }
+        else if (pattern instanceof RegExp) {
+            if (pattern.test(message)) {
+                return template;
+            }
+        }
+    }
+    return null;
+}
+/**
+ * Gets the AI-friendly tip for an error message
+ */
+function getErrorTip(message) {
+    const template = findErrorTemplate(message);
+    return template ? template.tip : null;
+}
+/**
+ * Applies AI-friendly tip to error message
+ */
+function enhanceErrorMessage(message) {
+    const tip = getErrorTip(message);
+    return tip ? `${message}\n\n${tip}` : message;
+}
+/**
+ * Gets error category for an error message
+ */
+function getErrorCategory(message) {
+    const template = findErrorTemplate(message);
+    return template ? template.category : 'unknown';
+}
+// =============================================================================
+// Export All
+// =============================================================================
+exports.errorTemplates = {
+    templates: exports.ERROR_TEMPLATES,
+    findTemplate: findErrorTemplate,
+    getTip: getErrorTip,
+    enhance: enhanceErrorMessage,
+    getCategory: getErrorCategory,
+};
+//# sourceMappingURL=error-templates.js.map

package/dist/utils/error-templates.js.map

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

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

@@ -0,0 +1,154 @@
+/**
+ * Tool Factory Pattern Utilities
+ *
+ * DRY utilities for creating MCP tools with common patterns.
+ * Eliminates duplication across 47 tool definitions.
+ *
+ * @see Phase 2.1 of refactoring plan
+ */
+import type { MCPTool } from '../types/mcp.js';
+import type { LaunchpadSDK } from '@gala-chain/launchpad-sdk';
+/**
+ * Handler function that takes SDK and args, returns result
+ */
+type ToolHandler<T = any> = (sdk: LaunchpadSDK, args: any) => Promise<T>;
+/**
+ * Simple handler that only needs SDK and tokenName
+ * Can return the result or null
+ */
+type SimpleTokenHandler<T = any> = (sdk: LaunchpadSDK, tokenName: string) => Promise<T | null>;
+/**
+ * Boolean check handler that returns true/false
+ */
+type BooleanCheckHandler = (sdk: LaunchpadSDK, value: string) => Promise<boolean>;
+/**
+ * No-parameter handler that only needs SDK, returns result
+ */
+type NoParamHandler<T = any> = (sdk: LaunchpadSDK) => T | Promise<T>;
+/**
+ * Creates a simple fetch tool that takes tokenName and calls an SDK method
+ *
+ * @example
+ * ```typescript
+ * export const fetchPoolDetailsTool = createSimpleTokenFetchTool({
+ *   name: 'gala_launchpad_fetch_pool_details',
+ *   description: 'Get detailed pool state from GalaChain bonding curve',
+ *   handler: (sdk, tokenName) => sdk.fetchPoolDetails(tokenName),
+ * });
+ * ```
+ */
+export declare function createSimpleTokenFetchTool(config: {
+    name: string;
+    description: string;
+    handler: SimpleTokenHandler;
+}): MCPTool;
+/**
+ * Creates a boolean check tool (e.g., isTokenNameAvailable, isTokenSymbolAvailable)
+ *
+ * @example
+ * ```typescript
+ * export const checkTokenNameTool = 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',
+ *   },
+ * });
+ * ```
+ */
+export declare function createBooleanCheckTool(config: {
+    name: string;
+    description: string;
+    paramName: string;
+    paramSchema: any;
+    handler: BooleanCheckHandler;
+    messages: {
+        true: string;
+        false: string;
+    };
+}): MCPTool;
+/**
+ * Creates a generic fetch tool with custom input schema and handler
+ *
+ * @example
+ * ```typescript
+ * export const fetchPoolsTool = createFetchTool({
+ *   name: 'gala_launchpad_fetch_pools',
+ *   description: 'Fetch token pools from Gala Launchpad',
+ *   inputSchema: {
+ *     type: 'object',
+ *     properties: {
+ *       type: { type: 'string', enum: ['recent', 'popular'] },
+ *       page: PAGE_SCHEMA,
+ *       limit: createLimitSchema('pool', 20),
+ *     },
+ *   },
+ *   handler: (sdk, args) => sdk.fetchPools({
+ *     type: args.type || 'recent',
+ *     page: args.page || 1,
+ *     limit: args.limit || 20,
+ *   }),
+ * });
+ * ```
+ */
+export declare function createFetchTool(config: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: 'object';
+        properties: Record<string, any>;
+        required?: string[];
+    };
+    handler: ToolHandler;
+}): MCPTool;
+/**
+ * Creates a resolution tool that maps tokenName to some resolved value
+ *
+ * @example
+ * ```typescript
+ * export const resolveVaultAddressTool = createResolutionTool({
+ *   name: 'gala_launchpad_resolve_vault_address',
+ *   description: 'Get GalaChain vault address for a token',
+ *   resolver: (sdk, tokenName) => sdk.resolveVaultAddress(tokenName),
+ *   resultKey: 'vaultAddress',
+ * });
+ * ```
+ */
+export declare function createResolutionTool(config: {
+    name: string;
+    description: string;
+    resolver: SimpleTokenHandler<string | any>;
+    resultKey: string;
+}): MCPTool;
+/**
+ * Creates a no-parameter tool that only needs SDK instance
+ *
+ * @example
+ * ```typescript
+ * export const getAddressTool = createNoParamTool({
+ *   name: 'gala_launchpad_get_address',
+ *   description: 'Get the GalaChain address format (eth|0x...) for the authenticated wallet.',
+ *   handler: (sdk) => sdk.getAddress(),
+ *   resultKey: 'address',
+ * });
+ * ```
+ */
+export declare function createNoParamTool(config: {
+    name: string;
+    description: string;
+    handler: NoParamHandler;
+    resultKey?: string;
+}): MCPTool;
+export declare const toolFactory: {
+    createSimpleTokenFetchTool: typeof createSimpleTokenFetchTool;
+    createBooleanCheckTool: typeof createBooleanCheckTool;
+    createFetchTool: typeof createFetchTool;
+    createResolutionTool: typeof createResolutionTool;
+    createNoParamTool: typeof createNoParamTool;
+};
+export {};
+//# sourceMappingURL=tool-factory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tool-factory.d.ts","sourceRoot":"","sources":["../../src/utils/tool-factory.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAS9D;;GAEG;AACH,KAAK,WAAW,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,YAAY,EAAE,IAAI,EAAE,GAAG,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;AAEzE;;;GAGG;AACH,KAAK,kBAAkB,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;AAE/F;;GAEG;AACH,KAAK,mBAAmB,GAAG,CAAC,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;AAElF;;GAEG;AACH,KAAK,cAAc,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,YAAY,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;AAMrE;;;;;;;;;;;GAWG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE;IACjD,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,kBAAkB,CAAC;CAC7B,GAAG,OAAO,CAgBV;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,GAAG,CAAC;IACjB,OAAO,EAAE,mBAAmB,CAAC;IAC7B,QAAQ,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;CACH,GAAG,OAAO,CAoBV;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ,CAAC;QACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAChC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;KACrB,CAAC;IACF,OAAO,EAAE,WAAW,CAAC;CACtB,GAAG,OAAO,CAUV;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,kBAAkB,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC;IAC3C,SAAS,EAAE,MAAM,CAAC;CACnB,GAAG,OAAO,CAmBV;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,cAAc,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAcV;AAMD,eAAO,MAAM,WAAW;;;;;;CAMvB,CAAC"}

package/dist/utils/tool-factory.js

@@ -0,0 +1,194 @@
+"use strict";
+/**
+ * Tool Factory Pattern Utilities
+ *
+ * DRY utilities for creating MCP tools with common patterns.
+ * Eliminates duplication across 47 tool definitions.
+ *
+ * @see Phase 2.1 of refactoring plan
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toolFactory = void 0;
+exports.createSimpleTokenFetchTool = createSimpleTokenFetchTool;
+exports.createBooleanCheckTool = createBooleanCheckTool;
+exports.createFetchTool = createFetchTool;
+exports.createResolutionTool = createResolutionTool;
+exports.createNoParamTool = createNoParamTool;
+const error_handler_js_1 = require("./error-handler.js");
+const response_formatter_js_1 = require("./response-formatter.js");
+const common_schemas_js_1 = require("../schemas/common-schemas.js");
+// =============================================================================
+// Factory Functions
+// =============================================================================
+/**
+ * Creates a simple fetch tool that takes tokenName and calls an SDK method
+ *
+ * @example
+ * ```typescript
+ * export const fetchPoolDetailsTool = createSimpleTokenFetchTool({
+ *   name: 'gala_launchpad_fetch_pool_details',
+ *   description: 'Get detailed pool state from GalaChain bonding curve',
+ *   handler: (sdk, tokenName) => sdk.fetchPoolDetails(tokenName),
+ * });
+ * ```
+ */
+function createSimpleTokenFetchTool(config) {
+    return {
+        name: config.name,
+        description: config.description,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                tokenName: common_schemas_js_1.TOKEN_NAME_SCHEMA,
+            },
+            required: ['tokenName'],
+        },
+        handler: (0, error_handler_js_1.withErrorHandling)(async (sdk, args) => {
+            const result = await config.handler(sdk, args.tokenName);
+            return (0, response_formatter_js_1.formatSuccess)(result);
+        }),
+    };
+}
+/**
+ * Creates a boolean check tool (e.g., isTokenNameAvailable, isTokenSymbolAvailable)
+ *
+ * @example
+ * ```typescript
+ * export const checkTokenNameTool = 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',
+ *   },
+ * });
+ * ```
+ */
+function createBooleanCheckTool(config) {
+    return {
+        name: config.name,
+        description: config.description,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                [config.paramName]: config.paramSchema,
+            },
+            required: [config.paramName],
+        },
+        handler: (0, error_handler_js_1.withErrorHandling)(async (sdk, args) => {
+            const value = args[config.paramName];
+            const available = await config.handler(sdk, value);
+            return (0, response_formatter_js_1.formatBoolean)(available, available ? config.messages.true : config.messages.false);
+        }),
+    };
+}
+/**
+ * Creates a generic fetch tool with custom input schema and handler
+ *
+ * @example
+ * ```typescript
+ * export const fetchPoolsTool = createFetchTool({
+ *   name: 'gala_launchpad_fetch_pools',
+ *   description: 'Fetch token pools from Gala Launchpad',
+ *   inputSchema: {
+ *     type: 'object',
+ *     properties: {
+ *       type: { type: 'string', enum: ['recent', 'popular'] },
+ *       page: PAGE_SCHEMA,
+ *       limit: createLimitSchema('pool', 20),
+ *     },
+ *   },
+ *   handler: (sdk, args) => sdk.fetchPools({
+ *     type: args.type || 'recent',
+ *     page: args.page || 1,
+ *     limit: args.limit || 20,
+ *   }),
+ * });
+ * ```
+ */
+function createFetchTool(config) {
+    return {
+        name: config.name,
+        description: config.description,
+        inputSchema: config.inputSchema,
+        handler: (0, error_handler_js_1.withErrorHandling)(async (sdk, args) => {
+            const result = await config.handler(sdk, args);
+            return (0, response_formatter_js_1.formatSuccess)(result);
+        }),
+    };
+}
+/**
+ * Creates a resolution tool that maps tokenName to some resolved value
+ *
+ * @example
+ * ```typescript
+ * export const resolveVaultAddressTool = createResolutionTool({
+ *   name: 'gala_launchpad_resolve_vault_address',
+ *   description: 'Get GalaChain vault address for a token',
+ *   resolver: (sdk, tokenName) => sdk.resolveVaultAddress(tokenName),
+ *   resultKey: 'vaultAddress',
+ * });
+ * ```
+ */
+function createResolutionTool(config) {
+    return {
+        name: config.name,
+        description: config.description,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                tokenName: common_schemas_js_1.TOKEN_NAME_SCHEMA,
+            },
+            required: ['tokenName'],
+        },
+        handler: (0, error_handler_js_1.withErrorHandling)(async (sdk, args) => {
+            const resolvedValue = await config.resolver(sdk, args.tokenName);
+            return (0, response_formatter_js_1.formatSuccess)({
+                tokenName: args.tokenName,
+                [config.resultKey]: resolvedValue,
+            });
+        }),
+    };
+}
+/**
+ * Creates a no-parameter tool that only needs SDK instance
+ *
+ * @example
+ * ```typescript
+ * export const getAddressTool = createNoParamTool({
+ *   name: 'gala_launchpad_get_address',
+ *   description: 'Get the GalaChain address format (eth|0x...) for the authenticated wallet.',
+ *   handler: (sdk) => sdk.getAddress(),
+ *   resultKey: 'address',
+ * });
+ * ```
+ */
+function createNoParamTool(config) {
+    return {
+        name: config.name,
+        description: config.description,
+        inputSchema: {
+            type: 'object',
+            properties: {},
+        },
+        handler: (0, error_handler_js_1.withErrorHandling)(async (sdk) => {
+            const result = await config.handler(sdk);
+            // If resultKey provided, wrap in object; otherwise return result directly
+            return (0, response_formatter_js_1.formatSuccess)(config.resultKey ? { [config.resultKey]: result } : result);
+        }),
+    };
+}
+// =============================================================================
+// Exports
+// =============================================================================
+exports.toolFactory = {
+    createSimpleTokenFetchTool,
+    createBooleanCheckTool,
+    createFetchTool,
+    createResolutionTool,
+    createNoParamTool,
+};
+//# sourceMappingURL=tool-factory.js.map

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

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