@continuumdao/continuum-node-sdk 1.3.24 → 1.3.27

package/dist/mcp/coinmarketcap-public/register.js

@@ -0,0 +1,99 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { missingCmcApiKeyReason, resolveCmcApiKey, } from '../../core/coinmarketcap/api-key.js';
+import { getAltcoinSeasonIndexLatest, getCmc100Latest, getCryptoOhlcvHistorical, getCryptoQuotesLatest, getDexPairQuotes, getDexToken, getDexTokenPools, getFearAndGreedHistorical, getFearAndGreedLatest, getGlobalMetricsLatest, getKlineCandles, getSimplePrice, searchDexTokens, GetAltcoinSeasonIndexLatestInputSchema, GetCmc100LatestInputSchema, GetCryptoOhlcvHistoricalInputSchema, GetCryptoOhlcvHistoricalOutputSchema, GetCryptoQuotesLatestInputSchema, GetDexPairQuotesInputSchema, GetDexTokenInputSchema, GetDexTokenPoolsInputSchema, GetFearAndGreedHistoricalInputSchema, GetFearAndGreedLatestInputSchema, GetGlobalMetricsLatestInputSchema, GetKlineCandlesInputSchema, GetKlineCandlesOutputSchema, GetSimplePriceInputSchema, SearchDexTokensInputSchema, } from '../../core/coinmarketcap/index.js';
+import { registerMcpMarkdownResource } from '../mcp-resources.js';
+import { MCP_LOOSE_OBJECT_SCHEMA, sdkResultToCallToolResult } from '../tool-utils.js';
+export function registerCoinMarketCapPublicTools(server, config) {
+    server.registerTool('get_crypto_ohlcv_historical', {
+        description: 'CEX aggregate OHLCV candlesticks from CoinMarketCap Pro API (/v2/cryptocurrency/ohlcv/historical). Requires COINMARKETCAP_API_KEY in Node → AI Agent → Variables (add_environment_variable). Pass CMC id (1=BTC, 1027=ETH), timePeriod (hourly/daily/weekly/monthly), optional count and interval. Returns quotes[] in result for prepare_chart_from_rows / analyze_*.',
+        inputSchema: GetCryptoOhlcvHistoricalInputSchema,
+        outputSchema: GetCryptoOhlcvHistoricalOutputSchema,
+    }, async (input) => {
+        const apiKey = await resolveCmcApiKey(config);
+        if (!apiKey) {
+            return sdkResultToCallToolResult({ ok: false, reason: missingCmcApiKeyReason() });
+        }
+        return sdkResultToCallToolResult(await getCryptoOhlcvHistorical(input, { apiKey }));
+    });
+    server.registerTool('get_kline_candles', {
+        description: 'DEX OHLCV candlesticks from CoinMarketCap keyless API. Pass platform (e.g. ethereum) and pool address. ' +
+            'Use lookbackDays (e.g. 7) or limit for bar count — keyless API does NOT accept from/to (returns HTTP 403). ' +
+            'Keyless DEX k-line data may lag days/months; check meta.warnings and latestBarTime. ' +
+            'For current ETH/BTC spot OHLCV when data is stale, ask the operator which source to use (CoinGecko, CMC Pro historical, DeFi venue) — see chart-ohlcv-sources. ' +
+            'Returns candles + window + optional meta.warnings. Pass full result object to prepare_chart_from_rows as toolResult.',
+        inputSchema: GetKlineCandlesInputSchema,
+        outputSchema: GetKlineCandlesOutputSchema,
+    }, async (input) => sdkResultToCallToolResult(await getKlineCandles(input, { apiKey: await resolveCmcApiKey(config) })));
+    server.registerTool('search_dex_tokens', {
+        description: 'Search DEX tokens by keyword (name, symbol, address) via CoinMarketCap keyless API. Returns matching tokens across chains.',
+        inputSchema: SearchDexTokensInputSchema,
+        outputSchema: MCP_LOOSE_OBJECT_SCHEMA,
+    }, async (input) => sdkResultToCallToolResult(await searchDexTokens(input)));
+    server.registerTool('get_dex_token', {
+        description: 'DEX token detail (price, liquidity, market cap, links) by platform and contract address. CoinMarketCap keyless API.',
+        inputSchema: GetDexTokenInputSchema,
+        outputSchema: MCP_LOOSE_OBJECT_SCHEMA,
+    }, async (input) => sdkResultToCallToolResult(await getDexToken(input)));
+    server.registerTool('get_dex_token_pools', {
+        description: 'List liquidity pools for a DEX token (Uniswap v3/v4, etc.) by platform and token address. Use pool addr for get_kline_candles.',
+        inputSchema: GetDexTokenPoolsInputSchema,
+        outputSchema: MCP_LOOSE_OBJECT_SCHEMA,
+    }, async (input) => sdkResultToCallToolResult(await getDexTokenPools(input)));
+    server.registerTool('get_dex_pair_quotes', {
+        description: 'Latest DEX pair quote by network_id (1 = Ethereum) and pool contract address. CoinMarketCap keyless API.',
+        inputSchema: GetDexPairQuotesInputSchema,
+        outputSchema: MCP_LOOSE_OBJECT_SCHEMA,
+    }, async (input) => sdkResultToCallToolResult(await getDexPairQuotes(input)));
+    server.registerTool('get_simple_price', {
+        description: 'CEX spot prices by CoinMarketCap cryptocurrency ids (comma-separated). Example ids: 1=BTC, 1027=ETH. Keyless API.',
+        inputSchema: GetSimplePriceInputSchema,
+        outputSchema: MCP_LOOSE_OBJECT_SCHEMA,
+    }, async (input) => sdkResultToCallToolResult(await getSimplePrice(input)));
+    server.registerTool('get_crypto_quotes_latest', {
+        description: 'Latest CEX market quotes for one or more CoinMarketCap ids (comma-separated). Keyless API.',
+        inputSchema: GetCryptoQuotesLatestInputSchema,
+        outputSchema: MCP_LOOSE_OBJECT_SCHEMA,
+    }, async (input) => sdkResultToCallToolResult(await getCryptoQuotesLatest(input)));
+    server.registerTool('get_global_metrics_latest', {
+        description: 'Global crypto market snapshot: total market cap, 24h volume, BTC/ETH dominance, DeFi metrics. CoinMarketCap keyless API. Optional convert (default USD).',
+        inputSchema: GetGlobalMetricsLatestInputSchema,
+        outputSchema: MCP_LOOSE_OBJECT_SCHEMA,
+    }, async (input) => sdkResultToCallToolResult(await getGlobalMetricsLatest(input)));
+    server.registerTool('get_fear_and_greed_latest', {
+        description: 'Latest CMC Crypto Fear and Greed Index (0–100) with classification (Extreme Fear, Greed, etc.). Keyless API.',
+        inputSchema: GetFearAndGreedLatestInputSchema,
+        outputSchema: MCP_LOOSE_OBJECT_SCHEMA,
+    }, async (input) => sdkResultToCallToolResult(await getFearAndGreedLatest(input)));
+    server.registerTool('get_fear_and_greed_historical', {
+        description: 'Historical CMC Fear and Greed readings. Optional start (1-based offset) and limit (max 500). Keyless API.',
+        inputSchema: GetFearAndGreedHistoricalInputSchema,
+        outputSchema: MCP_LOOSE_OBJECT_SCHEMA,
+    }, async (input) => sdkResultToCallToolResult(await getFearAndGreedHistorical(input)));
+    server.registerTool('get_cmc100_latest', {
+        description: 'Latest CoinMarketCap 100 index value, 24h change, and constituent weights. Keyless API.',
+        inputSchema: GetCmc100LatestInputSchema,
+        outputSchema: MCP_LOOSE_OBJECT_SCHEMA,
+    }, async (input) => sdkResultToCallToolResult(await getCmc100Latest(input)));
+    server.registerTool('get_altcoin_season_index_latest', {
+        description: 'Latest CMC Altcoin Season Index (0–100; above 75 suggests alt season). Keyless API.',
+        inputSchema: GetAltcoinSeasonIndexLatestInputSchema,
+        outputSchema: MCP_LOOSE_OBJECT_SCHEMA,
+    }, async (input) => sdkResultToCallToolResult(await getAltcoinSeasonIndexLatest(input)));
+}
+export function registerCoinMarketCapPublicResources(server) {
+    registerMcpMarkdownResource(server, 'coinmarketcap_public_docs', 'coinmarketcap-public.md', 'CoinMarketCap keyless public API MCP tools: DEX OHLCV, market snapshot, token search, pools, CEX quotes.');
+}
+export function createCoinMarketCapPublicMcpServer(config) {
+    const server = new McpServer({
+        name: 'continuum-cmc-public-mcp',
+        version: '1.0.0',
+    }, {
+        capabilities: {
+            tools: {},
+        },
+    });
+    registerCoinMarketCapPublicTools(server, config);
+    registerCoinMarketCapPublicResources(server);
+    return server;
+}
+//# sourceMappingURL=register.js.map

