@audienti/cli 0.1.91 → 0.1.93

package/CHANGELOG.md

@@ -4,6 +4,19 @@ All notable changes to the Audienti CLI are documented here.
 
 ## [Unreleased]
 
+## [0.1.93] - 2026-10-03
+
+### Added
+
+- `social-cookies show <scok_id> --json` includes `computer_usage`: separate measured Computer and browser-container bandwidth, running time, measurement coverage and timestamps. Missing usage stays unknown; the earlier browser estimate remains separate (#2578).
+
+## [0.1.92] - 2026-10-03
+
+### Added
+
+- `audienti payment show` tells whether an account still needs the $5 card step or a signup code, and prints the pay page address. `audienti payment code <signup_code>` uses a code (#2551).
+- A command against an account that has not paid or used a code now says so and points to `audienti payment show`.
+
 ## [0.1.91] - 2026-10-03
 
 ### Added

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@audienti/cli",
-  "version": "0.1.91",
+  "version": "0.1.93",
   "description": "Agent-first command-line client for Audienti.",
   "type": "module",
   "bin": {

package/src/api-client.js

@@ -437,6 +437,17 @@ export class AudientiClient {
     });
   }
 
+  accountPayment(accountId) {
+    return this.requestJson(accountPath(accountId, ["admission"]));
+  }
+
+  redeemSignupCode(accountId, code) {
+    return this.requestJson(accountPath(accountId, ["admission"]), {
+      method: "POST",
+      body: { code }
+    });
+  }
+
   brandProfile(accountId) {
     return this.requestJson(accountPath(accountId, ["brand_profile"]));
   }
@@ -1381,6 +1392,13 @@ function errorMessage(status, body) {
     return "Authentication failed. Run `audienti auth token <token>` with a valid API token.";
   }
 
+  if (status === 402) {
+    if (body?.code === "payment_needed") {
+      return "This account has not paid or used a signup code yet. Run `audienti payment show`.";
+    }
+    return body?.error || "Audienti stopped this account for a payment reason.";
+  }
+
   if (status === 403) {
     return "The API token is not allowed to access that Audienti resource.";
   }
@@ -1399,6 +1417,10 @@ function errorMessage(status, body) {
     return details ? `Audienti rejected the request: ${details}` : "Audienti rejected the request.";
   }
 
+  if (status === 429 && body?.error) {
+    return body.error;
+  }
+
   return `Audienti API request failed with HTTP ${status}.`;
 }
 

package/src/cli.js

@@ -136,6 +136,8 @@ const WEBHOOKS_ROTATE_USAGE = "Usage: audienti webhooks rotate <endpoint_id> [--
 const WEBHOOKS_REMOVE_USAGE = "Usage: audienti webhooks remove <endpoint_id> [--json] [--account <acct_id>]";
 const REPLY_ALERTS_SHOW_USAGE = "Usage: audienti reply-alerts show [--json]";
 const REPLY_ALERTS_UPDATE_USAGE = "Usage: audienti reply-alerts update [--phone <number|none>] [--sms <true|false>] [--slack <true|false>] [--json]";
+const PAYMENT_SHOW_USAGE = "Usage: audienti payment show [--json] [--account <acct_id>]";
+const PAYMENT_CODE_USAGE = "Usage: audienti payment code <signup_code> [--json] [--account <acct_id>]";
 const BRAND_PROFILE_SHOW_USAGE = "Usage: audienti brand-profile show [--json] [--account <acct_id>]";
 const BRAND_PROFILE_UPDATE_USAGE = "Usage: audienti brand-profile update [--voice <text>] [--style <text>] [--do-not-use <text>] [--json] [--account <acct_id>]";
 const ACCOUNTS_SHOW_USAGE = "Usage: audienti accounts show [<acct_id>] [--json] [--account <acct_id>]";
