keyring-agent-core 0.2.1 → 0.2.3

package/dist/tools/builtin/token/TokenInfoTool.js

@@ -1,221 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.TokenInfoTool = void 0;
-const BaseTool_1 = require("../../BaseTool");
-const chainResolver_1 = require("../../chainResolver");
-const MoralisService_1 = require("../../../services/MoralisService");
-const GeminiProvider_1 = require("../../../llm/GeminiProvider");
-/**
- * Tool: get-token-info
- *
- * Searches for a token by symbol/name and returns metadata, price,
- * 24h change, and whether the user holds it in their wallet.
- * Combines data from Pantograph search, Moralis metadata, and wallet balances.
- */
-class TokenInfoTool extends BaseTool_1.BaseTool {
-    name = 'get-token-info';
-    description = 'Get information about a specific cryptocurrency token: price, metadata, 24h change, market data, and user holdings. ' +
-        'Use this when the user asks about: token price, token info, "what is X token", "tell me about X", ' +
-        '"how much is X worth", or any token-specific question. ' +
-        'Supports: Ethereum, Optimism, BSC, Polygon, Base, Arbitrum, Avalanche, Linea';
-    category = 'blockchain-data';
-    parameters = [
-        {
-            name: 'keyword',
-            type: 'string',
-            description: 'Token symbol, name, or contract address (e.g. "USDC", "Pepe", "ETH", "0x1234…"). ' +
-                'If a 0x address is provided, performs a precise contract lookup. Otherwise searches by name/symbol.',
-            required: true,
-        },
-        {
-            name: 'chain',
-            type: 'string',
-            description: 'Hex chain ID: "0x1" Ethereum, "0xa" Optimism, "0x38" BSC, "0x89" Polygon, "0x2105" Base, ' +
-                '"0xa4b1" Arbitrum, "0xa86a" Avalanche, "0xe708" Linea. ONLY set this when the user EXPLICITLY names a chain; otherwise OMIT it so the connected wallet chain is used.',
-            required: false,
-        },
-        {
-            name: 'prompt',
-            type: 'string',
-            description: 'A rich, multi-angle research prompt sent to Gemini with Google Search grounding (real-time web access). ' +
-                "The prompt must be self-contained — Gemini does NOT see the user's original message, only this prompt. " +
-                'ALWAYS include: the token symbol/name, the chain, and an instruction to use web search for up-to-date info. ' +
-                'When the user asks an open/broad question (e.g. "show me X", "tell me about X", "what is X"), ' +
-                'expand the prompt to cover ALL of these angles in one request: ' +
-                '(1) what the token/project is and its core utility, ' +
-                '(2) current USD price, 24h change, market cap, FDV, 24h volume, ' +
-                '(3) recent news, announcements, or notable events in the last 7-30 days, ' +
-                '(4) on-chain activity signals (holders, liquidity, unusual flows), ' +
-                '(5) team/protocol updates or roadmap items, ' +
-                '(6) key risks, red flags, or controversies, ' +
-                '(7) sentiment and notable community discussion. ' +
-                'When the user asks a narrow question (e.g. "price of X"), still include 2-3 supporting angles for context. ' +
-                'Aim for 3-6 sentences. Be specific to the token. Do not use generic filler. ' +
-                'Example for "show me JPYT": "Research the JPYT token on Ethereum using up-to-date web sources. ' +
-                'Cover: what JPYT is and who issues it; current USD price, 24h change, market cap, FDV, and 24h volume; ' +
-                'recent news or announcements in the last 30 days; on-chain signals such as holder count, liquidity, ' +
-                'and unusual volume patterns; team or protocol updates; key risks or red flags; and overall sentiment."',
-            required: true,
-        },
-        {
-            name: 'buy_button_label',
-            type: 'string',
-            description: 'Label for the "Buy" suggestion button shown under the token info, IN THE USER\'S CURRENT LANGUAGE. ' +
-                'Use the exact placeholder "{token}" (do not translate the braces) for the token symbol; put the ' +
-                'localized verb directly in the text. ' +
-                'English example: "Buy {token}". Vietnamese example: "Mua {token}". Japanese example: "{token} を買う". ' +
-                'Always include {token}.',
-            required: true,
-        },
-        {
-            name: 'buy_prompt_template',
-            type: 'string',
-            description: 'A short "buy" command IN THE USER\'S CURRENT LANGUAGE, submitted as the next user turn when the Buy button ' +
-                'is clicked. Use the exact placeholder "{token}" (do not translate the braces) for the token symbol; put ' +
-                'the localized verb directly in the text. ' +
-                'English example: "buy {token}". Vietnamese example: "mua {token}". Japanese example: "{token} を買う". ' +
-                'Always include {token}.',
-            required: true,
-        },
-    ];
-    service;
-    llm;
-    constructor(config) {
-        super();
-        this.service = new MoralisService_1.MoralisService(config);
-        this.llm = new GeminiProvider_1.GeminiProvider({});
-    }
-    async run(args, userContext) {
-        const keyword = args.keyword || '';
-        const chain = (0, chainResolver_1.resolveChain)(args.chain, userContext);
-        const prompt = args.prompt || '';
-        const buyButtonLabel = args.buy_button_label || '';
-        const buyPromptTemplate = args.buy_prompt_template || '';
-        const walletAddress = userContext?.walletAddress || undefined;
-        if (!keyword) {
-            return { error: 'Missing required parameter: keyword' };
-        }
-        return await this.searchToken(keyword, chain, prompt, buyButtonLabel, buyPromptTemplate, walletAddress);
-    }
-    // Lift `actionButtons` from run() onto the ToolResult so AgentCore renders
-    // the Buy suggestion button below the token info.
-    async execute(args, userContext) {
-        const result = await super.execute(args, userContext);
-        const data = result.data;
-        if (result.success && data && Array.isArray(data.actionButtons) && data.actionButtons.length > 0) {
-            result.actionButtons = data.actionButtons;
-        }
-        return result;
-    }
-    async searchToken(keyword, chain, prompt, buyButtonLabel, buyPromptTemplate, walletAddress) {
-        const systemPrompt = [
-            walletAddress ? `User's connected wallet address: ${walletAddress}` : null,
-            chain ? `Current chain (hex chain ID): ${chain}, only consider tokens on this chain` : null,
-            'Use this context to personalize your answer where relevant (e.g. whether the user holds the token, chain-specific data).',
-        ]
-            .filter(Boolean)
-            .join('\n');
-        // Run search, wallet check, and Gemini (with Google Search grounding) in parallel
-        const [searchRes, walletHolding, aiText] = await Promise.all([
-            this.service.searchTokensByKey({ key: keyword, chain }),
-            walletAddress ? this.findTokenInWallet(walletAddress, chain, keyword) : Promise.resolve(null),
-            prompt ? this.askGeminiWithSearch(prompt, systemPrompt) : Promise.resolve(null),
-        ]);
-        const list = searchRes.success && searchRes.data ? (Array.isArray(searchRes.data) ? searchRes.data : []) : [];
-        const kw = keyword.toLowerCase();
-        const isExactMatch = (t) => t.symbol?.toLowerCase() === kw || t.token_address?.toLowerCase() === kw;
-        const sortedList = [...list].sort((a, b) => (isExactMatch(a) ? 0 : 1) - (isExactMatch(b) ? 0 : 1));
-        // Get Moralis metadata for best match (richer price data)
-        let token = null;
-        const topResult = sortedList[0];
-        if (topResult?.token_address) {
-            const metaRes = await this.service.getTokenMetadata({
-                address: topResult.token_address,
-                chain,
-            });
-            if (metaRes.success && metaRes.data) {
-                token = metaRes.data;
-            }
-        }
-        // Fallback: use search result directly
-        if (!token && topResult) {
-            token = { ...topResult };
-        }
-        // Offer a "Buy <token>" suggestion button when a token was resolved. The
-        // label/prompt are built from the LLM-supplied, already-localized templates
-        // (AgentCore stamps the turn language so a click re-runs in the same one).
-        const buySymbol = token?.symbol?.trim();
-        const buyButtons = buySymbol
-            ? [
-                {
-                    label: this.fillTemplate(buyButtonLabel, buySymbol, `Buy {token}`),
-                    prompt: this.fillTemplate(buyPromptTemplate, buySymbol, `buy {token}`),
-                },
-            ]
-            : [];
-        const data = {
-            _instructions: 'Present the token info in a clear summary. Include: token name & symbol, contract address (shortened), ' +
-                'current USD price, 24h price change % (use ▲ for positive, ▼ for negative), market cap, ' +
-                'fully diluted valuation, 24h trading volume, liquidity, and holder count (if available). ' +
-                'If the user holds this token, prominently show their balance and USD value. ' +
-                'If research is present, weave its substance naturally into your answer — fold the relevant points into ' +
-                'the description, context, and any notable news or risks. Do NOT add a labelled "AI Analysis" section or ' +
-                'any similar heading, and do NOT mention that the analysis came from AI; just write it as part of the ' +
-                'token summary. ' +
-                'Format numbers in a human-readable way (e.g. $1.23, +5.67%, $12.5M). If a field is null, omit it. ' +
-                'A "Buy" button is shown below your reply automatically — do NOT mention it, list it, or repeat its text.',
-            chain,
-            userHoldsToken: !!walletHolding,
-            walletBalance: walletHolding,
-            token,
-            ...(list.length > 1
-                ? {
-                    searchResults: sortedList.slice(0, 10),
-                }
-                : {}),
-            research: aiText,
-            ...(buyButtons.length > 0 ? { actionButtons: buyButtons } : {}),
-        };
-        return data;
-    }
-    /** Substitute the {token} placeholder in an LLM-supplied localized template. */
-    fillTemplate(template, token, fallback) {
-        const tpl = template && template.includes('{token}') ? template : fallback;
-        return tpl
-            .replace(/\{token\}/g, token)
-            .replace(/\s+/g, ' ')
-            .trim();
-    }
-    async askGeminiWithSearch(prompt, systemPrompt) {
-        const now = Date.now();
-        try {
-            const res = await this.llm.chat([
-                ...(systemPrompt ? [{ role: 'system', content: systemPrompt, timestamp: now }] : []),
-                { role: 'user', content: prompt, timestamp: now },
-            ], undefined, { googleSearch: true, maxRetries: 1 });
-            return res.text?.trim() || null;
-        }
-        catch {
-            return null;
-        }
-    }
-    async findTokenInWallet(walletAddress, chain, keyword) {
-        if (!keyword)
-            return null;
-        const balancesRes = await this.service.getWalletTokenBalances({
-            address: walletAddress,
-            chain,
-            excludeSpam: true,
-            excludeUnverifiedContracts: true,
-        });
-        if (!balancesRes.success || !balancesRes.data?.result)
-            return null;
-        const kw = keyword.toLowerCase();
-        const match = balancesRes.data.result.find((t) => t.token_address.toLowerCase() === kw || t.symbol?.toLowerCase() === kw || t.name?.toLowerCase().includes(kw));
-        if (!match)
-            return null;
-        return match;
-    }
-}
-exports.TokenInfoTool = TokenInfoTool;
-//# sourceMappingURL=TokenInfoTool.js.map