package/dist/mcp/coinmarketcap-public/register.js.map

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

package/dist/mcp/deferred/discovery-tools.d.ts

@@ -0,0 +1,6 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { NodeSdkConfig } from '../../config/schema.js';
+import type { DefiProtocolContext } from '../defi/context.js';
+import type { DeferredToolSession } from './session.js';
+export declare function registerDeferredDiscoveryTools(server: McpServer, _config: NodeSdkConfig, session: DeferredToolSession, defiContext?: DefiProtocolContext): void;
+//# sourceMappingURL=discovery-tools.d.ts.map

package/dist/mcp/deferred/discovery-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery-tools.d.ts","sourceRoot":"","sources":["../../../src/mcp/deferred/discovery-tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,yCAAyC,CAAC;AAEvE,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,wBAAwB,CAAC;AAC1D,OAAO,KAAK,EAAC,mBAAmB,EAAC,MAAM,oBAAoB,CAAC;AAG5D,OAAO,KAAK,EAAC,mBAAmB,EAAC,MAAM,cAAc,CAAC;AAqCtD,wBAAgB,8BAA8B,CAC7C,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE,aAAa,EACtB,OAAO,EAAE,mBAAmB,EAC5B,WAAW,CAAC,EAAE,mBAAmB,GAC/B,IAAI,CAoIN"}

