argorant 0.14.0 → 0.14.1

package/README.md

@@ -252,10 +252,12 @@ npx argorant webhooks rm 3 --yes
 ```
 
 `credits buy` shows the quote first and only buys after a yes: at a terminal it asks, anywhere
-else it needs `--yes`. When your workspace saved its card for API and agent purchases and the
-purchase fits the limits you set in Settings, that card is charged right away. Otherwise you get a
-payment link to pay yourself, and the credits are added once the payment goes through.
-`--pay-with link` always gives the link. Bought credits stay valid for 365 days.
+else it needs `--yes`. An agent that runs the CLI for someone passes that person's own words with
+`--confirmation "yes, buy 5,000 credits"`; every purchase records how it was confirmed. When the
+account owner allowed purchases with the saved card in Settings > Billing (up to a monthly limit)
+and the purchase fits, that card is charged right away. Otherwise you get a payment link to pay
+yourself, and the credits are added once the payment goes through. `--pay-with link` always gives
+the link. Bought credits stay valid for 365 days.
 
 `lists rm` and `webhooks rm` work the same way: they ask at a terminal and need `--yes` anywhere
 else. A webhook's signing secret is shown once, when you add it.

package/bin/argorant.js

@@ -3434,8 +3434,9 @@ async function cmdCredits(argv) {
     return console.log(`
 ${bold("argorant credits")} packs                      ${dim("the credit packs and their prices")}
 ${bold("argorant credits")} quote <credits>            ${dim("a price quote for one pack; nothing is bought")}
-${bold("argorant credits")} buy <credits> [--pay-with link] [--yes]
-    ${dim("shows the quote, asks, then charges the saved card (when your workspace allows it) or gives you a payment link")}
+${bold("argorant credits")} buy <credits> [--pay-with link] [--yes] [--confirmation "<the user's yes>"]
+    ${dim("shows the quote, asks, then charges the saved card (when the account owner allowed it, up to a monthly limit) or gives you a payment link")}
+    ${dim("every purchase records its confirmation: your answer at the prompt, or the words passed with --confirmation")}
 ${bold("argorant credits")} purchases [<id>]           ${dim("purchases made with this account")}
 ${dim("1 credit = 1 valid contact; 0.5 credit = 1 email check. Bought credits stay valid for 365 days.")}
 `);
@@ -3452,7 +3453,7 @@ ${dim("1 credit = 1 valid contact; 0.5 credit = 1 email check. Bought credits st
     return;
   }
   if (sub === "quote" || sub === "buy") {
-    const args = readFlags(rest, { "--currency": "currency", "--pay-with": "payWith" });
+    const args = readFlags(rest, { "--currency": "currency", "--pay-with": "payWith", "--confirmation": "confirmation" });
     const credits = parseLimit(String(args._[0] || "").replace(/[,_]/g, "") || "x", "credits");
     const body = { credits };
     if (args.currency) body.currency = String(args.currency).toLowerCase();
@@ -3468,9 +3469,14 @@ ${dim("1 credit = 1 valid contact; 0.5 credit = 1 email check. Bought credits st
     if (!args.json) for (const l of quoteLines(q)) console.log(l);
     const card = q.payment && q.payment.saved_card;
     const how = payWith !== "link" && card && card.usable ? `The saved ${card.card || "card"} is charged now.` : "You get a payment link; nothing is charged before you pay it.";
-    if (!(await confirmOrDie(args, `Buy ${credits.toLocaleString()} credits for ${fmtPrice(q.price_cents !== undefined || q.amount_cents !== undefined ? q : q.pack || q, q.currency)}? ${how}`, "Buying credits needs a confirmation."))) return;
+    const question = `Buy ${credits.toLocaleString()} credits for ${fmtPrice(q.price_cents !== undefined || q.amount_cents !== undefined ? q : q.pack || q, q.currency)}? ${how}`;
+    if (!(await confirmOrDie(args, question, "Buying credits needs a confirmation."))) return;
     const pbody = { quote_id: q.quote_id, confirmed: true };
     if (payWith !== "auto") pbody.pay_with = payWith;
+    // The purchase records how it was confirmed (2026-10-07): the user's own words when an agent passes them,
+    // the answer at the prompt, or nothing extra with --yes (the record then says confirmed=true).
+    const said = args.confirmation ? String(args.confirmation) : !args.yes ? `Answered yes at the terminal to: ${question}` : "";
+    if (said.trim()) pbody.user_confirmation = said.replace(/\s+/g, " ").trim().slice(0, 1000);
     const r = need(await request("POST", args.base, `${V1}/credits/purchases`, { key, body: pbody }), "credit purchase");
     if (args.json) return console.log(JSON.stringify({ quote: q, purchase: r }, null, 2));
     const p = r.purchase && typeof r.purchase === "object" ? { ...r.purchase, ...r } : r;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "argorant",
-  "version": "0.14.0",
+  "version": "0.14.1",
   "description": "Search, count, reveal, export, and verify B2B contacts from the Argorant database, and find work emails by name and company domain, from your terminal, scripts, or coding agent.",
   "bin": {
     "argorant": "bin/argorant.js"