@vultisig/cli 3.1.0 → 4.0.1

package/CHANGELOG.md

@@ -1,5 +1,38 @@
 # @vultisig/cli
 
+## 4.0.1
+
+### Patch Changes
+
+- [#1561](https://github.com/vultisig/vultisig-sdk/pull/1561) [`38be8ef`](https://github.com/vultisig/vultisig-sdk/commit/38be8eff97b061d241c7ac1c1616b48115fbb974) Thanks [@NeOMakinG](https://github.com/NeOMakinG)! - Render `yield_opportunities` and `polymarket_markets` agent surfaces as prose instead of leaking raw `{"surface":...}` JSON into the terminal. The CLI only advertised `balance_summary`/`turn_outcome` in `supported_surfaces`, so any other surface fell back to the backend's legacy verbatim-echo path. Adds parsers, prose renderers, and a legacy-echo fallback for both surfaces, mirroring the existing `balance_summary` handling, and wires them through the TUI, pipe mode, and `agent ask`.
+
+- Updated dependencies [[`3767033`](https://github.com/vultisig/vultisig-sdk/commit/3767033f51804f3fff5088098c767280577bd4a4), [`68df301`](https://github.com/vultisig/vultisig-sdk/commit/68df301134b8000187a11cf92b9427e8200d4623)]:
+  - @vultisig/sdk@4.0.1
+
+## 4.0.0
+
+### Minor Changes
+
+- [#1608](https://github.com/vultisig/vultisig-sdk/pull/1608) [`791d344`](https://github.com/vultisig/vultisig-sdk/commit/791d344c2dacc289c9fb7fbcbc38488aeeb47542) Thanks [@neavra](https://github.com/neavra)! - Fix tracked token balance fetching and make token removal report the truth.
+
+  A token added with `tokens --add` is stored under an id of the form `<Chain>-<address>`. That id was passed to the RPC as if it were a contract address; the RPC rejected it, the throw was swallowed per-chain, and the **whole chain's balances disappeared** — native asset included — leaving only a `console.warn`. Balance lookups now resolve a stored token reference to its real contract address / chain-level asset id before both the per-coin and batched calls. What is written to the vault file is unchanged, and balance result keys still use the stored id.
+
+  **Behavior change — `tokens --remove` now fails when nothing was removed.** Removal previously matched on an exact id comparison, so removing by symbol (or by contract address for a token added under the prefixed id form) matched nothing while the command still printed `Removed token …` and exited 0. Removal now goes through the shared token resolver, and a reference that matches no tracked token raises the existing not-found error and exits **5** (`RESOURCE_NOT_FOUND`) instead of exiting 0. A script that removed an untracked token and relied on a zero exit will now see a failure. Removal by symbol and by contract address, which previously silently no-op'd, now work.
+
+  **Behavior change — the agent `vault_coin remove` tool reports per-coin outcomes.** It previously returned `removed: true` unconditionally; it now returns the SDK's actual result, so the model is told when a coin was not tracked. Batch removals return `{ chain, tokenId, removed }` per coin rather than `{ chain, tokenId }`.
+
+  **Breaking SDK API change — `VaultBase.removeToken` now returns `Promise<boolean>` instead of `Promise<void>`.** It resolves to `true` when a tracked token was removed and persisted, and `false` when the reference matched nothing. Consumers with callbacks, interfaces, or overrides typed to the previous `Promise<void>` signature must update those types.
+
+### Patch Changes
+
+- [#1642](https://github.com/vultisig/vultisig-sdk/pull/1642) [`ac5becb`](https://github.com/vultisig/vultisig-sdk/commit/ac5becb7939bc8c6b45d04cd00067e0d2caf6297) Thanks [@neavra](https://github.com/neavra)! - Show the user-visible memo and XRP destination tag from the signable transaction payload in both send dry-run and pre-signing confirmation previews, with terminal-safe dry-run rendering.
+
+- Updated dependencies [[`b9f81af`](https://github.com/vultisig/vultisig-sdk/commit/b9f81af9065a5c0bfc2f86f8fb20aa51e670ab77), [`c0e260f`](https://github.com/vultisig/vultisig-sdk/commit/c0e260f89d159d14b170384864b24b101b23dfb0), [`2ef8f3f`](https://github.com/vultisig/vultisig-sdk/commit/2ef8f3f42f5d44673568b39a91c42bd0fe410311), [`791d344`](https://github.com/vultisig/vultisig-sdk/commit/791d344c2dacc289c9fb7fbcbc38488aeeb47542)]:
+  - @vultisig/core-chain@2.31.0
+  - @vultisig/sdk@4.0.0
+  - @vultisig/client-shared@0.3.2
+  - @vultisig/rujira@59.0.0
+
 ## 3.1.0
 
 ### Patch Changes

package/dist/index.js

@@ -5828,6 +5828,12 @@ import { fiatCurrencies, fiatCurrencyNameRecord as fiatCurrencyNameRecord2 } fro
 // src/ui.ts
 import { fiatCurrencyNameRecord, fromChainAmountExact, Vultisig } from "@vultisig/sdk";
 import chalk2 from "chalk";
+var escapeTerminalControls = (value) => Array.from(value, (character) => {
+  if (character === "\\") return "\\\\";
+  const codePoint = character.codePointAt(0) ?? 0;
+  const isTerminalControl = codePoint <= 31 || codePoint === 127 || codePoint >= 128 && codePoint <= 159;
+  return isTerminalControl ? `\\x${codePoint.toString(16).padStart(2, "0").toUpperCase()}` : character;
+}).join("");
 function displayBalance(chain, balance, _raw = false) {
   printResult(chalk2.cyan(`
 ${chain} Balance:`));
@@ -5933,7 +5939,7 @@ Estimated gas: ${JSON.stringify(gas, bigIntReplacer2, 2)}`));
   printResult(`  Amount: ${amount} ${symbol}`);
   printResult(`  Chain:  ${chain}`);
   if (memo) {
-    printResult(`  Memo:   ${memo}`);
+    printResult(`  Memo:   ${escapeTerminalControls(memo)}`);
   }
   if (destinationTag !== void 0) {
     printResult(`  Destination tag: ${destinationTag}`);
@@ -6244,7 +6250,8 @@ var EthereumL2Chain = {
   Blast: "Blast",
   Optimism: "Optimism",
   Zksync: "Zksync",
-  Mantle: "Mantle"
+  Mantle: "Mantle",
+  Robinhood: "Robinhood"
 };
 var EvmChain = {
   ...EthereumL2Chain,
@@ -6323,6 +6330,7 @@ var chainKindRecord = {
   [EvmChain.Mantle]: "evm",
   [EvmChain.Hyperliquid]: "evm",
   [EvmChain.Sei]: "evm",
+  [EvmChain.Robinhood]: "evm",
   [UtxoChain.Bitcoin]: "utxo",
   [UtxoChain.BitcoinCash]: "utxo",
   [UtxoChain.Litecoin]: "utxo",
@@ -7296,7 +7304,10 @@ async function addToken(ctx2, options) {
 }
 async function removeToken(ctx2, chain, tokenId) {
   const vault = await ctx2.ensureActiveVault();
-  await vault.removeToken(chain, tokenId);
+  const removed = await vault.removeToken(chain, tokenId);
+  if (!removed) {
+    throw new TokenNotFoundError(`Token "${tokenId}" not found on ${chain}`);
+  }
   success(`
 + Removed token ${tokenId} from ${chain}`);
 }
@@ -7411,8 +7422,57 @@ var normalizeRippleDestination = (address) => {
   return { address: value };
 };
 
+// ../../packages/core/mpc/dist/keysign/error.js
+var BuildKeysignPayloadError = class extends Error {
+  type;
+  constructor(type, message = type) {
+    super(message);
+    this.type = type;
+    this.name = "BuildKeysignPayloadError";
+  }
+};
+
+// ../../packages/core/mpc/dist/keysign/utils/rippleDestinationTag.js
+var maxRippleDestinationTag = 4294967295;
+var getLegacyDestinationTag = (memo) => {
+  if (!memo || !/^(0|[1-9]\d*)$/.test(memo))
+    return void 0;
+  const destinationTag = Number(memo);
+  return destinationTag <= maxRippleDestinationTag ? destinationTag : void 0;
+};
+var validateDestinationTag = (destinationTag) => {
+  if (!Number.isInteger(destinationTag) || destinationTag < 0 || destinationTag > maxRippleDestinationTag) {
+    throw new BuildKeysignPayloadError("ripple-destination-tag-invalid", `Invalid XRP destination tag: expected an integer between 0 and ${maxRippleDestinationTag}`);
+  }
+  return destinationTag;
+};
+var resolveDestinationTag = ({ destinationTag, memo }) => {
+  if (destinationTag !== void 0)
+    return validateDestinationTag(destinationTag);
+  return getLegacyDestinationTag(memo);
+};
+
 // src/commands/transaction.ts
 import { Chain as Chain4, Vultisig as Vultisig2 } from "@vultisig/sdk";
+var getSendPreviewDetails = (chain, keysignPayload) => {
+  let memo = keysignPayload.memo || void 0;
+  if (chain !== Chain4.Ripple) {
+    return { memo, destinationTag: void 0 };
+  }
+  const rippleSpecific = keysignPayload.blockchainSpecific;
+  if (rippleSpecific.case !== "rippleSpecific") {
+    throw new Error("Ripple send payload is missing Ripple-specific data");
+  }
+  const destinationTag = resolveDestinationTag({
+    destinationTag: rippleSpecific.value.destinationTag,
+    memo
+  });
+  const legacyMemoDestinationTag = getLegacyDestinationTag(memo);
+  if (legacyMemoDestinationTag !== void 0 && legacyMemoDestinationTag === destinationTag) {
+    memo = void 0;
+  }
+  return { memo, destinationTag };
+};
 async function executeSend(ctx2, params) {
   const vault = await ctx2.ensureActiveVault();
   if (!Object.values(Chain4).includes(params.chain)) {
@@ -7424,9 +7484,13 @@ async function executeSend(ctx2, params) {
   }
   return sendTransaction(vault, params);
 }
-async function previewDryRun(vault, params, dryResult, to, destinationTag) {
+async function previewDryRun(vault, params, dryResult, to) {
   const balance = await vault.balance(params.chain, params.tokenId);
   const hasInsufficientBalance = parseFloat(dryResult.total) > parseFloat(balance.formattedAmount);
+  const { memo: previewMemo, destinationTag: payloadDestinationTag } = getSendPreviewDetails(
+    params.chain,
+    dryResult.keysignPayload
+  );
   const isTokenSend = balance.tokenId !== void 0;
   const feeBalance = isTokenSend ? await vault.balance(params.chain).catch(() => void 0) : void 0;
   const warnings = [];
@@ -7450,7 +7514,8 @@ async function previewDryRun(vault, params, dryResult, to, destinationTag) {
     feeSymbol: dryResult.feeSymbol,
     total: dryResult.total,
     balance: balance.formattedAmount,
-    destinationTag,
+    destinationTag: payloadDestinationTag,
+    ...previewMemo ? { memo: previewMemo } : {},
     ...warnings.length > 0 ? { warning: warnings.join(". ") } : {}
   };
   if (isJsonOutput()) {
@@ -7463,6 +7528,7 @@ Dry-run preview:`);
   info(`  To:      ${result.to}`);
   info(`  Amount:  ${result.amount} ${result.symbol}`);
   if (result.destinationTag !== void 0) info(`  Destination tag: ${result.destinationTag}`);
+  if (result.memo) info(`  Memo:    ${escapeTerminalControls(result.memo)}`);
   info(`  Fee:     ${result.fee} ${result.feeSymbol}`);
   info(`  Total:   ${result.total} ${result.symbol}`);
   info(`  Balance: ${result.balance} ${result.symbol}`);
@@ -7497,7 +7563,7 @@ async function sendTransaction(vault, params) {
   prepareSpinner.succeed("Transaction prepared");
   if (!dryResult.dryRun) throw new Error("unreachable");
   if (params.dryRun) {
-    return previewDryRun(vault, params, dryResult, to, destinationTag);
+    return previewDryRun(vault, params, dryResult, to);
   }
   let gas;
   try {
@@ -7508,14 +7574,15 @@ async function sendTransaction(vault, params) {
   const balance = await vault.balance(params.chain, params.tokenId);
   if (!isJsonOutput()) {
     const address = await vault.address(params.chain);
+    const preview = getSendPreviewDetails(params.chain, dryResult.keysignPayload);
     displayTransactionPreview(
       address,
       to,
       dryResult.total,
       balance.symbol,
       params.chain,
-      params.memo,
-      destinationTag,
+      preview.memo,
+      preview.destinationTag,
       gas
     );
   }
@@ -10062,6 +10129,8 @@ var AskInterface = class {
   toolCalls = [];
   transactions = [];
   cards = [];
+  yieldCards = [];
+  polymarketCards = [];
   warnings = [];
   outcome;
   error;
@@ -10114,6 +10183,12 @@ var AskInterface = class {
       onBalanceSummary: (card) => {
         this.cards.push(card);
       },
+      onYieldOpportunities: (card) => {
+        this.yieldCards.push(card);
+      },
+      onPolymarketMarkets: (card) => {
+        this.polymarketCards.push(card);
+      },
       onTurnOutcome: (outcome) => {
         this.outcome = outcome;
       },
@@ -10172,6 +10247,8 @@ var AskInterface = class {
     this.toolCalls = [];
     this.transactions = [];
     this.cards = [];
+    this.yieldCards = [];
+    this.polymarketCards = [];
     this.warnings = [];
     this.outcome = void 0;
     this.error = void 0;
@@ -10195,6 +10272,8 @@ var AskInterface = class {
       toolCalls: this.toolCalls,
       transactions: this.transactions,
       cards: this.cards,
+      yieldCards: this.yieldCards,
+      polymarketCards: this.polymarketCards,
       warnings: this.warnings,
       error: this.error,
       ...this.outcome ? { outcome: this.outcome } : {}
@@ -10259,7 +10338,12 @@ async function authenticateVault(client, vault, password, maxAttempts = 3) {
 
 // src/agent/cards.ts
 import chalk8 from "chalk";
-var CLI_SUPPORTED_SURFACES = ["balance_summary", "turn_outcome"];
+var CLI_SUPPORTED_SURFACES = [
+  "balance_summary",
+  "turn_outcome",
+  "yield_opportunities",
+  "polymarket_markets"
+];
 function parseTurnOutcome(raw) {
   if (!raw || typeof raw !== "object") return null;
   const kind = raw.kind;
@@ -10407,6 +10491,142 @@ function renderBalanceSummaryCard(card) {
   }
   return lines.join("\n");
 }
+function parseYieldOpportunity(v) {
+  if (!v || typeof v !== "object") return null;
+  const o = v;
+  const id = asString(o.id);
+  const symbol = asString(o.token) || asString(o.symbol);
+  const chain = asString(o.network) || asString(o.chain);
+  if (!symbol) return null;
+  const opportunity = { id, chain, symbol };
+  const apy = o.apy;
+  if (typeof apy === "number" && Number.isFinite(apy)) {
+    opportunity.apy = `${apy.toFixed(2)}%`;
+  } else if (typeof apy === "string" && apy) {
+    opportunity.apy = stripControlChars(apy);
+  }
+  const provider = asString(o.provider);
+  if (provider) opportunity.provider = provider;
+  const type = asString(o.type);
+  if (type) opportunity.type = type;
+  return opportunity;
+}
+function parseYieldOpportunitiesEnvelope(value) {
+  if (!value || typeof value !== "object") return null;
+  const o = value;
+  if (o.surface !== "yield_opportunities") return null;
+  const raw = Array.isArray(o.opportunities) ? o.opportunities : Array.isArray(o.data) ? o.data : [];
+  const opportunities = raw.map(parseYieldOpportunity).filter((y) => y !== null);
+  if (opportunities.length === 0) return null;
+  const card = { surface: "yield_opportunities", opportunities };
+  const title = asString(o.title);
+  if (title) card.title = title;
+  return card;
+}
+function renderYieldOpportunitiesCard(card) {
+  const lines = [chalk8.bold(`  ${card.title || "Yield opportunities"}`)];
+  for (const opp of card.opportunities) {
+    const label = opp.symbol || opp.id || "opportunity";
+    const apyCol = opp.apy ? chalk8.green(`  ${opp.apy} APY`) : "";
+    const chainCol = opp.chain ? chalk8.gray(`  (${opp.chain})`) : "";
+    const providerCol = opp.provider ? chalk8.gray(`  via ${opp.provider}`) : "";
+    lines.push(`    ${chalk8.bold(label)}${apyCol}${chainCol}${providerCol}`);
+  }
+  return lines.join("\n");
+}
+function extractYieldOpportunitiesFromText(content) {
+  return extractSurfaceFromText(content, "yield_opportunities", parseYieldOpportunitiesEnvelope);
+}
+function formatProbability(v) {
+  if (typeof v !== "number" || !Number.isFinite(v)) return void 0;
+  if (v <= 0 || v >= 1) return void 0;
+  return `${Math.round(v * 100)}%`;
+}
+function buildPolymarketOutcomes(o) {
+  const yesPrice = formatProbability(o.yesPrice);
+  const noPrice = formatProbability(o.noPrice);
+  const topOutcome = asString(o.topOutcome);
+  if (topOutcome) {
+    const outcome = { name: topOutcome };
+    if (yesPrice) outcome.price = yesPrice;
+    return [outcome];
+  }
+  const outcomes = [];
+  if (yesPrice) outcomes.push({ name: "YES", price: yesPrice });
+  if (noPrice) outcomes.push({ name: "NO", price: noPrice });
+  return outcomes;
+}
+function parsePolymarketMarket(v) {
+  if (!v || typeof v !== "object") return null;
+  const o = v;
+  const question = asString(o.question) || asString(o.title);
+  if (!question) return null;
+  const id = asString(o.id) || asString(o.slug);
+  const outcomes = buildPolymarketOutcomes(o);
+  const market = { id, question, outcomes };
+  const volume24h = o.volume24h;
+  if (typeof volume24h === "number" && Number.isFinite(volume24h)) {
+    market.volume = formatUsd(volume24h);
+  } else if (typeof volume24h === "string" && volume24h) {
+    market.volume = stripControlChars(volume24h);
+  }
+  const endDate = asString(o.endDate) || asString(o.end_date);
+  if (endDate) market.endDate = endDate;
+  return market;
+}
+function parsePolymarketMarketsEnvelope(value) {
+  if (!value || typeof value !== "object") return null;
+  const o = value;
+  if (o.surface !== "polymarket_markets") return null;
+  const raw = Array.isArray(o.markets) ? o.markets : Array.isArray(o.data) ? o.data : [];
+  const markets = raw.map(parsePolymarketMarket).filter((m) => m !== null);
+  if (markets.length === 0) return null;
+  const card = { surface: "polymarket_markets", markets };
+  const title = asString(o.title);
+  if (title) card.title = title;
+  const subtitle = asString(o.subtitle);
+  if (subtitle) card.subtitle = subtitle;
+  return card;
+}
+function renderPolymarketMarketsCard(card) {
+  const lines = [chalk8.bold(`  ${card.title || "Polymarket markets"}`)];
+  if (card.subtitle) lines.push(chalk8.gray(`  ${card.subtitle}`));
+  for (const market of card.markets) {
+    const metaBits = [market.volume ? `${market.volume} vol` : "", market.endDate ? `ends ${market.endDate}` : ""].filter(Boolean).join(", ");
+    lines.push(`    ${chalk8.bold(market.question)}${metaBits ? chalk8.gray(`  (${metaBits})`) : ""}`);
+    for (const outcome of market.outcomes) {
+      const priceCol = outcome.price ? chalk8.gray(`  ${outcome.price}`) : "";
+      lines.push(`      ${outcome.name}${priceCol}`);
+    }
+  }
+  return lines.join("\n");
+}
+function extractPolymarketMarketsFromText(content) {
+  return extractSurfaceFromText(content, "polymarket_markets", parsePolymarketMarketsEnvelope);
+}
+function extractSurfaceFromText(content, surfaceKey, parser) {
+  if (!content || !content.includes(surfaceKey)) return null;
+  if (content.length > 2e5) return null;
+  for (let i = content.indexOf("{"); i !== -1; i = content.indexOf("{", i + 1)) {
+    const end = matchBrace(content, i);
+    if (end === -1) break;
+    const blob = content.slice(i, end + 1);
+    if (!blob.includes(surfaceKey)) continue;
+    let parsed;
+    try {
+      parsed = JSON.parse(blob);
+    } catch {
+      continue;
+    }
+    const card = parser(parsed);
+    if (!card) continue;
+    const before = content.slice(0, i).replace(/```(?:json)?\s*$/i, "");
+    const after = content.slice(end + 1).replace(/^\s*```/, "");
+    const remainingText = (before + after).trim();
+    return { card, remainingText };
+  }
+  return null;
+}
 
 // src/agent/client.ts
 import { randomUUID } from "node:crypto";
@@ -11028,8 +11248,8 @@ var AgentExecutor = class {
             `vault_coin remove: missing contract_address for ${t.ticker || t.symbol || "coin"} on ${t.chain}`
           );
         }
-        await this.vault.removeToken(chain2, tokenId2);
-        results.push({ chain: chain2.toString(), tokenId: tokenId2 });
+        const removed2 = await this.vault.removeToken(chain2, tokenId2);
+        results.push({ chain: chain2.toString(), tokenId: tokenId2, removed: removed2 });
       }
       return { removed: results };
     }
@@ -11040,8 +11260,8 @@ var AgentExecutor = class {
     if (!tokenId) {
       throw new Error(`vault_coin remove: missing contract_address for coin on ${chainName}`);
     }
-    await this.vault.removeToken(chain, tokenId);
-    return { chain: chain.toString(), removed: true };
+    const removed = await this.vault.removeToken(chain, tokenId);
+    return { chain: chain.toString(), removed };
   }
   async removeChain(_toolCallId, input) {
     return this.runTool("remove_chain", () => this.removeChainImpl(input));
@@ -12766,6 +12986,16 @@ var AgentClient = class {
           callbacks.onBalanceSummary?.(card);
           break;
         }
+        case "yield_opportunities": {
+          const card = v1Data ?? parsed.data ?? parsed;
+          callbacks.onYieldOpportunities?.(card);
+          break;
+        }
+        case "polymarket_markets": {
+          const card = v1Data ?? parsed.data ?? parsed;
+          callbacks.onPolymarketMarkets?.(card);
+          break;
+        }
         case "turn_outcome": {
           const outcome = parseTurnOutcome(v1Data ?? parsed.data ?? parsed);
           if (outcome) callbacks.onTurnOutcome?.(outcome);
@@ -12962,6 +13192,10 @@ var AgentClient = class {
         return "suggestions";
       case "data-balance_summary":
         return "balance_summary";
+      case "data-yield_opportunities":
+        return "yield_opportunities";
+      case "data-polymarket_markets":
+        return "polymarket_markets";
       case "data-turn_outcome":
         return "turn_outcome";
       case "data-message":
@@ -13384,6 +13618,12 @@ var PipeInterface = class {
       onBalanceSummary: (card) => {
         this.emit({ type: "balance_summary", card });
       },
+      onYieldOpportunities: (card) => {
+        this.emit({ type: "yield_opportunities", card });
+      },
+      onPolymarketMarkets: (card) => {
+        this.emit({ type: "polymarket_markets", card });
+      },
       onSuggestions: (suggestions) => {
         this.emit({ type: "suggestions", suggestions });
       },
@@ -14000,6 +14240,8 @@ var AgentSession = class {
     }
     let toolOutputCandidate = null;
     let balanceCardRendered = false;
+    let yieldCardRendered = false;
+    let polymarketCardRendered = false;
     const pendingDispatches = [];
     let dispatchChain = Promise.resolve();
     const callbacks = {
@@ -14037,6 +14279,20 @@ var AgentSession = class {
           ui.onBalanceSummary?.(card);
         }
       },
+      onYieldOpportunities: (raw) => {
+        const card = parseYieldOpportunitiesEnvelope(raw);
+        if (card) {
+          yieldCardRendered = true;
+          ui.onYieldOpportunities?.(card);
+        }
+      },
+      onPolymarketMarkets: (raw) => {
+        const card = parsePolymarketMarketsEnvelope(raw);
+        if (card) {
+          polymarketCardRendered = true;
+          ui.onPolymarketMarkets?.(card);
+        }
+      },
       onTurnOutcome: (outcome) => {
         ui.onTurnOutcome?.(outcome);
       },
@@ -14078,6 +14334,8 @@ var AgentSession = class {
     let displayText = stripLeakedToolCallTags(responseText);
     if (displayText) {
       displayText = this.renderEchoedBalanceCard(displayText, balanceCardRendered, ui);
+      displayText = this.renderEchoedYieldOpportunitiesCard(displayText, yieldCardRendered, ui);
+      displayText = this.renderEchoedPolymarketMarketsCard(displayText, polymarketCardRendered, ui);
     }
     if (displayText) {
       ui.onAssistantMessage(displayText);
@@ -14343,6 +14601,32 @@ var AgentSession = class {
     }
     return extracted.remainingText;
   }
+  /**
+   * Legacy-path fallback for echoed yield_opportunities cards (rj3p). Mirrors
+   * {@link renderEchoedBalanceCard} — strips a verbatim-echoed envelope from
+   * the displayed text and renders it, unless the typed SSE part already fired.
+   */
+  renderEchoedYieldOpportunitiesCard(displayText, alreadyRendered, ui) {
+    const extracted = extractYieldOpportunitiesFromText(displayText);
+    if (!extracted) return displayText;
+    if (!alreadyRendered) {
+      ui.onYieldOpportunities?.(extracted.card);
+    }
+    return extracted.remainingText;
+  }
+  /**
+   * Legacy-path fallback for echoed polymarket_markets cards (rj3p). Mirrors
+   * {@link renderEchoedBalanceCard} — strips a verbatim-echoed envelope from
+   * the displayed text and renders it, unless the typed SSE part already fired.
+   */
+  renderEchoedPolymarketMarketsCard(displayText, alreadyRendered, ui) {
+    const extracted = extractPolymarketMarketsFromText(displayText);
+    if (!extracted) return displayText;
+    if (!alreadyRendered) {
+      ui.onPolymarketMarkets?.(extracted.card);
+    }
+    return extracted.remainingText;
+  }
   /**
    * Wrap a per-tool dispatch with the password-prompt gate (for tools in
    * {@link PASSWORD_REQUIRED_TOOLS}) and `ui.onToolCall` /
@@ -14673,6 +14957,22 @@ var ChatTUI = class {
         this.currentStreamText = "";
         console.log(renderBalanceSummaryCard(card));
       },
+      onYieldOpportunities: (card) => {
+        if (this.isStreaming) {
+          process.stdout.write("\n");
+          this.isStreaming = false;
+        }
+        this.currentStreamText = "";
+        console.log(renderYieldOpportunitiesCard(card));
+      },
+      onPolymarketMarkets: (card) => {
+        if (this.isStreaming) {
+          process.stdout.write("\n");
+          this.isStreaming = false;
+        }
+        this.currentStreamText = "";
+        console.log(renderPolymarketMarketsCard(card));
+      },
       onSuggestions: (suggestions) => {
         if (suggestions.length > 0) {
           console.log(chalk9.gray("  Suggestions:"));
@@ -14883,6 +15183,13 @@ function summarizeData(data) {
     return `tx: ${data.tx_hash.slice(0, 12)}...`;
   }
   if (data.added) return "added";
+  if (Array.isArray(data.removed)) {
+    const entries = data.removed;
+    const removed = entries.filter((entry) => entry.removed).length;
+    if (removed === 0) return "not tracked";
+    return removed === entries.length ? "removed" : `removed ${removed}/${entries.length}`;
+  }
+  if (data.removed === false) return "not tracked";
   if (data.removed) return "removed";
   if (data.message) return data.message;
   return "";
@@ -15037,6 +15344,16 @@ function outputAskHuman(result, confirmationRequired, proposed) {
   for (const card of result.cards) {
     process.stdout.write(`
 ${renderBalanceSummaryCard(card)}
+`);
+  }
+  for (const card of result.yieldCards) {
+    process.stdout.write(`
+${renderYieldOpportunitiesCard(card)}
+`);
+  }
+  for (const card of result.polymarketCards) {
+    process.stdout.write(`
+${renderPolymarketMarketsCard(card)}
 `);
   }
   if (result.response) {
@@ -15068,6 +15385,8 @@ function outputAskSuccess(wantsJson, result, conversationId) {
       tool_calls: result.toolCalls,
       transactions: result.transactions,
       ...result.cards.length > 0 ? { cards: result.cards } : {},
+      ...result.yieldCards.length > 0 ? { yield_cards: result.yieldCards } : {},
+      ...result.polymarketCards.length > 0 ? { polymarket_cards: result.polymarketCards } : {},
       ...result.warnings.length > 0 ? { warnings: result.warnings } : {},
       // a2a-02: the typed turn ending (success | blocked | refusal | error) at
       // `data.outcome` — the same relative slot as on the error envelope. Present
@@ -15271,7 +15590,7 @@ var cachedVersion = null;
 function getVersion() {
   if (cachedVersion) return cachedVersion;
   if (true) {
-    cachedVersion = "3.1.0";
+    cachedVersion = "4.0.1";
     return cachedVersion;
   }
   try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vultisig/cli",
-  "version": "3.1.0",
+  "version": "4.0.1",
   "description": "The self-custody MPC wallet CLI for AI coding agents (Claude Code, Cursor, OpenCode). Natural-language agent mode, 36+ chains, DKLS23 threshold signatures. Seedless.",
   "type": "module",
   "bin": {
@@ -73,10 +73,10 @@
     "@cosmjs/stargate": "^0.39.0",
     "@napi-rs/keyring": "^1.3.0",
     "@noble/hashes": "^2.2.0",
-    "@vultisig/client-shared": "^0.3.1",
-    "@vultisig/core-chain": "^2.30.0",
-    "@vultisig/rujira": "^58.0.0",
-    "@vultisig/sdk": "^3.1.0",
+    "@vultisig/client-shared": "^0.3.2",
+    "@vultisig/core-chain": "^2.31.0",
+    "@vultisig/rujira": "^59.0.0",
+    "@vultisig/sdk": "^4.0.1",
     "chalk": "^5.6.2",
     "cli-table3": "^0.6.5",
     "commander": "^15.0.0",
@@ -94,6 +94,7 @@
     "@types/node": "^26.1.1",
     "@types/tabtab": "^3.0.4",
     "@types/ws": "^8.18.1",
+    "@vultisig/core-mpc": "^1.16.0",
     "esbuild": "^0.28.1",
     "ethers": "^6.17.0",
     "node-pty": "^1.1.0",