@@ -395,6 +397,7 @@ async function dispatch(argv, context) {
   if (normalizedResource === "webhooks") return webhooksCommand(action, rest, context, { accountOverride });
   if (normalizedResource === "reply-alerts") return replyAlertsCommand(action, rest, context);
   if (normalizedResource === "brand-profile") return brandProfileCommand(action, rest, context, { accountOverride });
+  if (normalizedResource === "payment") return paymentCommand(action, rest, context, { accountOverride });
   if (normalizedResource === "tags" && action === "list") return tagsList(rest, context, { accountOverride });
   if (normalizedResource === "tags" && action === "show") return tagsShow(rest, context, { accountOverride });
   if (normalizedResource === "tasks" && ["list", "manage"].includes(action)) return tasksList(rest, context, { accountOverride });
@@ -2636,6 +2639,57 @@ function writeReplyAlerts(alerts, context) {
   writeLine(context.stdout, `Slack: ${alerts?.slack_enabled ? "on" : "off"} | Connected: ${alerts?.slack_connected ? "yes" : "no"} | Channel: ${display(alerts?.slack_channel, "-")}`);
 }
 
+async function paymentCommand(action, args, context, { accountOverride } = {}) {
+  if (action === "show") {
+    const { values, positionals } = parseCommandArgs(args, jsonOptions());
+    if (positionals.length > 0) throw new CommandError(PAYMENT_SHOW_USAGE);
+
+    const { client, accountId } = await requireAccountContext(context, { accountOverride });
+    const payload = await client.accountPayment(accountId);
+    if (values.json) return writeJson(context.stdout, payload);
+
+    writeAccountPayment(payload, context);
+    return;
+  }
+
+  if (action === "code") {
+    const { values, positionals } = parseCommandArgs(args, jsonOptions());
+    if (positionals.length !== 1) throw new CommandError(PAYMENT_CODE_USAGE);
+
+    const { client, accountId } = await requireAccountContext(context, { accountOverride });
+    const payload = await client.redeemSignupCode(accountId, positionals[0]);
+    if (values.json) return writeJson(context.stdout, payload);
+
+    writeLine(context.stdout, "Code accepted. No card needed.");
+    writeAccountPayment(payload, context);
+    return;
+  }
+
+  throw new CommandError(`Unknown payment command "${display(action, "")}". Run \`audienti payment --help\`.`);
+}
+
+function writeAccountPayment(payment, context) {
+  const state = payment?.state;
+  if (state === "payment_needed") {
+    const price = payment?.price?.amount ? `$${payment.price.amount / 100}` : "the starting charge";
+    const credits = payment?.card_usage?.unit === "usd_cents" && payment.card_usage.amount ? ` The card charge gets you $${payment.card_usage.amount / 100} of credits.` : "";
+    writeLine(context.stdout, `Payment needed: pay ${price} by card or use a signup code.${credits}`);
+    writeLine(context.stdout, `Card: open ${display(payment?.payment_url, "-")}`);
+    writeLine(context.stdout, "Code: audienti payment code <signup_code>");
+    return;
+  }
+
+  if (state === "payment_stopped") {
+    writeLine(context.stdout, "Stopped: the payment for this account was returned. Nothing runs.");
+    return;
+  }
+
+  writeLine(context.stdout, `State: ${display(state, "-")}`);
+  writeLine(context.stdout, `Let in by: ${display(payment?.admitted_via, "-")}`);
+  const usage = payment?.starting_usage;
+  if (usage) writeLine(context.stdout, `Starting usage: ${usage.amount} ${usage.unit}`);
+}
+
 async function brandProfileCommand(action, args, context, { accountOverride } = {}) {
   if (action === "show") {
     const { values, positionals } = parseCommandArgs(args, jsonOptions());
@@ -10142,6 +10196,8 @@ const HELP_TOPICS = new Map([
     "    audienti hubspot show",
     "    audienti webhooks list",
     "    audienti brand-profile show",
+    "    audienti payment show",
+    "    audienti payment code <signup_code>",
     "    audienti reply-alerts show",
     "",
     "  Writer",
@@ -11348,6 +11404,42 @@ const HELP_TOPICS = new Map([
     "  PATCH /api/v1/me/reply_alerts.json"
   ].join("\n")],
 
+  ["payment", [
+    "Usage:",
+    `  ${PAYMENT_SHOW_USAGE.slice("Usage: ".length)}`,
+    `  ${PAYMENT_CODE_USAGE.slice("Usage: ".length)}`,
+    "",
+    "Status: implemented",
+    "",
+    "Purpose:",
+    "  A new account runs after one card charge or a signup code. Show the state, or use a code.",
+    "  The card step needs a browser; `payment show` prints the address. Account admins only for `code`.",
+    "",
+    "API:",
+    "  GET /api/v1/accounts/:account_id/admission.json",
+    "  POST /api/v1/accounts/:account_id/admission.json"
+  ].join("\n")],
+
+  ["payment show", [
+    "Usage:",
+    `  ${PAYMENT_SHOW_USAGE.slice("Usage: ".length)}`,
+    "",
+    "Status: implemented",
+    "",
+    "API:",
+    "  GET /api/v1/accounts/:account_id/admission.json"
+  ].join("\n")],
+
+  ["payment code", [
+    "Usage:",
+    `  ${PAYMENT_CODE_USAGE.slice("Usage: ".length)}`,
+    "",
+    "Status: implemented",
+    "",
+    "API:",
+    "  POST /api/v1/accounts/:account_id/admission.json"
+  ].join("\n")],
+
   ["brand-profile", [
     "Usage:",
     `  ${BRAND_PROFILE_SHOW_USAGE.slice("Usage: ".length)}`,