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

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

@@ -0,0 +1,135 @@
+/**
+ * Discovery Prompt Factory
+ *
+ * Provides factory functions for creating token/pool discovery MCP prompts
+ * with standardized filtering, sorting, and pagination patterns.
+ *
+ * @example
+ * // Create a discovery prompt with sorting and filtering
+ * const discoverPoolsPrompt = createDiscoveryPrompt({
+ *   name: 'discover-dex-pools',
+ *   description: 'Discover DEX liquidity pools',
+ *   toolName: 'gala_launchpad_fetch_dex_pools',
+ *   itemType: 'DEX liquidity pools',
+ *   sortOptions: ['tvl', 'volume30d', 'volume1d'],
+ *   defaultSort: 'tvl',
+ * });
+ */
+import type { MCPPrompt, MCPPromptArgument } from '../../types/mcp.js';
+/**
+ * Configuration for discovery prompt factory
+ */
+export interface DiscoveryPromptConfig {
+    /** Unique prompt name */
+    name: string;
+    /** User-facing description */
+    description: string;
+    /** MCP tool name for paginated discovery */
+    toolName: string;
+    /** MCP tool name for auto-paginated "fetch all" (optional) */
+    fetchAllToolName?: string;
+    /** What is being discovered (e.g., 'DEX liquidity pools', 'tokens') */
+    itemType: string;
+    /** Available sort options */
+    sortOptions?: string[];
+    /** Default sort field */
+    defaultSort?: string;
+    /** Default sort order */
+    defaultSortOrder?: 'asc' | 'desc';
+    /** Whether to include search filter */
+    includeSearch?: boolean;
+    /** Search parameter description */
+    searchDescription?: string;
+    /** Default page size */
+    defaultLimit?: number;
+    /** Maximum page size */
+    maxLimit?: number;
+    /** Additional filter arguments */
+    additionalFilters?: MCPPromptArgument[];
+    /** Function to build additional filter parameters */
+    buildAdditionalFilters?: (args: Record<string, string>) => Record<string, string | undefined>;
+    /** Display format for results */
+    displayFormat?: string;
+}
+/**
+ * Create a discovery prompt with standardized filtering and sorting
+ *
+ * Handles the common pattern of:
+ * - Search/filter parameters
+ * - Sort field and order
+ * - Pagination (page/limit)
+ * - Consistent display format
+ *
+ * @param config - Configuration for the discovery prompt
+ * @returns Complete MCPPrompt definition
+ *
+ * @example
+ * ```typescript
+ * const discoverPoolsPrompt = createDiscoveryPrompt({
+ *   name: 'galachain-launchpad:fetch-dex-pools',
+ *   description: 'Discover DEX liquidity pools',
+ *   toolName: 'gala_launchpad_fetch_dex_pools',
+ *   itemType: 'DEX liquidity pools',
+ *   sortOptions: ['tvl', 'volume30d', 'volume1d'],
+ *   defaultSort: 'tvl',
+ *   includeSearch: true,
+ *   searchDescription: 'Search filter for token symbols (e.g., GALA, GUSDC)',
+ * });
+ * ```
+ */
+export declare function createDiscoveryPrompt(config: DiscoveryPromptConfig): MCPPrompt;
+/**
+ * Create a "fetch all" discovery prompt with auto-pagination
+ *
+ * This creates a prompt that fetches ALL items automatically
+ * without manual pagination.
+ *
+ * @param config - Configuration for the fetch-all prompt
+ * @returns Complete MCPPrompt definition
+ *
+ * @example
+ * ```typescript
+ * const fetchAllPoolsPrompt = createFetchAllPrompt({
+ *   name: 'galachain-launchpad:fetch-all-dex-pools',
+ *   description: 'Discover ALL DEX pools with auto-pagination',
+ *   toolName: 'gala_launchpad_fetch_all_dex_pools',
+ *   itemType: 'DEX liquidity pools',
+ *   sortOptions: ['tvl', 'volume30d', 'volume1d'],
+ * });
+ * ```
+ */
+export declare function createFetchAllPrompt(config: Omit<DiscoveryPromptConfig, 'defaultLimit' | 'maxLimit'>): MCPPrompt;
+/**
+ * Create a pair of discovery prompts (paginated + fetch-all)
+ *
+ * This is a convenience function that creates both the paginated
+ * and auto-paginated versions of a discovery prompt.
+ *
+ * @param config - Base configuration for discovery prompts
+ * @param fetchAllToolName - Tool name for the fetch-all version
+ * @returns Array of two MCPPrompt definitions [paginated, fetchAll]
+ *
+ * @example
+ * ```typescript
+ * const [fetchPools, fetchAllPools] = createDiscoveryPromptPair(
+ *   {
+ *     name: 'galachain-launchpad:fetch-dex-pools',
+ *     description: 'Discover DEX pools',
+ *     toolName: 'gala_launchpad_fetch_dex_pools',
+ *     itemType: 'DEX liquidity pools',
+ *     sortOptions: ['tvl', 'volume30d', 'volume1d'],
+ *   },
+ *   'gala_launchpad_fetch_all_dex_pools'
+ * );
+ * ```
+ */
+export declare function createDiscoveryPromptPair(config: DiscoveryPromptConfig, fetchAllToolName: string): [MCPPrompt, MCPPrompt];
+/**
+ * Factory exports for convenient access
+ */
+export declare const discoveryPromptFactories: {
+    createDiscoveryPrompt: typeof createDiscoveryPrompt;
+    createFetchAllPrompt: typeof createFetchAllPrompt;
+    createDiscoveryPromptPair: typeof createDiscoveryPromptPair;
+};
+//# sourceMappingURL=discovery-prompt-factory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"discovery-prompt-factory.d.ts","sourceRoot":"","sources":["../../../src/prompts/factories/discovery-prompt-factory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AASvE;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,yBAAyB;IACzB,IAAI,EAAE,MAAM,CAAC;IAEb,8BAA8B;IAC9B,WAAW,EAAE,MAAM,CAAC;IAEpB,4CAA4C;IAC5C,QAAQ,EAAE,MAAM,CAAC;IAEjB,8DAA8D;IAC9D,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B,uEAAuE;IACvE,QAAQ,EAAE,MAAM,CAAC;IAEjB,6BAA6B;IAC7B,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IAEvB,yBAAyB;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,yBAAyB;IACzB,gBAAgB,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IAElC,uCAAuC;IACvC,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB,mCAAmC;IACnC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B,wBAAwB;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,wBAAwB;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,kCAAkC;IAClC,iBAAiB,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAExC,qDAAqD;IACrD,sBAAsB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IAE9F,iCAAiC;IACjC,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,qBAAqB,GAAG,SAAS,CA+F9E;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,IAAI,CAAC,qBAAqB,EAAE,cAAc,GAAG,UAAU,CAAC,GAC/D,SAAS,CAwFX;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,qBAAqB,EAC7B,gBAAgB,EAAE,MAAM,GACvB,CAAC,SAAS,EAAE,SAAS,CAAC,CAcxB;AAED;;GAEG;AACH,eAAO,MAAM,wBAAwB;;;;CAIpC,CAAC"}

