@t2000/engine 0.46.16 → 0.47.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 (40 tools), Reasoning Engine (9 guards across 3 priority tiers + 7 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 (34 tools — 23 read, 11 write), Reasoning Engine (9 guards across 3 priority tiers + 7 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.
 
@@ -75,8 +75,9 @@ QueryEngine.submitMessage()
 | `navi-config.ts` | `NAVI_MCP_CONFIG`, `NaviTools` | NAVI MCP server configuration |
 | `navi-transforms.ts` | `transformRates`, `transformBalance`, ... | Raw MCP response → engine types |
 | `navi-reads.ts` | `fetchRates`, `fetchBalance`, ... | Composite MCP read functions |
-| `defillama-prices.ts` | `fetchTokenPrices`, `clearPriceCache` | Batch USD prices from DefiLlama (single price source) |
-| `tools/defillama.ts` | 7 DefiLlama tools | Yield pools, protocol info, token prices, price changes, chain TVL, fees, Sui protocols |
+| `blockvision-prices.ts` | `fetchAddressPortfolio`, `fetchTokenPrices`, `clearPortfolioCache`, `clearPortfolioCacheFor`, `clearPriceMapCache` | BlockVision Indexer REST: full wallet portfolio + multi-token USD prices (Sui RPC + hardcoded-stable degraded fallback) |
+| `tools/protocol-deep-dive.ts` | `protocolDeepDiveTool` | DefiLlama protocol metadata (TVL, fees, audits, safety score) — lone production dependency on `api.llama.fi` post-Day-3 |
+| `tools/token-prices.ts` | `tokenPricesTool` | BlockVision-backed multi-token spot price + 24h change (replaces deleted `defillama_token_prices` / `defillama_price_change`) |
 | `tools/swap-quote.ts` | `swapQuoteTool` | Preview swap route + price impact (read-only) |
 | `tools/swap.ts` | `swapExecuteTool` | Cetus Aggregator multi-DEX swap |
 | `tools/volo-stats.ts` | `voloStatsTool` | VOLO liquid staking stats (vSUI/SUI rate, APY, TVL) |
@@ -87,11 +88,11 @@ QueryEngine.submitMessage()
 
 ## Built-in Tools
 
-### Read Tools (29 — parallel, auto-approved)
+### Read Tools (23 — parallel, auto-approved)
 
 | Tool | Description |
 |------|-------------|
-| `balance_check` | Available, savings, debt, rewards, gas reserve (DefiLlama pricing) |
+| `balance_check` | Available, savings, debt, rewards, gas reserve (BlockVision pricing, Sui RPC fallback) |
 | `savings_info` | Positions, earnings, fund status |
 | `health_check` | Health factor with risk assessment |
 | `rates_info` | Current supply/borrow APYs |
@@ -101,15 +102,9 @@ QueryEngine.submitMessage()
 | `swap_quote` | Preview swap route, output amount, and price impact (no execution) |
 | `volo_stats` | VOLO liquid staking stats — vSUI/SUI rate, APY, TVL |
 | `portfolio_analysis` | Portfolio breakdown with diversification insights |
-| `protocol_deep_dive` | Deep protocol analysis — TVL, yields, risks, alternatives |
+| `protocol_deep_dive` | Deep protocol analysis — TVL, yields, risks, alternatives (lone surviving DefiLlama dependency) |
 | `mpp_services` | Browse available MPP gateway services and endpoints |
-| `defillama_yield_pools` | Top yield pools by APY, filterable by chain |
-| `defillama_protocol_info` | Protocol TVL, category, chains |
-| `defillama_token_prices` | Current USD prices for Sui tokens |
-| `defillama_price_change` | Token price % change over period |
-| `defillama_chain_tvl` | Chain TVL rankings |
-| `defillama_protocol_fees` | Protocol fees/revenue rankings |
-| `defillama_sui_protocols` | Sui ecosystem protocols — TVL, category, changes |
+| `token_prices` | Current USD prices for Sui tokens (BlockVision; optional 24h change). Replaces deleted `defillama_token_prices` and `defillama_price_change`. |
 | `create_payment_link` | Create a shareable USDC payment link |
 | `list_payment_links` | List payment links with statuses |
 | `cancel_payment_link` | Cancel an active payment link |
@@ -145,6 +140,14 @@ QueryEngine.submitMessage()
 > `create_schedule`, `list_schedules`, `cancel_schedule` (DCA can't execute without user
 > online to sign), `pattern_status`, `pause_pattern` (pattern proposals removed; classifiers
 > kept as pure functions).
+>
+> **v1.4 BlockVision swap (April 2026):** Removed 7 `defillama_*` read tools —
+> `defillama_token_prices`, `defillama_price_change`, `defillama_yield_pools`,
+> `defillama_protocol_info`, `defillama_chain_tvl`, `defillama_protocol_fees`,
+> `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.
 
 ## Audric 2.0 Engine Features
 
@@ -177,23 +180,55 @@ Write tool permission resolved dynamically via `resolvePermissionTier(operation,
 
 ```typescript
 interface EngineConfig {
-  provider: LLMProvider;          // Required — LLM provider instance
-  agent?: unknown;                // T2000 SDK instance (for tool execution)
-  mcpManager?: unknown;           // McpClientManager (MCP-first reads)
-  walletAddress?: string;         // User's Sui address (for MCP reads)
-  tools?: Tool[];                 // Custom tool set (defaults to getDefaultTools())
-  systemPrompt?: string;          // Override default Audric prompt
-  model?: string;                 // LLM model override
-  maxTurns?: number;              // Max conversation turns (default: 10)
-  maxTokens?: number;             // Max tokens per response (default: 4096)
+  // Core
+  provider: LLMProvider;                    // Required — LLM provider instance
+  agent?: unknown;                          // T2000 SDK instance (for tool execution)
+  mcpManager?: unknown;                     // McpClientManager (MCP-first reads)
+  walletAddress?: string;                   // User's Sui address — populated into onAutoExecuted
+  suiRpcUrl?: string;                       // Sui JSON-RPC URL for direct chain queries
+  tools?: Tool[];                           // Custom tool set (defaults to getDefaultTools())
+  systemPrompt?: string | SystemBlock[];    // Override default Audric prompt
+  model?: string;                           // LLM model override
+  maxTurns?: number;                        // Max conversation turns (default: 10)
+  maxTokens?: number;                       // Max tokens per response (default: 4096)
+
+  // [v1.4 BlockVision] Pricing + portfolio
+  blockvisionApiKey?: string;               // BlockVision Indexer key — degrades to Sui RPC if absent
+  portfolioCache?: Map<string, AddressPortfolio>; // Per-request portfolio memoisation across read tools
+
+  // Reasoning engine
+  guards?: GuardConfig;                     // Guard runner (RE-2.2)
+  recipes?: RecipeRegistry;                 // YAML skill recipes (RE-3.1)
+  contextBudget?: ContextBudgetConfig;      // 200k limit, compaction trigger (RE-3.3)
+  contextSummarizer?: (msgs) => Promise<string>; // LLM summarizer fallback for compaction
+  thinking?: ThinkingConfig;                // Adaptive / extended thinking
+  outputConfig?: OutputConfig;              // Effort hint
+
+  // Permissions + state
+  permissionConfig?: UserPermissionConfig;  // USD-threshold write gating (B.4)
+  priceCache?: Map<string, number>;         // Symbol → USD for permission resolution
+  contacts?: ReadonlyArray<{ name: string; address: string }>; // Trusted send-transfer recipients
+  sessionSpendUsd?: number;                 // Cumulative session auto-execute total
+
+  // Hooks
+  onAutoExecuted?: (info: {                 // [v1.4] Fired after auto-tier write succeeds
+    toolName: string;
+    usdValue: number;
+    walletAddress?: string;                 // Populated from config.walletAddress for cache invalidation
+  }) => void | Promise<void>;
+  onGuardFired?: (guard: GuardMetric) => void; // [v1.4 Item 4] Per-guard observation hook
+  postWriteRefresh?: Record<string, string[]>; // [v1.5] Auto-rerun reads after a successful write
+
   costTracker?: {
-    budgetLimitUsd?: number;      // Kill switch at USD threshold
+    budgetLimitUsd?: number;                // Kill switch at USD threshold
     inputCostPerToken?: number;
     outputCostPerToken?: number;
   };
 }
 ```
 
+> See `packages/engine/src/types.ts` for the canonical interface — additional internal fields and full JSDoc.
+
 ## Event Types
 
 The `submitMessage()` async generator yields `EngineEvent`:
@@ -205,7 +240,7 @@ The `submitMessage()` async generator yields `EngineEvent`:
 | `thinking_done` | — | Extended thinking complete |
 | `tool_start` | `toolName`, `toolUseId`, `input` | Tool execution begins |
 | `tool_result` | `toolName`, `toolUseId`, `result`, `isError` | Tool execution completes |
-| `pending_action` | `action` (PendingAction) | Write tool awaiting client-side execution |
+| `pending_action` | `action` (PendingAction with `attemptId`, `toolUseId`, `turnIndex`, `name`, `input`) | Write tool awaiting client-side execution. `attemptId` is a per-yield UUID — hosts persist it on TurnMetrics and key the resume `updateMany` on it (avoids ambiguous `(sessionId, turnIndex)` updates) |
 | `canvas` | `html` | Interactive HTML visualization from `render_canvas` |
 | `turn_complete` | `stopReason` | Conversation turn finished |
 | `usage` | `inputTokens`, `outputTokens`, `cacheReadTokens?`, `cacheWriteTokens?` | Token usage report |

package/dist/index.d.ts

@@ -338,6 +338,62 @@ declare function extractConversationText(messages: Array<{
     recentUserText: string;
 };
 
+interface PortfolioCoin {
+    coinType: string;
+    symbol: string;
+    decimals: number;
+    /** Raw on-chain amount (string to preserve precision). */
+    balance: string;
+    /** USD spot price; `null` when not available (long-tail, degraded mode). */
+    price: number | null;
+    /** balance/10^decimals * price; `null` when price is `null`. */
+    usdValue: number | null;
+}
+interface AddressPortfolio {
+    coins: PortfolioCoin[];
+    totalUsd: number;
+    pricedAt: number;
+    source: 'blockvision' | 'sui-rpc-degraded';
+}
+/**
+ * One-shot wallet portfolio fetcher. BlockVision returns balances + USD
+ * prices in a single call; on failure we degrade to a Sui-RPC coin fetch
+ * with hardcoded stablecoin pricing. Memoised in-process for `CACHE_TTL_MS`
+ * keyed by `address` so back-to-back tool calls inside the same chat
+ * session (balance_check + portfolio_analysis) share the same response.
+ */
+declare function fetchAddressPortfolio(address: string, apiKey: string | undefined, fallbackRpcUrl?: string): Promise<AddressPortfolio>;
+/**
+ * Multi-token price lookup. Returns a map of coinType → `{ price, change24h }`
+ * with the `change24h` field populated when BlockVision returns it.
+ * Hardcoded stable allow-list short-circuits before the network call so
+ * USDC/USDT lookups don't pay the BlockVision RTT. Chunks transparently
+ * (BlockVision caps `tokenIds` at 10 per call). Cached in-process for
+ * `CACHE_TTL_MS` with merge-on-miss semantics — a cache containing 8 of 10
+ * requested coins fetches only the missing 2 instead of throwing the
+ * whole map away.
+ */
+declare function fetchTokenPrices(coinTypes: string[], apiKey: string | undefined): Promise<Record<string, {
+    price: number;
+    change24h?: number;
+}>>;
+declare function clearPortfolioCache(): void;
+/**
+ * [v1.4 — Day 2.5] Per-address invalidator. The module-level
+ * `portfolioCache` carries a 60s TTL — long enough to outlive a
+ * `save_deposit` / `swap_execute` / etc. plus the engine's 1.5s
+ * Sui-RPC-indexer-lag delay, so without explicit invalidation
+ * `runPostWriteRefresh` would re-fetch the *cached pre-write
+ * snapshot*. Engine calls this from `runPostWriteRefresh` right
+ * before the lag-delay so the next `fetchAddressPortfolio` for the
+ * affected address is forced to hit BlockVision again.
+ *
+ * No-op when `address` doesn't match a cached entry — cheap to call
+ * unconditionally on every write.
+ */
+declare function clearPortfolioCacheFor(address: string): void;
+declare function clearPriceMapCache(): void;
+
 /**
  * USD-aware permission resolution for write tools.
  *
@@ -614,6 +670,18 @@ interface PendingAction {
      * `apps/web/app/api/engine/resume/route.ts` `updateMany` clause.
      */
     turnIndex: number;
+    /**
+     * [v1.4.2 — Day 3 / Spec Item 3] Per-yield random identifier (UUID v4)
+     * stamped at the moment the engine emits this `pending_action`. Hosts
+     * persist it on the `TurnMetrics` row at chat-time and key the resume
+     * route's `updateMany` on it instead of `(sessionId, turnIndex)` — that
+     * pair is ambiguous when the same turn yields a second pending action
+     * (e.g. user edits → re-yield) or when a backfill leaves multiple rows
+     * matching the pair, which is exactly the false-resolution bug Item 3
+     * exists to kill. Also survives session persistence so the resume call
+     * can read it back from the rehydrated `PendingAction`.
+     */
+    attemptId: string;
 }
 /**
  * Response from the client when resolving a pending action.
@@ -651,6 +719,25 @@ interface ToolContext {
      * value would exceed the limit. Optional; omitted = unbounded.
      */
     sessionSpendUsd?: number;
+    /**
+     * [v1.4 BlockVision] Server-only BlockVision Indexer API key. Threaded
+     * through from the host (`audric/apps/web` reads
+     * `process.env.BLOCKVISION_API_KEY`). Forwarded to
+     * `fetchAddressPortfolio` / `fetchTokenPrices` in `blockvision-prices.ts`.
+     * When undefined / empty the price feed degrades to Sui RPC + the
+     * hardcoded stable allow-list — wallets still render but non-stable
+     * USD values are reported as `null`.
+     */
+    blockvisionApiKey?: string;
+    /**
+     * [v1.4 BlockVision] Per-request memoization of the BlockVision portfolio
+     * response. Keyed by Sui address. Multiple read tools (`balance_check`,
+     * `portfolio_analysis`) inside the same chat turn re-hit the same address;
+     * sharing this Map across them avoids a second 200–500ms BlockVision RTT.
+     * The `blockvision-prices` module also has its own TTL cache, so this is
+     * primarily a fast-path optimisation rather than a correctness primitive.
+     */
+    portfolioCache?: Map<string, AddressPortfolio>;
 }
 interface ServerPositionData {
     savings: number;
@@ -800,15 +887,34 @@ interface EngineConfig {
      * enforce `autonomousDailyLimit`.
      */
     sessionSpendUsd?: number;
+    /**
+     * [v1.4 BlockVision] Server-only BlockVision Indexer API key. Forwarded
+     * verbatim into `ToolContext.blockvisionApiKey` for read tools that hit
+     * `api.blockvision.org` (`balance_check`, `portfolio_analysis`,
+     * `token_prices`). When omitted, those tools degrade gracefully to a
+     * Sui-RPC + hardcoded-stable fallback — see `blockvision-prices.ts`.
+     */
+    blockvisionApiKey?: string;
+    /**
+     * [v1.4 BlockVision] Per-request portfolio cache shared across read
+     * tools in the same chat turn. Forwarded into `ToolContext.portfolioCache`.
+     */
+    portfolioCache?: Map<string, AddressPortfolio>;
     /**
      * [v1.4] Fired after a write tool successfully auto-executes (no
      * confirmation required). Hosts use this to persist cumulative spend in
-     * Redis. Errors are caught — the tool result is never blocked by a failure
-     * here.
+     * Redis and (post-v1.4 BlockVision swap) invalidate cross-session caches
+     * keyed by the user's wallet address. Errors are caught — the tool
+     * result is never blocked by a failure here.
+     *
+     * The `walletAddress` field is populated from the engine's
+     * `config.walletAddress`; it's absent only on unauthenticated engines
+     * (which never auto-execute a real write).
      */
     onAutoExecuted?: (info: {
         toolName: string;
         usdValue: number;
+        walletAddress?: string;
     }) => void | Promise<void>;
     /**
      * [v1.4 Item 4] Per-guard observation hook. Forwarded to `runGuards`
@@ -980,6 +1086,8 @@ declare class QueryEngine {
     private readonly sessionSpendUsd;
     private readonly onAutoExecuted;
     private readonly onGuardFired;
+    private readonly blockvisionApiKey;
+    private readonly portfolioCache;
     private readonly postWriteRefresh;
     private matchedRecipe;
     private messages;
@@ -2100,6 +2208,7 @@ interface PortfolioResult {
     savingsApy?: number;
     dailyEarning?: number;
     weekChange?: WeekChange;
+    priceSource: AddressPortfolio['source'];
 }
 declare const portfolioAnalysisTool: Tool<{
     address?: string | undefined;
@@ -2168,66 +2277,20 @@ declare const activitySummaryTool: Tool<{
     period?: "month" | "year" | "all" | "week" | undefined;
 }, ActivitySummary>;
 
-declare const defillamaYieldPoolsTool: Tool<{
-    stableOnly?: boolean | undefined;
-    limit?: number | undefined;
-    chain?: string | undefined;
-    project?: string | undefined;
-    minTvl?: number | undefined;
-}, Record<string, unknown> | unknown[]>;
-declare const defillamaProtocolInfoTool: Tool<{
-    name: string;
-}, {
-    name: string;
-    category: string;
-    chains: string[];
-    tvl: number;
-    change1d: number | undefined;
-    change7d: number | undefined;
-    url: string;
-    description: string | undefined;
-}>;
-declare const defillamaTokenPricesTool: Tool<{
+declare const tokenPricesTool: Tool<{
     coinTypes: string[];
-}, {
+    include24hChange?: boolean | undefined;
+}, ({
     coinType: string;
     symbol: string;
     price: number;
-}[]>;
-declare const defillamaPriceChangeTool: Tool<{
+    change24h?: number;
+} | {
     coinType: string;
-    period?: "1h" | "24h" | "7d" | "30d" | undefined;
-}, {
     symbol: string;
-    currentPrice: number;
-    historicalPrice: number | null;
-    change: number | null;
-    period: "1h" | "24h" | "7d" | "30d";
-}>;
-declare const defillamaChainTvlTool: Tool<{
-    limit?: number | undefined;
-}, {
-    rank: number;
-    chain: string;
-    tvl: number;
-}[]>;
-declare const defillamaProtocolFeesTool: Tool<{
-    limit?: number | undefined;
-    chain?: string | undefined;
-}, {
-    name: string;
-    fees24h: number | null;
-    fees7d: number | null;
-    category: string | undefined;
-}[]>;
-declare const defillamaSuiProtocolsTool: Tool<{
-    limit?: number | undefined;
-}, {
-    name: string;
-    slug: string;
-    tvl: number;
-    category: string;
-}[]>;
+    price: null;
+    priceUnavailable: boolean;
+})[]>;
 
 declare const READ_TOOLS: Tool[];
 declare const WRITE_TOOLS: Tool[];
@@ -2292,19 +2355,6 @@ interface WalletCoin {
  */
 declare function fetchWalletCoins(address: string, rpcUrl?: string): Promise<WalletCoin[]>;
 
-/**
- * Batch-fetch USD prices for Sui coin types from DefiLlama.
- * Returns a map of `coinType -> usdPrice`. Tokens not found return no entry.
- *
- * Cache behavior (post-0.47): merge-on-miss. If the cache is valid but missing
- * a few requested coin types, we fetch ONLY the missing ones and merge them
- * into the cached map — instead of throwing the entire cache away. This is
- * the common path when a wallet adds one new memecoin to a portfolio that
- * already has USDC/SUI prices cached. Saves ~0.5–1.5s on warm calls.
- */
-declare function fetchTokenPrices(coinTypes: string[]): Promise<Record<string, number>>;
-declare function clearPriceCache(): void;
-
-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 40 tools, Reasoning Engine with 9 guards and 7 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- Lead with the result. After tool calls, state the outcome with real numbers. Done.\n- Present amounts as $1,234.56 and rates as X.XX% APY.\n- Show top 3 results unless asked for more. Summarize totals in one line.\n\n## Execution rule\nOnly offer to execute actions you have tools for. If you retrieved a quote, data, or information but have no tool to act on it, give the user the result and tell them where to execute manually \u2014 in one sentence. Never say \"Would you like me to proceed?\" unless you have a tool that can actually proceed.\n\n## Before acting\n- ALWAYS call a read tool first before any write tool \u2014 balance_check before save/send/borrow, savings_info before withdraw.\n- Show real numbers from tools \u2014 never fabricate rates, amounts, or balances.\n- When user says \"all\" or an imprecise amount, call the read tool first to get the exact number.\n\n## Tool usage\n- Use tools proactively \u2014 don't refuse requests you can handle.\n- For real-world questions (weather, search, news, prices), use pay_api. Tell the user the cost first.\n- For broad market data (yields across protocols, token prices, TVL, protocol comparisons), use defillama_* tools.\n- To discover Sui protocols, use defillama_sui_protocols first, then defillama_protocol_info with the slug.\n- Run multiple read-only tools in parallel when you need several data points.\n- If a tool errors, say what went wrong and what to try instead. One sentence.\n\n## Savings = USDC only (critical)\n- save_deposit accepts ONLY USDC. No other token can be deposited into savings.\n- When asked \"how much can I save?\", report only the user's USDC wallet balance (saveableUsdc field from balance_check). Other tokens like GOLD, SUI, USDT are NOT saveable and NOT savings positions \u2014 they are just wallet holdings.\n- NEVER say a non-USDC token is \"in savings\" or \"earning APY in savings\" unless it appears in the savings_info positions list. Wallet holdings \u2260 savings.\n- If user wants to save non-USDC tokens, tell them to swap to USDC first. Do NOT auto-chain swap + deposit.\n\n## Multi-step flows\n- \"How much X for Y?\": swap_quote first, then swap_execute if user confirms.\n- \"Swap then save\": swap_execute \u2192 balance_check \u2192 save_deposit. Confirm each step.\n- \"Buy $X of token\": defillama_token_prices \u2192 calculate amount \u2192 swap_execute.\n- \"Best yield on SUI\": compare rates_info (NAVI lending) + defillama_yield_pools (broader) + volo_stats.\n- 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 is USDC only.\n- \"What protocols are on Sui?\": defillama_sui_protocols \u2192 defillama_protocol_info for details.\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.";
+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 9 guards and 7 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- Lead with the result. After tool calls, state the outcome with real numbers. Done.\n- Present amounts as $1,234.56 and rates as X.XX% APY.\n- Show top 3 results unless asked for more. Summarize totals in one line.\n\n## Execution rule\nOnly offer to execute actions you have tools for. If you retrieved a quote, data, or information but have no tool to act on it, give the user the result and tell them where to execute manually \u2014 in one sentence. Never say \"Would you like me to proceed?\" unless you have a tool that can actually proceed.\n\n## Before acting\n- ALWAYS call a read tool first before any write tool \u2014 balance_check before save/send/borrow, savings_info before withdraw.\n- Show real numbers from tools \u2014 never fabricate rates, amounts, or balances.\n- When user says \"all\" or an imprecise amount, call the read tool first to get the exact number.\n\n## Tool usage\n- Use tools proactively \u2014 don't refuse requests you can handle.\n- For real-world questions (weather, search, news, prices), use pay_api. Tell the user the cost first.\n- For 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 only (critical)\n- save_deposit accepts ONLY USDC. No other token can be deposited into savings.\n- When asked \"how much can I save?\", report only the user's USDC wallet balance (saveableUsdc field from balance_check). Other tokens like GOLD, SUI, USDT are NOT saveable and NOT savings positions \u2014 they are just wallet holdings.\n- NEVER say a non-USDC token is \"in savings\" or \"earning APY in savings\" unless it appears in the savings_info positions list. Wallet holdings \u2260 savings.\n- If user wants to save non-USDC tokens, tell them to swap to USDC first. Do NOT auto-chain swap + deposit.\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 is USDC only.\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.";
 
-export { AnthropicProvider, type AnthropicProviderConfig, type BalancePrices, type BalanceResult, BalanceTracker, type BuildToolOptions, CANVAS_TEMPLATES, type CanvasTemplate, type ChatParams, type CompactOptions, type ContentBlock, ContextBudget, type ContextBudgetConfig, type ConversationState, type ConversationStateStore, type CostSnapshot, CostTracker, type CostTrackerConfig, DEFAULT_GUARD_CONFIG, DEFAULT_PERMISSION_CONFIG, DEFAULT_SYSTEM_PROMPT, EarlyToolDispatcher, type EngineConfig, type EngineEvent, type GuardCheckResult, type GuardConfig, type GuardEvent, type GuardInjection, type GuardResult, type GuardRunnerState, type GuardTier, type GuardVerdict, type HealthFactorResult, type LLMProvider, type McpCallResult, McpClientManager, McpResponseCache, type McpServerConfig, type McpServerConnection, type McpToolAdapterConfig, type McpToolDescriptor, MemorySessionStore, type Message, NAVI_MCP_CONFIG, NAVI_MCP_URL, NAVI_SERVER_NAME, type NaviRawCoin, type NaviRawHealthFactor, type NaviRawPool, type NaviRawPosition, type NaviRawPositionsResponse, type NaviRawProtocolStats, type NaviRawRewardsResponse, type NaviReadOptions, NaviTools, type OutputConfig, PERMISSION_PRESETS, type PendingAction, type PendingActionModifiableField, type PendingReward, type PendingToolCall, type PermissionLevel, type PermissionOperation, type PermissionResponse, type PermissionRule, type PositionEntry, type PreflightResult, type ProtocolStats, type ProviderEvent, QueryEngine, READ_TOOLS, type RatesResult, type Recipe, type RecipePrerequisite, RecipeRegistry, type RecipeStep, type RecipeStepOnError, RetryTracker, type SSEEvent, type SavingsResult, type ServerPositionData, type SessionData, type SessionStore, type StateType, type StopReason, type SuiCoinBalance, type SystemBlock, type SystemPrompt, TOOL_FLAGS, TOOL_MODIFIABLE_FIELDS, type ThinkingConfig, type ThinkingEffort, type Tool, type ToolChoice, type ToolContext, type ToolDefinition, type ToolFlags, type ToolJsonSchema, type ToolResult, TxMutex, type UserFinancialProfile, type UserPermissionConfig, WRITE_TOOLS, type WalletCoin, activitySummaryTool, adaptAllMcpTools, adaptAllServerTools, adaptMcpTool, applyToolFlags, balanceCheckTool, borrowTool, budgetToolResult, buildCachedSystemPrompt, buildMcpTools, buildProactivenessInstructions, buildProfileContext, buildSelfEvaluationInstruction, buildStateContext, buildTool, claimRewardsTool, classifyEffort, clearPriceCache, compactMessages, createGuardRunnerState, defillamaChainTvlTool, defillamaPriceChangeTool, defillamaProtocolFeesTool, defillamaProtocolInfoTool, defillamaSuiProtocolsTool, defillamaTokenPricesTool, defillamaYieldPoolsTool, engineToSSE, estimateTokens, explainTxTool, extractConversationText, extractMcpText, fetchAvailableRewards, fetchBalance, fetchHealthFactor, fetchPositions, fetchProtocolStats, fetchRates, fetchSavings, fetchTokenPrices, fetchWalletCoins, findTool, getDefaultTools, getMcpManager, getModifiableFields, getToolFlags, getWalletAddress, guardArtifactPreview, guardStaleData, hasNaviMcp, healthCheckTool, loadRecipes, microcompact, mppServicesTool, parseMcpJson, parseRecipe, parseSSE, payApiTool, portfolioAnalysisTool, protocolDeepDiveTool, ratesInfoTool, registerEngineTools, renderCanvasTool, repayDebtTool, requireAgent, resolvePermissionTier, resolveUsdValue, runGuards, runTools, saveContactTool, saveDepositTool, savingsInfoTool, sendTransferTool, serializeSSE, spendingAnalyticsTool, swapExecuteTool, swapQuoteTool, toolNameToOperation, toolsToDefinitions, transactionHistoryTool, transformBalance, transformHealthFactor, transformPositions, transformRates, transformRewards, transformSavings, updateGuardStateAfterToolResult, validateHistory, voloStakeTool, voloStatsTool, voloUnstakeTool, webSearchTool, withdrawTool, yieldSummaryTool };
+export { type AddressPortfolio, AnthropicProvider, type AnthropicProviderConfig, type BalancePrices, type BalanceResult, BalanceTracker, type BuildToolOptions, CANVAS_TEMPLATES, type CanvasTemplate, type ChatParams, type CompactOptions, type ContentBlock, ContextBudget, type ContextBudgetConfig, type ConversationState, type ConversationStateStore, type CostSnapshot, CostTracker, type CostTrackerConfig, DEFAULT_GUARD_CONFIG, DEFAULT_PERMISSION_CONFIG, DEFAULT_SYSTEM_PROMPT, EarlyToolDispatcher, type EngineConfig, type EngineEvent, type GuardCheckResult, type GuardConfig, type GuardEvent, type GuardInjection, type GuardResult, type GuardRunnerState, type GuardTier, type GuardVerdict, type HealthFactorResult, type LLMProvider, type McpCallResult, McpClientManager, McpResponseCache, type McpServerConfig, type McpServerConnection, type McpToolAdapterConfig, type McpToolDescriptor, MemorySessionStore, type Message, NAVI_MCP_CONFIG, NAVI_MCP_URL, NAVI_SERVER_NAME, type NaviRawCoin, type NaviRawHealthFactor, type NaviRawPool, type NaviRawPosition, type NaviRawPositionsResponse, type NaviRawProtocolStats, type NaviRawRewardsResponse, type NaviReadOptions, NaviTools, type OutputConfig, PERMISSION_PRESETS, type PendingAction, type PendingActionModifiableField, type PendingReward, type PendingToolCall, type PermissionLevel, type PermissionOperation, type PermissionResponse, type PermissionRule, type PortfolioCoin, type PositionEntry, type PreflightResult, type ProtocolStats, type ProviderEvent, QueryEngine, READ_TOOLS, type RatesResult, type Recipe, type RecipePrerequisite, RecipeRegistry, type RecipeStep, type RecipeStepOnError, RetryTracker, type SSEEvent, type SavingsResult, type ServerPositionData, type SessionData, type SessionStore, type StateType, type StopReason, type SuiCoinBalance, type SystemBlock, type SystemPrompt, TOOL_FLAGS, TOOL_MODIFIABLE_FIELDS, type ThinkingConfig, type ThinkingEffort, type Tool, type ToolChoice, type ToolContext, type ToolDefinition, type ToolFlags, type ToolJsonSchema, type ToolResult, TxMutex, type UserFinancialProfile, type UserPermissionConfig, WRITE_TOOLS, type WalletCoin, activitySummaryTool, adaptAllMcpTools, adaptAllServerTools, adaptMcpTool, applyToolFlags, balanceCheckTool, borrowTool, budgetToolResult, buildCachedSystemPrompt, buildMcpTools, buildProactivenessInstructions, buildProfileContext, buildSelfEvaluationInstruction, buildStateContext, buildTool, claimRewardsTool, classifyEffort, clearPortfolioCache, clearPortfolioCacheFor, clearPriceMapCache, compactMessages, createGuardRunnerState, engineToSSE, estimateTokens, explainTxTool, extractConversationText, extractMcpText, fetchAddressPortfolio, fetchAvailableRewards, fetchBalance, fetchHealthFactor, fetchPositions, fetchProtocolStats, fetchRates, fetchSavings, fetchTokenPrices, fetchWalletCoins, findTool, getDefaultTools, getMcpManager, getModifiableFields, getToolFlags, getWalletAddress, guardArtifactPreview, guardStaleData, hasNaviMcp, healthCheckTool, loadRecipes, microcompact, mppServicesTool, parseMcpJson, parseRecipe, parseSSE, payApiTool, portfolioAnalysisTool, protocolDeepDiveTool, ratesInfoTool, registerEngineTools, renderCanvasTool, repayDebtTool, requireAgent, resolvePermissionTier, resolveUsdValue, runGuards, runTools, saveContactTool, saveDepositTool, savingsInfoTool, sendTransferTool, serializeSSE, spendingAnalyticsTool, swapExecuteTool, swapQuoteTool, tokenPricesTool, toolNameToOperation, toolsToDefinitions, transactionHistoryTool, transformBalance, transformHealthFactor, transformPositions, transformRates, transformRewards, transformSavings, updateGuardStateAfterToolResult, validateHistory, voloStakeTool, voloStatsTool, voloUnstakeTool, webSearchTool, withdrawTool, yieldSummaryTool };