@t2000/engine 1.1.0 → 1.2.0

package/dist/index.js

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { ALL_NAVI_ASSETS, getDecimalsForCoinType, resolveSymbol, normalizeCoinType, assertAllowedAsset, SUPPORTED_ASSETS, getSwapQuote, extractTransferDetails, classifyTransaction } from '@t2000/sdk';
+import { ALL_NAVI_ASSETS, getDecimalsForCoinType, resolveSymbol, isInRegistry, normalizeCoinType, assertAllowedAsset, SUPPORTED_ASSETS, getSwapQuote, extractTransferDetails, classifyTransaction } from '@t2000/sdk';
 import { randomUUID } from 'crypto';
 import { readdirSync, readFileSync } from 'fs';
 import { join } from 'path';
@@ -920,7 +920,7 @@ async function fetchPortfolioFromBlockVision(address, apiKey) {
   const rawCoins = json.result.coins ?? [];
   const coins = rawCoins.map((c) => {
     const coinType = c.coinType;
-    const symbol = c.symbol || resolveSymbol(coinType);
+    const symbol = isInRegistry(coinType) ? resolveSymbol(coinType) : c.symbol || resolveSymbol(coinType);
     const decimals = typeof c.decimals === "number" ? c.decimals : getDecimalsForCoinType(coinType);
     const stablePrice = STABLE_USD_PRICES[coinType];
     const apiPrice = parseNumberOrNull(c.price);
@@ -1642,9 +1642,96 @@ async function fetchAudricHistory(address, opts, env, signal) {
   }
 }
 
+// src/sui-address.ts
+var SUI_MAINNET_URL2 = "https://fullnode.mainnet.sui.io:443";
+var SUI_ADDRESS_REGEX = /^0x[a-fA-F0-9]{1,64}$/i;
+var SUI_ADDRESS_STRICT_REGEX = /^0x[a-fA-F0-9]{64}$/i;
+var SUINS_NAME_REGEX = /^[a-z0-9-]+(\.[a-z0-9-]+)*\.sui$/;
+var InvalidAddressError = class extends Error {
+  constructor(raw) {
+    super(
+      `"${raw}" isn't a valid Sui address or SuiNS name. Pass a 0x-prefixed hex address (e.g. 0x40cd\u20263e62) or a SuiNS name ending in .sui (e.g. alex.sui).`
+    );
+    this.raw = raw;
+    this.name = "InvalidAddressError";
+  }
+};
+var SuinsNotRegisteredError = class extends Error {
+  constructor(name_) {
+    super(
+      `"${name_}" isn't a registered SuiNS name. Double-check the spelling, or paste the full Sui address (0x\u2026 64 hex characters).`
+    );
+    this.name_ = name_;
+    this.name = "SuinsNotRegisteredError";
+  }
+};
+var SuinsRpcError = class extends Error {
+  constructor(name_, detail) {
+    super(`SuiNS lookup failed for "${name_}" (${detail}). Try again, or paste the full Sui address.`);
+    this.name_ = name_;
+    this.name = "SuinsRpcError";
+  }
+};
+function looksLikeSuiNs(value) {
+  if (!value) return false;
+  return SUINS_NAME_REGEX.test(value.trim().toLowerCase());
+}
+async function resolveSuinsViaRpc(rawName, ctx = {}) {
+  const name = rawName.trim().toLowerCase();
+  if (!SUINS_NAME_REGEX.test(name)) {
+    throw new InvalidAddressError(rawName);
+  }
+  const url = ctx.suiRpcUrl || SUI_MAINNET_URL2;
+  let res;
+  try {
+    res = await fetch(url, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({
+        jsonrpc: "2.0",
+        id: 1,
+        method: "suix_resolveNameServiceAddress",
+        params: [name]
+      }),
+      signal: ctx.signal ?? AbortSignal.timeout(8e3)
+    });
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    throw new SuinsRpcError(name, msg);
+  }
+  if (!res.ok) {
+    throw new SuinsRpcError(name, `HTTP ${res.status}`);
+  }
+  let body;
+  try {
+    body = await res.json();
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    throw new SuinsRpcError(name, `JSON parse failed: ${msg}`);
+  }
+  if (body.error) {
+    throw new SuinsRpcError(name, body.error.message);
+  }
+  return body.result ?? null;
+}
+async function normalizeAddressInput(value, ctx = {}) {
+  const trimmed = value.trim();
+  if (SUI_ADDRESS_REGEX.test(trimmed)) {
+    return { address: trimmed.toLowerCase(), suinsName: null, raw: value };
+  }
+  if (looksLikeSuiNs(trimmed)) {
+    const name = trimmed.toLowerCase();
+    const address = await resolveSuinsViaRpc(name, ctx);
+    if (!address) {
+      throw new SuinsNotRegisteredError(name);
+    }
+    return { address: address.toLowerCase(), suinsName: name, raw: value };
+  }
+  throw new InvalidAddressError(value);
+}
+
 // src/tools/balance.ts
 var GAS_RESERVE_SUI2 = 0.05;
-var SUI_ADDRESS_REGEX = /^0x[a-fA-F0-9]{1,64}$/;
 var VSUI_COIN_TYPE = "0x549e8b69270defbfafd4f94e17ec44cdbdd99820b33bda2278dea3b9a32d3f55::cert::CERT";
 var SUI_COIN_TYPE = "0x2::sui::SUI";
 var VSUI_FALLBACK_RATE = 1.05;
@@ -1696,17 +1783,16 @@ async function loadPortfolio(address, blockvisionApiKey, fallbackRpcUrl, cache)
 }
 var balanceCheckTool = buildTool({
   name: "balance_check",
-  description: "Get the full balance breakdown for the signed-in user OR any public Sui address. Returns wallet holdings (tokens the address owns \u2014 NOT savings), NAVI savings deposits (USDC and/or USDsui deposited into NAVI Protocol earning yield), outstanding debt, pending rewards, gas reserve, total net worth, saveableUsdc (USDC wallet balance available to save), and saveableUsdsui (USDsui wallet balance available to save \u2014 surfaces only when > 0). IMPORTANT: wallet holdings like GOLD, SUI, USDT, USDe are NOT savings positions and are NOT saveable \u2014 only USDC and USDsui can be saved/borrowed. Pass `address` to inspect a contact / watched / public wallet; defaults to the signed-in user when omitted.",
+  description: 'Get the full balance breakdown for the signed-in user OR any public Sui address or SuiNS name. Returns wallet holdings (tokens the address owns \u2014 NOT savings), NAVI savings deposits (USDC and/or USDsui deposited into NAVI Protocol earning yield), outstanding debt, pending rewards, gas reserve, total net worth, saveableUsdc (USDC wallet balance available to save), and saveableUsdsui (USDsui wallet balance available to save \u2014 surfaces only when > 0). IMPORTANT: wallet holdings like GOLD, SUI, USDT, USDe are NOT savings positions and are NOT saveable \u2014 only USDC and USDsui can be saved/borrowed. Pass `address` as a 0x address OR a SuiNS name (e.g. "alex.sui") to inspect a contact / watched / public wallet; defaults to the signed-in user when omitted.',
   inputSchema: z.object({
-    address: z.string().regex(SUI_ADDRESS_REGEX).optional().describe("Sui address to inspect (defaults to the signed-in wallet)")
+    address: z.string().optional().describe("Sui address (0x\u2026) or SuiNS name (alex.sui). Defaults to the signed-in wallet when omitted.")
   }),
   jsonSchema: {
     type: "object",
     properties: {
       address: {
         type: "string",
-        pattern: "^0x[a-fA-F0-9]{1,64}$",
-        description: "Sui address to inspect (defaults to the signed-in wallet)"
+        description: "Sui address (0x\u2026) or SuiNS name (e.g. alex.sui). The engine resolves the name to an on-chain address before querying. Omit to default to the signed-in wallet."
       }
     },
     required: []
@@ -1718,7 +1804,18 @@ var balanceCheckTool = buildTool({
   // calls — each one reflects a different on-chain + market snapshot.
   cacheable: false,
   async call(input, context) {
-    const targetAddress = input.address ?? context.walletAddress;
+    let suinsName = null;
+    let targetAddress;
+    if (input.address) {
+      const normalized = await normalizeAddressInput(input.address, {
+        suiRpcUrl: context.suiRpcUrl,
+        signal: context.signal
+      });
+      targetAddress = normalized.address;
+      suinsName = normalized.suinsName;
+    } else {
+      targetAddress = context.walletAddress;
+    }
     const isSelfQuery = !!context.walletAddress && !!targetAddress && targetAddress.toLowerCase() === context.walletAddress.toLowerCase();
     if (hasNaviMcpGlobal(context)) {
       if (!targetAddress) {
@@ -1850,10 +1947,12 @@ var balanceCheckTool = buildTool({
         saveableUsdsui,
         priceSource: portfolio.source,
         address,
-        isSelfQuery
+        isSelfQuery,
+        suinsName
       };
       const holdingsList = visibleHoldings.map((h) => `${h.symbol}: ${h.balance < 1 ? h.balance.toFixed(6) : h.balance.toFixed(2)} ($${h.usdValue.toFixed(2)})`).join(", ");
-      const subjectPrefix = isSelfQuery ? "Balance" : `Balance for ${address.slice(0, 6)}\u2026${address.slice(-4)}`;
+      const subjectLabel = suinsName ?? `${address.slice(0, 6)}\u2026${address.slice(-4)}`;
+      const subjectPrefix = isSelfQuery ? "Balance" : `Balance for ${subjectLabel}`;
       const defiSummaryText = (() => {
         if (defi2.source === "degraded") {
           return ' DeFi positions (Bluefin / Suilend / Cetus / etc.): UNAVAILABLE \u2014 DeFi data source is currently unreachable. Do NOT assert "no DeFi positions"; tell the user this slice is temporarily unknown and the total above EXCLUDES DeFi.';
@@ -1877,9 +1976,9 @@ var balanceCheckTool = buildTool({
         displayText: `${subjectPrefix}: $${bal.total.toFixed(2)} total. Wallet holdings (NOT savings): ${holdingsList || "none"}. NAVI savings deposits: $${bal.savings.toFixed(2)}.${defiSummaryText} ${saveableSummary}`
       };
     }
-    if (input.address && context.walletAddress && input.address.toLowerCase() !== context.walletAddress.toLowerCase()) {
+    if (targetAddress && context.walletAddress && targetAddress.toLowerCase() !== context.walletAddress.toLowerCase()) {
       throw new Error(
-        `Cannot inspect ${input.address.slice(0, 8)}\u2026 without NAVI MCP enabled. Configure NAVI MCP to enable third-party address reads.`
+        `Cannot inspect ${targetAddress.slice(0, 8)}\u2026 without NAVI MCP enabled. Configure NAVI MCP to enable third-party address reads.`
       );
     }
     const agent = requireAgent(context);
@@ -1941,7 +2040,8 @@ var balanceCheckTool = buildTool({
         saveableUsdc: sdkSaveableUsdc,
         saveableUsdsui: sdkSaveableUsdsui,
         address: targetAddress ?? "",
-        isSelfQuery: true
+        isSelfQuery: true,
+        suinsName
       },
       displayText: `Balance: $${sdkTotal.toFixed(2)} total. Wallet: $${balance.available.toFixed(2)} available. NAVI savings deposits: $${balance.savings.toFixed(2)}.${sdkDefiSummaryText} ${sdkSaveableUsdsui > 0 ? `Saveable: ${sdkSaveableUsdc.toFixed(2)} USDC + ${sdkSaveableUsdsui.toFixed(sdkSaveableUsdsui < 1 ? 4 : 2)} USDsui (only USDC and USDsui can be saved/borrowed).` : `Saveable USDC (only USDC and USDsui can be saved): ${sdkSaveableUsdc.toFixed(2)} USDC.`}`
     };
@@ -2173,7 +2273,6 @@ async function fetchProtocolStats(manager, opts) {
 
 // src/tools/savings.ts
 var DUST_THRESHOLD_USD = 0.01;
-var SUI_ADDRESS_REGEX2 = /^0x[a-fA-F0-9]{1,64}$/;
 function buildSavingsFromPositions(sp) {
   const positions = [
     ...sp.supplies.filter((s) => s.amountUsd >= DUST_THRESHOLD_USD).map((s) => ({
@@ -2215,11 +2314,12 @@ function buildSavingsFromPositions(sp) {
     }
   };
 }
-function formatSavingsDisplay(result, isSelfQuery = true, address) {
+function formatSavingsDisplay(result, isSelfQuery = true, address, suinsName) {
   const { positions, earnings, fundStatus } = result;
   const supplies = positions.filter((p) => p.type === "supply");
   const borrows = positions.filter((p) => p.type === "borrow");
-  const subjectPrefix = isSelfQuery || !address ? "" : `${address.slice(0, 6)}\u2026${address.slice(-4)} \u2014 `;
+  const subjectLabel = suinsName ?? (address ? `${address.slice(0, 6)}\u2026${address.slice(-4)}` : null);
+  const subjectPrefix = isSelfQuery || !subjectLabel ? "" : `${subjectLabel} \u2014 `;
   const lines = [];
   if (supplies.length > 0) {
     lines.push(`${subjectPrefix}Savings: $${fundStatus.supplied.toFixed(2)} at ${(earnings.currentApy * 100).toFixed(2)}% blended APY`);
@@ -2239,17 +2339,16 @@ function formatSavingsDisplay(result, isSelfQuery = true, address) {
 }
 var savingsInfoTool = buildTool({
   name: "savings_info",
-  description: "Get detailed savings positions and earnings for the signed-in user OR any public Sui address: current deposits by protocol, APY, total yield earned, daily earning rate, and projected monthly returns. Pass `address` to inspect a contact / watched / public wallet; defaults to the signed-in user when omitted.",
+  description: 'Get detailed savings positions and earnings for the signed-in user OR any public Sui address or SuiNS name: current deposits by protocol, APY, total yield earned, daily earning rate, and projected monthly returns. Pass `address` as a 0x address OR a SuiNS name (e.g. "alex.sui") to inspect a contact / watched / public wallet; defaults to the signed-in user when omitted.',
   inputSchema: z.object({
-    address: z.string().regex(SUI_ADDRESS_REGEX2).optional().describe("Sui address to inspect (defaults to the signed-in wallet)")
+    address: z.string().optional().describe("Sui address (0x\u2026) or SuiNS name (alex.sui). Defaults to the signed-in wallet when omitted.")
   }),
   jsonSchema: {
     type: "object",
     properties: {
       address: {
         type: "string",
-        pattern: "^0x[a-fA-F0-9]{1,64}$",
-        description: "Sui address to inspect (defaults to the signed-in wallet)"
+        description: "Sui address (0x\u2026) or SuiNS name (e.g. alex.sui). The engine resolves the name to an on-chain address before querying. Omit to default to the signed-in wallet."
       }
     },
     required: []
@@ -2259,23 +2358,34 @@ var savingsInfoTool = buildTool({
   // Each call reflects a fresh on-chain snapshot — never dedupe.
   cacheable: false,
   async call(input, context) {
-    const targetAddress = input.address ?? context.walletAddress;
+    let suinsName = null;
+    let targetAddress;
+    if (input.address) {
+      const normalized = await normalizeAddressInput(input.address, {
+        suiRpcUrl: context.suiRpcUrl,
+        signal: context.signal
+      });
+      targetAddress = normalized.address;
+      suinsName = normalized.suinsName;
+    } else {
+      targetAddress = context.walletAddress;
+    }
     const isSelfQuery = !!context.walletAddress && !!targetAddress && targetAddress.toLowerCase() === context.walletAddress.toLowerCase();
     if (context.positionFetcher && targetAddress) {
       const sp = await context.positionFetcher(targetAddress);
       const result2 = buildSavingsFromPositions(sp);
-      const stamped2 = { ...result2, address: targetAddress, isSelfQuery };
-      return { data: stamped2, displayText: formatSavingsDisplay(result2, isSelfQuery, targetAddress) };
+      const stamped2 = { ...result2, address: targetAddress, isSelfQuery, suinsName };
+      return { data: stamped2, displayText: formatSavingsDisplay(result2, isSelfQuery, targetAddress, suinsName) };
     }
     if (hasNaviMcpGlobal(context) && targetAddress) {
       const savings = await fetchSavings(getMcpManager(context), targetAddress);
       savings.positions = savings.positions.filter((p) => p.valueUsd >= DUST_THRESHOLD_USD);
-      const stamped2 = { ...savings, address: targetAddress, isSelfQuery };
-      return { data: stamped2, displayText: formatSavingsDisplay(savings, isSelfQuery, targetAddress) };
+      const stamped2 = { ...savings, address: targetAddress, isSelfQuery, suinsName };
+      return { data: stamped2, displayText: formatSavingsDisplay(savings, isSelfQuery, targetAddress, suinsName) };
     }
-    if (input.address && context.walletAddress && input.address.toLowerCase() !== context.walletAddress.toLowerCase()) {
+    if (targetAddress && context.walletAddress && targetAddress.toLowerCase() !== context.walletAddress.toLowerCase()) {
       throw new Error(
-        `Cannot inspect ${input.address.slice(0, 8)}\u2026 without NAVI MCP or a positionFetcher. Configure NAVI MCP to enable third-party address reads.`
+        `Cannot inspect ${targetAddress.slice(0, 8)}\u2026 without NAVI MCP or a positionFetcher. Configure NAVI MCP to enable third-party address reads.`
       );
     }
     const agent = requireAgent(context);
@@ -2309,11 +2419,10 @@ var savingsInfoTool = buildTool({
         projectedMonthly: fundStatus.projectedMonthly
       }
     };
-    const stamped = { ...result, address: targetAddress ?? "", isSelfQuery: true };
-    return { data: stamped, displayText: formatSavingsDisplay(result, true, void 0) };
+    const stamped = { ...result, address: targetAddress ?? "", isSelfQuery: true, suinsName };
+    return { data: stamped, displayText: formatSavingsDisplay(result, true, void 0, suinsName) };
   }
 });
-var SUI_ADDRESS_REGEX3 = /^0x[a-fA-F0-9]{1,64}$/;
 var DEBT_DUST_USD = 0.01;
 function hfStatus(hf, borrowed) {
   if (borrowed <= DEBT_DUST_USD) return "healthy";
@@ -2327,8 +2436,9 @@ function serializeHf(hf, borrowed) {
   if (hf == null || !Number.isFinite(hf)) return null;
   return hf;
 }
-function displayHfText(hf, borrowed, status, isSelfQuery = true, address) {
-  const subject = isSelfQuery || !address ? "Health Factor" : `Health Factor for ${address.slice(0, 6)}\u2026${address.slice(-4)}`;
+function displayHfText(hf, borrowed, status, isSelfQuery = true, address, suinsName) {
+  const subjectLabel = suinsName ?? (address ? `${address.slice(0, 6)}\u2026${address.slice(-4)}` : null);
+  const subject = isSelfQuery || !subjectLabel ? "Health Factor" : `Health Factor for ${subjectLabel}`;
   if (hf == null) {
     return `${subject}: \u221E (${status} \u2014 no debt)`;
   }
@@ -2336,17 +2446,16 @@ function displayHfText(hf, borrowed, status, isSelfQuery = true, address) {
 }
 var healthCheckTool = buildTool({
   name: "health_check",
-  description: 'Check the lending health factor for the signed-in user OR any public Sui address: current HF ratio, total supplied collateral, total borrowed, max additional borrow capacity, and liquidation threshold. HF < 1.5 is risky, < 1.2 is critical. When the address has no debt the tool returns healthFactor=null (semantically infinity) \u2014 render that as "Healthy" / \u221E, never as 0 or "Critical". Pass `address` to inspect a contact / watched / public wallet; defaults to the signed-in user when omitted.',
+  description: 'Check the lending health factor for the signed-in user OR any public Sui address or SuiNS name: current HF ratio, total supplied collateral, total borrowed, max additional borrow capacity, and liquidation threshold. HF < 1.5 is risky, < 1.2 is critical. When the address has no debt the tool returns healthFactor=null (semantically infinity) \u2014 render that as "Healthy" / \u221E, never as 0 or "Critical". Pass `address` as a 0x address OR a SuiNS name (e.g. "alex.sui") to inspect a contact / watched / public wallet; defaults to the signed-in user when omitted.',
   inputSchema: z.object({
-    address: z.string().regex(SUI_ADDRESS_REGEX3).optional().describe("Sui address to inspect (defaults to the signed-in wallet)")
+    address: z.string().optional().describe("Sui address (0x\u2026) or SuiNS name (alex.sui). Defaults to the signed-in wallet when omitted.")
   }),
   jsonSchema: {
     type: "object",
     properties: {
       address: {
         type: "string",
-        pattern: "^0x[a-fA-F0-9]{1,64}$",
-        description: "Sui address to inspect (defaults to the signed-in wallet)"
+        description: "Sui address (0x\u2026) or SuiNS name (e.g. alex.sui). The engine resolves the name to an on-chain address before querying. Omit to default to the signed-in wallet."
       }
     },
     required: []
@@ -2356,7 +2465,18 @@ var healthCheckTool = buildTool({
   // movement and even passively as oracle prices update. Never dedupe.
   cacheable: false,
   async call(input, context) {
-    const targetAddress = input.address ?? context.walletAddress;
+    let suinsName = null;
+    let targetAddress;
+    if (input.address) {
+      const normalized = await normalizeAddressInput(input.address, {
+        suiRpcUrl: context.suiRpcUrl,
+        signal: context.signal
+      });
+      targetAddress = normalized.address;
+      suinsName = normalized.suinsName;
+    } else {
+      targetAddress = context.walletAddress;
+    }
     const isSelfQuery = !!context.walletAddress && !!targetAddress && targetAddress.toLowerCase() === context.walletAddress.toLowerCase();
     if (context.positionFetcher && targetAddress) {
       const sp = await context.positionFetcher(targetAddress);
@@ -2373,9 +2493,10 @@ var healthCheckTool = buildTool({
           liquidationThreshold: 0,
           status: status2,
           address: targetAddress,
-          isSelfQuery
+          isSelfQuery,
+          suinsName
         },
-        displayText: displayHfText(transportHf2, borrowed2, status2, isSelfQuery, targetAddress)
+        displayText: displayHfText(transportHf2, borrowed2, status2, isSelfQuery, targetAddress, suinsName)
       };
     }
     if (hasNaviMcpGlobal(context) && targetAddress) {
@@ -2384,13 +2505,13 @@ var healthCheckTool = buildTool({
       const status2 = hfStatus(hf2.healthFactor, borrowed2);
       const transportHf2 = serializeHf(hf2.healthFactor, borrowed2);
       return {
-        data: { ...hf2, healthFactor: transportHf2, status: status2, address: targetAddress, isSelfQuery },
-        displayText: displayHfText(transportHf2, borrowed2, status2, isSelfQuery, targetAddress)
+        data: { ...hf2, healthFactor: transportHf2, status: status2, address: targetAddress, isSelfQuery, suinsName },
+        displayText: displayHfText(transportHf2, borrowed2, status2, isSelfQuery, targetAddress, suinsName)
       };
     }
-    if (input.address && context.walletAddress && input.address.toLowerCase() !== context.walletAddress.toLowerCase()) {
+    if (targetAddress && context.walletAddress && targetAddress.toLowerCase() !== context.walletAddress.toLowerCase()) {
       throw new Error(
-        `Cannot inspect ${input.address.slice(0, 8)}\u2026 without NAVI MCP or a positionFetcher. Configure NAVI MCP to enable third-party address reads.`
+        `Cannot inspect ${targetAddress.slice(0, 8)}\u2026 without NAVI MCP or a positionFetcher. Configure NAVI MCP to enable third-party address reads.`
       );
     }
     const agent = requireAgent(context);
@@ -2407,9 +2528,10 @@ var healthCheckTool = buildTool({
         liquidationThreshold: hf.liquidationThreshold,
         status,
         address: targetAddress ?? "",
-        isSelfQuery: true
+        isSelfQuery: true,
+        suinsName
       },
-      displayText: displayHfText(transportHf, borrowed, status, true, void 0)
+      displayText: displayHfText(transportHf, borrowed, status, true, void 0, suinsName)
     };
   }
 });
@@ -2633,14 +2755,13 @@ async function queryHistoryByDate(rpcUrl, address, targetDate, limit) {
 }
 var HISTORY_ACTIONS = ["send", "lending", "swap", "transaction"];
 var DEFAULT_LOOKBACK_DAYS = 30;
-var SUI_ADDRESS_REGEX4 = /^0x[0-9a-fA-F]{64}$/;
 var transactionHistoryTool = buildTool({
   name: "transaction_history",
   description: 'Retrieve recent transaction history (last 30 days by default): sends, saves, withdrawals, borrows, repayments, swaps, and rewards claims. Renders a rich transaction card.\n\nBy default, queries the SIGNED-IN USER\'S history. To inspect another wallet (a saved contact, a watched address, any public Sui address), pass `address` \u2014 e.g. user asks "show funkii\'s recent transactions" with funkii at 0x40cd\u20263e62, call with `address: "0x40cd\u20263e62"`. To filter the user\'s own history to a specific counterparty (user asks "show transactions WITH funkii"), pass `counterparty` \u2014 keeps the query rooted in the user\'s wallet but shows only rows where funkii is the recipient or sender.\n\nFilter args: `date` (YYYY-MM-DD), `action` (send/lending/swap), `minUsd` (minimum amount in USD \u2014 use this for "transactions over $X" instead of post-filtering), `assetSymbol` (e.g. "USDC", "SUI"), `direction` ("in" or "out"). The card itself respects all filters \u2014 never re-list the rows in narration.\n\nInternally queries both `FromAddress` and `ToAddress` filters in parallel and dedupes by digest, so pure-receive transactions (someone sends to the queried address with no balance-affecting outbound) are no longer dropped.',
   inputSchema: z.object({
     limit: z.number().int().min(1).max(50).optional(),
-    address: z.string().regex(SUI_ADDRESS_REGEX4, "Must be a 0x-prefixed 64-hex Sui address").optional().describe("Sui address to query history FOR. When omitted, defaults to the signed-in user's wallet. Pass this when the user asks about a contact's, watched address's, or any other public wallet's history."),
-    counterparty: z.string().regex(SUI_ADDRESS_REGEX4, "Must be a 0x-prefixed 64-hex Sui address").optional().describe('Sui address to filter rows by \u2014 only transactions where the queried address sent to or received from this counterparty are returned. Use for "show transactions with <contact>" queries. Compares against `tx.recipient` (case-insensitive).'),
+    address: z.string().optional().describe(`Sui address (0x\u2026) or SuiNS name (e.g. "alex.sui") to query history FOR. When omitted, defaults to the signed-in user's wallet. Pass this when the user asks about a contact's, watched address's, or any other public wallet's history.`),
+    counterparty: z.string().optional().describe('Sui address (0x\u2026) or SuiNS name (e.g. "alex.sui") to filter rows by \u2014 only transactions where the queried address sent to or received from this counterparty are returned. Use for "show transactions with <contact>" queries. Compares against `tx.recipient` (case-insensitive).'),
     date: z.string().optional().describe("Specific date to search for transactions (YYYY-MM-DD format). Paginates back to find that day."),
     action: z.enum(HISTORY_ACTIONS).optional().describe("Filter by action: send, lending, swap, or transaction."),
     minUsd: z.number().min(0).optional().describe('Minimum transaction amount in USD. Use this for "transactions over $X" \u2014 the amount is converted to USD using the asset price snapshot.'),
@@ -2656,11 +2777,11 @@ var transactionHistoryTool = buildTool({
       },
       address: {
         type: "string",
-        description: "Sui address to query history FOR (defaults to the signed-in user when omitted). Use for queries about a contact's, watched address's, or any other wallet's history."
+        description: "Sui address (0x\u2026) or SuiNS name (e.g. alex.sui) to query history FOR (defaults to the signed-in user when omitted). The engine resolves SuiNS names to addresses before querying. Use for queries about a contact's, watched address's, or any other wallet's history."
       },
       counterparty: {
         type: "string",
-        description: 'Sui address to filter rows by \u2014 only transactions where the queried address sent to or received from this counterparty are returned. Use for "show transactions with <contact>" queries.'
+        description: 'Sui address (0x\u2026) or SuiNS name (e.g. alex.sui) to filter rows by \u2014 only transactions where the queried address sent to or received from this counterparty are returned. Use for "show transactions with <contact>" queries.'
       },
       date: {
         type: "string",
@@ -2734,8 +2855,20 @@ var transactionHistoryTool = buildTool({
     const assetSymbol = input.assetSymbol?.toLowerCase();
     const direction = input.direction;
     const minUsd = input.minUsd;
-    const counterpartyLower = input.counterparty?.toLowerCase();
-    const targetAddress = input.address ?? context.walletAddress;
+    const [normalizedAddress, normalizedCounterparty] = await Promise.all([
+      input.address ? normalizeAddressInput(input.address, {
+        suiRpcUrl: context.suiRpcUrl,
+        signal: context.signal
+      }) : Promise.resolve(null),
+      input.counterparty ? normalizeAddressInput(input.counterparty, {
+        suiRpcUrl: context.suiRpcUrl,
+        signal: context.signal
+      }) : Promise.resolve(null)
+    ]);
+    const suinsName = normalizedAddress?.suinsName ?? null;
+    const counterpartySuinsName = normalizedCounterparty?.suinsName ?? null;
+    const counterpartyLower = normalizedCounterparty?.address.toLowerCase();
+    const targetAddress = normalizedAddress?.address ?? context.walletAddress;
     const isSelfQuery = !!targetAddress && !!context.walletAddress && targetAddress.toLowerCase() === context.walletAddress.toLowerCase();
     const prices = context.tokenPrices;
     const priceFor2 = (sym) => {
@@ -2772,9 +2905,13 @@ var transactionHistoryTool = buildTool({
       minUsd: minUsd ?? null,
       assetSymbol: input.assetSymbol ?? null,
       direction: direction ?? null,
-      counterparty: input.counterparty ?? null,
+      // Pre-resolved counterparty address (for the LLM/UI). Original
+      // SuiNS name is preserved in `counterpartySuinsName` below.
+      counterparty: normalizedCounterparty?.address ?? null,
+      counterpartySuinsName,
       address: targetAddress ?? null,
-      isSelfQuery
+      isSelfQuery,
+      suinsName
     };
     if (context.agent) {
       if (input.address && !isSelfQuery) {
@@ -3761,23 +3898,37 @@ ${summary}`
   }
 });
 var inputSchema3 = z.object({
-  address: z.string().optional().describe("Sui address to analyze (defaults to connected wallet)")
+  address: z.string().optional().describe("Sui address (0x\u2026) or SuiNS name (alex.sui) to analyze. Defaults to the signed-in wallet when omitted.")
 });
 var STABLECOINS = /* @__PURE__ */ new Set(["USDC", "USDT", "USDe", "USDsui"]);
 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.",
+  description: 'Analyze portfolio allocation, risk exposure, and yield optimization for the signed-in user OR any public Sui address or SuiNS name. Shows asset breakdown, diversification score, health factor assessment, and actionable suggestions. Pass `address` as a 0x address OR a SuiNS name (e.g. "alex.sui") to analyze a contact / watched / public wallet.',
   inputSchema: inputSchema3,
   jsonSchema: {
     type: "object",
     properties: {
-      address: { type: "string", description: "Sui address to analyze (defaults to connected wallet)" }
+      address: {
+        type: "string",
+        description: "Sui address (0x\u2026) or SuiNS name (e.g. alex.sui). The engine resolves the name to an on-chain address before querying. Omit to default to the signed-in wallet."
+      }
     },
     required: []
   },
   isReadOnly: true,
   async call(input, context) {
-    const address = input.address ?? context.walletAddress;
+    let suinsName = null;
+    let address;
+    if (input.address) {
+      const normalized = await normalizeAddressInput(input.address, {
+        suiRpcUrl: context.suiRpcUrl,
+        signal: context.signal
+      });
+      address = normalized.address;
+      suinsName = normalized.suinsName;
+    } else {
+      address = context.walletAddress;
+    }
     if (!address) {
       throw new Error("No wallet address provided. Sign in first.");
     }
@@ -3956,7 +4107,10 @@ var portfolioAnalysisTool = buildTool({
       savingsApy,
       dailyEarning,
       weekChange,
-      priceSource: portfolio.source
+      priceSource: portfolio.source,
+      address,
+      isSelfQuery: !!context.walletAddress && address.toLowerCase() === context.walletAddress.toLowerCase(),
+      suinsName
     };
     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}`;
@@ -4422,15 +4576,26 @@ Always prefer the canvas for visualisation requests. After rendering, offer to e
   async call(input, context) {
     const { template, params } = input;
     const title = CANVAS_TITLES[template];
+    let suinsName = null;
+    let resolvedParamAddress = null;
+    if (params?.address) {
+      const normalized = await normalizeAddressInput(params.address, {
+        suiRpcUrl: context.suiRpcUrl,
+        signal: context.signal
+      });
+      resolvedParamAddress = normalized.address;
+      suinsName = normalized.suinsName;
+    }
     const resolveAddressTarget = () => {
-      const fromParams = params?.address;
+      const fromParams = resolvedParamAddress;
       const fromContext = context.walletAddress;
       const target = fromParams ?? fromContext ?? null;
       const isSelfRender = !!target && !!fromContext && target.toLowerCase() === fromContext.toLowerCase();
-      return { address: target, isSelfRender };
+      return { address: target, isSelfRender, suinsName };
     };
+    const formatAddrLabel = (address, suins) => suins ?? `${address.slice(0, 6)}\u2026${address.slice(-4)}`;
     if (template === "full_portfolio") {
-      const { address, isSelfRender } = resolveAddressTarget();
+      const { address, isSelfRender, suinsName: resolvedSuins } = resolveAddressTarget();
       if (!address) {
         return {
           data: {
@@ -4442,7 +4607,8 @@ Always prefer the canvas for visualisation requests. After rendering, offer to e
           displayText: "Full Portfolio requires an address."
         };
       }
-      const titleSuffix = isSelfRender ? "" : ` \u2014 ${address.slice(0, 6)}\u2026${address.slice(-4)}`;
+      const addrLabel = formatAddrLabel(address, resolvedSuins);
+      const titleSuffix = isSelfRender ? "" : ` \u2014 ${addrLabel}`;
       const pos = isSelfRender ? context.serverPositions : null;
       const rate = normalizeSavingsRate(pos?.savingsRate);
       const savings = pos?.savings ?? 0;
@@ -4456,40 +4622,42 @@ Always prefer the canvas for visualisation requests. After rendering, offer to e
             available: true,
             address,
             isSelfRender,
+            suinsName: resolvedSuins,
             currentSavings: savings,
             currentDebt: borrows,
             healthFactor: pos?.healthFactor ?? null,
             savingsRate: rate
           }
         },
-        displayText: isSelfRender ? `Opened Full Portfolio Overview.` : `Opened Full Portfolio Overview for ${address.slice(0, 6)}\u2026${address.slice(-4)}.`
+        displayText: isSelfRender ? `Opened Full Portfolio Overview.` : `Opened Full Portfolio Overview for ${addrLabel}.`
       };
     }
     if (template === "watch_address") {
-      const targetAddress = params?.address ?? "";
-      if (!targetAddress || !targetAddress.startsWith("0x")) {
+      const targetAddress = resolvedParamAddress ?? "";
+      if (!targetAddress) {
         return {
           data: {
             __canvas: true,
             template,
             title,
-            templateData: { available: false, message: "Please provide a valid Sui address to watch." }
+            templateData: { available: false, message: "Please provide a valid Sui address or SuiNS name to watch." }
           },
-          displayText: "No valid address provided. Ask the user for a Sui address."
+          displayText: "No valid address provided. Ask the user for a Sui address or SuiNS name."
         };
       }
+      const addrLabel = formatAddrLabel(targetAddress, suinsName);
       return {
         data: {
           __canvas: true,
           template,
-          title: `Watch ${targetAddress.slice(0, 6)}\u2026${targetAddress.slice(-4)}`,
-          templateData: { available: true, address: targetAddress }
+          title: `Watch ${addrLabel}`,
+          templateData: { available: true, address: targetAddress, suinsName }
         },
-        displayText: `Opened Watch Address canvas for ${targetAddress.slice(0, 6)}\u2026${targetAddress.slice(-4)}.`
+        displayText: `Opened Watch Address canvas for ${addrLabel}.`
       };
     }
     if (template === "portfolio_timeline") {
-      const { address, isSelfRender } = resolveAddressTarget();
+      const { address, isSelfRender, suinsName: resolvedSuins } = resolveAddressTarget();
       if (!address) {
         return {
           data: {
@@ -4501,7 +4669,8 @@ Always prefer the canvas for visualisation requests. After rendering, offer to e
           displayText: "Portfolio Timeline requires an address."
         };
       }
-      const titleSuffix = isSelfRender ? "" : ` \u2014 ${address.slice(0, 6)}\u2026${address.slice(-4)}`;
+      const addrLabel = formatAddrLabel(address, resolvedSuins);
+      const titleSuffix = isSelfRender ? "" : ` \u2014 ${addrLabel}`;
       return {
         data: {
           __canvas: true,
@@ -4510,14 +4679,15 @@ Always prefer the canvas for visualisation requests. After rendering, offer to e
           templateData: {
             available: true,
             address,
-            isSelfRender
+            isSelfRender,
+            suinsName: resolvedSuins
           }
         },
-        displayText: isSelfRender ? `Opened Portfolio Timeline. Shows your net worth, savings, and debt over time.` : `Opened Portfolio Timeline for ${address.slice(0, 6)}\u2026${address.slice(-4)}.`
+        displayText: isSelfRender ? `Opened Portfolio Timeline. Shows your net worth, savings, and debt over time.` : `Opened Portfolio Timeline for ${addrLabel}.`
       };
     }
     if (template === "spending_breakdown") {
-      const { address, isSelfRender } = resolveAddressTarget();
+      const { address, isSelfRender, suinsName: resolvedSuins } = resolveAddressTarget();
       if (!address) {
         return {
           data: {
@@ -4529,7 +4699,8 @@ Always prefer the canvas for visualisation requests. After rendering, offer to e
           displayText: "Spending Breakdown requires an address."
         };
       }
-      const titleSuffix = isSelfRender ? "" : ` \u2014 ${address.slice(0, 6)}\u2026${address.slice(-4)}`;
+      const addrLabel = formatAddrLabel(address, resolvedSuins);
+      const titleSuffix = isSelfRender ? "" : ` \u2014 ${addrLabel}`;
       return {
         data: {
           __canvas: true,
@@ -4538,14 +4709,15 @@ Always prefer the canvas for visualisation requests. After rendering, offer to e
           templateData: {
             available: true,
             address,
-            isSelfRender
+            isSelfRender,
+            suinsName: resolvedSuins
           }
         },
-        displayText: isSelfRender ? `Opened Spending Breakdown. Shows your service spending by category.` : `Opened Spending Breakdown for ${address.slice(0, 6)}\u2026${address.slice(-4)}.`
+        displayText: isSelfRender ? `Opened Spending Breakdown. Shows your service spending by category.` : `Opened Spending Breakdown for ${addrLabel}.`
       };
     }
     if (template === "activity_heatmap") {
-      const { address, isSelfRender } = resolveAddressTarget();
+      const { address, isSelfRender, suinsName: resolvedSuins } = resolveAddressTarget();
       if (!address) {
         return {
           data: {
@@ -4557,7 +4729,8 @@ Always prefer the canvas for visualisation requests. After rendering, offer to e
           displayText: "Activity Heatmap requires an address."
         };
       }
-      const titleSuffix = isSelfRender ? "" : ` \u2014 ${address.slice(0, 6)}\u2026${address.slice(-4)}`;
+      const addrLabel = formatAddrLabel(address, resolvedSuins);
+      const titleSuffix = isSelfRender ? "" : ` \u2014 ${addrLabel}`;
       return {
         data: {
           __canvas: true,
@@ -4566,10 +4739,11 @@ Always prefer the canvas for visualisation requests. After rendering, offer to e
           templateData: {
             available: true,
             address,
-            isSelfRender
+            isSelfRender,
+            suinsName: resolvedSuins
           }
         },
-        displayText: isSelfRender ? `Opened Activity Heatmap for your wallet. Click any day to explore transactions.` : `Opened Activity Heatmap for ${address.slice(0, 6)}\u2026${address.slice(-4)}. Click any day to explore that address's transactions.`
+        displayText: isSelfRender ? `Opened Activity Heatmap for your wallet. Click any day to explore transactions.` : `Opened Activity Heatmap for ${addrLabel}. Click any day to explore that address's transactions.`
       };
     }
     const positions = context.serverPositions;
@@ -4593,13 +4767,13 @@ Always prefer the canvas for visualisation requests. After rendering, offer to e
       };
     }
     if (template === "health_simulator") {
-      const { address: targetAddress, isSelfRender } = resolveAddressTarget();
+      const { address: targetAddress, isSelfRender, suinsName: resolvedSuins } = resolveAddressTarget();
       const seedFromPos = isSelfRender;
       const seedSavings = seedFromPos ? totalSavings : 0;
       const seedBorrows = seedFromPos ? totalBorrows : 0;
       const seedHf = seedFromPos ? healthFactor : null;
       const roundedDebt = seedBorrows >= 1 ? Math.round(seedBorrows) : seedBorrows > 0 ? parseFloat(seedBorrows.toFixed(4)) : 0;
-      const titleSuffix = !targetAddress || isSelfRender ? "" : ` \u2014 ${targetAddress.slice(0, 6)}\u2026${targetAddress.slice(-4)}`;
+      const titleSuffix = !targetAddress || isSelfRender ? "" : ` \u2014 ${formatAddrLabel(targetAddress, resolvedSuins)}`;
       return {
         data: {
           __canvas: true,
@@ -4609,6 +4783,7 @@ Always prefer the canvas for visualisation requests. After rendering, offer to e
             available: true,
             address: targetAddress ?? "",
             isSelfRender,
+            suinsName: resolvedSuins,
             initialCollateral: seedSavings > 0 ? Math.round(seedSavings) : 1500,
             initialDebt: roundedDebt > 0 ? roundedDebt : seedSavings > 0 ? 0 : 500,
             currentHf: seedHf
@@ -4729,13 +4904,12 @@ var yieldSummaryTool = buildTool({
     }
   }
 });
-var SUI_ADDRESS_REGEX5 = /^0x[a-fA-F0-9]{1,64}$/;
 var activitySummaryTool = buildTool({
   name: "activity_summary",
-  description: "Returns a categorised DeFi activity summary for the signed-in user OR any public Sui address: transaction count, breakdown by action type (saves, sends, borrows, repayments, swaps, payments), total moved, net savings change, and yield earned. Use when the user asks about activity, transaction history summary, or what someone has done recently. Pass `address` to inspect a contact / watched / public wallet; defaults to the signed-in user when omitted.",
+  description: 'Returns a categorised DeFi activity summary for the signed-in user OR any public Sui address or SuiNS name: transaction count, breakdown by action type (saves, sends, borrows, repayments, swaps, payments), total moved, net savings change, and yield earned. Use when the user asks about activity, transaction history summary, or what someone has done recently. Pass `address` as a 0x address OR a SuiNS name (e.g. "alex.sui") to inspect a contact / watched / public wallet; defaults to the signed-in user when omitted.',
   inputSchema: z.object({
     period: z.enum(["week", "month", "year", "all"]).optional().describe("Time period. Defaults to current month."),
-    address: z.string().regex(SUI_ADDRESS_REGEX5).optional().describe("Sui address to inspect (defaults to the signed-in wallet)")
+    address: z.string().optional().describe("Sui address (0x\u2026) or SuiNS name (alex.sui). Defaults to the signed-in wallet when omitted.")
   }),
   jsonSchema: {
     type: "object",
@@ -4743,8 +4917,7 @@ var activitySummaryTool = buildTool({
       period: { type: "string", enum: ["week", "month", "year", "all"] },
       address: {
         type: "string",
-        pattern: "^0x[a-fA-F0-9]{1,64}$",
-        description: "Sui address to inspect (defaults to the signed-in wallet)"
+        description: "Sui address (0x\u2026) or SuiNS name (e.g. alex.sui). The engine resolves the name to an on-chain address before querying. Omit to default to the signed-in wallet."
       }
     }
   },
@@ -4752,7 +4925,18 @@ var activitySummaryTool = buildTool({
   async call(input, context) {
     const period = input.period ?? "month";
     const apiUrl = context.env?.AUDRIC_INTERNAL_API_URL;
-    const targetAddress = input.address ?? context.walletAddress;
+    let suinsName = null;
+    let targetAddress;
+    if (input.address) {
+      const normalized = await normalizeAddressInput(input.address, {
+        suiRpcUrl: context.suiRpcUrl,
+        signal: context.signal
+      });
+      targetAddress = normalized.address;
+      suinsName = normalized.suinsName;
+    } else {
+      targetAddress = context.walletAddress;
+    }
     const isSelfQuery = !!context.walletAddress && !!targetAddress && targetAddress.toLowerCase() === context.walletAddress.toLowerCase();
     const empty = {
       period,
@@ -4762,7 +4946,8 @@ var activitySummaryTool = buildTool({
       netSavingsUsd: 0,
       yieldEarnedUsd: 0,
       address: targetAddress,
-      isSelfQuery
+      isSelfQuery,
+      suinsName
     };
     if (!apiUrl || !targetAddress) {
       return { data: empty, displayText: "Activity summary not available." };
@@ -4777,11 +4962,12 @@ var activitySummaryTool = buildTool({
         return { data: empty, displayText: `Could not fetch activity data (HTTP ${res.status}).` };
       }
       const raw = await res.json();
-      const data = { ...raw, address: targetAddress, isSelfQuery };
+      const data = { ...raw, address: targetAddress, isSelfQuery, suinsName };
       const sorted = [...data.byAction ?? []].sort((a, b) => b.count - a.count);
       const top = sorted.slice(0, 3).map((a) => `${a.action} (${a.count})`).join(", ");
       const periodLabel = data.period === "all" ? "all time" : `this ${data.period}`;
-      const subjectPrefix = isSelfQuery ? "" : `${targetAddress.slice(0, 6)}\u2026${targetAddress.slice(-4)} \u2014 `;
+      const subjectLabel = suinsName ?? `${targetAddress.slice(0, 6)}\u2026${targetAddress.slice(-4)}`;
+      const subjectPrefix = isSelfQuery ? "" : `${subjectLabel} \u2014 `;
       return {
         data,
         displayText: data.totalTransactions > 0 ? `${subjectPrefix}${data.totalTransactions} transactions ${periodLabel}. Top: ${top}. Total moved: $${data.totalMovedUsd.toFixed(2)}. Net savings: $${data.netSavingsUsd.toFixed(2)}.` : `${subjectPrefix}No activity recorded for ${periodLabel}.`
@@ -4791,6 +4977,67 @@ var activitySummaryTool = buildTool({
     }
   }
 });
+var inputSchema5 = z.object({
+  name: z.string().describe(
+    'A SuiNS name ending in `.sui` (e.g. "alex.sui", "team.alex.sui"). The engine resolves the name on-chain via Sui JSON-RPC.'
+  )
+});
+var resolveSuinsTool = buildTool({
+  name: "resolve_suins",
+  description: 'Resolve a SuiNS name (e.g. "alex.sui", "obehi.sui") to its on-chain Sui address. Use this whenever the user asks for the address of a `.sui` name, asks who owns a name, or wants to verify a SuiNS name is registered. Returns the 0x-prefixed 64-hex address, or `registered: false` when the name isn\'t registered. Never use `web_search` for this \u2014 web_search doesn\'t index SuiNS records, but this tool queries the canonical on-chain registry. NOTE: For lookup queries about money flows ("what\'s alex.sui\'s balance / portfolio / health / transactions"), call the relevant read tool directly with `address: "alex.sui"` \u2014 those tools normalize SuiNS names internally, so an explicit `resolve_suins` round-trip is wasted.',
+  inputSchema: inputSchema5,
+  jsonSchema: {
+    type: "object",
+    properties: {
+      name: {
+        type: "string",
+        description: 'A SuiNS name ending in .sui (e.g. "alex.sui"). The engine resolves it on-chain.'
+      }
+    },
+    required: ["name"]
+  },
+  isReadOnly: true,
+  // Names map to addresses on a per-block basis (registry can change).
+  // Cheap, deterministic for a given block — safe to dedupe within a turn.
+  cacheable: true,
+  preflight: (input) => {
+    const trimmed = input.name?.trim().toLowerCase();
+    if (!trimmed) {
+      return { valid: false, error: "name is required" };
+    }
+    if (!SUINS_NAME_REGEX.test(trimmed)) {
+      return {
+        valid: false,
+        error: `"${input.name}" doesn't look like a SuiNS name. Names must end in .sui and use only lowercase letters, digits, and hyphens (e.g. alex.sui).`
+      };
+    }
+    return { valid: true };
+  },
+  async call(input, context) {
+    const name = input.name.trim().toLowerCase();
+    let address;
+    try {
+      address = await resolveSuinsViaRpc(name, {
+        suiRpcUrl: context.suiRpcUrl,
+        signal: context.signal
+      });
+    } catch (err) {
+      if (err instanceof SuinsRpcError) {
+        throw err;
+      }
+      throw err;
+    }
+    const result = {
+      name,
+      address,
+      registered: address !== null
+    };
+    return {
+      data: result,
+      displayText: address ? `${name} \u2192 \`${address.slice(0, 10)}\u2026${address.slice(-6)}\`` : `${name} is not a registered SuiNS name.`
+    };
+  }
+});
 var tokenPricesTool = buildTool({
   name: "token_prices",
   description: 'Get current USD prices for Sui tokens, with optional 24h change. Accepts full coin type strings (e.g. "0x2::sui::SUI"). Returns price per token and (when requested) 24h change percentage. Use for "what is X worth?" or "did Y move today?". For balance + portfolio rendering, prefer balance_check / portfolio_analysis instead \u2014 they bundle the same prices into the standard cards.',
@@ -4872,7 +5119,8 @@ var READ_TOOLS = [
   createInvoiceTool,
   spendingAnalyticsTool,
   yieldSummaryTool,
-  activitySummaryTool
+  activitySummaryTool,
+  resolveSuinsTool
 ];
 var WRITE_TOOLS = [
   saveDepositTool,
@@ -5274,7 +5522,7 @@ function guardCostWarning(tool, _call, conversationText) {
     message: "This action has a monetary cost. Confirm the user is aware before proceeding."
   };
 }
-var SUI_ADDRESS_REGEX6 = /^0x[a-fA-F0-9]{64}$/;
+var SUI_ADDRESS_REGEX2 = /^0x[a-fA-F0-9]{64}$/;
 function normalizeAddress(addr) {
   return addr.trim().toLowerCase();
 }
@@ -5339,7 +5587,7 @@ function guardAddressSource(tool, call, userText, contacts, walletAddress) {
   if (!rawTo) {
     return { verdict: "pass", gate: "address_source", tier: "safety" };
   }
-  if (!SUI_ADDRESS_REGEX6.test(rawTo)) {
+  if (!SUI_ADDRESS_REGEX2.test(rawTo)) {
     return { verdict: "pass", gate: "address_source", tier: "safety" };
   }
   const normalizedTo = normalizeAddress(rawTo);
@@ -8268,6 +8516,6 @@ function sanitizeAnthropicMessages(messages) {
   return merged;
 }
 
-export { AnthropicProvider, BalanceTracker, CANVAS_TEMPLATES, ContextBudget, CostTracker, DEFAULT_GUARD_CONFIG, DEFAULT_LEASE_SEC, DEFAULT_PERMISSION_CONFIG, DEFAULT_POLL_BUDGET_MS, DEFAULT_POLL_INTERVAL_MS, DEFAULT_SYSTEM_PROMPT, EarlyToolDispatcher, InMemoryDefiCacheStore, InMemoryFetchLock, InMemoryNaviCacheStore, InMemoryWalletCacheStore, McpClientManager, McpResponseCache, MemorySessionStore, NAVI_ADDR_TTL_SEC, NAVI_MCP_CONFIG, NAVI_MCP_URL, NAVI_RATES_TTL_SEC, NAVI_SERVER_NAME, NaviTools, PERMISSION_PRESETS, QueryEngine, READ_TOOLS, RecipeRegistry, RetryTracker, TOOL_FLAGS, TOOL_MODIFIABLE_FIELDS, TxMutex, WRITE_TOOLS, _resetNaviCircuitBreaker, activitySummaryTool, adaptAllMcpTools, adaptAllServerTools, adaptMcpTool, applyToolFlags, awaitOrFetch, balanceCheckTool, borrowTool, budgetToolResult, buildCachedSystemPrompt, buildMcpTools, buildProactivenessInstructions, buildProfileContext, buildSelfEvaluationInstruction, buildStateContext, buildTool, claimRewardsTool, classifyEffort, clearPortfolioCache, clearPortfolioCacheFor, clearPriceMapCache, compactMessages, createGuardRunnerState, engineToSSE, estimateTokens, explainTxTool, extractConversationText, extractMcpText, fetchAddressDefiPortfolio, fetchAddressPortfolio, fetchAudricHistory, fetchAudricPortfolio, fetchAvailableRewards, fetchBalance, fetchHealthFactor, fetchPositions, fetchProtocolStats, fetchRates, fetchSavings, fetchTokenPrices, fetchWalletCoins, findTool, getAudricApiBase, getDefaultTools, getDefiCacheStore, getFetchLock, getMcpManager, getModifiableFields, getNaviCacheStore, getTelemetrySink, getToolFlags, getWalletAddress, getWalletCacheStore, guardArtifactPreview, guardStaleData, hasNaviMcp, healthCheckTool, loadRecipes, microcompact, mppServicesTool, naviKey, parseMcpJson, parseRecipe, parseSSE, payApiTool, portfolioAnalysisTool, protocolDeepDiveTool, ratesInfoTool, registerEngineTools, renderCanvasTool, repayDebtTool, requireAgent, resetDefiCacheStore, resetFetchLock, resetNaviCacheStore, resetTelemetrySink, resetWalletCacheStore, resolvePermissionTier, resolveUsdValue, runGuards, runTools, saveContactTool, saveDepositTool, savingsInfoTool, sendTransferTool, serializeSSE, setDefiCacheStore, setFetchLock, setNaviCacheStore, setTelemetrySink, setWalletCacheStore, spendingAnalyticsTool, swapExecuteTool, swapQuoteTool, tokenPricesTool, toolNameToOperation, toolsToDefinitions, transactionHistoryTool, transformBalance, transformHealthFactor, transformPositions, transformRates, transformRewards, transformSavings, updateGuardStateAfterToolResult, validateHistory, voloStakeTool, voloStatsTool, voloUnstakeTool, webSearchTool, withdrawTool, yieldSummaryTool };
+export { AnthropicProvider, BalanceTracker, CANVAS_TEMPLATES, ContextBudget, CostTracker, DEFAULT_GUARD_CONFIG, DEFAULT_LEASE_SEC, DEFAULT_PERMISSION_CONFIG, DEFAULT_POLL_BUDGET_MS, DEFAULT_POLL_INTERVAL_MS, DEFAULT_SYSTEM_PROMPT, EarlyToolDispatcher, InMemoryDefiCacheStore, InMemoryFetchLock, InMemoryNaviCacheStore, InMemoryWalletCacheStore, InvalidAddressError, McpClientManager, McpResponseCache, MemorySessionStore, NAVI_ADDR_TTL_SEC, NAVI_MCP_CONFIG, NAVI_MCP_URL, NAVI_RATES_TTL_SEC, NAVI_SERVER_NAME, NaviTools, PERMISSION_PRESETS, QueryEngine, READ_TOOLS, RecipeRegistry, RetryTracker, SUINS_NAME_REGEX, SUI_ADDRESS_REGEX, SUI_ADDRESS_STRICT_REGEX, SuinsNotRegisteredError, SuinsRpcError, TOOL_FLAGS, TOOL_MODIFIABLE_FIELDS, TxMutex, WRITE_TOOLS, _resetNaviCircuitBreaker, activitySummaryTool, adaptAllMcpTools, adaptAllServerTools, adaptMcpTool, applyToolFlags, awaitOrFetch, balanceCheckTool, borrowTool, budgetToolResult, buildCachedSystemPrompt, buildMcpTools, buildProactivenessInstructions, buildProfileContext, buildSelfEvaluationInstruction, buildStateContext, buildTool, claimRewardsTool, classifyEffort, clearPortfolioCache, clearPortfolioCacheFor, clearPriceMapCache, compactMessages, createGuardRunnerState, engineToSSE, estimateTokens, explainTxTool, extractConversationText, extractMcpText, fetchAddressDefiPortfolio, fetchAddressPortfolio, fetchAudricHistory, fetchAudricPortfolio, fetchAvailableRewards, fetchBalance, fetchHealthFactor, fetchPositions, fetchProtocolStats, fetchRates, fetchSavings, fetchTokenPrices, fetchWalletCoins, findTool, getAudricApiBase, getDefaultTools, getDefiCacheStore, getFetchLock, getMcpManager, getModifiableFields, getNaviCacheStore, getTelemetrySink, getToolFlags, getWalletAddress, getWalletCacheStore, guardArtifactPreview, guardStaleData, hasNaviMcp, healthCheckTool, loadRecipes, looksLikeSuiNs, microcompact, mppServicesTool, naviKey, normalizeAddressInput, parseMcpJson, parseRecipe, parseSSE, payApiTool, portfolioAnalysisTool, protocolDeepDiveTool, ratesInfoTool, registerEngineTools, renderCanvasTool, repayDebtTool, requireAgent, resetDefiCacheStore, resetFetchLock, resetNaviCacheStore, resetTelemetrySink, resetWalletCacheStore, resolvePermissionTier, resolveSuinsTool, resolveSuinsViaRpc, resolveUsdValue, runGuards, runTools, saveContactTool, saveDepositTool, savingsInfoTool, sendTransferTool, serializeSSE, setDefiCacheStore, setFetchLock, setNaviCacheStore, setTelemetrySink, setWalletCacheStore, spendingAnalyticsTool, swapExecuteTool, swapQuoteTool, tokenPricesTool, toolNameToOperation, toolsToDefinitions, transactionHistoryTool, transformBalance, transformHealthFactor, transformPositions, transformRates, transformRewards, transformSavings, updateGuardStateAfterToolResult, validateHistory, voloStakeTool, voloStatsTool, voloUnstakeTool, webSearchTool, withdrawTool, yieldSummaryTool };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map