@audienti/cli 0.1.97 → 0.1.99

package/CHANGELOG.md

@@ -4,6 +4,18 @@ All notable changes to the Audienti CLI are documented here.
 
 ## [Unreleased]
 
+## [0.1.99] - 2026-10-05
+
+- List user-owned content plans and read scripts with `content plans` and `content plan --report`.
+- Edit, approve, research, draft and generate visuals for a plan piece through the existing production services.
+- Approve an explicit comment reply through the tracked post endpoint with `content post-reply`.
+
+## [0.1.98] - 2026-10-04
+
+### Added
+
+- `content track <url>` submits an owned LinkedIn post for tracking. `content posts` lists tracked posts, and `content engagement <cpwi_id>` reads collected comments and reactions.
+
 ## [0.1.97] - 2026-10-04
 
 ### Added

package/README.md

@@ -185,7 +185,18 @@ audienti motions update <motn_id> --payload motion-signals.json
 audienti motions activate <motn_id>
 audienti motions delete <motn_id> --confirm yes
 audienti content programs
+audienti content track <linkedin_post_url>
+audienti content posts
+audienti content engagement <cpwi_id> --json
 audienti content plan <cprg_id>
+audienti content plans --user me
+audienti content plan <rprt_id> --report --user me
+audienti content plan-update <rprt_id> --day 1 --payload edits.json
+audienti content plan-approve <rprt_id> --day 1
+audienti content plan-research <rprt_id> --day 1
+audienti content plan-draft <rprt_id> --day 1 --feedback "Revise the opening"
+audienti content plan-visuals <rprt_id> --day 1 --style <id>
+audienti content post-reply <cpwi_id> --comment <task_id> --body "Approved reply"
 audienti content approve <cpwi_id>
 audienti content comments
 audienti social-cookies sync-messages <scok_id> [--folder <folder>] [--retry] --json

package/package.json

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

package/src/api-client.js

@@ -695,10 +695,54 @@ export class AudientiClient {
     return this.requestJson(accountPath(accountId, ["content_ops", "programs", programId, "plan"], query));
   }
 
+  contentPlans(accountId, query = {}) {
+    return this.requestJson(accountPath(accountId, ["content_ops", "plans"], query));
+  }
+
+  contentPlanReport(accountId, reportId, query = {}) {
+    return this.requestJson(accountPath(accountId, ["content_ops", "plans", reportId], query));
+  }
+
+  contentPlanUpdate(accountId, reportId, day, body = {}) {
+    return this.requestJson(accountPath(accountId, ["content_ops", "plans", reportId, "items", day]), { method: "PATCH", body });
+  }
+
+  contentPlanApprove(accountId, reportId, day, body = {}) {
+    return this.requestJson(accountPath(accountId, ["content_ops", "plans", reportId, "items", day, "approve"]), { method: "POST", body });
+  }
+
+  contentPlanResearch(accountId, reportId, day, body = {}) {
+    return this.requestJson(accountPath(accountId, ["content_ops", "plans", reportId, "items", day, "research"]), { method: "POST", body });
+  }
+
+  contentPlanDraft(accountId, reportId, day, body = {}) {
+    return this.requestJson(accountPath(accountId, ["content_ops", "plans", reportId, "items", day, "draft"]), { method: "POST", body });
+  }
+
+  contentPlanVisuals(accountId, reportId, day, body = {}) {
+    return this.requestJson(accountPath(accountId, ["content_ops", "plans", reportId, "items", day, "visuals"]), { method: "POST", body });
+  }
+
+  contentPostReply(accountId, workItemId, taskId, body = {}) {
+    return this.requestJson(accountPath(accountId, ["content_ops", "tracked_posts", workItemId, "comments", taskId, "reply"]), { method: "POST", body });
+  }
+
   contentWorkItem(accountId, workItemId) {
     return this.requestJson(accountPath(accountId, ["content_ops", "work_items", workItemId]));
   }
 
