@gala-chain/launchpad-mcp-server 5.0.5-beta.9 → 5.1.0

package/dist/tools/notifications/index.js

@@ -0,0 +1,196 @@
+"use strict";
+/**
+ * Notification & Client Config Tools
+ *
+ * MCP tools for push notification management and client feature flags:
+ * - Register/unregister push notification device tokens
+ * - Get/update notification preferences
+ * - Get client feature flags
+ *
+ * Notification endpoints require JWT authentication.
+ * Client flags endpoint is public (no auth required).
+ *
+ * @since 5.1.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.notificationTools = exports.fetchClientFlagsTool = exports.updateNotificationPreferencesTool = exports.fetchNotificationPreferencesTool = exports.unregisterPushTokenTool = exports.registerPushTokenTool = void 0;
+const handler_factories_js_1 = require("../handler-factories.js");
+// =============================================================================
+// Push Notification Tools
+// =============================================================================
+/**
+ * 1. Register Push Token
+ */
+exports.registerPushTokenTool = {
+    name: 'gala_launchpad_register_push_token',
+    description: `Register a push notification device token.
+
+Associates a push token (FCM or APNs) with the authenticated user.
+If the token already exists, it updates the associated device info.
+
+**Parameters:**
+- token (required): Push notification token string (FCM or APNs)
+- platform (required): Device platform - "ios" or "android"
+- deviceId (optional): Device identifier for multi-device management
+
+RETURNS: { registered: boolean }
+
+Authentication: Requires JWT auth (call sdk.login() first).`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            token: {
+                type: 'string',
+                description: 'Push notification token (FCM or APNs token, max 512 characters)',
+            },
+            platform: {
+                type: 'string',
+                enum: ['ios', 'android'],
+                description: 'Device platform - must be "ios" or "android"',
+            },
+            deviceId: {
+                type: 'string',
+                description: 'Optional device identifier for multi-device management (max 255 characters)',
+            },
+        },
+        required: ['token', 'platform'],
+    },
+    handler: (0, handler_factories_js_1.createSimpleHandler)('registerPushToken', (args) => ({
+        token: args.token,
+        platform: args.platform,
+        ...(args.deviceId !== undefined ? { deviceId: args.deviceId } : {}),
+    })),
+};
+/**
+ * 2. Unregister Push Token
+ */
+exports.unregisterPushTokenTool = {
+    name: 'gala_launchpad_unregister_push_token',
+    description: `Unregister a push notification device token.
+
+Deactivates a push token so the device no longer receives notifications.
+
+**Parameters:**
+- token (required): The push notification token to unregister
+
+RETURNS: { unregistered: boolean }
+
+Authentication: Requires JWT auth (call sdk.login() first).`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            token: {
+                type: 'string',
+                description: 'Push notification token to unregister',
+            },
+        },
+        required: ['token'],
+    },
+    handler: (0, handler_factories_js_1.createSimpleHandler)('unregisterPushToken', (args) => args.token),
+};
+/**
+ * 3. Fetch Notification Preferences
+ */
+exports.fetchNotificationPreferencesTool = {
+    name: 'gala_launchpad_fetch_notification_preferences',
+    description: `Get notification preferences for the authenticated user.
+
+Returns the current push notification preference settings.
+
+RETURNS: { preferences: { tradesEnabled, streamsEnabled, chatEnabled, systemEnabled } }
+
+Authentication: Requires JWT auth (call sdk.login() first).`,
+    inputSchema: {
+        type: 'object',
+        properties: {},
+        required: [],
+    },
+    handler: (0, handler_factories_js_1.createConvenienceFetcher)('fetchNotificationPreferences'),
+};
+/**
+ * 4. Update Notification Preferences
+ */
+exports.updateNotificationPreferencesTool = {
+    name: 'gala_launchpad_update_notification_preferences',
+    description: `Update notification preferences for the authenticated user.
+
+Partial update - only provided fields are modified, others remain unchanged.
+At least one field should be provided.
+
+**Preference fields (all optional):**
+- tradesEnabled: Enable/disable trade notifications
+- streamsEnabled: Enable/disable stream notifications
+- chatEnabled: Enable/disable chat notifications
+- systemEnabled: Enable/disable system notifications
+
+RETURNS: { preferences: { tradesEnabled, streamsEnabled, chatEnabled, systemEnabled } }
+
+Authentication: Requires JWT auth (call sdk.login() first).`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            tradesEnabled: {
+                type: 'boolean',
+                description: 'Enable/disable trade notifications',
+            },
+            streamsEnabled: {
+                type: 'boolean',
+                description: 'Enable/disable stream notifications',
+            },
+            chatEnabled: {
+                type: 'boolean',
+                description: 'Enable/disable chat notifications',
+            },
+            systemEnabled: {
+                type: 'boolean',
+                description: 'Enable/disable system notifications',
+            },
+        },
+    },
+    handler: (0, handler_factories_js_1.createSimpleHandler)('updateNotificationPreferences', (args) => {
+        const params = {};
+        if (args.tradesEnabled !== undefined)
+            params.tradesEnabled = args.tradesEnabled;
+        if (args.streamsEnabled !== undefined)
+            params.streamsEnabled = args.streamsEnabled;
+        if (args.chatEnabled !== undefined)
+            params.chatEnabled = args.chatEnabled;
+        if (args.systemEnabled !== undefined)
+            params.systemEnabled = args.systemEnabled;
+        return params;
+    }),
+};
+/**
+ * 5. Fetch Client Feature Flags
+ */
+exports.fetchClientFlagsTool = {
+    name: 'gala_launchpad_fetch_client_flags',
+    description: `Get client feature flags for the native mobile app.
+
+Returns feature flag overrides that control which features are enabled/disabled.
+Useful for checking platform feature availability before performing operations.
+
+RETURNS: { flags: { PUSH_NOTIFICATIONS, OFFLINE_MODE, BIOMETRIC_AUTH, DARK_MODE, LIVE_STREAMING, DEX_TRADING, ... } }
+
+Authentication: None required (public endpoint).`,
+    inputSchema: {
+        type: 'object',
+        properties: {},
+        required: [],
+    },
+    handler: (0, handler_factories_js_1.createConvenienceFetcher)('fetchClientFlags'),
+};
+// =============================================================================
+// Export all notification & client config tools
+// =============================================================================
+/**
+ * All notification and client config tools
+ */
+exports.notificationTools = [
+    exports.registerPushTokenTool,
+    exports.unregisterPushTokenTool,
+    exports.fetchNotificationPreferencesTool,
+    exports.updateNotificationPreferencesTool,
+    exports.fetchClientFlagsTool,
+];
+//# sourceMappingURL=index.js.map

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

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

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

