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

package/dist/tools/overseers/cache-management.js

@@ -0,0 +1,151 @@
+"use strict";
+/**
+ * Cache Management Tools
+ *
+ * MCP tools for cache flush operations (Admin/Overseer only).
+ * Used to clear cached data for debugging, testing, or resolving stale data issues.
+ *
+ * @since 8.x.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cacheManagementTools = exports.flushAllCacheTool = exports.flushCacheByTokenTool = exports.flushCacheByAddressTool = void 0;
+const handler_factories_js_1 = require("../handler-factories.js");
+const common_schemas_js_1 = require("../../schemas/common-schemas.js");
+// =============================================================================
+// Cache Management Schemas
+// =============================================================================
+/**
+ * Flush confirmation schema - required for flush-all to prevent accidents
+ */
+const FLUSH_CONFIRM_SCHEMA = {
+    type: 'boolean',
+    description: 'Safety confirmation flag - MUST be true to proceed with flush all cache. This is the nuclear option!',
+};
+// =============================================================================
+// Cache Flush Tools
+// =============================================================================
+/**
+ * 1. Flush Cache By Address
+ */
+exports.flushCacheByAddressTool = {
+    name: 'gala_launchpad_flush_cache_by_address',
+    description: `Flush all cache entries for a wallet address.
+
+Clears all cached data associated with the specified address including:
+- User profile data (profile:data:*, profile:stats:*)
+- Overseer status
+- Owned tokens list
+- Ban status (global and per-token)
+- Moderator access entries
+
+Use this when:
+- User data appears stale or incorrect
+- After debugging user-specific issues
+- Resolving profile display inconsistencies
+
+RETURNS: { flushedCount, duration, target }
+- flushedCount: Number of cache keys flushed
+- duration: Time taken in milliseconds
+- target: Normalized address that was flushed
+
+Authentication: Requires streamAdminApiKey (admin) OR JWT auth as existing Overseer.`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            address: {
+                ...common_schemas_js_1.ADDRESS_SCHEMA,
+                description: 'Wallet address to flush cache for (eth|... or 0x... format).',
+            },
+        },
+        required: ['address'],
+    },
+    handler: (0, handler_factories_js_1.createSimpleHandler)('flushCacheByAddress', (args) => args.address),
+};
+/**
+ * 2. Flush Cache By Token
+ */
+exports.flushCacheByTokenTool = {
+    name: 'gala_launchpad_flush_cache_by_token',
+    description: `Flush all cache entries for a token.
+
+Clears all cached data associated with the specified token including:
+- Stream chat messages and pinned messages
+- Recordings list
+- Holders data and rankings
+- Token ban status
+- Price data (GALA and USD)
+- Vault address mapping
+
+Use this when:
+- Token data appears stale or incorrect
+- Chat/stream data seems outdated
+- Price or holder data is inconsistent
+- After modifying token settings
+
+RETURNS: { flushedCount, duration, target }
+- flushedCount: Number of cache keys flushed
+- duration: Time taken in milliseconds
+- target: Normalized token name that was flushed
+
+Authentication: Requires streamAdminApiKey (admin) OR JWT auth as existing Overseer.`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            tokenName: {
+                ...common_schemas_js_1.TOKEN_NAME_SCHEMA,
+                description: 'Token name to flush cache for (case-insensitive).',
+            },
+        },
+        required: ['tokenName'],
+    },
+    handler: (0, handler_factories_js_1.createSimpleHandler)('flushCacheByToken', (args) => args.tokenName),
+};
+/**
+ * 3. Flush All Cache (Nuclear Option)
+ */
+exports.flushAllCacheTool = {
+    name: 'gala_launchpad_flush_all_cache',
+    description: `⚠️ NUCLEAR OPTION: Flush ALL Launchpad cache.
+
+Clears ALL cached data across the entire Launchpad platform. This includes:
+- All user profile data
+- All token data (chat, recordings, holders, prices)
+- All overseer/moderator access data
+- All ban status data
+- Site configuration cache
+- Everything else
+
+**WARNING:** This will cause a temporary performance hit as all data
+needs to be re-fetched from the database. Use only when absolutely necessary.
+
+**Safety Feature:** Requires confirm=true to prevent accidental usage.
+
+Use this when:
+- Major cache corruption suspected
+- After database migrations
+- Debugging platform-wide issues
+- Testing cache behavior
+
+RETURNS: { flushedCount, duration }
+- flushedCount: Total number of cache keys flushed
+- duration: Time taken in milliseconds
+
+Authentication: Requires streamAdminApiKey (admin) OR JWT auth as existing Overseer.`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            confirm: FLUSH_CONFIRM_SCHEMA,
+        },
+        required: ['confirm'],
+    },
+    handler: (0, handler_factories_js_1.createSimpleHandler)('flushAllCache', (args) => args.confirm),
+};
+// =============================================================================
+// Export All Tools
+// =============================================================================
+exports.cacheManagementTools = [
+    exports.flushCacheByAddressTool,
+    exports.flushCacheByTokenTool,
+    exports.flushAllCacheTool,
+];
+//# sourceMappingURL=cache-management.js.map