package/dist/tools/builtin/token/TokenInfoTool.js.map

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

package/dist/tools/builtin/token/TokenScoreTool.d.ts

@@ -1,63 +0,0 @@
-import { BaseTool } from '../../BaseTool';
-import type { ToolParameter, UserContext } from '../../../types';
-import { type MoralisServiceConfig } from '../../../services/MoralisService';
-export type TokenScoreToolConfig = MoralisServiceConfig;
-/**
- * Tool: get-token-score
- *
- * Queries `GET /tokens/{tokenAddress}/score` — a composite 0–100 health/safety
- * score for a single token, plus the underlying metrics Moralis uses to
- * compute it.
- *
- * Returned fields:
- *   - score: integer 0–100 (higher = safer / healthier)
- *   - updatedAt: ISO timestamp of last refresh
- *   - metrics.usdPrice, metrics.liquidityUsd
- *   - metrics.volumeUsd: 10m / 30m / 1h / 4h / 12h / 1d / 7d / 30d
- *   - metrics.transactions: same 8 buckets
- *   - metrics.supply: { total, top10Percent }
- *
- * Accepts either `tokenSymbol` (e.g. "PEPE") or `contractAddress` (0x…).
- * Symbol → address resolution mirrors `TokenAnalyticsTool` / `TokenHoldersTool`:
- * first checks the connected wallet's balances, then falls back to Pantograph
- * search.
- */
-export declare class TokenScoreTool extends BaseTool {
-    name: string;
-    description: string;
-    category: string;
-    parameters: ToolParameter[];
-    private service;
-    constructor(config?: TokenScoreToolConfig);
-    protected run(args: Record<string, unknown>, userContext?: UserContext): Promise<{
-        error: string;
-        token?: undefined;
-        score?: undefined;
-        updatedAt?: undefined;
-        metrics?: undefined;
-    } | {
-        token: {
-            symbol: string | null;
-            name: string | null;
-            contractAddress: string;
-            chain: string;
-        };
-        score: number | null;
-        updatedAt: string | null;
-        metrics: {
-            usdPrice: number | null;
-            liquidityUsd: number | null;
-            volumeUsd: import("../../../services/MoralisService").TokenScoreTimeframeBuckets | null;
-            transactions: import("../../../services/MoralisService").TokenScoreTimeframeBuckets | null;
-            supply: import("../../../services/MoralisService").TokenScoreSupply | null;
-        };
-        error?: undefined;
-    }>;
-    /**
-     * Resolve a contract address from a token symbol.
-     * 1. Wallet balances (if wallet address available — most reliable)
-     * 2. Pantograph token search (fallback)
-     */
-    private resolveContractAddress;
-}
-//# sourceMappingURL=TokenScoreTool.d.ts.map

