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

package/dist/tools/pools/priceHistoryFactory.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Price History Tool Factory
+ *
+ * Factory for creating fetchPriceHistory and fetchAllPriceHistory tools.
+ * Eliminates duplication between paginated and auto-paginated variants.
+ *
+ * Both tools share:
+ * - Same token identification pattern (tokenName OR tokenId)
+ * - Same date filtering (from/to)
+ * - Same sort order option
+ * - Same handler logic structure
+ *
+ * Only differences:
+ * - Paginated: includes page/limit, calls sdk.fetchPriceHistory
+ * - Auto-paginated: no page/limit, calls sdk.fetchAllPriceHistory
+ *
+ * @see Phase 4A: DRY remediation for trading and discovery tools
+ */
+import type { MCPTool } from '../../types/mcp.js';
+/**
+ * Configuration for price history tool creation
+ */
+interface PriceHistoryToolConfig {
+    /** Whether to include pagination (page/limit) parameters */
+    paginated: boolean;
+}
+/**
+ * Creates a price history tool (paginated or auto-paginated variant)
+ *
+ * @param config - Configuration specifying whether tool is paginated
+ * @returns MCPTool definition
+ *
+ * @example
+ * ```typescript
+ * // Create paginated variant
+ * export const fetchPriceHistoryTool = createPriceHistoryTool({ paginated: true });
+ *
+ * // Create auto-paginated variant
+ * export const fetchAllPriceHistoryTool = createPriceHistoryTool({ paginated: false });
+ * ```
+ */
+export declare function createPriceHistoryTool(config: PriceHistoryToolConfig): MCPTool;
+export {};
+//# sourceMappingURL=priceHistoryFactory.d.ts.map

package/dist/tools/pools/priceHistoryFactory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"priceHistoryFactory.d.ts","sourceRoot":"","sources":["../../../src/tools/pools/priceHistoryFactory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAuDlD;;GAEG;AACH,UAAU,sBAAsB;IAC9B,4DAA4D;IAC5D,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAoF9E"}

package/dist/tools/pools/priceHistoryFactory.js

