@t2000/engine 0.40.4 → 0.41.0

package/dist/index.d.ts

@@ -189,6 +189,19 @@ interface GuardEvent {
     tier: GuardTier;
     message?: string;
 }
+/**
+ * [v1.4 Item 4] Per-guard metric emitted via `EngineConfig.onGuardFired`.
+ * Hosts (e.g. audric `TurnMetricsCollector`) accumulate these for the
+ * `TurnMetrics.guardsFired` JSON column. Mirrors `GuardEvent` but with
+ * a coarser tri-state action (allow/warn/block) so the host doesn't
+ * need to know the engine's verdict vocabulary.
+ */
+interface GuardMetric {
+    name: string;
+    tier: GuardTier;
+    action: 'allow' | 'warn' | 'block';
+    injectionAdded: boolean;
+}
 interface GuardConfig {
     balanceValidation?: boolean;
     healthFactor?: {
@@ -236,7 +249,14 @@ declare function createGuardRunnerState(): GuardRunnerState;
 declare function runGuards(tool: Tool, call: PendingToolCall, state: GuardRunnerState, config: GuardConfig, conversationContext: {
     fullText: string;
     lastAssistantText: string;
-}): GuardCheckResult;
+}, 
+/**
+ * [v1.4 Item 4] Optional per-guard observation hook. Fired exactly
+ * once per non-`pass` guard verdict (i.e. for every event that ends
+ * up in `events`/`injections`/`block`). Errors thrown by the host
+ * are caught so a misbehaving collector can't break tool execution.
+ */
+onGuardFired?: (guard: GuardMetric) => void): GuardCheckResult;
 declare function updateGuardStateAfterToolResult(toolName: string, tool: Tool | undefined, input: unknown, result: unknown, isError: boolean, state: GuardRunnerState): void;
 declare function extractConversationText(messages: Array<{
     role: string;
@@ -338,7 +358,16 @@ declare const PERMISSION_PRESETS: {
         })[];
     };
 };
-declare function resolvePermissionTier(operation: string, amountUsd: number, config: UserPermissionConfig): 'auto' | 'confirm' | 'explicit';
+/**
+ * Resolve the permission tier for a given operation + USD value.
+ *
+ * [v1.4] When `sessionSpendUsd` is supplied and adding the incoming
+ * `amountUsd` would push cumulative session spend over
+ * `config.autonomousDailyLimit`, an otherwise-`auto` tier is downgraded to
+ * `confirm`. This is the runtime guard for the daily autonomous spend cap.
+ * Tiers above `auto` are returned unchanged.
+ */
+declare function resolvePermissionTier(operation: string, amountUsd: number, config: UserPermissionConfig, sessionSpendUsd?: number): 'auto' | 'confirm' | 'explicit';
 declare function toolNameToOperation(toolName: string): PermissionOperation | undefined;
 /**
  * Resolve the USD value of a tool call from its inputs.
@@ -391,6 +420,18 @@ type EngineEvent = {
     toolUseId: string;
     result: unknown;
     isError: boolean;
+    /**
+     * [v1.4 Item 4] True when the tool was executed by `EarlyToolDispatcher`
+     * (read tools dispatched concurrently before the LLM yields). Hosts
+     * record this in `TurnMetrics.toolsCalled[].wasEarlyDispatched`.
+     */
+    wasEarlyDispatched?: boolean;
+    /**
+     * [v1.4 Item 4] True when this result was synthesized from a previous
+     * identical tool call by `microcompact` deduplication, instead of
+     * actually re-running the tool.
+     */
+    resultDeduped?: boolean;
 } | {
     type: 'pending_action';
     action: PendingAction;
@@ -413,8 +454,36 @@ type EngineEvent = {
     data: unknown;
     title: string;
     toolUseId: string;
+}
+/**
+ * [v1.4 Item 4] Emitted exactly once per agent turn when context-window
+ * compaction fires. Hosts (e.g. audric `TurnMetricsCollector`) flip a
+ * boolean for the `TurnMetrics.compactionTriggered` column. Carries no
+ * payload — `compactMessages` stays a pure function.
+ */
+ | {
+    type: 'compaction';
 };
 type StopReason = 'end_turn' | 'tool_use' | 'max_tokens' | 'max_turns' | 'error';
+/**
+ * [v1.4 Item 6] Describes a single input field on a `PendingAction` that
+ * the host UI may let the user modify before approving. Carried on the
+ * `pending_action` event so clients can render editable controls without
+ * hard-coding per-tool field metadata. See
+ * `packages/engine/src/tools/tool-modifiable-fields.ts` for the registry.
+ */
+interface PendingActionModifiableField {
+    /** Input key on the `PendingAction.input` object (e.g. "amount", "to"). */
+    name: string;
+    /**
+     * UI hint for which control to render.
+     *  - `amount` — numeric input; UI shows a "~Max" hint when balance is known.
+     *  - `address` — Sui address input with paste/scan affordance.
+     */
+    kind: 'amount' | 'address';
+    /** Optional asset symbol (e.g. "USDC", "SUI", "vSUI") for amount fields. */
+    asset?: string;
+}
 /**
  * Serializable description of a write tool that needs user approval.
  * Stored in the session so the client can act on it in a separate request.
@@ -438,6 +507,19 @@ interface PendingAction {
         _hint?: string;
         _warning?: string;
     }>;
+    /**
+     * [v1.4 Item 6] Fields the host UI may let the user modify before
+     * approving. Sourced from `tool-modifiable-fields.ts`. Absent (or
+     * empty) means the action is approve-or-deny only.
+     */
+    modifiableFields?: PendingActionModifiableField[];
+    /**
+     * [v1.4 Item 6] Monotonic turn index (assistant message count) at the
+     * point this pending action was emitted. Hosts use it to update the
+     * matching `TurnMetrics` row when the action resolves — see
+     * `apps/web/app/api/engine/resume/route.ts` `updateMany` clause.
+     */
+    turnIndex: number;
 }
 /**
  * Response from the client when resolving a pending action.
@@ -468,6 +550,13 @@ interface ToolContext {
     priceCache?: Map<string, number>;
     /** Per-user permission config for USD-threshold write tool gating (B.4). */
     permissionConfig?: UserPermissionConfig;
