keyring-agent-core 0.1.1 → 0.2.1

package/dist/tools/builtin/pool-subgraph/SubgraphPoolByPositionIdTool.js

@@ -0,0 +1,97 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SubgraphPoolByPositionIdTool = void 0;
+const BaseTool_1 = require("../../BaseTool");
+const UniswapSubgraphService_1 = require("../../../services/UniswapSubgraphService");
+const SubgraphPoolSearchTool_1 = require("./SubgraphPoolSearchTool");
+/**
+ * Tool: subgraph-pool-by-position-id
+ *
+ * Resolve a Uniswap V3 NFT position id to its underlying pool (without the
+ * deposit / fee history). Useful when the user asks "what pool is position
+ * 12345 in?" or refers to a pool by its position id colloquially.
+ */
+class SubgraphPoolByPositionIdTool extends BaseTool_1.BaseTool {
+    name = 'subgraph-pool-by-position-id';
+    description = 'Return the pool underlying a Uniswap V3 NFT position id. ' +
+        'Use when the user wants the pool stats for a numeric id WITHOUT the deposit/withdraw/fee history ' +
+        '(e.g. "which pool is position 962961 in?", "show the pool of id 12345"). ' +
+        'For full position history use subgraph-position-detail instead.';
+    category = 'blockchain-data';
+    noSuggestions = true;
+    parameters = [
+        {
+            name: 'positionId',
+            type: 'string',
+            description: 'Numeric Uniswap V3 NFT position id as a string.',
+            required: true,
+        },
+        {
+            name: 'chains',
+            type: 'array',
+            items: { type: 'string' },
+            description: 'Hex chain IDs: "0x1" Ethereum, "0xa" Optimism, "0x38" BSC, "0x89" Polygon, "0x2105" Base, "0xa4b1" Arbitrum, "0xa86a" Avalanche. ' +
+                'Pass [] when the user did not name a chain — the tool defaults to the connected chain.',
+            required: false,
+            default: [],
+        },
+    ];
+    service;
+    constructor(config) {
+        super();
+        this.service = new UniswapSubgraphService_1.UniswapSubgraphService(config);
+    }
+    async run(args, userContext) {
+        const positionId = typeof args.positionId === 'string' ? args.positionId.trim() : '';
+        if (!/^\d+$/.test(positionId)) {
+            return { error: 'positionId must be a numeric string.' };
+        }
+        const requested = (Array.isArray(args.chains) ? args.chains : []).filter((c) => typeof c === 'string' && c.trim().length > 0);
+        const unsupported = requested.filter((c) => !this.service.isSupported(c));
+        const supported = requested.filter((c) => this.service.isSupported(c)).map((c) => this.service.resolveChain(c));
+        if (requested.length > 0 && supported.length === 0) {
+            return {
+                _instructions: 'Requested chains are not supported. List the supported chains.',
+                unsupportedChains: unsupported,
+                supportedChains: this.service.listSupportedChains(),
+            };
+        }
+        const chains = supported.length > 0
+            ? supported
+            : this.service.isSupported(userContext?.chain)
+                ? [this.service.resolveChain(userContext?.chain)]
+                : ['0x1'];
+        const results = await Promise.allSettled(chains.map((chain) => this.service.getPoolByPositionId({ positionId, chain })));
+        const pool = results.map((r) => (r.status === 'fulfilled' ? r.value : null)).find((p) => p != null);
+        if (!pool) {
+            return {
+                _instructions: 'No pool found for this position id on the chosen chains. Ask the user to verify the id or chain.',
+                positionId,
+                chains,
+                found: false,
+            };
+        }
+        return {
+            _instructions: 'Prefix with: "According to the latest data from Subgraph Uniswap V3," (translate naturally; keep "Subgraph" as-is). ' +
+                'Show the pool of that position: pair, fee %, TVL, 24h volume, APR. Mention the position id. ' +
+                'End the response with the provided uniswapUrl as a clickable markdown link, e.g. "[View on Uniswap](uniswapUrl)". Never omit it. Do not invent URLs.',
+            positionId,
+            pool: {
+                pair: pool.pair,
+                poolAddress: pool.poolAddress,
+                chain: pool.chain,
+                feeTierBps: pool.feeTierBps,
+                feeTierPercent: pool.feeTierPercent,
+                tvlUsd: pool.tvl,
+                volume24hUsd: pool.volume24hUsd,
+                fees24hUsd: pool.fees24hUsd,
+                apr: pool.apr,
+                token0: pool.token0,
+                token1: pool.token1,
+                uniswapUrl: (0, SubgraphPoolSearchTool_1.buildUniswapPoolUrl)(pool),
+            },
+        };
+    }
+}
+exports.SubgraphPoolByPositionIdTool = SubgraphPoolByPositionIdTool;
+//# sourceMappingURL=SubgraphPoolByPositionIdTool.js.map

