@gala-chain/launchpad-mcp-server 5.0.3 → 5.0.4-beta.1

package/dist/prompts/prompt-factories.d.ts

@@ -0,0 +1,179 @@
+/**
+ * Prompt Factory Utilities
+ *
+ * Provides reusable factory functions for creating MCP prompt definitions
+ * with standardized validation, parameter handling, and response formatting.
+ *
+ * These factories reduce boilerplate and ensure consistent prompt behavior
+ * across the entire MCP server.
+ *
+ * @example
+ * // Create a simple token operation prompt
+ * const myPrompt = createTokenOperationPrompt({
+ *   name: 'my-operation',
+ *   description: 'Perform operation on token',
+ *   requiresTokenName: true,
+ *   toolName: 'gala_launchpad_my_tool',
+ *   actionDescription: 'perform the operation',
+ *   buildParameters: (args) => ({
+ *     token: `Token: ${args.tokenName}`,
+ *     amount: `Amount: ${args.amount}`
+ *   })
+ * });
+ */
+import type { MCPPrompt, MCPPromptArgument } from '../types/mcp.js';
+/**
+ * Configuration for token operation prompt factory
+ */
+export interface TokenOperationConfig {
+    /** Unique prompt name (e.g., 'send-token') */
+    name: string;
+    /** User-facing description */
+    description: string;
+    /** Whether this operation requires a tokenName argument */
+    requiresTokenName: boolean;
+    /** MCP tool name to invoke (e.g., 'gala_launchpad_send_token') */
+    toolName: string;
+    /** Action description for display (e.g., 'send the token') */
+    actionDescription: string;
+    /** Function to build parameter object from handler arguments */
+    buildParameters: (args: Record<string, string>) => Record<string, string | undefined>;
+    /** Additional arguments beyond tokenName (if requiresTokenName is true) */
+    additionalArguments?: MCPPromptArgument[];
+    /** Optional operation description override */
+    operationDescription?: string;
+    /** Optional display format instructions */
+    displayFormat?: string;
+    /** Optional operation-specific validation function */
+    validate?: (args: Record<string, string>) => void;
+}
+/**
+ * Create a complete MCPPrompt for a token operation with standardized handling
+ *
+ * This factory handles the common pattern of:
+ * 1. Validate token name (if required)
+ * 2. Validate any additional arguments
+ * 3. Build parameters object with conditional fields
+ * 4. Create and return prompt response
+ *
+ * @param config - Configuration for the token operation prompt
+ * @returns Complete MCPPrompt definition ready to use
+ *
+ * @example
+ * ```typescript
+ * const sendTokenPrompt = createTokenOperationPrompt({
+ *   name: 'send-token',
+ *   description: 'Send tokens to another user',
+ *   requiresTokenName: true,
+ *   toolName: 'gala_launchpad_send_token',
+ *   actionDescription: 'send the tokens',
+ *   additionalArguments: [
+ *     { name: 'to', description: 'Recipient address', required: true },
+ *     { name: 'amount', description: 'Amount to send', required: true }
+ *   ],
+ *   buildParameters: (args) => ({
+ *     token: `Token: ${args.tokenName}`,
+ *     to: `To: ${args.to}`,
+ *     amount: `Amount: ${args.amount}`
+ *   }),
+ *   operationDescription: 'Send tokens to another user. Requires valid recipient address.'
+ * });
+ * ```
+ */
+export declare function createTokenOperationPrompt(config: TokenOperationConfig): MCPPrompt;
+/**
+ * Build an address parameter conditionally
+ *
+ * Useful for handlers that accept optional address arguments.
+ * Returns the formatted parameter only if address is provided.
+ *
+ * @param address - Address value (optional)
+ * @param fieldName - Display name for the parameter (default: 'address')
+ * @returns Parameter object with formatted address, or undefined
+ *
+ * @example
+ * ```typescript
+ * // In handler
+ * const parameters = {
+ *   ...buildAddressParameter(args.address, 'From'),
+ *   ...buildAddressParameter(args.to, 'To')
+ * };
+ * ```
+ */
+export declare function buildAddressParameter(address?: string, fieldName?: string): Record<string, string> | undefined;
+/**
+ * Build parameter object with conditional fields
+ *
+ * Provides flexible parameter object construction with support for
+ * default values and conditional inclusion based on predicates.
+ *
+ * @param defaults - Default parameters to always include
+ * @param conditionals - Array of [condition, key, value] tuples for conditional fields
+ * @returns Parameter object with default and conditional fields
+ *
+ * @example
+ * ```typescript
+ * const parameters = buildParameterObject(
+ *   {
+ *     token: `Token: ${args.tokenName}`
+ *   },
+ *   [
+ *     [!!args.amount, 'amount', `Amount: ${args.amount}`],
+ *     [!!args.slippage, 'slippage', `Slippage: ${args.slippage}%`],
+ *     [args.type === 'exact', 'type', 'Type: Exact Input']
+ *   ]
+ * );
+ * ```
+ */
+export declare function buildParameterObject(defaults: Record<string, string>, conditionals?: Array<[condition: boolean, key: string, value: string]>): Record<string, string>;
+/**
+ * Parse boolean value from string argument
+ *
+ * Handles common boolean representations: 'true', 't', 'yes', '1' as true,
+ * everything else as false.
+ *
+ * @param value - String value to parse as boolean
+ * @returns Parsed boolean value
+ *
+ * @example
+ * ```typescript
+ * parseBoolean('true') // → true
+ * parseBoolean('false') // → false
+ * parseBoolean('yes') // → true
+ * parseBoolean('no') // → false
+ * parseBoolean('1') // → true
+ * parseBoolean('0') // → false
+ * ```
+ */
+export declare function parseBoolean(value: string): boolean;
+/**
+ * Format private key for display by obfuscating sensitive parts
+ *
+ * Shows only first and last 6 characters, replacing middle with asterisks.
+ * Never displays the full key to prevent accidental exposure.
+ *
+ * @param key - Private key to obfuscate
+ * @returns Obfuscated key for safe display
+ *
+ * @example
+ * ```typescript
+ * formatPrivateKeyForDisplay('0x1234567890abcdef...')
+ * // → '0x1234...cdef' (or similar pattern)
+ *
+ * const key = 'abc123def456ghi789'; // 18 chars
+ * formatPrivateKeyForDisplay(key)
+ * // → 'abc123...i789'
+ * ```
+ */
+export declare function formatPrivateKeyForDisplay(key: string): string;
+/**
+ * Export all factory utilities for convenient access
+ */
+export declare const promptFactories: {
+    createTokenOperationPrompt: typeof createTokenOperationPrompt;
+    buildAddressParameter: typeof buildAddressParameter;
+    buildParameterObject: typeof buildParameterObject;
+    parseBoolean: typeof parseBoolean;
+    formatPrivateKeyForDisplay: typeof formatPrivateKeyForDisplay;
+};
+//# sourceMappingURL=prompt-factories.d.ts.map

