@t2000/engine 0.28.5 → 0.28.7

package/README.md

@@ -87,7 +87,7 @@ QueryEngine.submitMessage()
 
 ## Built-in Tools
 
-### Read Tools (20 — parallel, auto-approved)
+### Read Tools (29 — parallel, auto-approved)
 
 | Tool | Description |
 |------|-------------|
@@ -111,6 +111,15 @@ QueryEngine.submitMessage()
 | `defillama_chain_tvl` | Chain TVL rankings |
 | `defillama_protocol_fees` | Protocol fees/revenue rankings |
 | `defillama_sui_protocols` | Sui ecosystem protocols — TVL, category, changes |
+| `create_payment_link` | Create a shareable USDC payment link |
+| `list_payment_links` | List payment links with statuses |
+| `cancel_payment_link` | Cancel an active payment link |
+| `create_invoice` | Create a formal invoice with due date and line items |
+| `list_invoices` | List invoices with statuses |
+| `cancel_invoice` | Cancel an unpaid invoice |
+| `toggle_allowance` | Pause or resume agent autonomous spending |
+| `update_daily_limit` | Change the daily USDC spending cap |
+| `update_permissions` | Update which service categories the agent can act on |
 
 ### Write Tools (11 — serial, confirmation required)
 

package/dist/index.js

@@ -1985,6 +1985,20 @@ Risks: ${riskFactors.join("; ")}`
     };
   }
 });
+async function patchAllowance(apiUrl, walletAddress, internalKey, body, signal) {
+  const res = await fetch(`${apiUrl}/api/allowance/${walletAddress}`, {
+    method: "PATCH",
+    headers: {
+      "Content-Type": "application/json",
+      "x-internal-key": internalKey ?? "",
+      "x-sui-address": walletAddress
+    },
+    body: JSON.stringify(body),
+    signal
+  });
+  if (!res.ok) return null;
+  return res.json();
+}
 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.",
@@ -2035,6 +2049,117 @@ var allowanceStatusTool = buildTool({
     };
   }
 });
+var toggleAllowanceTool = buildTool({
+  name: "toggle_allowance",
+  description: 'Pause or resume the agent spending allowance. Use when the user says "pause my agent", "disable autonomous spending", "resume my agent", or similar. ALWAYS confirm with the user before calling \u2014 e.g. "Pause agent spending? Your daily limit will be suspended." Only call after explicit confirmation.',
+  inputSchema: z.object({
+    enabled: z.boolean().describe("true to enable agent spending, false to pause it")
+  }),
+  jsonSchema: {
+    type: "object",
+    properties: {
+      enabled: { type: "boolean", description: "true to enable, false to pause" }
+    },
+    required: ["enabled"]
+  },
+  isReadOnly: true,
+  async call(input, context) {
+    const apiUrl = context.env?.ALLOWANCE_API_URL;
+    const internalKey = context.env?.AUDRIC_INTERNAL_KEY;
+    if (!apiUrl || !context.walletAddress) {
+      return { data: null, displayText: "Allowance management is not available." };
+    }
+    try {
+      const result = await patchAllowance(apiUrl, context.walletAddress, internalKey, {
+        action: "toggle",
+        enabled: input.enabled
+      }, context.signal);
+      if (!result) return { data: null, displayText: "Failed to update allowance." };
+      const action = input.enabled ? "enabled" : "paused";
+      return {
+        data: result,
+        displayText: `Agent spending ${action}.`
+      };
+    } catch {
+      return { data: null, displayText: "Failed to update allowance." };
+    }
+  }
+});
+var updateDailyLimitTool = buildTool({
+  name: "update_daily_limit",
+  description: `Update the agent's daily spending limit in USDC. Use when the user says "set my daily limit to $X", "change my spending cap", or similar. ALWAYS confirm with the user before calling \u2014 show the current limit and the new limit. Only call after explicit confirmation.`,
+  inputSchema: z.object({
+    dailyLimitUsdc: z.number().min(0).max(1e4).describe("New daily limit in USDC (0\u201310000)")
+  }),
+  jsonSchema: {
+    type: "object",
+    properties: {
+      dailyLimitUsdc: { type: "number", description: "New daily spending limit in USDC (0\u201310000)" }
+    },
+    required: ["dailyLimitUsdc"]
+  },
+  isReadOnly: true,
+  async call(input, context) {
+    const apiUrl = context.env?.ALLOWANCE_API_URL;
+    const internalKey = context.env?.AUDRIC_INTERNAL_KEY;
+    if (!apiUrl || !context.walletAddress) {
+      return { data: null, displayText: "Allowance management is not available." };
+    }
+    try {
+      const result = await patchAllowance(apiUrl, context.walletAddress, internalKey, {
+        action: "setLimit",
+        dailyLimitUsdc: input.dailyLimitUsdc
+      }, context.signal);
+      if (!result) return { data: null, displayText: "Failed to update daily limit." };
+      return {
+        data: result,
+        displayText: `Daily limit updated to $${input.dailyLimitUsdc.toFixed(2)} USDC.`
+      };
+    } catch {
+      return { data: null, displayText: "Failed to update daily limit." };
+    }
+  }
+});
+var updatePermissionsTool = buildTool({
+  name: "update_permissions",
+  description: 'Update which service categories the agent is allowed to act on autonomously. Valid permissions: savings, send, pay, credit, swap, stake. Use when the user says "disable sends", "only allow savings", "enable all services", or similar. ALWAYS show the current permissions and the new permissions before calling. Only call after explicit confirmation.',
+  inputSchema: z.object({
+    permissions: z.array(z.enum(["savings", "send", "pay", "credit", "swap", "stake"])).describe("Full list of enabled permission categories")
+  }),
+  jsonSchema: {
+    type: "object",
+    properties: {
+      permissions: {
+        type: "array",
+        items: { type: "string", enum: ["savings", "send", "pay", "credit", "swap", "stake"] },
+        description: "Full list of enabled permission categories"
+      }
+    },
+    required: ["permissions"]
+  },
+  isReadOnly: true,
+  async call(input, context) {
+    const apiUrl = context.env?.ALLOWANCE_API_URL;
+    const internalKey = context.env?.AUDRIC_INTERNAL_KEY;
+    if (!apiUrl || !context.walletAddress) {
+      return { data: null, displayText: "Allowance management is not available." };
+    }
+    try {
+      const result = await patchAllowance(apiUrl, context.walletAddress, internalKey, {
+        action: "setPermissions",
+        permissions: input.permissions
+      }, context.signal);
+      if (!result) return { data: null, displayText: "Failed to update permissions." };
+      const list = input.permissions.length > 0 ? input.permissions.join(", ") : "none";
+      return {
+        data: result,
+        displayText: `Permissions updated: ${list}.`
+      };
+    } catch {
+      return { data: null, displayText: "Failed to update permissions." };
+    }
+  }
+});
 var PaymentLinkSchema = z.object({
   amount: z.number().positive().optional().describe("Amount in USDC. Omit for open-amount links."),
   label: z.string().optional().describe('Human-readable label e.g. "Consulting fee March"'),
@@ -2238,6 +2363,51 @@ var cancelPaymentLinkTool = buildTool({
     }
   }
 });