package/dist/prompts/factories/discovery-prompt-factory.js

@@ -0,0 +1,240 @@
+"use strict";
+/**
+ * Discovery Prompt Factory
+ *
+ * Provides factory functions for creating token/pool discovery MCP prompts
+ * with standardized filtering, sorting, and pagination patterns.
+ *
+ * @example
+ * // Create a discovery prompt with sorting and filtering
+ * const discoverPoolsPrompt = createDiscoveryPrompt({
+ *   name: 'discover-dex-pools',
+ *   description: 'Discover DEX liquidity pools',
+ *   toolName: 'gala_launchpad_fetch_dex_pools',
+ *   itemType: 'DEX liquidity pools',
+ *   sortOptions: ['tvl', 'volume30d', 'volume1d'],
+ *   defaultSort: 'tvl',
+ * });
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.discoveryPromptFactories = void 0;
+exports.createDiscoveryPrompt = createDiscoveryPrompt;
+exports.createFetchAllPrompt = createFetchAllPrompt;
+exports.createDiscoveryPromptPair = createDiscoveryPromptPair;
+const handlerHelpers_js_1 = require("../utils/handlerHelpers.js");
+const textTemplates_js_1 = require("../utils/textTemplates.js");
+const pagination_helpers_js_1 = require("../utils/pagination-helpers.js");
+/**
+ * Create a discovery prompt with standardized filtering and sorting
+ *
+ * Handles the common pattern of:
+ * - Search/filter parameters
+ * - Sort field and order
+ * - Pagination (page/limit)
+ * - Consistent display format
+ *
+ * @param config - Configuration for the discovery prompt
+ * @returns Complete MCPPrompt definition
+ *
+ * @example
+ * ```typescript
+ * const discoverPoolsPrompt = createDiscoveryPrompt({
+ *   name: 'galachain-launchpad:fetch-dex-pools',
+ *   description: 'Discover DEX liquidity pools',
+ *   toolName: 'gala_launchpad_fetch_dex_pools',
+ *   itemType: 'DEX liquidity pools',
+ *   sortOptions: ['tvl', 'volume30d', 'volume1d'],
+ *   defaultSort: 'tvl',
+ *   includeSearch: true,
+ *   searchDescription: 'Search filter for token symbols (e.g., GALA, GUSDC)',
+ * });
+ * ```
+ */
+function createDiscoveryPrompt(config) {
+    const { name, description, toolName, itemType, sortOptions = [], defaultSort, defaultSortOrder = 'desc', includeSearch = false, searchDescription = 'Search filter', defaultLimit = 10, maxLimit = 100, additionalFilters = [], buildAdditionalFilters, displayFormat, } = config;
+    // Build arguments
+    const args = [];
+    if (includeSearch) {
+        args.push({
+            name: 'search',
+            description: searchDescription,
+            required: false,
+        });
+    }
+    if (sortOptions.length > 0) {
+        args.push({
+            name: 'sortBy',
+            description: `Sort field: ${sortOptions.join(', ')}${defaultSort ? ` (default: ${defaultSort})` : ''}`,
+            required: false,
+        });
+        args.push({
+            name: 'sortOrder',
+            description: `Sort order: desc or asc (default: ${defaultSortOrder})`,
+            required: false,
+        });
+    }
+    args.push(...additionalFilters, ...(0, pagination_helpers_js_1.createPaginationArguments)({ defaultLimit, maxLimit }));
+    return {
+        name,
+        description,
+        arguments: args,
+        handler: (handlerArgs) => {
+            // Validate limit using helper
+            (0, pagination_helpers_js_1.validatePaginationLimit)(handlerArgs.limit, maxLimit);
+            // Build parameters
+            const sortBy = handlerArgs.sortBy || defaultSort;
+            const sortOrder = handlerArgs.sortOrder || defaultSortOrder;
+            const parameters = {};
+            if (includeSearch) {
+                parameters.search = handlerArgs.search ? `Search: ${handlerArgs.search}` : 'Search: (none)';
+            }
+            if (sortOptions.length > 0 && sortBy) {
+                parameters.sort_by = `Sort by: ${sortBy}`;
+                parameters.sort_order = `Order: ${sortOrder}`;
+            }
+            // Add pagination parameters using helper
+            const paginationParams = (0, pagination_helpers_js_1.buildPaginationParameters)(handlerArgs.page, handlerArgs.limit, { page: 1, limit: defaultLimit });
+            parameters.page = paginationParams.page;
+            parameters.limit = paginationParams.limit;
+            // Add additional filters
+            if (buildAdditionalFilters) {
+                Object.assign(parameters, buildAdditionalFilters(handlerArgs));
+            }
+            return (0, handlerHelpers_js_1.createPromptResponse)((0, textTemplates_js_1.createSimpleOperationText)({
+                operation: `Discover ${itemType}.`,
+                parameters,
+                toolName,
+                actionDescription: `retrieve ${itemType} with pagination and filtering`,
+                displayFormat: displayFormat || `Display results showing key metrics for each item.`,
+            }));
+        },
+    };
+}
+/**
+ * Create a "fetch all" discovery prompt with auto-pagination
+ *
+ * This creates a prompt that fetches ALL items automatically
+ * without manual pagination.
+ *
+ * @param config - Configuration for the fetch-all prompt
+ * @returns Complete MCPPrompt definition
+ *
+ * @example
+ * ```typescript
+ * const fetchAllPoolsPrompt = createFetchAllPrompt({
+ *   name: 'galachain-launchpad:fetch-all-dex-pools',
+ *   description: 'Discover ALL DEX pools with auto-pagination',
+ *   toolName: 'gala_launchpad_fetch_all_dex_pools',
+ *   itemType: 'DEX liquidity pools',
+ *   sortOptions: ['tvl', 'volume30d', 'volume1d'],
+ * });
+ * ```
+ */
+function createFetchAllPrompt(config) {
+    const { name, description, toolName, itemType, sortOptions = [], defaultSort, defaultSortOrder = 'desc', includeSearch = false, searchDescription = 'Search filter', additionalFilters = [], buildAdditionalFilters, } = config;
+    // Build arguments (no pagination for fetch-all)
+    const args = [];
+    if (includeSearch) {
+        args.push({
+            name: 'search',
+            description: searchDescription,
+            required: false,
+        });
+    }
+    if (sortOptions.length > 0) {
+        args.push({
+            name: 'sortBy',
+            description: `Sort field: ${sortOptions.join(', ')}${defaultSort ? ` (default: ${defaultSort})` : ''}`,
+            required: false,
+        });
+        args.push({
+            name: 'sortOrder',
+            description: `Sort order: desc or asc (default: ${defaultSortOrder})`,
+            required: false,
+        });
+    }
+    args.push(...additionalFilters);
+    return {
+        name,
+        description,
+        arguments: args,
+        handler: (handlerArgs) => {
+            const sortBy = handlerArgs.sortBy || defaultSort;
+            const sortOrder = handlerArgs.sortOrder || defaultSortOrder;
+            // Build intro text
+            const introLines = [`I want to discover all ${itemType} on GalaSwap.`];
+            introLines.push('');
+            introLines.push('**Discovery Parameters:**');
+            if (includeSearch) {
+                introLines.push(`- Search Filter: ${handlerArgs.search || '(none - get all)'}`);
+            }
+            if (sortOptions.length > 0 && sortBy) {
+                introLines.push(`- Sort By: ${sortBy}`);
+                introLines.push(`- Sort Order: ${sortOrder}`);
+            }
+            // Add additional filters to display
+            if (buildAdditionalFilters) {
+                const extraFilters = buildAdditionalFilters(handlerArgs);
+                for (const [, value] of Object.entries(extraFilters)) {
+                    if (value) {
+                        introLines.push(`- ${value}`);
+                    }
+                }
+            }
+            introLines.push('');
+            introLines.push('**Action:**');
+            introLines.push(`Fetch all available ${itemType} with automatic pagination. Show comprehensive data including:`);
+            introLines.push('- Item identifiers and key details');
+            introLines.push('- Relevant metrics and statistics');
+            introLines.push('');
+            introLines.push('Please use the following MCP tool:');
+            introLines.push(`- ${toolName}: Retrieve all ${itemType} with auto-pagination`);
+            introLines.push('');
+            introLines.push('Display the results in a clear format showing key metrics for analysis.');
+            return (0, handlerHelpers_js_1.createPromptResponse)(introLines.join('\n'));
+        },
+    };
+}
+/**
+ * Create a pair of discovery prompts (paginated + fetch-all)
+ *
+ * This is a convenience function that creates both the paginated
+ * and auto-paginated versions of a discovery prompt.
+ *
+ * @param config - Base configuration for discovery prompts
+ * @param fetchAllToolName - Tool name for the fetch-all version
+ * @returns Array of two MCPPrompt definitions [paginated, fetchAll]
+ *
+ * @example
+ * ```typescript
+ * const [fetchPools, fetchAllPools] = createDiscoveryPromptPair(
+ *   {
+ *     name: 'galachain-launchpad:fetch-dex-pools',
+ *     description: 'Discover DEX pools',
+ *     toolName: 'gala_launchpad_fetch_dex_pools',
+ *     itemType: 'DEX liquidity pools',
+ *     sortOptions: ['tvl', 'volume30d', 'volume1d'],
+ *   },
+ *   'gala_launchpad_fetch_all_dex_pools'
+ * );
+ * ```
+ */
+function createDiscoveryPromptPair(config, fetchAllToolName) {
+    const paginatedPrompt = createDiscoveryPrompt(config);
+    const fetchAllPrompt = createFetchAllPrompt({
+        ...config,
+        name: config.name.replace(':fetch-', ':fetch-all-').replace(':list-', ':list-all-'),
+        description: config.description.replace(/with pagination|paginated/gi, 'with automatic pagination'),
+        toolName: fetchAllToolName,
+    });
+    return [paginatedPrompt, fetchAllPrompt];
+}
+/**
+ * Factory exports for convenient access
+ */
+exports.discoveryPromptFactories = {
+    createDiscoveryPrompt,
+    createFetchAllPrompt,
+    createDiscoveryPromptPair,
+};
+//# sourceMappingURL=discovery-prompt-factory.js.map

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

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