@@ -0,0 +1,31 @@
+/**
+ * OEmbed Operations Tools
+ *
+ * MCP tools for oEmbed metadata operations including:
+ * - Get home page oEmbed (featuring top/live token)
+ * - Get pool/token oEmbed (for buy-sell pages)
+ * - Get profile oEmbed (for user profiles)
+ *
+ * These endpoints are primarily consumed by social media bots for
+ * rich link previews (Twitter Cards, Open Graph, etc.).
+ *
+ * @since 9.0.0
+ */
+import type { MCPTool } from '../../types/mcp.js';
+/**
+ * 1. Get Home OEmbed
+ */
+export declare const getHomeOEmbedTool: MCPTool;
+/**
+ * 2. Get Pool OEmbed
+ */
+export declare const getPoolOEmbedTool: MCPTool;
+/**
+ * 3. Get Profile OEmbed
+ */
+export declare const getProfileOEmbedTool: MCPTool;
+/**
+ * All oEmbed tools
+ */
+export declare const oembedTools: MCPTool[];
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/oembed/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAuBlD;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAE,OAgB/B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAE,OAoB/B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,OAoBlC,CAAC;AAMF;;GAEG;AACH,eAAO,MAAM,WAAW,EAAE,OAAO,EAIhC,CAAC"}

