@t2000/engine 0.40.4 → 0.42.0

package/dist/index.js

@@ -1121,12 +1121,15 @@ async function queryHistoryByDate(rpcUrl, address, targetDate, limit) {
   }
   return results.slice(0, limit);
 }
+var HISTORY_ACTIONS = ["send", "lending", "swap", "transaction"];
+var DEFAULT_LOOKBACK_DAYS = 30;
 var transactionHistoryTool = buildTool({
   name: "transaction_history",
-  description: "Retrieve transaction history: past sends, saves, withdrawals, borrows, repayments, and rewards claims. Pass a date (YYYY-MM-DD) to find transactions from a specific day, or omit for the most recent.",
+  description: "Retrieve recent transaction history (last 30 days by default): sends, saves, withdrawals, borrows, repayments, and rewards claims. Pass `date` (YYYY-MM-DD) for a specific day, `action` to filter by category (send/lending/swap), or both.",
   inputSchema: z.object({
     limit: z.number().int().min(1).max(50).optional(),
-    date: z.string().optional().describe("Specific date to search for transactions (YYYY-MM-DD format). Paginates back to find that day.")
+    date: z.string().optional().describe("Specific date to search for transactions (YYYY-MM-DD format). Paginates back to find that day."),
+    action: z.enum(HISTORY_ACTIONS).optional().describe("Filter by action: send, lending, swap, or transaction.")
   }),
   jsonSchema: {
     type: "object",
@@ -1138,6 +1141,11 @@ var transactionHistoryTool = buildTool({
       date: {
         type: "string",
         description: "Specific date to search for transactions (YYYY-MM-DD format). Paginates back to find that day."
+      },
+      action: {
+        type: "string",
+        enum: [...HISTORY_ACTIONS],
+        description: "Filter results by action category: send, lending, swap, or transaction."
       }
     }
   },
@@ -1145,29 +1153,55 @@ var transactionHistoryTool = buildTool({
   maxResultSizeChars: 8e3,
   async call(input, context) {
     const limit = input.limit ?? 10;
+    const action = input.action;
+    const finalize = (records2) => {
+      let scoped = records2;
+      if (action) scoped = scoped.filter((r) => r.action === action);
+      return scoped.slice(0, limit);
+    };
     if (context.agent) {
       const agent = requireAgent(context);
-      const records2 = await agent.history({ limit });
+      const records2 = await agent.history({ limit: input.date ? limit : Math.max(limit * 4, 50) });
+      const filtered2 = finalize(records2);
       return {
-        data: { transactions: records2, count: records2.length, date: input.date ?? null },
-        displayText: `${records2.length} recent transaction(s)`
+        data: { transactions: filtered2, count: filtered2.length, date: input.date ?? null, action: action ?? null },
+        displayText: `${filtered2.length} recent transaction(s)`
       };
     }
     if (!context.walletAddress || !context.suiRpcUrl) {
       throw new Error("Transaction history requires a wallet address");
     }
     if (input.date) {
-      const records2 = await queryHistoryByDate(context.suiRpcUrl, context.walletAddress, input.date, limit);
+      const records2 = await queryHistoryByDate(
+        context.suiRpcUrl,
+        context.walletAddress,
+        input.date,
+        Math.max(limit * 4, 50)
+      );
+      const filtered2 = finalize(records2);
       const dateLabel = new Date(input.date).toLocaleDateString("en-US", { month: "long", day: "numeric", year: "numeric" });
       return {
-        data: { transactions: records2, count: records2.length, date: input.date },
-        displayText: records2.length > 0 ? `${records2.length} transaction(s) on ${dateLabel}` : `No transactions found on ${dateLabel}`
+        data: { transactions: filtered2, count: filtered2.length, date: input.date, action: action ?? null },
+        displayText: filtered2.length > 0 ? `${filtered2.length} transaction(s) on ${dateLabel}` : `No transactions found on ${dateLabel}`
       };
     }
-    const records = await queryHistoryRpc(context.suiRpcUrl, context.walletAddress, limit);
+    const cutoffMs = Date.now() - DEFAULT_LOOKBACK_DAYS * 864e5;
+    const records = await queryHistoryRpc(
+      context.suiRpcUrl,
+      context.walletAddress,
+      Math.max(limit * 4, 50)
+    );
+    const recent = records.filter((r) => r.timestamp >= cutoffMs);
+    const filtered = finalize(recent);
     return {
-      data: { transactions: records, count: records.length, date: null },
-      displayText: `${records.length} recent transaction(s)`
+      data: {
+        transactions: filtered,
+        count: filtered.length,
+        date: null,
+        action: action ?? null,
+        lookbackDays: DEFAULT_LOOKBACK_DAYS
+      },
+      displayText: `${filtered.length} transaction(s) in the last ${DEFAULT_LOOKBACK_DAYS} days`
     };
   }
 });
@@ -1547,16 +1581,21 @@ function matchesQuery(service, q) {
 }
 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.).",
+  description: "Discover available MPP gateway services. Returns service names, descriptions, endpoints with required parameters, and pricing. Pass `query` for keyword search or `category` to filter by category. Calling with NO filters returns a category summary (not the full catalog) \u2014 narrow first, then fetch endpoints. Use this BEFORE calling pay_api.",
   inputSchema: z.object({
-    query: z.string().optional().describe('Filter by keyword (e.g. "postcard", "translate", "weather"). Omit to list all services.')
+    query: z.string().optional().describe('Filter by keyword (e.g. "postcard", "translate", "weather").'),
+    category: z.string().optional().describe('Filter by category exactly (e.g. "weather", "image"). See category summary returned when called without filters.')
   }),
   jsonSchema: {
     type: "object",
     properties: {
       query: {
         type: "string",
-        description: 'Filter by keyword (e.g. "postcard", "translate", "weather"). Omit to list all.'
+        description: 'Filter by keyword (e.g. "postcard", "translate", "weather").'
+      },
+      category: {
+        type: "string",
+        description: 'Filter by category exactly (e.g. "weather", "image").'
       }
     },
     required: []
@@ -1565,7 +1604,34 @@ var mppServicesTool = buildTool({
   maxResultSizeChars: 5e3,
   async call(input) {
     const catalog = await fetchCatalog();
-    const filtered = input.query ? catalog.filter((s) => matchesQuery(s, input.query)) : catalog;
+    if (!input.query && !input.category) {
+      const counts = /* @__PURE__ */ new Map();
+      for (const svc of catalog) {
+        for (const cat of svc.categories) {
+          counts.set(cat, (counts.get(cat) ?? 0) + 1);
+        }
+      }
+      const categories = [...counts.entries()].sort((a, b) => b[1] - a[1]).map(([category, services2]) => ({ category, services: services2 }));
+      return {
+        data: {
+          _refine: {
+            reason: "MPP catalog has many services \u2014 pick a category or supply a query first.",
+            suggestedParams: { category: categories[0]?.category ?? "weather" }
+          },
+          categories,
+          totalServices: catalog.length
+        },
+        displayText: `${catalog.length} services across ${categories.length} categories. Re-call with a category or query.`
+      };
+    }
+    let filtered = catalog;
+    if (input.category) {
+      const cat = input.category.toLowerCase();
+      filtered = filtered.filter((s) => s.categories.some((c) => c.toLowerCase() === cat));
+    }
+    if (input.query) {
+      filtered = filtered.filter((s) => matchesQuery(s, input.query));
+    }
     const services = filtered.map((s) => ({
       id: s.id,
       name: s.name,
@@ -1578,7 +1644,11 @@ var mppServicesTool = buildTool({
         price: `$${e.price}`
       }))
     }));
-    const summary = input.query ? `Found ${services.length} service(s) matching "${input.query}"` : `${services.length} services available on MPP gateway`;
+    const filterDesc = [
+      input.query ? `query "${input.query}"` : null,
+      input.category ? `category "${input.category}"` : null
+    ].filter(Boolean).join(" + ");
+    const summary = `Found ${services.length} service(s) matching ${filterDesc}`;
     return {
       data: { services, total: services.length },
       displayText: summary
@@ -2830,6 +2900,10 @@ async function cachedFetch(url) {
   apiCache.set(url, { data, ts: Date.now() });
   return data;
 }
+async function fetchDefillamaYieldPools() {
+  const data = await cachedFetch(`${YIELDS_API2}/pools`);
+  return data.data ?? [];
+}
 function fmtToolTvl(tvl) {
   if (tvl >= 1e9) return `$${(tvl / 1e9).toFixed(1)}B`;
   if (tvl >= 1e6) return `$${(tvl / 1e6).toFixed(1)}M`;
@@ -2858,8 +2932,25 @@ var defillamaYieldPoolsTool = buildTool({
   isReadOnly: true,
   maxResultSizeChars: 6e3,
   async call(input) {
-    const data = await cachedFetch(`${YIELDS_API2}/pools`);
-    let pools = data.data ?? [];
+    if (!input.chain && !input.project) {
+      const all = await fetchDefillamaYieldPools();
+      const chainCounts = /* @__PURE__ */ new Map();
+      for (const p of all) {
+        chainCounts.set(p.chain, (chainCounts.get(p.chain) ?? 0) + 1);
+      }
+      const topChains = [...chainCounts.entries()].sort((a, b) => b[1] - a[1]).slice(0, 8).map(([chain, count]) => ({ chain, pools: count }));
+      return {
+        data: {
+          _refine: {
+            reason: "Cross-chain yield search is too broad; pick a chain.",
+            suggestedParams: { chain: "Sui" },
+            availableChains: topChains
+          }
+        },
+        displayText: "Yield query needs a chain filter. Common chains: " + topChains.map((c) => c.chain).join(", ")
+      };
+    }
+    let pools = await fetchDefillamaYieldPools();
     if (input.chain) {
       const chain = input.chain.toLowerCase();
       pools = pools.filter((p) => p.chain.toLowerCase() === chain);
@@ -3149,6 +3240,40 @@ function getDefaultTools() {
   return applyToolFlags([...READ_TOOLS, ...WRITE_TOOLS]);
 }
 
+// src/tools/tool-modifiable-fields.ts
+var TOOL_MODIFIABLE_FIELDS = {
+  save_deposit: [
+    { name: "amount", kind: "amount", asset: "USDC" }
+  ],
+  withdraw: [
+    { name: "amount", kind: "amount", asset: "USDC" }
+  ],
+  send_transfer: [
+    // `amount` first so the UI surfaces it prominently; the recipient
+    // address field is also editable in case the user typed the wrong one.
+    { name: "amount", kind: "amount" },
+    { name: "to", kind: "address" }
+  ],
+  swap_execute: [
+    { name: "amount", kind: "amount" }
+  ],
+  borrow: [
+    { name: "amount", kind: "amount", asset: "USDC" }
+  ],
+  repay_debt: [
+    { name: "amount", kind: "amount", asset: "USDC" }
+  ],
+  volo_stake: [
+    { name: "amount", kind: "amount", asset: "SUI" }
+  ],
+  volo_unstake: [
+    { name: "amount", kind: "amount", asset: "vSUI" }
+  ]
+};
+function getModifiableFields(toolName) {
+  return TOOL_MODIFIABLE_FIELDS[toolName];
+}
+
 // src/prompt.ts
 var DEFAULT_SYSTEM_PROMPT = `You are Audric \u2014 a financial agent on Sui. Audric is exactly five products: Audric Passport (the trust layer \u2014 Google sign-in, non-custodial wallet, tap-to-confirm consent, sponsored gas \u2014 wraps every other product), Audric Intelligence (you \u2014 the 5-system brain: Agent Harness with 40 tools, Reasoning Engine with 9 guards and 7 skill recipes, Silent Profile, Chain Memory, AdviceLog), Audric Finance (manage money on Sui \u2014 Save via NAVI lending at 3-8% APY USDC, Credit via NAVI borrowing with health factor, Swap via Cetus aggregator across 20+ DEXs at 0.1% fee, Charts for yield/health/portfolio viz), Audric Pay (move money \u2014 send USDC, receive via payment links / invoices / QR; free, global, instant on Sui), and Audric Store (creator marketplace, ships Phase 5 \u2014 say "coming soon" if asked). Save, swap, borrow, repay, withdraw, charts \u2192 Audric Finance. Send, receive, payment-link, invoice, QR \u2192 Audric Pay. Your silent context (profile, memory, chain facts, advice log) shapes your replies but never surfaces as a notification \u2014 you act only when the user asks, and every write waits on their tap-to-confirm via Passport. You can also call 41 paid APIs (music, image, research, translation, weather, fulfilment) via MPP micropayments using the pay_api tool \u2014 this is an internal capability, not a promoted product, so only mention it when the user asks for something that needs it.
 
@@ -3248,6 +3373,11 @@ var CostTracker = class {
 };
 
 // src/guards.ts
+function guardVerdictToAction(verdict) {
+  if (verdict === "pass" || verdict === "hint") return "allow";
+  if (verdict === "warn") return "warn";
+  return "block";
+}
 var DEFAULT_GUARD_CONFIG = {
   balanceValidation: true,
   healthFactor: { warnBelow: 2, blockBelow: 1.5 },
@@ -3464,9 +3594,22 @@ function createGuardRunnerState() {
     lastHealthFactor: null
   };
 }
-function runGuards(tool, call, state, config, conversationContext) {
+function runGuards(tool, call, state, config, conversationContext, onGuardFired) {
   const results = [];
   const now = Date.now();
+  const fire = (verdict, tier, gate, hadInjection) => {
+    if (!onGuardFired) return;
+    try {
+      onGuardFired({
+        name: gate,
+        tier,
+        action: guardVerdictToAction(verdict),
+        injectionAdded: hadInjection
+      });
+    } catch (err) {
+      console.warn("[guards] onGuardFired threw (ignored):", err);
+    }
+  };
   if (config.inputValidation !== false && tool.preflight) {
     const check = tool.preflight(call.input);
     if (!check.valid) {
@@ -3479,6 +3622,7 @@ function runGuards(tool, call, state, config, conversationContext) {
         tier: "safety",
         message: check.error
       };
+      fire("block", "safety", "input_validation", false);
       return {
         blocked: true,
         blockReason: check.error,
@@ -3520,6 +3664,10 @@ function runGuards(tool, call, state, config, conversationContext) {
   }));
   const block = results.find((r) => r.verdict === "block");
   if (block) {
+    for (const r of results) {
+      if (r.verdict === "pass") continue;
+      fire(r.verdict, r.tier, r.gate, false);
+    }
     return {
       blocked: true,
       blockReason: block.message ?? `Blocked by ${block.gate}`,
@@ -3532,6 +3680,10 @@ function runGuards(tool, call, state, config, conversationContext) {
     _gate: r.gate,
     ...r.verdict === "hint" ? { _hint: r.message } : { _warning: r.message }
   }));
+  for (const r of results) {
+    if (r.verdict === "pass") continue;
+    fire(r.verdict, r.tier, r.gate, r.verdict === "hint" || r.verdict === "warn");
+  }
   return { blocked: false, injections, events };
 }
 function updateGuardStateAfterToolResult(toolName, tool, input, result, isError, state) {
@@ -3576,6 +3728,7 @@ function microcompact(messages) {
   const seen = /* @__PURE__ */ new Map();
   let toolUseIndex = 0;
   const toolUseInputs = /* @__PURE__ */ new Map();
+  const dedupedToolUseIds = /* @__PURE__ */ new Set();
   for (const msg of messages) {
     for (const block of msg.content) {
       if (block.type === "tool_use") {
@@ -3583,7 +3736,7 @@ function microcompact(messages) {
       }
     }
   }
-  return messages.map((msg) => {
+  const out = messages.map((msg) => {
     if (msg.role !== "user") return { role: msg.role, content: [...msg.content] };
     const hasToolResults = msg.content.some((b) => b.type === "tool_result");
     if (!hasToolResults) return { role: msg.role, content: [...msg.content] };
@@ -3594,6 +3747,7 @@ function microcompact(messages) {
       toolUseIndex++;
       const prior = seen.get(key);
       if (prior && !block.isError) {
+        dedupedToolUseIds.add(block.toolUseId);
         return {
           ...block,
           content: `[Same result as call #${prior.turnIndex} \u2014 ${key.split(":")[0]} with identical inputs. Result unchanged.]`
@@ -3606,6 +3760,13 @@ function microcompact(messages) {
     });
     return { role: msg.role, content: newContent };
   });
+  Object.defineProperty(out, "dedupedToolUseIds", {
+    value: dedupedToolUseIds,
+    enumerable: false,
+    writable: false,
+    configurable: false
+  });
+  return out;
 }
 function stableStringify(value) {
   if (value === null || value === void 0) return "";
@@ -3845,13 +4006,18 @@ var PERMISSION_PRESETS = {
     ]
   }
 };
-function resolvePermissionTier(operation, amountUsd, config) {
+function resolvePermissionTier(operation, amountUsd, config, sessionSpendUsd) {
   const rule = config.rules.find((r) => r.operation === operation);
   const autoBelow = rule?.autoBelow ?? config.globalAutoBelow;
   const confirmBetween = rule?.confirmBetween ?? 1e3;
-  if (amountUsd < autoBelow) return "auto";
-  if (amountUsd < confirmBetween) return "confirm";
-  return "explicit";
+  let tier;
+  if (amountUsd < autoBelow) tier = "auto";
+  else if (amountUsd < confirmBetween) tier = "confirm";
+  else tier = "explicit";
+  if (tier === "auto" && typeof sessionSpendUsd === "number" && sessionSpendUsd + amountUsd > config.autonomousDailyLimit) {
+    return "confirm";
+  }
+  return tier;
 }
 var TOOL_TO_OPERATION = {
   save_deposit: "save",
@@ -3945,7 +4111,8 @@ var EarlyToolDispatcher = class {
           toolName: entry.call.name,
           toolUseId: entry.call.id,
           result: budgeted,
-          isError: result.isError
+          isError: result.isError,
+          wasEarlyDispatched: true
         };
       } catch (err) {
         yield {
@@ -3953,7 +4120,8 @@ var EarlyToolDispatcher = class {
           toolName: entry.call.name,
           toolUseId: entry.call.id,
           result: { error: err instanceof Error ? err.message : "Tool execution failed" },
-          isError: true
+          isError: true,
+          wasEarlyDispatched: true
         };
       }
     }
@@ -4005,6 +4173,13 @@ var QueryEngine = class {
   contextSummarizer;
   priceCache;
   permissionConfig;
+  // [v1.4] Session-scoped autonomous spend tracking.
+  sessionSpendUsd;
+  onAutoExecuted;
+  onGuardFired;
+  // [v1.5] See `EngineConfig.postWriteRefresh` — drives the post-write
+  // synthetic read injection in `resumeWithToolResult`.
+  postWriteRefresh;
   matchedRecipe = null;
   messages = [];
   abortController = null;
@@ -4034,6 +4209,10 @@ var QueryEngine = class {
     this.contextSummarizer = config.contextSummarizer;
     this.priceCache = config.priceCache;
     this.permissionConfig = config.permissionConfig;
+    this.sessionSpendUsd = config.sessionSpendUsd;
+    this.onAutoExecuted = config.onAutoExecuted;
+    this.onGuardFired = config.onGuardFired;
+    this.postWriteRefresh = config.postWriteRefresh;
     this.tools = config.tools ?? (config.agent ? getDefaultTools() : []);
   }
   /**
@@ -4102,8 +4281,96 @@ var QueryEngine = class {
       yield { type: "turn_complete", stopReason: "end_turn" };
       return;
     }
+    yield* this.runPostWriteRefresh(action, response, signal);
     yield* this.agentLoop(null, signal, false);
   }
+  /**
+   * [v1.5] Auto-run configured read tools after a successful write,
+   * push their results into the conversation, and yield `tool_result`
+   * events so hosts/UI render them in the timeline. See
+   * `EngineConfig.postWriteRefresh`.
+   *
+   * Pure injection — no LLM call here. The next `agentLoop` turn sees
+   * the fresh tool results and narrates from them.
+   */
+  async *runPostWriteRefresh(action, response, signal) {
+    const refreshList = this.postWriteRefresh?.[action.toolName];
+    if (!refreshList || refreshList.length === 0) return;
+    const exec = response.executionResult;
+    const writeFailed = exec != null && typeof exec === "object" && "success" in exec && exec.success === false;
+    if (writeFailed) return;
+    const refreshTools = refreshList.map((name) => findTool(this.tools, name)).filter(
+      (t) => t !== void 0 && t.isReadOnly && t.isConcurrencySafe
+    );
+    if (refreshTools.length === 0) return;
+    const context = {
+      agent: this.agent,
+      mcpManager: this.mcpManager,
+      walletAddress: this.walletAddress,
+      suiRpcUrl: this.suiRpcUrl,
+      serverPositions: this.serverPositions,
+      positionFetcher: this.positionFetcher,
+      env: this.env,
+      signal,
+      priceCache: this.priceCache,
+      permissionConfig: this.permissionConfig,
+      sessionSpendUsd: this.sessionSpendUsd
+    };
+    const idStem = `pwr_${action.toolUseId.slice(-6)}`;
+    const refreshes = await Promise.all(
+      refreshTools.map(async (tool, idx) => {
+        const id = `${idStem}_${idx}_${tool.name}`;
+        try {
+          const parsed = tool.inputSchema.safeParse({});
+          if (!parsed.success) {
+            return {
+              tool,
+              id,
+              isError: true,
+              data: {
+                error: `Post-write refresh: invalid input for ${tool.name}`
+              }
+            };
+          }
+          const result = await tool.call(parsed.data, context);
+          return { tool, id, isError: false, data: result.data };
+        } catch (err) {
+          return {
+            tool,
+            id,
+            isError: true,
+            data: {
+              error: err instanceof Error ? err.message : "Post-write refresh failed"
+            }
+          };
+        }
+      })
+    );
+    const refreshUses = refreshes.map((r) => ({
+      type: "tool_use",
+      id: r.id,
+      name: r.tool.name,
+      input: {}
+    }));
+    this.messages.push({ role: "assistant", content: refreshUses });
+    const refreshResults = refreshes.map((r) => ({
+      type: "tool_result",
+      toolUseId: r.id,
+      content: typeof r.data === "string" ? r.data : JSON.stringify(r.data),
+      isError: r.isError
+    }));
+    this.messages.push({ role: "user", content: refreshResults });
+    for (const r of refreshes) {
+      yield {
+        type: "tool_result",
+        toolName: r.tool.name,
+        toolUseId: r.id,
+        result: r.data,
+        isError: r.isError,
+        wasPostWriteRefresh: true
+      };
+    }
+  }
   interrupt() {
     this.abortController?.abort();
   }
@@ -4155,7 +4422,8 @@ var QueryEngine = class {
       env: this.env,
       signal,
       priceCache: this.priceCache,
-      permissionConfig: this.permissionConfig
+      permissionConfig: this.permissionConfig,
+      sessionSpendUsd: this.sessionSpendUsd
     };
     let turns = 0;
     let hasRetriedWithCleanHistory = false;
@@ -4174,13 +4442,25 @@ var QueryEngine = class {
       };
       const dispatcher = new EarlyToolDispatcher(this.tools, context);
       try {
-        this.messages = microcompact(this.messages);
+        const microcompacted = microcompact(this.messages);
+        this.messages = microcompacted;
+        for (const dedupedId of microcompacted.dedupedToolUseIds) {
+          yield {
+            type: "tool_result",
+            toolName: "__deduped__",
+            toolUseId: dedupedId,
+            result: null,
+            isError: false,
+            resultDeduped: true
+          };
+        }
         if (this.contextBudget.shouldCompact()) {
           this.messages = await compactMessages(this.messages, {
             maxTokens: 1e5,
             keepRecentCount: 8,
             summarizer: this.contextSummarizer
           });
+          yield { type: "compaction" };
         }
         this.messages = validateHistory(this.messages);
         if (process.env.NODE_ENV !== "test") {
@@ -4340,7 +4620,12 @@ ${recipeCtx}`;
             const operation = toolNameToOperation(call.name);
             if (operation) {
               const usdValue = resolveUsdValue(call.name, call.input, context.priceCache);
-              const tier = resolvePermissionTier(operation, usdValue, context.permissionConfig);
+              const tier = resolvePermissionTier(
+                operation,
+                usdValue,
+                context.permissionConfig,
+                context.sessionSpendUsd
+              );
               return tier !== "auto";
             }
           }
@@ -4363,7 +4648,14 @@ ${recipeCtx}`;
             guardedApproved.push(call);
             continue;
           }
-          const check = runGuards(tool, call, this.guardState, this.guardConfig, convCtx);
+          const check = runGuards(
+            tool,
+            call,
+            this.guardState,
+            this.guardConfig,
+            convCtx,
+            this.onGuardFired
+          );
           this.guardEvents.push(...check.events);
           if (check.blocked) {
             yield {
@@ -4445,6 +4737,22 @@ ${recipeCtx}`;
                 toolUseId: finalEvent.toolUseId
               };
             }
+            if (tool && !tool.isReadOnly && this.onAutoExecuted && this.permissionConfig && this.priceCache) {
+              const operation = toolNameToOperation(toolEvent.toolName);
+              if (operation && originalCall) {
+                const usdValue = resolveUsdValue(
+                  toolEvent.toolName,
+                  originalCall.input,
+                  this.priceCache
+                );
+                Promise.resolve().then(() => this.onAutoExecuted({
+                  toolName: toolEvent.toolName,
+                  usdValue
+                })).catch((err) => {
+                  console.warn("[engine] onAutoExecuted callback failed:", err);
+                });
+              }
+            }
           }
           toolResultBlocks.push({
             type: "tool_result",
@@ -4463,7 +4771,8 @@ ${recipeCtx}`;
           pendingWrite.call,
           this.guardState,
           this.guardConfig,
-          convCtx
+          convCtx,
+          this.onGuardFired
         );
         this.guardEvents.push(...check.events);
         if (check.blocked) {
@@ -4490,6 +4799,8 @@ ${recipeCtx}`;
       }
       if (pendingWrite) {
         const writeGuardInjections = pendingWrite.call._guardInjections;
+        const modifiableFields = getModifiableFields(pendingWrite.call.name);
+        const turnIndex = this.messages.filter((m) => m.role === "assistant").length;
         yield {
           type: "pending_action",
           action: {
@@ -4503,7 +4814,9 @@ ${recipeCtx}`;
               content: b.content,
               isError: b.isError ?? false
             })),
-            ...writeGuardInjections?.length ? { guardInjections: writeGuardInjections } : {}
+            ...writeGuardInjections?.length ? { guardInjections: writeGuardInjections } : {},
+            ...modifiableFields?.length ? { modifiableFields } : {},
+            turnIndex
           }
         };
         return;
@@ -5670,6 +5983,6 @@ function sanitizeAnthropicMessages(messages) {
   return merged;
 }
 
-export { AnthropicProvider, BalanceTracker, CANVAS_TEMPLATES, ContextBudget, CostTracker, DEFAULT_GUARD_CONFIG, DEFAULT_PERMISSION_CONFIG, DEFAULT_SYSTEM_PROMPT, EarlyToolDispatcher, McpClientManager, McpResponseCache, MemorySessionStore, NAVI_MCP_CONFIG, NAVI_MCP_URL, NAVI_SERVER_NAME, NaviTools, PERMISSION_PRESETS, QueryEngine, READ_TOOLS, RecipeRegistry, RetryTracker, TOOL_FLAGS, TxMutex, WRITE_TOOLS, activitySummaryTool, adaptAllMcpTools, adaptAllServerTools, adaptMcpTool, applyToolFlags, balanceCheckTool, borrowTool, budgetToolResult, buildCachedSystemPrompt, buildMcpTools, buildProactivenessInstructions, buildProfileContext, buildSelfEvaluationInstruction, buildStateContext, buildTool, claimRewardsTool, classifyEffort, clearPriceCache, compactMessages, createGuardRunnerState, defillamaChainTvlTool, defillamaPriceChangeTool, defillamaProtocolFeesTool, defillamaProtocolInfoTool, defillamaSuiProtocolsTool, defillamaTokenPricesTool, defillamaYieldPoolsTool, engineToSSE, estimateTokens, explainTxTool, extractConversationText, extractMcpText, fetchAvailableRewards, fetchBalance, fetchHealthFactor, fetchPositions, fetchProtocolStats, fetchRates, fetchSavings, fetchTokenPrices, fetchWalletCoins, findTool, getDefaultTools, getMcpManager, getToolFlags, getWalletAddress, guardArtifactPreview, guardStaleData, hasNaviMcp, healthCheckTool, loadRecipes, microcompact, mppServicesTool, parseMcpJson, parseRecipe, parseSSE, payApiTool, portfolioAnalysisTool, protocolDeepDiveTool, ratesInfoTool, registerEngineTools, renderCanvasTool, repayDebtTool, requireAgent, resolvePermissionTier, resolveUsdValue, runGuards, runTools, saveContactTool, saveDepositTool, savingsInfoTool, sendTransferTool, serializeSSE, spendingAnalyticsTool, swapExecuteTool, swapQuoteTool, toolNameToOperation, toolsToDefinitions, transactionHistoryTool, transformBalance, transformHealthFactor, transformPositions, transformRates, transformRewards, transformSavings, updateGuardStateAfterToolResult, validateHistory, voloStakeTool, voloStatsTool, voloUnstakeTool, webSearchTool, withdrawTool, yieldSummaryTool };
+export { AnthropicProvider, BalanceTracker, CANVAS_TEMPLATES, ContextBudget, CostTracker, DEFAULT_GUARD_CONFIG, DEFAULT_PERMISSION_CONFIG, DEFAULT_SYSTEM_PROMPT, EarlyToolDispatcher, McpClientManager, McpResponseCache, MemorySessionStore, NAVI_MCP_CONFIG, NAVI_MCP_URL, NAVI_SERVER_NAME, NaviTools, PERMISSION_PRESETS, QueryEngine, READ_TOOLS, RecipeRegistry, RetryTracker, TOOL_FLAGS, TOOL_MODIFIABLE_FIELDS, TxMutex, WRITE_TOOLS, activitySummaryTool, adaptAllMcpTools, adaptAllServerTools, adaptMcpTool, applyToolFlags, balanceCheckTool, borrowTool, budgetToolResult, buildCachedSystemPrompt, buildMcpTools, buildProactivenessInstructions, buildProfileContext, buildSelfEvaluationInstruction, buildStateContext, buildTool, claimRewardsTool, classifyEffort, clearPriceCache, compactMessages, createGuardRunnerState, defillamaChainTvlTool, defillamaPriceChangeTool, defillamaProtocolFeesTool, defillamaProtocolInfoTool, defillamaSuiProtocolsTool, defillamaTokenPricesTool, defillamaYieldPoolsTool, engineToSSE, estimateTokens, explainTxTool, extractConversationText, extractMcpText, fetchAvailableRewards, fetchBalance, fetchHealthFactor, fetchPositions, fetchProtocolStats, fetchRates, fetchSavings, fetchTokenPrices, fetchWalletCoins, findTool, getDefaultTools, getMcpManager, getModifiableFields, getToolFlags, getWalletAddress, guardArtifactPreview, guardStaleData, hasNaviMcp, healthCheckTool, loadRecipes, microcompact, mppServicesTool, parseMcpJson, parseRecipe, parseSSE, payApiTool, portfolioAnalysisTool, protocolDeepDiveTool, ratesInfoTool, registerEngineTools, renderCanvasTool, repayDebtTool, requireAgent, resolvePermissionTier, resolveUsdValue, runGuards, runTools, saveContactTool, saveDepositTool, savingsInfoTool, sendTransferTool, serializeSSE, spendingAnalyticsTool, swapExecuteTool, swapQuoteTool, toolNameToOperation, toolsToDefinitions, transactionHistoryTool, transformBalance, transformHealthFactor, transformPositions, transformRates, transformRewards, transformSavings, updateGuardStateAfterToolResult, validateHistory, voloStakeTool, voloStatsTool, voloUnstakeTool, webSearchTool, withdrawTool, yieldSummaryTool };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map