@@ -0,0 +1,154 @@
+"use strict";
+/**
+ * Price History Tool Factory
+ *
+ * Factory for creating fetchPriceHistory and fetchAllPriceHistory tools.
+ * Eliminates duplication between paginated and auto-paginated variants.
+ *
+ * Both tools share:
+ * - Same token identification pattern (tokenName OR tokenId)
+ * - Same date filtering (from/to)
+ * - Same sort order option
+ * - Same handler logic structure
+ *
+ * Only differences:
+ * - Paginated: includes page/limit, calls sdk.fetchPriceHistory
+ * - Auto-paginated: no page/limit, calls sdk.fetchAllPriceHistory
+ *
+ * @see Phase 4A: DRY remediation for trading and discovery tools
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createPriceHistoryTool = createPriceHistoryTool;
+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 date_converter_js_1 = require("../../utils/date-converter.js");
+// =============================================================================
+// Shared Schema Components
+// =============================================================================
+/**
+ * Token name schema for price history tools
+ */
+const TOKEN_NAME_SCHEMA = {
+    type: 'string',
+    description: 'Simple token name for convenience (e.g., "demonkpop", "shoewars") - automatically resolves to full token ID. Use this OR tokenId, not both.',
+};
+/**
+ * Token ID schema (extended from common schema)
+ */
+const TOKEN_ID_SCHEMA = {
+    ...common_schemas_js_1.FLEXIBLE_TOKEN_ID_SCHEMA,
+    description: 'Token identifier (string or TokenClassKey object). Use this OR tokenName, not both.',
+};
+/**
+ * Date range schemas
+ */
+const FROM_DATE_SCHEMA = {
+    type: 'string',
+    format: 'date-time',
+    description: 'Start date for filtering (ISO 8601 format, defaults to 30 days ago)',
+};
+const TO_DATE_SCHEMA = {
+    type: 'string',
+    format: 'date-time',
+    description: 'End date for filtering (ISO 8601 format, defaults to now)',
+};
+/**
+ * Sort order schema
+ */
+const SORT_ORDER_SCHEMA = {
+    type: 'string',
+    enum: ['ASC', 'DESC'],
+    description: 'Sort order for results (default: DESC for newest-first)',
+};
+/**
+ * Creates a price history tool (paginated or auto-paginated variant)
+ *
+ * @param config - Configuration specifying whether tool is paginated
+ * @returns MCPTool definition
+ *
+ * @example
+ * ```typescript
+ * // Create paginated variant
+ * export const fetchPriceHistoryTool = createPriceHistoryTool({ paginated: true });
+ *
+ * // Create auto-paginated variant
+ * export const fetchAllPriceHistoryTool = createPriceHistoryTool({ paginated: false });
+ * ```
+ */
+function createPriceHistoryTool(config) {
+    const { paginated } = config;
+    const name = paginated
+        ? 'gala_launchpad_fetch_price_history'
+        : 'gala_launchpad_fetch_all_price_history';
+    const methodName = paginated ? 'fetchPriceHistory' : 'fetchAllPriceHistory';
+    const paginationNote = paginated
+        ? '**Performance:** API-based queries with pagination support (max 50 items per page).'
+        : '**Performance:** API-based queries with automatic pagination (max 100 items per page, combined into single result).';
+    const description = `Fetch ${paginated ? '' : 'all '}historical price snapshots for DEX tokens from the DEX Backend API${paginated ? '' : ' with automatic pagination'}.
+
+**Endpoint:** \`/price-oracle/fetch-price\`
+
+**Requirements:**
+- DEX Backend API must be configured (dexBackendBaseUrl in SDK config)
+- Node.js environment only (not available in browser)
+- Either tokenName OR tokenId is required (not both)
+
+**Token Identification:**
+- Use \`tokenName\` for convenience (e.g., "demonkpop") - automatically resolved to full token ID
+- Use \`tokenId\` for direct specification (e.g., "Token|Unit|DKP|eth:...")
+- Provide exactly ONE of these parameters
+
+**Use Cases:**
+- ${paginated ? 'Historical' : 'Complete historical'} price analysis and charting
+- ${paginated ? 'Price' : 'Full price'} trend identification${paginated ? '' : ' over time periods'}
+- ${paginated ? 'Volatility analysis over time periods' : 'Comprehensive volatility analysis'}
+- Data export for external analytics
+
+${paginationNote}`;
+    // Build input schema - paginated version includes page/limit
+    const properties = {
+        tokenName: TOKEN_NAME_SCHEMA,
+        tokenId: TOKEN_ID_SCHEMA,
+        from: FROM_DATE_SCHEMA,
+        to: TO_DATE_SCHEMA,
+        sortOrder: SORT_ORDER_SCHEMA,
+    };
+    if (paginated) {
+        properties.page = common_schemas_js_1.PAGE_SCHEMA;
+        properties.limit = (0, common_schemas_js_1.createLimitSchema)('priceHistory', 10);
+    }
+    return {
+        name,
+        description,
+        inputSchema: {
+            type: 'object',
+            properties,
+            required: [],
+        },
+        handler: (0, error_handler_js_1.withErrorHandling)(async (sdk, args) => {
+            const options = {
+                sortOrder: args.sortOrder,
+            };
+            // Add pagination if paginated variant
+            if (paginated) {
+                options.page = args.page;
+                options.limit = args.limit;
+            }
+            // Support both tokenName and tokenId (mutual exclusivity validation happens in SDK)
+            if (args.tokenName) {
+                options.tokenName = args.tokenName;
+            }
+            else {
+                options.tokenId = args.tokenId;
+            }
+            // Add parsed dates using shared utility
+            (0, date_converter_js_1.addParsedDates)(options, args.from, args.to);
+            // Call appropriate SDK method
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any -- SDK method access via dynamic name
+            const result = await sdk[methodName](options);
+            return (0, response_formatter_js_1.formatSuccess)(result);
+        }),
+    };
+}
+//# sourceMappingURL=priceHistoryFactory.js.map

package/dist/tools/pools/priceHistoryFactory.js.map

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

package/dist/tools/pools/updateTokenSocials.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Update Token Socials Tool
+ *
+ * MCP tool for updating social media links for a token pool.
+ *
+ * @since 6.x.0
+ */
+import type { MCPTool } from '../../types/mcp.js';
+/**
+ * Update Token Socials Tool
+ *
+ * Updates social media links for a token pool. Multiple social platforms are supported.
+ * At least one social link should be provided.
+ */
+export declare const updateTokenSocialsTool: MCPTool;
+//# sourceMappingURL=updateTokenSocials.d.ts.map