package/dist/tools/oembed/index.js

@@ -0,0 +1,113 @@
+"use strict";
+/**
+ * OEmbed Operations Tools
+ *
+ * MCP tools for oEmbed metadata operations including:
+ * - Get home page oEmbed (featuring top/live token)
+ * - Get pool/token oEmbed (for buy-sell pages)
+ * - Get profile oEmbed (for user profiles)
+ *
+ * These endpoints are primarily consumed by social media bots for
+ * rich link previews (Twitter Cards, Open Graph, etc.).
+ *
+ * @since 9.0.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.oembedTools = exports.getProfileOEmbedTool = exports.getPoolOEmbedTool = exports.getHomeOEmbedTool = void 0;
+const handler_factories_js_1 = require("../handler-factories.js");
+// =============================================================================
+// OEmbed Schemas
+// =============================================================================
+/** Token name schema */
+const TOKEN_NAME_SCHEMA = {
+    type: 'string',
+    description: 'Token name (case-insensitive)',
+};
+/** User address schema */
+const ADDRESS_SCHEMA = {
+    type: 'string',
+    description: 'User wallet address (e.g., "eth|0x123...")',
+};
+// =============================================================================
+// OEmbed Tools
+// =============================================================================
+/**
+ * 1. Get Home OEmbed
+ */
+exports.getHomeOEmbedTool = {
+    name: 'gala_launchpad_get_home_oembed',
+    description: `Get oEmbed metadata for the home page.
+
+Returns oEmbed JSON data featuring the top/live token for social media previews.
+Used by Twitter Cards, Open Graph, and other social preview consumers.
+
+RETURNS: { oembed: { type, version, title, provider_name, provider_url, featuredToken?, featuredSymbol?, featuredImage?, featuredIsLive? } }
+
+Authentication: None required (public endpoint)`,
+    inputSchema: {
+        type: 'object',
+        properties: {},
+        required: [],
+    },
+    handler: (0, handler_factories_js_1.createConvenienceFetcher)('getHomeOEmbed'),
+};
+/**
+ * 2. Get Pool OEmbed
+ */
+exports.getPoolOEmbedTool = {
+    name: 'gala_launchpad_get_pool_oembed',
+    description: `Get oEmbed metadata for a pool/token page.
+
+Returns oEmbed JSON data for a token's buy/sell page, including
+live stream status if applicable.
+
+RETURNS: { oembed: { type, version, title, provider_name, provider_url, tokenName, symbol, image, isLive?, viewerCount? } }
+
+Authentication: None required (public endpoint)`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            tokenName: TOKEN_NAME_SCHEMA,
+        },
+        required: ['tokenName'],
+    },
+    handler: (0, handler_factories_js_1.createSimpleHandler)('getPoolOEmbed', (args) => ({
+        tokenName: args.tokenName,
+    })),
+};
+/**
+ * 3. Get Profile OEmbed
+ */
+exports.getProfileOEmbedTool = {
+    name: 'gala_launchpad_get_profile_oembed',
+    description: `Get oEmbed metadata for a user profile page.
+
+Returns oEmbed JSON data for a user's profile including stats like
+tokens created, graduation rate, and total volume.
+
+RETURNS: { oembed: { type, version, title, provider_name, provider_url, address, displayName?, avatarUrl?, tokensCreated, tokensGraduated, graduationRate, totalVolumeGala, isLiveStreaming?, liveStreamToken? } }
+
+Authentication: None required (public endpoint)`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            address: ADDRESS_SCHEMA,
+        },
+        required: ['address'],
+    },
+    handler: (0, handler_factories_js_1.createSimpleHandler)('getProfileOEmbed', (args) => ({
+        address: args.address,
+    })),
+};
+// =============================================================================
+// Export all oEmbed tools
+// =============================================================================
+/**
+ * All oEmbed tools
+ */
+exports.oembedTools = [
+    exports.getHomeOEmbedTool,
+    exports.getPoolOEmbedTool,
+    exports.getProfileOEmbedTool,
+];
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/oembed/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;GAYG;;;AAGH,kEAAwF;AAExF,gFAAgF;AAChF,iBAAiB;AACjB,gFAAgF;AAEhF,wBAAwB;AACxB,MAAM,iBAAiB,GAAG;IACxB,IAAI,EAAE,QAAiB;IACvB,WAAW,EAAE,+BAA+B;CAC7C,CAAC;AAEF,0BAA0B;AAC1B,MAAM,cAAc,GAAG;IACrB,IAAI,EAAE,QAAiB;IACvB,WAAW,EAAE,4CAA4C;CAC1D,CAAC;AAEF,gFAAgF;AAChF,eAAe;AACf,gFAAgF;AAEhF;;GAEG;AACU,QAAA,iBAAiB,GAAY;IACxC,IAAI,EAAE,gCAAgC;IACtC,WAAW,EAAE;;;;;;;gDAOiC;IAC9C,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE,EAAE;QACd,QAAQ,EAAE,EAAE;KACb;IACD,OAAO,EAAE,IAAA,+CAAwB,EAAC,eAAe,CAAC;CACnD,CAAC;AAEF;;GAEG;AACU,QAAA,iBAAiB,GAAY;IACxC,IAAI,EAAE,gCAAgC;IACtC,WAAW,EAAE;;;;;;;gDAOiC;IAC9C,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,SAAS,EAAE,iBAAiB;SAC7B;QACD,QAAQ,EAAE,CAAC,WAAW,CAAC;KACxB;IACD,OAAO,EAAE,IAAA,0CAAmB,EAAC,eAAe,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACvD,SAAS,EAAE,IAAI,CAAC,SAAmB;KACpC,CAAC,CAAC;CACJ,CAAC;AAEF;;GAEG;AACU,QAAA,oBAAoB,GAAY;IAC3C,IAAI,EAAE,mCAAmC;IACzC,WAAW,EAAE;;;;;;;gDAOiC;IAC9C,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,OAAO,EAAE,cAAc;SACxB;QACD,QAAQ,EAAE,CAAC,SAAS,CAAC;KACtB;IACD,OAAO,EAAE,IAAA,0CAAmB,EAAC,kBAAkB,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAC1D,OAAO,EAAE,IAAI,CAAC,OAAiB;KAChC,CAAC,CAAC;CACJ,CAAC;AAEF,gFAAgF;AAChF,0BAA0B;AAC1B,gFAAgF;AAEhF;;GAEG;AACU,QAAA,WAAW,GAAc;IACpC,yBAAiB;IACjB,yBAAiB;IACjB,4BAAoB;CACrB,CAAC"}

