@t2000/engine 1.2.1 → 1.4.0

package/README.md

@@ -261,8 +261,11 @@ The `submitMessage()` async generator yields `EngineEvent`:
 | Event | Fields | When |
 |-------|--------|------|
 | `text_delta` | `text` | LLM streams a text chunk |
-| `thinking_delta` | `text` | Extended thinking chunk (reasoning accordion) |
-| `thinking_done` | — | Extended thinking complete |
+| `thinking_delta` | `text`, `blockIndex` | Extended thinking chunk (reasoning accordion). **`blockIndex`** identifies which thinking block this delta belongs to so hosts can render multi-block thinking chronologically (Anthropic streams ≥1 thinking blocks per turn at high effort). |
+| `thinking_done` | `blockIndex`, `signature?`, `summaryMode?`, `evaluationItems?` | Extended thinking block complete. `blockIndex` matches the `thinking_delta` events for that block. **`summaryMode`** flips true and **`evaluationItems`** is populated when the block contained a parseable `<eval_summary>` marker — hosts render `HowIEvaluatedBlock` ("✦ HOW I EVALUATED THIS") from these fields. |
+| `todo_update` | `items`, `toolUseId` | **[SPEC 8 v0.5.1]** Side-channel event paired to every `update_todo` tool call. `items` is the full `TodoItem[]` array; hosts unconditionally replace their rendered list (the tool is idempotent). `toolUseId` keys the render to the originating call. |
+| `tool_progress` | `toolUseId`, `toolName`, `message`, `pct?` | **[SPEC 8 v0.5.1]** Mid-execution progress signal from long-running tools (Cetus swap, protocol_deep_dive, portfolio_analysis). Tools opt in via `context.progress?.(msg, pct?)`. Engine wiring lands with the Cetus SDK integration in a follow-on slice. |
+| `pending_input` | `schema`, `inputId`, `prompt?` | **[SPEC 8 v0.5.1, D2]** Reserved for SPEC 9 v0.1.2 inline forms. Engine doesn't emit under SPEC 8 — host adds a no-op handler now to avoid crashing when SPEC 9 ships emission. |
 | `tool_start` | `toolName`, `toolUseId`, `input` | Tool execution begins |
 | `tool_result` | `toolName`, `toolUseId`, `result`, `isError` | Tool execution completes |
 | `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) |

package/dist/index.d.ts

@@ -584,6 +584,34 @@ declare function toolNameToOperation(toolName: string): PermissionOperation | un
  */
 declare function resolveUsdValue(toolName: string, input: Record<string, unknown>, priceCache: Map<string, number>): number;
 
+type EvaluationStatus = 'good' | 'warning' | 'critical' | 'info';
+interface EvaluationItem {
+    label: string;
+    status: EvaluationStatus;
+    note?: string;
+}
+interface EvalSummaryParseResult {
+    /** Always true when this object is returned (vs null when absent). */
+    summaryMode: true;
+    /** The structured rows the host renders inside the trust card. */
+    evaluationItems: EvaluationItem[];
+    /** Count of markers detected — >1 indicates an LLM compliance violation. */
+    markerCount: number;
+}
+/**
+ * Scan a thinking-block text for one or more `<eval_summary>` markers.
+ *
+ * - Returns null when no marker is present, or when the first marker's
+ *   JSON is malformed (host falls back to standard rendering).
+ * - Returns a parsed result when at least one marker contains valid JSON.
+ *   `markerCount` reflects the total number of markers seen so the
+ *   engine can emit a `evalSummaryViolationsCount` telemetry counter
+ *   when N > 1 (LLM is supposed to emit at most one per turn).
+ *
+ * The function is pure — safe to call per-thinking-block.
+ */
+declare function parseEvalSummary(thinkingText: string): EvalSummaryParseResult | null;
+
 type ContentBlock = {
     type: 'text';
     text: string;
@@ -609,12 +637,34 @@ interface Message {
     role: 'user' | 'assistant';
     content: ContentBlock[];
 }
-type EngineEvent = {
+type EngineEvent = 
+/**
+ * [SPEC 8 v0.5.1] `blockIndex` identifies which thinking block this delta
+ * belongs to. Anthropic streams multi-block thinking with rising indices
+ * across each turn (block 0, 1, 2, ...). Hosts use this to render
+ * chronologically interleaved thinking accordions instead of flattening
+ * every delta into one string. Backwards-compatible: older hosts that
+ * ignore the field still see deltas in emission order.
+ */
+{
     type: 'thinking_delta';
     text: string;
-} | {
+    blockIndex: number;
+}
+/**
+ * [SPEC 8 v0.5.1] When the thinking block contained a parseable
+ * `<eval_summary>...</eval_summary>` marker, `summaryMode` flips true
+ * and `evaluationItems` carries the structured rows. Hosts render the
+ * `HowIEvaluatedBlock` ("✦ HOW I EVALUATED THIS") trust card from
+ * these fields. Both undefined when the block had no marker (every
+ * read-only and most write turns).
+ */
+ | {
     type: 'thinking_done';
+    blockIndex: number;
     signature?: string;
+    summaryMode?: boolean;
+    evaluationItems?: EvaluationItem[];
 } | {
     type: 'text_delta';
     text: string;
@@ -682,7 +732,70 @@ type EngineEvent = {
  */
  | {
     type: 'compaction';
+}
+/**
+ * [SPEC 8 v0.5.1] Side-channel event paired to every `update_todo` tool
+ * call. Hosts render the persistent todo card from this event (NOT from
+ * the tool_result — see `tools/update-todo.ts` § "side-channel" for
+ * rationale). Carries the full items array so the host can
+ * unconditionally replace its rendered list (the tool is idempotent —
+ * each call replaces the previous state). `toolUseId` lets the host
+ * key the render cell to the originating tool call.
+ */
+ | {
+    type: 'todo_update';
+    items: TodoItem$1[];
+    toolUseId: string;
+}
+/**
+ * [SPEC 8 v0.5.1] Mid-execution progress signal from a long-running tool
+ * (Cetus swap_execute 2-5s, protocol_deep_dive 3-8s, portfolio_analysis
+ * 1-2s). Tools opt in by calling `context.progress?.(msg, pct?)` from
+ * inside their `call` implementation. Hosts render the message + bar
+ * inside the corresponding tool block's spinner — kills the dead-air
+ * static-spinner UX that's the explicit SPEC 8 v0.3 fix target.
+ *
+ * Engine wiring (queue-and-yield in the dispatcher) lands with the
+ * Cetus integration in a follow-on slice. SPEC 8 v0.5.1 reserves the
+ * event type now so hosts can pre-wire the renderer.
+ *
+ * `pct` is 0–100 when the tool can express progress quantitatively,
+ * undefined otherwise (free-text status only).
+ */
+ | {
+    type: 'tool_progress';
+    toolUseId: string;
+    toolName: string;
+    message: string;
+    pct?: number;
+}
+/**
+ * [SPEC 8 v0.5.1, D2] Inline-form structured input event reserved for
+ * SPEC 9 v0.1.2 (`pending_input` form primitive). The engine does NOT
+ * emit this event under SPEC 8 — the type is reserved so legacy hosts
+ * can add a no-op handler now and avoid crashing when SPEC 9 ships
+ * `pending_input` emission. See SPEC 8 § "v0.5 cross-spec coupling
+ * fixes" — gap D2 — for the forward-compat rationale.
+ */
+ | {
+    type: 'pending_input';
+    /** Form schema (shape locked in SPEC 9 v0.1.2; engine treats it opaquely). */
+    schema: unknown;
+    /** Engine round-trip identifier — host posts the answer back keyed on this. */
+    inputId: string;
+    /** Optional human-readable prompt the LLM wants the host to display above the form. */
+    prompt?: string;
 };
+/**
+ * [SPEC 8 v0.5.1] One row in an `update_todo` payload. Mirrored from
+ * `packages/engine/src/tools/update-todo.ts`. Kept here so hosts that
+ * consume `EngineEvent` don't need to depend on the tool module.
+ */
+interface TodoItem$1 {
+    id: string;
+    label: string;
+    status: 'pending' | 'in_progress' | 'completed';
+}
 type StopReason = 'end_turn' | 'tool_use' | 'max_tokens' | 'max_turns' | 'error';
 /**
  * [v1.4 Item 6] Describes a single input field on a `PendingAction` that
@@ -1057,10 +1170,14 @@ interface ToolDefinition {
 type ProviderEvent = {
     type: 'thinking_delta';
     text: string;
+    blockIndex: number;
 } | {
     type: 'thinking_done';
+    blockIndex: number;
     thinking: string;
     signature: string;
+    summaryMode?: boolean;
+    evaluationItems?: EvaluationItem[];
 } | {
     type: 'redacted_thinking';
     data: string;
@@ -1276,9 +1393,13 @@ declare function findTool(tools: Tool[], name: string): Tool | undefined;
 type SSEEvent = {
     type: 'thinking_delta';
     text: string;
+    blockIndex: number;
 } | {
     type: 'thinking_done';
+    blockIndex: number;
     signature?: string;
+    summaryMode?: boolean;
+    evaluationItems?: EvaluationItem[];
 } | {
     type: 'text_delta';
     text: string;
@@ -1317,6 +1438,21 @@ type SSEEvent = {
     data: unknown;
     title: string;
     toolUseId: string;
+} | {
+    type: 'todo_update';
+    items: TodoItem$1[];
+    toolUseId: string;
+} | {
+    type: 'tool_progress';
+    toolUseId: string;
+    toolName: string;
+    message: string;
+    pct?: number;
+} | {
+    type: 'pending_input';
+    schema: unknown;
+    inputId: string;
+    prompt?: string;
 };
 declare function serializeSSE(event: SSEEvent): string;
 declare function parseSSE(raw: string): SSEEvent | null;
@@ -1392,6 +1528,24 @@ declare function getToolFlags(name: string): ToolFlags;
  */
 declare function classifyEffort(model: string, userMessage: string, matchedRecipe: Recipe | null, sessionWriteCount: number): ThinkingEffort;
 
+declare const EFFORT_THINKING_BUDGET_CAPS: Record<ThinkingEffort, number | null>;
+/**
+ * Clamp a `ThinkingConfig` to the HARD cap for the given effort tier.
+ *
+ * - When `effort === 'low'`, returns `{ type: 'disabled' }` regardless of
+ *   input — LEAN tier is non-negotiable.
+ * - When `config.type === 'enabled'` and `config.budgetTokens` exceeds
+ *   the cap, returns a copy with `budgetTokens` clamped down.
+ * - When `config.type === 'adaptive'`, returns it unchanged — adaptive
+ *   mode is shape-agnostic by design (Anthropic decides per-turn).
+ * - When `effort` is undefined, returns `config` unchanged — caller
+ *   hasn't classified the turn yet (back-compat for hosts that don't
+ *   route on effort).
+ *
+ * This function is pure and side-effect-free; safe to call per-turn.
+ */
+declare function clampThinkingForEffort(config: ThinkingConfig | undefined, effort: ThinkingEffort | undefined): ThinkingConfig | undefined;
+
 /**
  * Build a cacheable system prompt array from static and dynamic parts.
  *
@@ -2418,17 +2572,80 @@ declare const activitySummaryTool: Tool<{
 }, ActivitySummary>;
 
 interface ResolveSuinsResult {
-    /** The lookup name, lowercased and trimmed. */
-    name: string;
-    /** The resolved 0x address, or null when the name isn't registered. */
-    address: string | null;
-    /** True when the name resolves to an address. */
-    registered: boolean;
+    /** Direction the lookup ran in. */
+    direction: 'forward' | 'reverse';
+    /** The original query, lowercased. */
+    query: string;
+    /** Forward only: the resolved 0x address (null when unregistered). */
+    address?: string | null;
+    /** Forward only: convenience flag for the LLM. */
+    registered?: boolean;
+    /** Reverse only: every SuiNS name pointing at this address (sorted by registry). */
+    names?: string[];
+    /** Reverse only: the first name in `names` (the conventional "primary"), or null. */
+    primary?: string | null;
 }
 declare const resolveSuinsTool: Tool<{
-    name: string;
+    query: string;
 }, ResolveSuinsResult>;
 
+declare const todoItemSchema: z.ZodObject<{
+    id: z.ZodString;
+    label: z.ZodString;
+    status: z.ZodEnum<["pending", "in_progress", "completed"]>;
+}, "strip", z.ZodTypeAny, {
+    label: string;
+    status: "pending" | "in_progress" | "completed";
+    id: string;
+}, {
+    label: string;
+    status: "pending" | "in_progress" | "completed";
+    id: string;
+}>;
+declare const inputSchema: z.ZodObject<{
+    items: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodString;
+        status: z.ZodEnum<["pending", "in_progress", "completed"]>;
+    }, "strip", z.ZodTypeAny, {
+        label: string;
+        status: "pending" | "in_progress" | "completed";
+        id: string;
+    }, {
+        label: string;
+        status: "pending" | "in_progress" | "completed";
+        id: string;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    items: {
+        label: string;
+        status: "pending" | "in_progress" | "completed";
+        id: string;
+    }[];
+}, {
+    items: {
+        label: string;
+        status: "pending" | "in_progress" | "completed";
+        id: string;
+    }[];
+}>;
+type TodoItem = z.infer<typeof todoItemSchema>;
+type UpdateTodoInput = z.infer<typeof inputSchema>;
+declare const updateTodoTool: Tool<{
+    items: {
+        label: string;
+        status: "pending" | "in_progress" | "completed";
+        id: string;
+    }[];
+}, {
+    __todoUpdate: boolean;
+    items: {
+        label: string;
+        status: "pending" | "in_progress" | "completed";
+        id: string;
+    }[];
+}>;
+
 declare const tokenPricesTool: Tool<{
     coinTypes: string[];
     include24hChange?: boolean | undefined;
@@ -2561,6 +2778,23 @@ declare function resolveSuinsViaRpc(rawName: string, ctx?: {
     suiRpcUrl?: string;
     signal?: AbortSignal;
 }): Promise<string | null>;
+/**
+ * Reverse-resolve a 0x address to its registered SuiNS names via
+ * `suix_resolveNameServiceNames`. Returns the names sorted by the
+ * registry (the first entry is conventionally the user's "primary"
+ * name on dApps that show one), or `[]` when the address has no
+ * SuiNS records. Throws `SuinsRpcError` on RPC/network failure.
+ *
+ * Why this is its own helper (not folded into `normalizeAddressInput`):
+ * a reverse lookup adds a second RPC round-trip per tool call. We don't
+ * want every read tool that takes an `address` to silently double its
+ * latency. The lookup primitive is opt-in via the `resolve_suins` tool;
+ * normalizers stay forward-only.
+ */
+declare function resolveAddressToSuinsViaRpc(rawAddress: string, ctx?: {
+    suiRpcUrl?: string;
+    signal?: AbortSignal;
+}): Promise<string[]>;
 interface NormalizedAddress {
     /**
      * Canonical 0x-prefixed lowercase hex address. Always set on success.
@@ -2997,4 +3231,4 @@ declare function getTelemetrySink(): TelemetrySink;
 /** Restore the default noop sink. Used by test teardowns. */
 declare function resetTelemetrySink(): void;
 
-export { type AddressPortfolio, AnthropicProvider, type AnthropicProviderConfig, type AudricHistoryRecord, type AudricPortfolioResult, type AwaitOrFetchOpts, 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_LEASE_SEC, DEFAULT_PERMISSION_CONFIG, DEFAULT_POLL_BUDGET_MS, DEFAULT_POLL_INTERVAL_MS, DEFAULT_SYSTEM_PROMPT, type DefiCacheEntry, type DefiCacheStore, type DefiProtocol, type DefiSummary, EarlyToolDispatcher, type EngineConfig, type EngineEvent, type FetchLock, type GuardCheckResult, type GuardConfig, type GuardEvent, type GuardInjection, type GuardResult, type GuardRunnerState, type GuardTier, type GuardVerdict, type HealthFactorResult, InMemoryDefiCacheStore, InMemoryFetchLock, InMemoryNaviCacheStore, InMemoryWalletCacheStore, InvalidAddressError, type LLMProvider, type McpCallResult, McpClientManager, McpResponseCache, type McpServerConfig, type McpServerConnection, type McpToolAdapterConfig, type McpToolDescriptor, MemorySessionStore, type Message, NAVI_ADDR_TTL_SEC, NAVI_MCP_CONFIG, NAVI_MCP_URL, NAVI_RATES_TTL_SEC, NAVI_SERVER_NAME, type NaviCacheEntry, type NaviCacheStore, type NaviRawCoin, type NaviRawHealthFactor, type NaviRawPool, type NaviRawPosition, type NaviRawPositionsResponse, type NaviRawProtocolStats, type NaviRawRewardsResponse, type NaviReadOptions, NaviTools, type NormalizedAddress, 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, SUINS_NAME_REGEX, SUI_ADDRESS_REGEX, SUI_ADDRESS_STRICT_REGEX, type SavingsResult, type ServerPositionData, type SessionData, type SessionStore, type StateType, type StopReason, type SuiCoinBalance, SuinsNotRegisteredError, SuinsRpcError, type SystemBlock, type SystemPrompt, TOOL_FLAGS, TOOL_MODIFIABLE_FIELDS, type TelemetrySink, type TelemetryTags, 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 WalletCacheEntry, type WalletCacheStore, type WalletCoin, _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 };
+export { type AddressPortfolio, AnthropicProvider, type AnthropicProviderConfig, type AudricHistoryRecord, type AudricPortfolioResult, type AwaitOrFetchOpts, 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_LEASE_SEC, DEFAULT_PERMISSION_CONFIG, DEFAULT_POLL_BUDGET_MS, DEFAULT_POLL_INTERVAL_MS, DEFAULT_SYSTEM_PROMPT, type DefiCacheEntry, type DefiCacheStore, type DefiProtocol, type DefiSummary, EFFORT_THINKING_BUDGET_CAPS, EarlyToolDispatcher, type EngineConfig, type EngineEvent, type EvalSummaryParseResult, type EvaluationItem, type EvaluationStatus, type FetchLock, type GuardCheckResult, type GuardConfig, type GuardEvent, type GuardInjection, type GuardResult, type GuardRunnerState, type GuardTier, type GuardVerdict, type HealthFactorResult, InMemoryDefiCacheStore, InMemoryFetchLock, InMemoryNaviCacheStore, InMemoryWalletCacheStore, InvalidAddressError, type LLMProvider, type McpCallResult, McpClientManager, McpResponseCache, type McpServerConfig, type McpServerConnection, type McpToolAdapterConfig, type McpToolDescriptor, MemorySessionStore, type Message, NAVI_ADDR_TTL_SEC, NAVI_MCP_CONFIG, NAVI_MCP_URL, NAVI_RATES_TTL_SEC, NAVI_SERVER_NAME, type NaviCacheEntry, type NaviCacheStore, type NaviRawCoin, type NaviRawHealthFactor, type NaviRawPool, type NaviRawPosition, type NaviRawPositionsResponse, type NaviRawProtocolStats, type NaviRawRewardsResponse, type NaviReadOptions, NaviTools, type NormalizedAddress, 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, SUINS_NAME_REGEX, SUI_ADDRESS_REGEX, SUI_ADDRESS_STRICT_REGEX, type SavingsResult, type ServerPositionData, type SessionData, type SessionStore, type StateType, type StopReason, type SuiCoinBalance, SuinsNotRegisteredError, SuinsRpcError, type SystemBlock, type SystemPrompt, TOOL_FLAGS, TOOL_MODIFIABLE_FIELDS, type TelemetrySink, type TelemetryTags, type ThinkingConfig, type ThinkingEffort, type TodoItem$1 as TodoItem, type Tool, type ToolChoice, type ToolContext, type ToolDefinition, type ToolFlags, type ToolJsonSchema, type ToolResult, TxMutex, type UpdateTodoInput, type TodoItem as UpdateTodoItem, type UserFinancialProfile, type UserPermissionConfig, WRITE_TOOLS, type WalletCacheEntry, type WalletCacheStore, type WalletCoin, _resetNaviCircuitBreaker, activitySummaryTool, adaptAllMcpTools, adaptAllServerTools, adaptMcpTool, applyToolFlags, awaitOrFetch, balanceCheckTool, borrowTool, budgetToolResult, buildCachedSystemPrompt, buildMcpTools, buildProactivenessInstructions, buildProfileContext, buildSelfEvaluationInstruction, buildStateContext, buildTool, claimRewardsTool, clampThinkingForEffort, 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, parseEvalSummary, parseMcpJson, parseRecipe, parseSSE, payApiTool, portfolioAnalysisTool, protocolDeepDiveTool, ratesInfoTool, registerEngineTools, renderCanvasTool, repayDebtTool, requireAgent, resetDefiCacheStore, resetFetchLock, resetNaviCacheStore, resetTelemetrySink, resetWalletCacheStore, resolveAddressToSuinsViaRpc, 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, updateTodoTool, validateHistory, voloStakeTool, voloStatsTool, voloUnstakeTool, webSearchTool, withdrawTool, yieldSummaryTool };