@t2000/engine 0.5.12 → 0.6.0

package/dist/index.d.ts

@@ -94,6 +94,8 @@ interface ToolContext {
     serverPositions?: ServerPositionData;
     /** Fresh on-chain position reader — bypasses MCP caching. If provided, read tools prefer this. */
     positionFetcher?: (address: string) => Promise<ServerPositionData>;
+    /** Environment variables passed to tools (e.g. API keys not in process.env) */
+    env?: Record<string, string>;
     signal?: AbortSignal;
 }
 interface ServerPositionData {
@@ -981,6 +983,83 @@ declare const saveContactTool: Tool<{
     address: string;
 }>;
 
+interface SearchResult {
+    title: string;
+    url: string;
+    description: string;
+}
+interface WebSearchData {
+    results: SearchResult[];
+    error?: string;
+}
+declare const webSearchTool: Tool<{
+    query: string;
+    count?: number | undefined;
+}, WebSearchData>;
+
+interface TxEffect {
+    type: string;
+    description: string;
+}
+interface ExplainedTx {
+    digest: string;
+    sender: string;
+    status: string;
+    gasUsed: string;
+    timestamp?: string;
+    effects: TxEffect[];
+    summary: string;
+}
+declare const explainTxTool: Tool<{
+    digest: string;
+}, ExplainedTx>;
+
+interface AssetAllocation {
+    symbol: string;
+    amount: number;
+    usdValue: number;
+    percentage: number;
+}
+interface PortfolioInsight {
+    type: 'info' | 'warning' | 'suggestion';
+    message: string;
+}
+interface PortfolioResult {
+    totalValue: number;
+    walletValue: number;
+    savingsValue: number;
+    debtValue: number;
+    healthFactor: number | null;
+    allocations: AssetAllocation[];
+    stablePercentage: number;
+    insights: PortfolioInsight[];
+}
+declare const portfolioAnalysisTool: Tool<{
+    address?: string | undefined;
+}, PortfolioResult>;
+
+interface ProtocolProfile {
+    name: string;
+    slug: string;
+    category: string;
+    chains: string[];
+    tvl: number;
+    tvlChange1d: number;
+    tvlChange7d: number;
+    tvlChange30d: number;
+    mcap: number | null;
+    fees24h: number | null;
+    revenue24h: number | null;
+    audits: string[];
+    url: string;
+    twitter: string | null;
+    riskFactors: string[];
+    safetyScore: string;
+}
+declare const protocolDeepDiveTool: Tool<{
+    protocol: string;
+}, ProtocolProfile>;
+
 declare const defillamaYieldPoolsTool: Tool<{
     limit?: number | undefined;
     chain?: string | undefined;
@@ -1092,6 +1171,6 @@ declare function fetchWalletCoins(address: string, rpcUrl?: string): Promise<Wal
 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, WAL, ETH, NAVX, GOLD, USDe, USDsui. Pass asset param for non-USDC.\n- withdraw supports any deposited NAVI asset. Pass asset param to withdraw a specific token.\n- \"Deposit WAL/ETH/SUI to earn yield\": save_deposit with asset=\"WAL\"/\"ETH\"/\"SUI\" for NAVI lending, or volo_stake for SUI 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.";
+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: USDC (default), USDT, SUI, USDe, USDsui. Pass asset param for non-USDC.\n- withdraw supports: USDC, USDT, SUI, USDe, USDsui. Pass asset param to withdraw a specific token.\n- \"Deposit SUI to earn yield\": save_deposit with asset=\"SUI\" for NAVI lending, or volo_stake for SUI 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 ToolChoice, 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, mppServicesTool, parseMcpJson, parseSSE, payApiTool, ratesInfoTool, registerEngineTools, repayDebtTool, requireAgent, runTools, saveContactTool, saveDepositTool, savingsInfoTool, sendTransferTool, serializeSSE, swapExecuteTool, swapQuoteTool, toolsToDefinitions, transactionHistoryTool, transformBalance, transformHealthFactor, transformPositions, transformRates, transformRewards, transformSavings, validateHistory, voloStakeTool, voloStatsTool, voloUnstakeTool, 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 ToolChoice, 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, explainTxTool, extractMcpText, fetchAvailableRewards, fetchBalance, fetchHealthFactor, fetchPositions, fetchProtocolStats, fetchRates, fetchSavings, fetchTokenPrices, fetchWalletCoins, findTool, getDefaultTools, getMcpManager, getWalletAddress, hasNaviMcp, healthCheckTool, mppServicesTool, parseMcpJson, parseSSE, payApiTool, portfolioAnalysisTool, protocolDeepDiveTool, ratesInfoTool, registerEngineTools, repayDebtTool, requireAgent, runTools, saveContactTool, saveDepositTool, savingsInfoTool, sendTransferTool, serializeSSE, swapExecuteTool, swapQuoteTool, toolsToDefinitions, transactionHistoryTool, transformBalance, transformHealthFactor, transformPositions, transformRates, transformRewards, transformSavings, validateHistory, voloStakeTool, voloStatsTool, voloUnstakeTool, webSearchTool, withdrawTool };

package/dist/index.js

@@ -999,20 +999,20 @@ var transactionHistoryTool = buildTool({
 });
 var saveDepositTool = buildTool({
   name: "save_deposit",
-  description: "Deposit into NAVI lending to earn yield. Supports any NAVI-listed asset: USDC, USDT, SUI, WAL, ETH, NAVX, GOLD, USDe, USDsui. Amount is in token units (not USD).",
+  description: "Deposit into NAVI lending to earn yield. Supported assets: USDC, USDT, SUI, USDe, USDsui. Amount is in token units (not USD).",
   inputSchema: z.object({
     amount: z.number().positive(),
-    asset: z.string().optional().describe("Asset to deposit (default: USDC). Supports: USDC, USDT, SUI, WAL, ETH, NAVX, GOLD, USDe, USDsui")
+    asset: z.string().optional().describe("Asset to deposit (default: USDC). Supported: USDC, USDT, SUI, USDe, USDsui")
   }),
   jsonSchema: {
     type: "object",
     properties: {
       amount: {
-        description: "Exact amount to save in token units (call balance_check first)"
+        description: "Exact amount to deposit in token units"
       },
       asset: {
         type: "string",
-        description: "Asset to deposit (default: USDC). Supports: USDC, USDT, SUI, WAL, ETH, NAVX, GOLD, USDe, USDsui"
+        description: "Asset to deposit (default: USDC). Supported: USDC, USDT, SUI, USDe, USDsui"
       }
     },
     required: ["amount"]
@@ -1040,20 +1040,20 @@ var saveDepositTool = buildTool({
 });
 var withdrawTool = buildTool({
   name: "withdraw",
-  description: "Withdraw from NAVI lending back to wallet. Supports any deposited asset: USDC, USDT, SUI, WAL, ETH, NAVX, GOLD, USDe, USDsui. Checks health factor to prevent liquidation if there is outstanding debt.",
+  description: "Withdraw from NAVI lending back to wallet. Supported assets: USDC, USDT, SUI, USDe, USDsui. Checks health factor to prevent liquidation if there is outstanding debt.",
   inputSchema: z.object({
     amount: z.number().positive(),
-    asset: z.string().optional().describe("Asset to withdraw (default: picks largest position). Supports: USDC, USDT, SUI, WAL, ETH, NAVX, GOLD, USDe, USDsui")
+    asset: z.string().optional().describe("Asset to withdraw (default: picks largest position). Supported: USDC, USDT, SUI, USDe, USDsui")
   }),
   jsonSchema: {
     type: "object",
     properties: {
       amount: {
-        description: "Exact amount to withdraw (call savings_info first to get deposited amount)"
+        description: "Exact amount to withdraw in token units"
       },
       asset: {
         type: "string",
-        description: "Asset to withdraw (default: picks largest position). Supports: USDC, USDT, SUI, WAL, ETH, NAVX, GOLD, USDe, USDsui"
+        description: "Asset to withdraw (default: picks largest position). Supported: USDC, USDT, SUI, USDe, USDsui"
       }
     },
     required: ["amount"]
@@ -1526,7 +1526,356 @@ var saveContactTool = buildTool({
     };
   }
 });
+var BRAVE_API = "https://api.search.brave.com/res/v1/web/search";
+var inputSchema = z.object({
+  query: z.string().describe("Search query"),
+  count: z.number().optional().default(5).describe("Number of results (1-10)")
+});
+var webSearchTool = buildTool({
+  name: "web_search",
+  description: "Search the web for real-time information. Use for news, token info, project details, protocol documentation, or any question that needs current web data. Free for users.",
+  inputSchema,
+  jsonSchema: {
+    type: "object",
+    properties: {
+      query: { type: "string", description: "Search query" },
+      count: { type: "number", description: "Number of results (1-10)", default: 5 }
+    },
+    required: ["query"]
+  },
+  isReadOnly: true,
+  async call(input, context) {
+    const apiKey = context.env?.BRAVE_API_KEY ?? process.env.BRAVE_API_KEY;
+    if (!apiKey) {
+      return {
+        data: { results: [], error: "Web search not configured" },
+        displayText: "Web search is not available."
+      };
+    }
+    const count = Math.min(Math.max(input.count ?? 5, 1), 10);
+    const url = `${BRAVE_API}?q=${encodeURIComponent(input.query)}&count=${count}&text_decorations=false`;
+    const res = await fetch(url, {
+      headers: {
+        "Accept": "application/json",
+        "Accept-Encoding": "gzip",
+        "X-Subscription-Token": apiKey
+      },
+      signal: AbortSignal.timeout(8e3)
+    });
+    if (!res.ok) {
+      throw new Error(`Brave Search API error: HTTP ${res.status}`);
+    }
+    const json = await res.json();
+    const results = (json.web?.results ?? []).slice(0, count).map((r) => ({
+      title: r.title,
+      url: r.url,
+      description: r.description
+    }));
+    const displayText = results.length > 0 ? results.map((r, i) => `${i + 1}. ${r.title}
+   ${r.url}
+   ${r.description}`).join("\n\n") : "No results found.";
+    return { data: { results }, displayText };
+  }
+});
+var inputSchema2 = z.object({
+  digest: z.string().describe("Sui transaction digest to explain")
+});
+var SIX_DECIMAL_TOKENS = /* @__PURE__ */ new Set(["USDC", "USDT", "USDe", "WBTC"]);
+var EIGHT_DECIMAL_TOKENS = /* @__PURE__ */ new Set(["WETH", "ETH"]);
+function guessDecimals(coinType) {
+  const symbol = coinType.split("::").pop()?.toUpperCase() ?? "";
+  if (SIX_DECIMAL_TOKENS.has(symbol)) return 6;
+  if (EIGHT_DECIMAL_TOKENS.has(symbol)) return 8;
+  return 9;
+}
+var explainTxTool = buildTool({
+  name: "explain_tx",
+  description: "Explain a Sui transaction in plain English. Provide a transaction digest and get a human-readable breakdown of what happened \u2014 transfers, swaps, deposits, etc.",
+  inputSchema: inputSchema2,
+  jsonSchema: {
+    type: "object",
+    properties: {
+      digest: { type: "string", description: "Sui transaction digest" }
+    },
+    required: ["digest"]
+  },
+  isReadOnly: true,
+  async call(input, context) {
+    const rpcUrl = context.suiRpcUrl ?? "https://fullnode.mainnet.sui.io:443";
+    const res = await fetch(rpcUrl, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({
+        jsonrpc: "2.0",
+        id: 1,
+        method: "sui_getTransactionBlock",
+        params: [
+          input.digest,
+          {
+            showInput: true,
+            showEffects: true,
+            showEvents: true,
+            showBalanceChanges: true,
+            showObjectChanges: true
+          }
+        ]
+      }),
+      signal: AbortSignal.timeout(1e4)
+    });
+    if (!res.ok) throw new Error(`Sui RPC error: HTTP ${res.status}`);
+    const json = await res.json();
+    if (json.error) throw new Error(json.error.message);
+    if (!json.result) throw new Error("Transaction not found");
+    const tx = json.result;
+    const txInput = tx.transaction;
+    const effects = tx.effects;
+    const balanceChanges = tx.balanceChanges;
+    const events = tx.events;
+    const sender = txInput?.data?.sender ?? "unknown";
+    const status = effects?.status?.status ?? "unknown";
+    const gasUsed = effects?.gasUsed;
+    const gasCost = gasUsed ? (Number(gasUsed.computationCost ?? 0) + Number(gasUsed.storageCost ?? 0) - Number(gasUsed.storageRebate ?? 0)) / 1e9 : 0;
+    const timestamp = tx.timestampMs ? new Date(Number(tx.timestampMs)).toISOString() : void 0;
+    const txEffects = [];
+    if (balanceChanges?.length) {
+      for (const bc of balanceChanges) {
+        const ownerAddr = bc.owner?.AddressOwner ?? bc.owner?.ObjectOwner ?? "unknown";
+        const coinParts = bc.coinType.split("::");
+        const symbol = coinParts[coinParts.length - 1] ?? bc.coinType;
+        const amount = Number(bc.amount);
+        const isNegative = amount < 0;
+        const decimals = guessDecimals(bc.coinType);
+        txEffects.push({
+          type: isNegative ? "send" : "receive",
+          description: `${ownerAddr.slice(0, 8)}...${ownerAddr.slice(-4)} ${isNegative ? "sent" : "received"} ${Math.abs(amount / 10 ** decimals).toFixed(decimals > 6 ? 4 : 2)} ${symbol}`
+        });
+      }
+    }
+    if (events?.length) {
+      for (const evt of events.slice(0, 5)) {
+        const eventParts = evt.type.split("::");
+        const eventName = eventParts[eventParts.length - 1] ?? evt.type;
+        txEffects.push({
+          type: "event",
+          description: `Event: ${eventName}`
+        });
+      }
+    }
+    const summary = txEffects.length > 0 ? txEffects.filter((e) => e.type !== "event").map((e) => e.description).join("; ") : `Transaction ${status}`;
+    const result = {
+      digest: input.digest,
+      sender,
+      status,
+      gasUsed: `${gasCost.toFixed(6)} SUI`,
+      timestamp,
+      effects: txEffects,
+      summary
+    };
+    return {
+      data: result,
+      displayText: `**Tx ${input.digest.slice(0, 8)}...** (${status})
+Sender: ${sender}
+Gas: ${result.gasUsed}
+${summary}`
+    };
+  }
+});
+var inputSchema3 = z.object({
+  address: z.string().optional().describe("Sui address to analyze (defaults to connected wallet)")
+});
+var STABLECOINS = /* @__PURE__ */ new Set(["USDC", "USDT", "USDe", "USDsui", "DAI", "BUCK"]);
+var portfolioAnalysisTool = buildTool({
+  name: "portfolio_analysis",
+  description: "Analyze portfolio allocation, risk exposure, and yield optimization. Shows asset breakdown, diversification score, health factor assessment, and actionable suggestions.",
+  inputSchema: inputSchema3,
+  jsonSchema: {
+    type: "object",
+    properties: {
+      address: { type: "string", description: "Sui address to analyze (defaults to connected wallet)" }
+    },
+    required: []
+  },
+  isReadOnly: true,
+  async call(input, context) {
+    const address = input.address ?? context.walletAddress;
+    if (!address) {
+      throw new Error("No wallet address provided. Sign in first.");
+    }
+    const rpcUrl = context.suiRpcUrl ?? "https://fullnode.mainnet.sui.io:443";
+    const coins = await fetchWalletCoins(address, rpcUrl);
+    const nonZero = coins.filter((c) => Number(c.totalBalance) > 0);
+    const prices = await fetchTokenPrices(nonZero.map((c) => c.coinType)).catch(() => ({}));
+    let walletValue = 0;
+    const allocations = [];
+    for (const coin of nonZero) {
+      const amount = Number(coin.totalBalance) / 10 ** coin.decimals;
+      const price = prices[coin.coinType] ?? 0;
+      const usdValue = amount * price;
+      walletValue += usdValue;
+      allocations.push({ symbol: coin.symbol, amount, usdValue, percentage: 0 });
+    }
+    let savingsValue = 0;
+    let debtValue = 0;
+    let healthFactor = null;
+    if (context.positionFetcher) {
+      try {
+        const positions = await context.positionFetcher(address);
+        savingsValue = positions.savings ?? 0;
+        debtValue = positions.borrows ?? 0;
+        healthFactor = positions.healthFactor ?? null;
+      } catch {
+      }
+    }
+    const totalValue = walletValue + savingsValue;
+    for (const a of allocations) {
+      a.percentage = totalValue > 0 ? a.usdValue / totalValue * 100 : 0;
+    }
+    allocations.sort((a, b) => b.usdValue - a.usdValue);
+    const stableValue = allocations.filter((a) => STABLECOINS.has(a.symbol)).reduce((s, a) => s + a.usdValue, 0) + savingsValue;
+    const stablePercentage = totalValue > 0 ? stableValue / totalValue * 100 : 0;
+    const insights = [];
+    if (healthFactor !== null && healthFactor < 1.5) {
+      insights.push({
+        type: "warning",
+        message: `Health factor ${healthFactor.toFixed(2)} is dangerously low. Consider repaying debt or adding collateral.`
+      });
+    } else if (healthFactor !== null && healthFactor < 2.5) {
+      insights.push({
+        type: "warning",
+        message: `Health factor ${healthFactor.toFixed(2)} is moderate. Monitor your positions.`
+      });
+    }
+    if (stablePercentage > 80) {
+      insights.push({
+        type: "suggestion",
+        message: `${stablePercentage.toFixed(0)}% stablecoins. Consider diversifying into yield-bearing positions.`
+      });
+    }
+    const idleCash = allocations.find((a) => a.symbol === "USDC");
+    if (idleCash && idleCash.usdValue > 10) {
+      insights.push({
+        type: "suggestion",
+        message: `$${idleCash.usdValue.toFixed(2)} USDC idle in wallet. Deposit into NAVI savings for ~4-5% APY.`
+      });
+    }
+    if (allocations.length === 1) {
+      insights.push({
+        type: "info",
+        message: "Portfolio is concentrated in a single asset."
+      });
+    }
+    const result = {
+      totalValue,
+      walletValue,
+      savingsValue,
+      debtValue,
+      healthFactor,
+      allocations: allocations.slice(0, 10),
+      stablePercentage,
+      insights
+    };
+    const topLine = `Total: $${totalValue.toFixed(2)} | Wallet: $${walletValue.toFixed(2)} | Savings: $${savingsValue.toFixed(2)}`;
+    const insightLines = insights.map((i) => `${i.type === "warning" ? "\u26A0" : "\u2192"} ${i.message}`).join("\n");
+    return {
+      data: result,
+      displayText: `${topLine}
+${insightLines}`
+    };
+  }
+});
 var LLAMA_API = "https://api.llama.fi";
+var inputSchema4 = z.object({
+  protocol: z.string().describe('Protocol slug (e.g. "navi-protocol", "cetus", "scallop-lend")')
+});
+var protocolDeepDiveTool = buildTool({
+  name: "protocol_deep_dive",
+  description: 'Get a comprehensive safety and financial profile of a DeFi protocol. Includes TVL trends, revenue, audit status, and risk assessment. Use when users ask "is X safe?" or "tell me about protocol Y".',
+  inputSchema: inputSchema4,
+  jsonSchema: {
+    type: "object",
+    properties: {
+      protocol: { type: "string", description: 'Protocol slug (e.g. "navi-protocol", "cetus")' }
+    },
+    required: ["protocol"]
+  },
+  isReadOnly: true,
+  async call(input) {
+    const slug = input.protocol.toLowerCase().replace(/\s+/g, "-");
+    const [protocolRes, feesRes] = await Promise.allSettled([
+      fetch(`${LLAMA_API}/protocol/${slug}`, { signal: AbortSignal.timeout(1e4) }).then((r) => {
+        if (!r.ok) throw new Error(`HTTP ${r.status}`);
+        return r.json();
+      }),
+      fetch(`${LLAMA_API}/summary/fees/${slug}?dataType=dailyFees`, { signal: AbortSignal.timeout(8e3) }).then((r) => {
+        if (!r.ok) return null;
+        return r.json();
+      })
+    ]);
+    if (protocolRes.status === "rejected") {
+      throw new Error(`Protocol "${slug}" not found on DefiLlama.`);
+    }
+    const proto = protocolRes.value;
+    const tvl = Number(proto.tvl ?? 0);
+    const tvlChange1d = Number(proto.change_1d ?? 0);
+    const tvlChange7d = Number(proto.change_7d ?? 0);
+    const tvlChange30d = Number(proto.change_1m ?? 0);
+    const chains = proto.chains ?? [];
+    const category = proto.category ?? "Unknown";
+    const audits = proto.audits ?? proto.audit_links ?? [];
+    const auditNote = proto.audit_note ?? proto.audits;
+    let fees24h = null;
+    let revenue24h = null;
+    if (feesRes.status === "fulfilled" && feesRes.value) {
+      const feesData = feesRes.value;
+      fees24h = feesData.total24h != null ? Number(feesData.total24h) : null;
+      revenue24h = feesData.totalRevenue24h != null ? Number(feesData.totalRevenue24h) : null;
+    }
+    const riskFactors = [];
+    if (tvl < 1e6) riskFactors.push("TVL under $1M \u2014 low liquidity risk");
+    if (tvl < 1e7) riskFactors.push("TVL under $10M \u2014 moderate liquidity");
+    if (tvlChange7d < -15) riskFactors.push(`TVL dropped ${tvlChange7d.toFixed(1)}% in 7 days`);
+    if (chains.length === 1) riskFactors.push("Single-chain deployment");
+    if (!audits.length && !auditNote) riskFactors.push("No published audits found");
+    if (audits.length > 0) riskFactors.push(`${audits.length} audit(s) on file`);
+    let safetyScore;
+    if (tvl > 1e8 && audits.length > 0 && tvlChange7d > -10) {
+      safetyScore = "High \u2014 established protocol with audits and significant TVL";
+    } else if (tvl > 1e7 && tvlChange7d > -20) {
+      safetyScore = "Moderate \u2014 decent TVL, use with caution";
+    } else {
+      safetyScore = "Low \u2014 small or declining TVL, proceed carefully";
+    }
+    const result = {
+      name: proto.name ?? slug,
+      slug,
+      category,
+      chains,
+      tvl,
+      tvlChange1d,
+      tvlChange7d,
+      tvlChange30d,
+      mcap: proto.mcap ? Number(proto.mcap) : null,
+      fees24h,
+      revenue24h,
+      audits: typeof auditNote === "string" ? [auditNote] : audits.map(String),
+      url: proto.url ?? "",
+      twitter: proto.twitter ?? null,
+      riskFactors,
+      safetyScore
+    };
+    const tvlStr = tvl > 1e9 ? `$${(tvl / 1e9).toFixed(2)}B` : `$${(tvl / 1e6).toFixed(1)}M`;
+    const feesStr = fees24h != null ? ` | Fees 24h: $${fees24h.toLocaleString()}` : "";
+    return {
+      data: result,
+      displayText: `**${result.name}** (${category})
+TVL: ${tvlStr} (7d: ${tvlChange7d > 0 ? "+" : ""}${tvlChange7d.toFixed(1)}%)${feesStr}
+Chains: ${chains.join(", ")}
+Safety: ${safetyScore}
+Risks: ${riskFactors.join("; ")}`
+    };
+  }
+});
+var LLAMA_API2 = "https://api.llama.fi";
 var YIELDS_API = "https://yields.llama.fi";
 var COINS_API = "https://coins.llama.fi";
 var CACHE_TTL3 = 6e4;
@@ -1596,7 +1945,7 @@ var defillamaProtocolInfoTool = buildTool({
   },
   isReadOnly: true,
   async call(input) {
-    const data = await cachedFetch(`${LLAMA_API}/protocol/${encodeURIComponent(input.name)}`);
+    const data = await cachedFetch(`${LLAMA_API2}/protocol/${encodeURIComponent(input.name)}`);
     const result = {
       name: data.name,
       category: data.category,
@@ -1707,7 +2056,7 @@ var defillamaChainTvlTool = buildTool({
   },
   isReadOnly: true,
   async call(input) {
-    const data = await cachedFetch(`${LLAMA_API}/v2/chains`);
+    const data = await cachedFetch(`${LLAMA_API2}/v2/chains`);
     const sorted = [...data].sort((a, b) => b.tvl - a.tvl);
     const limit = input.limit ?? 10;
     const top = sorted.slice(0, limit);
@@ -1739,7 +2088,7 @@ var defillamaProtocolFeesTool = buildTool({
   },
   isReadOnly: true,
   async call(input) {
-    const data = await cachedFetch(`${LLAMA_API}/overview/fees`);
+    const data = await cachedFetch(`${LLAMA_API2}/overview/fees`);
     let protocols = data.protocols ?? [];
     if (input.chain) {
       const chain = input.chain.toLowerCase();
@@ -1777,7 +2126,7 @@ var defillamaSuiProtocolsTool = buildTool({
   isReadOnly: true,
   async call(input) {
     const limit = input.limit ?? 10;
-    const data = await cachedFetch(`${LLAMA_API}/protocols`);
+    const data = await cachedFetch(`${LLAMA_API2}/protocols`);
     const suiProtocols = data.filter((p) => p.chains?.includes("Sui") && p.tvl > 0).sort((a, b) => b.tvl - a.tvl).slice(0, limit);
     const results = suiProtocols.map((p) => ({
       name: p.name,
@@ -1802,6 +2151,10 @@ var READ_TOOLS = [
   swapQuoteTool,
   voloStatsTool,
   mppServicesTool,
+  webSearchTool,
+  explainTxTool,
+  portfolioAnalysisTool,
+  protocolDeepDiveTool,
   defillamaYieldPoolsTool,
   defillamaProtocolInfoTool,
   defillamaTokenPricesTool,
@@ -1858,9 +2211,9 @@ Only offer to execute actions you have tools for. If you retrieved a quote, data
 - "Swap then save": swap_execute \u2192 balance_check \u2192 save_deposit. Confirm each step.
 - "Buy $X of token": defillama_token_prices \u2192 calculate amount \u2192 swap_execute.
 - "Best yield on SUI": compare rates_info (NAVI lending) + defillama_yield_pools (broader) + volo_stats.
-- save_deposit supports any NAVI asset: USDC (default), USDT, SUI, WAL, ETH, NAVX, GOLD, USDe, USDsui. Pass asset param for non-USDC.
-- withdraw supports any deposited NAVI asset. Pass asset param to withdraw a specific token.
-- "Deposit WAL/ETH/SUI to earn yield": save_deposit with asset="WAL"/"ETH"/"SUI" for NAVI lending, or volo_stake for SUI liquid staking.
+- save_deposit supports: USDC (default), USDT, SUI, USDe, USDsui. Pass asset param for non-USDC.
+- withdraw supports: USDC, USDT, SUI, USDe, USDsui. Pass asset param to withdraw a specific token.
+- "Deposit SUI to earn yield": save_deposit with asset="SUI" for NAVI lending, or volo_stake for SUI liquid staking.
 - "What protocols are on Sui?": defillama_sui_protocols \u2192 defillama_protocol_info for details.
 
 ## Safety
@@ -3096,6 +3449,6 @@ function sanitizeAnthropicMessages(messages) {
   return merged;
 }
 
-export { AnthropicProvider, CostTracker, DEFAULT_SYSTEM_PROMPT, McpClientManager, McpResponseCache, MemorySessionStore, NAVI_MCP_CONFIG, NAVI_MCP_URL, NAVI_SERVER_NAME, NaviTools, QueryEngine, READ_TOOLS, TxMutex, WRITE_TOOLS, 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, mppServicesTool, parseMcpJson, parseSSE, payApiTool, ratesInfoTool, registerEngineTools, repayDebtTool, requireAgent, runTools, saveContactTool, saveDepositTool, savingsInfoTool, sendTransferTool, serializeSSE, swapExecuteTool, swapQuoteTool, toolsToDefinitions, transactionHistoryTool, transformBalance, transformHealthFactor, transformPositions, transformRates, transformRewards, transformSavings, validateHistory, voloStakeTool, voloStatsTool, voloUnstakeTool, withdrawTool };
+export { AnthropicProvider, CostTracker, DEFAULT_SYSTEM_PROMPT, McpClientManager, McpResponseCache, MemorySessionStore, NAVI_MCP_CONFIG, NAVI_MCP_URL, NAVI_SERVER_NAME, NaviTools, QueryEngine, READ_TOOLS, TxMutex, WRITE_TOOLS, adaptAllMcpTools, adaptAllServerTools, adaptMcpTool, balanceCheckTool, borrowTool, buildMcpTools, buildTool, claimRewardsTool, clearPriceCache, compactMessages, defillamaChainTvlTool, defillamaPriceChangeTool, defillamaProtocolFeesTool, defillamaProtocolInfoTool, defillamaSuiProtocolsTool, defillamaTokenPricesTool, defillamaYieldPoolsTool, engineToSSE, estimateTokens, explainTxTool, extractMcpText, fetchAvailableRewards, fetchBalance, fetchHealthFactor, fetchPositions, fetchProtocolStats, fetchRates, fetchSavings, fetchTokenPrices, fetchWalletCoins, findTool, getDefaultTools, getMcpManager, getWalletAddress, hasNaviMcp, healthCheckTool, mppServicesTool, parseMcpJson, parseSSE, payApiTool, portfolioAnalysisTool, protocolDeepDiveTool, ratesInfoTool, registerEngineTools, repayDebtTool, requireAgent, runTools, saveContactTool, saveDepositTool, savingsInfoTool, sendTransferTool, serializeSSE, swapExecuteTool, swapQuoteTool, toolsToDefinitions, transactionHistoryTool, transformBalance, transformHealthFactor, transformPositions, transformRates, transformRewards, transformSavings, validateHistory, voloStakeTool, voloStatsTool, voloUnstakeTool, webSearchTool, withdrawTool };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map