agentmall 0.1.11 → 0.1.13

package/dist/cli.js

@@ -264,6 +264,125 @@ var AgentMallRefunds = class {
   }
 };
 
+// src/cli/ui.ts
+var c = {
+  reset: "\x1B[0m",
+  bold: "\x1B[1m",
+  dim: "\x1B[2m",
+  italic: "\x1B[3m",
+  strike: "\x1B[9m",
+  red: "\x1B[31m",
+  green: "\x1B[32m",
+  yellow: "\x1B[33m",
+  blue: "\x1B[34m",
+  magenta: "\x1B[35m",
+  cyan: "\x1B[36m",
+  gray: "\x1B[90m"
+};
+var RULE_WIDTH = 48;
+function banner() {
+  console.log();
+  console.log(
+    `  ${c.bold}\u25CE agentmall${c.reset}  ${c.dim}\u2014 buy anything with a URL${c.reset}`
+  );
+}
+function section(title) {
+  const pad = Math.max(2, RULE_WIDTH - title.length - 2);
+  console.log();
+  console.log(
+    `  ${c.dim}\u2500\u2500\u2500${c.reset} ${c.bold}${title}${c.reset} ${c.dim}${"\u2500".repeat(pad)}${c.reset}`
+  );
+}
+function kv(key, value, opts) {
+  const k = `${c.gray}${key.padEnd(16)}${c.reset}`;
+  const color = opts?.color ?? "";
+  const reset = color ? c.reset : "";
+  const v = opts?.dim ? `${c.dim}${value}${c.reset}` : `${color}${value}${reset}`;
+  console.log(`  ${k} ${v}`);
+}
+function line(text) {
+  console.log(`  ${text}`);
+}
+function gap() {
+  console.log();
+}
+function muted(text) {
+  console.log(`  ${c.dim}${text}${c.reset}`);
+}
+function hint(text) {
+  console.log(`  ${c.dim}${text}${c.reset}`);
+}
+var STATUS_COLORS = {
+  payment_received: c.yellow,
+  submitted: c.blue,
+  pending: c.blue,
+  confirmed: c.green,
+  shipped: c.cyan,
+  delivered: c.green,
+  completed: c.green,
+  failed: c.red,
+  cancelled: c.red,
+  approved: c.yellow,
+  processing: c.blue,
+  processed: c.green,
+  in_stock: c.green,
+  out_of_stock: c.red,
+  low_stock: c.yellow
+};
+function statusBadge(status2) {
+  const color = STATUS_COLORS[status2] ?? c.gray;
+  return `${color}\u25CF${c.reset} ${status2}`;
+}
+var FRAMES = ["\u280B", "\u2819", "\u2839", "\u2838", "\u283C", "\u2834", "\u2826", "\u2827", "\u2807", "\u280F"];
+async function spin(label, task) {
+  let frame = 0;
+  const render = (char, color, text) => {
+    process.stdout.write(`\r  ${color}${char}${c.reset} ${text}\x1B[K`);
+  };
+  render(FRAMES[0], c.dim, `${c.dim}${label}${c.reset}`);
+  const interval = setInterval(() => {
+    frame = (frame + 1) % FRAMES.length;
+    render(FRAMES[frame], c.dim, `${c.dim}${label}${c.reset}`);
+  }, 80);
+  try {
+    const result = await task();
+    clearInterval(interval);
+    render("\u2714", c.green, label);
+    process.stdout.write("\n");
+    return result;
+  } catch (error) {
+    clearInterval(interval);
+    render("\u2716", c.red, label);
+    process.stdout.write("\n");
+    throw error;
+  }
+}
+function stripAnsi(s) {
+  return s.replace(/\x1b\[[0-9;]*m/g, "");
+}
+function box(lines) {
+  const maxLen = Math.max(
+    ...lines.map((l) => stripAnsi(l).length),
+    38
+  );
+  const w = maxLen + 2;
+  console.log(`  ${c.dim}\u256D${"\u2500".repeat(w)}\u256E${c.reset}`);
+  for (const l of lines) {
+    const visible = stripAnsi(l).length;
+    const pad = maxLen - visible;
+    console.log(
+      `  ${c.dim}\u2502${c.reset} ${l}${" ".repeat(Math.max(0, pad))} ${c.dim}\u2502${c.reset}`
+    );
+  }
+  console.log(`  ${c.dim}\u2570${"\u2500".repeat(w)}\u256F${c.reset}`);
+}
+function errorMsg(label, message) {
+  console.log();
+  console.log(`  ${c.red}\u2716 ${label}${c.reset}`);
+  console.log(`  ${message}`);
+  console.log();
+}
+
 // src/cli/display.ts
 var FAILURE_MESSAGES = {
   budget_exceeded: "Actual total exceeded your maximum budget.",
@@ -303,26 +422,27 @@ function calculateMinimumBudget(product, quantity = 1, variantUnitPriceCents) {
   return unitPriceCents * Math.max(1, quantity);
 }
 function displayProduct(product) {
-  console.log();
-  console.log("  \x1B[1m\u{1F4E6} Product\x1B[0m");
-  console.log(`  \x1B[1m${product.title}\x1B[0m`);
-  console.log(`  ${product.retailer} \u2014 ${product.availability}`);
-  console.log();
+  section("Product");
+  line(`${c.bold}${product.title}${c.reset}`);
+  line(`${c.dim}${product.retailer} \xB7 ${statusBadge(product.availability)}${c.reset}`);
+  gap();
   if (product.listPrice && product.discountPercent) {
-    console.log(
-      `  Price: \x1B[32m${formatCents(product.price)}\x1B[0m  \x1B[2m\x1B[9m${formatCents(product.listPrice)}\x1B[0m  \x1B[33m-${product.discountPercent}%\x1B[0m`
+    kv(
+      "Price",
+      `${c.green}${formatCents(product.price)}${c.reset}  ${c.dim}${c.strike}${formatCents(product.listPrice)}${c.reset}  ${c.yellow}-${product.discountPercent}%${c.reset}`
     );
   } else {
-    console.log(`  Price: \x1B[32m${formatCents(product.price)}\x1B[0m`);
+    kv("Price", formatCents(product.price), { color: c.green });
   }
   if (product.variants?.length) {
-    console.log();
+    gap();
     for (const v of product.variants) {
-      const label = v.label ? `${v.label}: ` : "";
-      console.log(`  ${label}\x1B[1m${v.value}\x1B[0m \u2014 $${v.price.toFixed(2)}`);
+      const label = v.label ? `${c.dim}${v.label}:${c.reset} ` : "";
+      line(
+        `${label}${c.bold}${v.value}${c.reset} ${c.dim}\u2014 $${v.price.toFixed(2)}${c.reset}`
+      );
     }
   }
-  console.log();
 }
 function displayCheckoutEstimate(product, quantity = 1, variantSelections, variantUnitPriceCents) {
   const quantityClamped = Math.max(1, quantity);
@@ -335,126 +455,131 @@ function displayCheckoutEstimate(product, quantity = 1, variantSelections, varia
   const linePrice = unitPriceCents * quantityClamped;
   const listBaseUnitPrice = typeof product.listPrice === "number" ? Math.max(product.listPrice, variantUnitPriceCents ?? 0) : void 0;
   const lineListPrice = typeof listBaseUnitPrice === "number" ? listBaseUnitPrice * quantityClamped : void 0;
-  console.log();
-  console.log("  \x1B[1m\u{1F4B8} Checkout Estimate\x1B[0m");
+  section("Checkout Estimate");
   if (lineListPrice && product.discountPercent) {
-    console.log(
-      `  Price: \x1B[32m${formatCents(linePrice)}\x1B[0m  \x1B[2m\x1B[9m${formatCents(lineListPrice)}\x1B[0m  \x1B[33m-${product.discountPercent}%\x1B[0m`
+    kv(
+      "Price",
+      `${c.green}${formatCents(linePrice)}${c.reset}  ${c.dim}${c.strike}${formatCents(lineListPrice)}${c.reset}  ${c.yellow}-${product.discountPercent}%${c.reset}`
     );
   } else {
-    console.log(`  Price: \x1B[32m${formatCents(linePrice)}\x1B[0m`);
+    kv("Price", formatCents(linePrice), { color: c.green });
   }
-  console.log(`  Quantity: ${quantityClamped}`);
+  kv("Quantity", `${quantityClamped}`);
   if (quantityClamped > 1) {
-    console.log(`  Unit price: ${formatCents(unitPriceCents)}`);
+    kv("Unit price", formatCents(unitPriceCents), { dim: true });
   }
   if (variantSelections?.length) {
     for (const variant of variantSelections) {
-      console.log(`  ${variant.label}: ${variant.value}`);
+      kv(variant.label, variant.value);
     }
   }
-  console.log(
-    `  Suggested budget: \x1B[1m${formatCents(suggestedBudget)}\x1B[0m (includes a 15% tax/price buffer plus an $8 minimum shipping buffer)`
+  kv("Budget", `${c.bold}${formatCents(suggestedBudget)}${c.reset} ${c.dim}(suggested)${c.reset}`);
+  kv("Fee", formatCents(SERVICE_FEE_CENTS), { dim: true });
+  kv(
+    "Total",
+    `${c.bold}${formatCents(suggestedBudget + SERVICE_FEE_CENTS)}${c.reset} USDC`
   );
-  console.log(
-    `  Service fee: ${formatCents(SERVICE_FEE_CENTS)}`
-  );
-  console.log(
-    `  Total charge: \x1B[1m${formatCents(suggestedBudget + SERVICE_FEE_CENTS)}\x1B[0m USDC`
-  );
-  console.log(
-    `  Any unused amount from your max budget is refunded automatically after checkout.`
-  );
-  console.log(
-    `  The buffer covers unforeseen tax, shipping, and retailer price changes at final checkout.`
+  gap();
+  hint(
+    "Budget includes a 15% tax/price buffer plus an $8 shipping buffer."
   );
+  hint("Unused amount is refunded automatically after checkout.");
   if (product.cached) {
-    console.log(`  \x1B[33m\u26A0 Price from cache \u2014 may not reflect current listing\x1B[0m`);
+    gap();
+    line(
+      `${c.yellow}\u26A0${c.reset}  ${c.yellow}Price from cache \u2014 may not reflect current listing${c.reset}`
+    );
   }
-  console.log();
 }
 function displayOrderSummary(body) {
-  console.log();
-  console.log("  \x1B[1m\u{1F9FE} Order Summary\x1B[0m");
+  section("Order Summary");
   for (const item of body.items) {
-    const url = item.product_url;
     const qty = item.quantity ?? 1;
-    console.log(`  ${qty}x ${url}`);
+    line(`${c.dim}${qty}x${c.reset} ${item.product_url}`);
     if (item.variant?.length) {
       for (const v of item.variant) {
-        console.log(`     ${v.label}: ${v.value}`);
+        line(`   ${c.dim}${v.label}:${c.reset} ${v.value}`);
       }
     }
   }
+  section("Shipping");
   const addr = body.delivery_address;
-  console.log();
-  console.log("  \x1B[1m\u{1F4CD} Shipping\x1B[0m");
-  console.log(`  Ship to: ${addr.first_name} ${addr.last_name}`);
-  console.log(`  ${addr.address_line1}${addr.address_line2 ? `, ${addr.address_line2}` : ""}`);
-  console.log(`  ${addr.city}, ${addr.state ?? ""} ${addr.postal_code} ${addr.country}`);
-  console.log();
-  console.log(`  Max budget: \x1B[1m${formatCents(body.max_budget)}\x1B[0m + ${formatCents(SERVICE_FEE_CENTS)} fee`);
-  console.log();
+  line(`${addr.first_name} ${addr.last_name}`);
+  line(
+    `${addr.address_line1}${addr.address_line2 ? `, ${addr.address_line2}` : ""}`
+  );
+  line(
+    `${addr.city}, ${addr.state ?? ""} ${addr.postal_code} ${addr.country}`
+  );
 }
 function displayOrderResult(order) {
-  console.log();
+  gap();
+  const lines = [];
   if (order.status === "failed") {
-    console.log(`  \x1B[31m\u274C Order failed during submission.\x1B[0m`);
+    lines.push(`${c.red}\u2716  Order failed during submission${c.reset}`);
   } else if (order.deduplicated) {
-    console.log(`  \x1B[33m\u267B\uFE0F  Reused existing order.\x1B[0m`);
+    lines.push(`${c.yellow}\u267B  Reused existing order${c.reset}`);
   } else {
-    console.log(`  \x1B[32m\u2705 Order placed!\x1B[0m`);
+    lines.push(`${c.green}\u2714  Order placed${c.reset}`);
   }
-  console.log(`  ID: \x1B[1m${order.id}\x1B[0m`);
-  console.log(`  Status: ${order.status}`);
+  lines.push("");
+  lines.push(`${c.gray}ID${c.reset}        ${c.bold}${order.id}${c.reset}`);
+  lines.push(`${c.gray}Status${c.reset}    ${statusBadge(order.status)}`);
   if (order.buyerToken) {
-    console.log("  \u{1F510} Saved local access token for status and refund checks.");
+    lines.push("");
+    lines.push(`${c.dim}\u{1F510} Saved buyer token for status checks${c.reset}`);
   }
-  console.log();
-  console.log(
-    order.status === "failed" ? "  Check status for failure details and refund progress:" : "  Check status in 5-10 minutes:"
+  lines.push("");
+  lines.push(
+    order.status === "failed" ? `${c.dim}Check failure details and refund progress:${c.reset}` : `${c.dim}Check status in 5-10 minutes:${c.reset}`
   );
-  console.log(`  npx agentmall status ${order.id}`);
-  console.log();
+  lines.push(`${c.cyan}npx agentmall status ${order.id}${c.reset}`);
+  box(lines);
+  gap();
 }
 function displayStatus(purchase) {
-  console.log();
-  console.log(`  \x1B[1m\u{1F4E6} Order ${purchase.id}\x1B[0m`);
-  console.log(`  Status: ${purchase.status}`);
+  section(`Order ${purchase.id}`);
+  kv("Status", statusBadge(purchase.status));
   if (purchase.items?.length) {
+    gap();
     for (const item of purchase.items) {
-      const price = item.price ? ` \u2014 ${formatCents(item.price)}` : "";
-      console.log(`  ${item.quantity}x ${item.title ?? item.productRef}${price}`);
+      const price = item.price ? ` ${c.dim}\u2014 ${formatCents(item.price)}${c.reset}` : "";
+      line(
+        `${c.dim}${item.quantity}x${c.reset} ${item.title ?? item.productRef}${price}`
+      );
     }
   }
+  gap();
   if (purchase.finalTotal) {
-    console.log(`  Final total: ${formatCents(purchase.finalTotal)}`);
+    kv("Final total", formatCents(purchase.finalTotal));
   }
   if (purchase.failureReason) {
-    console.log(
-      `  \x1B[31mFailure: ${FAILURE_MESSAGES[purchase.failureReason] ?? purchase.failureReason}\x1B[0m`
+    kv(
+      "Failure",
+      `${c.red}${FAILURE_MESSAGES[purchase.failureReason] ?? purchase.failureReason}${c.reset}`
     );
   }
   if (purchase.deliveryMethod) {
-    console.log(`  Shipping: ${purchase.deliveryMethod}`);
+    kv("Shipping", purchase.deliveryMethod);
   }
-  console.log(`  Created: ${new Date(purchase.createdAt).toLocaleString()}`);
-  console.log();
+  kv("Created", new Date(purchase.createdAt).toLocaleString(), { dim: true });
+  gap();
 }
 function displayRefund(refund2) {
-  console.log();
-  console.log(`  \x1B[1m\u{1F4B8} Refund ${refund2.id}\x1B[0m`);
-  console.log(`  Status: ${refund2.status}`);
-  console.log(`  Amount: ${formatCents(refund2.amountCents)}`);
-  console.log(`  Reason: ${refund2.reason}`);
+  section(`Refund ${refund2.id}`);
+  kv("Status", statusBadge(refund2.status));
+  kv("Amount", formatCents(refund2.amountCents), { color: c.green });
+  kv("Reason", refund2.reason);
   if (refund2.txHash) {
-    console.log(`  TX: ${refund2.txHash}`);
+    kv("TX", refund2.txHash, { dim: true });
   }
-  console.log(`  Created: ${new Date(refund2.createdAt).toLocaleString()}`);
+  kv("Created", new Date(refund2.createdAt).toLocaleString(), { dim: true });
   if (refund2.processedAt) {
-    console.log(`  Processed: ${new Date(refund2.processedAt).toLocaleString()}`);
+    kv("Processed", new Date(refund2.processedAt).toLocaleString(), {
+      dim: true
+    });
   }
-  console.log();
+  gap();
 }
 
 // src/cli/prompts.ts
@@ -675,7 +800,11 @@ async function runInteractiveCommand(command2, args2) {
 }
 async function readTempoWhoami() {
   try {
-    const result = await runCommandCapture("tempo", ["wallet", "-j", "whoami"]);
+    const result = await runCommandCapture("tempo", [
+      "wallet",
+      "-j",
+      "whoami"
+    ]);
     if (result.code !== 0) return null;
     return JSON.parse(result.stdout);
   } catch {
@@ -688,17 +817,18 @@ async function ensureTempoInstalled() {
     if (result.code === 0) return;
   } catch {
   }
-  console.error("\x1B[31mTempo CLI is required for purchases.\x1B[0m");
-  console.error("");
-  console.error("Install it first:");
-  console.error("  curl -fsSL https://tempo.xyz/install | bash");
+  errorMsg(
+    "Tempo CLI required",
+    `Install it first:
+  ${c.cyan}curl -fsSL https://tempo.xyz/install | bash${c.reset}`
+  );
   process.exit(1);
 }
 async function ensureTempoReady() {
   await ensureTempoInstalled();
   const whoami = await readTempoWhoami();
   if (whoami?.ready) return whoami;
-  console.log("  Tempo wallet login required...");
+  muted("Tempo wallet login required...");
   const loginCode = await runInteractiveCommand("tempo", ["wallet", "login"]);
   if (loginCode !== 0) {
     throw new Error("Tempo wallet login failed");
@@ -726,12 +856,14 @@ async function ensureSufficientBalance(requiredCents, wallet) {
   if (available >= required) {
     return wallet;
   }
-  console.log();
-  console.log("  \x1B[1m\u{1F4B3} Balance Check\x1B[0m");
-  console.log(
-    `  Tempo wallet balance is too low for this order: have ${formatUsdcNumber(available)} USDC, need ${formatUsdAmount(requiredCents)} USDC.`
+  section("Balance Check");
+  line(
+    `Wallet balance too low: have ${c.bold}${formatUsdcNumber(available)} USDC${c.reset}, need ${c.bold}${formatUsdAmount(requiredCents)} USDC${c.reset}`
   );
-  console.log(`  Shortfall: ${formatUsdcNumber(required - available)} USDC`);
+  kv("Shortfall", `${formatUsdcNumber(required - available)} USDC`, {
+    color: c.yellow
+  });
+  gap();
   const fundNow = await promptConfirm("Open Tempo funding flow now?");
   if (!fundNow) {
     throw new Error(
@@ -746,13 +878,13 @@ async function ensureSufficientBalance(requiredCents, wallet) {
     const refreshed = await ensureTempoReady();
     available = parseTempoBalance(refreshed.balance?.available);
     if (available >= required) {
-      console.log(
-        `  Funding complete. New balance: ${formatUsdcNumber(available)} ${refreshed.balance?.symbol ?? "USDC"}`
+      line(
+        `${c.green}\u2714${c.reset} Funding complete \u2014 ${c.bold}${formatUsdcNumber(available)} ${refreshed.balance?.symbol ?? "USDC"}${c.reset}`
       );
       return refreshed;
     }
     if (attempt < 5) {
-      console.log("  Waiting for updated wallet balance...");
+      muted("Waiting for updated wallet balance...");
       await sleep(3e3);
     }
   }
@@ -792,25 +924,28 @@ async function createPurchaseWithTempo(body) {
   try {
     return JSON.parse(result.stdout);
   } catch {
-    throw new Error(`Unexpected response from Tempo request: ${result.stdout.trim() || "(empty)"}`);
+    throw new Error(
+      `Unexpected response from Tempo request: ${result.stdout.trim() || "(empty)"}`
+    );
   }
 }
 async function buy(urlArg) {
   try {
-    console.log();
-    console.log("  \x1B[1m\u{1F6D2} agentmall\x1B[0m \u2014 Buy anything with a URL");
-    console.log();
+    banner();
+    gap();
     const url = urlArg ?? await promptProductUrl();
     const client = new AgentMall();
-    console.log("  Looking up product...");
-    const product = await client.products.lookup(url);
+    const product = await spin(
+      "Looking up product",
+      () => client.products.lookup(url)
+    );
     displayProduct(product);
     const quantity = await promptQuantity();
     const selectedVariants = product.variants?.length ? await promptVariants(product.variants) : void 0;
-    const variantSelections = selectedVariants?.map((variant) => variant.selection);
-    const selectedVariantUnitPriceCents = getSelectedVariantUnitPriceCents(
-      selectedVariants
+    const variantSelections = selectedVariants?.map(
+      (variant) => variant.selection
     );
+    const selectedVariantUnitPriceCents = getSelectedVariantUnitPriceCents(selectedVariants);
     const suggestedMaxBudget = calculateSuggestedBudget(
       product,
       quantity,
@@ -827,6 +962,7 @@ async function buy(urlArg) {
       variantSelections,
       selectedVariantUnitPriceCents
     );
+    gap();
     const address = await promptAddress();
     const maxBudget = await promptBudget(suggestedMaxBudget, minimumBudget);
     const { input: input2 } = await import("@inquirer/prompts");
@@ -835,64 +971,82 @@ async function buy(urlArg) {
       validate: (value) => EMAIL_PATTERN.test(value.trim()) ? true : "A valid email is required"
     });
     const body = {
-      items: [{
-        product_url: url,
-        quantity,
-        ...variantSelections?.length ? { variant: variantSelections } : {}
-      }],
+      items: [
+        {
+          product_url: url,
+          quantity,
+          ...variantSelections?.length ? { variant: variantSelections } : {}
+        }
+      ],
       delivery_address: address,
       max_budget: maxBudget,
       buyer_email: buyerEmail
     };
     displayOrderSummary(body);
-    console.log(`  Total charge: \x1B[1m${formatCents(maxBudget + SERVICE_FEE_CENTS)}\x1B[0m USDC on Tempo`);
-    console.log("  Any unused amount from your max budget is refunded automatically after checkout.");
-    console.log("  The buffer covers unforeseen tax, shipping, and retailer price changes at final checkout.");
-    console.log();
+    gap();
+    kv("Budget cap", `${c.bold}${formatCents(maxBudget)}${c.reset}`);
+    kv("Fee", formatCents(SERVICE_FEE_CENTS), { dim: true });
+    kv(
+      "Total charge",
+      `${c.bold}${formatCents(maxBudget + SERVICE_FEE_CENTS)}${c.reset} USDC on Tempo`
+    );
+    gap();
+    muted(
+      "Unused budget is refunded automatically after checkout."
+    );
+    muted(
+      "The buffer covers unforeseen tax, shipping, and retailer price changes."
+    );
+    gap();
     const proceed = await promptConfirm("Place order?");
     if (!proceed) {
-      console.log("  Cancelled.");
+      muted("Cancelled.");
       return;
     }
     const totalChargeCents = maxBudget + SERVICE_FEE_CENTS;
-    const wallet = await ensureSufficientBalance(
-      totalChargeCents,
-      await ensureTempoReady()
-    );
+    const wallet = await spin("Connecting wallet", () => ensureTempoReady());
+    await ensureSufficientBalance(totalChargeCents, wallet);
     if (wallet.wallet) {
-      const balance = wallet.balance?.available ? `, balance ${wallet.balance.available} ${wallet.balance?.symbol ?? "USDC"}` : "";
-      console.log(`  Paying with Tempo wallet ${wallet.wallet}${balance}`);
+      const addr = wallet.wallet;
+      const short = `${addr.slice(0, 6)}\u2026${addr.slice(-4)}`;
+      const bal = wallet.balance?.available ? ` \xB7 ${wallet.balance.available} ${wallet.balance?.symbol ?? "USDC"}` : "";
+      muted(`Wallet ${short}${bal}`);
     }
-    console.log("  Placing order...");
-    const order = await createPurchaseWithTempo(body);
+    const order = await spin(
+      "Placing order",
+      () => createPurchaseWithTempo(body)
+    );
     if (order.buyerToken) {
       await saveBuyerToken(order.id, order.buyerToken);
     }
     displayOrderResult(order);
   } catch (error) {
-    console.log();
+    gap();
     if (error instanceof ValidationError) {
-      console.error(`  \x1B[31mValidation error:\x1B[0m ${error.message}`);
+      errorMsg("Validation error", error.message);
       process.exitCode = 1;
       return;
     }
     if (error instanceof ConflictError) {
-      console.error(`  \x1B[31mConflict:\x1B[0m ${error.message}`);
+      errorMsg("Conflict", error.message);
       process.exitCode = 1;
       return;
     }
     if (error instanceof RateLimitError) {
-      console.error(`  \x1B[31mRate limited:\x1B[0m retry in about ${Math.ceil(error.retryAfterMs / 1e3)}s`);
+      errorMsg(
+        "Rate limited",
+        `Retry in about ${Math.ceil(error.retryAfterMs / 1e3)}s`
+      );
       process.exitCode = 1;
       return;
     }
     if (error instanceof AgentMallError) {
-      console.error(`  \x1B[31mRequest failed:\x1B[0m ${error.message}`);
+      errorMsg("Request failed", error.message);
       process.exitCode = 1;
       return;
     }
     if (error instanceof Error) {
-      console.error(`  \x1B[31mError:\x1B[0m ${error.message}`);
+      errorMsg("Error", error.message);
       process.exitCode = 1;
       return;
     }
@@ -900,51 +1054,79 @@ async function buy(urlArg) {
   }
 }
 async function status(purchaseId) {
+  banner();
   const apiSecret = process.env.AGENTMALL_API_SECRET;
   const buyerToken = apiSecret ? null : await getBuyerToken(purchaseId);
   const client = apiSecret ? new AgentMall({ apiSecret }) : new AgentMall();
   if (!apiSecret && !buyerToken) {
-    throw new Error("No saved buyer token found for this order on this machine.");
+    throw new Error(
+      "No saved buyer token found for this order on this machine."
+    );
   }
-  const result = await client.purchases.get(
-    purchaseId,
-    buyerToken ? { buyerToken } : void 0
+  const result = await spin(
+    "Fetching order",
+    () => client.purchases.get(purchaseId, buyerToken ? { buyerToken } : void 0)
   );
   displayStatus(result);
 }
 async function refund(purchaseId) {
+  banner();
   const apiSecret = process.env.AGENTMALL_API_SECRET;
   const buyerToken = apiSecret ? null : await getBuyerToken(purchaseId);
   const client = apiSecret ? new AgentMall({ apiSecret }) : new AgentMall();
   if (!apiSecret && !buyerToken) {
-    throw new Error("No saved buyer token found for this order on this machine.");
+    throw new Error(
+      "No saved buyer token found for this order on this machine."
+    );
   }
-  const result = await client.refunds.getByPurchase(
-    purchaseId,
-    buyerToken ? { buyerToken } : void 0
+  const result = await spin(
+    "Fetching refund",
+    () => client.refunds.getByPurchase(
+      purchaseId,
+      buyerToken ? { buyerToken } : void 0
+    )
   );
   displayRefund(result);
 }
 async function onboard() {
-  console.log();
-  console.log("  \x1B[1m\u{1F511} agentmall onboarding\x1B[0m");
-  console.log();
-  const wallet = await ensureTempoReady();
-  console.log();
+  banner();
+  gap();
+  const wallet = await spin(
+    "Checking Tempo wallet",
+    () => ensureTempoReady()
+  );
+  section("Wallet");
   if (wallet.wallet) {
-    console.log(`  Wallet ready: ${wallet.wallet}`);
+    kv("Address", wallet.wallet);
   }
   if (wallet.balance?.available) {
-    console.log(`  Available balance: ${wallet.balance.available} ${wallet.balance?.symbol ?? "USDC"}`);
+    kv(
+      "Balance",
+      `${wallet.balance.available} ${wallet.balance?.symbol ?? "USDC"}`,
+      { color: c.green }
+    );
   }
-  console.log("  Next steps:");
-  console.log("  1. Run \x1B[1mtempo wallet whoami\x1B[0m to review your wallet");
-  console.log("  2. Add funds to your Tempo wallet if needed");
-  console.log("  3. Retry your purchase with \x1B[1mnpx agentmall buy <url>\x1B[0m");
-  console.log();
+  section("Next Steps");
+  line(
+    `${c.dim}1.${c.reset} Run ${c.bold}tempo wallet whoami${c.reset} to review your wallet`
+  );
+  line(
+    `${c.dim}2.${c.reset} Add funds to your Tempo wallet if needed`
+  );
+  line(
+    `${c.dim}3.${c.reset} Buy something: ${c.bold}npx agentmall buy <url>${c.reset}`
+  );
+  gap();
 }
 
 // src/cli.ts
+var c2 = {
+  reset: "\x1B[0m",
+  bold: "\x1B[1m",
+  dim: "\x1B[2m",
+  cyan: "\x1B[36m",
+  gray: "\x1B[90m"
+};
 var args = process.argv.slice(2);
 var command = args[0];
 async function main() {
@@ -983,7 +1165,7 @@ async function main() {
   } catch (err) {
     if (err instanceof Error) {
       console.error(`
-  \x1B[31mError: ${err.message}\x1B[0m
+  ${c2.dim}\u2716${c2.reset} ${err.message}
 `);
     } else {
       console.error(err);
@@ -992,16 +1174,42 @@ async function main() {
   }
 }
 function printHelp() {
-  console.log(`
-  \x1B[1m\u{1F6D2} agentmall\x1B[0m \u2014 Buy anything with a URL
-
-  Usage:
-    \u{1F511} agentmall onboard         Log in to Tempo and show wallet funding steps
-    \u{1F6CD}\uFE0F  agentmall [url]          Buy a product (interactive)
-    \u{1F6CD}\uFE0F  agentmall buy <url>      Buy a product
-    \u{1F4E6} agentmall status <id>     Check order status using the saved buyer token
-    \u{1F4B8} agentmall refund <id>     Check refund status using the saved buyer token
-    \u2753 agentmall help            Show this help
-`);
+  const W = 48;
+  const rule = (title) => {
+    const pad = Math.max(2, W - title.length - 2);
+    return `${c2.dim}\u2500\u2500\u2500${c2.reset} ${c2.bold}${title}${c2.reset} ${c2.dim}${"\u2500".repeat(pad)}${c2.reset}`;
+  };
+  console.log();
+  console.log(
+    `  ${c2.bold}\u25CE agentmall${c2.reset}  ${c2.dim}\u2014 buy anything with a URL${c2.reset}`
+  );
+  console.log();
+  console.log(`  ${rule("Commands")}`);
+  console.log(
+    `  ${c2.cyan}agentmall${c2.reset} [url]          ${c2.dim}Interactive purchase${c2.reset}`
+  );
+  console.log(
+    `  ${c2.cyan}agentmall buy${c2.reset} <url>      ${c2.dim}Buy a product${c2.reset}`
+  );
+  console.log(
+    `  ${c2.cyan}agentmall status${c2.reset} <id>    ${c2.dim}Check order status${c2.reset}`
+  );
+  console.log(
+    `  ${c2.cyan}agentmall refund${c2.reset} <id>    ${c2.dim}Check refund status${c2.reset}`
+  );
+  console.log(
+    `  ${c2.cyan}agentmall onboard${c2.reset}        ${c2.dim}Set up Tempo wallet${c2.reset}`
+  );
+  console.log(
+    `  ${c2.cyan}agentmall help${c2.reset}           ${c2.dim}Show this help${c2.reset}`
+  );
+  console.log();
+  console.log(`  ${rule("Examples")}`);
+  console.log(
+    `  ${c2.dim}$${c2.reset} npx agentmall https://amazon.com/dp/B0DWTMJHCG`
+  );
+  console.log(`  ${c2.dim}$${c2.reset} npx agentmall status pur_abc123`);
+  console.log(`  ${c2.dim}$${c2.reset} npx agentmall refund pur_abc123`);
+  console.log();
 }
 main();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentmall",
-  "version": "0.1.11",
+  "version": "0.1.13",
   "description": "SDK and CLI for the AgentMall API — let AI agents buy physical products from US retailers",
   "type": "module",
   "main": "./dist/index.js",