package/dist/prompts/prompt-factories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-factories.d.ts","sourceRoot":"","sources":["../../src/prompts/prompt-factories.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAKpE;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,8CAA8C;IAC9C,IAAI,EAAE,MAAM,CAAC;IAEb,8BAA8B;IAC9B,WAAW,EAAE,MAAM,CAAC;IAEpB,2DAA2D;IAC3D,iBAAiB,EAAE,OAAO,CAAC;IAE3B,kEAAkE;IAClE,QAAQ,EAAE,MAAM,CAAC;IAEjB,8DAA8D;IAC9D,iBAAiB,EAAE,MAAM,CAAC;IAE1B,gEAAgE;IAChE,eAAe,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IAEtF,2EAA2E;IAC3E,mBAAmB,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAE1C,8CAA8C;IAC9C,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAE9B,2CAA2C;IAC3C,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,sDAAsD;IACtD,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,IAAI,CAAC;CACnD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,oBAAoB,GAAG,SAAS,CA4DlF;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,CAAC,EAAE,MAAM,EAChB,SAAS,SAAY,GACpB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAKpC;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAChC,YAAY,GAAE,KAAK,CAAC,CAAC,SAAS,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,CAAM,GACzE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAUxB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAKnD;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAS9D;AAED;;GAEG;AACH,eAAO,MAAM,eAAe;;;;;;CAM3B,CAAC"}

package/dist/prompts/prompt-factories.js