package/dist/tools/builtin/pool-subgraph/SubgraphPoolByPositionIdTool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SubgraphPoolByPositionIdTool.js","sourceRoot":"","sources":["../../../../src/tools/builtin/pool-subgraph/SubgraphPoolByPositionIdTool.ts"],"names":[],"mappings":";;;AAAA,6CAA0C;AAE1C,qFAA8G;AAC9G,qEAA+D;AAI/D;;;;;;GAMG;AACH,MAAa,4BAA6B,SAAQ,mBAAQ;IACxD,IAAI,GAAG,8BAA8B,CAAC;IACtC,WAAW,GACT,2DAA2D;QAC3D,mGAAmG;QACnG,2EAA2E;QAC3E,iEAAiE,CAAC;IACpE,QAAQ,GAAG,iBAAiB,CAAC;IAC7B,aAAa,GAAG,IAAI,CAAC;IACrB,UAAU,GAAoB;QAC5B;YACE,IAAI,EAAE,YAAY;YAClB,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,iDAAiD;YAC9D,QAAQ,EAAE,IAAI;SACf;QACD;YACE,IAAI,EAAE,QAAQ;YACd,IAAI,EAAE,OAAO;YACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACzB,WAAW,EACT,mIAAmI;gBACnI,wFAAwF;YAC1F,QAAQ,EAAE,KAAK;YACf,OAAO,EAAE,EAAE;SACZ;KACF,CAAC;IAEM,OAAO,CAAyB;IAExC,YAAY,MAA2C;QACrD,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,OAAO,GAAG,IAAI,+CAAsB,CAAC,MAAM,CAAC,CAAC;IACpD,CAAC;IAES,KAAK,CAAC,GAAG,CAAC,IAA6B,EAAE,WAAyB;QAC1E,MAAM,UAAU,GAAG,OAAO,IAAI,CAAC,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACrF,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;YAC9B,OAAO,EAAE,KAAK,EAAE,sCAAsC,EAAE,CAAC;QAC3D,CAAC;QACD,MAAM,SAAS,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAE,IAAI,CAAC,MAAoB,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,CACrF,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CACjE,CAAC;QACF,MAAM,WAAW,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;QAC1E,MAAM,SAAS,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;QAEhH,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACnD,OAAO;gBACL,aAAa,EAAE,gEAAgE;gBAC/E,iBAAiB,EAAE,WAAW;gBAC9B,eAAe,EAAE,IAAI,CAAC,OAAO,CAAC,mBAAmB,EAAE;aACpD,CAAC;QACJ,CAAC;QAED,MAAM,MAAM,GACV,SAAS,CAAC,MAAM,GAAG,CAAC;YAClB,CAAC,CAAC,SAAS;YACX,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,WAAW,EAAE,KAAK,CAAC;gBAC5C,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;gBACjD,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QAEhB,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,CACtC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,mBAAmB,CAAC,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC,CAC/E,CAAC;QACF,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC;QAEpG,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO;gBACL,aAAa,EACX,kGAAkG;gBACpG,UAAU;gBACV,MAAM;gBACN,KAAK,EAAE,KAAK;aACb,CAAC;QACJ,CAAC;QAED,OAAO;YACL,aAAa,EACX,sHAAsH;gBACtH,8FAA8F;gBAC9F,sJAAsJ;YACxJ,UAAU;YACV,IAAI,EAAE;gBACJ,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,WAAW,EAAE,IAAI,CAAC,WAAW;gBAC7B,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,UAAU,EAAE,IAAI,CAAC,UAAU;gBAC3B,cAAc,EAAE,IAAI,CAAC,cAAc;gBACnC,MAAM,EAAE,IAAI,CAAC,GAAG;gBAChB,YAAY,EAAE,IAAI,CAAC,YAAY;gBAC/B,UAAU,EAAE,IAAI,CAAC,UAAU;gBAC3B,GAAG,EAAE,IAAI,CAAC,GAAG;gBACb,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,UAAU,EAAE,IAAA,4CAAmB,EAAC,IAAI,CAAC;aACtC;SACF,CAAC;IACJ,CAAC;CACF;AAlGD,oEAkGC"}

