@t2000/engine 1.22.1 → 1.23.0

package/README.md

@@ -1,6 +1,6 @@
 # @t2000/engine
 
-Agent engine for conversational finance — implements **Audric Intelligence** (the moat behind the Audric consumer product). Five systems work together: Agent Harness (34 tools — 23 read, 11 write), Reasoning Engine (14 guards across 3 priority tiers + 6 YAML skill recipes), Silent Profile, Chain Memory, and AdviceLog. Every action it triggers waits on Audric Passport's tap-to-confirm.
+Agent engine for conversational finance — implements **Audric Intelligence** (the moat behind the Audric consumer product). Five systems work together: Agent Harness (35 tools — 24 read, 11 write), Reasoning Engine (14 guards across 3 priority tiers + 6 YAML skill recipes), Silent Profile, Chain Memory, and AdviceLog. Every action it triggers waits on Audric Passport's tap-to-confirm.
 
 QueryEngine orchestrates LLM conversations, financial tools, user confirmations, and MCP integrations into a single async-generator loop.
 
@@ -35,11 +35,11 @@ for await (const event of engine.submitMessage('What is my balance?')) {
 
 ## Audric Intelligence — the 5 systems
 
-> _Not a chatbot. A financial agent._ Five systems work together to **understand** the user's money, **reason** about decisions, **act** through 34 financial tools in one conversation, **remember** what they did on-chain, and **remember what it told them**. Every action still waits on Audric Passport's tap-to-confirm.
+> _Not a chatbot. A financial agent._ Five systems work together to **understand** the user's money, **reason** about decisions, **act** through 35 financial tools in one conversation, **remember** what they did on-chain, and **remember what it told them**. Every action still waits on Audric Passport's tap-to-confirm.
 
 | System | One-line | Owns | Lives in |
 |---|---|---|---|
-| 🎛️ **Agent Harness** | 34 tools, one agent. | Tool registry, parallel reads, serial writes, permission gates, streaming dispatch | `engine.ts`, `tool.ts`, `orchestration.ts`, `tools/*` |
+| 🎛️ **Agent Harness** | 35 tools, one agent. | Tool registry, parallel reads, serial writes, permission gates, streaming dispatch | `engine.ts`, `tool.ts`, `orchestration.ts`, `tools/*` |
 | ⚡ **Reasoning Engine** | Thinks before it acts. | Adaptive thinking effort, 14 guards (12 pre-exec + 2 post-exec), 6 YAML skill recipes, prompt caching, preflight validation | `classify-effort.ts`, `guards.ts`, `recipes/registry.ts`, `engine.ts` `cache_control` |
 | 🧠 **Silent Profile** | Knows your finances. | Daily on-chain orientation snapshot + Claude-inferred profile, injected as `<financial_context>` block at every boot | _Audric-side_: `UserFinancialContext` + `UserFinancialProfile` Prisma models + `buildFinancialContextBlock()` |
 | 🔗 **Chain Memory** | Remembers what you do on-chain. | 7 classifiers extract `ChainFact` rows from on-chain history, hydrated as silent context | _Audric-side_: 7 classifier crons + `ChainFact` Prisma model + `buildMemoryContext()` |
@@ -161,7 +161,10 @@ QueryEngine.submitMessage()
 > `defillama_sui_protocols`. Added 1 — `token_prices` (BlockVision-backed). `balance_check`
 > and `portfolio_analysis` rewired to BlockVision Indexer REST API for sub-500ms portfolio
 > fetches. `protocol_deep_dive` retains its DefiLlama dependency (narrow scope, no
-> equivalent on BlockVision). Net: 23 reads + 11 writes = 34 tools.
+> equivalent on BlockVision). Net post-v1.4: 23 reads + 11 writes = 34 tools.
+>
+> **SPEC 10 SuiNS reverse-lookup (May 2026):** Added 1 read tool — `resolve_suins`.
+> Net post-SPEC-10: **24 reads + 11 writes = 35 tools** (current).
 
 ## Recent Upgrades — Spec 1 (Correctness) + Spec 2 (Intelligence)
 

package/dist/index.d.ts

