keyring-agent-core 0.2.1 → 0.2.3

package/dist/tools/builtin/pool/PoolDetailTool.js

@@ -1,273 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.PoolDetailTool = void 0;
-const BaseTool_1 = require("../../BaseTool");
-const chainResolver_1 = require("../../chainResolver");
-const UniswapService_1 = require("../../../services/UniswapService");
-const DAYS_PER_YEAR = 365;
-const EVM_ADDRESS_RE = /^0x[a-fA-F0-9]{40}$/;
-/**
- * Tool: get-pool-detail
- *
- * Always-search-then-detail flow for a single Uniswap V3 pool:
- *   1) call SearchTokens upstream to enumerate pools matching the user's input,
- *   2) filter the search result by token symbols and (optionally) fee tier,
- *   3) if the filter narrows to exactly one pool, fetch its full detail via
- *      the V3Pool GraphQL operation,
- *   4) otherwise return the candidates so the LLM can ask the user to pick one.
- *
- * The LLM never passes pool addresses — every address that reaches the detail
- * call is one we observed upstream this turn, which makes pool-address
- * hallucinations structurally impossible.
- */
-class PoolDetailTool extends BaseTool_1.BaseTool {
-    name = 'get-pool-detail';
-    description = 'Get detailed stats for a single Uniswap V3 pool, identified by token pair (and optional fee tier). ' +
-        'Always runs a search first, filters by the provided symbols + fee tier, and only fetches detail when ' +
-        'the filter resolves to exactly one pool. Otherwise returns a `candidates` list — show that to the user, ' +
-        'ask which pool they want, then re-call this tool with the missing info. ' +
-        'Detail response includes: pool address, fee tier (bps and %), both tokens (symbol, name, address, decimals, USD price), ' +
-        'token0/token1 reserves, total TVL with 24h % change, 24h volume, weekly historical volume series, ' +
-        'total tx count, and a derived APR estimate (fees ÷ TVL × 365). ' +
-        'NEVER pass a pool address — the tool resolves the address itself by searching. ' +
-        'Token contract addresses are NOT pool addresses. ' +
-        'Source: https://app.uniswap.org. ' +
-        'Supports: Ethereum, Optimism, BSC, Polygon, Base, Arbitrum, Avalanche, Linea';
-    category = 'blockchain-data';
-    parameters = [
-        {
-            name: 'token0Symbol',
-            type: 'string',
-            description: 'Symbol of one of the pool\'s tokens (e.g. "USDC"). ' +
-                'Pair order does not matter — USDC/WETH and WETH/USDC resolve to the same pool. ' +
-                'When both token0Symbol and token1Symbol are provided the search is filtered to that exact pair.',
-            required: true,
-        },
-        {
-            name: 'token1Symbol',
-            type: 'string',
-            description: 'Symbol of the other pool token (e.g. "WETH"). ' +
-                'Optional — when omitted the tool returns all pools containing token0Symbol so the user can pick.',
-            required: false,
-        },
-        {
-            name: 'feeTier',
-            type: 'number',
-            description: 'Fee tier in basis points (bps): 100 = 0.01%, 500 = 0.05%, 3000 = 0.30%, 10000 = 1.00%. ' +
-                'Optional — when omitted the tool returns all fee tiers for the pair so the user can pick.',
-            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 UniswapService_1.UniswapService(config);
-    }
-    async run(args, userContext) {
-        const chain = (0, chainResolver_1.resolveChain)(args.chain, userContext);
-        const token0Symbol = typeof args.token0Symbol === 'string' ? args.token0Symbol.trim() : '';
-        const token1Symbol = typeof args.token1Symbol === 'string' ? args.token1Symbol.trim() : '';
-        const feeTier = typeof args.feeTier === 'number' && Number.isFinite(args.feeTier) ? Math.floor(args.feeTier) : undefined;
-        if (!token0Symbol) {
-            return {
-                error: 'token0Symbol is required. Provide at least one token symbol; add token1Symbol and feeTier to narrow the result.',
-            };
-        }
-        // Step 1: always search upstream first.
-        const searchQuery = token1Symbol ? `${token0Symbol} ${token1Symbol}` : token0Symbol;
-        const search = await this.service.searchPools({
-            query: searchQuery,
-            chain,
-            page: 1,
-            size: 100,
-            protocolVersion: 'V3',
-        });
-        if (!search.success) {
-            return { error: search.error || 'Pool search failed' };
-        }
-        // Step 2: filter by user-provided order first (sym0 → token0, sym1 → token1).
-        // Only fall back to the reversed match if the ordered match returns nothing —
-        // this respects how the user phrased the pair (e.g. "USDC/ETH 0.3%" should
-        // prefer pools where token0=USDC, not return the WETH/USDC pool unless the
-        // forward direction has no result).
-        const all = search.data ?? [];
-        const ordered = all.filter((p) => this.matchesFilter(p, token0Symbol, token1Symbol, feeTier, 'ordered'));
-        let filtered = ordered;
-        let usedReversedFallback = false;
-        if (filtered.length === 0 && token1Symbol) {
-            const reversed = all.filter((p) => this.matchesFilter(p, token0Symbol, token1Symbol, feeTier, 'reversed'));
-            if (reversed.length > 0) {
-                filtered = reversed;
-                usedReversedFallback = true;
-            }
-        }
-        if (filtered.length === 0) {
-            return {
-                error: `No V3 pool matched ${this.describeQuery(token0Symbol, token1Symbol, feeTier)} on chain ${chain}. ` +
-                    'Verify the symbols and fee tier with the user.',
-            };
-        }
-        // Step 3: exactly one match → fetch detail.
-        if (filtered.length === 1) {
-            const only = filtered[0];
-            if (!only.id || !EVM_ADDRESS_RE.test(only.id)) {
-                return { error: 'Resolved pool has no valid address' };
-            }
-            const result = await this.service.getV3PoolDetail({ address: only.id, chain });
-            if (!result.success || !result.data) {
-                return { error: result.error || 'Failed to fetch pool detail' };
-            }
-            return {
-                _instructions: 'Present pool details in a compact summary. Lead with the pair (token0/token1 symbols), fee tier (%), ' +
-                    'and chain. Then show: TVL (USD) with 24h % change, 24h volume (USD), 24h fees (USD), estimated APR (%), ' +
-                    'token0 reserve + USD price, token1 reserve + USD price, and total tx count. ' +
-                    'Optionally include the weekly historical volume as a sparkline-style bullet list. ' +
-                    'Format numbers human-readably (e.g. $12.5M, +1.23%, 0.05%). Omit null fields. Do NOT mention tool/API names.',
-                pairOrderMatched: usedReversedFallback ? 'reversed' : 'ordered',
-                pool: this.formatPool(result.data),
-            };
-        }
-        // Step 4: multiple matches → return candidates for the user to disambiguate.
-        return {
-            _instructions: 'The filter matched multiple pools. Render them as a numbered list (pair, fee tier %, 24h volume, address) ' +
-                'and ask the user which one they want to see. When they answer, re-call this tool with their selection — ' +
-                'pass token0Symbol + token1Symbol + feeTier (use the exact feeTier in bps from the chosen candidate). ' +
-                'Format numbers human-readably (e.g. $12.5M, 0.05%). Do NOT mention tool/API names.',
-            chain,
-            pairOrderMatched: usedReversedFallback ? 'reversed' : 'ordered',
-            reason: this.candidateReason(token0Symbol, token1Symbol, feeTier),
-            missing: this.missingFields(token1Symbol, feeTier),
-            candidates: this.rankCandidates(filtered)
-                .slice(0, 10)
-                .map((c) => this.formatCandidate(c)),
-        };
-    }
-    /**
-     * Filter predicate. `mode` controls pair-order matching when both symbols
-     * are given:
-     *   - "ordered"  → pool.token0 must match sym0 AND pool.token1 must match sym1
-     *   - "reversed" → pool.token0 must match sym1 AND pool.token1 must match sym0
-     * When sym1 is empty, mode is ignored (single-token contains check).
-     */
-    matchesFilter(p, sym0, sym1, fee, mode) {
-        if (fee != null && p.feeTier !== fee)
-            return false;
-        const a = (p.token0?.symbol ?? '').toLowerCase();
-        const b = (p.token1?.symbol ?? '').toLowerCase();
-        const x = sym0.toLowerCase();
-        if (sym1) {
-            const y = sym1.toLowerCase();
-            if (mode === 'reversed') {
-                return this.symbolIncludes(a, y) && this.symbolIncludes(b, x);
-            }
-            return this.symbolIncludes(a, x) && this.symbolIncludes(b, y);
-        }
-        return this.symbolIncludes(a, x) || this.symbolIncludes(b, x);
-    }
-    /** Bidirectional substring match — handles "ETH" vs "WETH", "USDC" vs "USDC.e", etc. */
-    symbolIncludes(poolSym, userSym) {
-        if (!poolSym || !userSym)
-            return false;
-        return poolSym.includes(userSym) || userSym.includes(poolSym);
-    }
-    describeQuery(sym0, sym1, fee) {
-        const pair = sym1 ? `${sym0}/${sym1}` : sym0;
-        return fee != null ? `${pair} at fee tier ${fee} bps` : pair;
-    }
-    candidateReason(sym0, sym1, fee) {
-        if (!sym1)
-            return `Multiple pools contain ${sym0}. Ask the user for the other token (and fee tier).`;
-        if (fee == null)
-            return `Multiple fee tiers exist for ${sym0}/${sym1}. Ask the user which fee tier they want.`;
-        return `Multiple ${sym0}/${sym1} pools share fee tier ${fee} bps. Ask the user which one they meant.`;
-    }
-    missingFields(sym1, fee) {
-        const missing = [];
-        if (!sym1)
-            missing.push('token1Symbol');
-        if (fee == null)
-            missing.push('feeTier');
-        return missing;
-    }
-    /** Sort candidates by 24h volume desc — the most-traded pool surfaces first. */
-    rankCandidates(pools) {
-        return [...pools].sort((a, b) => (b.volumeUsd24hr ?? 0) - (a.volumeUsd24hr ?? 0));
-    }
-    /** Compact view of a search candidate for the LLM to render as a picker. */
-    formatCandidate(p) {
-        return {
-            address: p.id,
-            protocolVersion: p.protocolVersion,
-            feeTierBps: p.feeTier,
-            feeTierPercent: typeof p.feeTier === 'number' ? p.feeTier / 10_000 : undefined,
-            volume24hUsd: p.volumeUsd24hr,
-            pair: p.token0?.symbol && p.token1?.symbol ? `${p.token0.symbol}/${p.token1.symbol}` : undefined,
-            token0: p.token0 ? { symbol: p.token0.symbol, name: p.token0.name, address: p.token0.address } : undefined,
-            token1: p.token1 ? { symbol: p.token1.symbol, name: p.token1.name, address: p.token1.address } : undefined,
-        };
-    }
-    /** Trim and enrich the GraphQL payload with derived metrics. */
-    formatPool(p) {
-        const tvlUsd = p.totalLiquidity?.value;
-        const volume24hUsd = p.volume24h?.value;
-        const feeTierBps = p.feeTier;
-        const feeTierPercent = typeof feeTierBps === 'number' ? feeTierBps / 10_000 : undefined;
-        const fees24hUsd = typeof volume24hUsd === 'number' && typeof feeTierPercent === 'number'
-            ? (volume24hUsd * feeTierPercent) / 100
-            : undefined;
-        const aprPercent = typeof fees24hUsd === 'number' && typeof tvlUsd === 'number' && tvlUsd > 0
-            ? (fees24hUsd / tvlUsd) * DAYS_PER_YEAR * 100
-            : undefined;
-        return {
-            address: p.address,
-            protocolVersion: p.protocolVersion,
-            feeTierBps,
-            feeTierPercent,
-            tvlUsd,
-            tvlChange24hPercent: p.totalLiquidityPercentChange24h?.value,
-            volume24hUsd,
-            fees24hUsd,
-            aprPercent,
-            txCount: p.txCount,
-            historicalVolumeWeek: this.formatHistorical(p.historicalVolume),
-            token0: p.token0
-                ? {
-                    address: p.token0.address,
-                    symbol: p.token0.symbol,
-                    name: p.token0.name,
-                    decimals: p.token0.decimals,
-                    priceUsd: p.token0.market?.price?.value ?? p.token0.price?.value,
-                    reserve: p.token0Supply,
-                    isSpam: p.token0.project?.isSpam,
-                    safetyLevel: p.token0.project?.safetyLevel,
-                }
-                : undefined,
-            token1: p.token1
-                ? {
-                    address: p.token1.address,
-                    symbol: p.token1.symbol,
-                    name: p.token1.name,
-                    decimals: p.token1.decimals,
-                    priceUsd: p.token1.market?.price?.value ?? p.token1.price?.value,
-                    reserve: p.token1Supply,
-                    isSpam: p.token1.project?.isSpam,
-                    safetyLevel: p.token1.project?.safetyLevel,
-                }
-                : undefined,
-        };
-    }
-    formatHistorical(points) {
-        if (!points || points.length === 0)
-            return undefined;
-        return points.map((p) => ({ timestamp: p.timestamp, volumeUsd: p.value }));
-    }
-}
-exports.PoolDetailTool = PoolDetailTool;
-//# sourceMappingURL=PoolDetailTool.js.map

package/dist/tools/builtin/pool/PoolDetailTool.js.map

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

package/dist/tools/builtin/pool/PoolSearchTool.d.ts

@@ -1,50 +0,0 @@
-import { BaseTool } from '../../BaseTool';
-import type { ToolParameter, UserContext } from '../../../types';
-import { type UniswapServiceConfig, type UniswapProtocolVersion } from '../../../services/UniswapService';
-export type PoolSearchToolConfig = UniswapServiceConfig;
-type ProtocolVersionFilter = UniswapProtocolVersion | 'ALL';
-/**
- * Tool: search-pools
- *
- * Wraps the Uniswap `Search.v1.SearchService/SearchTokens` endpoint with
- * `searchType: "POOL"`. Lets users discover pools by free-text query
- * (token symbol like "WBTC" or "USDC", token name, or pool address) on a
- * specific chain. Paginated.
- */
-export declare class PoolSearchTool extends BaseTool {
-    name: string;
-    description: string;
-    category: string;
-    parameters: ToolParameter[];
-    private service;
-    constructor(config?: PoolSearchToolConfig);
-    protected run(args: Record<string, unknown>, userContext?: UserContext): Promise<{
-        error: string;
-        _instructions?: undefined;
-        query?: undefined;
-        chain?: undefined;
-        protocolVersion?: undefined;
-        feeTierBps?: undefined;
-        feeTierPercent?: undefined;
-        page?: undefined;
-        size?: undefined;
-        count?: undefined;
-        pools?: undefined;
-    } | {
-        _instructions: string;
-        query: string;
-        chain: string;
-        protocolVersion: ProtocolVersionFilter;
-        feeTierBps: number | undefined;
-        feeTierPercent: number | undefined;
-        page: number;
-        size: number;
-        count: number;
-        pools: Record<string, unknown>[];
-        error?: undefined;
-    }>;
-    private parseProtocolFilter;
-    private formatPool;
-}
-export {};
-//# sourceMappingURL=PoolSearchTool.d.ts.map

package/dist/tools/builtin/pool/PoolSearchTool.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"PoolSearchTool.d.ts","sourceRoot":"","sources":["../../../../src/tools/builtin/pool/PoolSearchTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AACjE,OAAO,EAEL,KAAK,oBAAoB,EAEzB,KAAK,sBAAsB,EAC5B,MAAM,kCAAkC,CAAC;AAE1C,MAAM,MAAM,oBAAoB,GAAG,oBAAoB,CAAC;AAGxD,KAAK,qBAAqB,GAAG,sBAAsB,GAAG,KAAK,CAAC;AAE5D;;;;;;;GAOG;AACH,qBAAa,cAAe,SAAQ,QAAQ;IAC1C,IAAI,SAAkB;IACtB,WAAW,SAWuE;IAClF,QAAQ,SAAqB;IAC7B,UAAU,EAAE,aAAa,EAAE,CAkDzB;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;;;;;;;;;;;;;;;;;;;;;;;;;IAiD5E,OAAO,CAAC,mBAAmB;IAU3B,OAAO,CAAC,UAAU;CAwBnB"}

package/dist/tools/builtin/pool/PoolSearchTool.js

@@ -1,160 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.PoolSearchTool = void 0;
-const BaseTool_1 = require("../../BaseTool");
-const chainResolver_1 = require("../../chainResolver");
-const UniswapService_1 = require("../../../services/UniswapService");
-const SUPPORTED_VERSION_FILTERS = ['V2', 'V3', 'V4', 'ALL'];
-/**
- * Tool: search-pools
- *
- * Wraps the Uniswap `Search.v1.SearchService/SearchTokens` endpoint with
- * `searchType: "POOL"`. Lets users discover pools by free-text query
- * (token symbol like "WBTC" or "USDC", token name, or pool address) on a
- * specific chain. Paginated.
- */
-class PoolSearchTool extends BaseTool_1.BaseTool {
-    name = 'search-pools';
-    description = 'Search Uniswap liquidity pools on a given chain by free-text query — a SINGLE token symbol or token name. ' +
-        'Returns matching pools with: pool address, fee tier (bps + %), protocol version, both tokens ' +
-        '(symbol, name, address, decimals, logo), and short-window USD volume buckets (6h / 12h / 24h). ' +
-        'Use this tool when the user names ONE token and wants pools related to it: ' +
-        '"find WBTC pools on Optimism", "pools containing PEPE on Ethereum", "show USDC pools". ' +
-        'Do NOT use for: ' +
-        '(a) two-symbol pair lookups like "USDC/WETH 0.05%" — use get-pool-detail; ' +
-        '(b) raw 0x addresses (token or pool) — use lookup-pool-by-address; ' +
-        '(c) chain-wide rankings with no token mentioned — use get-top-pools. ' +
-        'Source: https://app.uniswap.org search. ' +
-        'Supports: Ethereum, Optimism, BSC, Polygon, Base, Arbitrum, Avalanche, Linea.';
-    category = 'blockchain-data';
-    parameters = [
-        {
-            name: 'query',
-            type: 'string',
-            description: 'Single token symbol or name to search pools by (e.g. "WBTC", "USDC", "pepe"). ' +
-                'Do NOT pass a 0x address (use lookup-pool-by-address) or a two-symbol pair (use get-pool-detail).',
-            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: 'protocolVersion',
-            type: 'string',
-            description: 'Filter results by Uniswap protocol version: "V2", "V3", "V4", or "ALL" to include every version. ' +
-                'Default is "V3" — only switch when the user explicitly asks for V2, V4, or all versions.',
-            required: false,
-            default: 'V3',
-        },
-        {
-            name: 'page',
-            type: 'number',
-            description: '1-based page index. Defaults to 1.',
-            required: false,
-            default: 1,
-        },
-        {
-            name: 'size',
-            type: 'number',
-            description: 'Page size (max 50). Defaults to 15.',
-            required: false,
-            default: 15,
-        },
-        {
-            name: 'feeTier',
-            type: 'number',
-            description: 'Optional fee tier filter in basis points (bps): 100 = 0.01%, 500 = 0.05%, 3000 = 0.30%, 10000 = 1.00%. ' +
-                'When provided, only pools with this exact fee tier are returned. ' +
-                'Pass it whenever the user mentions a fee tier in the current message OR earlier in the conversation ' +
-                '(e.g. "USDC/WETH 0.05% pool on Base" → feeTier=500). Omit otherwise.',
-            required: false,
-        },
-    ];
-    service;
-    constructor(config) {
-        super();
-        this.service = new UniswapService_1.UniswapService(config);
-    }
-    async run(args, userContext) {
-        const query = typeof args.query === 'string' ? args.query.trim() : '';
-        if (!query) {
-            return { error: 'Search query is required' };
-        }
-        const chain = (0, chainResolver_1.resolveChain)(args.chain, userContext);
-        const page = typeof args.page === 'number' && Number.isFinite(args.page) && args.page > 0 ? Math.floor(args.page) : 1;
-        const size = typeof args.size === 'number' && Number.isFinite(args.size) && args.size > 0
-            ? Math.min(Math.floor(args.size), 50)
-            : 15;
-        const protocolVersion = this.parseProtocolFilter(args.protocolVersion);
-        const feeTier = typeof args.feeTier === 'number' && Number.isFinite(args.feeTier) && args.feeTier > 0
-            ? Math.floor(args.feeTier)
-            : undefined;
-        // searchPools internally calls ExploreStats in parallel, applies
-        // protocol version + fee tier filters, and enriches with apr/tvl/txCount.
-        const result = await this.service.searchPools({ query, chain, page, size, protocolVersion, feeTier });
-        if (!result.success) {
-            return { error: result.error || 'Failed to search pools' };
-        }
-        const pools = (result.data ?? []).map((p) => this.formatPool(p));
-        return {
-            _instructions: 'Present the matching pools as a list. For each pool show: pair (token0/token1 symbols), fee tier (%), ' +
-                'protocol version, and only the fields that have actual data — apr (%), TVL (USD), 24h volume (USD), tx count. ' +
-                'Skip any field that is null/undefined — do not show zeros or dashes. ' +
-                'Format numbers human-readably (e.g. $12.5M, 0.30%, 4.2%). ' +
-                'Mention the search query and chain in the intro. Do NOT mention tool or API names.',
-            query,
-            chain,
-            protocolVersion,
-            feeTierBps: feeTier,
-            feeTierPercent: feeTier != null ? feeTier / 10_000 : undefined,
-            page,
-            size,
-            count: pools.length,
-            pools,
-        };
-    }
-    parseProtocolFilter(value) {
-        if (typeof value === 'string') {
-            const upper = value.trim().toUpperCase();
-            if (SUPPORTED_VERSION_FILTERS.includes(upper)) {
-                return upper;
-            }
-        }
-        return 'V3';
-    }
-    formatPool(p) {
-        const out = {
-            address: p.id,
-            chainId: p.chainId,
-            protocolVersion: p.protocolVersion,
-            feeTierBps: p.feeTier,
-            feeTierPercent: typeof p.feeTier === 'number' ? p.feeTier / 10_000 : undefined,
-        };
-        if (p.apr != null)
-            out.apr = p.apr;
-        if (p.tvlUsd != null)
-            out.tvlUsd = p.tvlUsd;
-        const vol24h = p.volume1DayUsd ?? p.volumeUsd24hr;
-        if (vol24h != null)
-            out.volume24hUsd = vol24h;
-        if (p.volumeUsd6hr != null)
-            out.volume6hUsd = p.volumeUsd6hr;
-        if (p.volumeUsd12hr != null)
-            out.volume12hUsd = p.volumeUsd12hr;
-        if (p.txCount != null)
-            out.txCount = p.txCount;
-        const t0 = p.token0;
-        const t1 = p.token1;
-        if (t0)
-            out.token0 = { address: t0.address, symbol: t0.symbol, name: t0.name, decimals: t0.decimals };
-        if (t1)
-            out.token1 = { address: t1.address, symbol: t1.symbol, name: t1.name, decimals: t1.decimals };
-        return out;
-    }
-}
-exports.PoolSearchTool = PoolSearchTool;
-//# sourceMappingURL=PoolSearchTool.js.map

package/dist/tools/builtin/pool/PoolSearchTool.js.map

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

package/dist/tools/builtin/pool/PreviewAddLiquidityTool.d.ts

@@ -1,124 +0,0 @@
-import { BaseTool } from '../../BaseTool';
-import type { ConfirmAddLiquidityTxProps, ToolKind, ToolParameter, ToolResult, UIPayload, UserContext } from '../../../types';
-import { type PoolServiceConfig } from '../../../services/PoolService';
-export interface PreviewAddLiquidityToolConfig {
-    pool?: PoolServiceConfig;
-    /** Default slippage in bps (100 = 1%). Default 100. */
-    defaultSlippageBps?: number;
-    /** Floor for amount0Min/amount1Min as % of swap min-out. Default 80. */
-    mintMinPercent?: number;
-}
-/**
- * Tool: preview-add-liquidity
- *
- * Called when the user has filled the AddLiquidityForm with:
- *   - native amount (in wei)
- *   - minPrice + maxPrice (token1 per token0, decimal-adjusted — the same unit
- *     as `pool.currentPrice` returned by open-add-liquidity-form)
- *
- * The tool converts those prices into ticks (rounded to tickSpacing), fetches
- * deBridge swap quotes for both legs, encodes the gateway.mint calldata, and
- * returns:
- *   - a UI payload (`ConfirmAddLiquidityTx`) the FE renders as a confirmation
- *     panel showing expected token0/token1 amounts and the unsigned tx,
- *   - the unsigned tx itself in `props.unsignedTx`, which the FE will pass to
- *     a wallet-side execute function (e.g. wagmi.sendTransactionAsync).
- *
- * The user reviews the panel and either confirms (FE signs + broadcasts) or
- * cancels. Native-only input — no approvals needed.
- */
-export declare class PreviewAddLiquidityTool extends BaseTool {
-    name: string;
-    kind: ToolKind;
-    category: string;
-    noSuggestions: boolean;
-    description: string;
-    parameters: ToolParameter[];
-    private pool;
-    private defaultSlippageBps;
-    private mintMinPercent;
-    private pantograph;
-    constructor(config?: PreviewAddLiquidityToolConfig);
-    /** Forward `ui` from run() into the ToolResult envelope. */
-    execute(args: Record<string, unknown>, userContext?: UserContext): Promise<ToolResult>;
-    protected run(args: Record<string, unknown>, userContext?: UserContext): Promise<{
-        error: string;
-        _instructions: string;
-        chain?: undefined;
-        rawTickLower?: undefined;
-        rawTickUpper?: undefined;
-        tickLower?: undefined;
-        tickUpper?: undefined;
-        balanceWei?: undefined;
-        requiredWei?: undefined;
-        gasReserveWei?: undefined;
-        ui?: undefined;
-        summary?: undefined;
-    } | {
-        error: string;
-        chain: string;
-        _instructions?: undefined;
-        rawTickLower?: undefined;
-        rawTickUpper?: undefined;
-        tickLower?: undefined;
-        tickUpper?: undefined;
-        balanceWei?: undefined;
-        requiredWei?: undefined;
-        gasReserveWei?: undefined;
-        ui?: undefined;
-        summary?: undefined;
-    } | {
-        error: string;
-        _instructions?: undefined;
-        chain?: undefined;
-        rawTickLower?: undefined;
-        rawTickUpper?: undefined;
-        tickLower?: undefined;
-        tickUpper?: undefined;
-        balanceWei?: undefined;
-        requiredWei?: undefined;
-        gasReserveWei?: undefined;
-        ui?: undefined;
-        summary?: undefined;
-    } | {
-        error: string;
-        _instructions: string;
-        rawTickLower: number;
-        rawTickUpper: number;
-        tickLower: number;
-        tickUpper: number;
-        chain?: undefined;
-        balanceWei?: undefined;
-        requiredWei?: undefined;
-        gasReserveWei?: undefined;
-        ui?: undefined;
-        summary?: undefined;
-    } | {
-        error: string;
-        _instructions: string;
-        balanceWei: string;
-        requiredWei: string;
-        gasReserveWei: string;
-        chain?: undefined;
-        rawTickLower?: undefined;
-        rawTickUpper?: undefined;
-        tickLower?: undefined;
-        tickUpper?: undefined;
-        ui?: undefined;
-        summary?: undefined;
-    } | {
-        ui: UIPayload<ConfirmAddLiquidityTxProps>;
-        summary: string;
-        _instructions: string;
-        error?: undefined;
-        chain?: undefined;
-        rawTickLower?: undefined;
-        rawTickUpper?: undefined;
-        tickLower?: undefined;
-        tickUpper?: undefined;
-        balanceWei?: undefined;
-        requiredWei?: undefined;
-        gasReserveWei?: undefined;
-    }>;
-}
-//# sourceMappingURL=PreviewAddLiquidityTool.d.ts.map

package/dist/tools/builtin/pool/PreviewAddLiquidityTool.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"PreviewAddLiquidityTool.d.ts","sourceRoot":"","sources":["../../../../src/tools/builtin/pool/PreviewAddLiquidityTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,OAAO,KAAK,EAEV,0BAA0B,EAE1B,QAAQ,EACR,aAAa,EACb,UAAU,EACV,SAAS,EAET,WAAW,EACZ,MAAM,gBAAgB,CAAC;AACxB,OAAO,EASL,KAAK,iBAAiB,EACvB,MAAM,+BAA+B,CAAC;AAMvC,MAAM,WAAW,6BAA6B;IAC5C,IAAI,CAAC,EAAE,iBAAiB,CAAC;IACzB,uDAAuD;IACvD,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,wEAAwE;IACxE,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,uBAAwB,SAAQ,QAAQ;IACnD,IAAI,SAA2B;IAC/B,IAAI,EAAE,QAAQ,CAAY;IAC1B,QAAQ,SAAiB;IACzB,aAAa,UAAQ;IACrB,WAAW,SAI6F;IAExG,UAAU,EAAE,aAAa,EAAE,CA8CzB;IAEF,OAAO,CAAC,IAAI,CAAc;IAC1B,OAAO,CAAC,kBAAkB,CAAkB;IAC5C,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,UAAU,CAAoB;gBAE1B,MAAM,CAAC,EAAE,6BAA6B;IAQlD,4DAA4D;IACtD,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;cA2B5E,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,CAAC,EAAE,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkS7E"}