package/dist/tools/builtin/pool-subgraph/SubgraphPoolSearchTool.d.ts

@@ -0,0 +1,77 @@
+import { BaseTool } from '../../BaseTool';
+import type { ToolParameter, UserContext } from '../../../types';
+import { type SubgraphServiceConfig, type SubgraphSort } from '../../../services/UniswapSubgraphService';
+export type SubgraphPoolSearchToolConfig = SubgraphServiceConfig;
+/**
+ * Tool: subgraph-search-pools
+ *
+ * Search Uniswap V3 pools across one or more EVM chains via The Graph
+ * subgraphs. Handles single-token, two-token, and no-token queries. Used
+ * for intents: search_pool, best_pool, safe_pool, compare_pool, new_pool.
+ *
+ * APR comes from DefiLlama Yields (uniswap-v3 only) for accuracy.
+ */
+export declare class SubgraphPoolSearchTool extends BaseTool {
+    name: string;
+    description: string;
+    category: string;
+    noSuggestions: boolean;
+    parameters: ToolParameter[];
+    private service;
+    constructor(config?: SubgraphPoolSearchToolConfig);
+    protected run(args: Record<string, unknown>, userContext?: UserContext): Promise<{
+        _instructions: string;
+        unsupportedChains: string[];
+        supportedChains: string[];
+        pools: never[];
+        count: number;
+        tokens?: undefined;
+        chains?: undefined;
+        sortBy?: undefined;
+        filters?: undefined;
+    } | {
+        _instructions: string;
+        tokens: string[];
+        chains: string[];
+        unsupportedChains: string[];
+        sortBy: SubgraphSort;
+        filters: {
+            minTVL: number | undefined;
+            maxTVL: number | undefined;
+            minAPR: number | undefined;
+            maxAPR: number | undefined;
+            feeTier: number | undefined;
+        };
+        count: number;
+        pools: {
+            pair: string;
+            poolAddress: string;
+            chain: string;
+            feeTierBps: number;
+            feeTierPercent: number;
+            tvlUsd: number;
+            volume24hUsd: number;
+            fees24hUsd: number;
+            apr: number | null;
+            token0: {
+                symbol: string;
+                address: string;
+                name?: string;
+            };
+            token1: {
+                symbol: string;
+                address: string;
+                name?: string;
+            };
+            uniswapUrl: string;
+        }[];
+        supportedChains?: undefined;
+    }>;
+    private formatPool;
+}
+export declare function buildUniswapPoolUrl(p: {
+    chain: string;
+    poolAddress: string;
+}): string;
+export declare const UNISWAP_CHAIN_SLUG: Record<string, string>;
+//# sourceMappingURL=SubgraphPoolSearchTool.d.ts.map

package/dist/tools/builtin/pool-subgraph/SubgraphPoolSearchTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SubgraphPoolSearchTool.d.ts","sourceRoot":"","sources":["../../../../src/tools/builtin/pool-subgraph/SubgraphPoolSearchTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AACjE,OAAO,EAEL,KAAK,qBAAqB,EAE1B,KAAK,YAAY,EAClB,MAAM,0CAA0C,CAAC;AAElD,MAAM,MAAM,4BAA4B,GAAG,qBAAqB,CAAC;AAIjE;;;;;;;;GAQG;AACH,qBAAa,sBAAuB,SAAQ,QAAQ;IAClD,IAAI,SAA2B;IAC/B,WAAW,SAK6H;IACxI,QAAQ,SAAqB;IAC7B,aAAa,UAAQ;IACrB,UAAU,EAAE,aAAa,EAAE,CAiEzB;IAEF,OAAO,CAAC,OAAO,CAAyB;gBAE5B,MAAM,CAAC,EAAE,4BAA4B;cAKjC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,CAAC,EAAE,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IA+E5E,OAAO,CAAC,UAAU;CAgBnB;AAED,wBAAgB,mBAAmB,CAAC,CAAC,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAGrF;AAED,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAQrD,CAAC"}