package/dist/prompts/factories/event-subscription-factory.d.ts

@@ -0,0 +1,177 @@
+/**
+ * Event Subscription Prompt Factory
+ *
+ * Provides factory functions for creating WebSocket event subscription MCP prompts.
+ * These prompts follow the common pattern of:
+ * 1. Subscribe to a WebSocket event stream
+ * 2. Apply filters (duration, thresholds, etc.)
+ * 3. Display events in real-time
+ * 4. Auto-disconnect after timeout
+ *
+ * @example
+ * ```typescript
+ * const swapEventPrompt = createEventSubscriptionPrompt({
+ *   name: 'subscribe-dex-swaps',
+ *   description: 'Monitor DEX swap events',
+ *   eventType: 'dex_swap_executed',
+ *   toolName: 'gala_launchpad_on_dex_pool_creation',
+ *   eventDetails: ['Input/output tokens', 'Swap amounts', 'Fee collected'],
+ *   useCases: ['Track volume', 'Detect whale trades'],
+ * });
+ * ```
+ */
+import type { MCPPrompt } from '../../types/mcp.js';
+/**
+ * Filter argument configuration for event subscriptions
+ */
+export interface EventFilterArg {
+    /** Argument name (e.g., 'minAmount', 'feeTier') */
+    name: string;
+    /** User-facing description */
+    description: string;
+    /** Whether to validate as numeric */
+    isNumeric?: boolean;
+    /** Label for display (e.g., 'Minimum amount') */
+    displayLabel: string;
+    /** Optional prefix for display value (e.g., '$') */
+    displayPrefix?: string;
+    /** Optional suffix for display value (e.g., '%') */
+    displaySuffix?: string;
+}
+/**
+ * Configuration for event subscription prompt factory
+ */
+export interface EventSubscriptionPromptConfig {
+    /** Unique prompt name (without 'galachain-launchpad:' prefix) */
+    name: string;
+    /** User-facing description */
+    description: string;
+    /** Type of event being subscribed to */
+    eventType: string;
+    /** MCP tool name to invoke for subscription */
+    toolName: string;
+    /** List of event details to display */
+    eventDetails: string[];
+    /** List of use cases for this subscription */
+    useCases: string[];
+    /** Optional additional filter arguments beyond duration */
+    filterArgs?: EventFilterArg[];
+    /** Optional additional important notes */
+    additionalNotes?: string[];
+    /** Optional creator/address filter support */
+    supportsCreatorFilter?: boolean;
+    /** Optional fee tier reference for DEX pools */
+    includeFeeTierReference?: boolean;
+}
+/**
+ * Create an event subscription prompt with standardized handling
+ *
+ * This factory creates prompts that follow the WebSocket subscription pattern:
+ * - Duration parameter (with default of 60 seconds)
+ * - Optional filter parameters (numeric thresholds, etc.)
+ * - Standardized workflow, event details, use cases, and notes sections
+ *
+ * @param config - Configuration for the event subscription prompt
+ * @returns Complete MCPPrompt definition
+ *
+ * @example
+ * ```typescript
+ * const liquidityAddedPrompt = createEventSubscriptionPrompt({
+ *   name: 'subscribe-dex-liquidity-added',
+ *   description: 'Monitor DEX liquidity additions',
+ *   eventType: 'dex_liquidity_added',
+ *   toolName: 'gala_launchpad_on_dex_pool_creation',
+ *   eventDetails: [
+ *     'Token pair (token0, token1)',
+ *     'Amount of liquidity added',
+ *     'Price range (tickLower, tickUpper)',
+ *     'Position ID',
+ *   ],
+ *   useCases: [
+ *     'Monitor LP position creations',
+ *     'Track market maker activity',
+ *     'Identify significant liquidity provisions',
+ *   ],
+ *   filterArgs: [{
+ *     name: 'minLiquidity',
+ *     description: 'Minimum liquidity amount to filter events',
+ *     isNumeric: true,
+ *     displayLabel: 'Minimum liquidity',
+ *   }],
+ * });
+ * ```
+ */
+export declare function createEventSubscriptionPrompt(config: EventSubscriptionPromptConfig): MCPPrompt;
+/**
+ * Create a token launch/creation subscription prompt
+ *
+ * Specialized factory for token creation event subscriptions with
+ * standard creator filter support and token-specific event details.
+ *
+ * @param config - Configuration for the token event subscription
+ * @returns Complete MCPPrompt definition
+ */
+export declare function createTokenEventSubscriptionPrompt(config: {
+    name: string;
+    description: string;
+    toolName: string;
+    eventDetails: string[];
+    useCases: string[];
+    additionalNotes?: string[];
+}): MCPPrompt;
+/**
+ * Create a DEX event subscription prompt
+ *
+ * Specialized factory for DEX-related event subscriptions with
+ * optional fee tier reference and common DEX event details.
+ *
+ * @param config - Configuration for the DEX event subscription
+ * @returns Complete MCPPrompt definition
+ */
+export declare function createDexEventSubscriptionPrompt(config: {
+    name: string;
+    description: string;
+    eventType: string;
+    toolName: string;
+    eventDetails: string[];
+    useCases: string[];
+    filterArgs?: EventFilterArg[];
+    includeFeeTierReference?: boolean;
+    additionalNotes?: string[];
+}): MCPPrompt;
+/**
+ * Standard filter argument for minimum amount thresholds
+ */
+export declare const MIN_AMOUNT_FILTER: EventFilterArg;
+/**
+ * Standard filter argument for minimum liquidity thresholds
+ */
+export declare const MIN_LIQUIDITY_FILTER: EventFilterArg;
+/**
+ * Standard filter argument for minimum TVL thresholds
+ */
+export declare const MIN_TVL_FILTER: EventFilterArg;
+/**
+ * Standard filter argument for fee tier
+ */
+export declare const FEE_TIER_FILTER: EventFilterArg;
+/**
+ * Standard filter argument for token filter (comma-separated)
+ */
+export declare const TOKEN_FILTER: EventFilterArg;
+/**
+ * Factory exports for convenient access
+ */
+export declare const eventSubscriptionFactories: {
+    createEventSubscriptionPrompt: typeof createEventSubscriptionPrompt;
+    createTokenEventSubscriptionPrompt: typeof createTokenEventSubscriptionPrompt;
+    createDexEventSubscriptionPrompt: typeof createDexEventSubscriptionPrompt;
+    filters: {
+        MIN_AMOUNT_FILTER: EventFilterArg;
+        MIN_LIQUIDITY_FILTER: EventFilterArg;
+        MIN_TVL_FILTER: EventFilterArg;
+        FEE_TIER_FILTER: EventFilterArg;
+        TOKEN_FILTER: EventFilterArg;
+    };
+};
+//# sourceMappingURL=event-subscription-factory.d.ts.map

