@continuumdao/continuum-node-sdk 1.3.39 → 1.3.40

package/dist/mcp/deferred/tool-group-map.js

@@ -7,36 +7,192 @@ export const DEFAULT_PINNED_GROUPS = [
     'node_info',
     'management_signer',
     'keygen',
-    'defi_discovery',
 ];
 /** Bundles surfaced in list_tool_groups as easy chat entry points (not pinned at init). */
-export const RECOMMENDED_CHAT_BUNDLES = ['chart'];
+export const RECOMMENDED_CHAT_BUNDLES = ['chart:core', 'defi_discovery'];
+/**
+ * Legacy / shorthand groupIds expanded by activate_tool_group and host LLM filter.
+ * `chart` → plot/fetch only (not full analyze/drawings/trade).
+ * `defi:<protocol>` (exactly two segments) → market-data pack only — handled in resolveActivateGroupIds.
+ */
+export const GROUP_ACTIVATE_ALIASES = {
+    chart: ['chart:core'],
+};
 /** Tags applied to all tools in a group for search_continuum_tools. */
 export const GROUP_SEARCH_TAGS = {
-    chart: [
+    discovery: [
+        'search tools',
+        'tool groups',
+        'activate bundle',
+        'load tools',
+        'discover tools',
+        'list bundles',
+    ],
+    'chart:core': [
         'chart',
         'ohlcv',
         'plot',
         'graph',
         'candlestick',
         'candle',
+        'prepare chart',
+        'render chart',
+        'perp',
+    ],
+    'chart:analyze': [
         'analysis',
         'analyze',
         'trend',
-        'fibonacci',
-        'drawings',
-        'levels',
         'momentum',
         'pattern',
         'elliott',
         'wave',
-        'price',
+        'fibonacci',
+        'levels',
+        'indicator',
+        'ichimoku',
+        'bollinger',
+        'macd',
+        'obv',
+        'rsi',
+        'ema',
+        'sma',
+        'donchian',
+        'supertrend',
+    ],
+    'chart:drawings': [
+        'drawings',
+        'overlay',
+        'apply drawings',
+        'pattern overlay',
+        'trend lines',
+        'key levels',
+    ],
+    'chart:trade': [
         'trade',
+        'trade ideas',
+        'build trade',
+        'multisign',
+        'consensus trade',
+        'tpsl',
+    ],
+    node_info: [
+        'version',
+        'health',
+        'node health',
+        'status',
+        'connectivity',
+        'uptime',
+        'logs',
+        'machine',
+        'node id',
+        'peers',
+    ],
+    management_signer: ['management', 'signer', 'ed25519', 'preferred signer', 'not keygen'],
+    group: [
+        'group',
+        'groups',
+        'group request',
+        'peers',
+        'formation',
+        'mpc group',
+        'create group',
+        'accept group',
+        'list groups',
+        'my groups',
+    ],
+    keygen: [
+        'keygen',
+        'key gen',
+        'keygen request',
+        'key gen request',
+        'mpc key',
+        'generate key',
+        'preferred keygen',
+        'wallet key',
+    ],
+    keygen_billing: ['billing', 'linea', 'mpa wallet', 'vpn billing', 'top up', 'overage', 'deposit'],
+    keygen_messaging: [
+        'message',
+        'messaging',
+        'thread',
+        'chat',
+        'attachment',
+        'inbox',
+        'keygen message',
+        'key gen message',
+    ],
+    registry_chains: [
+        'chain',
+        'registry',
+        'rpc',
+        'gas config',
+        'evm chain',
+        'network',
+        'add chain',
+        'configure chain',
+        'blockchain',
+        // Brand names that are also EVM networks — prefer chain registry over DeFi load.
+        'hyperliquid',
+        'hyperevm',
+        'hyperliquid chain',
+        'hyperevm chain',
+    ],
+    registry_address_book: ['address book', 'contact', 'contacts', 'saved address', 'known address'],
+    registry_tokens: ['token', 'tokens', 'token registry', 'saved token', 'erc20 registry'],
+    mpc_read: [
         'multisign',
+        'multisign request',
+        'sign request',
+        'sign requests',
+        'status',
+        'pending',
+        'gas options',
+        'ready',
+        'sign transaction',
+    ],
+    // Keep agree phrases on sign_request_agree tool tags — not bare "agree" group-wide.
+    mpc_agree: ['reject', 'shelve', 'sign request agree', 'multisign approve', 'join agree'],
+    mpc_execute: [
+        'broadcast',
+        'execute',
+        'trigger',
+        'get sig',
+        'bump',
+        'cancel',
+        'tx params',
+        'gas',
+    ],
+    mpc_compose: [
+        'compose',
+        'forge',
+        'transfer',
+        'native gas',
+        'erc20',
+        'erc721',
+        'joined multisign',
         'swap',
+        'send',
+        'transaction',
+        'create sign request',
+        'create multisign',
+    ],
+    agent_config: ['environment variable', 'env var', 'agent config', 'secrets'],
+    agent_mcp_servers: ['mcp server', 'mcp catalog', 'add mcp', 'remove mcp', 'coinmarketcap', 'flags'],
+    agent_skills: [
+        'skill',
+        'skills',
+        'markdown guidance',
+        'agent skill',
+        'agent guidance',
+        'skill file',
+        'markdown skill',
     ],
-    mpc_read: ['multisign', 'sign', 'status', 'pending'],
-    group: ['group', 'peers', 'formation'],
+    agent_cron: ['cron', 'schedule', 'scheduled job', 'cron job', 'every n minutes'],
+    agent_webhooks: ['webhook', 'inbound webhook', 'automation trigger', 'webhook catalog'],
+    // No bare protocol brands here — they collide with chain names (e.g. Hyperliquid).
+    // Brands live on list_defi_protocols / load_defi_protocol tool tags only.
+    defi_discovery: ['defi', 'protocol', 'load protocol', 'list protocols', 'protocol tools'],
 };
 /** Tools visible at init when their group is pinned (subset of full group). */
 export const PINNED_TOOL_NAMES = new Set([
@@ -68,24 +224,27 @@ export const GROUP_DESCRIPTIONS = {
     discovery: 'Search and activate Continuum MCP tool bundles',
     node_info: 'Node version, health, connectivity, logs, configured peers',
     management_signer: 'Ed25519 management signer lifecycle and preferred signer',
-    group: 'MPC group creation and agreement',
-    keygen: 'KeyGen request, agree, list, fetch results, preferred KeyGen',
+    group: 'MPC group requests: create/list group requests and agree/accept pending group requests',
+    keygen: 'KeyGen requests: create/list keygen requests, agree/accept pending keygen, fetch results, preferred KeyGen',
     keygen_billing: 'Linea MPA wallet, KeyGen/VPN billing multisign builders',
     keygen_messaging: 'KeyGen message threads between nodes',
     registry_chains: 'EVM chain registry (RPC, gas config)',
     registry_address_book: 'Known address book',
     registry_tokens: 'Saved token registry',
-    mpc_read: 'MultiSign list, get, status, gas options',
-    mpc_agree: 'MultiSign agree, reject, shelve',
-    mpc_execute: 'GetSig trigger, broadcast, bump/cancel, tx params',
-    mpc_compose: 'Compose, forge, join batch, native/ERC20 transfers',
+    mpc_read: 'MultiSign / sign requests: list, get, status, gas options',
+    mpc_agree: 'Agree to / reject / shelve a pending MultiSign (sign) request',
+    mpc_execute: 'Get Sig trigger, broadcast, bump/cancel, tx params',
+    mpc_compose: 'Create Multisign / sign requests: compose, forge, join batch, transfers',
     agent_config: 'Agent environment variables',
     agent_mcp_servers: 'Agent MCP server catalog and flags',
     agent_skills: 'Agent skills (markdown guidance)',
     agent_cron: 'Scheduled agent cron jobs',
     agent_webhooks: 'Inbound webhooks for agent automation',
     defi_discovery: 'List and load DeFi protocol tool bundles',
-    chart: 'OHLCV charts, analysis, drawings, and trade builds from analyze_* — call activate_tool_group({ groupId: "chart" }) before use',
+    'chart:core': 'Plot/prepare OHLCV charts (prepare_chart*) — activate chart:core; alias groupId "chart" expands here only',
+    'chart:analyze': 'Structured analyze_* OHLCV analysis (JSON, no chart render)',
+    'chart:drawings': 'calculate_* / apply_* drawing overlays on an existing chart',
+    'chart:trade': 'Trade ideas, build_trade_from_*, submit_trade_from_consensus, Uniswap TPSL monitor',
 };
 /** Static tool name → groupId on continuum main `/mcp` (DeFi protocol tools use defi:<protocolId> via metadata). */
 export const TOOL_GROUP_BY_NAME = {
@@ -226,71 +385,386 @@ export const TOOL_GROUP_BY_NAME = {
     search_continuum_tools: 'discovery',
     activate_tool_group: 'discovery',
     deactivate_tool_group: 'discovery',
-    // chart
-    prepare_chart_from_rows: 'chart',
-    prepare_chart: 'chart',
-    list_chart_analysis_options: 'chart',
-    analyze_trend_structure: 'chart',
-    analyze_elliott_waves: 'chart',
-    analyze_key_levels: 'chart',
-    analyze_key_level_fibonacci: 'chart',
-    analyze_momentum: 'chart',
-    analyze_liquidity_depth: 'chart',
-    apply_liquidity_depth_drawings: 'chart',
-    analyze_divergence: 'chart',
-    calculate_divergence_drawings: 'chart',
-    apply_divergence_drawings: 'chart',
-    analyze_range_volatility: 'chart',
-    analyze_bollinger_bands: 'chart',
-    analyze_donchian_breakout: 'chart',
-    analyze_supertrend: 'chart',
-    analyze_ichimoku: 'chart',
-    analyze_z_score: 'chart',
-    analyze_moving_averages: 'chart',
-    analyze_candlestick_patterns: 'chart',
-    analyze_chart_patterns: 'chart',
-    analyze_time_series_trend: 'chart',
-    analyze_time_series_momentum: 'chart',
-    analyze_time_series_stats: 'chart',
-    list_chart_customization_options: 'chart',
-    calculate_key_levels: 'chart',
-    calculate_pivot_points: 'chart',
-    calculate_fibonacci_range: 'chart',
-    calculate_trend_lines: 'chart',
-    calculate_chart_pattern_drawings: 'chart',
-    calculate_elliott_wave_drawings: 'chart',
-    apply_chart_pattern_drawings: 'chart',
-    apply_elliott_wave_drawings: 'chart',
-    apply_trend_line_drawings: 'chart',
-    apply_key_level_drawings: 'chart',
-    apply_key_fib_drawings: 'chart',
-    apply_chart_drawings: 'chart',
-    list_trade_ideas: 'chart',
-    build_trade_from_trade_idea: 'chart',
-    build_trade_from_chart_pattern: 'chart',
-    build_trade_from_candlestick: 'chart',
-    build_trade_from_key_levels: 'chart',
-    build_trade_from_momentum: 'chart',
-    build_trade_from_divergence: 'chart',
-    evaluate_uniswap_tpsl_monitor: 'chart',
+    // chart packs (slim LLM exposure — do not use bare "chart" as a tool group)
+    prepare_chart_from_rows: 'chart:core',
+    prepare_chart: 'chart:core',
+    list_chart_analysis_options: 'chart:core',
+    list_chart_customization_options: 'chart:core',
+    analyze_trend_structure: 'chart:analyze',
+    analyze_elliott_waves: 'chart:analyze',
+    analyze_key_levels: 'chart:analyze',
+    analyze_key_level_fibonacci: 'chart:analyze',
+    analyze_momentum: 'chart:analyze',
+    analyze_liquidity_depth: 'chart:analyze',
+    analyze_divergence: 'chart:analyze',
+    analyze_range_volatility: 'chart:analyze',
+    analyze_bollinger_bands: 'chart:analyze',
+    analyze_donchian_breakout: 'chart:analyze',
+    analyze_supertrend: 'chart:analyze',
+    analyze_ichimoku: 'chart:analyze',
+    analyze_z_score: 'chart:analyze',
+    analyze_moving_averages: 'chart:analyze',
+    analyze_candlestick_patterns: 'chart:analyze',
+    analyze_chart_patterns: 'chart:analyze',
+    analyze_time_series_trend: 'chart:analyze',
+    analyze_time_series_momentum: 'chart:analyze',
+    analyze_time_series_stats: 'chart:analyze',
+    apply_liquidity_depth_drawings: 'chart:drawings',
+    calculate_divergence_drawings: 'chart:drawings',
+    apply_divergence_drawings: 'chart:drawings',
+    calculate_key_levels: 'chart:drawings',
+    calculate_pivot_points: 'chart:drawings',
+    calculate_fibonacci_range: 'chart:drawings',
+    calculate_trend_lines: 'chart:drawings',
+    calculate_chart_pattern_drawings: 'chart:drawings',
+    calculate_elliott_wave_drawings: 'chart:drawings',
+    apply_chart_pattern_drawings: 'chart:drawings',
+    apply_elliott_wave_drawings: 'chart:drawings',
+    apply_trend_line_drawings: 'chart:drawings',
+    apply_key_level_drawings: 'chart:drawings',
+    apply_key_fib_drawings: 'chart:drawings',
+    apply_chart_drawings: 'chart:drawings',
+    list_trade_ideas: 'chart:trade',
+    build_trade_from_trade_idea: 'chart:trade',
+    build_trade_from_chart_pattern: 'chart:trade',
+    build_trade_from_candlestick: 'chart:trade',
+    build_trade_from_key_levels: 'chart:trade',
+    build_trade_from_momentum: 'chart:trade',
+    build_trade_from_divergence: 'chart:trade',
+    evaluate_uniswap_tpsl_monitor: 'chart:trade',
     register_uniswap_tpsl_monitor_cron: 'agent_cron',
-    submit_trade_from_consensus: 'chart',
+    submit_trade_from_consensus: 'chart:trade',
 };
 export const TOOL_SEARCH_TAGS = {
-    get_preferred_key_gen: ['keygen', 'key gen', 'preferred keygen', 'mpc key'],
+    // discovery
+    search_continuum_tools: ['search tools', 'find tools', 'tool search', 'what tools'],
+    list_tool_groups: ['tool groups', 'list bundles', 'available bundles'],
+    activate_tool_group: ['activate bundle', 'load tools', 'enable group'],
+    deactivate_tool_group: ['deactivate bundle', 'unload tools', 'disable group'],
+    // preferred key / signer
+    get_preferred_key_gen: [
+        'keygen',
+        'key gen',
+        'preferred keygen',
+        'mpc key',
+        'default keygen',
+        'which keygen',
+    ],
+    post_preferred_key_gen: ['set preferred keygen', 'preferred keygen', 'default keygen'],
     get_preferred_management_signer: [
         'management',
         'ed25519',
         'signer',
+        'preferred signer',
+        'not keygen',
+    ],
+    set_preferred_management_signer: [
+        'preferred signer',
+        'set preferred signer',
+        'management signer',
         'not keygen',
     ],
     get_configured_node_keys: ['group', 'peers', 'configured', 'node keys'],
-    prepare_chart: ['chart', 'plot', 'ohlcv'],
-    prepare_chart_from_rows: ['chart', 'plot', 'ohlcv'],
-    list_chart_analysis_options: ['chart', 'analysis'],
-    build_trade_from_trade_idea: ['chart', 'trade', 'multisign'],
-    list_trade_ideas: ['chart', 'trade'],
+    // node health / info
+    get_health: ['health', 'node health', 'status', 'is node ok', 'readiness'],
+    get_connectivity_health: ['connectivity', 'latency', 'peer health', 'ping'],
+    get_logs: ['logs', 'node logs', 'errors'],
+    node_id: ['node id', 'my node', 'public key'],
+    version: ['version', 'node version'],
+    get_machine_info: ['machine', 'cpu', 'memory', 'disk', 'vps'],
+    // chart entry + trade builds (multisign kept here, not on chart group)
+    prepare_chart: ['chart', 'plot', 'ohlcv', 'candlestick'],
+    prepare_chart_from_rows: ['chart', 'plot', 'ohlcv', 'candlestick'],
+    list_chart_analysis_options: ['chart', 'analysis', 'analysis options'],
+    list_chart_customization_options: ['chart', 'indicators', 'customization', 'overlays'],
+    list_trade_ideas: ['chart', 'trade', 'trade ideas'],
+    build_trade_from_trade_idea: ['chart', 'trade', 'multisign', 'build trade'],
+    build_trade_from_chart_pattern: ['chart', 'trade', 'multisign', 'chart pattern trade'],
+    build_trade_from_candlestick: ['chart', 'trade', 'multisign', 'candlestick trade'],
+    build_trade_from_key_levels: ['chart', 'trade', 'multisign', 'key levels trade'],
+    build_trade_from_momentum: ['chart', 'trade', 'multisign', 'momentum trade'],
+    build_trade_from_divergence: ['chart', 'trade', 'multisign', 'divergence trade'],
+    submit_trade_from_consensus: ['consensus trade', 'submit trade', 'cron trade'],
+    evaluate_uniswap_tpsl_monitor: [
+        'tpsl',
+        'take profit',
+        'stop loss',
+        'uniswap monitor',
+    ],
+    // registries
+    get_chain_registry: ['chain', 'chains', 'rpc', 'gas', 'registry', 'hyperliquid', 'hyperevm'],
+    add_to_chain_registry: [
+        'chain',
+        'add chain',
+        'rpc',
+        'registry',
+        'configure chain',
+        'hyperliquid',
+        'hyperevm',
+        'hyperliquid chain',
+    ],
+    remove_from_chain_registry: ['chain', 'remove chain', 'registry'],
+    get_address_book_registry: [
+        'address book',
+        'contacts',
+        'contact',
+        'saved address',
+        'saved contacts',
+    ],
+    add_to_address_book_registry: ['address book', 'add contact', 'save address'],
+    remove_from_address_book_registry: ['address book', 'remove contact', 'delete address'],
+    get_token_registry: ['token', 'tokens', 'registry', 'saved token'],
+    add_to_token_registry: ['token', 'add token', 'registry'],
+    remove_from_token_registry: ['token', 'remove token', 'registry'],
+    // group requests (newGroupRequest / agree)
+    list_group_requests: [
+        'group',
+        'groups',
+        'group request',
+        'group requests',
+        'peers',
+        'pending group',
+        'list groups',
+        'list group requests',
+    ],
+    list_group_results: ['group', 'groups', 'group result', 'formed group', 'list groups'],
+    create_group_request: [
+        'group',
+        'groups',
+        'group request',
+        'create group',
+        'form group',
+        'new group request',
+        'peers',
+    ],
+    accept_group_request: [
+        'group',
+        'groups',
+        'accept group',
+        'join group',
+        'agree',
+        'agree to group',
+        'agree to group request',
+        'agree group request',
+        'accept group request',
+    ],
+    // keygen requests
+    list_key_gen_requests: [
+        'keygen request',
+        'key gen request',
+        'keygen requests',
+        'list keygen',
+        'pending keygen',
+    ],
+    create_key_gen_request: [
+        'keygen request',
+        'key gen request',
+        'create keygen',
+        'new keygen',
+        'generate key',
+        'start keygen',
+    ],
+    accept_key_gen_request: [
+        'agree',
+        'agree to keygen',
+        'agree to key gen',
+        'agree to keygen request',
+        'agree to key gen request',
+        'accept keygen',
+        'accept key gen request',
+        'join keygen',
+    ],
+    get_key_gen_request_by_id: ['keygen request', 'get keygen', 'key gen request'],
+    fetch_key_gen_result: [
+        'keygen result',
+        'ethereum address',
+        'executor address',
+        'wallet address',
+    ],
+    // MultiSign / sign requests (read vs agree)
+    list_sign_requests: [
+        'sign request',
+        'sign requests',
+        'multisign request',
+        'multi sign request',
+        'list sign requests',
+        'pending sign',
+        'live sign',
+    ],
+    list_sign_requests_awaiting_join: [
+        'sign request',
+        'awaiting join',
+        'join tab',
+        'pending agree',
+        'needs agreement',
+        'local agreement pending',
+        'agree pending',
+    ],
+    get_sign_request_by_id: ['sign request', 'get sign request', 'sign request detail'],
+    get_sign_request_status: ['sign request status', 'lifecycle', 'ready to broadcast'],
+    list_sign_requests_ready: ['ready for get sig', 'quorum ready', 'ready to sign'],
+    get_sign_result_summary: ['sign result', 'ready to broadcast', 'get sig done'],
+    get_multi_sign_gas_options: ['gas options', 'custom gas', 'fee speed', 'get sig fee'],
+    wait_for_sign_request_ready: ['wait ready', 'poll sign ready'],
+    sign_request_agree: [
+        'agree',
+        'agree to sign',
+        'agree to sign request',
+        'agree to multisign',
+        'agree sign request',
+        'accept sign request',
+        'reject sign request',
+        'reject multisign',
+        'approve sign request',
+        'multisign approve',
+        'join agree',
+    ],
+    shelve_sign_request: ['shelve', 'shelve sign request', 'pause sign request'],
+    // execute
+    trigger_sign_result: ['get sig', 'trigger sign', 'mpc signing', 'trigger get sig'],
+    broadcast_sign_result: ['broadcast', 'execute on chain', 'send transaction', 'execute sign'],
+    bump_or_cancel_sign_result: ['bump gas', 'cancel stuck', 'replace transaction'],
+    tx_params_from_get_sign_request_id_data: ['tx params', 'transaction params'],
+    // compose / transfers
+    transfer_native_gas: ['transfer', 'send eth', 'send gas', 'native transfer', 'top up gas'],
+    transfer_erc20: ['transfer', 'send token', 'send erc20', 'erc20 transfer'],
+    transfer_erc721: ['transfer', 'send nft', 'erc721', 'nft transfer'],
+    transfer_ctm_erc20: ['transfer', 'send ctm', 'ctm transfer'],
+    transfer_ctm_erc20_cross_chain: [
+        'transfer',
+        'bridge ctm',
+        'cross chain ctm',
+        'c3transfer',
+    ],
+    create_compose_multi_sign_request: [
+        'compose',
+        'batch multisign',
+        'create multisign',
+        'create sign request',
+        'sign request',
+    ],
+    create_forge_multi_sign_request: [
+        'forge',
+        'foundry',
+        'broadcast json',
+        'create multisign',
+        'create sign request',
+    ],
+    create_joined_multi_sign_request: [
+        'join multisign',
+        'batch join',
+        'joined multisign',
+        'create sign request',
+    ],
+    // defi discovery
+    list_defi_protocols: [
+        'defi',
+        'protocol',
+        'protocols',
+        'list protocols',
+        'available protocols',
+        'what protocols',
+        // Brands on list/load tools only (not group-wide).
+        'uniswap',
+        'aave',
+        'gmx',
+        'hyperliquid',
+        'arcus',
+    ],
+    load_defi_protocol: [
+        'defi',
+        'protocol',
+        'load protocol',
+        'load defi',
+        'enable protocol',
+        'activate protocol',
+        'defi tools',
+        'uniswap',
+        'aave',
+        'gmx',
+        'hyperliquid',
+        'arcus',
+    ],
+    unload_defi_protocol: ['defi', 'protocol', 'unload protocol'],
+    get_defi_protocol_skill: ['defi skill', 'protocol skill', 'skill md'],
+    get_defi_protocol_supported_chains: ['protocol chains', 'defi chains'],
+    get_defi_protocol_supported_tokens: ['protocol tokens', 'defi tokens'],
+    get_tools_for_protocol: ['protocol tools', 'defi tools list'],
+    // agent cron / skills / webhooks / config
+    list_cron_jobs: ['cron', 'scheduled jobs', 'list cron'],
+    add_cron_job: ['cron', 'schedule job', 'create cron', 'every n minutes'],
+    run_cron_job: ['run cron', 'trigger cron'],
+    update_cron_job: ['update cron', 'edit cron'],
+    activate_cron_job: ['activate cron', 'enable cron'],
+    deactivate_cron_job: ['deactivate cron', 'disable cron'],
+    list_skills: ['skills', 'agent skills', 'list skills'],
+    get_skill: ['skill', 'get skill', 'read skill'],
+    add_skill: ['add skill', 'create skill', 'skill markdown'],
+    remove_skill: ['remove skill', 'delete skill'],
+    list_webhooks: ['webhooks', 'inbound webhook', 'list webhooks'],
+    add_webhook: ['add webhook', 'create webhook'],
+    add_webhook_from_catalog: ['webhook catalog', 'catalog webhook'],
+    list_environment_variables: ['env var', 'environment variables', 'secrets'],
+    add_environment_variable: ['env var', 'add secret', 'set variable'],
+    remove_environment_variable: ['env var', 'remove secret'],
+    list_mcp_servers: ['mcp server', 'list mcp', 'mcp catalog'],
+    add_mcp_server: ['add mcp', 'mcp server'],
+    add_mcp_server_from_catalog: ['mcp catalog', 'catalog mcp'],
+    // keygen messaging
+    send_key_gen_message: ['keygen message', 'send message', 'message peers'],
+    list_key_gen_messages: ['keygen message', 'inbox', 'list messages'],
+    get_key_gen_message_thread: ['message thread', 'conversation'],
 };
+export function classifyDefiToolPack(toolName) {
+    const n = stripMcpToolServerPrefix(toolName).toLowerCase();
+    if ((n.includes('build_') && n.includes('multisign')) ||
+        n.includes('create_swap') ||
+        n.includes('_place_') ||
+        n.includes('cancel_order') ||
+        n.includes('_close_position') ||
+        n.includes('close_position')) {
+        return 'trading';
+    }
+    if (n.includes('fetch_ohlcv') ||
+        n.includes('fetch_markets') ||
+        n.includes('fetch_open_context') ||
+        n.includes('search_markets') ||
+        n.includes('market_snapshot') ||
+        n.includes('fetch_open_orders') ||
+        n.includes('fetch_positions') ||
+        n.includes('usd_class_balances') ||
+        n.includes('fetch_vaults') ||
+        n.includes('user_vault_equities') ||
+        (n.includes('_quote') && !n.includes('build'))) {
+        return 'market-data';
+    }
+    return 'other';
+}
+export function defiProtocolPackGroupId(protocolId, pack = 'market-data') {
+    return `defi:${protocolId.trim()}:${pack}`;
+}
+/** Expand activate_tool_group aliases to concrete pack ids. */
+export function resolveActivateGroupIds(groupId) {
+    const id = groupId.trim();
+    if (!id) {
+        return [];
+    }
+    const aliased = GROUP_ACTIVATE_ALIASES[id];
+    if (aliased) {
+        return [...aliased];
+    }
+    // defi:<protocol> (no pack) → market-data only
+    if (id.startsWith('defi:')) {
+        const parts = id.split(':');
+        if (parts.length === 2 && parts[1]) {
+            return [defiProtocolPackGroupId(parts[1], 'market-data')];
+        }
+    }
+    return [id];
+}
+export function isChartFamilyGroupId(groupId) {
+    return groupId === 'chart' || groupId.startsWith('chart:');
+}
 export function resolveToolGroupId(name, options) {
     const bare = stripMcpToolServerPrefix(name);
     if (TOOL_GROUP_BY_NAME[bare]) {
@@ -300,10 +774,10 @@ export function resolveToolGroupId(name, options) {
         return TOOL_GROUP_BY_NAME[name];
     }
     if (options?.protocolId) {
-        return `defi:${options.protocolId}`;
+        return defiProtocolPackGroupId(options.protocolId, classifyDefiToolPack(bare));
     }
     if (bare.startsWith('ctm_') || name.startsWith('ctm_')) {
-        return 'defi:unknown';
+        return 'defi:unknown:other';
     }
     return 'unknown';
 }