@gala-chain/launchpad-mcp-server 5.0.5-beta.2 → 5.0.5-beta.20

package/dist/schemas/common-schemas.js

@@ -10,8 +10,9 @@
  * @see https://modelcontextprotocol.io/docs/concepts/tools
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TOKEN_PAIR_SCHEMA = exports.DEX_TOKEN_CLASS_KEY_SCHEMA = exports.REACTION_INPUT_SCHEMA = exports.REACTION_TYPE_SCHEMA = exports.CHAT_CONTENT_SCHEMA = exports.MESSAGE_ID_SCHEMA = exports.POOL_DISCOVERY_SCHEMA = exports.POOL_DISCOVERY_SORT_ORDER_SCHEMA = exports.POOL_DISCOVERY_SORT_BY_SCHEMA = exports.POOL_DISCOVERY_SEARCH_SCHEMA = exports.ACTIVE_USER_TYPE_SCHEMA = exports.BAN_DURATION_SCHEMA = exports.BAN_REASON_SCHEMA = exports.INVITE_SCOPE_SCHEMA = exports.INVITE_STATUS_SCHEMA = exports.INVITE_CODE_SCHEMA = exports.API_KEY_ROLE_SCHEMA = exports.MODERATOR_ROLE_SCHEMA = exports.EXPIRES_AT_SCHEMA = exports.ENTITY_DESCRIPTION_SCHEMA = exports.ENTITY_ID_SCHEMA = exports.FEE_TIER_SCHEMA = exports.DEX_TOKEN_SYMBOL_SCHEMA = exports.FLEXIBLE_TOKEN_ID_SCHEMA = exports.TOKEN_CLASS_KEY_SCHEMA = exports.CURRENT_SUPPLY_SCHEMA = exports.CALCULATION_MODE_SCHEMA = exports.SORT_ORDER_SCHEMA = exports.RBC_FEE_SLIPPAGE_SCHEMA = exports.SLIPPAGE_TOLERANCE_SCHEMA = exports.USER_PORTFOLIO_QUERY_SCHEMA = exports.OFFSET_SCHEMA = exports.PAGE_SCHEMA = exports.DATE_TIME_SCHEMA = exports.UNIQUE_KEY_SCHEMA = exports.TRANSACTION_ID_SCHEMA = exports.SEARCH_SCHEMA = exports.FULL_NAME_SCHEMA = exports.URL_SCHEMA = exports.INTEGER_AMOUNT_SCHEMA = exports.PRE_BUY_QUANTITY_SCHEMA = exports.DECIMAL_AMOUNT_SCHEMA = exports.OWNER_ADDRESS_SCHEMA = exports.RECIPIENT_ADDRESS_SCHEMA = exports.OPTIONAL_ADDRESS_SCHEMA = exports.ADDRESS_SCHEMA = exports.PRIVATE_KEY_SCHEMA = exports.TOKEN_DESCRIPTION_SCHEMA = exports.TOKEN_SYMBOL_SCHEMA = exports.TOKEN_NAME_SCHEMA = void 0;
-exports.EMPTY_INPUT_SCHEMA = exports.RTMP_URL_SCHEMA = exports.NFT_MAX_SUPPLY_SCHEMA = exports.NFT_RARITY_SCHEMA = exports.NFT_QUANTITY_SCHEMA = exports.COLLECTION_NAME_SCHEMA = exports.ADMIN_LIMIT_SCHEMA = exports.WRAP_UNWRAP_PROPERTIES = exports.BATCH_OPERATION_BASE_PROPERTIES = exports.BATCH_TOKEN_UNLOCK_EXTRA_PROPERTIES = exports.BATCH_TOKEN_LOCK_EXTRA_PROPERTIES = exports.BATCH_TOKEN_ITEM_PROPERTIES = exports.FLAG_ACTION_SCHEMA = exports.FLAG_STATUS_SCHEMA = exports.FLAG_REASON_SCHEMA = exports.CONTENT_TYPE_SCHEMA = exports.EXTERNAL_NETWORK_SCHEMA = exports.LIQUIDITY_AMOUNTS_SCHEMA = exports.DEX_POOL_QUOTE_INPUT_SCHEMA = exports.SWAP_QUOTE_INPUT_SCHEMA = exports.TOKEN_PAIR_WITH_TICKS_SCHEMA = void 0;
+exports.TOKEN_PAIR_WITH_TICKS_SCHEMA = exports.TOKEN_PAIR_SCHEMA = exports.DEX_TOKEN_CLASS_KEY_SCHEMA = exports.REACTION_INPUT_SCHEMA = exports.REACTION_TYPE_SCHEMA = exports.CHAT_CONTENT_SCHEMA = exports.MESSAGE_ID_SCHEMA = exports.POOL_DISCOVERY_SCHEMA = exports.POOL_DISCOVERY_SORT_ORDER_SCHEMA = exports.POOL_DISCOVERY_SORT_BY_SCHEMA = exports.POOL_DISCOVERY_SEARCH_SCHEMA = exports.ACTIVE_USER_TYPE_SCHEMA = exports.BAN_DURATION_SCHEMA = exports.BAN_REASON_SCHEMA = exports.INVITE_SCOPE_SCHEMA = exports.INVITE_STATUS_SCHEMA = exports.INVITE_CODE_SCHEMA = exports.API_KEY_ROLE_SCHEMA = exports.MODERATOR_ROLE_SCHEMA = exports.EXPIRES_AT_SCHEMA = exports.ENTITY_DESCRIPTION_SCHEMA = exports.ENTITY_ID_SCHEMA = exports.FEE_TIER_SCHEMA = exports.DEX_TOKEN_SYMBOL_SCHEMA = exports.FLEXIBLE_TOKEN_ID_SCHEMA = exports.TOKEN_CLASS_KEY_SCHEMA = exports.CURRENT_SUPPLY_SCHEMA = exports.CALCULATION_MODE_SCHEMA = exports.SORT_ORDER_SCHEMA = exports.RBC_FEE_SLIPPAGE_SCHEMA = exports.SLIPPAGE_TOLERANCE_SCHEMA = exports.USER_PORTFOLIO_QUERY_SCHEMA = exports.CURSOR_SCHEMA = exports.DATE_TIME_SCHEMA = exports.UNIQUE_KEY_SCHEMA = exports.TRANSACTION_ID_SCHEMA = exports.SEARCH_SCHEMA = exports.FULL_NAME_SCHEMA = exports.URL_SCHEMA = exports.INTEGER_AMOUNT_SCHEMA = exports.PRE_BUY_QUANTITY_SCHEMA = exports.DECIMAL_AMOUNT_SCHEMA = exports.OWNER_ADDRESS_SCHEMA = exports.RECIPIENT_ADDRESS_SCHEMA = exports.OPTIONAL_ADDRESS_SCHEMA = exports.ADDRESS_SCHEMA = exports.PRIVATE_KEY_SCHEMA = exports.TOKEN_DESCRIPTION_SCHEMA = exports.TOKEN_SYMBOL_SCHEMA = exports.TOKEN_NAME_SCHEMA = void 0;
+exports.EMPTY_INPUT_SCHEMA = exports.RTMP_URL_SCHEMA = exports.NFT_MAX_SUPPLY_SCHEMA = exports.NFT_RARITY_SCHEMA = exports.NFT_QUANTITY_SCHEMA = exports.COLLECTION_NAME_SCHEMA = exports.ADMIN_LIMIT_SCHEMA = exports.WRAP_UNWRAP_PROPERTIES = exports.BATCH_OPERATION_BASE_PROPERTIES = exports.BATCH_TOKEN_UNLOCK_EXTRA_PROPERTIES = exports.BATCH_TOKEN_LOCK_EXTRA_PROPERTIES = exports.BATCH_TOKEN_ITEM_PROPERTIES = exports.FLAG_ACTION_SCHEMA = exports.FLAG_STATUS_SCHEMA = exports.FLAG_REASON_SCHEMA = exports.CONTENT_TYPE_SCHEMA = exports.EXTERNAL_NETWORK_SCHEMA = exports.LIQUIDITY_AMOUNTS_SCHEMA = exports.DEX_POOL_QUOTE_INPUT_SCHEMA = exports.SWAP_QUOTE_INPUT_SCHEMA = void 0;
+exports.createPageSizeSchema = createPageSizeSchema;
 exports.createLimitSchema = createLimitSchema;
 exports.createPoolDiscoverySchema = createPoolDiscoverySchema;
 exports.createBatchTokenArraySchema = createBatchTokenArraySchema;
