@t2000/engine 1.9.0 → 1.10.1

package/dist/index.js

@@ -3056,7 +3056,7 @@ var transactionHistoryTool = buildTool({
 var SAVE_ASSETS = ["USDC", "USDsui"];
 var saveDepositTool = buildTool({
   name: "save_deposit",
-  description: 'Deposit USDC or USDsui into NAVI savings to earn yield. ONLY these two stables are accepted. If the user asks to save/deposit any other token (GOLD, SUI, USDT, USDe, ETH, etc.), do NOT call this tool and do NOT automatically swap their tokens and deposit. Instead, tell the user that only USDC and USDsui deposits are supported and ask if they would like to swap first. Let the user decide \u2014 never auto-chain swap + deposit. When the user says "save 10 USDC" pass asset="USDC". When they say "save 10 USDsui" pass asset="USDsui". When they say "save 10" with no asset, ALWAYS call balance_check first and ask which stable they want to deposit (or default to whichever they hold more of, with a one-line note). Never silently substitute USDsui for USDC or vice versa.',
+  description: 'Deposit USDC or USDsui into NAVI savings to earn yield. ONLY these two stables are accepted. If the user asks to save/deposit any other token (GOLD, SUI, USDT, USDe, ETH, etc.), do NOT call this tool and do NOT automatically swap their tokens and deposit. Instead, tell the user that only USDC and USDsui deposits are supported and ask if they would like to swap first. Let the user decide \u2014 never auto-chain swap + deposit. When the user says "save 10 USDC" pass asset="USDC". When they say "save 10 USDsui" pass asset="USDsui". When they say "save 10" with no asset, ALWAYS call balance_check first and ask which stable they want to deposit (or default to whichever they hold more of, with a one-line note). Never silently substitute USDsui for USDC or vice versa. Payment Stream: bundleable \u2014 when paired with another bundleable write in the same request (e.g. "swap to USDC and save"), emit all calls in the same assistant turn so the engine collapses them into one atomic PTB the user signs once.',
   inputSchema: z.object({
     amount: z.number().positive(),
     asset: z.enum(SAVE_ASSETS).optional().describe('"USDC" or "USDsui". Defaults to USDC when omitted.')
@@ -3109,7 +3109,7 @@ var saveDepositTool = buildTool({
 });
 var withdrawTool = buildTool({
   name: "withdraw",
-  description: "Withdraw from NAVI lending back to wallet. Defaults to USDC; also withdraws USDsui (the second active saveable stable). Legacy positions in other assets (USDe, SUI) can still be withdrawn if the user has them \u2014 but only USDC and USDsui are eligible to be re-deposited via save_deposit.",
+  description: 'Withdraw from NAVI lending back to wallet. Defaults to USDC; also withdraws USDsui (the second active saveable stable). Legacy positions in other assets (USDe, SUI) can still be withdrawn if the user has them \u2014 but only USDC and USDsui are eligible to be re-deposited via save_deposit. Payment Stream: bundleable \u2014 when paired with another bundleable write in the same request (e.g. "withdraw and send to Mom"), emit all calls in the same assistant turn so the engine collapses them into one atomic PTB the user signs once.',
   inputSchema: z.object({
     amount: z.number().positive(),
     asset: z.string().optional().describe("Asset to withdraw (default: USDC). Active: USDsui. Legacy positions: USDe, SUI.")
@@ -3152,7 +3152,7 @@ var withdrawTool = buildTool({
 var ASSET_LIST = ALL_NAVI_ASSETS.map((a) => String(a)).join(", ");
 var sendTransferTool = buildTool({
   name: "send_transfer",
-  description: `Send ANY supported token (${ASSET_LIST}) to another Sui address or contact name. Validates the address, checks balance, and executes the on-chain transfer. MUST set the \`asset\` field to the token symbol you want to send (case-insensitive). If \`asset\` is omitted, USDC is assumed \u2014 only do this when the user explicitly asks for USDC. When the user asks to send a token by name (SUI, USDT, etc.) or to send the proceeds of a just-completed swap, you MUST pass \`asset\` matching that token. Returns tx hash, gas cost, and updated balance.`,
+  description: `Send ANY supported token (${ASSET_LIST}) to another Sui address or contact name. Validates the address, checks balance, and executes the on-chain transfer. MUST set the \`asset\` field to the token symbol you want to send (case-insensitive). If \`asset\` is omitted, USDC is assumed \u2014 only do this when the user explicitly asks for USDC. When the user asks to send a token by name (SUI, USDT, etc.) or to send the proceeds of a just-completed swap, you MUST pass \`asset\` matching that token. Returns tx hash, gas cost, and updated balance. Payment Stream: bundleable \u2014 when paired with another bundleable write in the same request (e.g. "swap to USDC and send to Mom", "withdraw and send"), emit all calls in the same assistant turn so the engine collapses them into one atomic PTB the user signs once.`,
   inputSchema: z.object({
     to: z.string().min(1),
     amount: z.number().positive(),
@@ -3229,7 +3229,7 @@ var sendTransferTool = buildTool({
 var BORROW_ASSETS = ["USDC", "USDsui"];
 var borrowTool = buildTool({
   name: "borrow",
-  description: 'Borrow USDC or USDsui against savings collateral. ONLY these two stables are supported. Requires existing savings deposits as collateral. Checks max safe borrow and health factor. Returns tx hash, fee, asset borrowed, and post-borrow health factor. When the user says "borrow 10 USDC" pass asset="USDC". When they say "borrow 10 USDsui" pass asset="USDsui". When they say "borrow 10" with no asset, default to USDC unless the user has only USDsui collateral.',
+  description: 'Borrow USDC or USDsui against savings collateral. ONLY these two stables are supported. Requires existing savings deposits as collateral. Checks max safe borrow and health factor. Returns tx hash, fee, asset borrowed, and post-borrow health factor. When the user says "borrow 10 USDC" pass asset="USDC". When they say "borrow 10 USDsui" pass asset="USDsui". When they say "borrow 10" with no asset, default to USDC unless the user has only USDsui collateral. Payment Stream: bundleable \u2014 when paired with another bundleable write in the same request (e.g. "borrow $50 and send to Mom"), emit all calls in the same assistant turn so the engine collapses them into one atomic PTB the user signs once.',
   inputSchema: z.object({
     amount: z.number().positive(),
     asset: z.enum(BORROW_ASSETS).optional().describe('"USDC" or "USDsui". Defaults to USDC when omitted.')
@@ -3283,7 +3283,7 @@ var borrowTool = buildTool({
 var REPAY_ASSETS = ["USDC", "USDsui"];
 var repayDebtTool = buildTool({
   name: "repay_debt",
-  description: 'Repay outstanding USDC or USDsui debt. Always call balance_check first to know the debt amount + which asset is owed (savings_info shows per-asset borrow positions). Pass asset="USDC" or asset="USDsui" to target a specific debt. When omitted, repays the highest-APY borrow first. Important: a USDsui debt MUST be repaid with USDsui (and USDC debt with USDC) \u2014 the SDK fetches the correct coin type for the targeted asset, but the user must hold enough of that stable in their wallet. If the user has only the wrong stable, do NOT auto-swap \u2014 tell them to swap manually first. Returns tx hash, amount repaid, asset, and remaining debt.',
+  description: 'Repay outstanding USDC or USDsui debt. Always call balance_check first to know the debt amount + which asset is owed (savings_info shows per-asset borrow positions). Pass asset="USDC" or asset="USDsui" to target a specific debt. When omitted, repays the highest-APY borrow first. Important: a USDsui debt MUST be repaid with USDsui (and USDC debt with USDC) \u2014 the SDK fetches the correct coin type for the targeted asset, but the user must hold enough of that stable in their wallet. If the user has only the wrong stable, do NOT auto-swap \u2014 tell them to swap manually first. Returns tx hash, amount repaid, asset, and remaining debt. Payment Stream: bundleable \u2014 when paired with another bundleable write in the same request (e.g. "repay debt then withdraw the rest"), emit all calls in the same assistant turn so the engine collapses them into one atomic PTB the user signs once.',
   inputSchema: z.object({
     amount: z.number().positive(),
     asset: z.enum(REPAY_ASSETS).optional().describe('"USDC" or "USDsui". When omitted, repays the highest-APY borrow first.')
@@ -3340,7 +3340,7 @@ function formatAmount(amount) {
 }
 var claimRewardsTool = buildTool({
   name: "claim_rewards",
-  description: 'Claim all pending protocol rewards across lending adapters. Returns the claimed reward breakdown (per-asset symbol + amount), total USD value (best effort \u2014 may be 0 when oracle prices are unavailable), and the on-chain tx hash. When the rewards list is empty the response will explicitly say "no pending rewards"; when it is non-empty narrate the per-symbol amounts even if totalValueUsd is 0 (the on-chain credit still happened).',
+  description: 'Claim all pending protocol rewards across lending adapters. Returns the claimed reward breakdown (per-asset symbol + amount), total USD value (best effort \u2014 may be 0 when oracle prices are unavailable), and the on-chain tx hash. When the rewards list is empty the response will explicitly say "no pending rewards"; when it is non-empty narrate the per-symbol amounts even if totalValueUsd is 0 (the on-chain credit still happened). Payment Stream: bundleable \u2014 when paired with another bundleable write in the same request (e.g. "claim rewards and stake them"), emit all calls in the same assistant turn so the engine collapses them into one atomic PTB the user signs once.',
   inputSchema: z.object({}),
   jsonSchema: { type: "object", properties: {}, required: [] },
   isReadOnly: false,
@@ -3600,7 +3600,7 @@ var mppServicesTool = buildTool({
 });
 var swapExecuteTool = buildTool({
   name: "swap_execute",
-  description: "Swap tokens on Sui via Cetus Aggregator (20+ DEXs). Supports any token pair with liquidity. Use user-friendly names (SUI, USDC, CETUS, DEEP, etc.) or full coin types.",
+  description: 'Swap tokens on Sui via Cetus Aggregator (20+ DEXs). Supports any token pair with liquidity. Use user-friendly names (SUI, USDC, CETUS, DEEP, etc.) or full coin types. Payment Stream: bundleable \u2014 when paired with another bundleable write in the same request (e.g. "swap to USDC and save", "swap and send to Mom"), emit all calls in the same assistant turn so the engine collapses them into one atomic PTB the user signs once.',
   inputSchema: z.object({
     from: z.string().describe('Source token (e.g. "SUI", "USDC", or full coin type)'),
     to: z.string().describe('Target token (e.g. "USDC", "CETUS", or full coin type)'),
@@ -3689,7 +3689,7 @@ var swapQuoteTool = buildTool({
 });
 var voloStakeTool = buildTool({
   name: "volo_stake",
-  description: "Stake SUI for vSUI via VOLO liquid staking. Earn ~3-5% APY. Rewards compound automatically via exchange rate \u2014 no claiming needed. Minimum 1 SUI.",
+  description: 'Stake SUI for vSUI via VOLO liquid staking. Earn ~3-5% APY. Rewards compound automatically via exchange rate \u2014 no claiming needed. Minimum 1 SUI. Payment Stream: bundleable \u2014 when paired with another bundleable write in the same request (e.g. "swap USDC to SUI and stake"), emit all calls in the same assistant turn so the engine collapses them into one atomic PTB the user signs once.',
   inputSchema: z.object({
     amount: z.number().min(1).describe("Amount of SUI to stake (minimum 1)")
   }),
@@ -3720,7 +3720,7 @@ var voloStakeTool = buildTool({
 });
 var voloUnstakeTool = buildTool({
   name: "volo_unstake",
-  description: 'Unstake vSUI back to SUI. Returns SUI including accumulated yield. Use amount in vSUI units or "all" to unstake entire position.',
+  description: 'Unstake vSUI back to SUI. Returns SUI including accumulated yield. Use amount in vSUI units or "all" to unstake entire position. Payment Stream: bundleable \u2014 when paired with another bundleable write in the same request (e.g. "unstake vSUI and send to Mom"), emit all calls in the same assistant turn so the engine collapses them into one atomic PTB the user signs once.',
   inputSchema: z.object({
     amount: z.union([z.number().positive(), z.literal("all")]).describe('Amount of vSUI to unstake, or "all"')
   }),
@@ -7290,6 +7290,7 @@ var QueryEngine = class {
     let turns = 0;
     let hasRetriedWithCleanHistory = false;
     let turnStartMs = Date.now();
+    const turnReadToolResults = [];
     while (turns < this.maxTurns) {
       if (signal.aborted) {
         yield { type: "error", error: new Error("Aborted") };
@@ -7305,7 +7306,6 @@ var QueryEngine = class {
         pendingToolCalls: []
       };
       const dispatcher = new EarlyToolDispatcher(this.tools, context, this.turnReadCache);
-      const turnReadToolResults = [];
       try {
         const microcompacted = microcompact(this.messages, this.tools);
         this.messages = microcompacted;
@@ -8378,6 +8378,10 @@ var RecipeRegistry = class {
       recipe.description,
       "Follow these steps:"
     ];
+    const bundleSteps = recipe.steps.filter((s) => s.bundle === true);
+    const bundleStepNames = new Set(bundleSteps.map((s) => s.name));
+    const showBundleHeader = bundleStepNames.size >= 2;
+    let openedBundleHeader = false;
     for (let i = 0; i < recipe.steps.length; i++) {
       const step = recipe.steps[i];
       const num = i + 1;
@@ -8385,7 +8389,14 @@ var RecipeRegistry = class {
       const serviceNote = step.service ? ` (${step.service})` : "";
       const costNote = step.cost ? ` \u2014 ${step.cost}` : "";
       const gateNote = step.gate && step.gate !== "none" ? ` [GATE: ${step.gate}]` : "";
-      let line = `${num}. ${step.name}${toolNote}${serviceNote}${costNote}${gateNote}`;
+      if (showBundleHeader && step.bundle === true && !openedBundleHeader) {
+        lines.push(
+          "PAYMENT STREAM \u2014 emit ALL the following bundleable writes as parallel `tool_use` blocks IN THE SAME ASSISTANT TURN. The engine collapses them into ONE atomic PTB the user signs once. Do NOT execute step-by-step across turns:"
+        );
+        openedBundleHeader = true;
+      }
+      const bundleTag = showBundleHeader && step.bundle === true ? " [PAYMENT STREAM]" : "";
+      let line = `${num}. ${step.name}${toolNote}${serviceNote}${costNote}${gateNote}${bundleTag}`;
       if (step.gate_prompt) {
         line += ` \u2014 "${step.gate_prompt}"`;
       }