@@ -0,0 +1,230 @@
+"use strict";
+/**
+ * Prompt Factory Utilities
+ *
+ * Provides reusable factory functions for creating MCP prompt definitions
+ * with standardized validation, parameter handling, and response formatting.
+ *
+ * These factories reduce boilerplate and ensure consistent prompt behavior
+ * across the entire MCP server.
+ *
+ * @example
+ * // Create a simple token operation prompt
+ * const myPrompt = createTokenOperationPrompt({
+ *   name: 'my-operation',
+ *   description: 'Perform operation on token',
+ *   requiresTokenName: true,
+ *   toolName: 'gala_launchpad_my_tool',
+ *   actionDescription: 'perform the operation',
+ *   buildParameters: (args) => ({
+ *     token: `Token: ${args.tokenName}`,
+ *     amount: `Amount: ${args.amount}`
+ *   })
+ * });
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.promptFactories = void 0;
+exports.createTokenOperationPrompt = createTokenOperationPrompt;
+exports.buildAddressParameter = buildAddressParameter;
+exports.buildParameterObject = buildParameterObject;
+exports.parseBoolean = parseBoolean;
+exports.formatPrivateKeyForDisplay = formatPrivateKeyForDisplay;
+const validation_js_1 = require("../utils/validation.js");
+const handlerHelpers_js_1 = require("./utils/handlerHelpers.js");
+const textTemplates_js_1 = require("./utils/textTemplates.js");
+/**
+ * Create a complete MCPPrompt for a token operation with standardized handling
+ *
+ * This factory handles the common pattern of:
+ * 1. Validate token name (if required)
+ * 2. Validate any additional arguments
+ * 3. Build parameters object with conditional fields
+ * 4. Create and return prompt response
+ *
+ * @param config - Configuration for the token operation prompt
+ * @returns Complete MCPPrompt definition ready to use
+ *
+ * @example
+ * ```typescript
+ * const sendTokenPrompt = createTokenOperationPrompt({
+ *   name: 'send-token',
+ *   description: 'Send tokens to another user',
+ *   requiresTokenName: true,
+ *   toolName: 'gala_launchpad_send_token',
+ *   actionDescription: 'send the tokens',
+ *   additionalArguments: [
+ *     { name: 'to', description: 'Recipient address', required: true },
+ *     { name: 'amount', description: 'Amount to send', required: true }
+ *   ],
+ *   buildParameters: (args) => ({
+ *     token: `Token: ${args.tokenName}`,
+ *     to: `To: ${args.to}`,
+ *     amount: `Amount: ${args.amount}`
+ *   }),
+ *   operationDescription: 'Send tokens to another user. Requires valid recipient address.'
+ * });
+ * ```
+ */
+function createTokenOperationPrompt(config) {
+    const { name, description, requiresTokenName, toolName, actionDescription, buildParameters, additionalArguments = [], operationDescription, displayFormat, validate: customValidate, } = config;
+    // Build arguments list
+    const baseArguments = requiresTokenName
+        ? [{ name: 'tokenName', description: 'Token name (e.g., anime)', required: true }]
+        : [];
+    return {
+        name,
+        description,
+        arguments: [...baseArguments, ...additionalArguments],
+        handler: (args) => {
+            // Validate token name if required
+            if (requiresTokenName) {
+                (0, validation_js_1.validateTokenName)(args.tokenName);
+            }
+            // Run custom validation if provided
+            if (customValidate) {
+                customValidate(args);
+            }
+            // Build parameters object
+            const parameters = buildParameters(args);
+            // Create operation description (support template placeholders)
+            let operation = operationDescription || '';
+            if (operation && requiresTokenName) {
+                operation = operation.replace('{tokenName}', args.tokenName);
+            }
+            if (!operation) {
+                operation = requiresTokenName
+                    ? `Perform operation on token "${args.tokenName}".`
+                    : 'Perform operation.';
+            }
+            // Create and return prompt response
+            return (0, handlerHelpers_js_1.createPromptResponse)((0, textTemplates_js_1.createSimpleOperationText)({
+                operation,
+                parameters,
+                toolName,
+                actionDescription,
+                displayFormat,
+            }));
+        },
+    };
+}
+/**
+ * Build an address parameter conditionally
+ *
+ * Useful for handlers that accept optional address arguments.
+ * Returns the formatted parameter only if address is provided.
+ *
+ * @param address - Address value (optional)
+ * @param fieldName - Display name for the parameter (default: 'address')
+ * @returns Parameter object with formatted address, or undefined
+ *
+ * @example
+ * ```typescript
+ * // In handler
+ * const parameters = {
+ *   ...buildAddressParameter(args.address, 'From'),
+ *   ...buildAddressParameter(args.to, 'To')
+ * };
+ * ```
+ */
+function buildAddressParameter(address, fieldName = 'Address') {
+    if (!address) {
+        return undefined;
+    }
+    return { [fieldName]: `${fieldName}: ${address}` };
+}
+/**
+ * Build parameter object with conditional fields
+ *
+ * Provides flexible parameter object construction with support for
+ * default values and conditional inclusion based on predicates.
+ *
+ * @param defaults - Default parameters to always include
+ * @param conditionals - Array of [condition, key, value] tuples for conditional fields
+ * @returns Parameter object with default and conditional fields
+ *
+ * @example
+ * ```typescript
+ * const parameters = buildParameterObject(
+ *   {
+ *     token: `Token: ${args.tokenName}`
+ *   },
+ *   [
+ *     [!!args.amount, 'amount', `Amount: ${args.amount}`],
+ *     [!!args.slippage, 'slippage', `Slippage: ${args.slippage}%`],
+ *     [args.type === 'exact', 'type', 'Type: Exact Input']
+ *   ]
+ * );
+ * ```
+ */
+function buildParameterObject(defaults, conditionals = []) {
+    const parameters = { ...defaults };
+    for (const [condition, key, value] of conditionals) {
+        if (condition) {
+            parameters[key] = value;
+        }
+    }
+    return parameters;
+}
+/**
+ * Parse boolean value from string argument
+ *
+ * Handles common boolean representations: 'true', 't', 'yes', '1' as true,
+ * everything else as false.
+ *
+ * @param value - String value to parse as boolean
+ * @returns Parsed boolean value
+ *
+ * @example
+ * ```typescript
+ * parseBoolean('true') // → true
+ * parseBoolean('false') // → false
+ * parseBoolean('yes') // → true
+ * parseBoolean('no') // → false
+ * parseBoolean('1') // → true
+ * parseBoolean('0') // → false
+ * ```
+ */
+function parseBoolean(value) {
+    if (!value || typeof value !== 'string') {
+        return false;
+    }
+    return ['true', 't', 'yes', 'y', '1'].includes(value.toLowerCase());
+}
+/**
+ * Format private key for display by obfuscating sensitive parts
+ *
+ * Shows only first and last 6 characters, replacing middle with asterisks.
+ * Never displays the full key to prevent accidental exposure.
+ *
+ * @param key - Private key to obfuscate
+ * @returns Obfuscated key for safe display
+ *
+ * @example
+ * ```typescript
+ * formatPrivateKeyForDisplay('0x1234567890abcdef...')
+ * // → '0x1234...cdef' (or similar pattern)
+ *
+ * const key = 'abc123def456ghi789'; // 18 chars
+ * formatPrivateKeyForDisplay(key)
+ * // → 'abc123...i789'
+ * ```
+ */
+function formatPrivateKeyForDisplay(key) {
+    if (!key || key.length <= 12) {
+        return '***' + (key?.slice(-3) || '***');
+    }
+    const prefix = key.slice(0, 6);
+    const suffix = key.slice(-6);
+    return `${prefix}...${suffix}`;
+}
+/**
+ * Export all factory utilities for convenient access
+ */
+exports.promptFactories = {
+    createTokenOperationPrompt,
+    buildAddressParameter,
+    buildParameterObject,
+    parseBoolean,
+    formatPrivateKeyForDisplay,
+};
+//# sourceMappingURL=prompt-factories.js.map