package/dist/tools/pools/updateTokenSocials.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"updateTokenSocials.d.ts","sourceRoot":"","sources":["../../../src/tools/pools/updateTokenSocials.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAclD;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,EAAE,OAuDpC,CAAC"}

package/dist/tools/pools/updateTokenSocials.js

@@ -0,0 +1,84 @@
+"use strict";
+/**
+ * Update Token Socials Tool
+ *
+ * MCP tool for updating social media links for a token pool.
+ *
+ * @since 6.x.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.updateTokenSocialsTool = void 0;
+const handler_factories_js_1 = require("../handler-factories.js");
+const common_schemas_js_1 = require("../../schemas/common-schemas.js");
+/**
+ * URL schema for social media links
+ */
+const SOCIAL_URL_SCHEMA = {
+    type: 'string',
+    format: 'uri',
+    maxLength: 255,
+    description: 'Complete URL for social media link (e.g., https://twitter.com/myproject)',
+};
+/**
+ * Update Token Socials Tool
+ *
+ * Updates social media links for a token pool. Multiple social platforms are supported.
+ * At least one social link should be provided.
+ */
+exports.updateTokenSocialsTool = {
+    name: 'gala_launchpad_update_token_socials',
+    description: `Update social media links for a token.
+
+Updates one or more social media links for a token pool (website, Twitter, Telegram, etc.).
+At least one social link should be provided for meaningful updates.
+
+RETURNS: { success: boolean, tokenName: string, socials: { websiteUrl?, telegramUrl?, twitterUrl?, ... } }
+
+Authentication: Requires JWT auth (token owner/manager)`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            tokenName: common_schemas_js_1.TOKEN_NAME_SCHEMA,
+            websiteUrl: {
+                ...SOCIAL_URL_SCHEMA,
+                description: 'Official website URL',
+            },
+            telegramUrl: {
+                ...SOCIAL_URL_SCHEMA,
+                description: 'Telegram group/channel URL',
+            },
+            twitterUrl: {
+                ...SOCIAL_URL_SCHEMA,
+                description: 'Twitter profile URL',
+            },
+            instagramUrl: {
+                ...SOCIAL_URL_SCHEMA,
+                description: 'Instagram profile URL',
+            },
+            facebookUrl: {
+                ...SOCIAL_URL_SCHEMA,
+                description: 'Facebook page URL',
+            },
+            redditUrl: {
+                ...SOCIAL_URL_SCHEMA,
+                description: 'Reddit community URL',
+            },
+            tiktokUrl: {
+                ...SOCIAL_URL_SCHEMA,
+                description: 'TikTok profile URL',
+            },
+        },
+        required: ['tokenName'],
+    },
+    handler: (0, handler_factories_js_1.createSimpleHandler)('updateTokenSocials', (args) => ({
+        tokenName: args.tokenName,
+        websiteUrl: args.websiteUrl,
+        telegramUrl: args.telegramUrl,
+        twitterUrl: args.twitterUrl,
+        instagramUrl: args.instagramUrl,
+        facebookUrl: args.facebookUrl,
+        redditUrl: args.redditUrl,
+        tiktokUrl: args.tiktokUrl,
+    })),
+};
+//# sourceMappingURL=updateTokenSocials.js.map

