@t2000/engine 0.54.0 → 0.54.1

package/dist/index.d.ts

@@ -2274,6 +2274,20 @@ interface PortfolioResult {
     totalValue: number;
     walletValue: number;
     savingsValue: number;
+    /**
+     * [Bug — 2026-04-28] Aggregated DeFi value across non-NAVI protocols
+     * (Cetus LPs, Bluefin, Suilend, etc.) — same field that's been on
+     * `balance_check` since v0.50. Pre-fix this tool ignored DeFi entirely:
+     * a wallet with $1,569 in Cetus LPs reported a $228 totalValue
+     * (wallet only), under-counting net worth by 87% and prompting the LLM
+     * to misclassify the wallet as "concentrated in FAITH" when actually
+     * the bulk was in liquidity pools. Same SSOT-divergence class the v0.54
+     * cache work fixed for FullPortfolioCanvas, manifesting in a different
+     * tool that was written before DeFi support was bolted on.
+     */
+    defiValue: number;
+    /** Provenance of the DeFi read — used by the UI card to caveat partial/degraded. */
+    defiSource: DefiSummary['source'];
     debtValue: number;
     healthFactor: number | null;
     allocations: AssetAllocation[];
@@ -2508,12 +2522,21 @@ interface AudricPortfolioResult {
     portfolio: AddressPortfolio;
     /** NAVI lending positions, normalized to the engine's `ServerPositionData`. */
     positions: ServerPositionData;
-    /** Net worth derived audric-side (`wallet + savings - borrows`). */
+    /** Net worth derived audric-side (`wallet + savings + defi - borrows`). */
     netWorthUsd: number;
     /** `savings * savingsRate / 365`, capped at 0. */
     estimatedDailyYield: number;
     /** Per-symbol balance map — convenient for adapters that already used `WalletBalances`. */
     walletAllocations: Record<string, number>;
+    /**
+     * [Bug — 2026-04-28] Aggregated DeFi value (Cetus LPs, Bluefin, Suilend,
+     * etc.) when available. `defiSource === 'degraded'` when audric's wire
+     * didn't include the field — callers should treat that as "fall back to
+     * a direct fetchAddressDefiPortfolio call" (same convention used
+     * inside the audric web app's UI components).
+     */
+    defiValueUsd: number;
+    defiSource: DefiSummary['source'];
 }
 /**
  * Fetch the canonical portfolio snapshot from audric. Returns `null` if

package/dist/index.js

@@ -1243,7 +1243,14 @@ async function fetchAudricPortfolio(address, env, signal) {
       positions,
       netWorthUsd: json.netWorthUsd ?? portfolio.totalUsd + positions.savings - positions.borrows,
       estimatedDailyYield: json.estimatedDailyYield ?? 0,
-      walletAllocations: json.walletAllocations ?? {}
+      walletAllocations: json.walletAllocations ?? {},
+      // Default to 'degraded' (not 'partial') when the wire shape lacks
+      // DeFi: 'partial' implies "we tried and got partial data" which is
+      // misleading for a route that simply doesn't return the field.
+      // Callers that need DeFi must fall back to a direct fetch on
+      // 'degraded' — exactly the convention BalanceCard already uses.
+      defiValueUsd: typeof json.defiValueUsd === "number" ? json.defiValueUsd : 0,
+      defiSource: json.defiSource ?? "degraded"
     };
   } catch (err) {
     console.warn(`[audric-api] portfolio ${address.slice(0, 10)} fetch failed:`, err);
@@ -1932,10 +1939,25 @@ var STABLECOIN_SYMBOLS2 = /* @__PURE__ */ new Set([
 function isStable(symbol) {
   return STABLECOIN_SYMBOLS2.has(symbol.toLowerCase());
 }
+var TOKEN_ALIASES = {
+  usdt: ["usdt", "wusdt", "suiusdt"],
+  usdc: ["usdc", "wusdc"],
+  usde: ["usde", "suiusde", "sui_usde"],
+  usdsui: ["usdsui"]
+};
+function expandAliases(symbols) {
+  const out = /* @__PURE__ */ new Set();
+  for (const s of symbols) {
+    const norm = s.toLowerCase();
+    const aliases = TOKEN_ALIASES[norm] ?? [norm];
+    for (const a of aliases) out.add(a);
+  }
+  return out;
+}
 function applyFilters(rates, opts) {
   let entries = Object.entries(rates);
   if (opts.assets && opts.assets.length) {
-    const wanted = new Set(opts.assets.map((a) => a.toLowerCase()));
+    const wanted = expandAliases(opts.assets);
     entries = entries.filter(([sym]) => wanted.has(sym.toLowerCase()));
   } else if (opts.stableOnly) {
     entries = entries.filter(([sym]) => isStable(sym));
@@ -3277,7 +3299,7 @@ var portfolioAnalysisTool = buildTool({
       context.signal
     );
     const apiUrl = context.env?.AUDRIC_INTERNAL_API_URL;
-    const [portfolio, positions, weekHistResult] = await Promise.all([
+    const [portfolio, positions, weekHistResult, defiSummary] = await Promise.all([
       audricSnapshot ? Promise.resolve(audricSnapshot.portfolio) : (async () => {
         if (context.portfolioCache) {
           const hit = context.portfolioCache.get(address);
@@ -3306,7 +3328,23 @@ var portfolioAnalysisTool = buildTool({
       apiUrl ? fetch(
         `${apiUrl}/api/analytics/portfolio-history?days=7`,
         { headers: { "x-sui-address": address }, signal: context.signal }
-      ).then((res) => res.ok ? res.json() : null).catch(() => null) : Promise.resolve(null)
+      ).then((res) => res.ok ? res.json() : null).catch(() => null) : Promise.resolve(null),
+      // DeFi fetch — prefer the audric snapshot's already-computed value
+      // (when present and not 'degraded'), otherwise call the engine's
+      // direct aggregator. The 'degraded' check prevents the audric
+      // path from masking a useful direct read when the audric route's
+      // own DeFi field came back empty.
+      audricSnapshot && audricSnapshot.defiSource !== "degraded" ? Promise.resolve({
+        totalUsd: audricSnapshot.defiValueUsd,
+        perProtocol: {},
+        pricedAt: Date.now(),
+        source: audricSnapshot.defiSource
+      }) : fetchAddressDefiPortfolio(address, context.blockvisionApiKey).catch(
+        (err) => {
+          console.warn("[portfolio_analysis] defi fetch failed:", err);
+          return { totalUsd: 0, perProtocol: {}, pricedAt: Date.now(), source: "degraded" };
+        }
+      )
     ]);
     let walletValue = 0;
     const allAllocations = [];
@@ -3336,7 +3374,18 @@ var portfolioAnalysisTool = buildTool({
     if (weekHistResult?.change && weekHistResult.change.absoluteUsd !== 0) {
       weekChange = weekHistResult.change;
     }
-    const totalValue = walletValue + savingsValue;
+    const defiValue = defiSummary.totalUsd;
+    if (defiSummary.source !== "degraded") {
+      for (const [protocol, usdValue] of Object.entries(defiSummary.perProtocol)) {
+        if (typeof usdValue === "number" && usdValue >= DUST_USD) {
+          const label = protocol.charAt(0).toUpperCase() + protocol.slice(1) + " DeFi";
+          allocations.push({ symbol: label, amount: 0, usdValue, percentage: 0 });
+        }
+      }
+    } else if (defiValue > 0) {
+      allocations.push({ symbol: "DeFi (aggregate)", amount: 0, usdValue: defiValue, percentage: 0 });
+    }
+    const totalValue = walletValue + savingsValue + defiValue;
     for (const a of allocations) {
       a.percentage = totalValue > 0 ? a.usdValue / totalValue * 100 : 0;
     }
@@ -3374,10 +3423,23 @@ var portfolioAnalysisTool = buildTool({
         message: "Portfolio is concentrated in a single asset."
       });
     }
+    if (defiSummary.source === "degraded") {
+      insights.push({
+        type: "warning",
+        message: "DeFi positions could not be loaded \u2014 total may under-count any Cetus/Bluefin/Suilend value."
+      });
+    } else if (defiSummary.source === "partial") {
+      insights.push({
+        type: "warning",
+        message: "DeFi data is partial \u2014 at least one protocol failed; total may under-count."
+      });
+    }
     const result = {
       totalValue,
       walletValue,
       savingsValue,
+      defiValue,
+      defiSource: defiSummary.source,
       debtValue,
       healthFactor,
       allocations: allocations.slice(0, 10),
@@ -3388,7 +3450,8 @@ var portfolioAnalysisTool = buildTool({
       weekChange,
       priceSource: portfolio.source
     };
-    const topLine = `Total: $${totalValue.toFixed(2)} | Wallet: $${walletValue.toFixed(2)} | Savings: $${savingsValue.toFixed(2)}`;
+    const defiSegment = defiValue > 0 ? ` | DeFi: $${defiValue.toFixed(2)}${defiSummary.source === "partial" ? " (partial)" : ""}` : "";
+    const topLine = `Total: $${totalValue.toFixed(2)} | Wallet: $${walletValue.toFixed(2)} | Savings: $${savingsValue.toFixed(2)}${defiSegment}`;
     const insightLines = insights.map((i) => `${i.type === "warning" ? "\u26A0" : "\u2192"} ${i.message}`).join("\n");
     return {
       data: result,