@audienti/cli 0.1.36 → 0.1.38

package/CHANGELOG.md

@@ -4,6 +4,22 @@ All notable changes to the Audienti CLI are documented here.
 
 ## [Unreleased]
 
+## [0.1.38] - 2026-08-24
+
+### Added
+
+- Add `audienti tools humanize --file <path>` with optional tone and language controls, plain-text output for shell redirection, and normalized JSON output through the authenticated Audienti API.
+
+## [0.1.37] - 2026-08-23
+
+### Added
+
+- Add motion start/end scheduling and maximum-company discovery-cap configuration to motion API readback and CLI create/update/show workflows.
+
+### Changed
+
+- Show conversion totals, stage SLA, and oldest stage age in the default `audienti analytics stages` output so it matches the dashboard read model without requiring `--json`.
+
 ## [0.1.36] - 2026-08-22
 
 ### Added

package/README.md

@@ -143,6 +143,7 @@ audienti motions quick-start --url https://example.com --wait --confirm
 audienti motions abm-companies <motn_id> add --file abm-domains.txt
 audienti motions abm-companies <motn_id> list
 audienti motions update <motn_id> --status paused
+audienti motions update <motn_id> --start-date 2026-09-01 --end-date 2026-09-30 --maximum-company-count 25
 audienti motions update <motn_id> --own-post-engagement true
 audienti motions update <motn_id> --payload motion-signals.json
 audienti motions activate <motn_id>
@@ -173,12 +174,22 @@ audienti analytics users --user me --window 30d
 audienti analytics visibility --window 24h --user me
 audienti analytics content --window week
 audienti tools list