package/dist/tools/pools/updateTokenSocials.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"updateTokenSocials.js","sourceRoot":"","sources":["../../../src/tools/pools/updateTokenSocials.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAGH,kEAA8D;AAC9D,uEAAoE;AAEpE;;GAEG;AACH,MAAM,iBAAiB,GAAG;IACxB,IAAI,EAAE,QAAiB;IACvB,MAAM,EAAE,KAAK;IACb,SAAS,EAAE,GAAG;IACd,WAAW,EAAE,0EAA0E;CACxF,CAAC;AAEF;;;;;GAKG;AACU,QAAA,sBAAsB,GAAY;IAC7C,IAAI,EAAE,qCAAqC;IAC3C,WAAW,EAAE;;;;;;;wDAOyC;IACtD,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,SAAS,EAAE,qCAAiB;YAC5B,UAAU,EAAE;gBACV,GAAG,iBAAiB;gBACpB,WAAW,EAAE,sBAAsB;aACpC;YACD,WAAW,EAAE;gBACX,GAAG,iBAAiB;gBACpB,WAAW,EAAE,4BAA4B;aAC1C;YACD,UAAU,EAAE;gBACV,GAAG,iBAAiB;gBACpB,WAAW,EAAE,qBAAqB;aACnC;YACD,YAAY,EAAE;gBACZ,GAAG,iBAAiB;gBACpB,WAAW,EAAE,uBAAuB;aACrC;YACD,WAAW,EAAE;gBACX,GAAG,iBAAiB;gBACpB,WAAW,EAAE,mBAAmB;aACjC;YACD,SAAS,EAAE;gBACT,GAAG,iBAAiB;gBACpB,WAAW,EAAE,sBAAsB;aACpC;YACD,SAAS,EAAE;gBACT,GAAG,iBAAiB;gBACpB,WAAW,EAAE,oBAAoB;aAClC;SACF;QACD,QAAQ,EAAE,CAAC,WAAW,CAAC;KACxB;IACD,OAAO,EAAE,IAAA,0CAAmB,EAAC,oBAAoB,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAC5D,SAAS,EAAE,IAAI,CAAC,SAAmB;QACnC,UAAU,EAAE,IAAI,CAAC,UAAgC;QACjD,WAAW,EAAE,IAAI,CAAC,WAAiC;QACnD,UAAU,EAAE,IAAI,CAAC,UAAgC;QACjD,YAAY,EAAE,IAAI,CAAC,YAAkC;QACrD,WAAW,EAAE,IAAI,CAAC,WAAiC;QACnD,SAAS,EAAE,IAAI,CAAC,SAA+B;QAC/C,SAAS,EAAE,IAAI,CAAC,SAA+B;KAChD,CAAC,CAAC;CACJ,CAAC"}

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

@@ -0,0 +1,12 @@
+/**
+ * Referral Tools
+ *
+ * Referral program and rewards tracking operations.
+ */
+import type { MCPTool } from '../../types/mcp.js';
+export declare const fetchReferralUrlTool: MCPTool;
+export declare const fetchReferralsTool: MCPTool;
+export declare const fetchAllReferralsTool: MCPTool;
+export declare const fetchReferralsSummaryTool: MCPTool;
+export declare const referralTools: MCPTool[];
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/referrals/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAYlD,eAAO,MAAM,oBAAoB,EAAE,OASlC,CAAC;AAGF,eAAO,MAAM,kBAAkB,EAAE,OAgChC,CAAC;AAGF,eAAO,MAAM,qBAAqB,EAAE,OA4BnC,CAAC;AAGF,eAAO,MAAM,yBAAyB,EAAE,OAgBvC,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,OAAO,EAKlC,CAAC"}

package/dist/tools/referrals/index.js