package/dist/tools/builtin/token/TokenScoreTool.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"TokenScoreTool.d.ts","sourceRoot":"","sources":["../../../../src/tools/builtin/token/TokenScoreTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AACjE,OAAO,EAAkB,KAAK,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AAE7F,MAAM,MAAM,oBAAoB,GAAG,oBAAoB,CAAC;AAExD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,cAAe,SAAQ,QAAQ;IAC1C,IAAI,SAAqB;IACzB,WAAW,SAauE;IAClF,QAAQ,SAAqB;IAC7B,UAAU,EAAE,aAAa,EAAE,CA0BzB;IAEF,OAAO,CAAC,OAAO,CAAiB;gBAEpB,MAAM,CAAC,EAAE,oBAAoB;cAKzB,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,CAAC,EAAE,WAAW;;;;;;;;;;;;;;;;;;;;;;;;IA0D5E;;;;OAIG;YACW,sBAAsB;CA4BrC"}

package/dist/tools/builtin/token/TokenScoreTool.js

@@ -1,148 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.TokenScoreTool = void 0;
-const BaseTool_1 = require("../../BaseTool");
-const chainResolver_1 = require("../../chainResolver");
-const MoralisService_1 = require("../../../services/MoralisService");
-/**
- * Tool: get-token-score
- *
- * Queries `GET /tokens/{tokenAddress}/score` — a composite 0–100 health/safety
- * score for a single token, plus the underlying metrics Moralis uses to
- * compute it.
- *
- * Returned fields:
- *   - score: integer 0–100 (higher = safer / healthier)
- *   - updatedAt: ISO timestamp of last refresh
- *   - metrics.usdPrice, metrics.liquidityUsd
- *   - metrics.volumeUsd: 10m / 30m / 1h / 4h / 12h / 1d / 7d / 30d
- *   - metrics.transactions: same 8 buckets
- *   - metrics.supply: { total, top10Percent }
- *
- * Accepts either `tokenSymbol` (e.g. "PEPE") or `contractAddress` (0x…).
- * Symbol → address resolution mirrors `TokenAnalyticsTool` / `TokenHoldersTool`:
- * first checks the connected wallet's balances, then falls back to Pantograph
- * search.
- */
-class TokenScoreTool extends BaseTool_1.BaseTool {
-    name = 'get-token-score';
-    description = 'Get a composite 0–100 health/safety score for a single ERC-20 token, plus the metrics behind it. ' +
-        'Returns: overall score, last-updated timestamp, current USD price, paired liquidity, ' +
-        'multi-timeframe volume buckets (10m / 30m / 1h / 4h / 12h / 1d / 7d / 30d), ' +
-        'same buckets for transaction counts, and supply info (total supply + % held by top 10 holders). ' +
-        'Use tokenSymbol (e.g. "PEPE") to look up by name — the tool auto-resolves the contract address. ' +
-        'Use contractAddress when you already have the exact 0x address. ' +
-        'Use this tool for questions like: ' +
-        '"Is PEPE a safe token?" (tokenSymbol=PEPE → score), ' +
-        '"What\'s the health/score of USDC?", ' +
-        '"How concentrated is X\'s supply among whales?" (→ metrics.supply.top10Percent), ' +
-        '"How much volume did this token do over the last 7 days?" (→ metrics.volumeUsd.7d), ' +
-        '"Transaction count for this token in the last hour?" (→ metrics.transactions.1h). ' +
-        'Supports: Ethereum, Optimism, BSC, Polygon, Base, Arbitrum, Avalanche, Linea.';
-    category = 'blockchain-data';
-    parameters = [
-        {
-            name: 'tokenSymbol',
-            type: 'string',
-            description: 'Token symbol (e.g. "PEPE", "USDC", "WETH"). ' +
-                "The tool resolves the contract address automatically: first checks the connected wallet's balances, " +
-                'then searches by symbol. Takes precedence over contractAddress when both are given.',
-            required: false,
-        },
-        {
-            name: 'contractAddress',
-            type: 'string',
-            description: 'ERC-20 token contract address (0x…). Use when the exact address is already known. ' +
-                'Ignored if tokenSymbol is provided.',
-            required: false,
-        },
-        {
-            name: 'chain',
-            type: 'string',
-            description: 'Hex chain ID: "0x1" Ethereum, "0xa" Optimism, "0x38" BSC, "0x89" Polygon, "0x2105" Base, ' +
-                '"0xa4b1" Arbitrum, "0xa86a" Avalanche, "0xe708" Linea. ONLY set this when the user EXPLICITLY names a chain; otherwise OMIT it so the connected wallet chain is used.',
-            required: false,
-        },
-    ];
-    service;
-    constructor(config) {
-        super();
-        this.service = new MoralisService_1.MoralisService(config);
-    }
-    async run(args, userContext) {
-        const chain = (0, chainResolver_1.resolveChain)(args.chain, userContext);
-        const walletAddress = userContext?.walletAddress || undefined;
-        const tokenSymbol = typeof args.tokenSymbol === 'string' && args.tokenSymbol ? args.tokenSymbol.trim() : undefined;
-        let contractAddress = typeof args.contractAddress === 'string' && args.contractAddress ? args.contractAddress.trim() : undefined;
-        if (!tokenSymbol && !contractAddress) {
-            return { error: 'Provide either tokenSymbol (e.g. "PEPE") or contractAddress (0x…).' };
-        }
-        let resolvedSymbol;
-        let resolvedName;
-        if (tokenSymbol) {
-            const resolved = await this.resolveContractAddress(tokenSymbol, chain, walletAddress);
-            if (!resolved) {
-                return {
-                    error: `Cannot resolve token symbol "${tokenSymbol}" to a contract address on chain ${chain ?? 'default'}. Try passing contractAddress directly.`,
-                };
-            }
-            contractAddress = resolved.address;
-            resolvedSymbol = resolved.symbol;
-            resolvedName = resolved.name;
-        }
-        const result = await this.service.getTokenScore({
-            address: contractAddress,
-            chain,
-        });
-        if (!result.success) {
-            return { error: result.error || 'Failed to fetch token score' };
-        }
-        const data = result.data ?? {};
-        const metrics = data.metrics ?? {};
-        return {
-            token: {
-                symbol: resolvedSymbol ?? tokenSymbol ?? null,
-                name: resolvedName ?? null,
-                contractAddress: contractAddress,
-                chain: chain || 'default',
-            },
-            score: data.score ?? null,
-            updatedAt: data.updatedAt ?? null,
-            metrics: {
-                usdPrice: metrics.usdPrice ?? null,
-                liquidityUsd: metrics.liquidityUsd ?? null,
-                volumeUsd: metrics.volumeUsd ?? null,
-                transactions: metrics.transactions ?? null,
-                supply: metrics.supply ?? null,
-            },
-        };
-    }
-    /**
-     * Resolve a contract address from a token symbol.
-     * 1. Wallet balances (if wallet address available — most reliable)
-     * 2. Pantograph token search (fallback)
-     */
-    async resolveContractAddress(symbol, chain, walletAddress) {
-        const symLower = symbol.toLowerCase();
-        if (walletAddress) {
-            const balRes = await this.service.getWalletTokenBalances({ address: walletAddress, chain });
-            if (balRes.success && balRes.data?.result?.length) {
-                const match = balRes.data.result.find((t) => (t.symbol ?? '').toLowerCase() === symLower);
-                if (match) {
-                    return { address: match.token_address, symbol: match.symbol, name: match.name };
-                }
-            }
-        }
-        const searchRes = await this.service.searchTokensByKey({ key: symbol, chain });
-        if (searchRes.success && searchRes.data?.length) {
-            const exact = searchRes.data.find((t) => (t.symbol ?? '').toLowerCase() === symLower);
-            const candidate = exact ?? searchRes.data[0];
-            if (candidate?.token_address) {
-                return { address: candidate.token_address, symbol: candidate.symbol, name: candidate.name };
-            }
-        }
-        return undefined;
-    }
-}
-exports.TokenScoreTool = TokenScoreTool;
-//# sourceMappingURL=TokenScoreTool.js.map