@@ -30,8 +31,11 @@ const constraints_js_1 = require("../utils/constraints.js");
  * can't handle it (causes "Type instantiation is excessively deep" error). We cast through
  * unknown to tell TypeScript "I know this is valid" - which it is at runtime.
  */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
 function toMCPSchema(zodSchema, customDescription) {
-    // @ts-expect-error TS2589 - zodToJsonSchema return type causes infinite recursion in type checker
+    // Using 'any' for zodSchema parameter due to Zod's complex type hierarchy with exactOptionalPropertyTypes.
+    // This is intentional - zodToJsonSchema accepts any Zod schema type and we normalize output to Record<string, unknown>
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-argument
     const jsonSchema = (0, zod_to_json_schema_1.zodToJsonSchema)(zodSchema, { $refStrategy: 'none' });
     // Extract the schema properties (removing $schema metadata)
     const { $schema, ...schemaProps } = jsonSchema;
@@ -53,7 +57,7 @@ function toMCPSchema(zodSchema, customDescription) {
  * @maxLength 20
  * @example "boba", "testtoken", "mytoken123"
  */
-exports.TOKEN_NAME_SCHEMA = toMCPSchema(launchpad_sdk_1.tokenNameSchema, 'Token name');
+exports.TOKEN_NAME_SCHEMA = toMCPSchema(launchpad_sdk_1.tokenNameSchema, 'Token name.');
 /**
  * Token symbol schema - ONLY for token creation (new token symbols)
  *
@@ -68,7 +72,7 @@ exports.TOKEN_NAME_SCHEMA = toMCPSchema(launchpad_sdk_1.tokenNameSchema, 'Token
  * @maxLength 8
  * @example "GALA", "TEST", "MTK"
  */
-exports.TOKEN_SYMBOL_SCHEMA = toMCPSchema(launchpad_sdk_1.tokenSymbolSchema, 'Token symbol');
+exports.TOKEN_SYMBOL_SCHEMA = toMCPSchema(launchpad_sdk_1.tokenSymbolSchema, 'Token symbol.');
 /**
  * Token description schema
  *
@@ -97,7 +101,7 @@ exports.PRIVATE_KEY_SCHEMA = toMCPSchema(launchpad_sdk_1.privateKeySchema, 'Opti
  * @example "0x1234567890abcdef1234567890abcdef12345678"
  * @example "eth|1234567890abcdef1234567890abcdef12345678"
  */
-exports.ADDRESS_SCHEMA = toMCPSchema(launchpad_sdk_1.flexibleAddressSchema, 'Wallet address');
+exports.ADDRESS_SCHEMA = toMCPSchema(launchpad_sdk_1.flexibleAddressSchema, 'Wallet address.');
 /**
  * Optional wallet address schema - for queries without a required wallet parameter
  *
@@ -114,7 +118,7 @@ exports.OPTIONAL_ADDRESS_SCHEMA = toMCPSchema(launchpad_sdk_1.flexibleAddressSch
  * @example "0x1234567890abcdef1234567890abcdef12345678"
  * @example "eth|1234567890abcdef1234567890abcdef12345678"
  */
-exports.RECIPIENT_ADDRESS_SCHEMA = toMCPSchema(launchpad_sdk_1.flexibleAddressSchema, 'Recipient wallet address');
+exports.RECIPIENT_ADDRESS_SCHEMA = toMCPSchema(launchpad_sdk_1.flexibleAddressSchema, 'Recipient wallet address.');
 /**
  * Wallet address for position owner lookups
  *
@@ -122,7 +126,7 @@ exports.RECIPIENT_ADDRESS_SCHEMA = toMCPSchema(launchpad_sdk_1.flexibleAddressSc
  * @example "0x1234567890abcdef1234567890abcdef12345678"
  * @example "eth|1234567890abcdef1234567890abcdef12345678"
  */
-exports.OWNER_ADDRESS_SCHEMA = toMCPSchema(launchpad_sdk_1.flexibleAddressSchema, 'Wallet address that owns the position');
+exports.OWNER_ADDRESS_SCHEMA = toMCPSchema(launchpad_sdk_1.flexibleAddressSchema, 'Wallet address that owns the position.');
 // =============================================================================
 // Amount Schemas (from SDK)
 // =============================================================================
@@ -155,7 +159,7 @@ exports.PRE_BUY_QUANTITY_SCHEMA = toMCPSchema(launchpad_sdk_1.nonNegativeDecimal
 exports.INTEGER_AMOUNT_SCHEMA = {
     type: 'string',
     pattern: '^[0-9]+$',
-    description: 'Token amount',
+    description: 'Token amount.',
 };
 // =============================================================================
 // URL & Text Schemas (from SDK)
@@ -180,7 +184,7 @@ exports.URL_SCHEMA = toMCPSchema(launchpad_sdk_1.urlSchema);
  * @example "John Doe", "Alice Smith"
  * @note Only letters and spaces allowed
  */
-exports.FULL_NAME_SCHEMA = toMCPSchema(launchpad_sdk_1.fullNameSchema, 'Full name');
+exports.FULL_NAME_SCHEMA = toMCPSchema(launchpad_sdk_1.fullNameSchema, 'Full name.');
 /**
  * Search query schema - used in user tools
  *
@@ -209,7 +213,7 @@ exports.TRANSACTION_ID_SCHEMA = toMCPSchema(launchpad_sdk_1.transactionIdSchema,
  * @example "galaconnect-operation-abc123-def456"
  * @note Prevents duplicate transactions - optional but recommended
  */
-exports.UNIQUE_KEY_SCHEMA = toMCPSchema(launchpad_sdk_1.uniqueKeySchema, 'Optional idempotency key');
+exports.UNIQUE_KEY_SCHEMA = toMCPSchema(launchpad_sdk_1.uniqueKeySchema, 'Optional idempotency key.');
 /**
  * Date-time schema - used in trade and volume queries
  *
@@ -223,42 +227,27 @@ exports.DATE_TIME_SCHEMA = toMCPSchema(launchpad_sdk_1.isoDateStringSchema);
 // Pagination Schemas (from SDK)
 // =============================================================================
 /**
- * Page number schema - DEPRECATED
+ * Cursor schema - used for cursor-based pagination
  *
- * @deprecated Use OFFSET_SCHEMA instead for offset-based pagination
- * @description Generated from SDK pageNumberSchema
- * @type number
- * @minimum 1
- * @maximum 1000
- * @example 1, 2, 50
- * @note Default: 1 (first page) - retained for backwards compatibility
- */
-exports.PAGE_SCHEMA = toMCPSchema(launchpad_sdk_1.pageNumberSchema, 'Page number (default: 1)');
-/**
- * Offset schema - used in ~15 tools for offset-based pagination
- *
- * @description Offset for pagination (0-indexed, items to skip)
- * @type number
- * @minimum 0
- * @maximum 1000000
- * @example 0, 20, 100
- * @note Default: 0 (first page)
+ * @description Cursor from previous response for pagination
+ * @type string
+ * @optional
+ * @example "eyJvZmZzZXQiOjIwfQ==", undefined (first page)
+ * @note Omit for first page, use cursor from previous response for subsequent pages
  */
-exports.OFFSET_SCHEMA = {
-    type: 'number',
-    minimum: 0,
-    maximum: 1000000,
-    description: 'Offset for pagination (default: 0)',
+exports.CURSOR_SCHEMA = {
+    type: 'string',
+    description: 'Cursor from previous response (omit for first page).',
 };
 /**
- * Creates a limit schema with operation-specific maximum
+ * Creates a page size schema with operation-specific maximum
  * Uses SDK Zod schemas and converts to JSON Schema
  *
  * @param operationType - The type of operation (trade, user, pool, priceHistory)
- * @param defaultLimit - Default limit value (typically 20)
- * @returns Limit schema with appropriate maximum
+ * @param defaultPageSize - Default page size value (typically 20)
+ * @returns Page size schema with appropriate maximum
  */
-function createLimitSchema(operationType, defaultLimit = 20) {
+function createPageSizeSchema(operationType, defaultPageSize = 20) {
     const maxLimits = {
         trade: constraints_js_1.MCP_CONSTRAINTS.TRADE_LIMIT, // 20
         user: constraints_js_1.MCP_CONSTRAINTS.USER_LIMIT, // 20
@@ -267,9 +256,16 @@ function createLimitSchema(operationType, defaultLimit = 20) {
     };
     // Use SDK Zod createLimitSchema and convert to JSON Schema
     const zodLimit = (0, launchpad_sdk_1.createLimitSchema)(maxLimits[operationType]);
-    const jsonSchemaLimit = toMCPSchema(zodLimit, `Results per page (default: ${defaultLimit}, maximum: ${maxLimits[operationType]})`);
+    const jsonSchemaLimit = toMCPSchema(zodLimit, `Results per page (default: ${defaultPageSize}, maximum: ${maxLimits[operationType]})`);
     return jsonSchemaLimit;
 }
+/**
+ * @deprecated Use createPageSizeSchema instead
+ * Backwards compatibility wrapper
+ */
+function createLimitSchema(operationType, defaultLimit = 20) {
+    return createPageSizeSchema(operationType, defaultLimit);
+}
 // =============================================================================
 // User Portfolio Query Schema (composite)
 // =============================================================================
@@ -280,7 +276,7 @@ function createLimitSchema(operationType, defaultLimit = 20) {
  * - Required address parameter
  * - Optional tokenName exact filter
  * - Optional search fuzzy filter
- * - Standard pagination (offset/limit)
+ * - Cursor-based pagination (cursor/pageSize)
  *
  * Used by: fetchTokensHeld, fetchTokensCreated
  *
@@ -298,11 +294,11 @@ function createLimitSchema(operationType, defaultLimit = 20) {
  */
 exports.USER_PORTFOLIO_QUERY_SCHEMA = {
     address: exports.ADDRESS_SCHEMA,
-    offset: exports.OFFSET_SCHEMA,
-    limit: createLimitSchema('user', 20),
+    cursor: exports.CURSOR_SCHEMA,
+    pageSize: createPageSizeSchema('user', 20),
     tokenName: {
         ...exports.TOKEN_NAME_SCHEMA,
-        description: 'Optional token name (exact match filter)',
+        description: 'Optional token name (exact match filter).',
     },
     search: exports.SEARCH_SCHEMA,
 };
@@ -323,7 +319,7 @@ exports.SLIPPAGE_TOLERANCE_SCHEMA = {
     type: 'number',
     minimum: 0,
     maximum: 1,
-    description: 'Decimal format (0.05 = 5% slippage)',
+    description: 'Decimal format (0.05 = 5% slippage).',
 };
 /**
  * Reverse bonding curve fee slippage schema
@@ -353,7 +349,7 @@ exports.RBC_FEE_SLIPPAGE_SCHEMA = {
 exports.SORT_ORDER_SCHEMA = {
     type: 'string',
     enum: ['ASC', 'DESC'],
-    description: 'Sort order (default: DESC)',
+    description: 'Sort order (default: DESC).',
 };
 /**
  * Calculation mode schema - for calculateAmountMode parameter
@@ -383,7 +379,7 @@ Use CALCULATION_MODES.EXTERNAL for network-based GalaChain calculations.`,
  */
 exports.CURRENT_SUPPLY_SCHEMA = {
     ...exports.DECIMAL_AMOUNT_SCHEMA,
-    description: 'Current token supply (optional - only used for local mode, auto-fetched if missing)',
+    description: 'Current token supply (optional - only used for local mode, auto-fetched if missing).',
 };
 /**
  * Token class key schema - for fetchTokenClassesWithSupply
@@ -406,22 +402,22 @@ exports.TOKEN_CLASS_KEY_SCHEMA = {
     properties: {
         collection: {
             type: 'string',
-            description: 'Token collection identifier (e.g., "Token", "GALA")',
+            description: 'Token collection identifier (e.g., "Token", "GALA").',
             minLength: 1,
         },
         category: {
             type: 'string',
-            description: 'Token category (e.g., "Unit")',
+            description: 'Token category (e.g., "Unit").',
             minLength: 1,
         },
         type: {
             type: 'string',
-            description: 'Token type/symbol (e.g., "GALA", "GUSDC", "UNI")',
+            description: 'Token type/symbol (e.g., "GALA", "GUSDC", "UNI").',
             minLength: 1,
         },
         additionalKey: {
             type: 'string',
-            description: 'Additional key for network/chain identification (e.g., "none", "eth:0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174")',
+            description: 'Additional key for network/chain identification (e.g., "none", "eth:0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174").',
             minLength: 1,
         },
     },
@@ -447,11 +443,11 @@ exports.FLEXIBLE_TOKEN_ID_SCHEMA = {
     oneOf: [
         {
             type: 'string',
-            description: 'Pipe-delimited format: "collection|category|type|additionalKey" (e.g., "GUSDC|Unit|none|eth:0x...")',
+            description: 'Pipe-delimited format: "collection|category|type|additionalKey" (e.g., "GUSDC|Unit|none|eth:0x...").',
         },
         {
             ...exports.TOKEN_CLASS_KEY_SCHEMA,
-            description: 'TokenClassKey object format',
+            description: 'TokenClassKey object format.',
         },
     ],
 };
@@ -477,7 +473,7 @@ exports.DEX_TOKEN_SYMBOL_SCHEMA = {
     type: 'string',
     minLength: 1,
     maxLength: 100,
-    description: 'Token identifier in pipe-delimited format (e.g., "GALA|Unit|none|none", "Token|Unit|BENE|client:xxx")',
+    description: 'Token identifier in pipe-delimited format (e.g., "GALA|Unit|none|none", "Token|Unit|BENE|client:xxx").',
 };
 /**
  * Fee tier schema - for GalaSwap DEX operations
@@ -492,7 +488,7 @@ exports.DEX_TOKEN_SYMBOL_SCHEMA = {
 exports.FEE_TIER_SCHEMA = {
     type: 'number',
     enum: [500, 3000, 10000],
-    description: 'Fee tier in basis points: 500 (0.05%), 3000 (0.30%), 10000 (1.00%)',
+    description: 'Fee tier in basis points: 500 (0.05%), 3000 (0.30%), 10000 (1.00%).',
 };
 // =============================================================================
 // Domain-Specific Schemas (Bans, Moderators, API Keys)
@@ -508,7 +504,7 @@ exports.FEE_TIER_SCHEMA = {
 exports.ENTITY_ID_SCHEMA = {
     type: 'number',
     minimum: 1,
-    description: 'Entity ID (positive integer)',
+    description: 'Entity ID (positive integer).',
 };
 /**
  * Generic description schema - for invites, API keys, etc.
@@ -521,7 +517,7 @@ exports.ENTITY_ID_SCHEMA = {
 exports.ENTITY_DESCRIPTION_SCHEMA = {
     type: 'string',
     maxLength: 255,
-    description: 'Optional description/label (max 255 characters)',
+    description: 'Optional description/label (max 255 characters).',
 };
 /**
  * Generic expiration schema - for invites, API keys, bans, etc.
@@ -548,7 +544,7 @@ exports.MODERATOR_ROLE_SCHEMA = {
     description: `Role to grant:
 - MODERATOR: Manage comments, chat messages, ban/unban users
 - TECHNICAL_PRODUCER: Simulcast targets, stream key, stop/start stream
-- MANAGER: All of the above + recordings + stream settings`,
+- MANAGER: All of the above + recordings + stream settings.`,
 };
 /**
  * API key role schema - extends moderator roles with OWNER
@@ -564,7 +560,7 @@ exports.API_KEY_ROLE_SCHEMA = {
 - MODERATOR: Manage comments, chat messages, ban/unban users
 - TECHNICAL_PRODUCER: Simulcast targets, stream key, stop/start stream
 - MANAGER: Moderator + Technical Producer + recordings + stream settings
-- OWNER: Full access (indistinguishable from normal auth)`,
+- OWNER: Full access (indistinguishable from normal auth).`,
 };
 /**
  * Invite code schema - for moderator invite magic links
@@ -577,7 +573,7 @@ exports.API_KEY_ROLE_SCHEMA = {
 exports.INVITE_CODE_SCHEMA = {
     type: 'string',
     pattern: '^[a-fA-F0-9]{64}$',
-    description: 'The 64-character hex invite code from the magic link URL',
+    description: 'The 64-character hex invite code from the magic link URL.',
 };
 /**
  * Invite status schema - for filtering moderator invites
@@ -593,7 +589,7 @@ exports.INVITE_STATUS_SCHEMA = {
 - PENDING: Not yet claimed
 - CLAIMED: Claimed by a moderator
 - REVOKED: Revoked by the owner
-- EXPIRED: Past expiration date`,
+- EXPIRED: Past expiration date.`,
 };
 /**
  * Invite scope schema - for moderator invite scope selection
@@ -607,7 +603,7 @@ exports.INVITE_SCOPE_SCHEMA = {
     enum: ['TOKEN', 'ALL_OWNER_TOKENS'],
     description: `Invite scope (default: TOKEN):
 - TOKEN: Access to a specific token only (tokenName required)
-- ALL_OWNER_TOKENS: Blanket access to ALL tokens owned by the inviter (tokenName should be omitted)`,
+- ALL_OWNER_TOKENS: Blanket access to ALL tokens owned by the inviter (tokenName should be omitted).`,
 };
 /**
  * Ban reason schema - for user ban operations
@@ -619,7 +615,7 @@ exports.INVITE_SCOPE_SCHEMA = {
 exports.BAN_REASON_SCHEMA = {
     type: 'string',
     maxLength: 500,
-    description: 'Ban reason (optional, max 500 characters)',
+    description: 'Ban reason (optional, max 500 characters).',
 };
 /**
  * Ban duration schema - for temporary bans
@@ -634,7 +630,7 @@ exports.BAN_DURATION_SCHEMA = {
     type: 'number',
     minimum: 60,
     maximum: 31536000,
-    description: 'Ban duration in seconds (optional, omit for permanent). Range: 60 (1 min) to 31536000 (1 year). Presets: 3600 (1 hour), 86400 (1 day), 604800 (1 week), 2592000 (1 month)',
+    description: 'Ban duration in seconds (optional, omit for permanent). Range: 60 (1 min) to 31536000 (1 year). Presets: 3600 (1 hour), 86400 (1 day), 604800 (1 week), 2592000 (1 month).',
 };
 /**
  * Active user type schema - for getActiveUsers
@@ -646,7 +642,7 @@ exports.BAN_DURATION_SCHEMA = {
 exports.ACTIVE_USER_TYPE_SCHEMA = {
     type: 'string',
     enum: ['viewers', 'chat_participants'],
-    description: 'Type of active users to fetch (default: viewers)',
+    description: 'Type of active users to fetch (default: viewers).',
 };
 // =============================================================================
 // Pool Discovery Schemas (DEX Pool Filtering & Sorting)
@@ -672,14 +668,14 @@ exports.POOL_DISCOVERY_SEARCH_SCHEMA = {
  *
  * @description Field to sort results by
  * @type string
- * @enum ['tvl', 'volume30d', 'volume1d']
- * @example "tvl" (total value locked), "volume30d" (30-day volume)
- * @note Default: 'tvl'
+ * @enum ['TVL', 'volume30d', 'volume1d']
+ * @example "TVL" (total value locked), "volume30d" (30-day volume)
+ * @note Default: 'TVL'
  */
 exports.POOL_DISCOVERY_SORT_BY_SCHEMA = {
     type: 'string',
-    enum: ['tvl', 'volume30d', 'volume1d'],
-    description: 'Field to sort results by (default: tvl)',
+    enum: ['TVL', 'volume30d', 'volume1d'],
+    description: 'Field to sort results by (default: TVL).',
 };
 /**
  * Pool discovery sort order schema - used in DEX pool discovery tools
@@ -693,7 +689,7 @@ exports.POOL_DISCOVERY_SORT_BY_SCHEMA = {
 exports.POOL_DISCOVERY_SORT_ORDER_SCHEMA = {
     type: 'string',
     enum: ['asc', 'desc'],
-    description: 'Sort order direction (default: desc)',
+    description: 'Sort order direction (default: desc).',
 };
 /**
  * Pool discovery schema bundle - all three fields combined for spread usage
@@ -710,7 +706,7 @@ exports.POOL_DISCOVERY_SCHEMA = {
  * Factory function to create pool discovery tool inputSchema.
  *
  * Generates consistent inputSchema for pool discovery tools with optional
- * pagination and additional properties.
+ * cursor-based pagination and additional properties.
  *
  * @param config - Configuration for the pool discovery tool
  * @returns Object containing inputSchema definition
@@ -719,7 +715,7 @@ exports.POOL_DISCOVERY_SCHEMA = {
  * // Paginated tool
  * const schema = createPoolDiscoverySchema({
  *   includePagination: true,
- *   defaultLimit: 10,
+ *   defaultPageSize: 10,
  * });
  *
  * @example
@@ -728,7 +724,7 @@ exports.POOL_DISCOVERY_SCHEMA = {
  *   additionalProperties: {
  *     withPrices: {
  *       type: 'boolean',
- *       description: 'Whether to fetch real-time pricing data',
+ *       description: 'Whether to fetch real-time pricing data.',
  *     },
  *   },
  * });
@@ -736,13 +732,13 @@ exports.POOL_DISCOVERY_SCHEMA = {
  * @since 6.10.0
  */
 function createPoolDiscoverySchema(config = {}) {
-    const { includePagination = false, defaultLimit = 10, additionalProperties = {} } = config;
+    const { includePagination = false, defaultPageSize = 10, additionalProperties = {} } = config;
     const properties = {
         ...exports.POOL_DISCOVERY_SCHEMA,
     };
     if (includePagination) {
-        properties.offset = exports.OFFSET_SCHEMA;
-        properties.limit = createLimitSchema('pool', defaultLimit);
+        properties.cursor = exports.CURSOR_SCHEMA;
+        properties.pageSize = createPageSizeSchema('pool', defaultPageSize);
     }
     // Merge additional properties
     Object.assign(properties, additionalProperties);
@@ -773,7 +769,7 @@ exports.MESSAGE_ID_SCHEMA = {
     type: 'string',
     maxLength: 64,
     pattern: '^(msg-\\d{13}-[a-f0-9]{32}|chat-\\d{13}-[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12})$',
-    description: 'Message ID in format msg-{timestamp}-{uuid} or chat-{timestamp}-{uuid} (supports both modern and legacy formats)',
+    description: 'Message ID in format msg-{timestamp}-{uuid} or chat-{timestamp}-{uuid} (supports both modern and legacy formats).',
 };
 /**
  * Chat content schema - for chat messages
@@ -789,7 +785,7 @@ exports.CHAT_CONTENT_SCHEMA = {
     type: 'string',
     minLength: 1,
     maxLength: 500,
-    description: 'Chat message content (1-500 characters)',
+    description: 'Chat message content (1-500 characters).',
 };
 /**
  * Content reaction type schema
@@ -802,7 +798,7 @@ exports.CHAT_CONTENT_SCHEMA = {
 exports.REACTION_TYPE_SCHEMA = {
     type: 'string',
     enum: ['heart', 'fire', 'laugh', 'wow', 'thumbs_up'],
-    description: 'Type of reaction: heart, fire, laugh, wow, or thumbs_up',
+    description: 'Type of reaction: heart, fire, laugh, wow, or thumbs_up.',
 };
 /**
  * Combined reaction input schema - shared by 6 content reaction tools
@@ -851,7 +847,7 @@ exports.REACTION_INPUT_SCHEMA = {
  */
 exports.DEX_TOKEN_CLASS_KEY_SCHEMA = {
     type: 'string',
-    description: 'Full token class key in pipe-delimited format (e.g., "GALA|Unit|none|none" or "Token|Unit|SYMBOL|client:xxx")',
+    description: 'Full token class key in pipe-delimited format (e.g., "GALA|Unit|none|none" or "Token|Unit|SYMBOL|client:xxx").',
 };
 // =============================================================================
 // DEX Composite Schemas (Reusable token pair + fee combinations)
@@ -868,11 +864,11 @@ exports.DEX_TOKEN_CLASS_KEY_SCHEMA = {
 exports.TOKEN_PAIR_SCHEMA = {
     token0: {
         ...exports.DEX_TOKEN_SYMBOL_SCHEMA,
-        description: 'First token in pair (e.g., "GALA" or "GALA|Unit|none|none")',
+        description: 'First token in pair (e.g., "GALA" or "GALA|Unit|none|none").',
     },
     token1: {
         ...exports.DEX_TOKEN_SYMBOL_SCHEMA,
-        description: 'Second token in pair (e.g., "GUSDC" or "Token|Unit|GUSDC|client:xxx")',
+        description: 'Second token in pair (e.g., "GUSDC" or "Token|Unit|GUSDC|client:xxx").',
     },
     fee: exports.FEE_TIER_SCHEMA,
 };
@@ -888,11 +884,11 @@ exports.TOKEN_PAIR_WITH_TICKS_SCHEMA = {
     ...exports.TOKEN_PAIR_SCHEMA,
     tickLower: {
         type: 'number',
-        description: 'Lower tick boundary of the position',
+        description: 'Lower tick boundary of the position.',
     },
     tickUpper: {
         type: 'number',
-        description: 'Upper tick boundary of the position',
+        description: 'Upper tick boundary of the position.',
     },
 };
 /**
@@ -907,15 +903,15 @@ exports.TOKEN_PAIR_WITH_TICKS_SCHEMA = {
 exports.SWAP_QUOTE_INPUT_SCHEMA = {
     fromToken: {
         ...exports.DEX_TOKEN_SYMBOL_SCHEMA,
-        description: 'Source token symbol (e.g., "GALA")',
+        description: 'Source token symbol (e.g., "GALA").',
     },
     toToken: {
         ...exports.DEX_TOKEN_SYMBOL_SCHEMA,
-        description: 'Destination token symbol (e.g., "GUSDC")',
+        description: 'Destination token symbol (e.g., "GUSDC").',
     },
     amount: {
         ...exports.DECIMAL_AMOUNT_SCHEMA,
-        description: 'Amount for the quote',
+        description: 'Amount for the quote.',
     },
 };
 /**
@@ -930,24 +926,24 @@ exports.SWAP_QUOTE_INPUT_SCHEMA = {
 exports.DEX_POOL_QUOTE_INPUT_SCHEMA = {
     token0: {
         ...exports.DEX_TOKEN_CLASS_KEY_SCHEMA,
-        description: 'First token in pool (e.g., "GALA|Unit|none|none")',
+        description: 'First token in pool (e.g., "GALA|Unit|none|none").',
     },
     token1: {
         ...exports.DEX_TOKEN_CLASS_KEY_SCHEMA,
-        description: 'Second token in pool (e.g., "Token|Unit|BENE|client:xxx")',
+        description: 'Second token in pool (e.g., "Token|Unit|BENE|client:xxx").',
     },
     fee: exports.FEE_TIER_SCHEMA,
     fromToken: {
         ...exports.DEX_TOKEN_CLASS_KEY_SCHEMA,
-        description: 'Token to swap FROM',
+        description: 'Token to swap FROM.',
     },
     toToken: {
         ...exports.DEX_TOKEN_CLASS_KEY_SCHEMA,
-        description: 'Token to swap TO',
+        description: 'Token to swap TO.',
     },
     amount: {
         ...exports.DECIMAL_AMOUNT_SCHEMA,
-        description: 'Amount of fromToken to swap',
+        description: 'Amount of fromToken to swap.',
     },
 };
 /**
@@ -961,19 +957,19 @@ exports.DEX_POOL_QUOTE_INPUT_SCHEMA = {
 exports.LIQUIDITY_AMOUNTS_SCHEMA = {
     amount0Desired: {
         ...exports.DECIMAL_AMOUNT_SCHEMA,
-        description: 'Desired amount of token0 to provide',
+        description: 'Desired amount of token0 to provide.',
     },
     amount1Desired: {
         ...exports.DECIMAL_AMOUNT_SCHEMA,
-        description: 'Desired amount of token1 to provide',
+        description: 'Desired amount of token1 to provide.',
     },
     amount0Min: {
         ...exports.DECIMAL_AMOUNT_SCHEMA,
-        description: 'Minimum acceptable amount0 (optional, defaults to 0)',
+        description: 'Minimum acceptable amount0 (optional, defaults to 0).',
     },
     amount1Min: {
         ...exports.DECIMAL_AMOUNT_SCHEMA,
-        description: 'Minimum acceptable amount1 (optional, defaults to 0)',
+        description: 'Minimum acceptable amount1 (optional, defaults to 0).',
     },
 };
 // =============================================================================
@@ -994,7 +990,7 @@ exports.LIQUIDITY_AMOUNTS_SCHEMA = {
 exports.EXTERNAL_NETWORK_SCHEMA = {
     type: 'string',
     enum: ['Ethereum', 'Solana'],
-    description: 'Target external blockchain network',
+    description: 'Target external blockchain network.',
 };
 // =============================================================================
 // Content Flag Schemas (Moderation)
@@ -1013,7 +1009,7 @@ exports.EXTERNAL_NETWORK_SCHEMA = {
 exports.CONTENT_TYPE_SCHEMA = {
     type: 'string',
     enum: Object.values(launchpad_sdk_1.ContentType),
-    description: 'Type of content being flagged (CHAT_MESSAGE, COMMENT, STREAM)',
+    description: 'Type of content being flagged (CHAT_MESSAGE, COMMENT, STREAM).',
 };
 /**
  * Flag reason schema - for content flag operations
@@ -1029,7 +1025,7 @@ exports.CONTENT_TYPE_SCHEMA = {
 exports.FLAG_REASON_SCHEMA = {
     type: 'string',
     enum: Object.values(launchpad_sdk_1.FlagReason),
-    description: 'Reason for the flag (INAPPROPRIATE_CONTENT, SPAM, HARASSMENT, SCAM, OTHER)',
+    description: 'Reason for the flag (INAPPROPRIATE_CONTENT, SPAM, HARASSMENT, SCAM, OTHER).',
 };
 /**
  * Flag status schema - for filtering and querying flags
@@ -1045,7 +1041,7 @@ exports.FLAG_REASON_SCHEMA = {
 exports.FLAG_STATUS_SCHEMA = {
     type: 'string',
     enum: Object.values(launchpad_sdk_1.FlagStatus),
-    description: 'Flag status (PENDING, DISMISSED, ACTIONED)',
+    description: 'Flag status (PENDING, DISMISSED, ACTIONED).',
 };
 /**
  * Flag action schema - for taking action on flagged content
@@ -1061,7 +1057,7 @@ exports.FLAG_STATUS_SCHEMA = {
 exports.FLAG_ACTION_SCHEMA = {
     type: 'string',
     enum: Object.values(launchpad_sdk_1.FlagAction),
-    description: 'Action to take on flagged content (DELETE_CONTENT, BAN_USER, DELETE_AND_BAN)',
+    description: 'Action to take on flagged content (DELETE_CONTENT, BAN_USER, DELETE_AND_BAN).',
 };
 // =============================================================================
 // Batch Operation Schemas (Token Locks, Unlocks, Burns, Transfers)
@@ -1078,15 +1074,15 @@ exports.FLAG_ACTION_SCHEMA = {
 exports.BATCH_TOKEN_ITEM_PROPERTIES = {
     tokenId: {
         ...exports.FLEXIBLE_TOKEN_ID_SCHEMA,
-        description: 'Token identifier (use this OR tokenName, not both)',
+        description: 'Token identifier (use this OR tokenName, not both).',
     },
     tokenName: {
         ...exports.TOKEN_NAME_SCHEMA,
-        description: 'Token name for lookup (e.g., "anime", "dragon") - used if tokenId not provided',
+        description: 'Token name for lookup (e.g., "anime", "dragon") - used if tokenId not provided.',
     },
     amount: {
         ...exports.INTEGER_AMOUNT_SCHEMA,
-        description: 'Amount of tokens in decimal format',
+        description: 'Amount of tokens in decimal format.',
     },
 };
 /**
@@ -1097,7 +1093,7 @@ exports.BATCH_TOKEN_ITEM_PROPERTIES = {
 exports.BATCH_TOKEN_LOCK_EXTRA_PROPERTIES = {
     lockAuthority: {
         type: 'string',
-        description: 'Address that can unlock these tokens (defaults to caller if not specified)',
+        description: 'Address that can unlock these tokens (defaults to caller if not specified).',
     },
     expires: {
         type: 'number',
@@ -1116,7 +1112,7 @@ exports.BATCH_TOKEN_LOCK_EXTRA_PROPERTIES = {
 exports.BATCH_TOKEN_UNLOCK_EXTRA_PROPERTIES = {
     name: {
         type: 'string',
-        description: 'Optional name to match a specific lock (must match the name used during lock)',
+        description: 'Optional name to match a specific lock (must match the name used during lock).',
     },
 };
 /**
@@ -1165,19 +1161,19 @@ exports.BATCH_OPERATION_BASE_PROPERTIES = {
 exports.WRAP_UNWRAP_PROPERTIES = {
     tokenId: {
         ...exports.FLEXIBLE_TOKEN_ID_SCHEMA,
-        description: 'Token identifier (accepts symbol, pipe-delimited string, or TokenClassKey object)',
+        description: 'Token identifier (accepts symbol, pipe-delimited string, or TokenClassKey object).',
     },
     amount: {
         ...exports.DECIMAL_AMOUNT_SCHEMA,
-        description: 'Amount to wrap/unwrap (decimal string, e.g., "100.5")',
+        description: 'Amount to wrap/unwrap (decimal string, e.g., "100.5").',
     },
     recipient: {
         ...exports.ADDRESS_SCHEMA,
-        description: 'Optional recipient address (defaults to sender)',
+        description: 'Optional recipient address (defaults to sender).',
     },
     memo: {
         type: 'string',
-        description: 'Optional memo for the transaction',
+        description: 'Optional memo for the transaction.',
     },
 };
 // =============================================================================
@@ -1199,7 +1195,7 @@ exports.ADMIN_LIMIT_SCHEMA = {
     type: 'number',
     minimum: 1,
     maximum: 50,
-    description: 'Results per page (default: 20, maximum: 50)',
+    description: 'Results per page (default: 20, maximum: 50).',
 };
 // =============================================================================
 // NFT Schemas
@@ -1218,7 +1214,7 @@ exports.ADMIN_LIMIT_SCHEMA = {
 exports.COLLECTION_NAME_SCHEMA = {
     type: 'string',
     pattern: '^[a-zA-Z0-9]{3,50}$',
-    description: 'NFT collection name (alphanumeric, 3-50 characters)',
+    description: 'NFT collection name (alphanumeric, 3-50 characters).',
 };
 /**
  * NFT quantity schema - for minting and balance operations
@@ -1234,7 +1230,7 @@ exports.COLLECTION_NAME_SCHEMA = {
 exports.NFT_QUANTITY_SCHEMA = {
     type: 'string',
     pattern: '^[1-9][0-9]*$',
-    description: 'Number of NFTs (positive integer)',
+    description: 'Number of NFTs (positive integer).',
 };
 /**
  * NFT rarity schema - for token class metadata
@@ -1250,7 +1246,7 @@ exports.NFT_QUANTITY_SCHEMA = {
 exports.NFT_RARITY_SCHEMA = {
     type: 'string',
     pattern: '^[a-zA-Z]+$',
-    description: 'Rarity tier (letters only)',
+    description: 'Rarity tier (letters only).',
 };
 /**
  * NFT max supply schema - for token class creation and limits
@@ -1266,7 +1262,7 @@ exports.NFT_RARITY_SCHEMA = {
 exports.NFT_MAX_SUPPLY_SCHEMA = {
     type: 'string',
     pattern: '^[0-9]+$',
-    description: 'Maximum supply (whole number)',
+    description: 'Maximum supply (whole number).',
 };
 // =============================================================================
 // Streaming Schemas
@@ -1290,7 +1286,7 @@ const RTMP_URL_PATTERN = '^rtmps?://[a-zA-Z0-9.-]+(:[0-9]+)?(/.*)?$';
 exports.RTMP_URL_SCHEMA = {
     type: 'string',
     pattern: RTMP_URL_PATTERN,
-    description: 'Valid RTMP URL (rtmp://host[:port][/path] or rtmps://...)',
+    description: 'Valid RTMP URL (rtmp://host[:port][/path] or rtmps://...).',
 };
 // =============================================================================
 // Empty Input Schemas (for tools with no parameters)