package/dist/mcp/deferred/discovery-tools.js

@@ -0,0 +1,138 @@
+import { z } from 'zod';
+import { getProtocolSkill } from '../defi/catalog-adapter.js';
+import { markProtocolLoaded } from '../defi/register-protocol-tools.js';
+const ListGroupsOutputSchema = z.object({
+    groups: z.array(z.object({
+        groupId: z.string(),
+        description: z.string(),
+        toolCount: z.number().int().nonnegative(),
+        loaded: z.boolean(),
+        pinned: z.boolean(),
+        recommended: z.boolean(),
+    })),
+});
+const SearchOutputSchema = z.object({
+    hits: z.array(z.object({
+        name: z.string(),
+        shortDescription: z.string(),
+        group: z.string(),
+        loaded: z.boolean(),
+        score: z.number(),
+    })),
+    suggestion: z.string().optional(),
+});
+const ActivateOutputSchema = z.object({
+    activated: z.boolean(),
+    groupId: z.string(),
+    toolNames: z.array(z.string()),
+    advisoryTools: z.array(z.string()).optional(),
+    skillPreview: z.string().optional(),
+    skillHint: z.string().optional(),
+});
+export function registerDeferredDiscoveryTools(server, _config, session, defiContext) {
+    if (session.isDiscoveryRegistered()) {
+        return;
+    }
+    server.registerTool('list_tool_groups', {
+        description: 'List Continuum MCP tool bundles (groupId, toolCount, loaded, pinned). Call activate_tool_group before using tools in an unloaded bundle.',
+        inputSchema: z.object({}).strict(),
+        outputSchema: ListGroupsOutputSchema,
+    }, async () => {
+        const groups = session.listGroups();
+        const payload = { groups };
+        return {
+            content: [{ type: 'text', text: JSON.stringify(payload) }],
+            structuredContent: payload,
+        };
+    });
+    server.registerTool('search_continuum_tools', {
+        description: 'Search the Continuum tool catalog by keywords (e.g. chart, ohlcv, multisign). Returns compact hits; call activate_tool_group on the group id before tools/call. For charts: search "chart" then activate_tool_group({ groupId: "chart" }).',
+        inputSchema: z
+            .object({
+            q: z.string().min(1),
+            group: z.string().optional(),
+            limit: z.number().int().positive().max(50).optional(),
+        })
+            .strict(),
+        outputSchema: SearchOutputSchema,
+    }, async ({ q, group, limit }) => {
+        const hits = session.searchTools(q, group, limit ?? 20);
+        const first = hits[0];
+        const chartQuery = /\b(chart|ohlcv|plot|graph|candlestick|analysis)\b/i.test(q);
+        const chartLoaded = session.isGroupActive('chart');
+        let suggestion;
+        if (first && !first.loaded) {
+            suggestion = `Call activate_tool_group with groupId "${first.group}" to enable these tools.`;
+        }
+        else if (chartQuery && !chartLoaded) {
+            suggestion =
+                'Call activate_tool_group with groupId "chart" to enable chart and analysis tools.';
+        }
+        const payload = {
+            hits,
+            suggestion,
+        };
+        return {
+            content: [{ type: 'text', text: JSON.stringify(payload) }],
+            structuredContent: payload,
+        };
+    });
+    server.registerTool('activate_tool_group', {
+        description: 'Activate a tool bundle so its tools appear in tools/list and accept tools/call. Idempotent if already active.',
+        inputSchema: z.object({ groupId: z.string().min(1) }).strict(),
+        outputSchema: ActivateOutputSchema,
+    }, async ({ groupId }) => {
+        if (groupId.startsWith('defi:') && defiContext) {
+            const protocolId = groupId.slice('defi:'.length);
+            markProtocolLoaded(defiContext, protocolId);
+            const skill = getProtocolSkill(protocolId);
+            const toolNames = session.activateGroup(groupId);
+            const payload = {
+                activated: true,
+                groupId,
+                toolNames,
+                advisoryTools: [
+                    'get_defi_protocol_supported_chains',
+                    'get_defi_protocol_supported_tokens',
+                    'get_defi_protocol_skill',
+                ],
+                skillPreview: skill?.slice(0, 500),
+                skillHint: 'Call get_defi_protocol_skill for full SKILL.md workflow guidance.',
+            };
+            return {
+                content: [{ type: 'text', text: JSON.stringify(payload) }],
+                structuredContent: payload,
+            };
+        }
+        const toolNames = session.activateGroup(groupId);
+        if (toolNames.length === 0 &&
+            !session.listGroups().some(g => g.groupId === groupId)) {
+            throw new Error(`Unknown tool group: ${groupId}`);
+        }
+        const payload = { activated: true, groupId, toolNames };
+        return {
+            content: [{ type: 'text', text: JSON.stringify(payload) }],
+            structuredContent: payload,
+        };
+    });
+    server.registerTool('deactivate_tool_group', {
+        description: 'Hide tools in a bundle from tools/list. Pinned groups cannot be deactivated.',
+        inputSchema: z.object({ groupId: z.string().min(1) }).strict(),
+        outputSchema: z
+            .object({
+            deactivated: z.boolean(),
+            groupId: z.string(),
+            toolNames: z.array(z.string()),
+        })
+            .strict(),
+    }, async ({ groupId }) => {
+        const toolNames = session.deactivateGroup(groupId);
+        const payload = { deactivated: toolNames.length > 0, groupId, toolNames };
+        return {
+            content: [{ type: 'text', text: JSON.stringify(payload) }],
+            structuredContent: payload,
+        };
+    });
+    session.markDiscoveryRegistered();
+}
+//# sourceMappingURL=discovery-tools.js.map

