@t2000/engine 1.8.0 → 1.10.0

package/dist/index.d.ts

@@ -1535,6 +1535,14 @@ declare class QueryEngine {
     private runPostWriteRefresh;
     interrupt(): void;
     getMessages(): readonly Message[];
+    /**
+     * [SPEC 7 P2.4b] Read-only access to the engine's tool registry.
+     * Exposed so out-of-band utilities like `regenerateBundle` can call
+     * `composeBundleFromToolResults({ tools: engine.getTools(), ... })`
+     * without forcing the host to hand-thread the tool array. Mirrors
+     * `getMessages()` access pattern.
+     */
+    getTools(): readonly Tool[];
     getMatchedRecipe(): Recipe | null;
     getContextBudget(): ContextBudget;
     reset(): void;
@@ -1632,6 +1640,125 @@ declare function bundleShortestTtl(toolUseIds: string[], toolNamesById: Record<s
 /** The set of read tools whose results re-fire on REGENERATE. */
 declare const REGENERATABLE_READ_TOOLS: ReadonlySet<string>;
 
+/**
+ * SPEC 7 v0.3 Quote-Refresh ReviewCard — engine-side bundle regeneration.
+ *
+ * When a user takes 30–60s to read a multi-step Payment Stream
+ * `pending_action`, the upstream read results that fed bundle composition
+ * (Cetus quotes, NAVI APYs, wallet balances) drift. Today the user has to
+ * either approve with stale data (Sui dry-run is the safety gate, but the
+ * UX is "did this just lie to me?") or cancel and re-prompt the LLM
+ * (loses the narrative thread). The Quote-Refresh ReviewCard adds a
+ * third option: an explicit REGENERATE button that re-fires the
+ * upstream reads (no LLM call), rebuilds the bundle in place, and
+ * yields a fresh `pending_action` with new per-step `attemptId`s.
+ *
+ * **What this function does NOT do.**
+ *  - Run the LLM. Regenerate is "re-evaluate the same intent against
+ *    fresh state" — the writes' tool names + inputs stay identical;
+ *    only the upstream read TIMESTAMPS change (and any downstream
+ *    derivations the host made off them).
+ *  - Run the bundle on-chain. The host still presents the new
+ *    PermissionCard for confirmation; user can approve, regenerate
+ *    again, or deny.
+ *  - Mutate `TurnMetrics` rows. The host route owns analytics — see
+ *    `audric/apps/web/app/api/engine/regenerate/route.ts`.
+ *
+ * **Spec 1 / Spec 2 invariants preserved.**
+ *  - Each regeneration produces its own per-step `attemptId` (UUID v4),
+ *    so the host can write a fresh `TurnMetrics` row keyed on it.
+ *  - The original `pending_action`'s `attemptId` stays valid for the
+ *    host's `pendingActionOutcome = 'regenerated'` update — no
+ *    accidental over-write of the original row.
+ *
+ * **Why synchronous (no SSE).** The chat stream that originally
+ * yielded the bundled `pending_action` has already closed by the time
+ * the user taps Regenerate (`useEngine.ts` flips `isStreaming: false`
+ * on `pending_action`). Reopening a stream for a sub-second round-trip
+ * would be heavier than the host needs. Instead, the host endpoint
+ * calls this function synchronously and returns
+ * `{ success, newPendingAction, timelineEvents[] }` in the response
+ * body — host renders `timelineEvents[]` as a "↻ Regenerated · Ns"
+ * group above the new card.
+ */
+
+/**
+ * One event in the `timelineEvents[]` array returned to the host.
+ * Mirrors the engine's normal SSE event shapes for `tool_start` and
+ * `tool_result` so the host can push them onto its timeline as if they
+ * had streamed live.
+ */
+type RegenerateTimelineEvent = {
+    type: 'tool_start';
+    toolName: string;
+    toolUseId: string;
+    input: unknown;
+} | {
+    type: 'tool_result';
+    toolName: string;
+    toolUseId: string;
+    result: unknown;
+    isError: boolean;
+    durationMs: number;
+};
+interface RegenerateSuccess {
+    success: true;
+    /**
+     * Fresh `pending_action` with new per-step `attemptId`s. The host
+     * swaps this in for the original `PermissionCard` payload; the
+     * existing PermissionCard renderer requires no changes — it sees a
+     * fresh action with a fresh `quoteAge` of ~0ms.
+     */
+    newPendingAction: PendingAction;
+    /**
+     * Re-fired upstream read events the host renders as a
+     * "↻ Regenerated · Ns" group above the new card. Order: every
+     * `tool_start` for one read is paired with its `tool_result`; reads
+     * are processed serially (so durations sum cleanly for the group
+     * label).
+     */
+    timelineEvents: RegenerateTimelineEvent[];
+}
+interface RegenerateFailure {
+    success: false;
+    reason: 'pending_action_not_found' | 'cannot_regenerate' | 'engine_error';
+    message: string;
+}
+type RegenerateResult = RegenerateSuccess | RegenerateFailure;
+/**
+ * Re-fire the upstream reads that fed a bundled pending_action and
+ * compose a fresh bundle. The engine MUST be created with the same
+ * tool registry + ToolContext as the chat turn that produced the
+ * original action. The host typically reaches this by calling
+ * `createEngine({ address, session })` on the same session that
+ * persisted the pending_action.
+ *
+ * **Side effect.** On success, this mutates the engine's message
+ * history by appending one synthetic assistant message (carrying the
+ * regenerated `tool_use` blocks) and one user message (carrying the
+ * fresh `tool_result` blocks). This is so the LLM sees the fresh
+ * data when the user approves the new bundle and the engine resumes.
+ * The host should persist `engine.getMessages()` back to its session
+ * store after a successful regenerate.
+ *
+ * **Failure modes.**
+ *  - `pending_action_not_found` — the action isn't a bundle (no
+ *    `steps`, or fewer than 2 steps). Single-write actions can't be
+ *    regenerated by design.
+ *  - `cannot_regenerate` — the action's `canRegenerate` flag is
+ *    false, OR no contributing read tool_use_ids could be located in
+ *    session history.
+ *  - `engine_error` — a tool re-execution threw, OR bundle
+ *    composition rejected (defensive — should not happen if the
+ *    original bundle was valid).
+ *
+ * Errors in tool re-execution short-circuit the whole regenerate
+ * (bundle composition would inherit a broken read result). The host
+ * surfaces this as a toast: "Could not regenerate. The original card
+ * is still valid."
+ */
+declare function regenerateBundle(engine: QueryEngine, action: PendingAction): Promise<RegenerateResult>;
+
 interface BuildToolOptions<TInput, TOutput> {
     name: string;
     description: string;
@@ -3521,4 +3648,4 @@ declare function getTelemetrySink(): TelemetrySink;
 /** Restore the default noop sink. Used by test teardowns. */
 declare function resetTelemetrySink(): void;
 
-export { type AddressPortfolio, AnthropicProvider, type AnthropicProviderConfig, type AudricHistoryRecord, type AudricPortfolioResult, type AwaitOrFetchOpts, type BalancePrices, type BalanceResult, BalanceTracker, type BuildToolOptions, CANVAS_TEMPLATES, type CanvasTemplate, type ChatParams, type CompactOptions, type ContentBlock, ContextBudget, type ContextBudgetConfig, type ConversationState, type ConversationStateStore, type CostSnapshot, CostTracker, type CostTrackerConfig, DEFAULT_GUARD_CONFIG, DEFAULT_LEASE_SEC, DEFAULT_PERMISSION_CONFIG, DEFAULT_POLL_BUDGET_MS, DEFAULT_POLL_INTERVAL_MS, DEFAULT_SYSTEM_PROMPT, DEFAULT_TOOL_TTL_MS, type DefiCacheEntry, type DefiCacheStore, type DefiProtocol, type DefiSummary, EFFORT_THINKING_BUDGET_CAPS, EarlyToolDispatcher, type EngineConfig, type EngineEvent, type EvalSummaryParseResult, type EvaluationItem, type EvaluationStatus, type FetchLock, type GuardCheckResult, type GuardConfig, type GuardEvent, type GuardInjection, type GuardResult, type GuardRunnerState, type GuardTier, type GuardVerdict, type HarnessShape, type HealthFactorResult, InMemoryDefiCacheStore, InMemoryFetchLock, InMemoryNaviCacheStore, InMemoryWalletCacheStore, InvalidAddressError, type LLMProvider, type McpCallResult, McpClientManager, McpResponseCache, type McpServerConfig, type McpServerConnection, type McpToolAdapterConfig, type McpToolDescriptor, MemorySessionStore, type Message, NAVI_ADDR_TTL_SEC, NAVI_MCP_CONFIG, NAVI_MCP_URL, NAVI_RATES_TTL_SEC, NAVI_SERVER_NAME, type NaviCacheEntry, type NaviCacheStore, type NaviRawCoin, type NaviRawHealthFactor, type NaviRawPool, type NaviRawPosition, type NaviRawPositionsResponse, type NaviRawProtocolStats, type NaviRawRewardsResponse, type NaviReadOptions, NaviTools, type NormalizedAddress, type OutputConfig, PERMISSION_PRESETS, type PendingAction, type PendingActionModifiableField, type PendingActionStep, type PendingReward, type PendingToolCall, type PermissionLevel, type PermissionOperation, type PermissionResponse, type PermissionRule, type PortfolioCoin, type PositionEntry, type PreflightResult, type ProtocolStats, type ProviderEvent, QueryEngine, READ_TOOLS, REGENERATABLE_READ_TOOLS, type RatesResult, type Recipe, type RecipePrerequisite, RecipeRegistry, type RecipeStep, type RecipeStepOnError, RetryTracker, type SSEEvent, SUINS_NAME_REGEX, SUI_ADDRESS_REGEX, SUI_ADDRESS_STRICT_REGEX, type SavingsResult, type ServerPositionData, type SessionData, type SessionStore, type StateType, type StopReason, type SuiCoinBalance, SuinsNotRegisteredError, SuinsRpcError, type SystemBlock, type SystemPrompt, TOOL_FLAGS, TOOL_MODIFIABLE_FIELDS, TOOL_TTL_MS, type TelemetrySink, type TelemetryTags, type ThinkingConfig, type ThinkingEffort, type TodoItem$1 as TodoItem, type Tool, type ToolChoice, type ToolContext, type ToolDefinition, type ToolFlags, type ToolJsonSchema, type ToolResult, TxMutex, type UpdateTodoInput, type TodoItem as UpdateTodoItem, type UserFinancialProfile, type UserPermissionConfig, WRITE_TOOLS, type WalletCacheEntry, type WalletCacheStore, type WalletCoin, _resetNaviCircuitBreaker, activitySummaryTool, adaptAllMcpTools, adaptAllServerTools, adaptMcpTool, applyToolFlags, awaitOrFetch, balanceCheckTool, borrowTool, budgetToolResult, buildCachedSystemPrompt, buildMcpTools, buildProactivenessInstructions, buildProfileContext, buildSelfEvaluationInstruction, buildStateContext, buildTool, bundleShortestTtl, claimRewardsTool, clampThinkingForEffort, classifyEffort, clearPortfolioCache, clearPortfolioCacheFor, clearPriceMapCache, compactMessages, createGuardRunnerState, engineToSSE, estimateTokens, explainTxTool, extractConversationText, extractMcpText, fetchAddressDefiPortfolio, fetchAddressPortfolio, fetchAudricHistory, fetchAudricPortfolio, fetchAvailableRewards, fetchBalance, fetchHealthFactor, fetchPositions, fetchProtocolStats, fetchRates, fetchSavings, fetchTokenPrices, fetchWalletCoins, findTool, getAudricApiBase, getDefaultTools, getDefiCacheStore, getFetchLock, getMcpManager, getModifiableFields, getNaviCacheStore, getTelemetrySink, getToolFlags, getWalletAddress, getWalletCacheStore, guardArtifactPreview, guardStaleData, harnessShapeForEffort, hasNaviMcp, healthCheckTool, isBundleableTool, loadRecipes, looksLikeSuiNs, microcompact, mppServicesTool, naviKey, normalizeAddressInput, parseEvalSummary, parseMcpJson, parseRecipe, parseSSE, payApiTool, portfolioAnalysisTool, protocolDeepDiveTool, ratesInfoTool, registerEngineTools, renderCanvasTool, repayDebtTool, requireAgent, resetDefiCacheStore, resetFetchLock, resetNaviCacheStore, resetTelemetrySink, resetWalletCacheStore, resolveAddressToSuinsViaRpc, resolvePermissionTier, resolveSuinsTool, resolveSuinsViaRpc, resolveUsdValue, runGuards, runTools, saveContactTool, saveDepositTool, savingsInfoTool, sendTransferTool, serializeSSE, setDefiCacheStore, setFetchLock, setNaviCacheStore, setTelemetrySink, setWalletCacheStore, spendingAnalyticsTool, swapExecuteTool, swapQuoteTool, tokenPricesTool, toolNameToOperation, toolsToDefinitions, transactionHistoryTool, transformBalance, transformHealthFactor, transformPositions, transformRates, transformRewards, transformSavings, updateGuardStateAfterToolResult, updateTodoTool, validateHistory, voloStakeTool, voloStatsTool, voloUnstakeTool, webSearchTool, withdrawTool, yieldSummaryTool };
+export { type AddressPortfolio, AnthropicProvider, type AnthropicProviderConfig, type AudricHistoryRecord, type AudricPortfolioResult, type AwaitOrFetchOpts, type BalancePrices, type BalanceResult, BalanceTracker, type BuildToolOptions, CANVAS_TEMPLATES, type CanvasTemplate, type ChatParams, type CompactOptions, type ContentBlock, ContextBudget, type ContextBudgetConfig, type ConversationState, type ConversationStateStore, type CostSnapshot, CostTracker, type CostTrackerConfig, DEFAULT_GUARD_CONFIG, DEFAULT_LEASE_SEC, DEFAULT_PERMISSION_CONFIG, DEFAULT_POLL_BUDGET_MS, DEFAULT_POLL_INTERVAL_MS, DEFAULT_SYSTEM_PROMPT, DEFAULT_TOOL_TTL_MS, type DefiCacheEntry, type DefiCacheStore, type DefiProtocol, type DefiSummary, EFFORT_THINKING_BUDGET_CAPS, EarlyToolDispatcher, type EngineConfig, type EngineEvent, type EvalSummaryParseResult, type EvaluationItem, type EvaluationStatus, type FetchLock, type GuardCheckResult, type GuardConfig, type GuardEvent, type GuardInjection, type GuardResult, type GuardRunnerState, type GuardTier, type GuardVerdict, type HarnessShape, type HealthFactorResult, InMemoryDefiCacheStore, InMemoryFetchLock, InMemoryNaviCacheStore, InMemoryWalletCacheStore, InvalidAddressError, type LLMProvider, type McpCallResult, McpClientManager, McpResponseCache, type McpServerConfig, type McpServerConnection, type McpToolAdapterConfig, type McpToolDescriptor, MemorySessionStore, type Message, NAVI_ADDR_TTL_SEC, NAVI_MCP_CONFIG, NAVI_MCP_URL, NAVI_RATES_TTL_SEC, NAVI_SERVER_NAME, type NaviCacheEntry, type NaviCacheStore, type NaviRawCoin, type NaviRawHealthFactor, type NaviRawPool, type NaviRawPosition, type NaviRawPositionsResponse, type NaviRawProtocolStats, type NaviRawRewardsResponse, type NaviReadOptions, NaviTools, type NormalizedAddress, type OutputConfig, PERMISSION_PRESETS, type PendingAction, type PendingActionModifiableField, type PendingActionStep, type PendingReward, type PendingToolCall, type PermissionLevel, type PermissionOperation, type PermissionResponse, type PermissionRule, type PortfolioCoin, type PositionEntry, type PreflightResult, type ProtocolStats, type ProviderEvent, QueryEngine, READ_TOOLS, REGENERATABLE_READ_TOOLS, type RatesResult, type Recipe, type RecipePrerequisite, RecipeRegistry, type RecipeStep, type RecipeStepOnError, type RegenerateFailure, type RegenerateResult, type RegenerateSuccess, type RegenerateTimelineEvent, RetryTracker, type SSEEvent, SUINS_NAME_REGEX, SUI_ADDRESS_REGEX, SUI_ADDRESS_STRICT_REGEX, type SavingsResult, type ServerPositionData, type SessionData, type SessionStore, type StateType, type StopReason, type SuiCoinBalance, SuinsNotRegisteredError, SuinsRpcError, type SystemBlock, type SystemPrompt, TOOL_FLAGS, TOOL_MODIFIABLE_FIELDS, TOOL_TTL_MS, type TelemetrySink, type TelemetryTags, type ThinkingConfig, type ThinkingEffort, type TodoItem$1 as TodoItem, type Tool, type ToolChoice, type ToolContext, type ToolDefinition, type ToolFlags, type ToolJsonSchema, type ToolResult, TxMutex, type UpdateTodoInput, type TodoItem as UpdateTodoItem, type UserFinancialProfile, type UserPermissionConfig, WRITE_TOOLS, type WalletCacheEntry, type WalletCacheStore, type WalletCoin, _resetNaviCircuitBreaker, activitySummaryTool, adaptAllMcpTools, adaptAllServerTools, adaptMcpTool, applyToolFlags, awaitOrFetch, balanceCheckTool, borrowTool, budgetToolResult, buildCachedSystemPrompt, buildMcpTools, buildProactivenessInstructions, buildProfileContext, buildSelfEvaluationInstruction, buildStateContext, buildTool, bundleShortestTtl, claimRewardsTool, clampThinkingForEffort, classifyEffort, clearPortfolioCache, clearPortfolioCacheFor, clearPriceMapCache, compactMessages, createGuardRunnerState, engineToSSE, estimateTokens, explainTxTool, extractConversationText, extractMcpText, fetchAddressDefiPortfolio, fetchAddressPortfolio, fetchAudricHistory, fetchAudricPortfolio, fetchAvailableRewards, fetchBalance, fetchHealthFactor, fetchPositions, fetchProtocolStats, fetchRates, fetchSavings, fetchTokenPrices, fetchWalletCoins, findTool, getAudricApiBase, getDefaultTools, getDefiCacheStore, getFetchLock, getMcpManager, getModifiableFields, getNaviCacheStore, getTelemetrySink, getToolFlags, getWalletAddress, getWalletCacheStore, guardArtifactPreview, guardStaleData, harnessShapeForEffort, hasNaviMcp, healthCheckTool, isBundleableTool, loadRecipes, looksLikeSuiNs, microcompact, mppServicesTool, naviKey, normalizeAddressInput, parseEvalSummary, parseMcpJson, parseRecipe, parseSSE, payApiTool, portfolioAnalysisTool, protocolDeepDiveTool, ratesInfoTool, regenerateBundle, registerEngineTools, renderCanvasTool, repayDebtTool, requireAgent, resetDefiCacheStore, resetFetchLock, resetNaviCacheStore, resetTelemetrySink, resetWalletCacheStore, resolveAddressToSuinsViaRpc, resolvePermissionTier, resolveSuinsTool, resolveSuinsViaRpc, resolveUsdValue, runGuards, runTools, saveContactTool, saveDepositTool, savingsInfoTool, sendTransferTool, serializeSSE, setDefiCacheStore, setFetchLock, setNaviCacheStore, setTelemetrySink, setWalletCacheStore, spendingAnalyticsTool, swapExecuteTool, swapQuoteTool, tokenPricesTool, toolNameToOperation, toolsToDefinitions, transactionHistoryTool, transformBalance, transformHealthFactor, transformPositions, transformRates, transformRewards, transformSavings, updateGuardStateAfterToolResult, updateTodoTool, validateHistory, voloStakeTool, voloStatsTool, voloUnstakeTool, webSearchTool, withdrawTool, yieldSummaryTool };

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"')
   }),
@@ -7160,6 +7160,16 @@ var QueryEngine = class {
   getMessages() {
     return this.messages;
   }
+  /**
+   * [SPEC 7 P2.4b] Read-only access to the engine's tool registry.
+   * Exposed so out-of-band utilities like `regenerateBundle` can call
+   * `composeBundleFromToolResults({ tools: engine.getTools(), ... })`
+   * without forcing the host to hand-thread the tool array. Mirrors
+   * `getMessages()` access pattern.
+   */
+  getTools() {
+    return this.tools;
+  }
   getMatchedRecipe() {
     return this.matchedRecipe;
   }
@@ -8022,6 +8032,158 @@ function harnessShapeForEffort(effort) {
       return "max";
   }
 }
+async function regenerateBundle(engine, action) {
+  if (!action.steps || action.steps.length < 2) {
+    return {
+      success: false,
+      reason: "pending_action_not_found",
+      message: "Action is not a multi-step bundle"
+    };
+  }
+  if (action.canRegenerate !== true) {
+    return {
+      success: false,
+      reason: "cannot_regenerate",
+      message: "Bundle has canRegenerate=false (no upstream reads contributed)"
+    };
+  }
+  const regenIds = action.regenerateInput?.toolUseIds ?? [];
+  if (regenIds.length === 0) {
+    return {
+      success: false,
+      reason: "cannot_regenerate",
+      message: "Bundle has no regenerateInput.toolUseIds"
+    };
+  }
+  const messages = engine.getMessages();
+  const tools = [...engine.getTools()];
+  const originalReads = [];
+  for (const id of regenIds) {
+    let found = null;
+    outer: for (const msg of messages) {
+      if (msg.role !== "assistant") continue;
+      for (const block of msg.content) {
+        if (block.type === "tool_use" && block.id === id) {
+          found = {
+            name: block.name,
+            input: block.input
+          };
+          break outer;
+        }
+      }
+    }
+    if (!found) {
+      return {
+        success: false,
+        reason: "engine_error",
+        message: `Original tool_use ${id} not found in session history`
+      };
+    }
+    if (!REGENERATABLE_READ_TOOLS.has(found.name)) {
+      continue;
+    }
+    originalReads.push({ toolName: found.name, input: found.input });
+  }
+  if (originalReads.length === 0) {
+    return {
+      success: false,
+      reason: "cannot_regenerate",
+      message: "No regeneratable read tool_use blocks found in session history"
+    };
+  }
+  const timelineEvents = [];
+  const newReads = [];
+  for (const r of originalReads) {
+    const newToolUseId = `regen_${randomUUID().replace(/-/g, "").slice(0, 16)}`;
+    timelineEvents.push({
+      type: "tool_start",
+      toolName: r.toolName,
+      toolUseId: newToolUseId,
+      input: r.input
+    });
+    const t0 = Date.now();
+    let outcome;
+    try {
+      outcome = await engine.invokeReadTool(r.toolName, r.input);
+    } catch (err) {
+      outcome = {
+        data: { error: err instanceof Error ? err.message : String(err) },
+        isError: true
+      };
+    }
+    const durationMs = Date.now() - t0;
+    timelineEvents.push({
+      type: "tool_result",
+      toolName: r.toolName,
+      toolUseId: newToolUseId,
+      result: outcome.data,
+      isError: outcome.isError,
+      durationMs
+    });
+    if (outcome.isError) {
+      return {
+        success: false,
+        reason: "engine_error",
+        message: `Re-execution of ${r.toolName} failed`
+      };
+    }
+    newReads.push({
+      toolUseId: newToolUseId,
+      toolName: r.toolName,
+      input: r.input,
+      result: outcome.data,
+      isError: false,
+      timestamp: t0
+    });
+  }
+  const synthAssistantBlocks = newReads.map((r) => ({
+    type: "tool_use",
+    id: r.toolUseId,
+    name: r.toolName,
+    input: r.input
+  }));
+  const synthUserBlocks = newReads.map((r) => ({
+    type: "tool_result",
+    toolUseId: r.toolUseId,
+    content: typeof r.result === "string" ? r.result : JSON.stringify(r.result),
+    isError: r.isError
+  }));
+  const synthMessages = [
+    { role: "assistant", content: synthAssistantBlocks },
+    { role: "user", content: synthUserBlocks }
+  ];
+  engine.loadMessages([...messages, ...synthMessages]);
+  const pendingWrites = action.steps.map((step) => ({
+    id: step.toolUseId,
+    name: step.toolName,
+    input: step.input
+  }));
+  const readResults = newReads.map((r) => ({
+    toolUseId: r.toolUseId,
+    toolName: r.toolName,
+    timestamp: r.timestamp
+  }));
+  const assistantContent = action.assistantContent ?? [];
+  const completedResults = action.completedResults ?? [];
+  let newPendingAction;
+  try {
+    newPendingAction = composeBundleFromToolResults({
+      pendingWrites,
+      tools,
+      readResults,
+      assistantContent,
+      completedResults,
+      turnIndex: action.turnIndex
+    });
+  } catch (err) {
+    return {
+      success: false,
+      reason: "engine_error",
+      message: err instanceof Error ? err.message : "Bundle rebuild failed"
+    };
+  }
+  return { success: true, newPendingAction, timelineEvents };
+}
 
 // src/streaming.ts
 function serializeSSE(event) {
@@ -8216,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;
@@ -8223,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}"`;
       }
