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

package/dist/tools/balance/index.js

@@ -3,11 +3,16 @@
  * Balance & Portfolio Tools
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.balanceTools = exports.registerAccountTool = exports.fetchReferralsSummaryTool = exports.fetchAllReferralsTool = exports.fetchReferralsTool = exports.fetchReferralUrlTool = exports.updateProfileTool = exports.fetchProfileTool = exports.fetchTokensCreatedTool = exports.fetchTokensHeldTool = exports.fetchLockedTokensTool = exports.fetchTokenBalanceTool = exports.fetchGalaBalanceTool = void 0;
+exports.balanceTools = exports.fetchAvailableBalanceTool = exports.getManagedTokensTool = exports.registerAccountTool = exports.updateProfileTool = exports.fetchProfileTool = exports.fetchTokensCreatedTool = exports.fetchTokensHeldTool = exports.fetchLockedTokensTool = exports.fetchTokenBalanceTool = exports.fetchGalaBalanceTool = exports.fetchSolanaWalletTokenBalanceTool = exports.fetchEthereumWalletTokenBalanceTool = void 0;
 const response_formatter_js_1 = require("../../utils/response-formatter.js");
 const error_handler_js_1 = require("../../utils/error-handler.js");
 const common_schemas_js_1 = require("../../schemas/common-schemas.js");
-const default_values_js_1 = require("../../utils/default-values.js");
+const handler_factories_js_1 = require("../handler-factories.js");
+const pagination_handler_factory_js_1 = require("../pagination-handler-factory.js");
+const format_balance_js_1 = require("./helpers/format-balance.js");
+const external_chain_balance_tools_js_1 = require("../bridge/helpers/external-chain-balance-tools.js");
+Object.defineProperty(exports, "fetchEthereumWalletTokenBalanceTool", { enumerable: true, get: function () { return external_chain_balance_tools_js_1.fetchEthereumWalletTokenBalanceTool; } });
+Object.defineProperty(exports, "fetchSolanaWalletTokenBalanceTool", { enumerable: true, get: function () { return external_chain_balance_tools_js_1.fetchSolanaWalletTokenBalanceTool; } });
 // 1. Fetch GALA Balance
 exports.fetchGalaBalanceTool = {
     name: 'gala_launchpad_fetch_gala_balance',
@@ -21,10 +26,7 @@ exports.fetchGalaBalanceTool = {
             },
         },
     },
-    handler: (0, error_handler_js_1.withErrorHandling)(async (sdk, args) => {
-        const result = await sdk.fetchGalaBalance(args.address);
-        return (0, response_formatter_js_1.formatSuccess)(result);
-    }),
+    handler: (0, handler_factories_js_1.createOptionalAddressFetcher)('fetchGalaBalance'),
 };
 // 2. Fetch Token Balance (Optimized Single-Token Lookup)
 exports.fetchTokenBalanceTool = {
@@ -38,14 +40,7 @@ exports.fetchTokenBalanceTool = {
         },
         required: ['tokenName', 'address'],
     },