package/dist/mcp/deferred/discovery-tools.js.map

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

package/dist/mcp/deferred/optional-endpoint-groups.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Tools on optional MCP HTTP endpoints (/mcp/cmc-public, /mcp/ta, /mcp/vpn).
+ * Not registered on continuum main `/mcp` — load via hub catalog or direct endpoint only.
+ * Inventory script merges these; deferred loading on main server ignores them.
+ */
+export declare const OPTIONAL_ENDPOINT_GROUP_DESCRIPTIONS: Record<string, string>;
+/** @see OPTIONAL_ENDPOINT_GROUP_DESCRIPTIONS */
+export declare const OPTIONAL_ENDPOINT_TOOL_GROUPS: Record<string, string>;
+/** Relative paths under src/mcp for optional-endpoint registrars (inventory split). */
+export declare const OPTIONAL_ENDPOINT_SCAN_PREFIXES: readonly ["coinmarketcap-public/", "ta/", "vpn.ts"];
+export declare function isOptionalEndpointRegistrarPath(file: string): boolean;
+//# sourceMappingURL=optional-endpoint-groups.d.ts.map

package/dist/mcp/deferred/optional-endpoint-groups.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"optional-endpoint-groups.d.ts","sourceRoot":"","sources":["../../../src/mcp/deferred/optional-endpoint-groups.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,eAAO,MAAM,oCAAoC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAMvE,CAAC;AAEF,gDAAgD;AAChD,eAAO,MAAM,6BAA6B,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CA4BhE,CAAC;AAEF,uFAAuF;AACvF,eAAO,MAAM,+BAA+B,qDAIlC,CAAC;AAEX,wBAAgB,+BAA+B,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAIrE"}

package/dist/mcp/deferred/optional-endpoint-groups.js

