@vultisig/cli 4.0.0 → 4.0.1

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # @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

package/dist/index.js

@@ -10129,6 +10129,8 @@ var AskInterface = class {
   toolCalls = [];
   transactions = [];
   cards = [];
+  yieldCards = [];
+  polymarketCards = [];
   warnings = [];
   outcome;
   error;
@@ -10181,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;
       },
@@ -10239,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;
@@ -10262,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 } : {}
@@ -10326,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;
@@ -10474,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";
@@ -12833,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);
@@ -13029,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":
@@ -13451,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 });
       },
@@ -14067,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 = {
@@ -14104,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);
       },
@@ -14145,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);
@@ -14410,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` /
@@ -14740,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:"));
@@ -15111,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) {
@@ -15142,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
@@ -15345,7 +15590,7 @@ var cachedVersion = null;
 function getVersion() {
   if (cachedVersion) return cachedVersion;
   if (true) {
-    cachedVersion = "4.0.0";
+    cachedVersion = "4.0.1";
     return cachedVersion;
   }
   try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vultisig/cli",
-  "version": "4.0.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": {
@@ -76,7 +76,7 @@
     "@vultisig/client-shared": "^0.3.2",
     "@vultisig/core-chain": "^2.31.0",
     "@vultisig/rujira": "^59.0.0",
-    "@vultisig/sdk": "^4.0.0",
+    "@vultisig/sdk": "^4.0.1",
     "chalk": "^5.6.2",
     "cli-table3": "^0.6.5",
     "commander": "^15.0.0",