@@ -0,0 +1,110 @@
+"use strict";
+/**
+ * Referral Tools
+ *
+ * Referral program and rewards tracking operations.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.referralTools = exports.fetchReferralsSummaryTool = exports.fetchAllReferralsTool = exports.fetchReferralsTool = exports.fetchReferralUrlTool = void 0;
+const common_schemas_js_1 = require("../../schemas/common-schemas.js");
+const handler_factories_js_1 = require("../handler-factories.js");
+// 1. 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, handler_factories_js_1.createConvenienceFetcher)('fetchReferralUrl'),
+};
+// 2. 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, handler_factories_js_1.createSimpleHandler)('fetchReferrals', (args) => ({
+        address: args.address,
+        page: args.page,
+        limit: args.limit,
+        sortBy: args.sortBy,
+        sortDir: args.sortDir,
+    })),
+};
+// 3. 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.',
+    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')",
+            },
+        },
+        required: [],
+    },
+    handler: (0, handler_factories_js_1.createSimpleHandler)('fetchAllReferrals', (args) => ({
+        address: args.address,
+        sortBy: args.sortBy,
+        sortDir: args.sortDir,
+    })),
+};
+// 4. 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.',
+    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.',
+            },
+        },
+        required: [],
+    },
+    handler: (0, handler_factories_js_1.createSimpleHandler)('fetchReferralsSummary', (args) => ({
+        address: args.address,
+    })),
+};
+exports.referralTools = [
+    exports.fetchReferralUrlTool,
+    exports.fetchReferralsTool,
+    exports.fetchAllReferralsTool,
+    exports.fetchReferralsSummaryTool,
+];
+//# sourceMappingURL=index.js.map

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

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

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

@@ -0,0 +1,94 @@
+/**
+ * Streaming Operations Tools
+ *
+ * MCP tools for live streaming management including stream control,
+ * recordings, simulcast targets, and global streaming status.
+ *
+ * Refactored to use handler factories for DRY consolidation (Phase 4C).
+ *
+ * @since 5.1.0
+ */
+import type { MCPTool } from '../../types/mcp.js';
+/**
+ * 1. Start Stream
+ */
+export declare const startStreamTool: MCPTool;
+/**
+ * 2. Stop Stream
+ */
+export declare const stopStreamTool: MCPTool;
+/**
+ * 3. Get Stream Info
+ */
+export declare const getStreamInfoTool: MCPTool;
+/**
+ * 4. Set Stream Enabled (Enable/Disable)
+ *
+ * Consolidates enable/disable stream into a single toggle tool for DRY compliance.
+ * Uses createToggleHandler factory pattern.
+ */
+export declare const setStreamEnabledTool: MCPTool;
+/**
+ * 5. Reset Stream Key
+ */
+export declare const resetStreamKeyTool: MCPTool;
+/**
+ * 6. Get Stream Recordings
+ *
+ * Uses createStreamingListHandler factory for DRY consolidation.
+ */
+export declare const getStreamRecordingsTool: MCPTool;
+/**
+ * 7. Get Recording Download
+ *
+ * Uses createStreamingGetHandler factory for DRY consolidation.
+ */
+export declare const getRecordingDownloadTool: MCPTool;
+/**
+ * 8. Delete Recording
+ *
+ * Uses createStreamingDeleteHandler factory for DRY consolidation.
+ */
+export declare const deleteRecordingTool: MCPTool;
+/**
+ * 9. Get Simulcast Targets
+ */
+export declare const getSimulcastTargetsTool: MCPTool;
+/**
+ * 10. Add Simulcast Target
+ */
+export declare const addSimulcastTargetTool: MCPTool;
+/**
+ * 11. Remove Simulcast Target
+ *
+ * Uses createStreamingDeleteHandler factory for DRY consolidation.
+ */
+export declare const removeSimulcastTargetTool: MCPTool;
+/**
+ * 12. Get Global Streaming Status
+ */
+export declare const getGlobalStreamingStatusTool: MCPTool;
+/**
+ * 13. Set Global Streaming Enabled
+ */
+export declare const setGlobalStreamingEnabledTool: MCPTool;
+/**
+ * 14. Get Stream Role
+ *
+ * @since 5.7.0
+ */
+export declare const getStreamRoleTool: MCPTool;
+/**
+ * 17. Get Available Roles
+ *
+ * @since 5.10.0
+ */
+export declare const getAvailableRolesTool: MCPTool;
+/**
+ * 18. Get Token Access
+ *
+ * @since 5.11.0
+ */
+export declare const getTokenAccessTool: MCPTool;
+export declare const streamingTools: MCPTool[];
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/streaming/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAoFlD;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,OAkB7B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,OAiB5B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAE,OAkB/B,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,EAAE,OAuBlC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,OAkBhC,CAAC;AAMF;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,EAAE,OAmBrC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,EAAE,OAkBtC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,EAAE,OAkBjC,CAAC;AAMF;;GAEG;AACH,eAAO,MAAM,uBAAuB,EAAE,OAiBrC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,sBAAsB,EAAE,OA2BpC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,EAAE,OAkBvC,CAAC;AAMF;;GAEG;AACH,eAAO,MAAM,4BAA4B,EAAE,OAc1C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,6BAA6B,EAAE,OAqB3C,CAAC;AAMF;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,EAAE,OAoB/B,CAAC;AAMF;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,EAAE,OAwCnC,CAAC;AAMF;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,EAAE,OA6ChC,CAAC;AAMF,eAAO,MAAM,cAAc,EAAE,OAAO,EAyBnC,CAAC"}