@@ -0,0 +1,51 @@
+/**
+ * Tools on optional MCP HTTP endpoints (/mcp/cmc-public, /mcp/ta, /mcp/vpn).
+ * Not registered on continuum main `/mcp` — load via hub catalog or direct endpoint only.
+ * Inventory script merges these; deferred loading on main server ignores them.
+ */
+export const OPTIONAL_ENDPOINT_GROUP_DESCRIPTIONS = {
+    vpn_admin: 'WireGuard admin VPN status, enable, client config download',
+    vpn_egress: 'Peer egress VPN exits, sharing, revoke, client config',
+    ta: 'Standalone technical indicator math (fast-technical-indicators)',
+    'catalog:coinmarketcap-public': 'Optional CoinMarketCap public API — add via agent MCP catalog (not core continuum)',
+};
+/** @see OPTIONAL_ENDPOINT_GROUP_DESCRIPTIONS */
+export const OPTIONAL_ENDPOINT_TOOL_GROUPS = {
+    // vpn_admin (/mcp/vpn)
+    get_vpn_status: 'vpn_admin',
+    set_vpn_enabled: 'vpn_admin',
+    download_vpn_admin_client_config: 'vpn_admin',
+    // vpn_egress
+    get_vpn_egress_status: 'vpn_egress',
+    list_vpn_egress_exits: 'vpn_egress',
+    set_vpn_egress_sharing: 'vpn_egress',
+    revoke_vpn_egress_peer: 'vpn_egress',
+    download_vpn_egress_client_config: 'vpn_egress',
+    // ta (/mcp/ta)
+    list_technical_indicators: 'ta',
+    calculate_technical_indicator: 'ta',
+    // catalog (/mcp/cmc-public or hub coinmarketcap-public)
+    get_crypto_ohlcv_historical: 'catalog:coinmarketcap-public',
+    get_kline_candles: 'catalog:coinmarketcap-public',
+    search_dex_tokens: 'catalog:coinmarketcap-public',
+    get_dex_token: 'catalog:coinmarketcap-public',
+    get_dex_token_pools: 'catalog:coinmarketcap-public',
+    get_dex_pair_quotes: 'catalog:coinmarketcap-public',
+    get_simple_price: 'catalog:coinmarketcap-public',
+    get_crypto_quotes_latest: 'catalog:coinmarketcap-public',
+    get_global_metrics_latest: 'catalog:coinmarketcap-public',
+    get_fear_and_greed_latest: 'catalog:coinmarketcap-public',
+    get_fear_and_greed_historical: 'catalog:coinmarketcap-public',
+    get_cmc100_latest: 'catalog:coinmarketcap-public',
+    get_altcoin_season_index_latest: 'catalog:coinmarketcap-public',
+};
+/** Relative paths under src/mcp for optional-endpoint registrars (inventory split). */
+export const OPTIONAL_ENDPOINT_SCAN_PREFIXES = [
+    'coinmarketcap-public/',
+    'ta/',
+    'vpn.ts',
+];
+export function isOptionalEndpointRegistrarPath(file) {
+    return OPTIONAL_ENDPOINT_SCAN_PREFIXES.some(prefix => file === prefix.replace(/\/$/, '') || file.startsWith(prefix));
+}
+//# sourceMappingURL=optional-endpoint-groups.js.map

package/dist/mcp/deferred/optional-endpoint-groups.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"optional-endpoint-groups.js","sourceRoot":"","sources":["../../../src/mcp/deferred/optional-endpoint-groups.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,CAAC,MAAM,oCAAoC,GAA2B;IAC3E,SAAS,EAAE,4DAA4D;IACvE,UAAU,EAAE,uDAAuD;IACnE,EAAE,EAAE,iEAAiE;IACrE,8BAA8B,EAC7B,oFAAoF;CACrF,CAAC;AAEF,gDAAgD;AAChD,MAAM,CAAC,MAAM,6BAA6B,GAA2B;IACpE,uBAAuB;IACvB,cAAc,EAAE,WAAW;IAC3B,eAAe,EAAE,WAAW;IAC5B,gCAAgC,EAAE,WAAW;IAC7C,aAAa;IACb,qBAAqB,EAAE,YAAY;IACnC,qBAAqB,EAAE,YAAY;IACnC,sBAAsB,EAAE,YAAY;IACpC,sBAAsB,EAAE,YAAY;IACpC,iCAAiC,EAAE,YAAY;IAC/C,eAAe;IACf,yBAAyB,EAAE,IAAI;IAC/B,6BAA6B,EAAE,IAAI;IACnC,wDAAwD;IACxD,2BAA2B,EAAE,8BAA8B;IAC3D,iBAAiB,EAAE,8BAA8B;IACjD,iBAAiB,EAAE,8BAA8B;IACjD,aAAa,EAAE,8BAA8B;IAC7C,mBAAmB,EAAE,8BAA8B;IACnD,mBAAmB,EAAE,8BAA8B;IACnD,gBAAgB,EAAE,8BAA8B;IAChD,wBAAwB,EAAE,8BAA8B;IACxD,yBAAyB,EAAE,8BAA8B;IACzD,yBAAyB,EAAE,8BAA8B;IACzD,6BAA6B,EAAE,8BAA8B;IAC7D,iBAAiB,EAAE,8BAA8B;IACjD,+BAA+B,EAAE,8BAA8B;CAC/D,CAAC;AAEF,uFAAuF;AACvF,MAAM,CAAC,MAAM,+BAA+B,GAAG;IAC9C,uBAAuB;IACvB,KAAK;IACL,QAAQ;CACC,CAAC;AAEX,MAAM,UAAU,+BAA+B,CAAC,IAAY;IAC3D,OAAO,+BAA+B,CAAC,IAAI,CAC1C,MAAM,CAAC,EAAE,CAAC,IAAI,KAAK,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CACvE,CAAC;AACH,CAAC"}

