@t2000/engine 0.4.6 → 0.5.1

package/README.md

@@ -75,32 +75,51 @@ QueryEngine.submitMessage()
 | `navi-config.ts` | `NAVI_MCP_CONFIG`, `NaviTools` | NAVI MCP server configuration |
 | `navi-transforms.ts` | `transformRates`, `transformBalance`, ... | Raw MCP response → engine types |
 | `navi-reads.ts` | `fetchRates`, `fetchBalance`, ... | Composite MCP read functions |
+| `defillama-prices.ts` | `fetchTokenPrices`, `clearPriceCache` | Batch USD prices from DefiLlama (single price source) |
+| `tools/defillama.ts` | 7 DefiLlama tools | Yield pools, protocol info, token prices, price changes, chain TVL, fees, Sui protocols |
+| `tools/swap-quote.ts` | `swapQuoteTool` | Preview swap route + price impact (read-only) |
+| `tools/swap.ts` | `swapExecuteTool` | Cetus Aggregator multi-DEX swap |
+| `tools/volo-stats.ts` | `voloStatsTool` | VOLO liquid staking stats (vSUI/SUI rate, APY, TVL) |
+| `tools/volo-stake.ts` | `voloStakeTool` | Stake SUI → vSUI |
+| `tools/volo-unstake.ts` | `voloUnstakeTool` | Unstake vSUI → SUI |
 | `prompt.ts` | `DEFAULT_SYSTEM_PROMPT` | Audric system prompt |
 | `providers/anthropic.ts` | `AnthropicProvider` | Anthropic Claude LLM provider |
 
 ## Built-in Tools
 
-### Read Tools (parallel, auto-approved)
+### Read Tools (14 — parallel, auto-approved)
 
 | Tool | Description |
 |------|-------------|
-| `balance_check` | Available, savings, debt, rewards, gas reserve |
+| `balance_check` | Available, savings, debt, rewards, gas reserve (DefiLlama pricing) |
 | `savings_info` | Positions, earnings, fund status |
 | `health_check` | Health factor with risk assessment |
 | `rates_info` | Current supply/borrow APYs |
 | `transaction_history` | Recent transaction log |
-
-### Write Tools (serial, confirmation required)
+| `swap_quote` | Preview swap route, output amount, and price impact (no execution) |
+| `volo_stats` | VOLO liquid staking stats — vSUI/SUI rate, APY, TVL |
+| `defillama_yield_pools` | Top yield pools by APY, filterable by chain |
+| `defillama_protocol_info` | Protocol TVL, category, chains |
+| `defillama_token_prices` | Current USD prices for Sui tokens |
+| `defillama_price_change` | Token price % change over period |
+| `defillama_chain_tvl` | Chain TVL rankings |
+| `defillama_protocol_fees` | Protocol fees/revenue rankings |
+| `defillama_sui_protocols` | Sui ecosystem protocols — TVL, category, changes |
+
+### Write Tools (10 — serial, confirmation required)
 
 | Tool | Description |
 |------|-------------|
-| `save_deposit` | Deposit USDC to savings |
-| `withdraw` | Withdraw from savings |
+| `save_deposit` | Deposit to savings (optional `asset` for multi-asset NAVI deposits) |
+| `withdraw` | Withdraw from savings (optional `asset` for multi-asset withdrawals) |
 | `send_transfer` | Send USDC to an address |
 | `borrow` | Borrow USDC against collateral |
 | `repay_debt` | Repay outstanding debt |
 | `claim_rewards` | Claim pending yield rewards |
 | `pay_api` | Pay for an API service via MPP |
+| `swap_execute` | Swap any token pair via Cetus Aggregator (20+ DEXs) |
+| `volo_stake` | Stake SUI for vSUI (VOLO liquid staking) |
+| `volo_unstake` | Unstake vSUI back to SUI |
 
 ## Configuration
 

package/dist/index.d.ts