package/dist/tools/overseers/cache-management.d.ts

@@ -0,0 +1,27 @@
+/**
+ * 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
+ */
+import type { MCPTool } from '../../types/mcp.js';
+/**
+ * 1. Flush Cache By Address
+ */
+export declare const flushCacheByAddressTool: MCPTool;
+/**
+ * 2. Flush Cache By Token
+ */
+export declare const flushCacheByTokenTool: MCPTool;
+/**
+ * 3. Flush All Cache (Nuclear Option)
+ */
+export declare const flushAllCacheTool: MCPTool;
+/**
+ * 4. Flush Wallet-Alias Cache
+ */
+export declare const flushCacheWalletAliasesTool: MCPTool;
+export declare const cacheManagementTools: MCPTool[];
+//# sourceMappingURL=cache-management.d.ts.map

package/dist/tools/overseers/cache-management.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-management.d.ts","sourceRoot":"","sources":["../../../src/tools/overseers/cache-management.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAoBlD;;GAEG;AACH,eAAO,MAAM,uBAAuB,EAAE,OAiCrC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,qBAAqB,EAAE,OAmCnC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAE,OAoC/B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,2BAA2B,EAAE,OAmCzC,CAAC;AAMF,eAAO,MAAM,oBAAoB,EAAE,OAAO,EAKzC,CAAC"}

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

