@t2000/engine 0.36.0 → 0.36.2

package/README.md

@@ -87,7 +87,7 @@ QueryEngine.submitMessage()
 
 ## Built-in Tools
 
-### Read Tools (29 — parallel, auto-approved)
+### Read Tools (38 — parallel, auto-approved)
 
 | Tool | Description |
 |------|-------------|
@@ -120,8 +120,17 @@ QueryEngine.submitMessage()
 | `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)
+| `spending_analytics` | Spending breakdown by service/category over time period |
+| `yield_summary` | Yield earned + projections with sparkline data |
+| `activity_summary` | Activity breakdown by action type |
+| `create_schedule` | Create a recurring scheduled action (DCA) |
+| `list_schedules` | List scheduled actions with trust stage |
+| `cancel_schedule` | Cancel a scheduled action |
+| `render_canvas` | Generate interactive HTML canvas visualizations |
+| `pattern_status` | View behavioral pattern proposals and trust stage |
+| `record_advice` | Record financial advice given for outcome tracking |
+
+### Write Tools (12 — serial, confirmation required)
 
 | Tool | Description |
 |------|-------------|
@@ -136,6 +145,34 @@ QueryEngine.submitMessage()
 | `volo_stake` | Stake SUI for vSUI (VOLO liquid staking) |
 | `volo_unstake` | Unstake vSUI back to SUI |
 | `save_contact` | Save a contact name + address for quick sends |
+| `pause_pattern` | Pause an autonomous behavioral pattern |
+
+## Audric 2.0 Engine Features
+
+### Streaming Tool Execution (Early Dispatch)
+
+`EarlyToolDispatcher` dispatches read-only tools mid-stream before `message_stop`. Tools with `isReadOnly && isConcurrencySafe` fire as soon as their `tool_use` block completes. Write tools still go through the permission gate.
+
+### Tool Result Budgeting
+
+Tools can set `maxResultSizeChars` to cap output size. Results exceeding the limit are truncated with a hint to narrow parameters. Custom `summarizeOnTruncate` callbacks supported.
+
+### Microcompact
+
+`microcompact(messages)` deduplicates identical tool calls (same name + input) in conversation history, replacing repeated results with `[Same result as turn N]`.
+
+### Granular Permissions (USD-aware)
+
+Write tool permission resolved dynamically via `resolvePermissionTier(operation, amountUsd, config)`. Small amounts auto-execute; large amounts require confirmation. Three presets: `conservative`, `balanced`, `aggressive`.
+
+### Reasoning Engine
+
+- **Adaptive thinking** — routes queries to `low`/`medium`/`high` effort based on financial complexity
+- **Guard runner** — 9 guards across 3 priority tiers (Safety > Financial > UX)
+- **Skill recipes** — YAML recipe files with longest-trigger-match-wins
+- **Context compaction** — 200k limit, 85% compact trigger, LLM summarizer fallback
+- **Tool flags** — `mutating`, `requiresBalance`, `affectsHealth`, `irreversible` etc.
+- **Preflight validation** — input validation on `send_transfer`, `swap_execute`, `pay_api`, `borrow`, `save_deposit`
 
 ## Configuration
 
@@ -165,9 +202,12 @@ The `submitMessage()` async generator yields `EngineEvent`:
 | Event | Fields | When |
 |-------|--------|------|
 | `text_delta` | `text` | LLM streams a text chunk |
+| `thinking_delta` | `text` | Extended thinking chunk (reasoning accordion) |
+| `thinking_done` | — | Extended thinking complete |
 | `tool_start` | `toolName`, `toolUseId`, `input` | Tool execution begins |
 | `tool_result` | `toolName`, `toolUseId`, `result`, `isError` | Tool execution completes |
 | `pending_action` | `action` (PendingAction) | Write tool awaiting client-side execution |
+| `canvas` | `html` | Interactive HTML visualization from `render_canvas` |
 | `turn_complete` | `stopReason` | Conversation turn finished |
 | `usage` | `inputTokens`, `outputTokens`, `cacheReadTokens?`, `cacheWriteTokens?` | Token usage report |
 | `error` | `error` | Unrecoverable error |

package/dist/index.js

@@ -2394,9 +2394,17 @@ var InvoiceSchema = z.object({
     amount: z.number().positive()
   })).optional().describe("Line items. If omitted, a single line item matching the total is implied.")
 });
+function internalHeaders(context) {
+  const internalKey = context.env?.AUDRIC_INTERNAL_KEY;
+  return {
+    "Content-Type": "application/json",
+    "x-sui-address": context.walletAddress ?? "",
+    ...internalKey ? { "x-internal-key": internalKey } : {}
+  };
+}
 var createPaymentLinkTool = buildTool({
   name: "create_payment_link",
-  description: 'Create a shareable payment link so someone can send USDC to the user. Returns a URL the user can share. Use when the user says "create a payment link", "generate a payment link", "I want to get paid", or similar.',
+  description: 'Create a shareable payment link so someone can send USDC to the user. Returns a URL the user can share. Payers can connect their wallet, scan a QR code, or send manually. Use when the user says "create a payment link", "generate a payment link", "I want to get paid", or similar.',
   inputSchema: PaymentLinkSchema,
   jsonSchema: {
     type: "object",
@@ -2411,20 +2419,15 @@ var createPaymentLinkTool = buildTool({
   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: "Payment link creation is not available." };
     }
     try {
-      const res = await fetch(`${apiUrl}/api/internal/payment-links`, {
+      const res = await fetch(`${apiUrl}/api/internal/payments`, {
         method: "POST",
         signal: context.signal,
-        headers: {
-          "Content-Type": "application/json",
-          "x-sui-address": context.walletAddress,
-          ...internalKey ? { "x-internal-key": internalKey } : {}
-        },
-        body: JSON.stringify(input)
+        headers: internalHeaders(context),
+        body: JSON.stringify({ ...input, type: "link" })
       });
       if (!res.ok) {
         const err = await res.json().catch(() => ({}));
@@ -2434,7 +2437,7 @@ var createPaymentLinkTool = buildTool({
       const amountStr = link.amount != null ? `$${link.amount.toFixed(2)} ${link.currency}` : `any amount ${link.currency}`;
       return {
         data: link,
-        displayText: `Payment link created for ${amountStr}${link.label ? ` \u2014 ${link.label}` : ""}. Share: ${link.url}`
+        displayText: `Payment link created for ${amountStr}${link.label ? ` \u2014 ${link.label}` : ""}. Payers can connect their wallet, scan the QR code, or send manually. Share: ${link.url}`
       };
     } catch {
       return { data: null, displayText: "Failed to create payment link." };
@@ -2449,33 +2452,29 @@ var listPaymentLinksTool = buildTool({
   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: { links: [] }, displayText: "No payment links found." };
+      return { data: { payments: [] }, displayText: "No payment links found." };
     }
     try {
-      const res = await fetch(`${apiUrl}/api/internal/payment-links`, {
+      const res = await fetch(`${apiUrl}/api/internal/payments?type=link`, {
         signal: context.signal,
-        headers: {
-          "x-sui-address": context.walletAddress,
-          ...internalKey ? { "x-internal-key": internalKey } : {}
-        }
+        headers: internalHeaders(context)
       });
-      if (!res.ok) return { data: { links: [] }, displayText: "Could not fetch payment links." };
+      if (!res.ok) return { data: { payments: [] }, displayText: "Could not fetch payment links." };
       const data = await res.json();
-      const count = data.links.length;
+      const count = data.payments.length;
       return {
         data,
         displayText: count === 0 ? "No payment links yet." : `${count} payment link${count !== 1 ? "s" : ""} found.`
       };
     } catch {
-      return { data: { links: [] }, displayText: "Could not fetch payment links." };
+      return { data: { payments: [] }, displayText: "Could not fetch payment links." };
     }
   }
 });
 var createInvoiceTool = buildTool({
   name: "create_invoice",
-  description: 'Create a formal invoice that the user can share with a client or customer. Returns a URL for the invoice page. Use when the user says "create an invoice", "generate an invoice", "bill a client", or similar.',
+  description: 'Create a formal invoice that the user can share with a client or customer. Returns a URL for the invoice page. Payers can connect their wallet, scan a QR code, or send manually. Use when the user says "create an invoice", "generate an invoice", "bill a client", or similar.',
   inputSchema: InvoiceSchema,
   jsonSchema: {
     type: "object",
@@ -2504,20 +2503,15 @@ var createInvoiceTool = buildTool({
   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 creation is not available." };
     }
     try {
-      const res = await fetch(`${apiUrl}/api/internal/invoices`, {
+      const res = await fetch(`${apiUrl}/api/internal/payments`, {
         method: "POST",
         signal: context.signal,
-        headers: {
-          "Content-Type": "application/json",
-          "x-sui-address": context.walletAddress,
-          ...internalKey ? { "x-internal-key": internalKey } : {}
-        },
-        body: JSON.stringify(input)
+        headers: internalHeaders(context),
+        body: JSON.stringify({ ...input, type: "invoice" })
       });
       if (!res.ok) {
         const err = await res.json().catch(() => ({}));
@@ -2527,7 +2521,7 @@ var createInvoiceTool = buildTool({
       const dueStr = invoice.dueDate ? ` due ${new Date(invoice.dueDate).toLocaleDateString()}` : "";
       return {
         data: invoice,
-        displayText: `Invoice created for $${invoice.amount.toFixed(2)} ${invoice.currency}${dueStr} \u2014 ${invoice.label}. Share: ${invoice.url}`
+        displayText: `Invoice created for $${invoice.amount.toFixed(2)} ${invoice.currency}${dueStr} \u2014 ${invoice.label}. Payers can connect their wallet, scan the QR code, or send manually. Share: ${invoice.url}`
       };
     } catch {
       return { data: null, displayText: "Failed to create invoice." };
@@ -2550,19 +2544,14 @@ var cancelPaymentLinkTool = buildTool({
   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: "Payment link cancellation is not available." };
     }
     try {
-      const res = await fetch(`${apiUrl}/api/internal/payment-links`, {
+      const res = await fetch(`${apiUrl}/api/internal/payments`, {
         method: "PATCH",
         signal: context.signal,
-        headers: {
-          "Content-Type": "application/json",
-          "x-sui-address": context.walletAddress,
-          ...internalKey ? { "x-internal-key": internalKey } : {}
-        },
+        headers: internalHeaders(context),
         body: JSON.stringify({ slug: input.slug, action: "cancel" })
       });
       if (!res.ok) {
@@ -2595,19 +2584,14 @@ var cancelInvoiceTool = buildTool({
   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`, {
+      const res = await fetch(`${apiUrl}/api/internal/payments`, {
         method: "PATCH",
         signal: context.signal,
-        headers: {
-          "Content-Type": "application/json",
-          "x-sui-address": context.walletAddress,
-          ...internalKey ? { "x-internal-key": internalKey } : {}
-        },
+        headers: internalHeaders(context),
         body: JSON.stringify({ slug: input.slug, action: "cancel" })
       });
       if (!res.ok) {
@@ -2632,27 +2616,23 @@ var listInvoicesTool = buildTool({
   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: { invoices: [] }, displayText: "No invoices found." };
+      return { data: { payments: [] }, displayText: "No invoices found." };
     }
     try {
-      const res = await fetch(`${apiUrl}/api/internal/invoices`, {
+      const res = await fetch(`${apiUrl}/api/internal/payments?type=invoice`, {
         signal: context.signal,
-        headers: {
-          "x-sui-address": context.walletAddress,
-          ...internalKey ? { "x-internal-key": internalKey } : {}
-        }
+        headers: internalHeaders(context)
       });
-      if (!res.ok) return { data: { invoices: [] }, displayText: "Could not fetch invoices." };
+      if (!res.ok) return { data: { payments: [] }, displayText: "Could not fetch invoices." };
       const data = await res.json();
-      const count = data.invoices.length;
+      const count = data.payments.length;
       return {
         data,
         displayText: count === 0 ? "No invoices yet." : `${count} invoice${count !== 1 ? "s" : ""} found.`
       };
     } catch {
-      return { data: { invoices: [] }, displayText: "Could not fetch invoices." };
+      return { data: { payments: [] }, displayText: "Could not fetch invoices." };
     }
   }
 });