+var cancelInvoiceTool = buildTool({
+  name: "cancel_invoice",
+  description: 'Cancel an invoice that has not yet been paid. Use when the user says "cancel my invoice", "delete invoice", or refers to a specific invoice slug or label. Use list_invoices first if the slug is not known.',
+  inputSchema: z.object({
+    slug: z.string().describe('The slug of the invoice to cancel (e.g. "xFYKBWy5")')
+  }),
+  jsonSchema: {
+    type: "object",
+    properties: {
+      slug: { type: "string", description: "The slug of the invoice to cancel" }
+    },
+    required: ["slug"]
+  },
+  isReadOnly: true,
+  async call(input, context) {
+    const apiUrl = context.env?.ALLOWANCE_API_URL;
+    const internalKey = context.env?.AUDRIC_INTERNAL_KEY;
+    if (!apiUrl || !context.walletAddress) {
+      return { data: null, displayText: "Invoice cancellation is not available." };
+    }
+    try {
+      const res = await fetch(`${apiUrl}/api/internal/invoices`, {
+        method: "PATCH",
+        signal: context.signal,
+        headers: {
+          "Content-Type": "application/json",
+          "x-sui-address": context.walletAddress,
+          ...internalKey ? { "x-internal-key": internalKey } : {}
+        },
+        body: JSON.stringify({ slug: input.slug, action: "cancel" })
+      });
+      if (!res.ok) {
+        const err = await res.json().catch(() => ({}));
+        return { data: null, displayText: err.error ?? "Failed to cancel invoice." };
+      }
+      const result = await res.json();
+      return {
+        data: result,
+        displayText: `Invoice ${result.slug} cancelled.`
+      };
+    } catch {
+      return { data: null, displayText: "Failed to cancel invoice." };
+    }
+  }
+});
 var listInvoicesTool = buildTool({
   name: "list_invoices",
   description: `List the user's invoices \u2014 pending, overdue, paid, and cancelled. Use when the user asks "show my invoices", "what invoices do I have", or wants to check invoice status.`,
@@ -2574,9 +2744,13 @@ var READ_TOOLS = [
   defillamaProtocolFeesTool,
   defillamaSuiProtocolsTool,
   allowanceStatusTool,
+  toggleAllowanceTool,
+  updateDailyLimitTool,
+  updatePermissionsTool,
   listPaymentLinksTool,
   cancelPaymentLinkTool,
   listInvoicesTool,
+  cancelInvoiceTool,
   createPaymentLinkTool,
   createInvoiceTool
 ];