package/dist/prompts/prompt-factories.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-factories.js","sourceRoot":"","sources":["../../src/prompts/prompt-factories.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;;;AA2EH,gEA4DC;AAqBD,sDAQC;AA0BD,oDAaC;AAqBD,oCAKC;AAqBD,gEASC;AAhQD,0DAA2D;AAC3D,iEAAiE;AACjE,+DAAqE;AAqCrE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,SAAgB,0BAA0B,CAAC,MAA4B;IACrE,MAAM,EACJ,IAAI,EACJ,WAAW,EACX,iBAAiB,EACjB,QAAQ,EACR,iBAAiB,EACjB,eAAe,EACf,mBAAmB,GAAG,EAAE,EACxB,oBAAoB,EACpB,aAAa,EACb,QAAQ,EAAE,cAAc,GACzB,GAAG,MAAM,CAAC;IAEX,uBAAuB;IACvB,MAAM,aAAa,GAAwB,iBAAiB;QAC1D,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,0BAA0B,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;QAClF,CAAC,CAAC,EAAE,CAAC;IAEP,OAAO;QACL,IAAI;QACJ,WAAW;QACX,SAAS,EAAE,CAAC,GAAG,aAAa,EAAE,GAAG,mBAAmB,CAAC;QACrD,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;YAChB,kCAAkC;YAClC,IAAI,iBAAiB,EAAE,CAAC;gBACtB,IAAA,iCAAiB,EAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACpC,CAAC;YAED,oCAAoC;YACpC,IAAI,cAAc,EAAE,CAAC;gBACnB,cAAc,CAAC,IAAI,CAAC,CAAC;YACvB,CAAC;YAED,0BAA0B;YAC1B,MAAM,UAAU,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;YAEzC,+DAA+D;YAC/D,IAAI,SAAS,GAAG,oBAAoB,IAAI,EAAE,CAAC;YAC3C,IAAI,SAAS,IAAI,iBAAiB,EAAE,CAAC;gBACnC,SAAS,GAAG,SAAS,CAAC,OAAO,CAAC,aAAa,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;YAC/D,CAAC;YACD,IAAI,CAAC,SAAS,EAAE,CAAC;gBACf,SAAS,GAAG,iBAAiB;oBAC3B,CAAC,CAAC,+BAA+B,IAAI,CAAC,SAAS,IAAI;oBACnD,CAAC,CAAC,oBAAoB,CAAC;YAC3B,CAAC;YAED,oCAAoC;YACpC,OAAO,IAAA,wCAAoB,EACzB,IAAA,4CAAyB,EAAC;gBACxB,SAAS;gBACT,UAAU;gBACV,QAAQ;gBACR,iBAAiB;gBACjB,aAAa;aACd,CAAC,CACH,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,SAAgB,qBAAqB,CACnC,OAAgB,EAChB,SAAS,GAAG,SAAS;IAErB,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,EAAE,CAAC,SAAS,CAAC,EAAE,GAAG,SAAS,KAAK,OAAO,EAAE,EAAE,CAAC;AACrD,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,SAAgB,oBAAoB,CAClC,QAAgC,EAChC,eAAwE,EAAE;IAE1E,MAAM,UAAU,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC;IAEnC,KAAK,MAAM,CAAC,SAAS,EAAE,GAAG,EAAE,KAAK,CAAC,IAAI,YAAY,EAAE,CAAC;QACnD,IAAI,SAAS,EAAE,CAAC;YACd,UAAU,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QAC1B,CAAC;IACH,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,SAAgB,YAAY,CAAC,KAAa;IACxC,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACxC,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,CAAC,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;AACtE,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,SAAgB,0BAA0B,CAAC,GAAW;IACpD,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC;QAC7B,OAAO,KAAK,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC;IAC3C,CAAC;IAED,MAAM,MAAM,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC/B,MAAM,MAAM,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAE7B,OAAO,GAAG,MAAM,MAAM,MAAM,EAAE,CAAC;AACjC,CAAC;AAED;;GAEG;AACU,QAAA,eAAe,GAAG;IAC7B,0BAA0B;IAC1B,qBAAqB;IACrB,oBAAoB;IACpB,YAAY;IACZ,0BAA0B;CAC3B,CAAC"}