package/dist/tools/overseers/cache-management.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-management.js","sourceRoot":"","sources":["../../../src/tools/overseers/cache-management.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AAGH,kEAA8D;AAC9D,uEAAoF;AAEpF,gFAAgF;AAChF,2BAA2B;AAC3B,gFAAgF;AAEhF;;GAEG;AACH,MAAM,oBAAoB,GAAG;IAC3B,IAAI,EAAE,SAAkB;IACxB,WAAW,EAAE,sGAAsG;CACpH,CAAC;AAEF,gFAAgF;AAChF,oBAAoB;AACpB,gFAAgF;AAEhF;;GAEG;AACU,QAAA,uBAAuB,GAAY;IAC9C,IAAI,EAAE,uCAAuC;IAC7C,WAAW,EAAE;;;;;;;;;;;;;;;;;;;qFAmBsE;IACnF,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,OAAO,EAAE;gBACP,GAAG,kCAAc;gBACjB,WAAW,EAAE,8DAA8D;aAC5E;SACF;QACD,QAAQ,EAAE,CAAC,SAAS,CAAC;KACtB;IACD,OAAO,EAAE,IAAA,0CAAmB,EAAC,qBAAqB,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAiB,CAAC;CACtF,CAAC;AAEF;;GAEG;AACU,QAAA,qBAAqB,GAAY;IAC5C,IAAI,EAAE,qCAAqC;IAC3C,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;qFAqBsE;IACnF,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,SAAS,EAAE;gBACT,GAAG,qCAAiB;gBACpB,WAAW,EAAE,mDAAmD;aACjE;SACF;QACD,QAAQ,EAAE,CAAC,WAAW,CAAC;KACxB;IACD,OAAO,EAAE,IAAA,0CAAmB,EAAC,mBAAmB,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,SAAmB,CAAC;CACtF,CAAC;AAEF;;GAEG;AACU,QAAA,iBAAiB,GAAY;IACxC,IAAI,EAAE,gCAAgC;IACtC,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;qFAyBsE;IACnF,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,OAAO,EAAE,oBAAoB;SAC9B;QACD,QAAQ,EAAE,CAAC,SAAS,CAAC;KACtB;IACD,OAAO,EAAE,IAAA,0CAAmB,EAAC,eAAe,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAe,CAAC;CAC9E,CAAC;AAEF,gFAAgF;AAChF,mBAAmB;AACnB,gFAAgF;AAEnE,QAAA,oBAAoB,GAAc;IAC7C,+BAAuB;IACvB,6BAAqB;IACrB,yBAAiB;CAClB,CAAC"}

package/dist/tools/overseers/getOverseerUserSummary.js

@@ -24,13 +24,13 @@ for a specific user. Perfect for overseer dashboard user detail pages.
 
 RETURNS: { address, profile: { name, image, bio }, statistics: { tokens, positions, trades }, metrics: { flagsReceived, activeBans }, createdAt }
 