@@ -771,6 +771,7 @@ declare const balanceCheckTool: Tool<{}, {
     gasReserve: number;
     total: number;
     stables: number;
+    holdings: any[];
 }>;
 
 declare const savingsInfoTool: Tool<{}, SavingsResult>;
@@ -795,10 +796,12 @@ declare const transactionHistoryTool: Tool<{
 
 declare const saveDepositTool: Tool<{
     amount: number;
+    asset?: string | undefined;
 }, {
     success: boolean;
     tx: string;
     amount: number;
+    asset: "SUI" | "USDC" | "USDT" | "USDe" | "USDsui";
     apy: number;
     fee: number;
     gasCost: number;
@@ -807,6 +810,7 @@ declare const saveDepositTool: Tool<{
 
 declare const withdrawTool: Tool<{
     amount: number;
+    asset?: string | undefined;
 }, {
     success: boolean;
     tx: string;
@@ -874,6 +878,122 @@ declare const payApiTool: Tool<{
     } | undefined;
 }>;
 
+declare const swapExecuteTool: Tool<{
+    amount: number;
+    to: string;
+    from: string;
+    byAmountIn?: boolean | undefined;
+    slippage?: number | undefined;
+}, {
+    tx: string;
+    fromToken: string;
+    toToken: string;
+    fromAmount: number;
+    toAmount: number;
+    priceImpact: number;
+    route: string;
+    gasCost: number;
+}>;
+
+declare const swapQuoteTool: Tool<{
+    amount: number;
+    to: string;
+    from: string;
+    byAmountIn?: boolean | undefined;
+}, _t2000_sdk.SwapQuoteResult>;
+
+declare const voloStakeTool: Tool<{
+    amount: number;
+}, {
+    tx: string;
+    amountSui: number;
+    vSuiReceived: number;
+    apy: number;
+    gasCost: number;
+}>;
+
+declare const voloUnstakeTool: Tool<{
+    amount: number | "all";
+}, {
+    tx: string;
+    vSuiAmount: number;
+    suiReceived: number;
+    gasCost: number;
+}>;
+
+declare const voloStatsTool: Tool<{}, {
+    apy: number;
+    exchangeRate: number;
+    totalStaked: number;
+    totalVSui: number;
+}>;
+
+declare const defillamaYieldPoolsTool: Tool<{
+    limit?: number | undefined;
+    chain?: string | undefined;
+}, {
+    pool: string;
+    protocol: string;
+    chain: string;
+    apy: number;
+    apyBase: number | undefined;
+    apyReward: number | undefined;
+    tvl: number;
+}[]>;
+declare const defillamaProtocolInfoTool: Tool<{
+    name: string;
+}, {
+    name: string;
+    category: string;
+    chains: string[];
+    tvl: number;
+    change1d: number | undefined;
+    change7d: number | undefined;
+    url: string;
+    description: string | undefined;
+}>;
+declare const defillamaTokenPricesTool: Tool<{
+    coinTypes: string[];
+}, {
+    coinType: string;
+    symbol: string;
+    price: number;
+}[]>;
+declare const defillamaPriceChangeTool: Tool<{
+    coinType: string;
+    period?: "1h" | "24h" | "7d" | "30d" | undefined;
+}, {
+    symbol: string;
+    currentPrice: number;
+    historicalPrice: number | null;
+    change: number | null;
+    period: "1h" | "24h" | "7d" | "30d";
+}>;
+declare const defillamaChainTvlTool: Tool<{
+    limit?: number | undefined;
+}, {
+    rank: number;
+    chain: string;
+    tvl: number;
+}[]>;
+declare const defillamaProtocolFeesTool: Tool<{
+    limit?: number | undefined;
+    chain?: string | undefined;
+}, {
+    name: string;
+    fees24h: number | null;
+    fees7d: number | null;
+    category: string | undefined;
+}[]>;
+declare const defillamaSuiProtocolsTool: Tool<{
+    limit?: number | undefined;
+}, {
+    name: string;
+    slug: string;
+    tvl: number;
+    category: string;
+}[]>;
+
 declare const READ_TOOLS: Tool[];
 declare const WRITE_TOOLS: Tool[];
 declare function getDefaultTools(): Tool[];
@@ -911,6 +1031,14 @@ interface WalletCoin {
  */
 declare function fetchWalletCoins(address: string, rpcUrl?: string): Promise<WalletCoin[]>;
 
-declare const DEFAULT_SYSTEM_PROMPT = "You are Audric, an AI assistant built on the Sui blockchain. You help users manage finances AND access 40+ paid API services via MPP (Machine Payment Protocol) micropayments.\n\n## Core Capabilities\n- Check balances, savings positions, health factors, and interest rates\n- Execute deposits, withdrawals, transfers, borrows, and repayments\n- Track transaction history and earnings\n- Look up swap quotes, bridge options, and token information via NAVI\n- **Access any MPP service** \u2014 weather, web search, news, crypto prices, stock quotes, translations, image generation, maps, flights, and more via the pay_api tool\n- Answer general knowledge questions conversationally\n\n## MPP Services (via pay_api tool)\nWhen users ask for real-world data (weather, search, prices, news, etc.), use the pay_api tool. Each call costs a few cents in USDC, paid automatically on-chain. Common services:\n- **Weather/forecast**: OpenWeather \u2014 current conditions, 5-day forecast\n- **Web search**: Brave Search, Serper (Google), Perplexity (AI-powered)\n- **News**: NewsAPI headlines and search\n- **Crypto**: CoinGecko prices, markets, trending\n- **Stocks**: Alpha Vantage quotes, daily data\n- **Maps**: Google Maps geocode, places, directions\n- **Translation**: DeepL, Google Translate\n- **FX rates**: Exchange rate conversion\n- **Scraping**: Firecrawl, Jina Reader\n- **Flights**: SerpAPI Google Flights\n- **Image gen**: Flux, Stable Diffusion, DALL-E\n- **Email**: Resend\n\nAlways tell users the cost before calling a paid service. If they agree, use pay_api.\n\n## Guidelines\n\n### Before Acting\n- **ALWAYS call a read tool first** before any write tool \u2014 call balance_check before save/send/borrow, savings_info before withdraw, balance_check before repay. Never skip this step.\n- Show real numbers from tool results \u2014 never fabricate rates, amounts, or balances\n- For transactions that move funds, explain what will happen and confirm intent\n- When the user says \"all\" or \"idle\" or an imprecise amount, call the relevant read tool first to get the exact number, then call the write tool with that specific amount\n\n### Tool Usage\n- Use any available tools to help the user \u2014 don't refuse requests you can handle\n- For real-world questions (weather, search, news, prices), use pay_api with the appropriate MPP endpoint\n- Use multiple read-only tools in parallel when you need several data points\n- Present amounts as currency ($1,234.56) and rates as percentages (4.86% APY)\n- If a tool errors, explain the issue clearly and suggest alternatives\n\n### Communication Style\n- Be concise and direct \u2014 lead with results, follow with context\n- Use short sentences. Avoid hedging language.\n- When presenting positions or balances, use a structured format\n- For non-financial questions, answer naturally and helpfully\n\n### Safety\n- Never encourage risky financial behavior\n- Warn when health factor drops below 1.5\n- Remind users of gas costs for on-chain transactions\n- All amounts are in USDC unless explicitly stated otherwise";
+/**
+ * Batch-fetch USD prices for Sui coin types from DefiLlama.
+ * Returns a map of `coinType -> usdPrice`. Tokens not found return no entry.
+ * Results are cached for 60s. Free API, no auth required.
+ */
+declare function fetchTokenPrices(coinTypes: string[]): Promise<Record<string, number>>;
+declare function clearPriceCache(): void;
+
+declare const DEFAULT_SYSTEM_PROMPT = "You are a financial agent on Sui. You manage money and access paid APIs via MPP micropayments.\n\n## Response rules\n- 1-2 sentences max. No bullet lists unless asked. No preambles.\n- Never say \"Would you like me to...\", \"Sure!\", \"Great question!\", \"Absolutely!\" \u2014 just do it or say you can't.\n- Lead with the result. After tool calls, state the outcome with real numbers. Done.\n- Present amounts as $1,234.56 and rates as X.XX% APY.\n- Show top 3 results unless asked for more. Summarize totals in one line.\n\n## Execution rule\nOnly offer to execute actions you have tools for. If you retrieved a quote, data, or information but have no tool to act on it, give the user the result and tell them where to execute manually \u2014 in one sentence. Never say \"Would you like me to proceed?\" unless you have a tool that can actually proceed.\n\n## Before acting\n- ALWAYS call a read tool first before any write tool \u2014 balance_check before save/send/borrow, savings_info before withdraw.\n- Show real numbers from tools \u2014 never fabricate rates, amounts, or balances.\n- When user says \"all\" or an imprecise amount, call the read tool first to get the exact number.\n\n## Tool usage\n- Use tools proactively \u2014 don't refuse requests you can handle.\n- For real-world questions (weather, search, news, prices), use pay_api. Tell the user the cost first.\n- For broad market data (yields across protocols, token prices, TVL, protocol comparisons), use defillama_* tools.\n- To discover Sui protocols, use defillama_sui_protocols first, then defillama_protocol_info with the slug.\n- Run multiple read-only tools in parallel when you need several data points.\n- If a tool errors, say what went wrong and what to try instead. One sentence.\n\n## Multi-step flows\n- \"How much X for Y?\": swap_quote first, then swap_execute if user confirms.\n- \"Swap then save\": swap_execute \u2192 balance_check \u2192 save_deposit. Confirm each step.\n- \"Buy $X of token\": defillama_token_prices \u2192 calculate amount \u2192 swap_execute.\n- \"Best yield on SUI\": compare rates_info (NAVI lending) + defillama_yield_pools (broader) + volo_stats.\n- save_deposit supports any NAVI asset: USDC (default), USDT, SUI, USDe, USDsui. Pass asset param for non-USDC.\n- \"Deposit SUI to earn yield\": save_deposit with asset=\"SUI\" for NAVI lending, or volo_stake for liquid staking.\n- \"What protocols are on Sui?\": defillama_sui_protocols \u2192 defillama_protocol_info for details.\n\n## Safety\n- Never encourage risky financial behavior.\n- Warn when health factor < 1.5.\n- All amounts in USDC unless stated otherwise.";
 
-export { AnthropicProvider, type AnthropicProviderConfig, type BalancePrices, type BalanceResult, type BuildToolOptions, type ChatParams, type CompactOptions, type ContentBlock, type CostSnapshot, CostTracker, type CostTrackerConfig, DEFAULT_SYSTEM_PROMPT, type EngineConfig, type EngineEvent, type HealthFactorResult, type LLMProvider, type McpCallResult, McpClientManager, McpResponseCache, type McpServerConfig, type McpServerConnection, type McpToolAdapterConfig, type McpToolDescriptor, MemorySessionStore, type Message, NAVI_MCP_CONFIG, NAVI_MCP_URL, NAVI_SERVER_NAME, type NaviRawCoin, type NaviRawHealthFactor, type NaviRawPool, type NaviRawPosition, type NaviRawPositionsResponse, type NaviRawProtocolStats, type NaviRawRewardsResponse, type NaviReadOptions, NaviTools, type PendingAction, type PendingReward, type PendingToolCall, type PermissionLevel, type PermissionResponse, type PositionEntry, type ProtocolStats, type ProviderEvent, QueryEngine, READ_TOOLS, type RatesResult, type SSEEvent, type SavingsResult, type ServerPositionData, type SessionData, type SessionStore, type StopReason, type SuiCoinBalance, type Tool, type ToolContext, type ToolDefinition, type ToolJsonSchema, type ToolResult, TxMutex, WRITE_TOOLS, type WalletCoin, adaptAllMcpTools, adaptAllServerTools, adaptMcpTool, balanceCheckTool, borrowTool, buildMcpTools, buildTool, claimRewardsTool, compactMessages, engineToSSE, estimateTokens, extractMcpText, fetchAvailableRewards, fetchBalance, fetchHealthFactor, fetchPositions, fetchProtocolStats, fetchRates, fetchSavings, fetchWalletCoins, findTool, getDefaultTools, getMcpManager, getWalletAddress, hasNaviMcp, healthCheckTool, parseMcpJson, parseSSE, payApiTool, ratesInfoTool, registerEngineTools, repayDebtTool, requireAgent, runTools, saveDepositTool, savingsInfoTool, sendTransferTool, serializeSSE, toolsToDefinitions, transactionHistoryTool, transformBalance, transformHealthFactor, transformPositions, transformRates, transformRewards, transformSavings, validateHistory, withdrawTool };
+export { AnthropicProvider, type AnthropicProviderConfig, type BalancePrices, type BalanceResult, type BuildToolOptions, type ChatParams, type CompactOptions, type ContentBlock, type CostSnapshot, CostTracker, type CostTrackerConfig, DEFAULT_SYSTEM_PROMPT, type EngineConfig, type EngineEvent, type HealthFactorResult, type LLMProvider, type McpCallResult, McpClientManager, McpResponseCache, type McpServerConfig, type McpServerConnection, type McpToolAdapterConfig, type McpToolDescriptor, MemorySessionStore, type Message, NAVI_MCP_CONFIG, NAVI_MCP_URL, NAVI_SERVER_NAME, type NaviRawCoin, type NaviRawHealthFactor, type NaviRawPool, type NaviRawPosition, type NaviRawPositionsResponse, type NaviRawProtocolStats, type NaviRawRewardsResponse, type NaviReadOptions, NaviTools, type PendingAction, type PendingReward, type PendingToolCall, type PermissionLevel, type PermissionResponse, type PositionEntry, type ProtocolStats, type ProviderEvent, QueryEngine, READ_TOOLS, type RatesResult, type SSEEvent, type SavingsResult, type ServerPositionData, type SessionData, type SessionStore, type StopReason, type SuiCoinBalance, type Tool, type ToolContext, type ToolDefinition, type ToolJsonSchema, type ToolResult, TxMutex, WRITE_TOOLS, type WalletCoin, adaptAllMcpTools, adaptAllServerTools, adaptMcpTool, balanceCheckTool, borrowTool, buildMcpTools, buildTool, claimRewardsTool, clearPriceCache, compactMessages, defillamaChainTvlTool, defillamaPriceChangeTool, defillamaProtocolFeesTool, defillamaProtocolInfoTool, defillamaSuiProtocolsTool, defillamaTokenPricesTool, defillamaYieldPoolsTool, engineToSSE, estimateTokens, extractMcpText, fetchAvailableRewards, fetchBalance, fetchHealthFactor, fetchPositions, fetchProtocolStats, fetchRates, fetchSavings, fetchTokenPrices, fetchWalletCoins, findTool, getDefaultTools, getMcpManager, getWalletAddress, hasNaviMcp, healthCheckTool, parseMcpJson, parseSSE, payApiTool, ratesInfoTool, registerEngineTools, repayDebtTool, requireAgent, runTools, saveDepositTool, savingsInfoTool, sendTransferTool, serializeSSE, swapExecuteTool, swapQuoteTool, toolsToDefinitions, transactionHistoryTool, transformBalance, transformHealthFactor, transformPositions, transformRates, transformRewards, transformSavings, validateHistory, voloStakeTool, voloStatsTool, voloUnstakeTool, withdrawTool };