package/dist/tools/builtin/pool-subgraph/SubgraphPoolSearchTool.js

@@ -0,0 +1,190 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UNISWAP_CHAIN_SLUG = exports.SubgraphPoolSearchTool = void 0;
+exports.buildUniswapPoolUrl = buildUniswapPoolUrl;
+const BaseTool_1 = require("../../BaseTool");
+const UniswapSubgraphService_1 = require("../../../services/UniswapSubgraphService");
+const ALLOWED_SORT = ['tvl', 'volume', 'apr', 'fee', 'liquidity'];
+/**
+ * Tool: subgraph-search-pools
+ *
+ * Search Uniswap V3 pools across one or more EVM chains via The Graph
+ * subgraphs. Handles single-token, two-token, and no-token queries. Used
+ * for intents: search_pool, best_pool, safe_pool, compare_pool, new_pool.
+ *
+ * APR comes from DefiLlama Yields (uniswap-v3 only) for accuracy.
+ */
+class SubgraphPoolSearchTool extends BaseTool_1.BaseTool {
+    name = 'subgraph-search-pools';
+    description = 'Search Uniswap V3 liquidity pools via The Graph subgraphs by token symbol(s) on one or more chains. ' +
+        'Use for: "find ETH/USDC pools on Base", "show OP pools", "stablecoin pools on Arbitrum", "best USDC pool". ' +
+        'Returns pools with pair, TVL, 24h volume, fee tier (%), APR (DefiLlama-enriched), and liquidity rank. ' +
+        'Supports TVL/APR/fee filters and sort by tvl, volume, apr, fee, or liquidity. ' +
+        'Supported chains: Ethereum (0x1), Arbitrum (0xa4b1), Polygon (0x89), BSC (0x38), Base (0x2105), Optimism (0xa), Avalanche (0xa86a).';
+    category = 'blockchain-data';
+    noSuggestions = true;
+    parameters = [
+        {
+            name: 'tokens',
+            type: 'array',
+            items: { type: 'string' },
+            description: 'Token symbols to match. 0 tokens = top pools by chosen sort. 1 token = pools containing it. ' +
+                '2 tokens = pools with that exact pair (both orderings tried). Wrapped variants (WETH↔ETH, WBTC↔BTC) auto-handled.',
+            required: false,
+            default: [],
+        },
+        {
+            name: 'chains',
+            type: 'array',
+            items: { type: 'string' },
+            description: 'Hex chain IDs: "0x1" Ethereum, "0xa" Optimism, "0x38" BSC, "0x89" Polygon, "0x2105" Base, "0xa4b1" Arbitrum, "0xa86a" Avalanche. ' +
+                'Pass [] when the user did not name a chain — the tool defaults to the connected chain.',
+            required: false,
+            default: [],
+        },
+        {
+            name: 'sortBy',
+            type: 'string',
+            description: 'Sort key: "tvl" (default), "volume", "apr", "fee" (low-to-high), or "liquidity".',
+            required: false,
+            default: 'tvl',
+        },
+        {
+            name: 'minTVL',
+            type: 'number',
+            description: 'Minimum TVL in USD.',
+            required: false,
+        },
+        {
+            name: 'maxTVL',
+            type: 'number',
+            description: 'Maximum TVL in USD.',
+            required: false,
+        },
+        {
+            name: 'minAPR',
+            type: 'number',
+            description: 'Minimum APR percentage (e.g. 5 for 5%).',
+            required: false,
+        },
+        {
+            name: 'maxAPR',
+            type: 'number',
+            description: 'Maximum APR percentage.',
+            required: false,
+        },
+        {
+            name: 'feeTier',
+            type: 'number',
+            description: 'Fee tier in basis points: 100, 500, 3000, or 10000.',
+            required: false,
+        },
+        {
+            name: 'limit',
+            type: 'number',
+            description: 'Max pools to return after sort/filter. Default 5, max 20.',
+            required: false,
+            default: 5,
+        },
+    ];
+    service;
+    constructor(config) {
+        super();
+        this.service = new UniswapSubgraphService_1.UniswapSubgraphService(config);
+    }
+    async run(args, userContext) {
+        const tokens = (Array.isArray(args.tokens) ? args.tokens : [])
+            .filter((t) => typeof t === 'string' && t.trim().length > 0)
+            .map((t) => t.trim().toUpperCase());
+        const requested = (Array.isArray(args.chains) ? args.chains : []).filter((c) => typeof c === 'string' && c.trim().length > 0);
+        const unsupported = requested.filter((c) => !this.service.isSupported(c));
+        const supported = requested.filter((c) => this.service.isSupported(c)).map((c) => this.service.resolveChain(c));
+        const chainsToQuery = supported.length > 0
+            ? supported
+            : this.service.isSupported(userContext?.chain)
+                ? [this.service.resolveChain(userContext?.chain)]
+                : ['0x1'];
+        const sortBy = (typeof args.sortBy === 'string' && ALLOWED_SORT.includes(args.sortBy) ? args.sortBy : 'tvl');
+        const filters = {
+            minTVL: typeof args.minTVL === 'number' ? args.minTVL : undefined,
+            maxTVL: typeof args.maxTVL === 'number' ? args.maxTVL : undefined,
+            minAPR: typeof args.minAPR === 'number' ? args.minAPR : undefined,
+            maxAPR: typeof args.maxAPR === 'number' ? args.maxAPR : undefined,
+            feeTier: typeof args.feeTier === 'number' ? args.feeTier : undefined,
+        };
+        const limit = typeof args.limit === 'number' && Number.isFinite(args.limit) && args.limit > 0
+            ? Math.min(Math.floor(args.limit), 20)
+            : 5;
+        // If user only requested unsupported chains, do NOT silently fall back.
+        if (requested.length > 0 && supported.length === 0) {
+            return {
+                _instructions: 'The user requested chains we do not support via The Graph subgraph. Politely list the unsupported chains and the supported chains. Do not show any pool data.',
+                unsupportedChains: unsupported,
+                supportedChains: this.service.listSupportedChains(),
+                pools: [],
+                count: 0,
+            };
+        }
+        const results = await Promise.allSettled(chainsToQuery.map((chain) => this.service.searchPools({ tokens, chain, sortBy, filters })));
+        let pools = results.flatMap((r) => (r.status === 'fulfilled' ? r.value : []));
+        if (sortBy === 'apr') {
+            pools.sort((a, b) => (b.apr ?? 0) - (a.apr ?? 0));
+        }
+        else if (sortBy === 'tvl') {
+            pools.sort((a, b) => b.tvl - a.tvl);
+        }
+        else if (sortBy === 'volume') {
+            pools.sort((a, b) => b.volume24hUsd - a.volume24hUsd);
+        }
+        else if (sortBy === 'fee') {
+            pools.sort((a, b) => a.feeTierBps - b.feeTierBps);
+        }
+        pools = pools.slice(0, limit);
+        return {
+            _instructions: 'Prefix the answer with: "According to the latest data from Subgraph Uniswap V3," (translate naturally into the user language; keep the word "Subgraph" as-is). ' +
+                'Then list the pools with: pair (e.g. USDC/WETH), fee tier (%), TVL (USD), 24h volume (USD), APR (%). ' +
+                'Format USD human-readably ($12.5M, $450K). Mention chain and sort metric briefly. ' +
+                'If a pool has no APR (null), skip the APR field rather than showing zero. ' +
+                'For EACH pool, render the provided uniswapUrl as a clickable markdown link — e.g. wrap the pair as "[USDC/WETH](uniswapUrl)" or append "[View on Uniswap](uniswapUrl)". Never omit this link. Do not invent URLs. ' +
+                'If unsupportedChains is non-empty, mention them once at the end.',
+            tokens,
+            chains: chainsToQuery,
+            unsupportedChains: unsupported,
+            sortBy,
+            filters,
+            count: pools.length,
+            pools: pools.map((p) => this.formatPool(p)),
+        };
+    }
+    formatPool(p) {
+        return {
+            pair: p.pair,
+            poolAddress: p.poolAddress,
+            chain: p.chain,
+            feeTierBps: p.feeTierBps,
+            feeTierPercent: p.feeTierPercent,
+            tvlUsd: p.tvl,
+            volume24hUsd: p.volume24hUsd,
+            fees24hUsd: p.fees24hUsd,
+            apr: p.apr,
+            token0: p.token0,
+            token1: p.token1,
+            uniswapUrl: buildUniswapPoolUrl(p),
+        };
+    }
+}
+exports.SubgraphPoolSearchTool = SubgraphPoolSearchTool;
+function buildUniswapPoolUrl(p) {
+    const slug = exports.UNISWAP_CHAIN_SLUG[p.chain] || p.chain;
+    return `https://app.uniswap.org/explore/pools/${slug}/${p.poolAddress}`;
+}
+exports.UNISWAP_CHAIN_SLUG = {
+    ethereum: 'ethereum',
+    arbitrum: 'arbitrum',
+    polygon: 'polygon',
+    bsc: 'bnb',
+    base: 'base',
+    optimism: 'optimism',
+    avalanche: 'avalanche',
+};
+//# sourceMappingURL=SubgraphPoolSearchTool.js.map

