@fluxa-pay/planner 0.2.1 → 0.2.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fluxa-pay/planner",
-  "version": "0.2.1",
+  "version": "0.2.3",
   "description": "FluxA Planner CLI. Recommend the right models, APIs and skills for a task, run paid calls via x402, and manage your oneshot APIs.",
   "type": "module",
   "bin": {

package/planner.mjs

@@ -47,6 +47,12 @@ const KIND = { model: c.cyan("model"), api: c.lime("api  "), skill: c.green("ski
 const pad = (s, n) => { s = String(s); return s.length > n ? s.slice(0, n - 1) + "…" : s.padEnd(n); };
 const usd = (units) => { const v = (units || 0) * UNIT_USD; return v < 0.01 ? `$${v.toFixed(4)}` : `$${v.toFixed(2)}`; };
 const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+// The planner brain occasionally HTML-escapes angle brackets in free text
+// (e.g. "&lt;merchant&gt;"); un-escape the common entities for terminal output.
+// &amp; is undone LAST so "&amp;lt;" doesn't collapse into "<".
+const unesc = (s) => typeof s === "string"
+  ? s.replace(/&lt;/g, "<").replace(/&gt;/g, ">").replace(/&quot;/g, '"').replace(/&#3?9;/g, "'").replace(/&amp;/g, "&")
+  : s;
 
 // --- config / auth ----------------------------------------------------------
 function loadConfig() {
@@ -181,6 +187,18 @@ async function cmdModels(vendor) {
   }
 }
 
+async function cmdVendors() {
+  const { data } = await http(`${PLATFORM}/api/llm/vendors`);
+  const vendors = data.vendors || [];
+  if (!vendors.length) return console.log(c.dim("  no vendors"));
+  console.log("  " + c.dim(pad("slug", 22) + pad("name", 22) + pad("models", 9) + pad("bundles", 9) + "price (Units/Mtok)"));
+  for (const v of vendors) {
+    const pr = v.priceRange;
+    const price = pr && Number.isFinite(pr.min) ? (pr.min === pr.max ? `${pr.min}` : `${pr.min}-${pr.max}`) : c.dim("—");
+    console.log(`  ${c.bold(pad(v.slug, 22))}${c.gray(pad(v.name || "", 22))}${pad(String(v.modelCount ?? 0), 9)}${pad(String(v.bundleCount ?? 0), 9)}${price}`);
+  }
+}
+
 async function cmdBalance(vendor) {
   const url = vendor ? `${PROXY}/llm/wallet/balances/${vendor}` : `${PROXY}/llm/wallet/balances`;
   const { data } = await http(url, { auth: true });
@@ -617,14 +635,14 @@ async function cmdPlan(task) {
 }
 
 function printAnswer(a) {
-  console.log("\n  " + c.bold(a.answer));
+  console.log("\n  " + c.bold(unesc(a.answer)));
   if (a.command) {
     console.log("\n  " + c.dim("run:"));
-    console.log("    " + c.cyan(a.command));
+    console.log("    " + c.cyan(unesc(a.command)));
   }
   if (a.prompt) {
     console.log("\n  " + c.dim("copy this prompt for your agent:"));
-    for (const line of a.prompt.split("\n")) console.log("    " + line);
+    for (const line of unesc(a.prompt).split("\n")) console.log("    " + line);
   }
   console.log("");
 }
@@ -632,17 +650,17 @@ function printAnswer(a) {
 // Render a PlanOrAnswer plan: tools carry kind/slug/name/units/detail.
 function printPlan(plan) {
   const tools = plan.tools || [];
-  const heading = plan.reason || plan.task || "Recommended";
+  const heading = unesc(plan.reason || plan.task || "Recommended");
   console.log("\n  " + c.bold("Recommended") + "  " + c.dim(heading));
   let total = 0;
   for (const t of tools) {
     const k = KIND[t.kind] || pad(t.kind, 5);
     total += t.units || 0;
-    console.log(`    ${k}  ${c.bold(pad(t.slug, 36))} ${c.dim(pad(t.detail || "", 30))} ${c.lime("~" + (t.units || 0).toLocaleString() + " Units")}`);
+    console.log(`    ${k}  ${c.bold(pad(t.slug, 36))} ${c.dim(pad(unesc(t.detail || ""), 30))} ${c.lime("~" + (t.units || 0).toLocaleString() + " Units")}`);
   }
   console.log(c.gray("    " + "─".repeat(78)));
   console.log(`    ${c.bold("est")} ${c.lime("~" + total.toLocaleString() + " Units")} ${c.dim("(~" + usd(total) + ")")}`);
-  if (plan.instructions) console.log("\n  " + c.dim(plan.instructions));
+  if (plan.instructions) console.log("\n  " + c.dim(unesc(plan.instructions)));
   console.log(c.dim("\n  → call these tools directly — FluxA settles each paid call from your wallet. No keys, no subs."));
   return total;
 }
@@ -770,6 +788,7 @@ ${c.bold("Headline")}
 ${c.bold("Primitives")}  ${c.dim("(all live)")}
   planner search "<q>" [--type api,skill,model]   discover resources
   planner models [--vendor <slug>]                 model catalog + Units rates
+  planner vendors                                  list fundable merchants (slug, models, price)
   planner balance [vendor]                         prepaid Units per merchant
   planner topup <vendor> [--credits <N>|--bundle <slug>]   prepay Units (x402, via wallet)
   planner ledger <vendor>                          spend/topup history
@@ -838,6 +857,7 @@ async function main() {
       });
     case "search": return cmdSearch(arg, type);
     case "models": return cmdModels(vendor);
+    case "vendors": return cmdVendors();
     case "balance": case "bal": return cmdBalance(rest[0]);
     case "topup":
       return cmdTopup(rest[0], {