-Authentication: Requires streamAdminApiKey (admin) OR JWT auth as existing Overseer`,
+Authentication: Requires streamAdminApiKey (admin) OR JWT auth as existing Overseer.`,
     inputSchema: {
         type: 'object',
         properties: {
             userAddress: {
                 ...common_schemas_js_1.ADDRESS_SCHEMA,
-                description: 'User wallet address to get summary for',
+                description: 'User wallet address to get summary for.',
             },
         },
         required: ['userAddress'],

package/dist/tools/overseers/getOverseerUserSummary.js.map

@@ -1 +1 @@
-{"version":3,"file":"getOverseerUserSummary.js","sourceRoot":"","sources":["../../../src/tools/overseers/getOverseerUserSummary.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAGH,kEAA8D;AAC9D,uEAAiE;AAEjE;;;;GAIG;AACU,QAAA,0BAA0B,GAAY;IACjD,IAAI,EAAE,0CAA0C;IAChD,WAAW,EAAE;;;;;;;oFAOqE;IAClF,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,WAAW,EAAE;gBACX,GAAG,kCAAc;gBACjB,WAAW,EAAE,wCAAwC;aACtD;SACF;QACD,QAAQ,EAAE,CAAC,aAAa,CAAC;KAC1B;IACD,OAAO,EAAE,IAAA,0CAAmB,EAAC,wBAAwB,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,WAAqB,CAAC;CAC7F,CAAC"}
+{"version":3,"file":"getOverseerUserSummary.js","sourceRoot":"","sources":["../../../src/tools/overseers/getOverseerUserSummary.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAGH,kEAA8D;AAC9D,uEAAiE;AAEjE;;;;GAIG;AACU,QAAA,0BAA0B,GAAY;IACjD,IAAI,EAAE,0CAA0C;IAChD,WAAW,EAAE;;;;;;;qFAOsE;IACnF,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,WAAW,EAAE;gBACX,GAAG,kCAAc;gBACjB,WAAW,EAAE,yCAAyC;aACvD;SACF;QACD,QAAQ,EAAE,CAAC,aAAa,CAAC;KAC1B;IACD,OAAO,EAAE,IAAA,0CAAmB,EAAC,wBAAwB,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,WAAqB,CAAC;CAC7F,CAAC"}

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

@@ -45,13 +45,22 @@ export declare const listOverseersTool: MCPTool;
 /**
  * 7. Revoke Overseer
  */
+/**
+ * 7. Create Overseer Directly
+ *
+ * @since 8.3.0
+ */
+export declare const createOverseerDirectTool: MCPTool;
+/**
+ * 8. Revoke Overseer
+ */
 export declare const revokeOverseerTool: MCPTool;
 /**
- * 8. Get My Overseer Status
+ * 9. Get My Overseer Status
  */
 export declare const getMyOverseerStatusTool: MCPTool;
 /**
- * 9. Get Platform Summary (CCTV Dashboard)
+ * 10. Get Platform Summary (CCTV Dashboard)
  */
 export declare const getOverseerSummaryTool: MCPTool;
 export declare const overseerTools: MCPTool[];

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/overseers/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AA8ElD;;GAEG;AACH,eAAO,MAAM,wBAAwB,EAAE,OAyBtC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,EAAE,OAsBrC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,2BAA2B,EAAE,OAuBzC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,uBAAuB,EAAE,OAsBrC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,wBAAwB,EAAE,OAsBtC,CAAC;AAMF;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,EAAE,OAsB/B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,OAwBhC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,uBAAuB,EAAE,OAgBrC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,sBAAsB,EAAE,OAuBpC,CAAC;AAMF,eAAO,MAAM,aAAa,EAAE,OAAO,EAYlC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/overseers/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AA8ElD;;GAEG;AACH,eAAO,MAAM,wBAAwB,EAAE,OAyBtC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,EAAE,OAuBrC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,2BAA2B,EAAE,OAuBzC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,uBAAuB,EAAE,OAsBrC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,wBAAwB,EAAE,OAsBtC,CAAC;AAMF;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,EAAE,OAuB/B,CAAC;AAEF;;GAEG;AACH;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,EAAE,OA4BtC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,OAwBhC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,uBAAuB,EAAE,OAgBrC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,sBAAsB,EAAE,OAuBpC,CAAC;AAMF,eAAO,MAAM,aAAa,EAAE,OAAO,EAclC,CAAC"}

package/dist/tools/overseers/index.js

@@ -15,12 +15,13 @@
  * @since 5.9.0
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.overseerTools = exports.getOverseerSummaryTool = exports.getMyOverseerStatusTool = exports.revokeOverseerTool = exports.listOverseersTool = exports.revokeOverseerInviteTool = exports.claimOverseerInviteTool = exports.getOverseerInviteByCodeTool = exports.listOverseerInvitesTool = exports.createOverseerInviteTool = void 0;
+exports.overseerTools = exports.getOverseerSummaryTool = exports.getMyOverseerStatusTool = exports.revokeOverseerTool = exports.createOverseerDirectTool = exports.listOverseersTool = exports.revokeOverseerInviteTool = exports.claimOverseerInviteTool = exports.getOverseerInviteByCodeTool = exports.listOverseerInvitesTool = exports.createOverseerInviteTool = void 0;
 const handler_factories_js_1 = require("../handler-factories.js");
 const common_schemas_js_1 = require("../../schemas/common-schemas.js");
 const launchpad_sdk_1 = require("@gala-chain/launchpad-sdk");
 const listOverseerUsers_js_1 = require("./listOverseerUsers.js");
 const getOverseerUserSummary_js_1 = require("./getOverseerUserSummary.js");
+const cache_management_js_1 = require("./cache-management.js");
 // =============================================================================
 // Overseer-Specific Schemas
 // =============================================================================
@@ -29,7 +30,7 @@ const getOverseerUserSummary_js_1 = require("./getOverseerUserSummary.js");
  */
 const OVERSEER_INVITE_ID_SCHEMA = {
     ...common_schemas_js_1.ENTITY_ID_SCHEMA,
-    description: 'Overseer invite ID (positive integer)',
+    description: 'Overseer invite ID (positive integer).',
 };
 /**
  * Overseer invite description schema
@@ -45,7 +46,7 @@ const OVERSEER_INVITE_CODE_SCHEMA = {
     type: 'string',
     minLength: 1,
     maxLength: 100,
-    description: 'The invite code from the magic link URL',
+    description: 'The invite code from the magic link URL.',
 };
 /**
  * Overseer invite status schema
@@ -57,7 +58,7 @@ const OVERSEER_INVITE_STATUS_SCHEMA = {
 - PENDING: Not yet claimed
 - CLAIMED: Claimed by an overseer
 - REVOKED: Revoked by admin/overseer
-- EXPIRED: Past expiration date`,
+- EXPIRED: Past expiration date.`,
 };
 /**
  * Overseer status schema
@@ -67,7 +68,7 @@ const OVERSEER_STATUS_FILTER_SCHEMA = {
     enum: Object.values(launchpad_sdk_1.OVERSEER_STATUS),
     description: `Filter overseers by status:
 - ACTIVE: Currently active overseer
-- REVOKED: Access has been revoked`,
+- REVOKED: Access has been revoked.`,
 };
 // =============================================================================
 // Overseer Invite Tools
@@ -87,7 +88,7 @@ The recipient claims the invite after logging in.
 
 RETURNS: { invite: { id, inviteCode, inviteUrl, invitedBy, claimedBy, description, status, expiresAt, createdAt } }
 
-Authentication: Requires streamAdminApiKey (admin) OR JWT auth as existing Overseer`,
+Authentication: Requires streamAdminApiKey (admin) OR JWT auth as existing Overseer.`,
     inputSchema: {
         type: 'object',
         properties: {
@@ -108,25 +109,26 @@ Authentication: Requires streamAdminApiKey (admin) OR JWT auth as existing Overs
  */
 exports.listOverseerInvitesTool = {
     name: 'gala_launchpad_list_overseer_invites',
-    description: `List all overseer invites with pagination and filtering.
+    description: `List all overseer invites with cursor-based pagination and filtering.
 
 Returns a paginated list of overseer invites that can be filtered by status.
 
-RETURNS: { invites: [...], meta: { totalItems, currentPage, pageSize, totalPages } }
+RETURNS: { invites: [...], pageInfo: { hasNextPage, endCursor, hasPreviousPage, startCursor } }
 
-Authentication: Requires streamAdminApiKey (admin) OR JWT auth as existing Overseer`,
+Authentication: Requires streamAdminApiKey (admin) OR JWT auth as existing Overseer.`,
     inputSchema: {
         type: 'object',
         properties: {
             status: OVERSEER_INVITE_STATUS_SCHEMA,
-            page: common_schemas_js_1.OFFSET_SCHEMA,
-            limit: common_schemas_js_1.ADMIN_LIMIT_SCHEMA,
+            cursor: common_schemas_js_1.CURSOR_SCHEMA,
+            pageSize: common_schemas_js_1.ADMIN_LIMIT_SCHEMA,
         },
         required: [],
     },
     handler: (0, handler_factories_js_1.createSimpleHandler)('listOverseerInvites', (args) => ({
         status: (0, handler_factories_js_1.extractStatusArg)(args),
-        ...(0, handler_factories_js_1.extractPaginationArgs)(args),
+        cursor: args.cursor,
+        pageSize: args.pageSize,
     })),
 };
 /**
@@ -146,7 +148,7 @@ by the frontend to display invite details before the user logs in to claim.
 
 RETURNS: { description, status, expiresAt, invitedBy: { address, fullName } }
 
-Authentication: None required (public endpoint)`,
+Authentication: None required (public endpoint).`,
     inputSchema: {
         type: 'object',
         properties: {
@@ -172,7 +174,7 @@ user's wallet becomes an overseer with GLOBAL access to ALL tokens on the platfo
 
 RETURNS: { invite: { id, inviteCode, inviteUrl, invitedBy, claimedBy, description, status, expiresAt, claimedAt, createdAt } }
 
-Authentication: Requires JWT auth`,
+Authentication: Requires JWT auth.`,
     inputSchema: {
         type: 'object',
         properties: {
@@ -194,7 +196,7 @@ the overseer loses access to the platform.
 
 RETURNS: { success: true, message: "Invite revoked" }
 
-Authentication: Requires streamAdminApiKey (admin) OR JWT auth as existing Overseer`,
+Authentication: Requires streamAdminApiKey (admin) OR JWT auth as existing Overseer.`,
     inputSchema: {
         type: 'object',
         properties: {
@@ -214,30 +216,68 @@ Authentication: Requires streamAdminApiKey (admin) OR JWT auth as existing Overs
  */
 exports.listOverseersTool = {
     name: 'gala_launchpad_list_overseers',
-    description: `List all overseers with pagination and filtering.
+    description: `List all overseers with cursor-based pagination and filtering.
 
 Returns a paginated list of overseers that can be filtered by status.
 
-RETURNS: { overseers: [...], meta: { totalItems, currentPage, pageSize, totalPages } }
+RETURNS: { overseers: [...], pageInfo: { hasNextPage, endCursor, hasPreviousPage, startCursor } }
 
-Authentication: Requires streamAdminApiKey (admin) OR JWT auth as existing Overseer`,
+Authentication: Requires streamAdminApiKey (admin) OR JWT auth as existing Overseer.`,
     inputSchema: {
         type: 'object',
         properties: {
             status: OVERSEER_STATUS_FILTER_SCHEMA,
-            page: common_schemas_js_1.OFFSET_SCHEMA,
-            limit: common_schemas_js_1.ADMIN_LIMIT_SCHEMA,
+            cursor: common_schemas_js_1.CURSOR_SCHEMA,
+            pageSize: common_schemas_js_1.ADMIN_LIMIT_SCHEMA,
         },
         required: [],
     },
     handler: (0, handler_factories_js_1.createSimpleHandler)('listOverseers', (args) => ({
         status: (0, handler_factories_js_1.extractStatusArg)(args),
-        ...(0, handler_factories_js_1.extractPaginationArgs)(args),
+        cursor: args.cursor,
+        pageSize: args.pageSize,
     })),
 };
 /**
  * 7. Revoke Overseer
  */
+/**
+ * 7. Create Overseer Directly
+ *
+ * @since 8.3.0
+ */
+exports.createOverseerDirectTool = {
+    name: 'gala_launchpad_create_overseer_direct',
+    description: `Create an overseer directly (bypassing invite flow).
+
+Directly promotes a user to overseer status without requiring them to claim an invite.
+A synthetic invite record is created for audit trail.
+
+Use this when you need to promote someone programmatically without requiring their
+interaction (e.g., CLI admin tools, automated tests).
+
+RETURNS: { overseer: { id, userAddress, inviteId, status, createdAt } }
+
+Authentication: Requires streamAdminApiKey (admin) OR JWT auth as existing Overseer.`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            userAddress: {
+                ...common_schemas_js_1.ADDRESS_SCHEMA,
+                description: 'Wallet address to promote to overseer (eth|... or 0x... format).',
+            },
+            description: OVERSEER_DESCRIPTION_SCHEMA,
+        },
+        required: ['userAddress'],
+    },
+    handler: (0, handler_factories_js_1.createSimpleHandler)('createOverseerDirect', (args) => ({
+        userAddress: args.userAddress,
+        description: args.description,
+    })),
+};
+/**
+ * 8. Revoke Overseer
+ */
 exports.revokeOverseerTool = {
     name: 'gala_launchpad_revoke_overseer',
     description: `Revoke an overseer's access.
@@ -246,13 +286,13 @@ Revokes an overseer by wallet address, removing their global platform access.
 
 RETURNS: { success: true, message: "Overseer access revoked" }
 
-Authentication: Requires streamAdminApiKey (admin) OR JWT auth as existing Overseer`,
+Authentication: Requires streamAdminApiKey (admin) OR JWT auth as existing Overseer.`,
     inputSchema: {
         type: 'object',
         properties: {
             address: {
                 ...common_schemas_js_1.ADDRESS_SCHEMA,
-                description: 'Wallet address of the overseer to revoke (eth|... or 0x... format)',
+                description: 'Wallet address of the overseer to revoke (eth|... or 0x... format).',
             },
         },
         required: ['address'],
@@ -260,7 +300,7 @@ Authentication: Requires streamAdminApiKey (admin) OR JWT auth as existing Overs
     handler: (0, handler_factories_js_1.createBooleanHandler)('revokeOverseer', (args) => args.address, 'Overseer access revoked'),
 };
 /**
- * 8. Get My Overseer Status
+ * 9. Get My Overseer Status
  */
 exports.getMyOverseerStatusTool = {
     name: 'gala_launchpad_get_my_overseer_status',
@@ -271,7 +311,7 @@ and their details if so.
 
 RETURNS: { isOverseer: boolean, overseer?: { id, userAddress, inviteId, status, createdAt } }
 
-Authentication: Requires JWT auth`,
+Authentication: Requires JWT auth.`,
     inputSchema: {
         type: 'object',
         properties: {},
@@ -280,7 +320,7 @@ Authentication: Requires JWT auth`,
     handler: (0, handler_factories_js_1.createConvenienceFetcher)('getMyOverseerStatus'),
 };
 /**
- * 9. Get Platform Summary (CCTV Dashboard)
+ * 10. Get Platform Summary (CCTV Dashboard)
  */
 exports.getOverseerSummaryTool = {
     name: 'gala_launchpad_get_overseer_summary',
@@ -298,7 +338,7 @@ Use this for dashboard header stats. For detailed data, use:
 
 RETURNS: { activeStreams, totalViewers, pendingFlags, totalPools }
 
-Authentication: Requires streamAdminApiKey (admin) OR JWT auth as Overseer`,
+Authentication: Requires streamAdminApiKey (admin) OR JWT auth as Overseer.`,
     inputSchema: {
         type: 'object',
         properties: {},
@@ -316,10 +356,12 @@ exports.overseerTools = [
     exports.claimOverseerInviteTool,
     exports.revokeOverseerInviteTool,
     exports.listOverseersTool,
+    exports.createOverseerDirectTool,
     exports.revokeOverseerTool,
     exports.getMyOverseerStatusTool,
     exports.getOverseerSummaryTool,
     listOverseerUsers_js_1.listOverseerUsersTool,
     getOverseerUserSummary_js_1.getOverseerUserSummaryTool,
+    ...cache_management_js_1.cacheManagementTools,
 ];
 //# sourceMappingURL=index.js.map

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

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

package/dist/tools/overseers/listOverseerUsers.d.ts

@@ -2,6 +2,7 @@
  * List Overseer Users Tool
  *
  * MCP tool for listing users with pagination and sorting.
+ * Uses cursor-based pagination for efficient result navigation.
  *
  * @since 6.x.0
  */

package/dist/tools/overseers/listOverseerUsers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"listOverseerUsers.d.ts","sourceRoot":"","sources":["../../../src/tools/overseers/listOverseerUsers.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAsBlD;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,EAAE,OAyCnC,CAAC"}
+{"version":3,"file":"listOverseerUsers.d.ts","sourceRoot":"","sources":["../../../src/tools/overseers/listOverseerUsers.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAsBlD;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,EAAE,OA6CnC,CAAC"}

package/dist/tools/overseers/listOverseerUsers.js

@@ -3,6 +3,7 @@
  * List Overseer Users Tool
  *
  * MCP tool for listing users with pagination and sorting.
+ * Uses cursor-based pagination for efficient result navigation.
  *
  * @since 6.x.0
  */
@@ -16,7 +17,7 @@ const common_schemas_js_1 = require("../../schemas/common-schemas.js");
 const USER_SORT_BY_SCHEMA = {
     type: 'string',
     enum: ['address', 'flagsReceived', 'activeBans', 'createdAt'],
-    description: 'Field to sort by (default: createdAt)',
+    description: 'Field to sort by (default: createdAt).',
 };
 /**
  * Sort order schema
@@ -24,7 +25,7 @@ const USER_SORT_BY_SCHEMA = {
 const SORT_ORDER_SCHEMA = {
     type: 'string',
     enum: ['asc', 'desc'],
-    description: 'Sort order (default: desc)',
+    description: 'Sort order (default: desc).',
 };
 /**
  * List Overseer Users Tool
@@ -44,24 +45,28 @@ Useful for overseer/admin dashboard user management.
 - activeBans: Active bans count
 - createdAt: Account creation date (default)
 
-RETURNS: { items: [...], total: number, offset, limit, hasNext }
+RETURNS: { items: [...], total: number, cursor?, pageSize }
 
-Authentication: Requires streamAdminApiKey (admin) OR JWT auth as existing Overseer`,
+Authentication: Requires streamAdminApiKey (admin) OR JWT auth as existing Overseer.`,
     inputSchema: {
         type: 'object',
         properties: {
             search: {
                 ...common_schemas_js_1.SEARCH_SCHEMA,
-                description: 'Search by user address or name',
+                description: 'Search by user address or name.',
             },
             sortBy: USER_SORT_BY_SCHEMA,
             sortOrder: SORT_ORDER_SCHEMA,
-            offset: {
+            cursor: {
+                type: 'string',
+                description: 'Cursor from previous response for pagination (omit for first page).',
+            },
+            pageSize: {
                 type: 'integer',
-                minimum: 0,
-                description: 'Offset for pagination (default: 0)',
+                minimum: 1,
+                maximum: 100,
+                description: 'Results per page (max: 100, default: 20).',
             },
-            limit: common_schemas_js_1.ADMIN_LIMIT_SCHEMA,
         },
         required: [],
     },
@@ -69,8 +74,8 @@ Authentication: Requires streamAdminApiKey (admin) OR JWT auth as existing Overs
         search: args.search,
         sortBy: args.sortBy,
         sortOrder: args.sortOrder,
-        offset: args.offset,
-        limit: args.limit,
+        cursor: args.cursor,
+        pageSize: args.pageSize ?? 20,
     })),
 };
 //# sourceMappingURL=listOverseerUsers.js.map

package/dist/tools/overseers/listOverseerUsers.js.map

@@ -1 +1 @@
-{"version":3,"file":"listOverseerUsers.js","sourceRoot":"","sources":["../../../src/tools/overseers/listOverseerUsers.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAGH,kEAA8D;AAC9D,uEAAoF;AAEpF;;GAEG;AACH,MAAM,mBAAmB,GAAG;IAC1B,IAAI,EAAE,QAAiB;IACvB,IAAI,EAAE,CAAC,SAAS,EAAE,eAAe,EAAE,YAAY,EAAE,WAAW,CAAC;IAC7D,WAAW,EAAE,uCAAuC;CACrD,CAAC;AAEF;;GAEG;AACH,MAAM,iBAAiB,GAAG;IACxB,IAAI,EAAE,QAAiB;IACvB,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,4BAA4B;CAC1C,CAAC;AAEF;;;;GAIG;AACU,QAAA,qBAAqB,GAAY;IAC5C,IAAI,EAAE,oCAAoC;IAC1C,WAAW,EAAE;;;;;;;;;;;;;oFAaqE;IAClF,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,MAAM,EAAE;gBACN,GAAG,iCAAa;gBAChB,WAAW,EAAE,gCAAgC;aAC9C;YACD,MAAM,EAAE,mBAAmB;YAC3B,SAAS,EAAE,iBAAiB;YAC5B,MAAM,EAAE;gBACN,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,CAAC;gBACV,WAAW,EAAE,oCAAoC;aAClD;YACD,KAAK,EAAE,sCAAkB;SAC1B;QACD,QAAQ,EAAE,EAAE;KACb;IACD,OAAO,EAAE,IAAA,0CAAmB,EAAC,mBAAmB,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAC3D,MAAM,EAAE,IAAI,CAAC,MAA4B;QACzC,MAAM,EAAE,IAAI,CAAC,MAA8E;QAC3F,SAAS,EAAE,IAAI,CAAC,SAAuC;QACvD,MAAM,EAAE,IAAI,CAAC,MAA4B;QACzC,KAAK,EAAE,IAAI,CAAC,KAA2B;KACxC,CAAC,CAAC;CACJ,CAAC"}
+{"version":3,"file":"listOverseerUsers.js","sourceRoot":"","sources":["../../../src/tools/overseers/listOverseerUsers.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AAGH,kEAA8D;AAC9D,uEAAgE;AAEhE;;GAEG;AACH,MAAM,mBAAmB,GAAG;IAC1B,IAAI,EAAE,QAAiB;IACvB,IAAI,EAAE,CAAC,SAAS,EAAE,eAAe,EAAE,YAAY,EAAE,WAAW,CAAC;IAC7D,WAAW,EAAE,wCAAwC;CACtD,CAAC;AAEF;;GAEG;AACH,MAAM,iBAAiB,GAAG;IACxB,IAAI,EAAE,QAAiB;IACvB,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,6BAA6B;CAC3C,CAAC;AAEF;;;;GAIG;AACU,QAAA,qBAAqB,GAAY;IAC5C,IAAI,EAAE,oCAAoC;IAC1C,WAAW,EAAE;;;;;;;;;;;;;qFAasE;IACnF,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,MAAM,EAAE;gBACN,GAAG,iCAAa;gBAChB,WAAW,EAAE,iCAAiC;aAC/C;YACD,MAAM,EAAE,mBAAmB;YAC3B,SAAS,EAAE,iBAAiB;YAC5B,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,qEAAqE;aACnF;YACD,QAAQ,EAAE;gBACR,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,CAAC;gBACV,OAAO,EAAE,GAAG;gBACZ,WAAW,EAAE,2CAA2C;aACzD;SACF;QACD,QAAQ,EAAE,EAAE;KACb;IACD,OAAO,EAAE,IAAA,0CAAmB,EAAC,mBAAmB,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAC3D,MAAM,EAAE,IAAI,CAAC,MAA4B;QACzC,MAAM,EAAE,IAAI,CAAC,MAA8E;QAC3F,SAAS,EAAE,IAAI,CAAC,SAAuC;QACvD,MAAM,EAAE,IAAI,CAAC,MAA4B;QACzC,QAAQ,EAAG,IAAI,CAAC,QAAmB,IAAI,EAAE;KAC1C,CAAC,CAAC;CACJ,CAAC"}