package/dist/tools/builtin/token/TokenScoreTool.js.map

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

package/dist/tools/builtin/token/TopGainersTool.d.ts

@@ -1,37 +0,0 @@
-import { BaseTool } from '../../BaseTool';
-import type { ToolParameter, UserContext } from '../../../types';
-import type { MoralisServiceConfig } from '../../../services/MoralisService';
-export type TopGainersToolConfig = MoralisServiceConfig;
-/**
- * Tool: get-top-gainers
- *
- * Queries Pantograph's `GET /token-list/top-gainers/{chain}?duration=…` — the
- * tokens with the largest USD price increase over a chosen window. Single-chain
- * (Pantograph has no cross-chain feed); defaults to the connected chain, then
- * Base. Returns the canonical trending-token shape: price, market cap, 24h
- * volume, and the price change over the selected window.
- */
-export declare class TopGainersTool extends BaseTool {
-    name: string;
-    description: string;
-    category: string;
-    parameters: ToolParameter[];
-    private service;
-    constructor(config?: TopGainersToolConfig);
-    protected run(args: Record<string, unknown>, userContext?: UserContext): Promise<{
-        error: string;
-        _instructions?: undefined;
-        chain?: undefined;
-        timeFrame?: undefined;
-        count?: undefined;
-        tokens?: undefined;
-    } | {
-        _instructions: string;
-        chain: string;
-        timeFrame: string | null;
-        count: number;
-        tokens: import("../../../services/MoralisService").TrendingToken[];
-        error?: undefined;
-    }>;
-}
-//# sourceMappingURL=TopGainersTool.d.ts.map

