@t2000/engine 0.5.6 → 0.5.8

package/dist/index.d.ts

@@ -798,10 +798,19 @@ declare const healthCheckTool: Tool<{}, {
 
 declare const ratesInfoTool: Tool<{}, _t2000_sdk.RatesResult>;
 
+interface TxRecord {
+    digest: string;
+    action: string;
+    amount?: number;
+    asset?: string;
+    recipient?: string;
+    timestamp: number;
+    gasCost?: number;
+}
 declare const transactionHistoryTool: Tool<{
     limit?: number | undefined;
 }, {
-    transactions: _t2000_sdk.TransactionRecord[];
+    transactions: TxRecord[];
     count: number;
 }>;
 
@@ -812,7 +821,7 @@ declare const saveDepositTool: Tool<{
     success: boolean;
     tx: string;
     amount: number;
-    asset: "SUI" | "USDC" | "USDT" | "USDe" | "USDsui";
+    asset: string;
     apy: number;
     fee: number;
     gasCost: number;
@@ -826,6 +835,7 @@ declare const withdrawTool: Tool<{
     success: boolean;
     tx: string;
     amount: number;
+    asset: string;
     gasCost: number;
 }>;
 
@@ -1077,6 +1087,6 @@ declare function fetchWalletCoins(address: string, rpcUrl?: string): Promise<Wal
 declare function fetchTokenPrices(coinTypes: string[]): Promise<Record<string, number>>;
 declare function clearPriceCache(): void;
 
-declare const DEFAULT_SYSTEM_PROMPT = "You are a financial agent on Sui. You manage money and access paid APIs via MPP micropayments.\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## 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- save_deposit supports any NAVI asset: USDC (default), USDT, SUI, USDe, USDsui. Pass asset param for non-USDC.\n- \"Deposit SUI to earn yield\": save_deposit with asset=\"SUI\" for NAVI lending, or volo_stake for liquid staking.\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.";
+declare const DEFAULT_SYSTEM_PROMPT = "You are a financial agent on Sui. You manage money and access paid APIs via MPP micropayments.\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## 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- save_deposit supports any NAVI asset: USDC (default), USDT, SUI, WAL, ETH, NAVX, GOLD, USDe, USDsui. Pass asset param for non-USDC.\n- withdraw supports any deposited NAVI asset. Pass asset param to withdraw a specific token.\n- \"Deposit WAL/ETH/SUI to earn yield\": save_deposit with asset=\"WAL\"/\"ETH\"/\"SUI\" for NAVI lending, or volo_stake for SUI liquid staking.\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, type BuildToolOptions, type ChatParams, type CompactOptions, type ContentBlock, type CostSnapshot, CostTracker, type CostTrackerConfig, DEFAULT_SYSTEM_PROMPT, type EngineConfig, type EngineEvent, 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 PendingAction, type PendingReward, type PendingToolCall, type PermissionLevel, type PermissionResponse, type PositionEntry, type ProtocolStats, type ProviderEvent, QueryEngine, READ_TOOLS, type RatesResult, type SSEEvent, type SavingsResult, type ServerPositionData, type SessionData, type SessionStore, type StopReason, type SuiCoinBalance, type Tool, type ToolChoice, type ToolContext, type ToolDefinition, type ToolJsonSchema, type ToolResult, TxMutex, WRITE_TOOLS, type WalletCoin, adaptAllMcpTools, adaptAllServerTools, adaptMcpTool, balanceCheckTool, borrowTool, buildMcpTools, buildTool, claimRewardsTool, clearPriceCache, compactMessages, defillamaChainTvlTool, defillamaPriceChangeTool, defillamaProtocolFeesTool, defillamaProtocolInfoTool, defillamaSuiProtocolsTool, defillamaTokenPricesTool, defillamaYieldPoolsTool, engineToSSE, estimateTokens, extractMcpText, fetchAvailableRewards, fetchBalance, fetchHealthFactor, fetchPositions, fetchProtocolStats, fetchRates, fetchSavings, fetchTokenPrices, fetchWalletCoins, findTool, getDefaultTools, getMcpManager, getWalletAddress, hasNaviMcp, healthCheckTool, mppServicesTool, parseMcpJson, parseSSE, payApiTool, ratesInfoTool, registerEngineTools, repayDebtTool, requireAgent, runTools, saveContactTool, saveDepositTool, savingsInfoTool, sendTransferTool, serializeSSE, swapExecuteTool, swapQuoteTool, toolsToDefinitions, transactionHistoryTool, transformBalance, transformHealthFactor, transformPositions, transformRates, transformRewards, transformSavings, validateHistory, voloStakeTool, voloStatsTool, voloUnstakeTool, withdrawTool };

package/dist/index.js

@@ -161,7 +161,10 @@ var KNOWN_COINS = {
   "0xc060006111016b8a020ad5b33834984a437aaa7d3c74c18e09a95d48aceab08c::coin::COIN": { symbol: "USDT", decimals: 6 },
   "0x375f70cf2ae4c00bf37117d0c85a2c71545e6ee05c4a5c7d282cd66a4504b068::usdt::USDT": { symbol: "USDT", decimals: 6 },
   "0xd0e89b2af5e4910726fbcd8b8dd37bb79b29e5f83f7491bca830e94f7f226d29::eth::ETH": { symbol: "ETH", decimals: 8 },
-  "0x0041f9f9344cac094454cd574e333c4fdb132d7bcc9379bcd4aab485b2a63942::wbtc::WBTC": { symbol: "BTC", decimals: 8 }
+  "0x0041f9f9344cac094454cd574e333c4fdb132d7bcc9379bcd4aab485b2a63942::wbtc::WBTC": { symbol: "BTC", decimals: 8 },
+  "0x356a26eb9e012a68958082340d4c4116e7f55615cf27affcff209cf0ae544f59::wal::WAL": { symbol: "WAL", decimals: 9 },
+  "0xa99b8952d4f7d947ea77fe0ecdcc9e5fc0bcab2841d6e2a5aa00c3044e5544b5::navx::NAVX": { symbol: "NAVX", decimals: 9 },
+  "0x9d297676e7a4b771ab023291377b2adfaa4938fb9080b8d12430e4b108b836a9::xaum::XAUM": { symbol: "GOLD", decimals: 6 }
 };
 async function fetchWalletCoins(address, rpcUrl) {
   const url = rpcUrl || SUI_MAINNET_URL;
@@ -866,6 +869,97 @@ var ratesInfoTool = buildTool({
     };
   }
 });
+var SUI_TYPE = "0x2::sui::SUI";
+var KNOWN_TARGETS = [
+  [/::suilend|::obligation/, "lending"],
+  [/::navi|::incentive_v\d+|::oracle_pro/, "lending"],
+  [/::cetus|::pool/, "swap"],
+  [/::deepbook/, "swap"],
+  [/::transfer::public_transfer/, "send"]
+];
+function resolveOwner(owner) {
+  if (typeof owner === "object" && owner.AddressOwner) return owner.AddressOwner;
+  if (typeof owner === "string") return owner;
+  return null;
+}
+function classifyAction(targets, commandTypes) {
+  for (const target of targets) {
+    for (const [pattern, label] of KNOWN_TARGETS) {
+      if (pattern.test(target)) return label;
+    }
+  }
+  if (commandTypes.includes("TransferObjects") && !commandTypes.includes("MoveCall")) return "send";
+  return "transaction";
+}
+function parseRpcTx(tx, address) {
+  const gasUsed = tx.effects?.gasUsed;
+  const gasCost = gasUsed ? (Number(gasUsed.computationCost) + Number(gasUsed.storageCost) - Number(gasUsed.storageRebate)) / 1e9 : void 0;
+  const moveCallTargets = [];
+  const commandTypes = [];
+  try {
+    const data = tx.transaction?.data;
+    const inner = data?.transaction;
+    const commands = inner?.commands;
+    if (commands) {
+      for (const cmd of commands) {
+        if (cmd.MoveCall) {
+          const mc = cmd.MoveCall;
+          moveCallTargets.push(`${mc.package}::${mc.module}::${mc.function}`);
+          commandTypes.push("MoveCall");
+        } else if (cmd.TransferObjects) {
+          commandTypes.push("TransferObjects");
+        }
+      }
+    }
+  } catch {
+  }
+  const changes = tx.balanceChanges ?? [];
+  const outflows = changes.filter((c) => resolveOwner(c.owner) === address && BigInt(c.amount) < 0n);
+  const inflows = changes.filter((c) => resolveOwner(c.owner) !== address && BigInt(c.amount) > 0n);
+  const primaryOutflow = outflows.filter((c) => c.coinType !== SUI_TYPE).sort((a, b) => Number(BigInt(a.amount) - BigInt(b.amount)))[0] ?? outflows[0];
+  let amount;
+  let asset;
+  let recipient;
+  if (primaryOutflow) {
+    const coinType = primaryOutflow.coinType;
+    const decimals = coinType.includes("::usdc::") ? 6 : 9;
+    amount = Math.abs(Number(BigInt(primaryOutflow.amount))) / 10 ** decimals;
+    asset = coinType === SUI_TYPE ? "SUI" : coinType.includes("::usdc::") ? "USDC" : coinType.split("::").pop() ?? "unknown";
+    const recipientChange = inflows.find((c) => c.coinType === coinType);
+    recipient = recipientChange ? resolveOwner(recipientChange.owner) ?? void 0 : void 0;
+  }
+  return {
+    digest: tx.digest,
+    action: classifyAction(moveCallTargets, commandTypes),
+    amount,
+    asset,
+    recipient,
+    timestamp: Number(tx.timestampMs ?? 0),
+    gasCost
+  };
+}
+async function queryHistoryRpc(rpcUrl, address, limit) {
+  const res = await fetch(rpcUrl, {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify({
+      jsonrpc: "2.0",
+      id: 1,
+      method: "suix_queryTransactionBlocks",
+      params: [
+        { filter: { FromAddress: address }, options: { showEffects: true, showInput: true, showBalanceChanges: true } },
+        null,
+        limit,
+        true
+      ]
+    }),
+    signal: AbortSignal.timeout(1e4)
+  });
+  if (!res.ok) throw new Error(`Sui RPC error: ${res.status}`);
+  const json = await res.json();
+  if (json.error) throw new Error(`RPC error: ${json.error.message}`);
+  return (json.result?.data ?? []).map((tx) => parseRpcTx(tx, address));
+}
 var transactionHistoryTool = buildTool({
   name: "transaction_history",
   description: "Retrieve recent transaction history: past sends, saves, withdrawals, borrows, repayments, and rewards claims. Optionally limit the number of results.",
@@ -883,33 +977,41 @@ var transactionHistoryTool = buildTool({
   },
   isReadOnly: true,
   async call(input, context) {
-    const agent = requireAgent(context);
-    const records = await agent.history({ limit: input.limit ?? 10 });
+    const limit = input.limit ?? 10;
+    if (context.agent) {
+      const agent = requireAgent(context);
+      const records2 = await agent.history({ limit });
+      return {
+        data: { transactions: records2, count: records2.length },
+        displayText: `${records2.length} recent transaction(s)`
+      };
+    }
+    if (!context.walletAddress || !context.suiRpcUrl) {
+      throw new Error("Transaction history requires a wallet address");
+    }
+    const records = await queryHistoryRpc(context.suiRpcUrl, context.walletAddress, limit);
     return {
-      data: {
-        transactions: records,
-        count: records.length
-      },
+      data: { transactions: records, count: records.length },
       displayText: `${records.length} recent transaction(s)`
     };
   }
 });
 var saveDepositTool = buildTool({
   name: "save_deposit",
-  description: "Deposit into NAVI lending to earn yield. Supports USDC (default), USDT, SUI, and other NAVI-supported assets. Always call balance_check first to know the available amount.",
+  description: "Deposit into NAVI lending to earn yield. Supports any NAVI-listed asset: USDC, USDT, SUI, WAL, ETH, NAVX, GOLD, USDe, USDsui. Always call balance_check first to know the available amount.",
   inputSchema: z.object({
     amount: z.number().positive(),
-    asset: z.string().optional().describe("Asset to deposit (default: USDC). Options: USDC, USDT, SUI, USDe, USDsui")
+    asset: z.string().optional().describe("Asset to deposit (default: USDC). Supports: USDC, USDT, SUI, WAL, ETH, NAVX, GOLD, USDe, USDsui")
   }),
   jsonSchema: {
     type: "object",
     properties: {
       amount: {
-        description: "Exact amount to save (call balance_check first to get available amount)"
+        description: "Exact amount to save in token units (call balance_check first)"
       },
       asset: {
         type: "string",
-        description: "Asset to deposit (default: USDC). Options: USDC, USDT, SUI, USDe, USDsui"
+        description: "Asset to deposit (default: USDC). Supports: USDC, USDT, SUI, WAL, ETH, NAVX, GOLD, USDe, USDsui"
       }
     },
     required: ["amount"]
@@ -931,16 +1033,16 @@ var saveDepositTool = buildTool({
         gasCost: result.gasCost,
         savingsBalance: result.savingsBalance
       },
-      displayText: `Saved ${result.amount.toFixed(2)} ${asset} at ${(result.apy * 100).toFixed(2)}% APY (tx: ${result.tx.slice(0, 8)}\u2026)`
+      displayText: `Saved ${result.amount.toFixed(result.amount < 1 ? 6 : 2)} ${asset} at ${(result.apy * 100).toFixed(2)}% APY (tx: ${result.tx.slice(0, 8)}\u2026)`
     };
   }
 });
 var withdrawTool = buildTool({
   name: "withdraw",
-  description: "Withdraw from NAVI lending back to wallet. Supports any deposited asset (USDC, USDT, SUI, etc). Always call savings_info first. Checks health factor to prevent liquidation if there is outstanding debt.",
+  description: "Withdraw from NAVI lending back to wallet. Supports any deposited asset (USDC, USDT, SUI, WAL, ETH, NAVX, GOLD, etc). Always call savings_info first. Checks health factor to prevent liquidation if there is outstanding debt.",
   inputSchema: z.object({
     amount: z.number().positive(),
-    asset: z.string().optional().describe("Asset to withdraw (default: picks largest position). Options: USDC, USDT, SUI, USDe, USDsui")
+    asset: z.string().optional().describe("Asset to withdraw (default: picks largest position). Supports: USDC, USDT, SUI, WAL, ETH, NAVX, GOLD, USDe, USDsui")
   }),
   jsonSchema: {
     type: "object",
@@ -950,7 +1052,7 @@ var withdrawTool = buildTool({
       },
       asset: {
         type: "string",
-        description: "Asset to withdraw (default: picks largest position). Options: USDC, USDT, SUI, USDe, USDsui"
+        description: "Asset to withdraw (default: picks largest position). Supports: USDC, USDT, SUI, WAL, ETH, NAVX, GOLD, USDe, USDsui"
       }
     },
     required: ["amount"]
@@ -963,14 +1065,16 @@ var withdrawTool = buildTool({
       amount: input.amount,
       asset: input.asset
     });
+    const withdrawnAsset = result.asset ?? input.asset ?? "";
     return {
       data: {
         success: result.success,
         tx: result.tx,
         amount: result.amount,
+        asset: withdrawnAsset,
         gasCost: result.gasCost
       },
-      displayText: `Withdrew ${result.amount.toFixed(2)}${input.asset ? " " + input.asset : ""} (tx: ${result.tx.slice(0, 8)}\u2026)`
+      displayText: `Withdrew ${result.amount.toFixed(result.amount < 1 ? 6 : 2)}${withdrawnAsset ? " " + withdrawnAsset : ""} (tx: ${result.tx.slice(0, 8)}\u2026)`
     };
   }
 });
@@ -1753,8 +1857,9 @@ Only offer to execute actions you have tools for. If you retrieved a quote, data
 - "Swap then save": swap_execute \u2192 balance_check \u2192 save_deposit. Confirm each step.
 - "Buy $X of token": defillama_token_prices \u2192 calculate amount \u2192 swap_execute.
 - "Best yield on SUI": compare rates_info (NAVI lending) + defillama_yield_pools (broader) + volo_stats.
-- save_deposit supports any NAVI asset: USDC (default), USDT, SUI, USDe, USDsui. Pass asset param for non-USDC.
-- "Deposit SUI to earn yield": save_deposit with asset="SUI" for NAVI lending, or volo_stake for liquid staking.
+- save_deposit supports any NAVI asset: USDC (default), USDT, SUI, WAL, ETH, NAVX, GOLD, USDe, USDsui. Pass asset param for non-USDC.
+- withdraw supports any deposited NAVI asset. Pass asset param to withdraw a specific token.
+- "Deposit WAL/ETH/SUI to earn yield": save_deposit with asset="WAL"/"ETH"/"SUI" for NAVI lending, or volo_stake for SUI liquid staking.
 - "What protocols are on Sui?": defillama_sui_protocols \u2192 defillama_protocol_info for details.
 
 ## Safety