package/dist/mcp/deferred/session.d.ts

@@ -0,0 +1,56 @@
+import type { RegisteredTool } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export type CatalogEntry = {
+    name: string;
+    description: string;
+    groupId: string;
+    tags: string[];
+    registered: RegisteredTool;
+};
+export type DeferredToolSessionOptions = {
+    pinnedGroups?: Set<string>;
+};
+export declare class DeferredToolSession {
+    private readonly server;
+    readonly deferLoading: boolean;
+    private readonly pinnedGroups;
+    private readonly catalog;
+    private readonly activeGroups;
+    private readonly fullActivation;
+    private readonly groupTools;
+    private discoveryRegistered;
+    private wrapInstalled;
+    constructor(server: McpServer, deferLoading: boolean, options?: DeferredToolSessionOptions);
+    installRegistrationWrapper(): void;
+    trackTool(name: string, description: string, groupId: string, registered: RegisteredTool, options?: {
+        protocolId?: string;
+        skipVisibility?: boolean;
+    }): void;
+    assignToolGroup(name: string, groupId: string): void;
+    private shouldBeVisible;
+    applyInitialVisibility(): void;
+    activateGroup(groupId: string): string[];
+    deactivateGroup(groupId: string): string[];
+    isGroupActive(groupId: string): boolean;
+    listGroups(): Array<{
+        groupId: string;
+        description: string;
+        toolCount: number;
+        loaded: boolean;
+        pinned: boolean;
+        recommended: boolean;
+    }>;
+    searchTools(q: string, groupFilter: string | undefined, limit: number): Array<{
+        name: string;
+        shortDescription: string;
+        group: string;
+        loaded: boolean;
+        score: number;
+    }>;
+    getCatalogSize(): number;
+    getVisibleToolCount(): number;
+    markDiscoveryRegistered(): void;
+    isDiscoveryRegistered(): boolean;
+}
+export declare function mcpDeferLoadingFromEnv(): boolean;
+//# sourceMappingURL=session.d.ts.map

package/dist/mcp/deferred/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../../src/mcp/deferred/session.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,yCAAyC,CAAC;AAC5E,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,yCAAyC,CAAC;AAYvE,MAAM,MAAM,YAAY,GAAG;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,UAAU,EAAE,cAAc,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,0BAA0B,GAAG;IACxC,YAAY,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CAC3B,CAAC;AAEF,qBAAa,mBAAmB;IAW9B,OAAO,CAAC,QAAQ,CAAC,MAAM;IAVxB,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAc;IAC3C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmC;IAC3D,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAqB;IAClD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAqB;IACpD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAkC;IAC7D,OAAO,CAAC,mBAAmB,CAAS;IACpC,OAAO,CAAC,aAAa,CAAS;gBAGZ,MAAM,EAAE,SAAS,EAClC,YAAY,EAAE,OAAO,EACrB,OAAO,GAAE,0BAA+B;IAazC,0BAA0B,IAAI,IAAI;IAelC,SAAS,CACR,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,cAAc,EAC1B,OAAO,CAAC,EAAE;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,cAAc,CAAC,EAAE,OAAO,CAAA;KAAC,GACvD,IAAI;IAgCP,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAapD,OAAO,CAAC,eAAe;IAUvB,sBAAsB,IAAI,IAAI;IAa9B,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE;IAcxC,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE;IAyB1C,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAIvC,UAAU,IAAI,KAAK,CAAC;QACnB,OAAO,EAAE,MAAM,CAAC;QAChB,WAAW,EAAE,MAAM,CAAC;QACpB,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,OAAO,CAAC;QAChB,MAAM,EAAE,OAAO,CAAC;QAChB,WAAW,EAAE,OAAO,CAAC;KACrB,CAAC;IA6BF,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,KAAK,CAAC;QAC7E,IAAI,EAAE,MAAM,CAAC;QACb,gBAAgB,EAAE,MAAM,CAAC;QACzB,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,OAAO,CAAC;QAChB,KAAK,EAAE,MAAM,CAAC;KACd,CAAC;IAmDF,cAAc,IAAI,MAAM;IAIxB,mBAAmB,IAAI,MAAM;IAQ7B,uBAAuB,IAAI,IAAI;IAI/B,qBAAqB,IAAI,OAAO;CAGhC;AAED,wBAAgB,sBAAsB,IAAI,OAAO,CAUhD"}