package/dist/tools/builtin/pool-subgraph/SubgraphPoolSearchTool.js.map

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

package/dist/tools/builtin/pool-subgraph/SubgraphPositionDetailTool.d.ts

@@ -0,0 +1,107 @@
+import { BaseTool } from '../../BaseTool';
+import type { ToolParameter, UserContext } from '../../../types';
+import { type SubgraphServiceConfig } from '../../../services/UniswapSubgraphService';
+export type SubgraphPositionDetailToolConfig = SubgraphServiceConfig;
+/**
+ * Tool: subgraph-position-detail
+ *
+ * Returns full position detail (deposits/withdrawals/collected fees + the
+ * underlying pool) for a Uniswap V3 NFT position id (numeric string).
+ * Maps to intent `position_detail` ("tell me about position 962961").
+ */
+export declare class SubgraphPositionDetailTool extends BaseTool {
+    name: string;
+    description: string;
+    category: string;
+    noSuggestions: boolean;
+    parameters: ToolParameter[];
+    private service;
+    constructor(config?: SubgraphPositionDetailToolConfig);
+    protected run(args: Record<string, unknown>, userContext?: UserContext): Promise<{
+        error: string;
+        _instructions?: undefined;
+        unsupportedChains?: undefined;
+        supportedChains?: undefined;
+        positionId?: undefined;
+        chains?: undefined;
+        found?: undefined;
+        position?: undefined;
+        pool?: undefined;
+    } | {
+        _instructions: string;
+        unsupportedChains: string[];
+        supportedChains: string[];
+        error?: undefined;
+        positionId?: undefined;
+        chains?: undefined;
+        found?: undefined;
+        position?: undefined;
+        pool?: undefined;
+    } | {
+        _instructions: string;
+        positionId: string;
+        chains: string[];
+        found: boolean;
+        error?: undefined;
+        unsupportedChains?: undefined;
+        supportedChains?: undefined;
+        position?: undefined;
+        pool?: undefined;
+    } | {
+        _instructions: string;
+        positionId: string;
+        position: {
+            uniswapPositionUrl: string;
+            positionId: string;
+            poolAddress: string;
+            pair: string;
+            token0: {
+                symbol: string;
+                address: string;
+            };
+            token1: {
+                symbol: string;
+                address: string;
+            };
+            feeTierBps: number;
+            feeTierPercent: number;
+            chain: string;
+            liquidity: string;
+            depositedToken0: string;
+            depositedToken1: string;
+            withdrawnToken0: string;
+            withdrawnToken1: string;
+            collectedFeesToken0: string;
+            collectedFeesToken1: string;
+        };
+        pool: {
+            uniswapUrl: string;
+            poolAddress: string;
+            pair: string;
+            token0: {
+                symbol: string;
+                address: string;
+                name?: string;
+            };
+            token1: {
+                symbol: string;
+                address: string;
+                name?: string;
+            };
+            tvl: number;
+            volume24hUsd: number;
+            fees24hUsd: number;
+            apr: number | null;
+            feeTierBps: number;
+            feeTierPercent: number;
+            liquidity: string;
+            chain: string;
+        };
+        error?: undefined;
+        unsupportedChains?: undefined;
+        supportedChains?: undefined;
+        chains?: undefined;
+        found?: undefined;
+    }>;
+}
+//# sourceMappingURL=SubgraphPositionDetailTool.d.ts.map