package/dist/prompts/factories/event-subscription-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-subscription-factory.d.ts","sourceRoot":"","sources":["../../../src/prompts/factories/event-subscription-factory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAqB,MAAM,oBAAoB,CAAC;AAQvE;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,mDAAmD;IACnD,IAAI,EAAE,MAAM,CAAC;IAEb,8BAA8B;IAC9B,WAAW,EAAE,MAAM,CAAC;IAEpB,qCAAqC;IACrC,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB,iDAAiD;IACjD,YAAY,EAAE,MAAM,CAAC;IAErB,oDAAoD;IACpD,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,oDAAoD;IACpD,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,6BAA6B;IAC5C,iEAAiE;IACjE,IAAI,EAAE,MAAM,CAAC;IAEb,8BAA8B;IAC9B,WAAW,EAAE,MAAM,CAAC;IAEpB,wCAAwC;IACxC,SAAS,EAAE,MAAM,CAAC;IAElB,+CAA+C;IAC/C,QAAQ,EAAE,MAAM,CAAC;IAEjB,uCAAuC;IACvC,YAAY,EAAE,MAAM,EAAE,CAAC;IAEvB,8CAA8C;IAC9C,QAAQ,EAAE,MAAM,EAAE,CAAC;IAEnB,2DAA2D;IAC3D,UAAU,CAAC,EAAE,cAAc,EAAE,CAAC;IAE9B,0CAA0C;IAC1C,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAE3B,8CAA8C;IAC9C,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAEhC,gDAAgD;IAChD,uBAAuB,CAAC,EAAE,OAAO,CAAC;CACnC;AAmGD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,6BAA6B,GACpC,SAAS,CA6GX;AAED;;;;;;;;GAQG;AACH,wBAAgB,kCAAkC,CAAC,MAAM,EAAE;IACzD,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B,GAAG,SAAS,CAUZ;AAED;;;;;;;;GAQG;AACH,wBAAgB,gCAAgC,CAAC,MAAM,EAAE;IACvD,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,UAAU,CAAC,EAAE,cAAc,EAAE,CAAC;IAC9B,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B,GAAG,SAAS,CAQZ;AAMD;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAE,cAK/B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,cAMlC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,cAM5B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,cAM7B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,YAAY,EAAE,cAM1B,CAAC;AAMF;;GAEG;AACH,eAAO,MAAM,0BAA0B;;;;;;;;;;;CAYtC,CAAC"}