@t2000/engine 0.7.6 → 0.7.7

package/README.md

@@ -87,7 +87,7 @@ QueryEngine.submitMessage()
 
 ## Built-in Tools
 
-### Read Tools (19 — parallel, auto-approved)
+### Read Tools (20 — parallel, auto-approved)
 
 | Tool | Description |
 |------|-------------|
@@ -96,6 +96,7 @@ QueryEngine.submitMessage()
 | `health_check` | Health factor with risk assessment |
 | `rates_info` | Current supply/borrow APYs |
 | `transaction_history` | Recent transaction log |
+| `allowance_status` | Agent budget allowance and permissions |
 | `explain_tx` | Human-readable transaction explanation from digest |
 | `web_search` | Web search via Brave Search API |
 | `swap_quote` | Preview swap route, output amount, and price impact (no execution) |

package/dist/index.d.ts

@@ -850,6 +850,7 @@ declare const withdrawTool: Tool<{
 declare const sendTransferTool: Tool<{
     amount: number;
     to: string;
+    memo?: string | undefined;
 }, {
     success: boolean;
     tx: string;
@@ -859,6 +860,7 @@ declare const sendTransferTool: Tool<{
     gasCost: number;
     gasMethod: _t2000_sdk.GasMethod;
     balance: _t2000_sdk.BalanceResponse;
+    memo: string | null;
 }>;
 
 declare const borrowTool: Tool<{

package/dist/index.js

@@ -1135,7 +1135,8 @@ var sendTransferTool = buildTool({
   description: "Send USDC to another Sui address or contact name. Validates the address, checks balance, and executes the on-chain transfer. Returns tx hash, gas cost, and updated balance.",
   inputSchema: z.object({
     to: z.string().min(1),
-    amount: z.number().positive()
+    amount: z.number().positive(),
+    memo: z.string().optional()
   }),
   jsonSchema: {
     type: "object",
@@ -1147,6 +1148,10 @@ var sendTransferTool = buildTool({
       amount: {
         type: "number",
         description: "Amount in USD to send"
+      },
+      memo: {
+        type: "string",
+        description: "Optional note attached to the transfer (shown in transaction receipt)"
       }
     },
     required: ["to", "amount"]
@@ -1165,7 +1170,8 @@ var sendTransferTool = buildTool({
         contactName: result.contactName,
         gasCost: result.gasCost,
         gasMethod: result.gasMethod,
-        balance: result.balance
+        balance: result.balance,
+        memo: input.memo ?? null
       },
       displayText: `Sent $${result.amount.toFixed(2)} to ${result.contactName ?? result.to.slice(0, 10)}\u2026 (tx: ${result.tx.slice(0, 8)}\u2026)`
     };
@@ -1295,7 +1301,15 @@ var payApiTool = buildTool({
 
 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 + service path. Pass parameters as a JSON string in body.`,
+Always use POST. Construct the URL from the gateway base + service path. Pass parameters as a JSON string in body.
+
+CRITICAL \u2014 non-retryable errors: If the result contains "doNotRetry": true or "paymentConfirmed": true, the user has ALREADY been charged. NEVER call pay_api again for the same request. Report the error to the user.
+
+Lob (postcards/letters) \u2014 MULTI-STEP, NEVER skip:
+1. Generate design image FIRST via fal/fal-ai/flux/dev ($0.03). Show the image to the user as markdown ![design](url).
+2. Ask the user to confirm before mailing ("Here's the design. Print and mail for $1.00?").
+3. ONLY after user confirms: call lob/v1/postcards with the image URL in the front HTML (<img src="URL" style="width:100%;height:100%;object-fit:cover"/>).
+Always use ISO-3166 country codes (GB not UK, US not USA). A return address ("from") is added automatically \u2014 do not include one.`,
   inputSchema: z.object({
     url: z.string().url(),
     method: z.enum(["GET", "POST", "PUT", "DELETE"]).optional(),
@@ -1971,6 +1985,56 @@ Risks: ${riskFactors.join("; ")}`
     };
   }
 });
+var allowanceStatusTool = buildTool({
+  name: "allowance_status",
+  description: "Check the agent spending allowance status: whether it is enabled, the daily USDC limit, amount spent today, remaining budget, which service categories are permitted, and when the budget resets. Use this when the user asks about their agent budget, spending limits, or autonomous transaction permissions.",
+  inputSchema: z.object({}),
+  jsonSchema: { type: "object", properties: {}, required: [] },
+  isReadOnly: true,
+  async call(_input, context) {
+    if (!context.env?.ALLOWANCE_API_URL || !context.walletAddress) {
+      return {
+        data: {
+          enabled: false,
+          dailyLimit: 0,
+          spent: 0,
+          remaining: 0,
+          permissions: [],
+          resetsAt: null
+        },
+        displayText: "Agent allowance is not configured."
+      };
+    }
+    const disabledResult = {
+      data: {
+        enabled: false,
+        dailyLimit: 0,
+        spent: 0,
+        remaining: 0,
+        permissions: [],
+        resetsAt: null
+      },
+      displayText: "Unable to fetch allowance status."
+    };
+    let allowance;
+    try {
+      const url = `${context.env.ALLOWANCE_API_URL}/api/allowance/${context.walletAddress}`;
+      const res = await fetch(url, {
+        signal: context.signal,
+        headers: context.env.AUDRIC_INTERNAL_KEY ? { "x-internal-key": context.env.AUDRIC_INTERNAL_KEY } : void 0
+      });
+      if (!res.ok) return disabledResult;
+      allowance = await res.json();
+    } catch {
+      return disabledResult;
+    }
+    const statusText = allowance.enabled ? `Allowance active: $${allowance.spent.toFixed(2)} / $${allowance.dailyLimit.toFixed(2)} used today. ${allowance.permissions.length} service categories enabled.` : "Agent allowance is disabled.";
+    return {
+      data: allowance,
+      displayText: statusText
+    };
+  }
+});
 var LLAMA_API2 = "https://api.llama.fi";
 var YIELDS_API2 = "https://yields.llama.fi";
 var COINS_API = "https://coins.llama.fi";
@@ -2273,7 +2337,8 @@ var READ_TOOLS = [
   defillamaPriceChangeTool,
   defillamaChainTvlTool,
   defillamaProtocolFeesTool,
-  defillamaSuiProtocolsTool
+  defillamaSuiProtocolsTool,
+  allowanceStatusTool
 ];
 var WRITE_TOOLS = [
   saveDepositTool,