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

package/dist/utils/default-values.js

@@ -0,0 +1,177 @@
+"use strict";
+/**
+ * Default Value Utilities
+ *
+ * Centralized default values for tool parameters to eliminate magic numbers
+ * and ensure consistency across 47 MCP tools.
+ *
+ * @see Phase 2.2 of refactoring plan
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defaultValues = exports.RESOLUTION_MAP = exports.DEFAULT_VOLUME_RESOLUTION = exports.DEFAULT_SORT_ORDER = exports.DEFAULT_POOL_TYPE = exports.DEFAULT_RBC_FEE_SLIPPAGE = exports.DEFAULT_SLIPPAGE_TOLERANCE = exports.MAX_LIMITS = exports.DEFAULT_LIMITS = exports.DEFAULT_PAGINATION = void 0;
+exports.applyPaginationDefaults = applyPaginationDefaults;
+exports.applyOperationPaginationDefaults = applyOperationPaginationDefaults;
+exports.applySlippageDefaults = applySlippageDefaults;
+exports.resolutionToSeconds = resolutionToSeconds;
+exports.dateToUnixTimestamp = dateToUnixTimestamp;
+const constraints_js_1 = require("./constraints.js");
+// =============================================================================
+// Pagination Defaults
+// =============================================================================
+/**
+ * Default pagination configuration
+ */
+exports.DEFAULT_PAGINATION = {
+    page: 1,
+    limit: 20,
+};
+/**
+ * Operation-specific default limits
+ */
+exports.DEFAULT_LIMITS = {
+    trade: 20,
+    user: 20,
+    pool: 20,
+    comment: 20,
+};
+/**
+ * Maximum limits per operation type (from MCP_CONSTRAINTS)
+ */
+exports.MAX_LIMITS = {
+    trade: constraints_js_1.MCP_CONSTRAINTS.TRADE_LIMIT, // 20
+    user: constraints_js_1.MCP_CONSTRAINTS.USER_LIMIT, // 20
+    pool: constraints_js_1.MCP_CONSTRAINTS.POOL_LIMIT, // 100
+    comment: constraints_js_1.MCP_CONSTRAINTS.COMMENT_LIMIT, // 50
+};
+// =============================================================================
+// Trading Defaults
+// =============================================================================
+/**
+ * Default slippage tolerance (1%)
+ */
+exports.DEFAULT_SLIPPAGE_TOLERANCE = 0.01;
+/**
+ * Default reverse bonding curve fee slippage tolerance (1%)
+ */
+exports.DEFAULT_RBC_FEE_SLIPPAGE = 0.01;
+/**
+ * Default pool type for fetchPools
+ */
+exports.DEFAULT_POOL_TYPE = 'recent';
+/**
+ * Default sort order
+ */
+exports.DEFAULT_SORT_ORDER = 'DESC';
+// =============================================================================
+// Volume Data Defaults
+// =============================================================================
+/**
+ * Default resolution for volume data (1 hour)
+ */
+exports.DEFAULT_VOLUME_RESOLUTION = '1h';
+/**
+ * Resolution mapping (string to seconds)
+ */
+exports.RESOLUTION_MAP = {
+    '1m': 60,
+    '5m': 300,
+    '15m': 900,
+    '1h': 3600,
+    '4h': 14400,
+    '1d': 86400,
+};
+// =============================================================================
+// Utility Functions
+// =============================================================================
+/**
+ * Applies default pagination values to args object
+ *
+ * @example
+ * ```typescript
+ * const params = applyPaginationDefaults(args);
+ * // { page: 1, limit: 20, ...otherArgs }
+ * ```
+ */
+function applyPaginationDefaults(args, defaults = exports.DEFAULT_PAGINATION) {
+    return {
+        ...args,
+        page: args.page ?? defaults.page ?? exports.DEFAULT_PAGINATION.page,
+        limit: args.limit ?? defaults.limit ?? exports.DEFAULT_PAGINATION.limit,
+    };
+}
+/**
+ * Applies operation-specific pagination defaults
+ *
+ * @example
+ * ```typescript
+ * const params = applyOperationPaginationDefaults(args, 'pool');
+ * // Uses default limit of 20 for pool operations
+ * ```
+ */
+function applyOperationPaginationDefaults(args, operationType) {
+    return applyPaginationDefaults(args, {
+        page: exports.DEFAULT_PAGINATION.page,
+        limit: exports.DEFAULT_LIMITS[operationType],
+    });
+}
+/**
+ * Applies default slippage values to trading args
+ *
+ * @example
+ * ```typescript
+ * const params = applySlippageDefaults(args);
+ * // { slippageToleranceFactor: 0.01, maxAcceptableReverseBondingCurveFeeSlippageFactor: 0.01, ...args }
+ * ```
+ */
+function applySlippageDefaults(args, defaults = {}) {
+    return {
+        ...args,
+        slippageToleranceFactor: args.slippageToleranceFactor ??
+            defaults.slippageToleranceFactor ??
+            exports.DEFAULT_SLIPPAGE_TOLERANCE,
+        maxAcceptableReverseBondingCurveFeeSlippageFactor: args.maxAcceptableReverseBondingCurveFeeSlippageFactor ??
+            defaults.maxAcceptableReverseBondingCurveFeeSlippageFactor ??
+            exports.DEFAULT_RBC_FEE_SLIPPAGE,
+    };
+}
+/**
+ * Converts volume resolution string to seconds
+ *
+ * @example
+ * ```typescript
+ * const seconds = resolutionToSeconds('1h', '1h');
+ * // 3600
+ * ```
+ */
+function resolutionToSeconds(resolution, defaultResolution = exports.DEFAULT_VOLUME_RESOLUTION) {
+    return exports.RESOLUTION_MAP[resolution ?? defaultResolution] ?? exports.RESOLUTION_MAP[defaultResolution];
+}
+/**
+ * Converts ISO 8601 date string to Unix timestamp (seconds)
+ *
+ * @example
+ * ```typescript
+ * const timestamp = dateToUnixTimestamp('2024-01-15T14:30:25Z');
+ * // 1705329025
+ * ```
+ */
+function dateToUnixTimestamp(isoDate) {
+    if (!isoDate)
+        return undefined;
+    return Math.floor(new Date(isoDate).getTime() / 1000);
+}
+// =============================================================================
+// Export All
+// =============================================================================
+exports.defaultValues = {
+    pagination: exports.DEFAULT_PAGINATION,
+    limits: exports.DEFAULT_LIMITS,
+    maxLimits: exports.MAX_LIMITS,
+    slippageTolerance: exports.DEFAULT_SLIPPAGE_TOLERANCE,
+    rbcFeeSlippage: exports.DEFAULT_RBC_FEE_SLIPPAGE,
+    poolType: exports.DEFAULT_POOL_TYPE,
+    sortOrder: exports.DEFAULT_SORT_ORDER,
+    volumeResolution: exports.DEFAULT_VOLUME_RESOLUTION,
+    resolutionMap: exports.RESOLUTION_MAP,
+};
+//# sourceMappingURL=default-values.js.map