package/dist/prompts/referrals.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Referral Prompts
+ *
+ * Slash commands for the referral program and rewards tracking on Gala Launchpad.
+ * Includes fetching referral URLs, listing referrals, and viewing summaries.
+ *
+ * @since 6.0.0
+ */
+import type { MCPPrompt } from '../types/mcp.js';
+/**
+ * Fetch Referral URL - Get unique referral link
+ */
+export declare const fetchReferralUrlPrompt: MCPPrompt;
+/**
+ * Fetch Referrals - Get paginated list of referrals
+ */
+export declare const fetchReferralsPrompt: MCPPrompt;
+/**
+ * Fetch All Referrals - Get complete referral list
+ */
+export declare const fetchAllReferralsPrompt: MCPPrompt;
+/**
+ * Fetch Referrals Summary - Get referral statistics
+ */
+export declare const fetchReferralsSummaryPrompt: MCPPrompt;
+export declare const referralPrompts: MCPPrompt[];
+//# sourceMappingURL=referrals.d.ts.map

package/dist/prompts/referrals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"referrals.d.ts","sourceRoot":"","sources":["../../src/prompts/referrals.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAmBjD;;GAEG;AACH,eAAO,MAAM,sBAAsB,EAAE,SAkBpC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,SA+ClC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,uBAAuB,EAAE,SA8CrC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,2BAA2B,EAAE,SAoCzC,CAAC;AAMF,eAAO,MAAM,eAAe,EAAE,SAAS,EAKtC,CAAC"}

