@t2000/engine 0.28.9 → 0.29.0

package/dist/index.d.ts

@@ -1091,6 +1091,17 @@ declare const protocolDeepDiveTool: Tool<{
     protocol: string;
 }, ProtocolProfile>;
 
+interface SpendingResponse {
+    period: string;
+    totalSpent: number;
+    requestCount: number;
+    serviceCount: number;
+    byService: unknown[];
+}
+declare const spendingAnalyticsTool: Tool<{
+    period?: "all" | "week" | "month" | "year" | undefined;
+}, SpendingResponse>;
+
 declare const defillamaYieldPoolsTool: Tool<{
     limit?: number | undefined;
     chain?: string | undefined;
@@ -1206,4 +1217,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## 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, type BuildToolOptions, CANVAS_TEMPLATES, type CanvasTemplate, 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, explainTxTool, extractMcpText, fetchAvailableRewards, fetchBalance, fetchHealthFactor, fetchPositions, fetchProtocolStats, fetchRates, fetchSavings, fetchTokenPrices, fetchWalletCoins, findTool, getDefaultTools, getMcpManager, getWalletAddress, hasNaviMcp, healthCheckTool, mppServicesTool, parseMcpJson, parseSSE, payApiTool, portfolioAnalysisTool, protocolDeepDiveTool, ratesInfoTool, registerEngineTools, renderCanvasTool, repayDebtTool, requireAgent, runTools, saveContactTool, saveDepositTool, savingsInfoTool, sendTransferTool, serializeSSE, swapExecuteTool, swapQuoteTool, toolsToDefinitions, transactionHistoryTool, transformBalance, transformHealthFactor, transformPositions, transformRates, transformRewards, transformSavings, validateHistory, voloStakeTool, voloStatsTool, voloUnstakeTool, webSearchTool, withdrawTool };
+export { AnthropicProvider, type AnthropicProviderConfig, type BalancePrices, type BalanceResult, type BuildToolOptions, CANVAS_TEMPLATES, type CanvasTemplate, 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, explainTxTool, extractMcpText, fetchAvailableRewards, fetchBalance, fetchHealthFactor, fetchPositions, fetchProtocolStats, fetchRates, fetchSavings, fetchTokenPrices, fetchWalletCoins, findTool, getDefaultTools, getMcpManager, getWalletAddress, hasNaviMcp, healthCheckTool, mppServicesTool, parseMcpJson, parseSSE, payApiTool, portfolioAnalysisTool, protocolDeepDiveTool, ratesInfoTool, registerEngineTools, renderCanvasTool, repayDebtTool, requireAgent, runTools, saveContactTool, saveDepositTool, savingsInfoTool, sendTransferTool, serializeSSE, spendingAnalyticsTool, swapExecuteTool, swapQuoteTool, toolsToDefinitions, transactionHistoryTool, transformBalance, transformHealthFactor, transformPositions, transformRates, transformRewards, transformSavings, validateHistory, voloStakeTool, voloStatsTool, voloUnstakeTool, webSearchTool, withdrawTool };

package/dist/index.js

@@ -2450,6 +2450,12 @@ var CANVAS_TEMPLATES = [
   "watch_address",
   "full_portfolio"
 ];
+function normalizeSavingsRate(raw, fallback = 4.5) {
+  const r = raw ?? 0;
+  if (r > 0 && r < 1) return r * 100;
+  if (r > 0) return r;
+  return fallback;
+}
 var CANVAS_TITLES = {
   activity_heatmap: "On-Chain Activity",
   portfolio_timeline: "Net Worth Over Time",
@@ -2460,26 +2466,20 @@ var CANVAS_TITLES = {
   watch_address: "Watch Address",
   full_portfolio: "Full Portfolio Overview"
 };
-var PHASE_3_TEMPLATES = /* @__PURE__ */ new Set([
-  "activity_heatmap",
-  "portfolio_timeline",
-  "spending_breakdown",
-  "full_portfolio"
-]);
 var renderCanvasTool = buildTool({
   name: "render_canvas",
   description: `Renders an interactive financial canvas inline in the chat.
 
 Use when the user asks for a visual chart, simulator, or financial overview. Pick the most relevant template:
 
-- activity_heatmap \u2014 on-chain transaction history as a GitHub-style heatmap (coming soon \u2014 needs Phase 3 data)
-- portfolio_timeline \u2014 net worth over time, wallet/savings/debt breakdown (coming soon \u2014 needs Phase 3 data)
+- activity_heatmap \u2014 on-chain transaction history as a GitHub-style heatmap (WORKS NOW \u2014 loads from wallet)
+- portfolio_timeline \u2014 net worth over time, wallet/savings/debt breakdown (WORKS NOW \u2014 daily snapshots)
 - yield_projector \u2014 compound yield simulator with amount/APY/period sliders (WORKS NOW \u2014 client-side)
 - health_simulator \u2014 borrow health factor simulator with collateral/debt sliders (WORKS NOW \u2014 uses current position)
 - dca_planner \u2014 savings plan curve for regular monthly deposits (WORKS NOW \u2014 client-side)
-- spending_breakdown \u2014 spending by service category (coming soon \u2014 needs Phase 3 data)
-- watch_address \u2014 portfolio overview for any public Sui address (coming soon \u2014 CA-6)
-- full_portfolio \u2014 4-panel overview: heatmap, timeline, yield, HF (coming soon \u2014 CA-7)
+- spending_breakdown \u2014 spending by service category (WORKS NOW \u2014 from AppEvent + ServicePurchase)
+- watch_address \u2014 portfolio overview for any public Sui address (WORKS NOW \u2014 pass address in params)
+- full_portfolio \u2014 4-panel overview: savings, health, activity, spending (WORKS NOW \u2014 aggregates all data)
 
 Always prefer the canvas for visualisation requests. After rendering, offer to explain what the user sees.`,
   inputSchema: z.object({
@@ -2511,31 +2511,95 @@ Always prefer the canvas for visualisation requests. After rendering, offer to e
   async call(input, context) {
     const { template, params } = input;
     const title = CANVAS_TITLES[template];
-    if (PHASE_3_TEMPLATES.has(template)) {
+    if (template === "full_portfolio") {
+      const pos = context.serverPositions;
+      const rate = normalizeSavingsRate(pos?.savingsRate);
+      const savings = pos?.savings ?? 0;
+      const borrows = pos?.borrows ?? 0;
       return {
         data: {
           __canvas: true,
           template,
           title,
-          templateData: { available: false, message: "This canvas will be available in Phase 3 when analytics APIs are ready." }
+          templateData: {
+            available: true,
+            address: context.walletAddress ?? "",
+            currentSavings: savings,
+            currentDebt: borrows,
+            healthFactor: pos?.healthFactor ?? null,
+            savingsRate: rate
+          }
         },
-        displayText: `Canvas template "${title}" is coming soon.`
+        displayText: `Opened Full Portfolio Overview.`
       };
     }
     if (template === "watch_address") {
+      const targetAddress = params?.address ?? "";
+      if (!targetAddress || !targetAddress.startsWith("0x")) {
+        return {
+          data: {
+            __canvas: true,
+            template,
+            title,
+            templateData: { available: false, message: "Please provide a valid Sui address to watch." }
+          },
+          displayText: "No valid address provided. Ask the user for a Sui address."
+        };
+      }
+      return {
+        data: {
+          __canvas: true,
+          template,
+          title: `Watch ${targetAddress.slice(0, 6)}\u2026${targetAddress.slice(-4)}`,
+          templateData: { available: true, address: targetAddress }
+        },
+        displayText: `Opened Watch Address canvas for ${targetAddress.slice(0, 6)}\u2026${targetAddress.slice(-4)}.`
+      };
+    }
+    if (template === "portfolio_timeline") {
       return {
         data: {
           __canvas: true,
           template,
           title,
-          templateData: { available: false, address: params?.address ?? null, message: "Watch Address canvas is coming soon." }
+          templateData: {
+            available: true,
+            address: context.walletAddress ?? ""
+          }
         },
-        displayText: `Canvas template "${title}" is coming soon.`
+        displayText: `Opened Portfolio Timeline. Shows your net worth, savings, and debt over time.`
+      };
+    }
+    if (template === "spending_breakdown") {
+      return {
+        data: {
+          __canvas: true,
+          template,
+          title,
+          templateData: {
+            available: true,
+            address: context.walletAddress ?? ""
+          }
+        },
+        displayText: `Opened Spending Breakdown. Shows your service spending by category.`
+      };
+    }
+    if (template === "activity_heatmap") {
+      return {
+        data: {
+          __canvas: true,
+          template,
+          title,
+          templateData: {
+            available: true,
+            address: context.walletAddress ?? ""
+          }
+        },
+        displayText: `Opened Activity Heatmap for your wallet. Click any day to explore transactions.`
       };
     }
     const positions = context.serverPositions;
-    const rawRate = positions?.savingsRate ?? 0;
-    const savingsRate = rawRate > 0 && rawRate < 1 ? rawRate * 100 : rawRate > 0 ? rawRate : 4.5;
+    const savingsRate = normalizeSavingsRate(positions?.savingsRate);
     const healthFactor = positions?.healthFactor ?? null;
     const totalSavings = positions?.savings ?? 0;
     const totalBorrows = positions?.borrows ?? 0;
@@ -2596,6 +2660,50 @@ Always prefer the canvas for visualisation requests. After rendering, offer to e
     };
   }
 });
+var spendingAnalyticsTool = buildTool({
+  name: "spending_analytics",
+  description: "Returns MPP service spending breakdown for a period. Shows total spent, request count, and breakdown by service/category. Use when the user asks about their API spending, service usage, or costs.",
+  inputSchema: z.object({
+    period: z.enum(["week", "month", "year", "all"]).optional().describe("Time period. Defaults to current month.")
+  }),
+  jsonSchema: {
+    type: "object",
+    properties: {
+      period: { type: "string", enum: ["week", "month", "year", "all"] }
+    }
+  },
+  isReadOnly: true,
+  async call(input, context) {
+    const period = input.period ?? "month";
+    const apiUrl = context.env?.ALLOWANCE_API_URL;
+    const address = context.walletAddress;
+    const empty = { period, totalSpent: 0, requestCount: 0, serviceCount: 0, byService: [] };
+    if (!apiUrl || !address) {
+      return { data: empty, displayText: "Spending analytics not available." };
+    }
+    try {
+      const res = await fetch(
+        `${apiUrl}/api/analytics/spending?address=${address}&period=${period}`,
+        {
+          headers: { "x-sui-address": address },
+          signal: context.signal
+        }
+      );
+      if (!res.ok) {
+        return { data: empty, displayText: `Could not fetch spending data (HTTP ${res.status}).` };
+      }
+      const data = await res.json();
+      const total = data.totalSpent ?? 0;
+      const count = data.requestCount ?? 0;
+      return {
+        data,
+        displayText: total > 0 ? `You spent $${total.toFixed(2)} across ${count} request${count !== 1 ? "s" : ""} on ${data.serviceCount} service${data.serviceCount !== 1 ? "s" : ""} (${data.period}).` : `No service spending recorded for ${data.period}.`
+      };
+    } catch {
+      return { data: empty, displayText: "Error fetching spending analytics." };
+    }
+  }
+});
 var LLAMA_API2 = "https://api.llama.fi";
 var YIELDS_API2 = "https://yields.llama.fi";
 var COINS_API = "https://coins.llama.fi";
@@ -2909,7 +3017,8 @@ var READ_TOOLS = [
   listInvoicesTool,
   cancelInvoiceTool,
   createPaymentLinkTool,
-  createInvoiceTool
+  createInvoiceTool,
+  spendingAnalyticsTool
 ];
 var WRITE_TOOLS = [
   saveDepositTool,
@@ -4216,6 +4325,6 @@ function sanitizeAnthropicMessages(messages) {
   return merged;
 }
 
-export { AnthropicProvider, CANVAS_TEMPLATES, 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, explainTxTool, extractMcpText, fetchAvailableRewards, fetchBalance, fetchHealthFactor, fetchPositions, fetchProtocolStats, fetchRates, fetchSavings, fetchTokenPrices, fetchWalletCoins, findTool, getDefaultTools, getMcpManager, getWalletAddress, hasNaviMcp, healthCheckTool, mppServicesTool, parseMcpJson, parseSSE, payApiTool, portfolioAnalysisTool, protocolDeepDiveTool, ratesInfoTool, registerEngineTools, renderCanvasTool, repayDebtTool, requireAgent, runTools, saveContactTool, saveDepositTool, savingsInfoTool, sendTransferTool, serializeSSE, swapExecuteTool, swapQuoteTool, toolsToDefinitions, transactionHistoryTool, transformBalance, transformHealthFactor, transformPositions, transformRates, transformRewards, transformSavings, validateHistory, voloStakeTool, voloStatsTool, voloUnstakeTool, webSearchTool, withdrawTool };
+export { AnthropicProvider, CANVAS_TEMPLATES, 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, explainTxTool, extractMcpText, fetchAvailableRewards, fetchBalance, fetchHealthFactor, fetchPositions, fetchProtocolStats, fetchRates, fetchSavings, fetchTokenPrices, fetchWalletCoins, findTool, getDefaultTools, getMcpManager, getWalletAddress, hasNaviMcp, healthCheckTool, mppServicesTool, parseMcpJson, parseSSE, payApiTool, portfolioAnalysisTool, protocolDeepDiveTool, ratesInfoTool, registerEngineTools, renderCanvasTool, repayDebtTool, requireAgent, runTools, saveContactTool, saveDepositTool, savingsInfoTool, sendTransferTool, serializeSSE, spendingAnalyticsTool, swapExecuteTool, swapQuoteTool, toolsToDefinitions, transactionHistoryTool, transformBalance, transformHealthFactor, transformPositions, transformRates, transformRewards, transformSavings, validateHistory, voloStakeTool, voloStatsTool, voloUnstakeTool, webSearchTool, withdrawTool };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map