+  contentTrackedPosts(accountId, query = {}) {
+    return this.requestJson(accountPath(accountId, ["content_ops", "tracked_posts"], query));
+  }
+
+  contentTrackPost(accountId, body) {
+    return this.requestJson(accountPath(accountId, ["content_ops", "tracked_posts"]), { method: "POST", body });
+  }
+
+  contentTrackedPost(accountId, workItemId) {
+    return this.requestJson(accountPath(accountId, ["content_ops", "tracked_posts", workItemId]));
+  }
+
   contentFeedback(accountId, workItemId, body) {
     return this.requestJson(accountPath(accountId, ["content_ops", "work_items", workItemId, "feedback"]), { method: "POST", body });
   }

package/src/cli.js

@@ -166,8 +166,13 @@ const WRITER_TEST_RUN_SHOW_USAGE = "Usage: audienti writer test-run show <prsp_i
 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|closing|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>] [--approach <text>] [--gift <gift_id|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_PLAN_USAGE = "Usage: audienti content plan <cprg_id|rprt_id> [--report] [--user <id|me>] [--week <n>] [--due] [--json] [--account <acct_id>]";
+const CONTENT_PLANS_USAGE = "Usage: audienti content plans [--user <id|me>] [--page <n>] [--json] [--account <acct_id>]";
+const CONTENT_POST_REPLY_USAGE = "Usage: audienti content post-reply <cpwi_id> --comment <cctk_id> --body <text> [--user <id|me>] [--json] [--account <acct_id>]";
 const CONTENT_SHOW_USAGE = "Usage: audienti content show <cpwi_id> [--json] [--account <acct_id>]";
+const CONTENT_POSTS_USAGE = "Usage: audienti content posts [--user <account_user_id|email|name|me>] [--page <n>] [--json] [--account <acct_id>]";
+const CONTENT_TRACK_USAGE = "Usage: audienti content track <linkedin_post_url> [--user <account_user_id|email|name|me>] [--json] [--account <acct_id>]";
+const CONTENT_ENGAGEMENT_USAGE = "Usage: audienti content engagement <cpwi_id> [--json] [--account <acct_id>]";
 const CONTENT_FEEDBACK_USAGE = "Usage: audienti content feedback <cpwi_id> (--message <text> | --payload <file.json>) [--json] [--account <acct_id>]";
 const CONTENT_APPROVE_USAGE = "Usage: audienti content approve <cpwi_id> [--json] [--account <acct_id>]";
 const CONTENT_SCHEDULE_USAGE = "Usage: audienti content schedule <cpwi_id> --at <time> [--json] [--account <acct_id>]";
@@ -448,8 +453,14 @@ async function dispatch(argv, context) {
   if (normalizedResource === "motions" && action === "quick-start") return motionsQuickStart(rest, context, { accountOverride });
   if (normalizedResource === "motions" && action === "setup-state") return motionsSetupState(rest, context, { accountOverride });
   if (normalizedResource === "content" && action === "programs") return contentPrograms(rest, context, { accountOverride });
+  if (normalizedResource === "content" && action === "plans") return contentPlans(rest, context, { accountOverride });
+  if (normalizedResource === "content" && ["plan-update", "plan-approve", "plan-research", "plan-draft", "plan-visuals"].includes(action)) return contentPlanAction(action, rest, context, { accountOverride });
+  if (normalizedResource === "content" && action === "post-reply") return contentPostReply(rest, context, { accountOverride });
   if (normalizedResource === "content" && action === "plan") return contentPlan(rest, context, { accountOverride });
   if (normalizedResource === "content" && action === "show") return contentShow(rest, context, { accountOverride });
+  if (normalizedResource === "content" && action === "posts") return contentPosts(rest, context, { accountOverride });
+  if (normalizedResource === "content" && action === "track") return contentTrack(rest, context, { accountOverride });
+  if (normalizedResource === "content" && action === "engagement") return contentEngagement(rest, context, { accountOverride });
   if (normalizedResource === "content" && action === "feedback") return contentFeedback(rest, context, { accountOverride });
   if (normalizedResource === "content" && action === "approve") return contentApprove(rest, context, { accountOverride });
   if (normalizedResource === "content" && action === "schedule") return contentSchedule(rest, context, { accountOverride });
@@ -3847,18 +3858,71 @@ async function contentPrograms(args, context, { accountOverride } = {}) {
   renderContentPrograms(programs, context);
 }
 
+async function contentPlans(args, context, { accountOverride } = {}) {
+  const { values, positionals } = parseCommandArgs(args, { ...jsonOptions(), user: { type: "string" }, page: { type: "string" } });
+  if (positionals.length) throw new CommandError(CONTENT_PLANS_USAGE);
+  const { client, accountId } = await requireAccountContext(context, { accountOverride });
+  const payload = await client.contentPlans(accountId, compactObject({ user: values.user, page: values.page }));
+  if (values.json) return writeJson(context.stdout, payload);
+  for (const plan of payload.plans || []) context.stdout.write(`${plan.prefix_id}  ${plan.channel}  ${plan.status}  ${plan.title}\n`);
+  context.stdout.write("Open a plan: content plan <rprt_id> --report\n");
+  if (payload.next_page) context.stdout.write(`More plans: content plans --page ${payload.next_page}\n`);
+}
+
+async function contentPlanAction(action, args, context, { accountOverride } = {}) {
+  const usage = `Usage: audienti content ${action} <rprt_id> --day <n> [--user <id|me>] [--payload <file.json>] [--feedback <text>] [--style <id>] [--aspect-ratio <w:h>] [--json] [--account <acct_id>]`;
+  const { values, positionals } = parseCommandArgs(args, { ...jsonOptions(), day: { type: "string" }, user: { type: "string" }, payload: { type: "string" }, feedback: { type: "string" }, style: { type: "string" }, "aspect-ratio": { type: "string" } });
+  const day = Number(values.day);
+  if (positionals.length !== 1 || !Number.isInteger(day) || day < 1 || (action === "plan-update" && !values.payload)) throw new CommandError(usage);
+  if (values["aspect-ratio"] && !/^\d+:\d+$/.test(values["aspect-ratio"])) throw new CommandError("Aspect ratio must be w:h.");
+  const body = compactObject({ user: values.user });
+  if (action === "plan-update") {
+    body.item = await readJsonPayload(values.payload);
+    if (!body.item || typeof body.item !== "object" || Array.isArray(body.item)) throw new CommandError("Plan update payload must be a JSON object.");
+  }
+  if (action === "plan-draft") body.draft_feedback = values.feedback || "";
+  if (action === "plan-visuals") body.visual_generation = compactObject({ ad_style_id: values.style, aspect_ratio_option: values["aspect-ratio"] });
+  const { client, accountId } = await requireAccountContext(context, { accountOverride });
+  let result;
+  if (action === "plan-update") result = await client.contentPlanUpdate(accountId, positionals[0], day, body);
+  else if (action === "plan-approve") result = await client.contentPlanApprove(accountId, positionals[0], day, body);
+  else if (action === "plan-research") result = await client.contentPlanResearch(accountId, positionals[0], day, body);
+  else if (action === "plan-draft") result = await client.contentPlanDraft(accountId, positionals[0], day, body);
+  else result = await client.contentPlanVisuals(accountId, positionals[0], day, body);
+  if (values.json) return writeJson(context.stdout, result);
+  context.stdout.write(`${result.title || "Content plan"}: ${result.status}\n`);
+}
+
+async function contentPostReply(args, context, { accountOverride } = {}) {
+  const { values, positionals } = parseCommandArgs(args, { ...jsonOptions(), comment: { type: "string" }, body: { type: "string" }, user: { type: "string" } });
+  if (positionals.length !== 1 || !values.comment || !values.body?.trim()) throw new CommandError(CONTENT_POST_REPLY_USAGE);
+  const { client, accountId } = await requireAccountContext(context, { accountOverride });
+  const result = await client.contentPostReply(accountId, positionals[0], values.comment, compactObject({ reply_body: values.body, user: values.user }));
+  if (values.json) return writeJson(context.stdout, result);
+  context.stdout.write(`Reply approved for post ${result.prefix_id}; check engagement for delivery status.\n`);
+}
+
 async function contentPlan(args, context, { accountOverride } = {}) {
   const { values, positionals } = parseCommandArgs(args, {
     ...jsonOptions(),
     week: { type: "string" },
-    due: { type: "boolean" }
+    due: { type: "boolean" },
+    report: { type: "boolean" },
+    user: { type: "string" }
   });
   if (positionals.length !== 1) throw new CommandError(CONTENT_PLAN_USAGE);
 
   const { client, accountId } = await requireAccountContext(context, { accountOverride });
-  const payload = await client.contentPlan(accountId, positionals[0]);
+  const payload = values.report
+    ? await client.contentPlanReport(accountId, positionals[0], compactObject({ user: values.user }))
+    : await client.contentPlan(accountId, positionals[0]);
   if (values.json) return writeJson(context.stdout, payload);
 
+  if (values.report) {
+    context.stdout.write(`${payload.title || "Content plan"}: ${payload.status}\n`);
+    for (const row of payload.content_plan || []) context.stdout.write(`Day ${row.day_number}  ${row.channel}  ${row.title}  ${row.execution?.workflow_phase || "Not started"}\n${row.finalized_content || ""}\n`);
+    return;
+  }
   const week = values.week ? Number.parseInt(values.week, 10) : null;
   let rows = Array.isArray(payload?.rows) ? payload.rows : [];
   if (week) rows = rows.filter((row) => Number(row.week_number) === week);
@@ -3877,6 +3941,47 @@ async function contentShow(args, context, { accountOverride } = {}) {
   renderContentWorkItem(item, context);
 }
 
+async function contentPosts(args, context, { accountOverride } = {}) {
+  const { values, positionals } = parseCommandArgs(args, { ...jsonOptions(), user: { type: "string" }, page: { type: "string" } });
+  if (positionals.length) throw new CommandError(CONTENT_POSTS_USAGE);
+  const { client, accountId } = await requireAccountContext(context, { accountOverride });
+  const payload = await client.contentTrackedPosts(accountId, { ...(values.user ? { user: values.user } : {}), ...(values.page ? { page: values.page } : {}) });
+  if (values.json) return writeJson(context.stdout, payload);
+  for (const post of payload.posts || []) context.stdout.write(`${post.prefix_id}  ${post.status}  ${post.published_at || "Publication time unavailable"}  ${post.url}\n`);
+  if (payload.next_page) context.stdout.write(`More posts: content posts --page ${payload.next_page}\n`);
+}
+
+async function contentTrack(args, context, { accountOverride } = {}) {
+  const { values, positionals } = parseCommandArgs(args, { ...jsonOptions(), user: { type: "string" } });
+  if (positionals.length !== 1) throw new CommandError(CONTENT_TRACK_USAGE);
+  const { client, accountId } = await requireAccountContext(context, { accountOverride });
+  const post = await client.contentTrackPost(accountId, { url: positionals[0], ...(values.user ? { user: values.user } : {}) });
+  if (values.json) return writeJson(context.stdout, post);
+  context.stdout.write(`Tracking ${post.prefix_id}: ${post.status}\n${post.url}\n`);
+}
+
+async function contentEngagement(args, context, { accountOverride } = {}) {
+  const { values, positionals } = parseCommandArgs(args, jsonOptions());
+  if (positionals.length !== 1) throw new CommandError(CONTENT_ENGAGEMENT_USAGE);
+  const { client, accountId } = await requireAccountContext(context, { accountOverride });
+  const post = await client.contentTrackedPost(accountId, positionals[0]);
+  if (values.json) return writeJson(context.stdout, post);
+  context.stdout.write(`${post.title || "LinkedIn post"}: ${post.status}\n${post.url}\n`);
+  if (post.error) context.stdout.write(`Tracking error: ${post.error}\n`);
+  context.stdout.write(`Reposts reported: ${post.repost_count ?? "unavailable"}; reposter identities unavailable\n`);
+  for (const category of ["comments", "reactions"]) {
+    const state = post.categories?.[category] || {};
+    context.stdout.write(`${category}: ${state.status || "pending"}, ${state.collected_count ?? 0} collected\n`);
+    if (state.error) context.stdout.write(`  ${state.error}\n`);
+    for (const engagement of post[category] || []) {
+      const person = engagement.profile || {};
+      context.stdout.write(`  ${person.name || "Unknown person"} | ${person.title || "Title unavailable"} | ${person.company || "Company unavailable"} | ${person.url || "Profile unavailable"}\n`);
+      if (engagement.text) context.stdout.write(`  ${engagement.commented_at || "Time unavailable"}: ${engagement.text}\n`);
+      if (engagement.task?.id) context.stdout.write(`  Reply task: ${engagement.task.id} (${engagement.task.delivery_state || engagement.task.status})\n`);
+    }
+  }
+}
+
 async function contentFeedback(args, context, { accountOverride } = {}) {
   const { values, positionals } = parseCommandArgs(args, {
     ...jsonOptions(),
@@ -10216,6 +10321,9 @@ const HELP_TOPICS = new Map([
     "    audienti content programs",
     "    audienti content plan <cprg_id>",
     "    audienti content show <cpwi_id>",
+    "    audienti content track <linkedin_post_url>",
+    "    audienti content posts",
+    "    audienti content engagement <cpwi_id>",
     "    audienti content feedback <cpwi_id> --message <text>",
     "    audienti content approve <cpwi_id>",
     "    audienti content publish <cpwi_id> --url <permalink>",
@@ -12558,6 +12666,9 @@ const HELP_TOPICS = new Map([
     "  audienti content programs [--user <account_user_id|email|name|me>] [--json]",
     "  audienti content plan <cprg_id> [--week <n>] [--due] [--json]",
     "  audienti content show <cpwi_id> [--json]",
+    "  audienti content track <linkedin_post_url> [--user <account_user_id|email|name|me>] [--json]",
+    "  audienti content posts [--user <account_user_id|email|name|me>] [--json]",
+    "  audienti content engagement <cpwi_id> [--json]",
     "  audienti content feedback <cpwi_id> --message <text> [--json]",
     "  audienti content approve <cpwi_id> [--json]",
     "  audienti content schedule <cpwi_id> --at <time> [--json]",
@@ -12572,7 +12683,13 @@ const HELP_TOPICS = new Map([
 
   ["content programs", [CONTENT_PROGRAMS_USAGE].join("\n")],
   ["content plan", [CONTENT_PLAN_USAGE].join("\n")],
+  ["content plans", CONTENT_PLANS_USAGE],
+  ["content post-reply", CONTENT_POST_REPLY_USAGE],
+  ...["plan-update", "plan-approve", "plan-research", "plan-draft", "plan-visuals"].map((action) => [`content ${action}`, `Usage: audienti content ${action} <rprt_id> --day <n> [--user <id|me>] [--payload <file.json>] [--feedback <text>] [--style <id>] [--aspect-ratio <w:h>] [--json] [--account <acct_id>]`]),
   ["content show", [CONTENT_SHOW_USAGE].join("\n")],
+  ["content posts", [CONTENT_POSTS_USAGE].join("\n")],
+  ["content track", [CONTENT_TRACK_USAGE].join("\n")],
+  ["content engagement", [CONTENT_ENGAGEMENT_USAGE].join("\n")],
   ["content feedback", [CONTENT_FEEDBACK_USAGE].join("\n")],
   ["content approve", [CONTENT_APPROVE_USAGE].join("\n")],
   ["content schedule", [CONTENT_SCHEDULE_USAGE].join("\n")],