package/dist/tools/builtin/pool-subgraph/SubgraphPositionDetailTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SubgraphPositionDetailTool.d.ts","sourceRoot":"","sources":["../../../../src/tools/builtin/pool-subgraph/SubgraphPositionDetailTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AACjE,OAAO,EAA0B,KAAK,qBAAqB,EAAE,MAAM,0CAA0C,CAAC;AAG9G,MAAM,MAAM,gCAAgC,GAAG,qBAAqB,CAAC;AAErE;;;;;;GAMG;AACH,qBAAa,0BAA2B,SAAQ,QAAQ;IACtD,IAAI,SAA8B;IAClC,WAAW,SAI+D;IAC1E,QAAQ,SAAqB;IAC7B,aAAa,UAAQ;IACrB,UAAU,EAAE,aAAa,EAAE,CAiBzB;IAEF,OAAO,CAAC,OAAO,CAAyB;gBAE5B,MAAM,CAAC,EAAE,gCAAgC;cAKrC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,CAAC,EAAE,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBA1BvD,CAAC;;;;;oBAGL,CAAC;;;;;;;;;;;;;;;;;CAmFnB"}

package/dist/tools/builtin/pool-subgraph/SubgraphPositionDetailTool.js

@@ -0,0 +1,92 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SubgraphPositionDetailTool = void 0;
+const BaseTool_1 = require("../../BaseTool");
+const UniswapSubgraphService_1 = require("../../../services/UniswapSubgraphService");
+const SubgraphPoolSearchTool_1 = require("./SubgraphPoolSearchTool");
+/**
+ * Tool: subgraph-position-detail
+ *
+ * Returns full position detail (deposits/withdrawals/collected fees + the
+ * underlying pool) for a Uniswap V3 NFT position id (numeric string).
+ * Maps to intent `position_detail` ("tell me about position 962961").
+ */
+class SubgraphPositionDetailTool extends BaseTool_1.BaseTool {
+    name = 'subgraph-position-detail';
+    description = 'Look up a Uniswap V3 liquidity position by its numeric NFT id (e.g. 962961) on one or more chains via The Graph subgraphs. ' +
+        'Returns the position (deposited/withdrawn token amounts, collected fees, liquidity) AND its underlying pool (pair, fee tier, TVL, 24h volume, APR). ' +
+        'Use when the user names a numeric id with phrases like: "position 12345", "pool id 962961", "tell me about position 962961". ' +
+        "Does NOT support the user's wallet-wide LP list — only a specific id.";
+    category = 'blockchain-data';
+    noSuggestions = true;
+    parameters = [
+        {
+            name: 'positionId',
+            type: 'string',
+            description: 'Numeric Uniswap V3 NFT position id as a string (e.g. "962961").',
+            required: true,
+        },
+        {
+            name: 'chains',
+            type: 'array',
+            items: { type: 'string' },
+            description: 'Hex chain IDs: "0x1" Ethereum, "0xa" Optimism, "0x38" BSC, "0x89" Polygon, "0x2105" Base, "0xa4b1" Arbitrum, "0xa86a" Avalanche. ' +
+                'Pass [] when the user did not name a chain — the tool defaults to the connected chain.',
+            required: false,
+            default: [],
+        },
+    ];
+    service;
+    constructor(config) {
+        super();
+        this.service = new UniswapSubgraphService_1.UniswapSubgraphService(config);
+    }
+    async run(args, userContext) {
+        const positionId = typeof args.positionId === 'string' ? args.positionId.trim() : '';
+        if (!/^\d+$/.test(positionId)) {
+            return { error: 'positionId must be a numeric string (Uniswap V3 NFT id).' };
+        }
+        const requested = (Array.isArray(args.chains) ? args.chains : []).filter((c) => typeof c === 'string' && c.trim().length > 0);
+        const unsupported = requested.filter((c) => !this.service.isSupported(c));
+        const supported = requested.filter((c) => this.service.isSupported(c)).map((c) => this.service.resolveChain(c));
+        if (requested.length > 0 && supported.length === 0) {
+            return {
+                _instructions: 'User asked about a position on chains we do not support. List unsupported + supported chains.',
+                unsupportedChains: unsupported,
+                supportedChains: this.service.listSupportedChains(),
+            };
+        }
+        const chains = supported.length > 0
+            ? supported
+            : this.service.isSupported(userContext?.chain)
+                ? [this.service.resolveChain(userContext?.chain)]
+                : ['0x1'];
+        const results = await Promise.allSettled(chains.map((chain) => this.service.getPositionDetail({ positionId, chain })));
+        const hit = results.map((r) => (r.status === 'fulfilled' ? r.value : null)).find((v) => v != null);
+        if (!hit) {
+            return {
+                _instructions: 'No position with this id was found on the chosen chains. Suggest the user double-check the id or specify another chain.',
+                positionId,
+                chains,
+                found: false,
+            };
+        }
+        const slug = SubgraphPoolSearchTool_1.UNISWAP_CHAIN_SLUG[hit.position.chain] || hit.position.chain;
+        return {
+            _instructions: 'Prefix with: "According to the latest data from Subgraph Uniswap V3," (translate naturally; keep "Subgraph" as-is). ' +
+                'Show the pair, chain, fee tier (%), deposited/withdrawn/collected fees for each token, plus pool stats (TVL, 24h volume, APR). ' +
+                'End the response with TWO clickable markdown links from the data: position.uniswapPositionUrl as "[View position on Uniswap](uniswapPositionUrl)" and pool.uniswapUrl as "[View pool on Uniswap](uniswapUrl)". Never omit them. Do not invent URLs.',
+            positionId,
+            position: {
+                ...hit.position,
+                uniswapPositionUrl: `https://app.uniswap.org/positions/v3/${slug}/${hit.position.positionId}`,
+            },
+            pool: {
+                ...hit.pool,
+                uniswapUrl: (0, SubgraphPoolSearchTool_1.buildUniswapPoolUrl)(hit.pool),
+            },
+        };
+    }
+}
+exports.SubgraphPositionDetailTool = SubgraphPositionDetailTool;
+//# sourceMappingURL=SubgraphPositionDetailTool.js.map