package/dist/tools/builtin/token/TopGainersTool.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"TopGainersTool.d.ts","sourceRoot":"","sources":["../../../../src/tools/builtin/token/TopGainersTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AACjE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AAG7E,MAAM,MAAM,oBAAoB,GAAG,oBAAoB,CAAC;AAWxD;;;;;;;;GAQG;AACH,qBAAa,cAAe,SAAQ,QAAQ;IAC1C,IAAI,SAAqB;IACzB,WAAW,SAOuE;IAClF,QAAQ,SAAqB;IAC7B,UAAU,EAAE,aAAa,EAAE,CA0BzB;IAEF,OAAO,CAAC,OAAO,CAAoB;gBAEvB,MAAM,CAAC,EAAE,oBAAoB;cAKzB,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,CAAC,EAAE,WAAW;;;;;;;;;;;;;;;CA2C7E"}

package/dist/tools/builtin/token/TopGainersTool.js

@@ -1,100 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.TopGainersTool = void 0;
-const BaseTool_1 = require("../../BaseTool");
-const chainResolver_1 = require("../../chainResolver");
-const PantographService_1 = require("../../../services/PantographService");
-/** Maps the user-facing timeframe to a Pantograph `duration` window. */
-const TIMEFRAME_TO_DURATION = {
-    '1h': '1h',
-    '1d': '24h',
-    '1w': '7d',
-    '1M': '30d',
-};
-const ALLOWED_TIMEFRAMES = Object.keys(TIMEFRAME_TO_DURATION);
-/**
- * Tool: get-top-gainers
- *
- * Queries Pantograph's `GET /token-list/top-gainers/{chain}?duration=…` — the
- * tokens with the largest USD price increase over a chosen window. Single-chain
- * (Pantograph has no cross-chain feed); defaults to the connected chain, then
- * Base. Returns the canonical trending-token shape: price, market cap, 24h
- * volume, and the price change over the selected window.
- */
-class TopGainersTool extends BaseTool_1.BaseTool {
-    name = 'get-top-gainers';
-    description = 'List tokens with the highest USD price increase over a chosen timeframe (1h / 1d / 1w / 1M). ' +
-        'Returns name & symbol, current USD price, market cap, 24h volume, and the price change % over the selected window. ' +
-        'Scoped to a single chain — pass `chain` to pick the network, otherwise the connected chain (or Base) is used. ' +
-        'Use this tool for questions like: ' +
-        '"What are today\'s top gainers?", "Biggest pumps this week?", "Which tokens went up most in the last hour?", ' +
-        '"Top gainers on Base". ' +
-        'Supports: Ethereum, Optimism, BSC, Polygon, Base, Arbitrum, Avalanche, Linea.';
-    category = 'blockchain-data';
-    parameters = [
-        {
-            name: 'chain',
-            type: 'string',
-            description: 'Hex chain ID: "0x1" Ethereum, "0xa" Optimism, "0x38" BSC, "0x89" Polygon, "0x2105" Base, ' +
-                '"0xa4b1" Arbitrum, "0xa86a" Avalanche, "0xe708" Linea. Defaults to the connected chain, or Base (0x2105).',
-            required: false,
-        },
-        {
-            name: 'timeFrame',
-            type: 'string',
-            description: 'Window over which the price change is measured. Allowed values: ' +
-                '"1h" (last hour), "1d" (last 24h), "1w" (last 7 days), "1M" (last 30 days). ' +
-                'Pick the timeframe that matches the user\'s question — e.g. "today" → "1d", "this week" → "1w". Defaults to "1d".',
-            required: false,
-        },
-        {
-            name: 'limit',
-            type: 'number',
-            description: 'Number of top gainers to return. Only set this when the user asks for a specific count ' +
-                '(e.g. "show 20 top gainers" → 20). Omit otherwise.',
-            required: false,
-        },
-    ];
-    service;
-    constructor(config) {
-        super();
-        this.service = new PantographService_1.PantographService({ baseUrl: config?.pantographUrl });
-    }
-    async run(args, userContext) {
-        const chain = (0, chainResolver_1.resolveChainScope)(args.chain, userContext);
-        const rawTimeFrame = typeof args.timeFrame === 'string' ? args.timeFrame.trim() : undefined;
-        if (rawTimeFrame && !ALLOWED_TIMEFRAMES.includes(rawTimeFrame)) {
-            return {
-                error: `Invalid timeFrame "${rawTimeFrame}". Allowed values: ${ALLOWED_TIMEFRAMES.join(', ')}.`,
-            };
-        }
-        const timeFrame = rawTimeFrame || undefined;
-        const duration = timeFrame ? TIMEFRAME_TO_DURATION[timeFrame] : undefined;
-        const limit = typeof args.limit === 'number' && Number.isFinite(args.limit) && args.limit > 0
-            ? Math.floor(args.limit)
-            : undefined;
-        const result = await this.service.getTopGainers({ chain, limit, duration });
-        if (!result.success) {
-            return { error: result.error || 'Failed to fetch top gainers' };
-        }
-        const tokens = result.data ?? [];
-        return {
-            _instructions: 'Start with a one-line header like "Here are the top gainers on <chain name> right now:". ' +
-                'Then present the tokens as a numbered list. For EACH token render exactly these lines (omit any line whose value is null):\n' +
-                '<rank>. <name> (<symbol>)\n' +
-                '- Price: <usdPrice>\n' +
-                '- Market Cap: <marketCap>\n' +
-                '- Price Change: <pricePercentChange.24h> (use ▲ for positive, ▼ for negative)\n' +
-                '- 24h Volume: <totalVolume.24h>\n' +
-                'Format numbers human-readably: price as $0.65 / $0.016 (more decimals for sub-cent), ' +
-                'market cap & volume compact ($12.8M, $6,474), price change signed with one or two decimals (+5.67%, -1.6%). ' +
-                "Reply in the user's language and use the human-readable chain name. Do NOT mention tool names, UI, or forms.",
-            chain: chain ?? 'all',
-            timeFrame: timeFrame ?? null,
-            count: tokens.length,
-            tokens: tokens,
-        };
-    }
-}
-exports.TopGainersTool = TopGainersTool;
-//# sourceMappingURL=TopGainersTool.js.map