package/dist/utils/default-values.js.map

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

package/dist/utils/error-handler.d.ts

@@ -1,7 +1,10 @@
 /**
  * Error Handler Utility
  *
- * Formats errors for MCP protocol responses
+ * Formats errors for MCP protocol responses with AI-friendly tips.
+ * Uses centralized error templates from error-templates.ts.
+ *
+ * @see src/utils/error-templates.ts
  */
 import type { MCPToolResponse } from '../types/mcp.js';
 /**
@@ -10,6 +13,10 @@ import type { MCPToolResponse } from '../types/mcp.js';
 export declare function formatError(error: unknown): MCPToolResponse;
 /**
  * Wrap handler with error handling
+ *
+ * @template TArgs - Array of argument types
+ * @param handler - Handler function to wrap with error handling
+ * @returns Wrapped handler with automatic error formatting
  */
-export declare function withErrorHandling<T extends (...args: any[]) => Promise<MCPToolResponse>>(handler: T): T;
+export declare function withErrorHandling<TArgs extends unknown[]>(handler: (...args: TArgs) => Promise<MCPToolResponse>): (...args: TArgs) => Promise<MCPToolResponse>;
 //# sourceMappingURL=error-handler.d.ts.map

package/dist/utils/error-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"error-handler.d.ts","sourceRoot":"","sources":["../../src/utils/error-handler.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEvD;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,CAoB3D;AA+ED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,eAAe,CAAC,EACtF,OAAO,EAAE,CAAC,GACT,CAAC,CAQH"}
+{"version":3,"file":"error-handler.d.ts","sourceRoot":"","sources":["../../src/utils/error-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAGvD;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,CAkB3D;AAkBD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,SAAS,OAAO,EAAE,EACvD,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,KAAK,OAAO,CAAC,eAAe,CAAC,GACpD,CAAC,GAAG,IAAI,EAAE,KAAK,KAAK,OAAO,CAAC,eAAe,CAAC,CAQ9C"}

package/dist/utils/error-handler.js

@@ -2,22 +2,24 @@
 /**
  * Error Handler Utility
  *
- * Formats errors for MCP protocol responses
+ * Formats errors for MCP protocol responses with AI-friendly tips.
+ * Uses centralized error templates from error-templates.ts.
+ *
+ * @see src/utils/error-templates.ts
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.formatError = formatError;
 exports.withErrorHandling = withErrorHandling;
+const error_templates_js_1 = require("./error-templates.js");
 /**
  * Format error for MCP response with AI-friendly tips
  */
 function formatError(error) {
-    const errorMessage = error instanceof Error
-        ? error.message
-        : String(error);
+    const errorMessage = error instanceof Error ? error.message : String(error);
     // Sanitize sensitive information from error messages
     const sanitized = sanitizeError(errorMessage);
-    // Add AI-friendly tips for common errors
-    const withTips = addAIFriendlyTips(sanitized);
+    // Add AI-friendly tips using centralized templates
+    const withTips = (0, error_templates_js_1.enhanceErrorMessage)(sanitized);
     return {
         content: [
             {
@@ -28,57 +30,6 @@ function formatError(error) {
         isError: true,
     };
 }
-/**
- * Add AI-friendly tips for common error patterns
- */
-function addAIFriendlyTips(message) {
-    // Limit validation errors
-    if (message.includes('Limit must be') || message.includes('between 1 and')) {
-        if (message.includes('20')) {
-            return `${message}\n\n💡 AI TIP: Trade and user operations have a maximum limit of 20. Use:\n- gala_launchpad_fetch_trades: limit ≤ 20\n- gala_launchpad_fetch_tokens_held: limit ≤ 20\n- gala_launchpad_fetch_tokens_created: limit ≤ 20\n\nSee docs/CONSTRAINTS-REFERENCE.md for details.`;
-        }
-        if (message.includes('50')) {
-            return `${message}\n\n💡 AI TIP: Comment operations have a maximum limit of 50. Use:\n- gala_launchpad_fetch_comments: limit ≤ 50\n\nSee docs/CONSTRAINTS-REFERENCE.md for details.`;
-        }
-        if (message.includes('100')) {
-            return `${message}\n\n💡 AI TIP: Pool operations have a maximum limit of 100. Use:\n- gala_launchpad_fetch_pools: limit ≤ 100\n\nSee docs/CONSTRAINTS-REFERENCE.md for details.`;
-        }
-    }
-    // Token name validation errors
-    if (message.includes('token name') && (message.includes('invalid') || message.includes('validation'))) {
-        return `${message}\n\n💡 AI TIP: Token names must match pattern ^[a-z0-9_-]{2,20}$:\n- Lowercase letters and numbers only\n- Dashes and underscores allowed\n- Length: 2-20 characters\n- Valid examples: 'mytoken', 'test-token', 'token_123'\n- Invalid: 'MyToken' (uppercase), 'a' (too short), 'my token' (space)`;
-    }
-    // Token symbol validation errors
-    if (message.includes('token symbol') && (message.includes('invalid') || message.includes('validation'))) {
-        return `${message}\n\n💡 AI TIP: Token symbols must match pattern ^[A-Z0-9]{2,10}$:\n- Uppercase letters and numbers only\n- No special characters\n- Length: 2-10 characters\n- Valid examples: 'MTK', 'TEST123', 'ABC'\n- Invalid: 'mtk' (lowercase), 'A' (too short), 'MY-TOKEN' (dash)`;
-    }
-    // Wallet address format errors
-    if (message.includes('address') && (message.includes('format') || message.includes('validation'))) {
-        return `${message}\n\n💡 AI TIP: Wallet addresses must use format:\n- Backend API: 'eth|{40-hex-chars}' (e.g., 'eth|abc123...')\n- Convert from standard: address.startsWith('0x') ? \`eth|\${address.slice(2)}\` : address\n- Most MCP tools expect 'eth|...' format`;
-    }
-    // WebSocket/trade timeout errors
-    if (message.includes('timeout') || message.includes('WebSocket')) {
-        return `${message}\n\n💡 AI TIP: Trade execution timeouts often indicate incorrect expectedAmount parameter.\n\n✅ CORRECT WORKFLOW:\n1. Call calculate_buy_amount() or calculate_sell_amount()\n2. Extract result.amount from response (e.g., "16843.7579794843252")\n3. Use result.amount as expectedAmount in buy() or sell()\n\n❌ WRONG: Using your input amount as expectedAmount\n✅ RIGHT: Using calculated result.amount as expectedAmount\n\nSee docs/AI-AGENT-PATTERNS.md section "Gotcha #1" for examples.`;
-    }
-    // Slippage/amount errors
-    if (message.includes('slippage') || message.includes('amount') && message.includes('expected')) {
-        return `${message}\n\n💡 AI TIP: expectedAmount must be the calculated output from calculate functions, NOT your input amount.\n\nExample:\nconst calc = await calculateBuyAmount({ amount: '10', type: 'native', ... });\n// calc.amount = "16843.7579794843252" <- Use THIS as expectedAmount\nawait buy({ amount: '10', expectedAmount: calc.amount, ... });\n\nSee docs/AI-AGENT-PATTERNS.md for complete trading workflow.`;
-    }
-    // Social URL requirement errors
-    if (message.includes('social') || (message.includes('URL') && message.includes('required'))) {
-        return `${message}\n\n💡 AI TIP: Token launch requires at least ONE social URL:\n- websiteUrl (e.g., 'https://mytoken.com')\n- twitterUrl (e.g., 'https://twitter.com/mytoken')\n- telegramUrl (e.g., 'https://t.me/mytoken')\n\nProvide at least one in launchToken() call.`;
-    }
-    // Type parameter confusion
-    if (message.includes('type') && (message.includes('native') || message.includes('token'))) {
-        return `${message}\n\n💡 AI TIP: Trading type parameter:\n- 'native': You specify GALA amount (most common)\n  Example: "I want to spend 10 GALA" → type: 'native', amount: '10'\n- 'token': You specify exact token amount\n  Example: "I want to buy exactly 1000 tokens" → type: 'token', amount: '1000'\n\nSee docs/AI-AGENT-PATTERNS.md section "Gotcha #3" for details.`;
-    }
-    // Generic validation error
-    if (message.includes('validation') || message.includes('invalid')) {
-        return `${message}\n\n💡 AI TIP: Check parameter formats in docs/AI-AGENT-PATTERNS.md\nCommon validation rules:\n- tokenName: ^[a-z0-9_-]{2,20}$ (lowercase, 2-20 chars)\n- tokenSymbol: ^[A-Z0-9]{2,10}$ (uppercase, 2-10 chars)\n- address: 'eth|...' or '0x...' format (auto-normalized)\n- amount: ^[0-9.]+$ (decimal string)\n- limits: See CONSTRAINTS-REFERENCE.md`;
-    }
-    // No specific tip found, return original message
-    return message;
-}
 /**
  * Sanitize error messages to remove sensitive information
  */
@@ -93,15 +44,19 @@ function sanitizeError(message) {
 }
 /**
  * Wrap handler with error handling
+ *
+ * @template TArgs - Array of argument types
+ * @param handler - Handler function to wrap with error handling
+ * @returns Wrapped handler with automatic error formatting
  */
 function withErrorHandling(handler) {
-    return (async (...args) => {
+    return async (...args) => {
         try {
             return await handler(...args);
         }
         catch (error) {
             return formatError(error);
         }
-    });
+    };
 }
 //# sourceMappingURL=error-handler.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"error-handler.js","sourceRoot":"","sources":["../../src/utils/error-handler.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"error-handler.js","sourceRoot":"","sources":["../../src/utils/error-handler.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;AAQH,kCAkBC;AAyBD,8CAUC;AA1DD,6DAA2D;AAE3D;;GAEG;AACH,SAAgB,WAAW,CAAC,KAAc;IACxC,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAE5E,qDAAqD;IACrD,MAAM,SAAS,GAAG,aAAa,CAAC,YAAY,CAAC,CAAC;IAE9C,mDAAmD;IACnD,MAAM,QAAQ,GAAG,IAAA,wCAAmB,EAAC,SAAS,CAAC,CAAC;IAEhD,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,UAAU,QAAQ,EAAE;aAC3B;SACF;QACD,OAAO,EAAE,IAAI;KACd,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAS,aAAa,CAAC,OAAe;IACpC,sBAAsB;IACtB,IAAI,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,oBAAoB,EAAE,OAAO,CAAC,CAAC;IAE/D,gDAAgD;IAChD,SAAS,GAAG,SAAS,CAAC,OAAO,CAAC,yBAAyB,EAAE,OAAO,CAAC,CAAC;IAElE,8CAA8C;IAC9C,SAAS,GAAG,SAAS,CAAC,OAAO,CAAC,sBAAsB,EAAE,OAAO,CAAC,CAAC;IAE/D,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,iBAAiB,CAC/B,OAAqD;IAErD,OAAO,KAAK,EAAE,GAAG,IAAW,EAA4B,EAAE;QACxD,IAAI,CAAC;YACH,OAAO,MAAM,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;QAChC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,WAAW,CAAC,KAAK,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}

package/dist/utils/error-templates.d.ts

@@ -0,0 +1,96 @@
+/**
+ * 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
+ */
+/**
+ * Error template with AI-friendly tip
+ */
+export interface ErrorTemplate {
+    pattern: RegExp | string;
+    tip: string;
+    category: 'validation' | 'timeout' | 'format' | 'business-logic' | 'network';
+}
+/**
+ * Limit validation errors
+ */
+export declare const LIMIT_ERRORS: {
+    readonly trade: {
+        readonly pattern: RegExp;
+        readonly tip: "💡 AI TIP: Trade and user operations have a maximum limit of 20. Use:\n- gala_launchpad_fetch_trades: limit ≤ 20\n- gala_launchpad_fetch_tokens_held: limit ≤ 20\n- gala_launchpad_fetch_tokens_created: limit ≤ 20\n\nSee docs/CONSTRAINTS-REFERENCE.md for details.";
+        readonly category: "validation";
+    };
+    readonly comment: {
+        readonly pattern: RegExp;
+        readonly tip: "💡 AI TIP: Comment operations have a maximum limit of 50. Use:\n- gala_launchpad_fetch_comments: limit ≤ 50\n\nSee docs/CONSTRAINTS-REFERENCE.md for details.";
+        readonly category: "validation";
+    };
+    readonly pool: {
+        readonly pattern: RegExp;
+        readonly tip: "💡 AI TIP: Pool operations have a maximum limit of 100. Use:\n- gala_launchpad_fetch_pools: limit ≤ 100\n\nSee docs/CONSTRAINTS-REFERENCE.md for details.";
+        readonly category: "validation";
+    };
+};
+/**
+ * Token name validation errors
+ */
+export declare const TOKEN_NAME_ERROR: ErrorTemplate;
+/**
+ * Token symbol validation errors
+ */
+export declare const TOKEN_SYMBOL_ERROR: ErrorTemplate;
+/**
+ * Wallet address format errors
+ */
+export declare const ADDRESS_FORMAT_ERROR: ErrorTemplate;
+/**
+ * WebSocket/trade timeout errors
+ */
+export declare const TRADE_TIMEOUT_ERROR: ErrorTemplate;
+/**
+ * Slippage/amount errors
+ */
+export declare const SLIPPAGE_ERROR: ErrorTemplate;
+/**
+ * Type parameter confusion
+ */
+export declare const TRADE_TYPE_ERROR: ErrorTemplate;
+/**
+ * Social URL requirement errors
+ */
+export declare const SOCIAL_URL_ERROR: ErrorTemplate;
+/**
+ * Generic validation error
+ */
+export declare const GENERIC_VALIDATION_ERROR: ErrorTemplate;
+/**
+ * All error templates in priority order (checked sequentially)
+ */
+export declare const ERROR_TEMPLATES: ErrorTemplate[];
+/**
+ * Finds the best matching error template for a message
+ */
+export declare function findErrorTemplate(message: string): ErrorTemplate | null;
+/**
+ * Gets the AI-friendly tip for an error message
+ */
+export declare function getErrorTip(message: string): string | null;
+/**
+ * Applies AI-friendly tip to error message
+ */
+export declare function enhanceErrorMessage(message: string): string;
+/**
+ * Gets error category for an error message
+ */
+export declare function getErrorCategory(message: string): string;
+export declare const errorTemplates: {
+    templates: ErrorTemplate[];
+    findTemplate: typeof findErrorTemplate;
+    getTip: typeof getErrorTip;
+    enhance: typeof enhanceErrorMessage;
+    getCategory: typeof getErrorCategory;
+};
+//# sourceMappingURL=error-templates.d.ts.map

package/dist/utils/error-templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-templates.d.ts","sourceRoot":"","sources":["../../src/utils/error-templates.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,YAAY,GAAG,SAAS,GAAG,QAAQ,GAAG,gBAAgB,GAAG,SAAS,CAAC;CAC9E;AAMD;;GAEG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;CA2Bf,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,aAS9B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,aAShC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,aAOlC,CAAC;AAMF;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,aAcjC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,aAW5B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,aAU9B,CAAC;AAMF;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,aAS9B,CAAC;AAMF;;GAEG;AACH,eAAO,MAAM,wBAAwB,EAAE,aAUtC,CAAC;AAMF;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,aAAa,EAe1C,CAAC;AAMF;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAgBvE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAG1D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAG3D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAGxD;AAMD,eAAO,MAAM,cAAc;;;;;;CAM1B,CAAC"}