@audienti/cli 0.1.37 → 0.1.38

package/CHANGELOG.md

@@ -4,6 +4,12 @@ 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

package/README.md

@@ -174,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.37",
+  "version": "0.1.38",
   "description": "Agent-first command-line client for Audienti.",
   "type": "module",
   "bin": {

package/skills/audienti/SKILL.md

@@ -120,6 +120,7 @@ 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

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

@@ -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 });
@@ -2977,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(),
@@ -4128,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 {
@@ -5531,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>]",
@@ -6724,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>",
@@ -9198,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]",
@@ -9208,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.",
@@ -9254,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>]",