+audienti tools humanize --file draft.txt --tone professional --language English
 audienti tools linkedin-review --url https://www.linkedin.com/in/example --icp <icp_id>
 audienti tools linkedin-review reports
 audienti tools linkedin-review show <rprt_id>
 audienti tools linkedin-review status <rprt_id>
 ```
 
+To humanize arbitrary text without exposing the underlying provider key, pass a
+UTF-8 file. Plain output contains only the transformed text, so it can be
+redirected directly to another file:
+
+```bash
+audienti tools humanize --file draft.txt --tone professional > revised.txt
+audienti tools humanize --file draft.txt --language English --json
+```
+
 To let an agent or operator check whether the local CLI is behind the latest
 published package:
 

package/package.json

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

package/skills/audienti/SKILL.md

@@ -110,14 +110,17 @@ audienti motions quick-start --url https://example.com --wait --confirm --json
 audienti motions abm-companies <motn_id> add --file abm-domains.txt --json
 audienti motions abm-companies <motn_id> list --json
 audienti motions update <motn_id> --status paused --json
+audienti motions update <motn_id> --start-date 2026-09-01 --end-date 2026-09-30 --maximum-company-count 25 --json
 audienti motions activate <motn_id> --json
 audienti motions delete <motn_id> --confirm yes --json
 audienti operator next --json
 audienti operator next --plan
 audienti analytics prospects --window 24h --json
+audienti analytics stages --window 30d
 audienti analytics visibility --window 24h --user me --json
 audienti analytics content --window week --json
 audienti tools list --json
+audienti tools humanize --file draft.txt --tone professional --json
 audienti tools linkedin-review --url https://www.linkedin.com/in/example --icp <icp_id> --json
 audienti tools linkedin-review reports --json
 audienti tools linkedin-review show <rprt_id> --json
@@ -135,6 +138,13 @@ condition and action data as the list UI. Inspect the ordered rules first, use
 as an asynchronous relaunch: it queues the existing routing job and does not
 mean every list member has finished routing.
 
+Motion start and end dates are optional lifecycle controls. A due start can
+activate a configured preparing or paused motion; an end date is the final
+active day and pauses the motion afterward. `--maximum-company-count` caps
+durable company admissions only: research and people discovery for admitted
+companies, prospect intake, and automation continue. Use `none` to clear any
+of these settings.
+
 `audienti writer test-run <prsp_id>` starts a report-backed writing session and
 builds the campaign timeline without drafting every message. The printed
 `Report: rprt_...` id is the session handle. Pass `--report <rprt_id>` when

package/src/api-client.js

@@ -614,6 +614,13 @@ export class AudientiClient {
     return this.requestJson(accountPath(accountId, ["tools", "linkedin-review", "reports", reportId]));
   }
 
+  humanizeText(accountId, body) {
+    return this.requestJson(accountPath(accountId, ["tools", "humanize"]), {
+      method: "POST",
+      body: { humanization: body }
+    });
+  }
+
   operatorQueue(accountId, query = {}) {
     return this.requestJson(accountPath(accountId, ["operator"], query));
   }

package/src/cli.js

@@ -72,7 +72,7 @@ const OFFERS_DELETE_USAGE = "Usage: audienti offers delete <offr_id> --confirm <
 const WRITER_TEST_RUN_USAGE = "Usage: audienti writer test-run <prsp_id> [--json] [--mode <plan|report|step>] [--branch <both|no-accept|accepted>] [--step <step_key|row_number>] [--report <rprt_id>] [--no-wait] [--timeout-seconds <n>] [--poll-interval-seconds <n>] [--account <acct_id>]";
 const WRITER_TEST_RUN_SHOW_USAGE = "Usage: audienti writer test-run show <prsp_id> <rprt_id> [--json] [--account <acct_id>]";
 const MOTIONS_ANALYTICS_USAGE = "Usage: audienti motions analytics <motn_id> [--window 30d] [--json] [--account <acct_id>]";
-const MOTIONS_UPDATE_USAGE = "Usage: audienti motions update <motn_id> ([--status <draft|preparing|active|paused|archived>] [--tags <tag[,tag...]>] [--own-post-engagement <true|false>] | --payload <file.json>) [--json] [--account <acct_id>]";
+const MOTIONS_UPDATE_USAGE = "Usage: audienti motions update <motn_id> ([--status <draft|preparing|active|paused|archived>] [--tags <tag[,tag...]>] [--own-post-engagement <true|false>] [--start-date <YYYY-MM-DD|none>] [--end-date <YYYY-MM-DD|none>] [--maximum-company-count <n|none>] | --payload <file.json>) [--json] [--account <acct_id>]";
 const CONTENT_PROGRAMS_USAGE = "Usage: audienti content programs [--user <account_user_id|email|name|me>] [--json] [--account <acct_id>]";
 const CONTENT_PLAN_USAGE = "Usage: audienti content plan <cprg_id> [--week <n>] [--due] [--json] [--account <acct_id>]";
 const CONTENT_SHOW_USAGE = "Usage: audienti content show <cpwi_id> [--json] [--account <acct_id>]";
@@ -112,6 +112,7 @@ const ANALYTICS_DASHBOARD_USAGE = "Usage: audienti analytics dashboard [--cohort
 const ANALYTICS_STAGES_USAGE = "Usage: audienti analytics stages [--interval weekly|monthly] [--cohort-start YYYY-MM-DD --cohort-end YYYY-MM-DD] [--play-tag <tag>] [--motion <motn_id>] [--list <list_id>] [--offer <offr_id>] [--icp <icp_id>] [--user <account_user_id|email|name|me>] [--json] [--account <acct_id>]";
 const ANALYTICS_COHORT_LIST_USAGE = "Usage: audienti analytics cohorts create-list --name <text> --start YYYY-MM-DD --end YYYY-MM-DD [--event connection_request_sent] [--user <account_user_id|email|name|me>] [--note-mode <any|with_note|blank>] [--motion <motn_id>] [--offer <offr_id>] [--icp <icp_id>] [--play-tag <tag>] [--json] [--account <acct_id>]";
 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>] [--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>]";
 const TOOLS_LINKEDIN_REVIEW_SHOW_USAGE = "Usage: audienti tools linkedin-review show <rprt_id> [--json] [--account <acct_id>]";
@@ -299,6 +300,7 @@ async function dispatch(argv, context) {
   if (normalizedResource === "writer" && action === "test-run") return writerTestRun(rest, context, { accountOverride });
   if (normalizedResource === "tools" && action === "list") return toolsList(rest, context);
   if (normalizedResource === "tools" && action === "get") return toolsGet(rest, context, { accountOverride });
+  if (normalizedResource === "tools" && action === "humanize") return toolsHumanize(rest, context, { accountOverride });
   if (normalizedResource === "tools" && action === "linkedin-review") return toolsLinkedinReview(rest, context, { accountOverride });
   if (normalizedResource === "operator" && action === "failed-drafts") return operatorFailedDrafts(rest, context, { accountOverride });
   if (normalizedResource === "operator" && action === "queue") return operatorQueue(rest, context, { accountOverride });
@@ -1881,7 +1883,10 @@ async function motionsUpdate(args, context, { accountOverride } = {}) {
     payload: { type: "string" },
     status: { type: "string" },
     tags: { type: "string" },
-    "own-post-engagement": { type: "string" }
+    "own-post-engagement": { type: "string" },
+    "start-date": { type: "string" },
+    "end-date": { type: "string" },
+    "maximum-company-count": { type: "string" }
   });
   const hasUpdateField = values.payload || motionSimpleFieldsPresent(values);
   if (positionals.length !== 1 || !hasUpdateField) {
@@ -1899,7 +1904,7 @@ async function motionsUpdate(args, context, { accountOverride } = {}) {
 async function motionUpdatePayload(values) {
   if (values.payload) {
     if (motionSimpleFieldsPresent(values)) {
-      throw new CommandError("Choose one motion input mode: either --payload <file.json> or the simple --status/--tags/--own-post-engagement flags.");
+      throw new CommandError("Choose one motion input mode: either --payload <file.json> or the simple motion update flags.");
     }
 
     const payload = await readJsonPayload(values.payload);
@@ -1907,15 +1912,54 @@ async function motionUpdatePayload(values) {
     return payload;
   }
 
-  return compactObject({
+  const payload = compactObject({
     status: normalizeMotionStatus(values.status),
     play_tags: values.tags !== undefined ? tagList(values.tags) : undefined,
     own_post_engagement: values["own-post-engagement"] !== undefined ? parseBooleanString(values["own-post-engagement"], "--own-post-engagement") : undefined
   });
+  const nullableSettings = {
+    starts_on: normalizeMotionDate(values["start-date"], "--start-date"),
+    ends_on: normalizeMotionDate(values["end-date"], "--end-date"),
+    maximum_company_count: normalizeMotionMaximumCompanyCount(values["maximum-company-count"])
+  };
+  for (const [key, value] of Object.entries(nullableSettings)) {
+    if (value !== undefined) payload[key] = value;
+  }
+
+  return payload;
 }
 
 function motionSimpleFieldsPresent(values) {
-  return Boolean(values.status) || values.tags !== undefined || values["own-post-engagement"] !== undefined;
+  return Boolean(values.status) ||
+    values.tags !== undefined ||
+    values["own-post-engagement"] !== undefined ||
+    values["start-date"] !== undefined ||
+    values["end-date"] !== undefined ||
+    values["maximum-company-count"] !== undefined;
+}
+
+function normalizeMotionDate(value, flagName) {
+  if (value === undefined) return undefined;
+
+  const normalized = String(value || "").trim().toLowerCase();
+  if (normalized === "none") return null;
+  const match = normalized.match(/^(\d{4})-(\d{2})-(\d{2})$/);
+  if (!match) throw new CommandError(`${flagName} must be YYYY-MM-DD or none.`);
+
+  const [, year, month, day] = match.map(Number);
+  const parsed = new Date(Date.UTC(year, month - 1, day));
+  if (parsed.getUTCFullYear() !== year || parsed.getUTCMonth() !== month - 1 || parsed.getUTCDate() !== day) {
+    throw new CommandError(`${flagName} must be YYYY-MM-DD or none.`);
+  }
+
+  return normalized;
+}
+
+function normalizeMotionMaximumCompanyCount(value) {
+  if (value === undefined) return undefined;
+  if (String(value || "").trim().toLowerCase() === "none") return null;
+
+  return normalizeOptionalPositiveInteger(value, "--maximum-company-count");
 }
 
 function validateMotionSignalRows(payload) {
@@ -2935,6 +2979,36 @@ async function toolsList(args, context) {
   renderToolsList(payload.tools, context);
 }
 
+async function toolsHumanize(args, context, { accountOverride } = {}) {
+  const { values, positionals } = parseCommandArgs(args, {
+    ...jsonOptions(),
+    file: { type: "string" },
+    tone: { type: "string" },
+    language: { type: "string" }
+  });
+
+  if (positionals.length > 0 || !values.file) {
+    throw new CommandError(TOOLS_HUMANIZE_USAGE);
+  }
+
+  const text = await readHumanizerFile(values.file);
+  const { client, accountId } = await requireAccountContext(context, { accountOverride });
+  const payload = await client.humanizeText(accountId, {
+    text,
+    tone: values.tone,
+    language: values.language
+  });
+
+  if (values.json) return writeJson(context.stdout, payload);
+
+  const humanizedText = String(payload?.humanized_text || "");
+  if (!humanizedText.trim()) {
+    throw new CommandError("The humanizer response did not include humanized_text.");
+  }
+  context.stdout.write(humanizedText);
+  if (!humanizedText.endsWith("\n")) context.stdout.write("\n");
+}
+
 async function toolsLinkedinReviewReports(args, context, { accountOverride } = {}) {
   const { values, positionals } = parseCommandArgs(args, {
     ...jsonOptions(),
@@ -4086,6 +4160,26 @@ async function readJsonPayload(filePath) {
   }
 }
 
+async function readHumanizerFile(filePath) {
+  let bytes;
+  try {
+    bytes = await readFile(filePath);
+  } catch (error) {
+    throw new CommandError(`Could not read humanizer file ${filePath}: ${error.message}`);
+  }
+
+  let contents;
+  try {
+    contents = new TextDecoder("utf-8", { fatal: true }).decode(bytes);
+  } catch {
+    throw new CommandError(`Humanizer file ${filePath} must be valid UTF-8 text.`);
+  }
+
+  if (!contents.trim()) throw new CommandError("Humanizer file cannot be blank.");
+
+  return contents;
+}
+
 async function readProspectImportBatchFile(filePath) {
   let contents;
   try {
@@ -4588,6 +4682,9 @@ function renderMotion(motion, context) {
   writeLine(context.stdout, `Motion: ${display(motion?.name)} (${display(motion?.prefix_id)})`);
   writeLine(context.stdout, `Status: ${display(motion?.status)}`);
   writeLine(context.stdout, `Kind: ${display(motion?.kind)}`);
+  writeLine(context.stdout, `Start date: ${display(motion?.starts_on, "not set")}`);
+  writeLine(context.stdout, `End date: ${display(motion?.ends_on, "not set")}`);
+  writeLine(context.stdout, `Maximum companies: ${display(motion?.maximum_company_count, "not set")}`);
   renderExecutableConfiguration(motion?.executable_configuration, context);
   if (motion?.offer?.name) writeLine(context.stdout, `Offer: ${motion.offer.name} (${display(motion.offer.prefix_id)})`);
   if (motion?.icp?.name) writeLine(context.stdout, `ICP: ${motion.icp.name} (${display(motion.icp.prefix_id)})`);
@@ -5486,6 +5583,13 @@ function availableTools() {
       reports_command: null,
       status_command: null
     },
+    {
+      id: "humanize",
+      command: "audienti tools humanize --file <path> [--tone <tone>] [--language <language>]",
+      description: "Humanize arbitrary text from a UTF-8 file and print the transformed result.",
+      reports_command: null,
+      status_command: null
+    },
     {
       id: "linkedin-review",
       command: "audienti tools linkedin-review --url <linkedin_url> [--icp <icp_id>]",
@@ -5780,6 +5884,7 @@ function writeStageConversionTable(conversionGrid, context) {
   const rows = Array.isArray(conversionGrid?.rows) ? conversionGrid.rows : [];
   const definitions = Array.isArray(conversionGrid?.stage_definitions) ? conversionGrid.stage_definitions : [];
   const columns = definitions.filter((definition) => definition?.key);
+  const totalValues = conversionGrid?.total_values || {};
 
   writeLine(context.stdout, "");
   writeLine(context.stdout, display(conversionGrid?.window_description, "Conversion cohorts"));
@@ -5790,6 +5895,12 @@ function writeStageConversionTable(conversionGrid, context) {
     display(row?.label),
     ...columns.map((column) => stageMetricValueLabel(row?.values?.[column.key]))
   ]);
+  if (Object.keys(totalValues).length > 0) {
+    tableRows.push([
+      "TOTAL",
+      ...columns.map((column) => stageMetricValueLabel(totalValues[column.key]))
+    ]);
+  }
 
   writeAlignedTable(context, headers, tableRows);
 }
@@ -5807,20 +5918,22 @@ function writeStageAgingTable(stageAging, context) {
   );
   writeAlignedTable(
     context,
-    ["STAGE", "CURRENT", "DUE SOON", "OVERDUE", "OVERDUE %", "MED AGE", "OLDEST IDLE"],
+    ["STAGE", "SLA", "CURRENT", "DUE SOON", "OVERDUE", "OVERDUE %", "MED AGE", "OLDEST AGE", "OLDEST IDLE"],
     rows.map(stageAgingRow),
-    { numericColumns: [false, true, true, true, true, true, true] }
+    { numericColumns: [false, true, true, true, true, true, true, true, true] }
   );
 }
 
 function stageAgingRow(row) {
   return [
     display(row?.label || row?.key),
+    dayCountLabel(row?.due_after_days),
     display(row?.current_count, 0),
     display(row?.due_soon_count, 0),
     display(row?.overdue_count, 0),
     percentageLabel(row?.overdue_rate),
     dayCountLabel(row?.median_stage_age_days),
+    dayCountLabel(row?.oldest_stage_age_days),
     dayCountLabel(row?.oldest_idle_days)
   ];
 }
@@ -6576,7 +6689,7 @@ const HELP_TOPICS = new Map([
     "    audienti motions abm-companies <motn_id> list",
     "    audienti motions abm-companies <motn_id> add <domain_or_linkedin_url>...",
     "    audienti motions create --payload <file.json>",
-    "    audienti motions update <motn_id> [--status <state>] [--tags <tag[,tag...]>] [--own-post-engagement <true|false>]",
+    "    audienti motions update <motn_id> [--status <state>] [--tags <tag[,tag...]>] [--own-post-engagement <true|false>] [--start-date <date|none>] [--end-date <date|none>] [--maximum-company-count <n|none>]",
     "    audienti motions update <motn_id> --payload <file.json>",
     "    audienti motions add-tag <motn_id> <tag>",
     "    audienti motions remove-tag <motn_id> <tag>",
@@ -6670,6 +6783,7 @@ const HELP_TOPICS = new Map([
     "    audienti tools list",
     "    audienti tools get email --url <linkedin_url>",
     "    audienti tools get phone --url <linkedin_url>",
+    "    audienti tools humanize --file <path>",
     "    audienti tools linkedin-review --url <linkedin_url> [--icp <icp_id>]",
     "    audienti tools linkedin-review reports",
     "    audienti tools linkedin-review show <rprt_id>",
@@ -7899,7 +8013,7 @@ const HELP_TOPICS = new Map([
     "  audienti motions abm-companies <motn_id> add (<domain_or_linkedin_url>... | --file <txt|json>) [--json]",
     "  audienti motions abm-companies <motn_id> remove <row_id> [--json]",
     "  audienti motions create --payload <file.json> [--json]",
-    "  audienti motions update <motn_id> ([--status <draft|preparing|active|paused|archived>] [--tags <tag[,tag...]>] [--own-post-engagement <true|false>] | --payload <file.json>) [--json]",
+    `  ${MOTIONS_UPDATE_USAGE.slice("Usage: ".length).replace(" [--account <acct_id>]", "")}`,
     "  audienti motions add-tag <motn_id> <tag> [--json]",
     "  audienti motions remove-tag <motn_id> <tag> [--json]",
     "  audienti motions activate <motn_id> [--json]",
@@ -8177,6 +8291,9 @@ const HELP_TOPICS = new Map([
     "  icp_id: icpp_ prefix id | optional",
     "  list_id: list_ prefix id | optional",
     "  play_tags: [string] | optional",
+    "  starts_on: YYYY-MM-DD | null | optional scheduled activation date",
+    "  ends_on: YYYY-MM-DD | null | optional final active date",
+    "  maximum_company_count: positive integer | null | optional new-company discovery cap",
     "  signal_rows: [{ scope: company | person | both, question: string, company_signal_category: string | optional, role_terms: string | optional, posting_language: hiring-only string | optional, topics: string | optional }] | optional for outbound motions",
     "  signal_questions: newline-delimited company::, person::, or both:: legacy question text | optional for outbound motions",
     "  inbound_channels: [linkedin | reddit] | optional; defaults to [linkedin] for inbound motions",
@@ -8191,6 +8308,9 @@ const HELP_TOPICS = new Map([
     "    \"offer_id\": \"offr_abc123\",",
     "    \"principal_account_user_id\": 42,",
     "    \"list_id\": \"list_abc123\",",
+    "    \"starts_on\": \"2026-09-01\",",
+    "    \"ends_on\": \"2026-09-30\",",
+    "    \"maximum_company_count\": 25,",
     "    \"play_tags\": [\"sarit\", \"pj\"]",
     "  }",
     "",
@@ -8214,8 +8334,8 @@ const HELP_TOPICS = new Map([
     "  name: new motion name",
     "",
     "Behavior:",
-    "  Copies the motion kind, offer, ICP, principal, premise, approach, targeting profile, suppression policy, secondary roles, and active signal rows.",
-    "  The clone starts as draft with a new empty backing list.",
+    "  Copies the motion kind, offer, ICP, principal, premise, approach, maximum company count, targeting profile, suppression policy, secondary roles, and active signal rows.",
+    "  The clone starts as draft with a new empty backing list and no inherited schedule dates.",
     "",
     "API:",
     "  POST /api/v1/accounts/:account_id/motions/:id/clone.json",
@@ -8241,10 +8361,14 @@ const HELP_TOPICS = new Map([
     "  motn_id: motn_ prefix id",
     "  status: draft | preparing | active | paused | archived | optional",
     "  tags: comma-separated tag list | optional",
+    "  start-date: YYYY-MM-DD | none | optional",
+    "  end-date: YYYY-MM-DD | none | optional",
+    "  maximum-company-count: positive integer | none | optional",
     "  payload: file.json | optional full or partial motion object using the account API shape",
     "",
     "Behavior:",
-    "  Choose either --payload or simple flags. Updates only the provided fields. Sending --tags replaces the motion's full tag set.",
+    "  Choose either --payload or simple flags. Updates only the provided fields. Use none to clear a schedule date or company cap. Sending --tags replaces the motion's full tag set.",
+    "  The company cap stops only new company discovery; existing company research, people discovery, prospect intake, and automation continue.",
     "  Payload mode supports outbound signal_rows or legacy signal_questions; supplied rows replace the motion's active ready signals.",
     "  posting_language is only supported on company-scope hiring signal rows; use topics for person discussion evidence.",
     "",
@@ -9134,6 +9258,7 @@ const HELP_TOPICS = new Map([
     "Usage:",
     "  audienti tools list [--json]",
     "  audienti tools get <email|phone> --url <linkedin_url> [--json]",
+    "  audienti tools humanize --file <path> [--tone <tone>] [--language <language>] [--json]",
     "  audienti tools linkedin-review --url <linkedin_url> [--icp <icp_id>] [--json]",
     "  audienti tools linkedin-review reports [--limit <n>] [--json]",
     "  audienti tools linkedin-review show <rprt_id> [--json]",
@@ -9144,6 +9269,7 @@ const HELP_TOPICS = new Map([
     "Commands:",
     "  audienti tools list             Show available CLI tools and the report commands they support.",
     "  audienti tools get              Run a LinkedIn URL through the existing import and contact-enrichment pipeline, then return the first selected email or phone.",
+    "  audienti tools humanize         Humanize arbitrary UTF-8 text and print the result.",
     "  audienti tools linkedin-review  Queue a LinkedIn personal profile authority review and ICP-fit positioning blueprint.",
     "  audienti tools linkedin-review reports  List recent LinkedIn Review reports for the active account.",
     "  audienti tools linkedin-review show     View the completed report content in the terminal.",
@@ -9190,6 +9316,28 @@ const HELP_TOPICS = new Map([
     "  JSON: { kind, url, found, value, import_id, status, ready, prospect, pipeline }"
   ].join("\n")],
 
+  ["tools humanize", [
+    "Usage:",
+    `  ${TOOLS_HUMANIZE_USAGE.slice("Usage: ".length)}`,
+    "",
+    "Status: implemented",
+    "",
+    "Purpose:",
+    "  Sends arbitrary UTF-8 text to Audienti's server-side humanizer without exposing the provider key.",
+    "",
+    "Options:",
+    "  --file <path>       Required UTF-8 text file",
+    "  --tone <professional|academic|blog|casual|creative|scientific|technical>",
+    "  --language <name>   Optional language hint, for example English",
+    "",
+    "Output:",
+    "  Plain text: only the humanized text, suitable for redirecting to a file",
+    "  JSON: { humanized_text, id, input_words }",
+    "",
+    "API:",
+    "  POST /api/v1/accounts/:account_id/tools/humanize.json"
+  ].join("\n")],
+
   ["tools linkedin-review", [
     "Usage:",
     "  audienti tools linkedin-review --url <linkedin_url> [--icp <icp_id>] [--json] [--account <acct_id>]",