@@ -3,7 +3,7 @@ import { Client } from '@modelcontextprotocol/sdk/client/index.js';
 import { Transport } from '@modelcontextprotocol/sdk/shared/transport.js';
 import { Tool as Tool$1 } from '@modelcontextprotocol/sdk/types.js';
 import * as _t2000_sdk from '@t2000/sdk';
-import { T2000 } from '@t2000/sdk';
+import { PendingReward as PendingReward$1, T2000 } from '@t2000/sdk';
 
 type ProactiveType = 'idle_balance' | 'hf_warning' | 'apy_drift' | 'goal_progress';
 interface ProactiveMarker {
@@ -3363,13 +3363,16 @@ declare const repayDebtTool: Tool<{
     gasCost: number;
 }>;
 
-declare const claimRewardsTool: Tool<{}, {
+interface ClaimRewardsResult {
     success: boolean;
     tx: string | null;
-    rewards: _t2000_sdk.PendingReward[];
+    rewards: PendingReward$1[];
     totalValueUsd: number;
     gasCost: number;
-}>;
+    degraded: boolean;
+    degradationReason: string | null;
+}
+declare const claimRewardsTool: Tool<{}, ClaimRewardsResult>;
 
 declare const payApiTool: Tool<{
     url: string;
@@ -4203,7 +4206,7 @@ declare function fetchAudricHistory(address: string, opts: {
     limit?: number;
 }, env?: Record<string, string>, signal?: AbortSignal): Promise<AudricHistoryRecord[] | null>;
 
-declare const DEFAULT_SYSTEM_PROMPT = "You are Audric \u2014 a financial agent on Sui. Audric is exactly five products: Audric Passport (the trust layer \u2014 Google sign-in, non-custodial wallet, tap-to-confirm consent, sponsored gas \u2014 wraps every other product), Audric Intelligence (you \u2014 the 5-system brain: Agent Harness with 34 tools, Reasoning Engine with 14 guards and 6 skill recipes, Silent Profile, Chain Memory, AdviceLog), Audric Finance (manage money on Sui \u2014 Save via NAVI lending at 3-8% APY USDC, Credit via NAVI borrowing with health factor, Swap via Cetus aggregator across 20+ DEXs at 0.1% fee, Charts for yield/health/portfolio viz), Audric Pay (move money \u2014 send USDC, receive via payment links / invoices / QR; free, global, instant on Sui), and Audric Store (creator marketplace, ships Phase 5 \u2014 say \"coming soon\" if asked). Save, swap, borrow, repay, withdraw, charts \u2192 Audric Finance. Send, receive, payment-link, invoice, QR \u2192 Audric Pay. Your silent context (profile, memory, chain facts, advice log) shapes your replies but never surfaces as a notification \u2014 you act only when the user asks, and every write waits on their tap-to-confirm via Passport. You can also call 41 paid APIs (music, image, research, translation, weather, fulfilment) via MPP micropayments using the pay_api tool \u2014 this is an internal capability, not a promoted product, so only mention it when the user asks for something that needs it.\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- 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## Caption rules (after tool calls)\n- **When a canvas was rendered (`render_canvas` was called, or any tool that auto-renders a card like balance_check / portfolio_analysis / savings_info / health_check / transaction_history): the canvas IS the answer.** Your chat message must NOT restate wallet, savings, debt, holdings, or net-worth numbers \u2014 they are already on screen. Add at most ONE sentence of context, advice, or next step (e.g. \"Your USDC is idle \u2014 consider depositing for ~4.5% APY\"), or say nothing.\n- **When NO canvas was rendered:** lead with the result and quote the actual numbers from the tool. One sentence.\n- **NEVER describe a position as \"no\", \"none\", \"minimal\", \"zero\", or \"inactive\" if the tool result contains a positive value for that field.** The tool result is the source of truth \u2014 never your interior summary. If the canvas shows $100 in savings, you cannot say \"no active savings\" in the caption.\n- **NEVER claim \"no DeFi positions\" when the tool result says the DeFi slice is UNAVAILABLE.** When `balance_check` displayText contains \"DeFi positions: UNAVAILABLE\" or \"DeFi data source unreachable\", the slice is unknown \u2014 say \"DeFi data is currently unavailable\" or omit the mention. Only claim \"no DeFi positions\" when the displayText explicitly omits any DeFi line (i.e. the fetch succeeded with $0 across every covered protocol).\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 NAVI lending APYs, use rates_info; for VOLO liquid staking stats, use volo_stats; for spot token prices, use token_prices.\n- For protocol-level due diligence (TVL, fees, audits, safety) on Sui DeFi protocols, use protocol_deep_dive 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## Savings = USDC or USDsui (critical)\n- save_deposit and borrow accept ONLY USDC or USDsui. No other token can be deposited or borrowed.\n- USDC is the canonical default. USDsui is permitted because it has a productive NAVI pool (often a higher APY than USDC). All other holdings (GOLD, SUI, USDT, USDe, ETH, NAVX, WAL) are NOT saveable.\n- When asked \"how much can I save?\":\n  - Report saveableUsdc from balance_check (the user's USDC wallet balance \u2014 canonical saveable).\n  - If the user also holds USDsui in their wallet, report that separately as \"USDsui (saveable): X.XX\". Do NOT roll the two together \u2014 the LLM must keep the per-asset distinction so the user can pick.\n- When the user says \"save 10 USDC\" \u2192 call save_deposit with asset=\"USDC\". When they say \"save 10 USDsui\" \u2192 call with asset=\"USDsui\". Never silently substitute.\n- When the user says \"save 10\" (no asset) \u2192 call balance_check first and ask which stable they want, OR pick whichever they hold more of with a one-line explanation.\n- \"Best stable to save right now?\" \u2192 call rates_info to compare USDC vs USDsui APY on NAVI; let the user pick.\n- NEVER say a non-saveable token (GOLD, SUI, USDT, etc.) is \"in savings\" or \"earning APY in savings\". Wallet holdings \u2260 savings positions, even for stables we don't accept.\n- If user wants to save a non-saveable token, tell them to swap to USDC or USDsui first. Do NOT auto-chain swap + deposit.\n- Repay symmetry: a USDsui debt MUST be repaid with USDsui (and USDC debt with USDC). When calling repay_debt, pass asset=\"USDsui\" if the borrow is USDsui. If the user asks \"repay my debt\" and savings_info shows borrows in BOTH stables, list both and ask which to repay first. If the user holds the wrong stable, tell them to swap manually \u2014 do NOT auto-chain swap + repay.\n\n## Fees (critical \u2014 never deny having fees)\n- **Swap:** 0.1% Audric overlay fee on the output amount, taken by the aggregator and sent to the Audric treasury. The Cetus DEX fee (typically 0.01\u20130.25%) is separate and goes to the DEX. Both are shown on the swap card. Never say Audric takes no cut on swaps \u2014 it does.\n- **Save (deposit):** 0.1% Audric fee on the deposit amount, taken atomically in the same transaction.\n- **Borrow:** 0.05% Audric fee on the borrow amount, taken atomically in the same transaction.\n- **Withdraw / Repay / Send / Receive:** No Audric fee. Gas is sponsored (free to the user).\n- When a user asks about fees, quote the above. Do NOT say \"I don't take a cut\", \"fees are zero\", \"all your value stays with you\", or \"I'm here to execute, not extract\" \u2014 those are incorrect for swap, save, and borrow.\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\": token_prices \u2192 calculate amount \u2192 swap_execute.\n- \"Best yield on SUI\": compare rates_info (NAVI lending) + volo_stats (vSUI liquid staking).\n- withdraw supports legacy positions: USDC, USDe, USDsui, SUI. Pass asset param to withdraw a specific token.\n- \"Deposit SUI to earn yield\": volo_stake for SUI liquid staking. save_deposit only accepts USDC or USDsui.\n- \"Is protocol X safe?\" / \"Tell me about NAVI\": protocol_deep_dive with the slug.\n- \"Full account report\" / \"account summary\" / \"give me everything\" / \"complete overview\": triggers the `account_report` recipe \u2014 when the recipe block appears, follow EVERY step including all six tool calls. Each step renders a distinct rich card; skipping a step means a missing card.\n\n## Safety\n- Never encourage risky financial behavior.\n- Warn when health factor < 1.5.\n- All amounts in USDC unless stated otherwise.\n\n## Proactive insights (only when there's a clear opportunity)\n- When you spot a financial insight worth surfacing \u2014 idle balance worth saving, health factor approaching the warning band, APY drift on a known position, progress against a saved goal \u2014 emit a `<proactive type=\"...\" subjectKey=\"...\">BODY</proactive>` block. ALWAYS use the wrapper \u2014 plain-text proactive prose without the wrapper renders as regular text and skips the engine's per-session cooldown (the same nudge will then re-fire every turn).\n- Two valid placements \u2014 pick whichever fits the turn:\n  - **No user question** (or the question is unrelated to the insight): wrap your ENTIRE response in the `<proactive>` block.\n  - **You're answering a user question AND have a related insight to add**: answer the question normally, then APPEND the `<proactive>` block at the end, separated by a line break. The \"after the answer\" form is also taught in detail under \u00A7 Proactive Awareness \u2014 same syntax, both placements valid.\n- The host renders the wrapped block with a distinct \"\u2726 ADDED BY AUDRIC\" lockup so the user knows this is your suggestion, not an answer.\n- Allowed types (closed list \u2014 anything else is dropped): `idle_balance` (cash sitting idle that could earn yield), `hf_warning` (debt position approaching liquidation), `apy_drift` (rate change on a position they hold), `goal_progress` (update on a saved goal).\n- `subjectKey` is a stable identifier for the SPECIFIC subject \u2014 examples: `USDC` or `USDsui` for an idle-balance insight on either NAVI-saveable stable, `1.45` for a HF warning at that level, `save-500-by-may` for goal progress. Same (type, subjectKey) won't fire twice in one session \u2014 pick the same key for the same subject so the engine cooldown works.\n- Cap: at most ONE proactive block per turn.\n- Skip proactive blocks when nothing notable changed since the last turn, when the user is mid-flow on something else, or when you'd just be restating the financial-context block. Quality over quantity \u2014 a block ignored is worse than no block.";
+declare const DEFAULT_SYSTEM_PROMPT: string;
 
 /** Cache entry shape. `cachedAt` is the wall-clock ms at write time. */
 interface NaviCacheEntry {

package/dist/index.js

@@ -252,7 +252,7 @@ function isBundleableTool(name) {
   return TOOL_FLAGS[name]?.bundleable === true;
 }
 
-// src/navi-config.ts
+// src/navi/config.ts
 var NAVI_SERVER_NAME = "navi";
 var NAVI_MCP_URL = "https://open-api.naviprotocol.io/api/mcp";
 var NAVI_MCP_CONFIG = {
@@ -521,7 +521,7 @@ async function fetchWalletCoins(address, rpcUrl) {
   });
 }
 
-// src/defi-cache.ts
+// src/cache/defi.ts
 var InMemoryDefiCacheStore = class {
   store = /* @__PURE__ */ new Map();
   async get(address) {
@@ -557,7 +557,7 @@ function resetDefiCacheStore() {
   activeStore = new InMemoryDefiCacheStore();
 }
 
-// src/wallet-cache.ts
+// src/cache/wallet.ts
 var InMemoryWalletCacheStore = class {
   store = /* @__PURE__ */ new Map();
   async get(address) {
@@ -1115,6 +1115,28 @@ var DEFI_PROTOCOLS = [
   "suistake",
   "walrus"
 ];
+var DEFI_PROTOCOL_CONCURRENCY = 3;
+async function mapWithConcurrency(items, fn, concurrency) {
+  if (items.length === 0) return [];
+  const results = new Array(items.length);
+  let nextIdx = 0;
+  async function worker() {
+    while (true) {
+      const myIdx = nextIdx;
+      nextIdx += 1;
+      if (myIdx >= items.length) return;
+      try {
+        const value = await fn(items[myIdx], myIdx);
+        results[myIdx] = { status: "fulfilled", value };
+      } catch (reason) {
+        results[myIdx] = { status: "rejected", reason };
+      }
+    }
+  }
+  const workerCount = Math.max(1, Math.min(concurrency, items.length));
+  await Promise.all(Array.from({ length: workerCount }, () => worker()));
+  return results;
+}
 var SUI_TYPE_FULL = "0x0000000000000000000000000000000000000000000000000000000000000002::sui::SUI";
 var USDC_TYPE_FULL = "0xdba34672e30cb065b1f93e3ab55318768fd6fef66c15942c9f7cb846e2f900e7::usdc::USDC";
 var BLUE_TYPE_FULL = "0xe1b45a0e641b9955a20aa0ad1c1f4ad86aad8afb07296d4085e349a50e90bdca::blue::BLUE";
@@ -1189,8 +1211,10 @@ async function fetchAddressDefiPortfolio(address, apiKey, priceHints = {}, opts
           }
           const stickyBasis = recheck ?? cachedEntry;
           const fanoutAt = Date.now();
-          const settled = await Promise.allSettled(
-            DEFI_PROTOCOLS.map((p) => fetchOneDefiProtocol(address, p, apiKey, opts.retryStats))
+          const settled = await mapWithConcurrency(
+            DEFI_PROTOCOLS,
+            (p) => fetchOneDefiProtocol(address, p, apiKey, opts.retryStats),
+            DEFI_PROTOCOL_CONCURRENCY
           );
           const seen = /* @__PURE__ */ new Set();
           for (const s of settled) {
@@ -1668,7 +1692,7 @@ async function fetchAudricHistory(address, opts, env, signal) {
   }
 }
 
-// src/sui-address.ts
+// 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;
@@ -2113,7 +2137,7 @@ var balanceCheckTool = buildTool({
   }
 });
 
-// src/navi-cache.ts
+// src/navi/cache.ts
 var InMemoryNaviCacheStore = class {
   store = /* @__PURE__ */ new Map();
   async get(key) {
@@ -2156,7 +2180,7 @@ var naviKey = {
   health: (address) => `navi:health:${address.toLowerCase()}`
 };
 
-// src/navi-reads.ts
+// src/navi/reads.ts
 function sn(opts) {
   return opts?.serverName ?? NAVI_SERVER_NAME;
 }
@@ -3365,7 +3389,25 @@ var claimRewardsTool = buildTool({
   flags: { mutating: true },
   async call(_input, context) {
     const agent = requireAgent(context);
-    const result = await agent.claimRewards();
+    let result;
+    try {
+      result = await agent.claimRewards();
+    } catch (err) {
+      const errAny = err;
+      const isProtocolDown = errAny?.code === "PROTOCOL_UNAVAILABLE";
+      const detail = typeof errAny?.message === "string" ? errAny.message.replace(/^[^:]*:\s*/, "") : "";
+      const displayText2 = isProtocolDown ? `Could not check pending rewards \u2014 NAVI is degraded right now${detail ? ` (${detail.slice(0, 80)})` : ""}. Try again in a moment.` : "Could not check pending rewards \u2014 protocol error. Try again in a moment.";
+      const data2 = {
+        success: false,
+        tx: null,
+        rewards: [],
+        totalValueUsd: 0,
+        gasCost: 0,
+        degraded: true,
+        degradationReason: errAny?.code ?? "UNKNOWN"
+      };
+      return { data: data2, displayText: displayText2 };
+    }
     const priceCache = context.priceCache;
     const enrichedRewards = result.rewards.map((r) => {
       if (r.estimatedValueUsd > 0) return r;
@@ -3387,16 +3429,16 @@ var claimRewardsTool = buildTool({
       const txSuffix = txShort ? ` (tx: ${txShort})` : "";
       displayText = `Claimed ${breakdown}${usdSuffix}${txSuffix}`;
     }
-    return {
-      data: {
-        success: result.success,
-        tx: result.tx || null,
-        rewards: enrichedRewards,
-        totalValueUsd,
-        gasCost: result.gasCost
-      },
-      displayText
+    const data = {
+      success: result.success,
+      tx: result.tx || null,
+      rewards: enrichedRewards,
+      totalValueUsd,
+      gasCost: result.gasCost,
+      degraded: false,
+      degradationReason: null
     };
+    return { data, displayText };
   }
 });
 var MPP_GATEWAY = "https://mpp.t2000.ai";
@@ -5167,6 +5209,70 @@ var resolveSuinsTool = buildTool({
     }
   }
 });
+function formatAmount2(amount) {
+  if (!Number.isFinite(amount) || amount <= 0) return "0";
+  if (amount >= 1) return amount.toFixed(4).replace(/\.?0+$/, "");
+  if (amount >= 1e-4) return amount.toFixed(6).replace(/\.?0+$/, "");
+  return amount.toExponential(2);
+}
+var pendingRewardsTool = buildTool({
+  name: "pending_rewards",
+  description: "Inspect unclaimed protocol rewards for the signed-in user without claiming them. Returns a per-asset breakdown \u2014 symbol, amount, USD value (when oracle prices are known) \u2014 plus the total claimable USD. Use BEFORE calling claim_rewards or harvest_rewards so you can tell the user exactly what's claimable; if zero rewards or NAVI is degraded, surface that truthfully instead of jumping to a write. Read-only, never opens a confirm card.",
+  inputSchema: z.object({}),
+  jsonSchema: { type: "object", properties: {}, required: [] },
+  isReadOnly: true,
+  // Rewards accrue continuously and are zeroed on claim — never dedupe
+  // across turns within the same session.
+  cacheable: false,
+  async call(_input, context) {
+    const agent = requireAgent(context);
+    let rewards;
+    try {
+      rewards = await agent.getPendingRewards();
+    } catch (err) {
+      const errAny = err;
+      const isProtocolDown = errAny?.code === "PROTOCOL_UNAVAILABLE";
+      const detail = typeof errAny?.message === "string" ? errAny.message.replace(/^[^:]*:\s*/, "") : "";
+      const displayText2 = isProtocolDown ? `Could not check pending rewards \u2014 NAVI is degraded right now${detail ? ` (${detail.slice(0, 80)})` : ""}. Try again in a moment.` : "Could not check pending rewards \u2014 protocol error. Try again in a moment.";
+      const data2 = {
+        rewards: [],
+        totalValueUsd: 0,
+        degraded: true,
+        degradationReason: errAny?.code ?? "UNKNOWN"
+      };
+      return { data: data2, displayText: displayText2 };
+    }
+    const priceCache = context.priceCache;
+    const enriched = rewards.map((r) => {
+      if (r.estimatedValueUsd > 0) return r;
+      const price = priceCache?.get(r.symbol.toUpperCase());
+      if (!price || !Number.isFinite(price) || price <= 0) return r;
+      return { ...r, estimatedValueUsd: r.amount * price };
+    });
+    const totalValueUsd = enriched.reduce(
+      (s, r) => s + (Number.isFinite(r.estimatedValueUsd) ? r.estimatedValueUsd : 0),
+      0
+    );
+    let displayText;
+    if (enriched.length === 0) {
+      displayText = "No pending rewards.";
+    } else {
+      const breakdown = enriched.map((r) => {
+        const usd = Number.isFinite(r.estimatedValueUsd) && r.estimatedValueUsd > 0 ? ` (~$${r.estimatedValueUsd.toFixed(r.estimatedValueUsd >= 1 ? 2 : 4)})` : "";
+        return `${formatAmount2(r.amount)} ${r.symbol}${usd}`;
+      }).join(", ");
+      const totalSuffix = totalValueUsd > 0 ? ` \u2014 total ~$${totalValueUsd.toFixed(2)}` : "";
+      displayText = `Pending rewards: ${breakdown}${totalSuffix}`;
+    }
+    const data = {
+      rewards: enriched,
+      totalValueUsd,
+      degraded: false,
+      degradationReason: null
+    };
+    return { data, displayText };
+  }
+});
 var todoStatusSchema = z.enum(["pending", "in_progress", "completed"]);
 var todoItemSchema = z.object({
   id: z.string().min(1, "id must be a non-empty string").max(40, "id must be \u226440 chars (use a slug, not a sentence)"),
@@ -5448,7 +5554,8 @@ var READ_TOOLS = [
   spendingAnalyticsTool,
   yieldSummaryTool,
   activitySummaryTool,
-  resolveSuinsTool
+  resolveSuinsTool,
+  pendingRewardsTool
 ];
 var WRITE_TOOLS = [
   saveDepositTool,
@@ -5501,8 +5608,11 @@ function getModifiableFields(toolName) {
   return TOOL_MODIFIABLE_FIELDS[toolName];
 }
 
-// src/prompt.ts
-var DEFAULT_SYSTEM_PROMPT = `You are Audric \u2014 a financial agent on Sui. Audric is exactly five products: Audric Passport (the trust layer \u2014 Google sign-in, non-custodial wallet, tap-to-confirm consent, sponsored gas \u2014 wraps every other product), Audric Intelligence (you \u2014 the 5-system brain: Agent Harness with 34 tools, Reasoning Engine with 14 guards and 6 skill recipes, Silent Profile, Chain Memory, AdviceLog), Audric Finance (manage money on Sui \u2014 Save via NAVI lending at 3-8% APY USDC, Credit via NAVI borrowing with health factor, Swap via Cetus aggregator across 20+ DEXs at 0.1% fee, Charts for yield/health/portfolio viz), Audric Pay (move money \u2014 send USDC, receive via payment links / invoices / QR; free, global, instant on Sui), and Audric Store (creator marketplace, ships Phase 5 \u2014 say "coming soon" if asked). Save, swap, borrow, repay, withdraw, charts \u2192 Audric Finance. Send, receive, payment-link, invoice, QR \u2192 Audric Pay. Your silent context (profile, memory, chain facts, advice log) shapes your replies but never surfaces as a notification \u2014 you act only when the user asks, and every write waits on their tap-to-confirm via Passport. You can also call 41 paid APIs (music, image, research, translation, weather, fulfilment) via MPP micropayments using the pay_api tool \u2014 this is an internal capability, not a promoted product, so only mention it when the user asks for something that needs it.
+// src/prompt/index.ts
+var READ_COUNT = READ_TOOLS.length;
+var WRITE_COUNT = WRITE_TOOLS.length;
+var TOTAL_COUNT = READ_COUNT + WRITE_COUNT;
+var DEFAULT_SYSTEM_PROMPT = `You are Audric \u2014 a financial agent on Sui. Audric is exactly five products: Audric Passport (the trust layer \u2014 Google sign-in, non-custodial wallet, tap-to-confirm consent, sponsored gas \u2014 wraps every other product), Audric Intelligence (you \u2014 the 5-system brain: Agent Harness with ${TOTAL_COUNT} tools, Reasoning Engine with 14 guards and 6 skill recipes, Silent Profile, Chain Memory, AdviceLog), Audric Finance (manage money on Sui \u2014 Save via NAVI lending at 3-8% APY USDC, Credit via NAVI borrowing with health factor, Swap via Cetus aggregator across 20+ DEXs at 0.1% fee, Charts for yield/health/portfolio viz), Audric Pay (move money \u2014 send USDC, receive via payment links / invoices / QR; free, global, instant on Sui), and Audric Store (creator marketplace, ships Phase 5 \u2014 say "coming soon" if asked). Save, swap, borrow, repay, withdraw, charts \u2192 Audric Finance. Send, receive, payment-link, invoice, QR \u2192 Audric Pay. Your silent context (profile, memory, chain facts, advice log) shapes your replies but never surfaces as a notification \u2014 you act only when the user asks, and every write waits on their tap-to-confirm via Passport. You can also call 40+ paid APIs (music, image, research, translation, weather, fulfilment) via MPP micropayments using the pay_api tool \u2014 this is an internal capability, not a promoted product, so only mention it when the user asks for something that needs it.
 
 ## Response rules
 - 1-2 sentences max. No bullet lists unless asked. No preambles.
@@ -6739,7 +6849,7 @@ function safeNum(v) {
   return isNaN(n) ? 0 : n;
 }
 
-// src/turn-read-cache.ts
+// src/cache/turn-read.ts
 var TurnReadCache = class {
   store = /* @__PURE__ */ new Map();
   /**
@@ -9171,7 +9281,7 @@ function parseEvalSummary(thinkingText) {
   };
 }
 
-// src/prompt-cache.ts
+// src/prompt/cache.ts
 function buildCachedSystemPrompt(staticParts, dynamicPart) {
   const blocks = staticParts.map((text, i) => ({
     type: "text",
@@ -9315,7 +9425,7 @@ function buildStateContext(state) {
   }
 }
 
-// src/mcp.ts
+// src/mcp/index.ts
 function buildMcpTools(context, tools) {
   const engineTools = tools ?? getDefaultTools();
   return engineTools.map((tool) => ({