+    /**
+     * [v1.4] Cumulative USD already auto-executed in the current session.
+     * Used by `resolvePermissionTier` to enforce `autonomousDailyLimit` —
+     * downgrades `auto` to `confirm` when adding the incoming tool's USD
+     * value would exceed the limit. Optional; omitted = unbounded.
+     */
+    sessionSpendUsd?: number;
 }
 interface ServerPositionData {
     savings: number;
@@ -587,6 +676,29 @@ interface EngineConfig {
     priceCache?: Map<string, number>;
     /** Per-user permission config for USD-threshold write tool gating (B.4). */
     permissionConfig?: UserPermissionConfig;
+    /**
+     * [v1.4] Cumulative USD already auto-executed in the current session.
+     * Forwarded to `ToolContext` and consulted by `resolvePermissionTier` to
+     * enforce `autonomousDailyLimit`.
+     */
+    sessionSpendUsd?: number;
+    /**
+     * [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.
+     */
+    onAutoExecuted?: (info: {
+        toolName: string;
+        usdValue: number;
+    }) => void | Promise<void>;
+    /**
+     * [v1.4 Item 4] Per-guard observation hook. Forwarded to `runGuards`
+     * and fired once per non-`pass` verdict so hosts can record guard
+     * behaviour in `TurnMetrics.guardsFired` without re-implementing the
+     * verdict→action mapping. Errors thrown by the host are caught.
+     */
+    onGuardFired?: (guard: GuardMetric) => void;
 }
 interface LLMProvider {
     chat(params: ChatParams): AsyncGenerator<ProviderEvent>;
@@ -709,6 +821,9 @@ declare class QueryEngine {
     private readonly contextSummarizer;
     private readonly priceCache;
     private readonly permissionConfig;
+    private readonly sessionSpendUsd;
+    private readonly onAutoExecuted;
+    private readonly onGuardFired;
     private matchedRecipe;
     private messages;
     private abortController;
@@ -983,15 +1098,32 @@ interface ConversationStateStore {
 }
 declare function buildStateContext(state: ConversationState): string;
 
+/**
+ * [v1.4 Item 4] Side-channel return from `microcompact` so callers can
+ * count or surface dedup hits without re-walking the message ledger.
+ * Backwards-compatible: `microcompact(messages)` still returns the
+ * processed `Message[]` (now enriched), and the dedup set lives on the
+ * returned array via a non-enumerable `dedupedToolUseIds` accessor that
+ * the engine reads in its agent loop.
+ */
+interface MicrocompactResult extends Array<Message> {
+    /**
+     * Tool-use IDs whose prior results were replaced with a compact
+     * back-reference during this pass. Empty when nothing matched.
+     */
+    dedupedToolUseIds: Set<string>;
+}
 /**
  * Zero-cost deduplication pass: if the same tool was called with identical
  * inputs earlier in the conversation and the result hasn't changed, replace
  * the full prior result with a compact back-reference. Runs before any
  * LLM-based compaction and costs nothing.
  *
- * Returns a new array — does not mutate the input.
+ * Returns a new array — does not mutate the input. The returned array
+ * carries a `dedupedToolUseIds` property listing every tool-use ID whose
+ * tool_result block was replaced with a back-reference this pass.
  */
-declare function microcompact(messages: readonly Message[]): Message[];
+declare function microcompact(messages: readonly Message[]): MicrocompactResult;
 
 /**
  * EarlyToolDispatcher — dispatches read-only tools mid-stream.
@@ -1421,13 +1553,10 @@ declare const healthCheckTool: Tool<{}, {
 declare const ratesInfoTool: Tool<{}, _t2000_sdk.RatesResult>;
 
 declare const transactionHistoryTool: Tool<{
+    action?: "send" | "swap" | "lending" | "transaction" | undefined;
     date?: string | undefined;
     limit?: number | undefined;
-}, {
-    transactions: _t2000_sdk.TransactionRecord[];
-    count: number;
-    date: string | null;
-}>;
+}, Record<string, unknown>>;
 
 declare const saveDepositTool: Tool<{
     amount: number;
@@ -1519,21 +1648,8 @@ declare const payApiTool: Tool<{
 
 declare const mppServicesTool: Tool<{
     query?: string | undefined;
-}, {
-    services: {
-        id: string;
-        name: string;
-        description: string;
-        categories: string[];
-        endpoints: {
-            url: string;
-            method: string;
-            description: string;
-            price: string;
-        }[];
-    }[];
-    total: number;
-}>;
+    category?: string | undefined;
+}, Record<string, unknown>>;
 
 declare const swapExecuteTool: Tool<{
     amount: number;
@@ -1724,15 +1840,7 @@ declare const defillamaYieldPoolsTool: Tool<{
     chain?: string | undefined;
     project?: string | undefined;
     minTvl?: number | undefined;
-}, {
-    pool: string;
-    protocol: string;
-    chain: string;
-    apy: number;
-    apyBase: number | undefined;
-    apyReward: number | undefined;
-    tvl: number;
-}[]>;
+}, Record<string, unknown> | unknown[]>;
 declare const defillamaProtocolInfoTool: Tool<{
     name: string;
 }, {
@@ -1791,6 +1899,32 @@ declare const READ_TOOLS: Tool[];
 declare const WRITE_TOOLS: Tool[];
 declare function getDefaultTools(): Tool[];
 
+/**
+ * tool-modifiable-fields.ts — Audric Harness Correctness Spec v1.4 / Item 6
+ *
+ * Per-tool registry of input fields the host UI may let the user modify
+ * before approving a `PendingAction`. The engine consults this registry
+ * when emitting a `pending_action` event so the client can render an
+ * editable control without hard-coding tool names in the UI layer.
+ *
+ * The plan reserves modification for amount-bearing write tools where the
+ * user might want to lower the amount before confirming (e.g. "save $50"
+ * → user edits to $30 → engine resumes with the modified input). Tools
+ * absent from this registry have no modifiable fields and the UI renders
+ * a static "approve / deny" pair.
+ */
+
+/**
+ * Tool name → ordered list of modifiable input fields. Order matters for
+ * UI rendering — the first entry typically becomes the prominent control.
+ */
+declare const TOOL_MODIFIABLE_FIELDS: Record<string, PendingActionModifiableField[]>;
+/**
+ * Returns the modifiable fields for a tool name, or `undefined` if the tool
+ * has no modifiable inputs. Used by the engine when emitting `pending_action`.
+ */
+declare function getModifiableFields(toolName: string): PendingActionModifiableField[] | undefined;
+
 declare function requireAgent(context: ToolContext): T2000;
 /**
  * Check if context has an MCP manager with a connected NAVI server
@@ -1834,4 +1968,4 @@ 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\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 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, 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, 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 { 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 };