-    handler: (0, error_handler_js_1.withErrorHandling)(async (sdk, args) => {
-        // SDK now handles routing: tokenId → GalaChain, tokenName → launchpad backend
-        const result = await sdk.fetchTokenBalance({
-            tokenName: args.tokenName,
-            address: args.address
-        });
-        return (0, response_formatter_js_1.formatSuccess)(result);
-    }),
+    handler: (0, handler_factories_js_1.createTokenAddressHandler)('fetchTokenBalance'),
 };
 // 3. Fetch Locked Tokens (Lock Details Query)
 exports.fetchLockedTokensTool = {
@@ -64,9 +59,8 @@ exports.fetchLockedTokensTool = {
         required: ['tokenName', 'address'],
     },
     handler: (0, error_handler_js_1.withErrorHandling)(async (sdk, args) => {
-        // Resolve tokenName to tokenId for GalaChain lock query
-        const tokenClassKey = await sdk.resolveTokenClassKey(args.tokenName);
-        const tokenId = `${tokenClassKey.collection}|${tokenClassKey.category}|${tokenClassKey.type}|${tokenClassKey.additionalKey}`;
+        // Resolve tokenName to tokenId using shared helper
+        const tokenId = await (0, format_balance_js_1.resolveTokenId)(sdk, args.tokenName);
         const result = await sdk.fetchLockedBalance({
             tokenId,
             address: args.address,
@@ -76,67 +70,33 @@ exports.fetchLockedTokensTool = {
     }),
 };
 // 4. Fetch Tokens Held (with Filtering Support)
+// Uses USER_PORTFOLIO_QUERY_SCHEMA and createUserPortfolioQueryHandler for DRY
 exports.fetchTokensHeldTool = {
     name: 'gala_launchpad_fetch_tokens_held',
     description: 'Get tokens held by a wallet with optional filtering. Supports exact match (tokenName) and fuzzy search (search) for efficient backend filtering.',
     inputSchema: {
         type: 'object',
-        properties: {
-            address: common_schemas_js_1.ADDRESS_SCHEMA,
-            page: common_schemas_js_1.PAGE_SCHEMA,
-            limit: (0, common_schemas_js_1.createLimitSchema)('user', 20),
-            tokenName: {
-                ...common_schemas_js_1.TOKEN_NAME_SCHEMA,
-                description: 'Optional token name (exact match filter)',
-            },
-            search: common_schemas_js_1.SEARCH_SCHEMA,
-        },
+        properties: common_schemas_js_1.USER_PORTFOLIO_QUERY_SCHEMA,
         required: ['address'],
     },
-    handler: (0, error_handler_js_1.withErrorHandling)(async (sdk, args) => {
-        const pagination = (0, default_values_js_1.applyOperationPaginationDefaults)(args, 'user');
-        const result = await sdk.fetchTokensHeld({
-            ...pagination,
-            tokenName: args.tokenName,
-            search: args.search,
-            address: args.address,
-        });
-        return (0, response_formatter_js_1.formatSuccess)(result);
-    }),
+    handler: (0, pagination_handler_factory_js_1.createUserPortfolioQueryHandler)({ sdkMethodName: 'fetchTokensHeld' }),
 };
 // 5. Fetch Tokens Created (with Filtering Support)
+// Uses USER_PORTFOLIO_QUERY_SCHEMA and createUserPortfolioQueryHandler for DRY
 exports.fetchTokensCreatedTool = {
     name: 'gala_launchpad_fetch_tokens_created',
     description: 'Get tokens created by a wallet with optional filtering. Supports exact match (tokenName) and fuzzy search (search) for efficient backend filtering.',
     inputSchema: {
         type: 'object',
-        properties: {
-            address: common_schemas_js_1.ADDRESS_SCHEMA,
-            page: common_schemas_js_1.PAGE_SCHEMA,
-            limit: (0, common_schemas_js_1.createLimitSchema)('user', 20),
-            tokenName: {
-                ...common_schemas_js_1.TOKEN_NAME_SCHEMA,
-                description: 'Optional token name (exact match filter)',
-            },
-            search: common_schemas_js_1.SEARCH_SCHEMA,
-        },
+        properties: common_schemas_js_1.USER_PORTFOLIO_QUERY_SCHEMA,
         required: ['address'],
     },
-    handler: (0, error_handler_js_1.withErrorHandling)(async (sdk, args) => {
-        const pagination = (0, default_values_js_1.applyOperationPaginationDefaults)(args, 'user');
-        const result = await sdk.fetchTokensCreated({
-            ...pagination,
-            tokenName: args.tokenName,
-            search: args.search,
-            address: args.address,
-        });
-        return (0, response_formatter_js_1.formatSuccess)(result);
-    }),
+    handler: (0, pagination_handler_factory_js_1.createUserPortfolioQueryHandler)({ sdkMethodName: 'fetchTokensCreated' }),
 };
 // 6. Fetch Profile
 exports.fetchProfileTool = {
     name: 'gala_launchpad_fetch_profile',
-    description: 'Get user profile data',
+    description: 'Get user profile data including full name, profile image, wallet address, and join date. Returns null if user has no profile yet.',
     inputSchema: {
         type: 'object',
         properties: {
@@ -146,15 +106,12 @@ exports.fetchProfileTool = {
             },
         },
     },
-    handler: (0, error_handler_js_1.withErrorHandling)(async (sdk, args) => {
-        const result = await sdk.fetchProfile(args.address);
-        return (0, response_formatter_js_1.formatSuccess)(result);
-    }),
+    handler: (0, handler_factories_js_1.createOptionalAddressFetcher)('fetchProfile'),
 };
 // 7. Update Profile
 exports.updateProfileTool = {
     name: 'gala_launchpad_update_profile',
-    description: 'Update user profile',
+    description: 'Update user profile (fullName and profileImage). Returns success flag and updated profile data.',
     inputSchema: {
         type: 'object',
         properties: {
@@ -168,141 +125,74 @@ exports.updateProfileTool = {
         },
         required: ['fullName', 'profileImage', 'address'],
     },
-    handler: (0, error_handler_js_1.withErrorHandling)(async (sdk, args) => {
-        await sdk.updateProfile({
+    handler: (0, handler_factories_js_1.createBooleanHandler)('updateProfile', (args) => [
+        {
             fullName: args.fullName,
             profileImage: args.profileImage,
-            address: args.address,
-            privateKey: args.privateKey,
-        });
-        return (0, response_formatter_js_1.formatBoolean)(true, 'Profile updated successfully');
-    }),
-};
-// 8. Fetch Referral URL
-exports.fetchReferralUrlTool = {
-    name: 'gala_launchpad_fetch_referral_url',
-    description: "Fetch the authenticated user's unique referral URL for sharing. The referral URL can be used to earn rewards when new users sign up through the link. Requires wallet configuration.",
-    inputSchema: {
-        type: 'object',
-        properties: {},
-        required: [],
-    },
-    handler: (0, error_handler_js_1.withErrorHandling)(async (sdk) => {
-        const result = await sdk.fetchReferralUrl();
-        return (0, response_formatter_js_1.formatSuccess)(result);
-    }),
-};
-// 9. Fetch Referrals (Paginated)
-exports.fetchReferralsTool = {
-    name: 'gala_launchpad_fetch_referrals',
-    description: "Fetch paginated list of users who signed up using this wallet's referral link. Returns relationship level, join date, and rewards earned from each referral.",
-    inputSchema: {
-        type: 'object',
-        properties: {
-            address: {
-                ...common_schemas_js_1.ADDRESS_SCHEMA,
-                description: 'Wallet address to fetch referrals for (defaults to SDK wallet). Supports eth|..., 0x..., or client|... formats.',
-            },
-            page: common_schemas_js_1.PAGE_SCHEMA,
-            limit: (0, common_schemas_js_1.createLimitSchema)('user', 100),
-            sortBy: {
-                type: 'string',
-                enum: ['joined'],
-                description: 'Sort field (default: joined)',
-            },
-            sortDir: {
-                type: 'string',
-                enum: ['asc', 'desc'],
-                description: "Sort direction: 'asc' or 'desc' (default: 'desc')",
-            },
         },
-        required: [],
-    },
-    handler: (0, error_handler_js_1.withErrorHandling)(async (sdk, args) => {
-        const result = await sdk.fetchReferrals({
-            address: args.address,
-            page: args.page,
-            limit: args.limit,
-            sortBy: args.sortBy,
-            sortDir: args.sortDir,
-        });
-        return (0, response_formatter_js_1.formatSuccess)(result);
-    }),
+        args.address,
+        args.privateKey,
+    ], 'Profile updated successfully'),
 };
-// 10. Fetch All Referrals (Auto-Paginated)
-exports.fetchAllReferralsTool = {
-    name: 'gala_launchpad_fetch_all_referrals',
-    description: 'Fetch all referrals for a wallet address with automatic pagination. Returns the complete list of referred users without manual pagination.',
+// 8. Register Account
+exports.registerAccountTool = {
+    name: 'gala_launchpad_register_account',
+    description: 'Register an account for trading on Gala. Call this before the first purchase to ensure the wallet is ready. Returns registration status and wallet alias. This is idempotent - calling multiple times is safe.',
     inputSchema: {
         type: 'object',
         properties: {
             address: {
                 ...common_schemas_js_1.ADDRESS_SCHEMA,
-                description: 'Wallet address to fetch referrals for (defaults to SDK wallet). Supports eth|..., 0x..., or client|... formats.',
-            },
-            sortBy: {
-                type: 'string',
-                enum: ['joined'],
-                description: 'Sort field (default: joined)',
-            },
-            sortDir: {
-                type: 'string',
-                enum: ['asc', 'desc'],
-                description: "Sort direction: 'asc' or 'desc' (default: 'desc')",
+                description: 'Wallet address to register (defaults to SDK wallet). Supports eth|..., 0x..., or client|... formats.',
             },
         },
         required: [],
     },
-    handler: (0, error_handler_js_1.withErrorHandling)(async (sdk, args) => {
-        const result = await sdk.fetchAllReferrals({
-            address: args.address,
-            sortBy: args.sortBy,
-            sortDir: args.sortDir,
-        });
-        return (0, response_formatter_js_1.formatSuccess)(result);
-    }),
+    handler: (0, handler_factories_js_1.createSimpleHandler)('registerAccount', (args) => ({
+        address: args.address,
+    })),
 };
-// 11. Fetch Referrals Summary
-exports.fetchReferralsSummaryTool = {
-    name: 'gala_launchpad_fetch_referrals_summary',
-    description: 'Fetch referral program summary statistics including total referral count and reward totals (past day, past month, all-time). Perfect for dashboards and quick overviews.',
+// 13. Get Managed Tokens (for Moderation Dashboard)
+exports.getManagedTokensTool = {
+    name: 'gala_launchpad_get_managed_tokens',
+    description: `Fetch all tokens the authenticated user can manage (owned tokens + moderated tokens + overseer status).
+
+Returns a unified view of:
+- **ownedTokens**: Tokens created by this wallet (with live status, viewer count)
+- **moderatedTokens**: Tokens where user has a moderator role (MANAGER, TECHNICAL_PRODUCER, MODERATOR) with role and invite scope details
+- **isOverseer**: Whether user has platform-wide overseer access
+- **overseerSince**: When overseer status was granted (if applicable)
+
+Use this for building moderation dashboards or determining which tokens a user can access Studio for.`,
     inputSchema: {
         type: 'object',
         properties: {
-            address: {
-                ...common_schemas_js_1.ADDRESS_SCHEMA,
-                description: 'Wallet address to fetch summary for (defaults to SDK wallet). Supports eth|..., 0x..., or client|... formats.',
-            },
+            page: common_schemas_js_1.PAGE_SCHEMA,
+            limit: (0, common_schemas_js_1.createLimitSchema)('user', 20),
         },
         required: [],
     },
-    handler: (0, error_handler_js_1.withErrorHandling)(async (sdk, args) => {
-        const result = await sdk.fetchReferralsSummary({
-            address: args.address,
-        });
-        return (0, response_formatter_js_1.formatSuccess)(result);
-    }),
+    handler: (0, handler_factories_js_1.createSimpleHandler)('getManagedTokens', (args) => ({
+        page: args.page,
+        limit: args.limit,
+    })),
 };
-// 12. Register Account
-exports.registerAccountTool = {
-    name: 'gala_launchpad_register_account',
-    description: 'Register an account for trading on Gala. Call this before the first purchase to ensure the wallet is ready. Returns registration status and wallet alias. This is idempotent - calling multiple times is safe.',
+// 14. Fetch Available Balance
+exports.fetchAvailableBalanceTool = {
+    name: 'gala_launchpad_fetch_available_balance',
+    description: 'Get available (unlocked) token balance for a wallet. Returns both total and available quantities, accounting for locks. More useful than fetchTokenBalance when you need to know how much can actually be transferred.',
     inputSchema: {
         type: 'object',
         properties: {
-            address: {
-                ...common_schemas_js_1.ADDRESS_SCHEMA,
-                description: 'Wallet address to register (defaults to SDK wallet). Supports eth|..., 0x..., or client|... formats.',
-            },
+            tokenName: common_schemas_js_1.TOKEN_NAME_SCHEMA,
+            address: common_schemas_js_1.ADDRESS_SCHEMA,
         },
-        required: [],
+        required: ['tokenName', 'address'],
     },
-    handler: (0, error_handler_js_1.withErrorHandling)(async (sdk, args) => {
-        const result = await sdk.registerAccount({
-            address: args.address,
-        });
-        return (0, response_formatter_js_1.formatSuccess)(result);
-    }),
+    handler: (0, handler_factories_js_1.createTransformingHandler)('fetchAvailableBalance', (args) => ({
+        tokenName: args.tokenName,
+        address: args.address,
+    }), (result) => (0, format_balance_js_1.formatAvailableBalance)(result)),
 };
 exports.balanceTools = [
     exports.fetchGalaBalanceTool,
@@ -312,10 +202,8 @@ exports.balanceTools = [
     exports.fetchTokensCreatedTool,
     exports.fetchProfileTool,
     exports.updateProfileTool,
-    exports.fetchReferralUrlTool,
-    exports.fetchReferralsTool,
-    exports.fetchAllReferralsTool,
-    exports.fetchReferralsSummaryTool,
     exports.registerAccountTool,
+    exports.fetchAvailableBalanceTool,
+    exports.getManagedTokensTool,
 ];
 //# sourceMappingURL=index.js.map

package/dist/tools/balance/index.js.map

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

package/dist/tools/ban/index.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Ban/Moderation Operations Tools
+ *
+ * MCP tools for user ban management including creating bans, removing bans,
+ * listing banned users, checking ban status, and getting active users.
+ *
+ * @since 5.5.0
+ */
+import type { MCPTool } from '../../types/mcp.js';
+/**
+ * 1. Create Ban
+ *
+ * Uses createTokenUserHandler factory for DRY consolidation.
+ */
+export declare const createBanTool: MCPTool;
+/**
+ * 2. Remove Ban
+ *
+ * Uses createTokenUserHandler factory for DRY consolidation.
+ */
+export declare const removeBanTool: MCPTool;
+/**
+ * 3. List Bans
+ */
+export declare const listBansTool: MCPTool;
+/**
+ * 4. Get Ban Status
+ *
+ * Uses createTokenUserHandler factory for DRY consolidation.
+ */
+export declare const getBanStatusTool: MCPTool;
+/**
+ * 5. Get Active Users
+ */
+export declare const getActiveUsersTool: MCPTool;
+export declare const banTools: MCPTool[];
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/ban/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/ban/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAsBlD;;;;GAIG;AACH,eAAO,MAAM,aAAa,EAAE,OAiC3B,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,aAAa,EAAE,OAqB3B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,YAAY,EAAE,OAwC1B,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,EAAE,OAqB9B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,OAsChC,CAAC;AAMF,eAAO,MAAM,QAAQ,EAAE,OAAO,EAM7B,CAAC"}

package/dist/tools/ban/index.js

@@ -0,0 +1,206 @@
+"use strict";
+/**
+ * Ban/Moderation Operations Tools
+ *
+ * MCP tools for user ban management including creating bans, removing bans,
+ * listing banned users, checking ban status, and getting active users.
+ *
+ * @since 5.5.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.banTools = exports.getActiveUsersTool = exports.getBanStatusTool = exports.listBansTool = exports.removeBanTool = exports.createBanTool = void 0;
+const handler_factories_js_1 = require("../handler-factories.js");
+const common_schemas_js_1 = require("../../schemas/common-schemas.js");
+// =============================================================================
+// Ban Management Tools
+// =============================================================================
+/**
+ * 1. Create Ban
+ *
+ * Uses createTokenUserHandler factory for DRY consolidation.
+ */
+exports.createBanTool = {
+    name: 'gala_launchpad_create_ban',
+    description: `Create a ban for a user on a token.
+
+Bans prevent users from sending chat messages and reactions on the specified token's stream.
+Can be permanent (omit durationSeconds) or temporary (specify duration).
+
+**Duration Presets:**
+- 1 hour: 3600
+- 1 day: 86400
+- 1 week: 604800
+- 1 month: 2592000
+
+RETURNS: { ban: { id, userAddress, tokenName, reason, bannedBy, expiresAt, createdAt, isPermanent }, tokenName }
+
+Authentication: Requires streamAdminApiKey (admin) OR JWT auth (token owner)`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            tokenName: common_schemas_js_1.TOKEN_NAME_SCHEMA,
+            userAddress: {
+                ...common_schemas_js_1.ADDRESS_SCHEMA,
+                description: 'Wallet address of user to ban',
+            },
+            reason: common_schemas_js_1.BAN_REASON_SCHEMA,
+            durationSeconds: common_schemas_js_1.BAN_DURATION_SCHEMA,
+        },
+        required: ['tokenName', 'userAddress'],
+    },
+    handler: (0, handler_factories_js_1.createTokenUserHandler)('createBan', (args) => ({
+        reason: args.reason,
+        durationSeconds: args.durationSeconds,
+    })),
+};
+/**
+ * 2. Remove Ban
+ *
+ * Uses createTokenUserHandler factory for DRY consolidation.
+ */
+exports.removeBanTool = {
+    name: 'gala_launchpad_remove_ban',
+    description: `Remove a ban for a user on a token.
+
+Unbans the user, allowing them to send chat messages and reactions again.
+
+RETURNS: { removed: true, tokenName, userAddress }
+
+Authentication: Requires streamAdminApiKey (admin) OR JWT auth (token owner)`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            tokenName: common_schemas_js_1.TOKEN_NAME_SCHEMA,
+            userAddress: {
+                ...common_schemas_js_1.ADDRESS_SCHEMA,
+                description: 'Wallet address of user to unban',
+            },
+        },
+        required: ['tokenName', 'userAddress'],
+    },
+    handler: (0, handler_factories_js_1.createTokenUserHandler)('removeBan'),
+};
+/**
+ * 3. List Bans
+ */
+exports.listBansTool = {
+    name: 'gala_launchpad_list_bans',
+    description: `List all banned users for a token.
+
+Returns a paginated list of banned users with their ban details.
+Supports filtering by search query, name, or user address.
+
+**Filter Behavior:**
+- search: Combined search on userAddress OR fullName (partial match)
+- name: Filter by fullName only
+- userAddress: Filter by userAddress only
+
+RETURNS: { bans: [...], meta: { total, page, limit, totalPages } }
+
+Authentication: Requires streamAdminApiKey (admin) OR JWT auth (token owner)`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            tokenName: common_schemas_js_1.TOKEN_NAME_SCHEMA,
+            page: common_schemas_js_1.PAGE_SCHEMA,
+            limit: (0, common_schemas_js_1.createLimitSchema)('pool', 20),
+            search: common_schemas_js_1.SEARCH_SCHEMA,
+            name: {
+                type: 'string',
+                maxLength: 100,
+                description: 'Filter by fullName only (case-insensitive, partial match)',
+            },
+            userAddress: {
+                type: 'string',
+                maxLength: 100,
+                description: 'Filter by userAddress only (case-insensitive, partial match)',
+            },
+        },
+        required: ['tokenName'],
+    },
+    handler: (0, handler_factories_js_1.createSimpleHandler)('listBans', (args) => ({
+        tokenName: args.tokenName,
+        ...(0, handler_factories_js_1.extractPaginationArgs)(args),
+        ...(0, handler_factories_js_1.extractSearchFilterArgs)(args),
+    })),
+};
+/**
+ * 4. Get Ban Status
+ *
+ * Uses createTokenUserHandler factory for DRY consolidation.
+ */
+exports.getBanStatusTool = {
+    name: 'gala_launchpad_get_ban_status',
+    description: `Check if a specific user is banned on a token.
+
+Returns whether the user is currently banned and ban details if applicable.
+
+RETURNS: { banned: boolean, ban?: { ... }, tokenName, userAddress }
+
+Authentication: Requires streamAdminApiKey (admin) OR JWT auth (token owner)`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            tokenName: common_schemas_js_1.TOKEN_NAME_SCHEMA,
+            userAddress: {
+                ...common_schemas_js_1.ADDRESS_SCHEMA,
+                description: 'Wallet address of user to check',
+            },
+        },
+        required: ['tokenName', 'userAddress'],
+    },
+    handler: (0, handler_factories_js_1.createTokenUserHandler)('getBanStatus'),
+};
+/**
+ * 5. Get Active Users
+ */
+exports.getActiveUsersTool = {
+    name: 'gala_launchpad_get_active_users',
+    description: `Get currently active users on a token's stream.
+
+Returns up to 1000 active viewers or chat participants.
+Useful for moderation - see who's watching/chatting before issuing bans.
+
+**User Types:**
+- viewers: All users currently connected to the stream
+- chat_participants: Users who have sent chat messages
+
+RETURNS: { tokenName, type, users: [...], total, truncated }
+
+Authentication: Requires streamAdminApiKey (admin) OR JWT auth (token owner)`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            tokenName: common_schemas_js_1.TOKEN_NAME_SCHEMA,
+            type: common_schemas_js_1.ACTIVE_USER_TYPE_SCHEMA,
+            search: common_schemas_js_1.SEARCH_SCHEMA,
+            name: {
+                type: 'string',
+                maxLength: 100,
+                description: 'Filter by fullName only (case-insensitive, partial match)',
+            },
+            userAddress: {
+                type: 'string',
+                maxLength: 100,
+                description: 'Filter by userAddress only (case-insensitive, partial match)',
+            },
+        },
+        required: ['tokenName'],
+    },
+    handler: (0, handler_factories_js_1.createSimpleHandler)('getActiveUsers', (args) => ({
+        tokenName: args.tokenName,
+        type: args.type,
+        ...(0, handler_factories_js_1.extractSearchFilterArgs)(args),
+    })),
+};
+// =============================================================================
+// Export All Tools
+// =============================================================================
+exports.banTools = [
+    exports.createBanTool,
+    exports.removeBanTool,
+    exports.listBansTool,
+    exports.getBanStatusTool,
+    exports.getActiveUsersTool,
+];
+//# sourceMappingURL=index.js.map

package/dist/tools/ban/index.js.map

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