package/dist/tools/builtin/token/TopGainersTool.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"TopGainersTool.js","sourceRoot":"","sources":["../../../../src/tools/builtin/token/TopGainersTool.ts"],"names":[],"mappings":";;;AAAA,6CAA0C;AAC1C,uDAAwD;AAGxD,2EAAwE;AAIxE,wEAAwE;AACxE,MAAM,qBAAqB,GAA2B;IACpD,IAAI,EAAE,IAAI;IACV,IAAI,EAAE,KAAK;IACX,IAAI,EAAE,IAAI;IACV,IAAI,EAAE,KAAK;CACZ,CAAC;AACF,MAAM,kBAAkB,GAAG,MAAM,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;AAE9D;;;;;;;;GAQG;AACH,MAAa,cAAe,SAAQ,mBAAQ;IAC1C,IAAI,GAAG,iBAAiB,CAAC;IACzB,WAAW,GACT,+FAA+F;QAC/F,qHAAqH;QACrH,gHAAgH;QAChH,oCAAoC;QACpC,+GAA+G;QAC/G,yBAAyB;QACzB,+EAA+E,CAAC;IAClF,QAAQ,GAAG,iBAAiB,CAAC;IAC7B,UAAU,GAAoB;QAC5B;YACE,IAAI,EAAE,OAAO;YACb,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,2FAA2F;gBAC3F,2GAA2G;YAC7G,QAAQ,EAAE,KAAK;SAChB;QACD;YACE,IAAI,EAAE,WAAW;YACjB,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,kEAAkE;gBAClE,8EAA8E;gBAC9E,mHAAmH;YACrH,QAAQ,EAAE,KAAK;SAChB;QACD;YACE,IAAI,EAAE,OAAO;YACb,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,yFAAyF;gBACzF,oDAAoD;YACtD,QAAQ,EAAE,KAAK;SAChB;KACF,CAAC;IAEM,OAAO,CAAoB;IAEnC,YAAY,MAA6B;QACvC,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,OAAO,GAAG,IAAI,qCAAiB,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC,CAAC;IAC3E,CAAC;IAES,KAAK,CAAC,GAAG,CAAC,IAA6B,EAAE,WAAyB;QAC1E,MAAM,KAAK,GAAG,IAAA,iCAAiB,EAAC,IAAI,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;QAEzD,MAAM,YAAY,GAAG,OAAO,IAAI,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;QAC5F,IAAI,YAAY,IAAI,CAAC,kBAAkB,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC;YAC/D,OAAO;gBACL,KAAK,EAAE,sBAAsB,YAAY,sBAAsB,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;aAChG,CAAC;QACJ,CAAC;QACD,MAAM,SAAS,GAAG,YAAY,IAAI,SAAS,CAAC;QAC5C,MAAM,QAAQ,GAAG,SAAS,CAAC,CAAC,CAAC,qBAAqB,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAE1E,MAAM,KAAK,GACT,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,GAAG,CAAC;YAC7E,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC;YACxB,CAAC,CAAC,SAAS,CAAC;QAEhB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;QAE5E,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,6BAA6B,EAAE,CAAC;QAClE,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;QAEjC,OAAO;YACL,aAAa,EACX,2FAA2F;gBAC3F,8HAA8H;gBAC9H,6BAA6B;gBAC7B,uBAAuB;gBACvB,6BAA6B;gBAC7B,iFAAiF;gBACjF,mCAAmC;gBACnC,uFAAuF;gBACvF,8GAA8G;gBAC9G,8GAA8G;YAChH,KAAK,EAAE,KAAK,IAAI,KAAK;YACrB,SAAS,EAAE,SAAS,IAAI,IAAI;YAC5B,KAAK,EAAE,MAAM,CAAC,MAAM;YACpB,MAAM,EAAE,MAAM;SACf,CAAC;IACJ,CAAC;CACF;AAzFD,wCAyFC"}