package/dist/mcp/deferred/session.js

@@ -0,0 +1,242 @@
+import { GROUP_DESCRIPTIONS, GROUP_SEARCH_TAGS, isToolPinnedAtInit, parsePinnedGroupsFromEnv, RECOMMENDED_CHAT_BUNDLES, resolveToolGroupId, TOOL_SEARCH_TAGS, } from './tool-group-map.js';
+export class DeferredToolSession {
+    server;
+    deferLoading;
+    pinnedGroups;
+    catalog = new Map();
+    activeGroups = new Set();
+    fullActivation = new Set();
+    groupTools = new Map();
+    discoveryRegistered = false;
+    wrapInstalled = false;
+    constructor(server, deferLoading, options = {}) {
+        this.server = server;
+        this.deferLoading = deferLoading;
+        this.pinnedGroups =
+            options.pinnedGroups ?? parsePinnedGroupsFromEnv(process.env['MCP_DEFER_PIN_GROUPS']);
+        if (deferLoading) {
+            for (const g of this.pinnedGroups) {
+                this.activeGroups.add(g);
+            }
+            this.activeGroups.add('discovery');
+        }
+    }
+    installRegistrationWrapper() {
+        if (this.wrapInstalled || !this.deferLoading) {
+            return;
+        }
+        this.wrapInstalled = true;
+        const original = this.server.registerTool.bind(this.server);
+        const session = this;
+        this.server.registerTool = ((name, config, handler) => {
+            const groupId = resolveToolGroupId(name);
+            const registered = original(name, config, handler);
+            session.trackTool(name, String(config.description ?? ''), groupId, registered);
+            return registered;
+        });
+    }
+    trackTool(name, description, groupId, registered, options) {
+        const resolvedGroup = options?.protocolId
+            ? resolveToolGroupId(name, { protocolId: options.protocolId })
+            : groupId;
+        const tags = [
+            resolvedGroup,
+            ...(GROUP_SEARCH_TAGS[resolvedGroup] ?? []),
+            ...(TOOL_SEARCH_TAGS[name] ?? []),
+            ...name.split('_'),
+        ];
+        this.catalog.set(name, {
+            name,
+            description,
+            groupId: resolvedGroup,
+            tags,
+            registered,
+        });
+        if (!this.groupTools.has(resolvedGroup)) {
+            this.groupTools.set(resolvedGroup, new Set());
+        }
+        this.groupTools.get(resolvedGroup).add(name);
+        if (!this.deferLoading || options?.skipVisibility) {
+            return;
+        }
+        if (this.shouldBeVisible(name, resolvedGroup)) {
+            registered.enable();
+        }
+        else {
+            registered.disable();
+        }
+    }
+    assignToolGroup(name, groupId) {
+        const entry = this.catalog.get(name);
+        if (!entry || entry.groupId === groupId) {
+            return;
+        }
+        this.groupTools.get(entry.groupId)?.delete(name);
+        if (!this.groupTools.has(groupId)) {
+            this.groupTools.set(groupId, new Set());
+        }
+        this.groupTools.get(groupId).add(name);
+        entry.groupId = groupId;
+    }
+    shouldBeVisible(name, groupId) {
+        if (!this.activeGroups.has(groupId)) {
+            return false;
+        }
+        if (this.fullActivation.has(groupId)) {
+            return true;
+        }
+        return isToolPinnedAtInit(name, groupId, this.pinnedGroups);
+    }
+    applyInitialVisibility() {
+        if (!this.deferLoading) {
+            return;
+        }
+        for (const entry of this.catalog.values()) {
+            if (this.shouldBeVisible(entry.name, entry.groupId)) {
+                entry.registered.enable();
+            }
+            else {
+                entry.registered.disable();
+            }
+        }
+    }
+    activateGroup(groupId) {
+        this.activeGroups.add(groupId);
+        this.fullActivation.add(groupId);
+        const names = [...(this.groupTools.get(groupId) ?? [])];
+        for (const name of names) {
+            const entry = this.catalog.get(name);
+            if (entry) {
+                entry.registered.enable();
+            }
+        }
+        void this.server.server.sendToolListChanged().catch(() => { });
+        return names.sort();
+    }
+    deactivateGroup(groupId) {
+        if (this.pinnedGroups.has(groupId) || groupId === 'discovery') {
+            return [];
+        }
+        this.activeGroups.delete(groupId);
+        this.fullActivation.delete(groupId);
+        const names = [...(this.groupTools.get(groupId) ?? [])];
+        for (const name of names) {
+            const entry = this.catalog.get(name);
+            if (entry) {
+                if (this.pinnedGroups.has(groupId)) {
+                    if (this.shouldBeVisible(name, groupId)) {
+                        entry.registered.enable();
+                    }
+                    else {
+                        entry.registered.disable();
+                    }
+                }
+                else {
+                    entry.registered.disable();
+                }
+            }
+        }
+        void this.server.server.sendToolListChanged().catch(() => { });
+        return names.sort();
+    }
+    isGroupActive(groupId) {
+        return this.activeGroups.has(groupId);
+    }
+    listGroups() {
+        const recommended = new Set(RECOMMENDED_CHAT_BUNDLES);
+        const out = [];
+        for (const [groupId, tools] of this.groupTools) {
+            if (groupId === 'unknown')
+                continue;
+            out.push({
+                groupId,
+                description: GROUP_DESCRIPTIONS[groupId] ?? groupId,
+                toolCount: tools.size,
+                loaded: this.activeGroups.has(groupId),
+                pinned: this.pinnedGroups.has(groupId) || groupId === 'discovery',
+                recommended: recommended.has(groupId),
+            });
+        }
+        return out.sort((a, b) => {
+            if (a.recommended !== b.recommended) {
+                return a.recommended ? -1 : 1;
+            }
+            return a.groupId.localeCompare(b.groupId);
+        });
+    }
+    searchTools(q, groupFilter, limit) {
+        const tokens = q
+            .toLowerCase()
+            .split(/\s+/)
+            .filter(Boolean);
+        const hits = [];
+        for (const entry of this.catalog.values()) {
+            if (entry.groupId === 'unknown')
+                continue;
+            if (groupFilter) {
+                const gf = groupFilter.toLowerCase();
+                if (entry.groupId !== gf &&
+                    !entry.groupId.toLowerCase().startsWith(`${gf}:`) &&
+                    !entry.groupId.toLowerCase().startsWith(gf)) {
+                    continue;
+                }
+            }
+            const hay = [
+                entry.name,
+                entry.description,
+                entry.groupId,
+                ...entry.tags,
+            ]
+                .join(' ')
+                .toLowerCase();
+            let score = 0;
+            for (const t of tokens) {
+                if (entry.name === t)
+                    score += 10;
+                else if (entry.name.startsWith(t))
+                    score += 5;
+                else if (hay.includes(t))
+                    score += 1;
+            }
+            if (score > 0) {
+                hits.push({
+                    name: entry.name,
+                    shortDescription: entry.description.slice(0, 160),
+                    group: entry.groupId,
+                    loaded: this.activeGroups.has(entry.groupId),
+                    score,
+                });
+            }
+        }
+        return hits.sort((a, b) => b.score - a.score).slice(0, limit);
+    }
+    getCatalogSize() {
+        return this.catalog.size;
+    }
+    getVisibleToolCount() {
+        let n = 0;
+        for (const entry of this.catalog.values()) {
+            if (entry.registered.enabled)
+                n++;
+        }
+        return n;
+    }
+    markDiscoveryRegistered() {
+        this.discoveryRegistered = true;
+    }
+    isDiscoveryRegistered() {
+        return this.discoveryRegistered;
+    }
+}
+export function mcpDeferLoadingFromEnv() {
+    const raw = process.env['MCP_DEFER_LOADING'];
+    if (raw === undefined || raw === '') {
+        return true;
+    }
+    const v = raw.trim().toLowerCase();
+    if (v === '0' || v === 'false' || v === 'no' || v === 'off') {
+        return false;
+    }
+    return true;
+}
+//# sourceMappingURL=session.js.map