@@ -9123,6 +9296,6 @@ function sanitizeAnthropicMessages(messages) {
   return merged;
 }
 
-export { AnthropicProvider, BalanceTracker, CANVAS_TEMPLATES, ContextBudget, CostTracker, DEFAULT_GUARD_CONFIG, DEFAULT_LEASE_SEC, DEFAULT_PERMISSION_CONFIG, DEFAULT_POLL_BUDGET_MS, DEFAULT_POLL_INTERVAL_MS, DEFAULT_SYSTEM_PROMPT, DEFAULT_TOOL_TTL_MS, EFFORT_THINKING_BUDGET_CAPS, EarlyToolDispatcher, InMemoryDefiCacheStore, InMemoryFetchLock, InMemoryNaviCacheStore, InMemoryWalletCacheStore, InvalidAddressError, McpClientManager, McpResponseCache, MemorySessionStore, NAVI_ADDR_TTL_SEC, NAVI_MCP_CONFIG, NAVI_MCP_URL, NAVI_RATES_TTL_SEC, NAVI_SERVER_NAME, NaviTools, PERMISSION_PRESETS, QueryEngine, READ_TOOLS, REGENERATABLE_READ_TOOLS, RecipeRegistry, RetryTracker, SUINS_NAME_REGEX, SUI_ADDRESS_REGEX, SUI_ADDRESS_STRICT_REGEX, SuinsNotRegisteredError, SuinsRpcError, TOOL_FLAGS, TOOL_MODIFIABLE_FIELDS, TOOL_TTL_MS, TxMutex, WRITE_TOOLS, _resetNaviCircuitBreaker, activitySummaryTool, adaptAllMcpTools, adaptAllServerTools, adaptMcpTool, applyToolFlags, awaitOrFetch, balanceCheckTool, borrowTool, budgetToolResult, buildCachedSystemPrompt, buildMcpTools, buildProactivenessInstructions, buildProfileContext, buildSelfEvaluationInstruction, buildStateContext, buildTool, bundleShortestTtl, claimRewardsTool, clampThinkingForEffort, classifyEffort, clearPortfolioCache, clearPortfolioCacheFor, clearPriceMapCache, compactMessages, createGuardRunnerState, engineToSSE, estimateTokens, explainTxTool, extractConversationText, extractMcpText, fetchAddressDefiPortfolio, fetchAddressPortfolio, fetchAudricHistory, fetchAudricPortfolio, fetchAvailableRewards, fetchBalance, fetchHealthFactor, fetchPositions, fetchProtocolStats, fetchRates, fetchSavings, fetchTokenPrices, fetchWalletCoins, findTool, getAudricApiBase, getDefaultTools, getDefiCacheStore, getFetchLock, getMcpManager, getModifiableFields, getNaviCacheStore, getTelemetrySink, getToolFlags, getWalletAddress, getWalletCacheStore, guardArtifactPreview, guardStaleData, harnessShapeForEffort, hasNaviMcp, healthCheckTool, isBundleableTool, loadRecipes, looksLikeSuiNs, microcompact, mppServicesTool, naviKey, normalizeAddressInput, parseEvalSummary, parseMcpJson, parseRecipe, parseSSE, payApiTool, portfolioAnalysisTool, protocolDeepDiveTool, ratesInfoTool, registerEngineTools, renderCanvasTool, repayDebtTool, requireAgent, resetDefiCacheStore, resetFetchLock, resetNaviCacheStore, resetTelemetrySink, resetWalletCacheStore, resolveAddressToSuinsViaRpc, resolvePermissionTier, resolveSuinsTool, resolveSuinsViaRpc, resolveUsdValue, runGuards, runTools, saveContactTool, saveDepositTool, savingsInfoTool, sendTransferTool, serializeSSE, setDefiCacheStore, setFetchLock, setNaviCacheStore, setTelemetrySink, setWalletCacheStore, spendingAnalyticsTool, swapExecuteTool, swapQuoteTool, tokenPricesTool, toolNameToOperation, toolsToDefinitions, transactionHistoryTool, transformBalance, transformHealthFactor, transformPositions, transformRates, transformRewards, transformSavings, updateGuardStateAfterToolResult, updateTodoTool, validateHistory, voloStakeTool, voloStatsTool, voloUnstakeTool, webSearchTool, withdrawTool, yieldSummaryTool };
+export { AnthropicProvider, BalanceTracker, CANVAS_TEMPLATES, ContextBudget, CostTracker, DEFAULT_GUARD_CONFIG, DEFAULT_LEASE_SEC, DEFAULT_PERMISSION_CONFIG, DEFAULT_POLL_BUDGET_MS, DEFAULT_POLL_INTERVAL_MS, DEFAULT_SYSTEM_PROMPT, DEFAULT_TOOL_TTL_MS, EFFORT_THINKING_BUDGET_CAPS, EarlyToolDispatcher, InMemoryDefiCacheStore, InMemoryFetchLock, InMemoryNaviCacheStore, InMemoryWalletCacheStore, InvalidAddressError, McpClientManager, McpResponseCache, MemorySessionStore, NAVI_ADDR_TTL_SEC, NAVI_MCP_CONFIG, NAVI_MCP_URL, NAVI_RATES_TTL_SEC, NAVI_SERVER_NAME, NaviTools, PERMISSION_PRESETS, QueryEngine, READ_TOOLS, REGENERATABLE_READ_TOOLS, RecipeRegistry, RetryTracker, SUINS_NAME_REGEX, SUI_ADDRESS_REGEX, SUI_ADDRESS_STRICT_REGEX, SuinsNotRegisteredError, SuinsRpcError, TOOL_FLAGS, TOOL_MODIFIABLE_FIELDS, TOOL_TTL_MS, TxMutex, WRITE_TOOLS, _resetNaviCircuitBreaker, activitySummaryTool, adaptAllMcpTools, adaptAllServerTools, adaptMcpTool, applyToolFlags, awaitOrFetch, balanceCheckTool, borrowTool, budgetToolResult, buildCachedSystemPrompt, buildMcpTools, buildProactivenessInstructions, buildProfileContext, buildSelfEvaluationInstruction, buildStateContext, buildTool, bundleShortestTtl, claimRewardsTool, clampThinkingForEffort, classifyEffort, clearPortfolioCache, clearPortfolioCacheFor, clearPriceMapCache, compactMessages, createGuardRunnerState, engineToSSE, estimateTokens, explainTxTool, extractConversationText, extractMcpText, fetchAddressDefiPortfolio, fetchAddressPortfolio, fetchAudricHistory, fetchAudricPortfolio, fetchAvailableRewards, fetchBalance, fetchHealthFactor, fetchPositions, fetchProtocolStats, fetchRates, fetchSavings, fetchTokenPrices, fetchWalletCoins, findTool, getAudricApiBase, getDefaultTools, getDefiCacheStore, getFetchLock, getMcpManager, getModifiableFields, getNaviCacheStore, getTelemetrySink, getToolFlags, getWalletAddress, getWalletCacheStore, guardArtifactPreview, guardStaleData, harnessShapeForEffort, hasNaviMcp, healthCheckTool, isBundleableTool, loadRecipes, looksLikeSuiNs, microcompact, mppServicesTool, naviKey, normalizeAddressInput, parseEvalSummary, parseMcpJson, parseRecipe, parseSSE, payApiTool, portfolioAnalysisTool, protocolDeepDiveTool, ratesInfoTool, regenerateBundle, registerEngineTools, renderCanvasTool, repayDebtTool, requireAgent, resetDefiCacheStore, resetFetchLock, resetNaviCacheStore, resetTelemetrySink, resetWalletCacheStore, resolveAddressToSuinsViaRpc, resolvePermissionTier, resolveSuinsTool, resolveSuinsViaRpc, resolveUsdValue, runGuards, runTools, saveContactTool, saveDepositTool, savingsInfoTool, sendTransferTool, serializeSSE, setDefiCacheStore, setFetchLock, setNaviCacheStore, setTelemetrySink, setWalletCacheStore, spendingAnalyticsTool, swapExecuteTool, swapQuoteTool, tokenPricesTool, toolNameToOperation, toolsToDefinitions, transactionHistoryTool, transformBalance, transformHealthFactor, transformPositions, transformRates, transformRewards, transformSavings, updateGuardStateAfterToolResult, updateTodoTool, validateHistory, voloStakeTool, voloStatsTool, voloUnstakeTool, webSearchTool, withdrawTool, yieldSummaryTool };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map