package/dist/prompts/referrals.js

@@ -0,0 +1,176 @@
+"use strict";
+/**
+ * Referral Prompts
+ *
+ * Slash commands for the referral program and rewards tracking on Gala Launchpad.
+ * Includes fetching referral URLs, listing referrals, and viewing summaries.
+ *
+ * @since 6.0.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.referralPrompts = exports.fetchReferralsSummaryPrompt = exports.fetchAllReferralsPrompt = exports.fetchReferralsPrompt = exports.fetchReferralUrlPrompt = void 0;
+const validation_js_1 = require("../utils/validation.js");
+const handlerHelpers_js_1 = require("./utils/handlerHelpers.js");
+const textTemplates_js_1 = require("./utils/textTemplates.js");
+const prompt_factories_js_1 = require("./prompt-factories.js");
+const pagination_helpers_js_1 = require("./utils/pagination-helpers.js");
+// Tool name constants
+const REFERRAL_TOOLS = {
+    FETCH_REFERRAL_URL: 'gala_launchpad_fetch_referral_url',
+    FETCH_REFERRALS: 'gala_launchpad_fetch_referrals',
+    FETCH_ALL_REFERRALS: 'gala_launchpad_fetch_all_referrals',
+    FETCH_REFERRALS_SUMMARY: 'gala_launchpad_fetch_referrals_summary',
+};
+// =============================================================================
+// Referral Prompts
+// =============================================================================
+/**
+ * Fetch Referral URL - Get unique referral link
+ */
+exports.fetchReferralUrlPrompt = {
+    name: 'galachain-launchpad:fetch-referral-url',
+    description: 'Get your unique referral URL for sharing',
+    arguments: [],
+    handler: () => {
+        return (0, handlerHelpers_js_1.createPromptResponse)((0, textTemplates_js_1.createSimpleOperationText)({
+            operation: `Get your unique referral URL.
+
+The referral URL can be shared to earn rewards when new users sign up.
+Requires wallet configuration.`,
+            parameters: {},
+            toolName: REFERRAL_TOOLS.FETCH_REFERRAL_URL,
+            actionDescription: 'fetch the referral URL',
+            displayFormat: 'Display the referral URL ready for sharing.',
+        }));
+    },
+};
+/**
+ * Fetch Referrals - Get paginated list of referrals
+ */
+exports.fetchReferralsPrompt = {
+    name: 'galachain-launchpad:fetch-referrals',
+    description: 'Get paginated list of users who signed up using your referral link',
+    arguments: [
+        {
+            name: 'address',
+            description: 'Wallet address (defaults to SDK wallet)',
+            required: false,
+        },
+        ...(0, pagination_helpers_js_1.createPaginationArguments)({ defaultLimit: 100, maxLimit: 100 }),
+        {
+            name: 'sortBy',
+            description: 'Sort field: joined (default: joined)',
+            required: false,
+        },
+        {
+            name: 'sortDir',
+            description: 'Sort direction: asc or desc (default: desc)',
+            required: false,
+        },
+    ],
+    handler: (args) => {
+        if (args.address) {
+            (0, validation_js_1.validateAddress)(args.address, 'address');
+        }
+        const parameters = (0, prompt_factories_js_1.buildParameterObject)({}, [
+            [!!args.address, 'address', `Address: ${args.address}`],
+            [!!args.page, 'page', `Page: ${args.page}`],
+            [!!args.limit, 'limit', `Limit: ${args.limit}`],
+            [!!args.sortBy, 'sortBy', `Sort By: ${args.sortBy}`],
+            [!!args.sortDir, 'sortDir', `Sort Dir: ${args.sortDir}`],
+        ]);
+        return (0, handlerHelpers_js_1.createPromptResponse)((0, textTemplates_js_1.createSimpleOperationText)({
+            operation: 'Fetch paginated list of referrals.',
+            parameters,
+            toolName: REFERRAL_TOOLS.FETCH_REFERRALS,
+            actionDescription: 'fetch referrals',
+            displayFormat: 'Display referrals in a table with address, join date, and rewards earned.',
+        }));
+    },
+};
+/**
+ * Fetch All Referrals - Get complete referral list
+ */
+exports.fetchAllReferralsPrompt = {
+    name: 'galachain-launchpad:fetch-all-referrals',
+    description: 'Fetch all referrals with automatic pagination',
+    arguments: [
+        {
+            name: 'address',
+            description: 'Wallet address (defaults to SDK wallet)',
+            required: false,
+        },
+        {
+            name: 'sortBy',
+            description: 'Sort field: joined (default: joined)',
+            required: false,
+        },
+        {
+            name: 'sortDir',
+            description: 'Sort direction: asc or desc (default: desc)',
+            required: false,
+        },
+    ],
+    handler: (args) => {
+        if (args.address) {
+            (0, validation_js_1.validateAddress)(args.address, 'address');
+        }
+        const parameters = (0, prompt_factories_js_1.buildParameterObject)({}, [
+            [!!args.address, 'address', `Address: ${args.address}`],
+            [!!args.sortBy, 'sortBy', `Sort By: ${args.sortBy}`],
+            [!!args.sortDir, 'sortDir', `Sort Dir: ${args.sortDir}`],
+        ]);
+        return (0, handlerHelpers_js_1.createPromptResponse)((0, textTemplates_js_1.createSimpleOperationText)({
+            operation: `Fetch all referrals with automatic pagination.
+
+Returns the complete list of referred users without manual pagination.`,
+            parameters,
+            toolName: REFERRAL_TOOLS.FETCH_ALL_REFERRALS,
+            actionDescription: 'fetch all referrals',
+            displayFormat: 'Display all referrals with total count.',
+        }));
+    },
+};
+/**
+ * Fetch Referrals Summary - Get referral statistics
+ */
+exports.fetchReferralsSummaryPrompt = {
+    name: 'galachain-launchpad:fetch-referrals-summary',
+    description: 'Get referral program summary statistics',
+    arguments: [
+        {
+            name: 'address',
+            description: 'Wallet address (defaults to SDK wallet)',
+            required: false,
+        },
+    ],
+    handler: (args) => {
+        if (args.address) {
+            (0, validation_js_1.validateAddress)(args.address, 'address');
+        }
+        const parameters = (0, prompt_factories_js_1.buildParameterObject)({}, [[!!args.address, 'address', `Address: ${args.address}`]]);
+        return (0, handlerHelpers_js_1.createPromptResponse)((0, textTemplates_js_1.createSimpleOperationText)({
+            operation: `Get referral program summary statistics.
+
+Returns:
+- Total referral count
+- Rewards earned (past day, past month, all-time)
+
+Perfect for dashboards and quick overviews.`,
+            parameters,
+            toolName: REFERRAL_TOOLS.FETCH_REFERRALS_SUMMARY,
+            actionDescription: 'fetch referral summary',
+            displayFormat: 'Display summary with total referrals and reward breakdowns.',
+        }));
+    },
+};
+// =============================================================================
+// Export
+// =============================================================================
+exports.referralPrompts = [
+    exports.fetchReferralUrlPrompt,
+    exports.fetchReferralsPrompt,
+    exports.fetchAllReferralsPrompt,
+    exports.fetchReferralsSummaryPrompt,
+];
+//# sourceMappingURL=referrals.js.map

package/dist/prompts/referrals.js.map

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