@@ -0,0 +1,191 @@
+"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.flushCacheWalletAliasesTool = 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),
+};
+/**
+ * 4. Flush Wallet-Alias Cache
+ */
+exports.flushCacheWalletAliasesTool = {
+    name: 'gala_launchpad_flush_cache_wallet_aliases',
+    description: `Flush wallet-alias cache entries (eth| → client| resolution cache).
+
+Clears the Redis cache that maps eth| addresses to their GalaChain client| aliases.
+Use this when a user's login returns a stale eth| address even though they have
+a client| alias on GalaChain. After flushing, the next login will re-resolve
+the alias from the GalaChain public-key contract.
+
+- Without address: flushes ALL wallet-alias entries (use after updating the public-key contract URL)
+- With address: flushes only the specified address's alias entry
+
+Use this when:
+- A user logs in and gets their eth| address instead of their client| alias
+- After fixing GALA_PUBLIC_KEY_CONTRACT configuration
+- After a GalaChain network outage caused null-cached aliases
+- Debugging alias resolution issues on dev/staging environments
+
+RETURNS: { flushedCount, duration, target? }
+- flushedCount: Number of alias cache entries flushed
+- duration: Time taken in milliseconds
+- target: Normalized address (only present when flushing a single address)
+
+Authentication: Requires streamAdminApiKey (admin) OR JWT auth as existing Overseer.`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            address: {
+                ...common_schemas_js_1.ADDRESS_SCHEMA,
+                description: 'Optional wallet address (eth|... or 0x... format). If omitted, ALL wallet-alias entries are flushed.',
+            },
+        },
+        required: [],
+    },
+    handler: (0, handler_factories_js_1.createSimpleHandler)('flushWalletAliasCache', (args) => args.address),
+};
+// =============================================================================
+// Export All Tools
+// =============================================================================
+exports.cacheManagementTools = [
+    exports.flushCacheByAddressTool,
+    exports.flushCacheByTokenTool,
+    exports.flushAllCacheTool,
+    exports.flushCacheWalletAliasesTool,
+];
+//# 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;;GAEG;AACU,QAAA,2BAA2B,GAAY;IAClD,IAAI,EAAE,2CAA2C;IACjD,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;qFAqBsE;IACnF,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,OAAO,EAAE;gBACP,GAAG,kCAAc;gBACjB,WAAW,EAAE,sGAAsG;aACpH;SACF;QACD,QAAQ,EAAE,EAAE;KACb;IACD,OAAO,EAAE,IAAA,0CAAmB,EAAC,uBAAuB,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAA6B,CAAC;CACpG,CAAC;AAEF,gFAAgF;AAChF,mBAAmB;AACnB,gFAAgF;AAEnE,QAAA,oBAAoB,GAAc;IAC7C,+BAAuB;IACvB,6BAAqB;IACrB,yBAAiB;IACjB,mCAA2B;CAC5B,CAAC"}

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

@@ -45,14 +45,40 @@ 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;
+/**
+ * 11. Get Ban Stats
+ */
+export declare const getBanStatsTool: MCPTool;
+/**
+ * 12. Get Token Ban Stats
+ */
+export declare const getTokenBanStatsTool: MCPTool;
+/**
+ * 13. Get Invite Stats
+ */
+export declare const getInviteStatsTool: MCPTool;
+/**
+ * 14. Get Flag Stats
+ */
+export declare const getFlagStatsTool: MCPTool;
+export declare const getUserStatsTool: MCPTool;
 export declare const overseerTools: MCPTool[];
 //# sourceMappingURL=index.d.ts.map

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;AA6ElD;;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,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;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,OAe7B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,OAelC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,OAehC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,OAe9B,CAAC;AAMF,eAAO,MAAM,gBAAgB,EAAE,OAe9B,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,OAAO,EAmBlC,CAAC"}