@audienti/cli 0.1.136 → 0.1.138

package/CHANGELOG.md

@@ -4,6 +4,19 @@ All notable changes to the Audienti CLI are documented here.
 
 ## [Unreleased]
 
+## [0.1.138] - 2026-10-24
+
+### Added
+
+- Review and explicitly accept Email Find credit quotes. Review queued rows and resume, pause, cancel or approve a new payer through shared API controls. Read exact credit receipts; ordinary tool history hides supplier monetary amounts (#2643). Real charging remains separately gated.
+
+
+## [0.1.137] - 2026-10-24
+
+### Changed
+
+- No CLI behavior change. The API events controller now shares its rejection status table with the Operator drawer for settling an uncertain post comment (#3097).
+
 ## [0.1.136] - 2026-10-24
 
 ### Added

package/README.md

@@ -328,6 +328,23 @@ inside fields are not. With `--wait`, the exit code is 1 on an API error, a
 timeout or an aborted (failed) run; per-item outcomes such as `no_match` do
 not change it.
 
+For an active paid Email Find operation, review a server quote first:
+
+```bash
+audienti tools email-find --file people.csv --quote
+audienti tools email-find --file people.csv --accept-quote <quote_reference>
+audienti tools runs review <run_id>
+audienti tools runs resume <run_id> --item <item_id> --revision <revision> --idempotency-key <unique_key>
+```
+
+Use the same input when accepting the quote. Queued rows retain the accepted price.
+Review reports available credits and the rows that can continue. Select fewer rows
+or top up; a top-up does not restart manually paused work. Use `pause` or `cancel`
+in place of `resume` with the same reviewed selection. `approve-payer` requires the
+new root administrator and does not resume work. `tools runs usage <usage_reference>`
+opens the exact receipt data. Tool history displays credits; supplier costs stay internal.
+Real prices and production charging require separate approval.
+
 Prefer `tools email-find` for an email lookup. `tools get email` still runs the
 prospect import pipeline and creates a prospect.
 

package/package.json

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

package/src/api-client.js

@@ -1318,6 +1318,18 @@ export class AudientiClient {
   }
 
   // Standalone account tool runs (#2554).
+  quoteToolRun(accountId, body) {
+    return this.requestJson(accountPath(accountId, ["tools", "run_quotes"]), { method: "POST", body });
+  }
+
+  toolRunCreditAction(accountId, runId, body) {
+    return this.requestJson(accountPath(accountId, ["tools", "runs", runId, "credit_actions"]), { method: "POST", body });
+  }
+
+  toolCreditUsage(accountId, reference) {
+    return this.requestJson(accountPath(accountId, ["tools", "credit_usages", reference]));
+  }
+
   createToolRun(accountId, body) {
     return this.requestJson(accountPath(accountId, ["tools", "runs"]), { method: "POST", body });
   }

package/src/cli.js

@@ -231,11 +231,11 @@ const ANALYTICS_COHORT_LIST_USAGE = "Usage: audienti analytics cohorts create-li
 const TOOLS_LIST_USAGE = "Usage: audienti tools list [--json]";
 const TOOLS_HUMANIZE_USAGE = "Usage: audienti tools humanize --file <path> [--tone <professional|academic|blog|casual|creative|scientific|technical>] [--language <language>] [--async [--wait]] [--json] [--account <acct_id>]";
 const TOOL_RUN_FLAGS_USAGE = "[--request-key <key>] [--wait [--timeout-seconds <n>] [--poll-interval-seconds <n>]] [--json] [--account <acct_id>]";
-const TOOLS_EMAIL_FIND_USAGE = `Usage: audienti tools email-find (--first-name <name> --last-name <name> --company-domain <domain> | --linkedin-url <url> | --file <csv|jsonl|json>) ${TOOL_RUN_FLAGS_USAGE}`;
+const TOOLS_EMAIL_FIND_USAGE = `Usage: audienti tools email-find (--first-name <name> --last-name <name> --company-domain <domain> | --linkedin-url <url> | --file <csv|jsonl|json>) [--quote | --accept-quote <reference>] ${TOOL_RUN_FLAGS_USAGE}`;
 const TOOLS_LINKEDIN_ENRICH_USAGE = `Usage: audienti tools linkedin-enrich (--url <linkedin_url> [--kind <person|company>] | --file <csv|jsonl|json>) ${TOOL_RUN_FLAGS_USAGE}`;
 const TOOLS_SIGNALS_FIND_USAGE = `Usage: audienti tools signals-find --icp <text> --question <text> [--count <1-10>] [--date-window-days <n>] ${TOOL_RUN_FLAGS_USAGE}`;
 const TOOLS_WRITE_USAGE = `Usage: audienti tools write --purpose <text> --audience <text> --fact <text> [--fact <text> ...] --channel <channel> [--tone <tone>] [--subject|--no-subject] [--prospect <prsp_id>] ${TOOL_RUN_FLAGS_USAGE}`;
-const TOOLS_RUNS_USAGE = "Usage: audienti tools runs (list [--tool <tool>] [--status <status>] [--limit <n>] [--cursor <id>] | show <trun_id> | results <trun_id> [--limit <n>] [--cursor <n>] | export <trun_id> [--format <csv|json>] [--output <path>]) [--json] [--account <acct_id>]";
+const TOOLS_RUNS_USAGE = "Usage: audienti tools runs (list [--tool <tool>] [--status <status>] [--limit <n>] [--cursor <id>] | show <trun_id> | results <trun_id> [--limit <n>] [--cursor <n>] | export <trun_id> [--format <csv|json>] [--output <path>] | review <trun_id> | (resume|pause|cancel|approve-payer) <trun_id> --item <item_id> --revision <revision> --idempotency-key <key> [--cancel-others] | usage <reference>) [--json] [--account <acct_id>]";
 const NETWORK_USAGE = "Usage: audienti network (list|export) --cookie <scok_id> [--platform <linkedin|twitter>] [--kind <connection|follow>] [--direction <incoming|outgoing>] [--query <text>] [--limit <n>] [--cursor <n>] [--format <csv|json>] [--output <path>] [--json] [--account <acct_id>]";
 const TOOLS_LINKEDIN_REVIEW_USAGE = "Usage: audienti tools linkedin-review --url <linkedin_url> [--icp <icp_id>] [--json] [--account <acct_id>]";
 const TOOLS_LINKEDIN_REVIEW_REPORTS_USAGE = "Usage: audienti tools linkedin-review reports [--limit <n>] [--json] [--account <acct_id>]";
@@ -16353,6 +16353,8 @@ async function toolsEmailFind(args, context, { accountOverride } = {}) {
   const { values, positionals } = parseCommandArgs(args, {
     ...jsonOptions(),
     ...TOOL_RUN_WAIT_OPTIONS,
+    quote: { type: "boolean" },
+    "accept-quote": { type: "string" },
     "first-name": { type: "string" },
     "last-name": { type: "string" },
     "company-domain": { type: "string" },
@@ -16450,7 +16452,16 @@ async function toolsWrite(args, context, { accountOverride } = {}) {
 
 async function submitToolRun(tool, input, values, context, { accountOverride } = {}) {
   const { client, accountId } = await requireAccountContext(context, { accountOverride });
-  const run = await client.createToolRun(accountId, compactObject({ tool, input, request_key: values["request-key"] }));
+  if (values.quote) {
+    if (values["accept-quote"]) throw new CommandError("Choose --quote or --accept-quote, not both.");
+    const quote = await client.quoteToolRun(accountId, { tool, input });
+    if (values.json) return writeJson(context.stdout, quote);
+    writeLine(context.stdout, `Up to ${quote.maximum_credits} credits for ${quote.max_units} rows. Available: ${quote.available_credits} credits.`);
+    writeLine(context.stdout, `Accept with the same input and --accept-quote ${quote.quote_reference}`);
+    return 0;
+  }
+  const run = await client.createToolRun(accountId, compactObject({ tool, input, request_key: values["request-key"],
+    quote_reference: values["accept-quote"], accept_quote: values["accept-quote"] ? true : undefined }));
   if (!values.wait) {
     if (values.json) return writeJson(context.stdout, run);
 
@@ -16507,6 +16518,7 @@ async function fetchAllToolRunItems(client, accountId, runId) {
 
 async function toolsRuns(args, context, { accountOverride } = {}) {
   const [subcommand, ...rest] = args;
+  if (["review", "resume", "pause", "cancel", "approve-payer", "usage"].includes(subcommand)) return toolsRunsCredits(subcommand, rest, context, { accountOverride });
   if (subcommand === "list") return toolsRunsList(rest, context, { accountOverride });
   if (subcommand === "show") return toolsRunsShow(rest, context, { accountOverride });
   if (subcommand === "results") return toolsRunsResults(rest, context, { accountOverride });
@@ -16515,6 +16527,24 @@ async function toolsRuns(args, context, { accountOverride } = {}) {
   throw new CommandError(TOOLS_RUNS_USAGE);
 }
 
+async function toolsRunsCredits(action, args, context, { accountOverride } = {}) {
+  const { values, positionals } = parseCommandArgs(args, {
+    ...jsonOptions(), item: { type: "string", multiple: true }, revision: { type: "string" },
+    "idempotency-key": { type: "string" }, "cancel-others": { type: "boolean" }
+  });
+  if (positionals.length !== 1) throw new CommandError("Supply one run id (or usage reference for usage).");
+  const { client, accountId } = await requireAccountContext(context, { accountOverride });
+  if (action === "usage") return writeJson(context.stdout, await client.toolCreditUsage(accountId, positionals[0]));
+  if (action !== "review" && (!values.item?.length || !values.revision || !values["idempotency-key"])) {
+    throw new CommandError("Review first, then supply --item for each selected row, --revision and --idempotency-key.");
+  }
+  const result = await client.toolRunCreditAction(accountId, positionals[0], compactObject({
+    action_name: action.replaceAll("-", "_"), item_ids: values.item, revision: values.revision,
+    idempotency_key: values["idempotency-key"], cancel_others: values["cancel-others"]
+  }));
+  return writeJson(context.stdout, result);
+}
+
 async function toolsRunsList(args, context, { accountOverride } = {}) {
   const { values, positionals } = parseCommandArgs(args, {
     ...jsonOptions(),
@@ -16666,8 +16696,8 @@ function renderToolRun(run, context) {
     if (Number(run.summary.cache_hit_count) > 0) usage.push(`${run.summary.cache_hit_count} cached`);
     writeLine(context.stdout, `Usage: ${usage.join("; ")}`);
   }
-  const stillRunningWithoutExpenses = ["queued", "running"].includes(run?.status) && run?.current_expenses?.state === "none";
-  if (run?.current_expenses && !stillRunningWithoutExpenses) writeLine(context.stdout, `Recorded expenses: ${toolRunExpenseSummary(run.current_expenses)}`);
+  if (run?.credit_usage) writeLine(context.stdout, run.credit_usage.credit_history_available
+    ? `Charged: ${run.credit_usage.charged_credits} credits` : "Credit history unavailable");
   const outcomes = run?.summary?.outcomes || {};
   if (Object.keys(outcomes).length > 0) {
     writeLine(context.stdout, `Outcomes: ${Object.entries(outcomes).map(([outcome, count]) => `${outcome} ${count}`).join(", ")}`);
@@ -16676,31 +16706,6 @@ function renderToolRun(run, context) {
   if (run?.details_expired) writeLine(context.stdout, "Details expired after 90 days; only this summary remains.");
 }
 
-function toolRunExpenseSummary(expenses) {
-  if (expenses.state === "unavailable") return "data unavailable";
-  if (expenses.state === "none") return "no recorded expenses";
-  if (expenses.state === "expired") {
-    const known = expenses.completion_snapshot?.known_billed_expense_cents;
-    return `current receipt detail expired; completion-time snapshot ${expenseAmountLabel(known)}; ${display(expenses.uncertain_attempt_count, 0)} call(s) with unknown or uncertain expense at completion`;
-  }
-
-  const known = expenses.known_expense_cents;
-  const parts = [known === null || known === undefined ? "no priced receipts" : `${expenseAmountLabel(known)} recorded`];
-  if (expenses.unknown_expense_receipt_count > 0) parts.push(`${expenses.unknown_expense_receipt_count} linked receipt(s) with unknown amount`);
-  if (expenses.uncertain_attempt_count > 0) parts.push(`${expenses.uncertain_attempt_count} call(s) with unknown or uncertain expense`);
-  if (expenses.completion_unverified_attempt_count > 0) parts.push(`${expenses.completion_unverified_attempt_count} call(s) with cost unverified at completion`);
-  if (expenses.in_progress_attempt_count > 0) parts.push(`${expenses.in_progress_attempt_count} call(s) in progress`);
-  if (expenses.state === "partial") parts.push("known sum may be partial");
-  return parts.join("; ");
-}
-
-function expenseAmountLabel(cents) {
-  if (cents === null || cents === undefined) return "no known amount";
-  const amount = Number(cents);
-  if (amount > 0 && amount < 0.01) return "less than 0.01¢";
-  return `${amount.toFixed(2)}¢`;
-}
-
 function renderToolRunItems(tool, items, context) {
   if (items.length === 0) return writeLine(context.stdout, "No results yet.");