@fluxa-pay/planner 0.2.4 → 0.2.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fluxa-pay/planner",
-  "version": "0.2.4",
+  "version": "0.2.5",
   "description": "FluxA Planner CLI. Recommend the right models, APIs and skills for a task, and manage your oneshot APIs.",
   "type": "module",
   "bin": {
@@ -10,7 +10,8 @@
     "node": ">=20"
   },
   "files": [
-    "planner.mjs"
+    "planner.mjs",
+    "plan-format.mjs"
   ],
   "publishConfig": {
     "access": "public"

package/plan-format.mjs

@@ -0,0 +1,49 @@
+// Pure formatting of a `planner plan` result into terminal lines. No I/O and no
+// color of its own — the caller passes a helpers bag (h) so planner.mjs injects
+// ANSI while tests pass identity helpers and assert on plain text.
+//
+// When the plan carries capability `groups`, each capability prints its options
+// (the recommended one first, tagged) so the agent sees the alternatives. Older
+// / template plans without groups fall back to the flat `tools` list.
+export function planLines(plan, h) {
+  const lines = [];
+  const heading = h.unesc(plan.reason || plan.task || "Recommended");
+  lines.push("");
+  lines.push("  " + h.bold("Recommended") + "  " + h.dim(heading));
+
+  const groups = Array.isArray(plan.groups) ? plan.groups : null;
+  let total = 0;
+
+  if (groups && groups.length) {
+    for (const g of groups) {
+      lines.push("  " + h.dim(h.unesc(g.capability || "")));
+      const lead = g.options.find((o) => o.recommended) || g.options[0];
+      const ordered = lead ? [lead, ...g.options.filter((o) => o !== lead)] : g.options;
+      if (lead) total += lead.units || 0;
+      for (const o of ordered) {
+        const k = h.kind(o.kind);
+        const tag = o === lead ? "  " + h.lime("recommended") : "";
+        lines.push(
+          `    ${k}  ${h.bold(h.pad(o.slug, 34))} ${h.dim(h.pad(h.unesc(o.detail || ""), 24))} ${h.lime("~" + (o.units || 0).toLocaleString() + " Units")}${tag}`,
+        );
+      }
+    }
+  } else {
+    for (const t of plan.tools || []) {
+      total += t.units || 0;
+      const k = h.kind(t.kind);
+      lines.push(
+        `    ${k}  ${h.bold(h.pad(t.slug, 36))} ${h.dim(h.pad(h.unesc(t.detail || ""), 30))} ${h.lime("~" + (t.units || 0).toLocaleString() + " Units")}`,
+      );
+    }
+  }
+
+  lines.push(h.gray("    " + "─".repeat(78)));
+  lines.push(`    ${h.bold("est")} ${h.lime("~" + total.toLocaleString() + " Units")} ${h.dim("(~" + h.usd(total) + ")")}`);
+  if (plan.instructions) {
+    lines.push("");
+    lines.push("  " + h.dim(h.unesc(plan.instructions)));
+  }
+  lines.push(h.dim("\n  → Run these yourself. Paid endpoints answer HTTP 402; settle with fluxa-wallet (planner info pay)."));
+  return { lines, total };
+}

package/planner.mjs

@@ -26,6 +26,7 @@ import { promisify } from "node:util";
 import { homedir } from "node:os";
 import { join } from "node:path";
 import { stdout, argv, env, exit } from "node:process";
+import { planLines } from "./plan-format.mjs";
 
 const pexec = promisify(execFile);
 
@@ -519,19 +520,12 @@ function printAnswer(a) {
 
 // Render a PlanOrAnswer plan: tools carry kind/slug/name/units/detail.
 function printPlan(plan) {
-  const tools = plan.tools || [];
-  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(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(unesc(plan.instructions)));
-  console.log(c.dim("\n  → call these tools directly — FluxA settles each paid call from your wallet. No keys, no subs."));
+  const { lines, total } = planLines(plan, {
+    bold: c.bold, dim: c.dim, lime: c.lime, gray: c.gray,
+    kind: (k) => KIND[k] || pad(k, 5),
+    pad, usd, unesc,
+  });
+  for (const l of lines) console.log(l);
   return total;
 }