package/dist/tools/builtin/pool-subgraph/SubgraphPositionDetailTool.js.map

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

package/dist/tools/builtin/pool-subgraph/SubgraphTrendingPoolsTool.d.ts

@@ -0,0 +1,56 @@
+import { BaseTool } from '../../BaseTool';
+import type { ToolParameter, UserContext } from '../../../types';
+import { type SubgraphServiceConfig } from '../../../services/UniswapSubgraphService';
+export type SubgraphTrendingPoolsToolConfig = SubgraphServiceConfig;
+/**
+ * Tool: subgraph-trending-pools
+ *
+ * Returns Uniswap V3 pools sorted by 24h volume on the chosen chain(s).
+ * Maps to intent: trending_pool ("hot pools", "most active", "trending").
+ */
+export declare class SubgraphTrendingPoolsTool extends BaseTool {
+    name: string;
+    description: string;
+    category: string;
+    noSuggestions: boolean;
+    parameters: ToolParameter[];
+    private service;
+    constructor(config?: SubgraphTrendingPoolsToolConfig);
+    protected run(args: Record<string, unknown>, userContext?: UserContext): Promise<{
+        _instructions: string;
+        unsupportedChains: string[];
+        supportedChains: string[];
+        pools: never[];
+        count: number;
+        chains?: undefined;
+    } | {
+        _instructions: string;
+        chains: string[];
+        unsupportedChains: string[];
+        count: number;
+        pools: {
+            pair: string;
+            poolAddress: string;
+            chain: string;
+            feeTierBps: number;
+            feeTierPercent: number;
+            tvlUsd: number;
+            volume24hUsd: number;
+            fees24hUsd: number;
+            apr: number | null;
+            token0: {
+                symbol: string;
+                address: string;
+                name?: string;
+            };
+            token1: {
+                symbol: string;
+                address: string;
+                name?: string;
+            };
+            uniswapUrl: string;
+        }[];
+        supportedChains?: undefined;
+    }>;
+}
+//# sourceMappingURL=SubgraphTrendingPoolsTool.d.ts.map