@t2000/engine 0.5.4 → 0.5.6

package/dist/index.d.ts

@@ -889,6 +889,24 @@ declare const payApiTool: Tool<{
     } | undefined;
 }>;
 
+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;
+}>;
+
 declare const swapExecuteTool: Tool<{
     amount: number;
     to: string;
@@ -939,6 +957,15 @@ declare const voloStatsTool: Tool<{}, {
     totalVSui: number;
 }>;
 
+declare const saveContactTool: Tool<{
+    name: string;
+    address: string;
+}, {
+    saved: boolean;
+    name: string;
+    address: string;
+}>;
+
 declare const defillamaYieldPoolsTool: Tool<{
     limit?: number | undefined;
     chain?: string | undefined;
@@ -1052,4 +1079,4 @@ 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.";
 
-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, parseMcpJson, parseSSE, payApiTool, ratesInfoTool, registerEngineTools, repayDebtTool, requireAgent, runTools, saveDepositTool, savingsInfoTool, sendTransferTool, serializeSSE, swapExecuteTool, swapQuoteTool, toolsToDefinitions, transactionHistoryTool, transformBalance, transformHealthFactor, transformPositions, transformRates, transformRewards, transformSavings, validateHistory, voloStakeTool, voloStatsTool, voloUnstakeTool, withdrawTool };
+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

@@ -1129,29 +1129,11 @@ function estimatePayApiCost(url) {
 }
 var payApiTool = buildTool({
   name: "pay_api",
-  description: `Call any MPP (Machine Payment Protocol) service via on-chain USDC micropayment. The gateway at ${MPP_GATEWAY} hosts 40+ services (88 endpoints). All endpoints accept POST with JSON body. Payment is handled automatically.
+  description: `Execute any MPP gateway service via on-chain USDC micropayment. The gateway at ${MPP_GATEWAY} hosts 40+ services (88 endpoints). Payment is handled automatically.
 
-Popular services and their URLs:
-- Weather: ${MPP_GATEWAY}/openweather/v1/weather (body: {"city":"London"}) \u2014 $0.005
-- Forecast: ${MPP_GATEWAY}/openweather/v1/forecast (body: {"city":"London"}) \u2014 $0.005
-- Web search: ${MPP_GATEWAY}/brave/v1/web/search (body: {"q":"search query"}) \u2014 $0.005
-- AI search: ${MPP_GATEWAY}/perplexity/v1/chat/completions (body: {"model":"sonar","messages":[...]}) \u2014 $0.01
-- Google search: ${MPP_GATEWAY}/serper/v1/search (body: {"q":"query"}) \u2014 $0.005
-- News headlines: ${MPP_GATEWAY}/newsapi/v1/headlines (body: {"country":"us"}) \u2014 $0.005
-- Crypto prices: ${MPP_GATEWAY}/coingecko/v1/price (body: {"ids":"bitcoin,sui","vs_currencies":"usd"}) \u2014 $0.005
-- Stock quotes: ${MPP_GATEWAY}/alphavantage/v1/quote (body: {"symbol":"AAPL"}) \u2014 $0.005
-- FX rates: ${MPP_GATEWAY}/exchangerate/v1/rates (body: {"base":"USD"}) \u2014 $0.005
-- Translate: ${MPP_GATEWAY}/deepl/v1/translate (body: {"text":["hello"],"target_lang":"ES"}) \u2014 $0.005
-- Scrape URL: ${MPP_GATEWAY}/firecrawl/v1/scrape (body: {"url":"https://..."}) \u2014 $0.01
-- Read URL: ${MPP_GATEWAY}/jina/v1/read (body: {"url":"https://..."}) \u2014 $0.005
-- Geocode: ${MPP_GATEWAY}/googlemaps/v1/geocode (body: {"address":"..."}) \u2014 $0.01
-- Directions: ${MPP_GATEWAY}/googlemaps/v1/directions (body: {"origin":"...","destination":"..."}) \u2014 $0.01
-- Places: ${MPP_GATEWAY}/googlemaps/v1/places (body: {"query":"restaurants in Sydney"}) \u2014 $0.01
-- Image gen: ${MPP_GATEWAY}/fal/fal-ai/flux/dev (body: {"prompt":"..."}) \u2014 $0.03
-- Send email: ${MPP_GATEWAY}/resend/v1/emails (body: {"from":"...","to":"...","subject":"...","html":"..."}) \u2014 $0.005
-- Flights: ${MPP_GATEWAY}/serpapi/v1/flights (body: {"departure_id":"SYD","arrival_id":"NRT","outbound_date":"2026-03-01"}) \u2014 $0.01
+Use mpp_services tool first to discover available services and get the correct endpoint URL, required body parameters, and pricing. Then call this tool with the full URL and JSON body.
 
-Always use POST. Construct the URL from the gateway base + path. Pass parameters in JSON body string.`,
+Always use POST. Construct the URL from the gateway base + service path. Pass parameters as a JSON string in body.`,
   inputSchema: z.object({
     url: z.string().url(),
     method: z.enum(["GET", "POST", "PUT", "DELETE"]).optional(),
@@ -1193,6 +1175,63 @@ Always use POST. Construct the URL from the gateway base + path. Pass parameters
     };
   }
 });
+var MPP_GATEWAY2 = "https://mpp.t2000.ai";
+var CATALOG_URL = `${MPP_GATEWAY2}/api/services`;
+var CACHE_TTL2 = 12e4;
+var catalogCache = null;
+async function fetchCatalog() {
+  if (catalogCache && Date.now() - catalogCache.ts < CACHE_TTL2) {
+    return catalogCache.data;
+  }
+  const res = await fetch(CATALOG_URL, { signal: AbortSignal.timeout(1e4) });
+  if (!res.ok) throw new Error(`MPP catalog fetch failed: HTTP ${res.status}`);
+  const data = await res.json();
+  catalogCache = { data, ts: Date.now() };
+  return data;
+}
+function matchesQuery(service, q) {
+  const lower = q.toLowerCase();
+  return service.id.toLowerCase().includes(lower) || service.name.toLowerCase().includes(lower) || service.description.toLowerCase().includes(lower) || service.categories.some((c) => c.toLowerCase().includes(lower)) || service.endpoints.some((e) => e.description.toLowerCase().includes(lower));
+}
+var mppServicesTool = buildTool({
+  name: "mpp_services",
+  description: "Discover available MPP gateway services. Returns service names, descriptions, endpoints with required parameters, and pricing. Use this BEFORE calling pay_api to find the correct URL and body format for any real-world API (weather, search, translation, image generation, email, maps, etc.).",
+  inputSchema: z.object({
+    query: z.string().optional().describe('Filter by keyword (e.g. "postcard", "translate", "weather"). Omit to list all services.')
+  }),
+  jsonSchema: {
+    type: "object",
+    properties: {
+      query: {
+        type: "string",
+        description: 'Filter by keyword (e.g. "postcard", "translate", "weather"). Omit to list all.'
+      }
+    },
+    required: []
+  },
+  isReadOnly: true,
+  async call(input) {
+    const catalog = await fetchCatalog();
+    const filtered = input.query ? catalog.filter((s) => matchesQuery(s, input.query)) : catalog;
+    const services = filtered.map((s) => ({
+      id: s.id,
+      name: s.name,
+      description: s.description,
+      categories: s.categories,
+      endpoints: s.endpoints.map((e) => ({
+        url: `${MPP_GATEWAY2}/${s.id}${e.path}`,
+        method: e.method,
+        description: e.description,
+        price: `$${e.price}`
+      }))
+    }));
+    const summary = input.query ? `Found ${services.length} service(s) matching "${input.query}"` : `${services.length} services available on MPP gateway`;
+    return {
+      data: { services, total: services.length },
+      displayText: summary
+    };
+  }
+});
 var swapExecuteTool = buildTool({
   name: "swap_execute",
   description: "Swap tokens on Sui via Cetus Aggregator (20+ DEXs). Supports any token pair with liquidity. Use user-friendly names (SUI, USDC, CETUS, DEEP, etc.) or full coin types.",
@@ -1358,14 +1397,38 @@ var voloStatsTool = buildTool({
     };
   }
 });
+var saveContactTool = buildTool({
+  name: "save_contact",
+  description: "Save a contact with a friendly name and Sui address so the user can send to them by name later.",
+  inputSchema: z.object({
+    name: z.string().describe('Friendly name for the contact (e.g. "Alex", "Mom")'),
+    address: z.string().describe("Full Sui address (0x...)")
+  }),
+  jsonSchema: {
+    type: "object",
+    properties: {
+      name: { type: "string", description: "Friendly name for the contact" },
+      address: { type: "string", description: "Full Sui address (0x...)" }
+    },
+    required: ["name", "address"]
+  },
+  isReadOnly: false,
+  permissionLevel: "confirm",
+  async call(input) {
+    return {
+      data: { saved: true, name: input.name, address: input.address },
+      displayText: `Saved contact "${input.name}" (${input.address.slice(0, 8)}\u2026)`
+    };
+  }
+});
 var LLAMA_API = "https://api.llama.fi";
 var YIELDS_API = "https://yields.llama.fi";
 var COINS_API = "https://coins.llama.fi";
-var CACHE_TTL2 = 6e4;
+var CACHE_TTL3 = 6e4;
 var apiCache = /* @__PURE__ */ new Map();
 async function cachedFetch(url) {
   const hit = apiCache.get(url);
-  if (hit && Date.now() - hit.ts < CACHE_TTL2) return hit.data;
+  if (hit && Date.now() - hit.ts < CACHE_TTL3) return hit.data;
   const res = await fetch(url, { signal: AbortSignal.timeout(15e3) });
   if (!res.ok) throw new Error(`DefiLlama API error: HTTP ${res.status}`);
   const data = await res.json();
@@ -1633,6 +1696,7 @@ var READ_TOOLS = [
   transactionHistoryTool,
   swapQuoteTool,
   voloStatsTool,
+  mppServicesTool,
   defillamaYieldPoolsTool,
   defillamaProtocolInfoTool,
   defillamaTokenPricesTool,
@@ -1651,7 +1715,8 @@ var WRITE_TOOLS = [
   payApiTool,
   swapExecuteTool,
   voloStakeTool,
-  voloUnstakeTool
+  voloUnstakeTool,
+  saveContactTool
 ];
 function getDefaultTools() {
   return [...READ_TOOLS, ...WRITE_TOOLS];
@@ -2156,6 +2221,11 @@ function validateHistory(messages) {
   }
   return merged;
 }
+function resolveTokenSymbol(nameOrType) {
+  if (!nameOrType.includes("::")) return nameOrType;
+  const parts = nameOrType.split("::");
+  return parts[parts.length - 1];
+}
 function describeAction(tool, call) {
   const input = call.input;
   switch (tool.name) {
@@ -2181,8 +2251,8 @@ function describeAction(tool, call) {
       return `Pay for API call to ${url} (~$${cost})`;
     }
     case "swap_execute": {
-      const from = input.from ?? "?";
-      const to = input.to ?? "?";
+      const from = resolveTokenSymbol(String(input.from ?? "?"));
+      const to = resolveTokenSymbol(String(input.to ?? "?"));
       const amt = input.amount ?? "?";
       const slippagePct = (input.slippage ?? 0.01) * 100;
       return `Swap ${amt} ${from} for ${to} (${slippagePct}% max slippage)`;
@@ -2917,6 +2987,6 @@ function sanitizeAnthropicMessages(messages) {
   return merged;
 }
 
-export { AnthropicProvider, CostTracker, DEFAULT_SYSTEM_PROMPT, McpClientManager, McpResponseCache, MemorySessionStore, NAVI_MCP_CONFIG, NAVI_MCP_URL, NAVI_SERVER_NAME, NaviTools, QueryEngine, READ_TOOLS, TxMutex, WRITE_TOOLS, 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, parseMcpJson, parseSSE, payApiTool, ratesInfoTool, registerEngineTools, repayDebtTool, requireAgent, runTools, saveDepositTool, savingsInfoTool, sendTransferTool, serializeSSE, swapExecuteTool, swapQuoteTool, toolsToDefinitions, transactionHistoryTool, transformBalance, transformHealthFactor, transformPositions, transformRates, transformRewards, transformSavings, validateHistory, voloStakeTool, voloStatsTool, voloUnstakeTool, withdrawTool };
+export { AnthropicProvider, CostTracker, DEFAULT_SYSTEM_PROMPT, McpClientManager, McpResponseCache, MemorySessionStore, NAVI_MCP_CONFIG, NAVI_MCP_URL, NAVI_SERVER_NAME, NaviTools, QueryEngine, READ_TOOLS, TxMutex, WRITE_TOOLS, 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 };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map