@audienti/cli 0.1.70 → 0.1.73

package/CHANGELOG.md

@@ -4,6 +4,30 @@ All notable changes to the Audienti CLI are documented here.
 
 ## [Unreleased]
 
+### Added
+
+- Add Motion-owned discovery signal tracking to `motions show` and the `motions signals` command, including attribution holds, source counts, and retained Agent provenance.
+
+## [0.1.73] - 2026-09-26
+
+### Added
+
+- Add the account-scoped `motions signals` command for inspecting Motion-owned Topic and profile signals.
+
+## [0.1.72] - 2026-09-26
+
+### Added
+
+- Add `social-cookies sync-messages` to request account-scoped email syncs with folder and explicit-retry controls, while printing the server's durable sync-slot status.
+
+## [0.1.71] - 2026-09-24
+
+### Changed
+
+- Motion updates now honor the server's durable first-discovery Approach lock: edits remain available before the first accepted discovery launch and are rejected after the lock is set.
+
+- Prospect replan API responses now use the canonical Planner contract for admitted memberships.
+
 ## [0.1.70] - 2026-09-18
 
 ### Added

package/README.md

@@ -161,6 +161,7 @@ audienti content programs
 audienti content plan <cprg_id>
 audienti content approve <cpwi_id>
 audienti content comments
+audienti social-cookies sync-messages <scok_id> [--folder <folder>] [--retry] --json
 audienti prospects show <prsp_id> --json
 audienti prospects list --profiles
 audienti prospects list --assigned-user unassigned
@@ -418,6 +419,12 @@ configuration, current outstanding inventory, any inventory blocker, and current
 invitation capacity calculated by the server. A `null` weekly quota means
 unlimited.
 
+For an email social cookie, `social-cookies sync-messages` requests the shared
+account-scoped cookie/folder sync slot and prints the server's durable status.
+Pass `--folder` to select a provider folder and `--retry` only when an explicit
+retry is intended. The command does not call a provider directly; `--json`
+returns the accepted request and `sync_states` payload unchanged.
+
 Use `users automation` to inspect or change one account user's LinkedIn safety
 policy without changing the saved account selection:
 

package/package.json

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

package/skills/audienti/SKILL.md

@@ -122,6 +122,7 @@ audienti users activity me --window 7d --json
 audienti users automation show <account_user_id|me> --platform linkedin --json --account <acct_id>
 audienti users automation update <account_user_id|me> --payload automation-controls.json --json --account <acct_id>
 audienti users automation update <account_user_id|me> --payload automation-controls.json --apply --json --account <acct_id>
+audienti social-cookies sync-messages <scok_id> [--folder <folder>] [--retry] --json
 audienti prospects import-batch --file prospects.csv --motion <motn_id> --assigned-user me --json
 audienti lists create --name "Target list" --json
 audienti lists routing-rules <list_id> list --json

package/src/api-client.js

@@ -66,6 +66,13 @@ export class AudientiClient {
     return this.requestJson(accountPath(accountId, ["social_cookies"], query));
   }
 
+  syncSocialCookieMessages(accountId, socialCookieId, body = {}) {
+    return this.requestJson(accountPath(accountId, ["social_cookies", socialCookieId, "sync_messages"]), {
+      method: "POST",
+      body
+    });
+  }
+
   userActivity(accountId, userId, query = {}) {
     return this.requestJson(accountPath(accountId, ["operations", "users", userId, "activity"], query));
   }
@@ -339,6 +346,10 @@ export class AudientiClient {
     return this.requestJson(accountPath(accountId, ["motions", motionId]));
   }
 
+  motionSignals(accountId, motionId) {
+    return this.requestJson(accountPath(accountId, ["motions", motionId, "signals"]));
+  }
+
   createMotion(accountId, body) {
     return this.requestJson(accountPath(accountId, ["motions"]), {
       method: "POST",

package/src/cli.js

@@ -176,6 +176,7 @@ const TOOLS_LINKEDIN_REVIEW_USAGE = "Usage: audienti tools linkedin-review --url
 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>]";
 const TOOLS_LINKEDIN_REVIEW_STATUS_USAGE = "Usage: audienti tools linkedin-review status <rprt_id> [--json] [--account <acct_id>]";
+const SOCIAL_COOKIES_SYNC_MESSAGES_USAGE = "Usage: audienti social-cookies sync-messages <scok_id> [--folder <folder>] [--retry] [--json] [--account <acct_id>]";
 const COHORT_STAGE_ORDER = [
   "identified",
   "pre_connect",
@@ -269,6 +270,7 @@ async function dispatch(argv, context) {
   if (normalizedResource === "users" && action === "activity") return usersActivity(rest, context, { accountOverride });
   if (normalizedResource === "users" && action === "automation") return usersAutomation(rest, context, { accountOverride });
   if (normalizedResource === "setup" && action === "play" && rest[0] === "preflight") return setupPlayPreflight(rest.slice(1), context, { accountOverride });
+  if (normalizedResource === "social-cookies" && action === "sync-messages") return socialCookiesSyncMessages(rest, context, { accountOverride });
   if (normalizedResource === "offers" && action === "list") return offersList(rest, context, { accountOverride });
   if (normalizedResource === "offers" && action === "show") return offersShow(rest, context, { accountOverride });
   if (normalizedResource === "offers" && action === "create") return offersCreate(rest, context, { accountOverride });
@@ -311,6 +313,7 @@ async function dispatch(argv, context) {
   if (normalizedResource === "lists" && ["routing-rules", "rules"].includes(action)) return listsRoutingRules(rest, context, { accountOverride });
   if (normalizedResource === "motions" && action === "list") return motionsList(rest, context, { accountOverride });
   if (normalizedResource === "motions" && action === "show") return motionsShow(rest, context, { accountOverride });
+  if (normalizedResource === "motions" && action === "signals") return motionsSignals(rest, context, { accountOverride });
   if (normalizedResource === "motions" && action === "status") return motionsStatus(rest, context, { accountOverride });
   if (normalizedResource === "motions" && ["abm-companies", "company-filters"].includes(action)) return motionsAbmCompanies(rest, context, { accountOverride });
   if (normalizedResource === "motions" && action === "analytics") return motionsAnalytics(rest, context, { accountOverride });
@@ -479,6 +482,7 @@ function normalizeResource(resource) {
   if (resource === "principals") return "users";
   if (resource === "writers") return "writer";
   if (resource === "company_rules" || resource === "company-rules") return "company-rules";
+  if (resource === "social_cookie" || resource === "social_cookies") return "social-cookies";
   return resource === "plays" ? "motions" : resource;
 }
 
@@ -1033,6 +1037,26 @@ async function setupPlayPreflight(args, context, { accountOverride } = {}) {
   renderSetupPlayPreflight(payload, context);
 }
 
+async function socialCookiesSyncMessages(args, context, { accountOverride } = {}) {
+  const { values, positionals } = parseCommandArgs(args, {
+    ...jsonOptions(),
+    folder: { type: "string" },
+    retry: { type: "boolean" }
+  });
+  if (positionals.length !== 1 || (values.folder !== undefined && !String(values.folder).trim())) {
+    throw new CommandError(SOCIAL_COOKIES_SYNC_MESSAGES_USAGE);
+  }
+
+  const { client, accountId } = await requireAccountContext(context, { accountOverride });
+  const payload = await client.syncSocialCookieMessages(accountId, positionals[0], compactObject({
+    folder: values.folder,
+    retry: values.retry ? true : undefined
+  }));
+  if (values.json) return writeJson(context.stdout, payload);
+
+  renderSocialCookieSync(payload, context);
+}
+
 async function offersList(args, context, { accountOverride } = {}) {
   const { values, positionals } = parseCommandArgs(args, jsonOptions());
   if (positionals.length > 0) throw new CommandError("Usage: audienti offers list [--json] [--account <acct_id>]");
@@ -1774,6 +1798,17 @@ async function motionsShow(args, context, { accountOverride } = {}) {
   renderMotion(motion, context);
 }
 
+async function motionsSignals(args, context, { accountOverride } = {}) {
+  const { values, positionals } = parseCommandArgs(args, jsonOptions());
+  if (positionals.length !== 1) throw new CommandError("Usage: audienti motions signals <motn_id> [--json] [--account <acct_id>]");
+
+  const { client, accountId } = await requireAccountContext(context, { accountOverride });
+  const payload = await client.motionSignals(accountId, positionals[0]);
+  if (values.json) return writeJson(context.stdout, payload);
+
+  renderMotionDiscoverySignals(payload, context);
+}
+
 async function motionsStatus(args, context, { accountOverride } = {}) {
   const { values, positionals } = parseCommandArgs(args, jsonOptions());
   if (positionals.length !== 1) throw new CommandError("Usage: audienti motions status <motn_id> [--json] [--account <acct_id>]");
@@ -5441,6 +5476,30 @@ function renderSetupPlayPreflight(payload, context) {
   }
 }
 
+function renderSocialCookieSync(payload, context) {
+  const requestStatus = payload?.requested ? "accepted" : "not requested";
+  const coalesced = payload?.coalesced ? " (coalesced)" : "";
+  writeLine(context.stdout, `Email sync: ${requestStatus}${coalesced} for ${display(payload?.social_cookie_id)}`);
+  if (payload?.reason) writeLine(context.stdout, `Reason: ${payload.reason}`);
+
+  const states = Array.isArray(payload?.sync_states) ? payload.sync_states : [];
+  if (states.length === 0) return writeLine(context.stdout, "No durable sync state returned.");
+
+  writeLine(context.stdout, "FOLDER\tSTATUS\tGENERATION\tATTEMPTS\tDUE\tLAST SUCCESS\tLAST ERROR\tSYNCED THROUGH");
+  for (const state of states) {
+    writeLine(context.stdout, [
+      display(state?.canonical_folder),
+      display(state?.status),
+      display(state?.generation, "0"),
+      display(state?.attempts, "0"),
+      display(state?.due_at),
+      display(state?.last_success_at),
+      display(state?.last_error_code),
+      display(state?.last_synced_through_at)
+    ].join("\t"));
+  }
+}
+
 function renderSetupLinkedInCapabilities(capabilities, context) {
   const storedBoolean = (value) => value === true ? "yes" : value === false ? "no" : "unknown";
   writeLine(
@@ -5833,6 +5892,7 @@ function renderMotion(motion, context) {
   if (Array.isArray(motion?.inbound_channels)) writeLine(context.stdout, `Inbound channels: ${display(motion.inbound_channels.join(", "), "-")}`);
   renderMotionLopaProfiles(motion?.lopa_profiles, context);
   renderMotionSignalRows(motion?.signal_rows, context);
+  renderMotionDiscoverySignals(motion?.discovery_signals, context);
   renderMotionAbmCompanies(motion, context, { showEmpty: false });
   if (Array.isArray(motion?.play_tags)) writeLine(context.stdout, `Tags: ${display(motion.play_tags.join(", "), "-")}`);
   if (motion?.principal_account_user?.id) {
@@ -5867,6 +5927,32 @@ function renderMotionSignalRows(rows, context) {
   }
 }
 
+function renderMotionDiscoverySignals(payload, context) {
+  if (!payload || typeof payload !== "object") return;
+
+  const rows = Array.isArray(payload?.signals) ? payload.signals : [];
+  const counts = payload?.counts || {};
+  const motionId = payload?.prefix_id ? ` (${display(payload.prefix_id)})` : "";
+
+  writeLine(context.stdout, `Motion-owned discovery signals${motionId}: ${display(counts.total, "0")} total, ${display(counts.actionable, "0")} actionable, ${display(counts.pending, "0")} pending, ${display(counts.held, "0")} held`);
+  if (rows.length === 0) return;
+
+  for (const row of rows) {
+    const provenance = Array.isArray(row.agent_provenance)
+      ? row.agent_provenance.map((entry) => [entry.agent_name, entry.agent_id].filter(Boolean).join(" · ")).filter(Boolean).join(", ")
+      : "";
+    const status = row.actionable ? "actionable" : display(row.status, "pending");
+    const sourceCounts = row.source_counts || {};
+    const detail = [
+      row.canonical_url || row.topic?.slug || row.source_key,
+      `sources=${display(sourceCounts.total, "0")}/${display(sourceCounts.accepted, "0")}/${display(sourceCounts.rejected, "0")}`,
+      provenance ? `agents=${provenance}` : null,
+      !row.actionable && row.motion_attribution_reason ? `reason=${singleLine(row.motion_attribution_reason)}` : null
+    ].filter(Boolean).join("; ");
+    writeLine(context.stdout, `- [${status}] ${display(row.type, "signal")}: ${display(row.label, "unnamed")} (${detail})`);
+  }
+}
+
 function renderMotionAbmCompanies(payload, context, { showEmpty = true } = {}) {
   const rows = Array.isArray(payload?.abm_companies) ? payload.abm_companies : [];
   if (rows.length === 0) {
@@ -6054,16 +6140,32 @@ function renderProspectReplan(payload, context) {
   const current = payload?.current || {};
   const replanned = payload?.replanned || {};
   const status = replanStatusLabel(payload);
+  const reason = payload?.reason_code || payload?.refresh?.reason;
 
   writeLine(context.stdout, `Replan ${status} for ${display(prospect.display_name || prospect.name)} (${display(prospect.prefix_id)}).`);
   writeLine(context.stdout, `Changed: ${payload?.changed ? "yes" : "no"}`);
-  if (payload?.reason_code) writeLine(context.stdout, `Reason: ${payload.reason_code}`);
+  if (reason) writeLine(context.stdout, `Reason: ${reason}`);
   writeLine(context.stdout, `Current: ${formatCoachAction(current.next_action)}`);
   writeLine(context.stdout, `Replanned: ${formatCoachAction(replanned.next_action)}`);
   if (replanned.rationale) writeLine(context.stdout, `Rationale: ${replanned.rationale}`);
   if (replanned.guidance) writeLine(context.stdout, `Guidance: ${replanned.guidance}`);
-  if (payload?.status === "dry_run") writeLine(context.stdout, "Run again with --apply to persist this plan.");
-  if (payload?.status === "coach_error") writeLine(context.stdout, "The plan was not persisted. Fix the coach error and rerun with --apply.");
+  if (payload?.status === "dry_run") {
+    writeLine(context.stdout, "Run again with --apply to persist this plan.");
+  } else if (payload?.status === "coach_error") {
+    writeLine(context.stdout, "The plan was not persisted. Fix the coach error and rerun with --apply.");
+  } else if (payload?.status === "pending") {
+    writeLine(context.stdout, "The replan request was recorded but is not applied yet. Retry after the refresh reason clears.");
+  } else if (payload?.status === "busy") {
+    writeLine(context.stdout, "Planner execution is busy. No replan was applied; retry later.");
+  } else if (payload?.status === "failed") {
+    writeLine(context.stdout, "The request was recorded, but the Planner could not apply it. Review the reason before retrying.");
+  } else if (payload?.status === "evaluation_error") {
+    writeLine(context.stdout, "Planner evaluation failed. Fix the evaluation error and rerun with --apply.");
+  } else if (payload?.status === "unsupported_plan_version") {
+    writeLine(context.stdout, "This membership uses an unsupported Planner version. Migrate it before retrying.");
+  } else if (payload?.status === "not_applied") {
+    writeLine(context.stdout, "The plan was not persisted. Review the reason before retrying.");
+  }
 }
 
 function renderProspectReenrich(payload, context) {
@@ -6121,12 +6223,24 @@ function formatObjectCounts(value) {
     .join(", ");
 }
 
+const REPLAN_STATUS_LABELS = Object.freeze({
+  dry_run: "dry run",
+  coach_error: "coach error",
+  not_applied: "not applied",
+  pending: "pending",
+  busy: "busy",
+  failed: "failed",
+  evaluation_error: "evaluation error",
+  unsupported_plan_version: "unsupported plan version"
+});
+
 function replanStatusLabel(payload) {
-  if (payload?.status === "dry_run") return "dry run";
-  if (payload?.status === "coach_error") return "coach error";
-  if (payload?.status === "not_applied") return "not applied";
+  const rawStatus = payload?.status;
+  if (Object.prototype.hasOwnProperty.call(REPLAN_STATUS_LABELS, rawStatus)) {
+    return REPLAN_STATUS_LABELS[rawStatus];
+  }
 
-  return payload?.applied ? "applied" : "dry run";
+  return payload?.applied ? "applied" : "not applied";
 }
 
 function formatCoachAction(nextAction = {}) {
@@ -8305,6 +8419,9 @@ const HELP_TOPICS = new Map([
     "    audienti users automation show <account_user_id|me>",
     "    audienti users automation update <account_user_id|me> --payload <file.json> [--apply]",
     "",
+    "  Email sync",
+    "    audienti social-cookies sync-messages <scok_id> [--folder <folder>] [--retry]",
+    "",
     "  Motions / plays",
     "    audienti motions list",
     "    audienti motions show <motn_id>",
@@ -8616,6 +8733,41 @@ const HELP_TOPICS = new Map([
     "  acct_id: string  Account prefix id, for example acct_abc123"
   ].join("\n")],
 
+  ["social-cookies", [
+    "Usage:",
+    "  audienti social-cookies sync-messages <scok_id> [--folder <folder>] [--retry] [--json] [--account <acct_id>]",
+    "",
+    "Status: implemented",
+    "",
+    "Commands:",
+    "  audienti social-cookies sync-messages  Request the shared durable email sync slot",
+    "",
+    "Run `audienti social-cookies sync-messages help` for the request and output contract."
+  ].join("\n")],
+
+  ["social-cookies sync-messages", [
+    "Usage:",
+    "  audienti social-cookies sync-messages <scok_id> [--folder <folder>] [--retry] [--json] [--account <acct_id>]",
+    "",
+    "Status: implemented",
+    "",
+    "Purpose:",
+    "  Request one account-scoped email sync through the server's durable cookie/folder slot.",
+    "",
+    "Input shape:",
+    "  scok_id: string  Social cookie prefix id or numeric id",
+    "  folder: string   Provider folder; omitted means the server's INBOX default",
+    "  retry: flag       Explicitly reopen an exhausted or credential-held slot",
+    "",
+    "Output shape:",
+    "  requested, coalesced, reason, sync_states  Server response and durable slot status",
+    "  sync_states      Includes status, generation, attempts, due, last error, and watermark",
+    "",
+    "API:",
+    "  POST /api/v1/accounts/:account_id/social_cookies/:id/sync_messages.json",
+    "  The CLI only requests work; provider traversal remains owned by the server worker."
+  ].join("\n")],
+
   ["accounts list", [
     "Usage:",
     "  audienti accounts list [--json] [--account <acct_id>]",
@@ -9774,6 +9926,7 @@ const HELP_TOPICS = new Map([
     "Usage:",
     "  audienti motions list [--tag <tag>] [--json]",
     "  audienti motions show <motn_id> [--json]",
+    "  audienti motions signals <motn_id> [--json]",
     "  audienti motions status <motn_id> [--json]",
     "  audienti motions run-discovery <motn_id> [--target-count <n>] [--json]",
     "  audienti motions quick-start --url <company_url> [--confirm] [--wait] [--json]",
@@ -9869,12 +10022,30 @@ const HELP_TOPICS = new Map([
     "  inbound_channels: enabled inbound collectors for inbound motions",
     "  lopa_profiles[]: tracked LinkedIn profile rows for LOPA motions",
     "  signal_rows[]: outbound signal configuration rows",
+    "  discovery_signals: Motion-owned Topic/profile signals with attribution state and Agent provenance",
     "  abm_companies[]: motion-scoped positive company filter rows",
     "",
     "API:",
     "  GET /api/v1/accounts/:account_id/motions/:id.json"
   ].join("\n")],
 
+  ["motions signals", [
+    "Usage:",
+    "  audienti motions signals <motn_id> [--json] [--account <acct_id>]",
+    "",
+    "Status: implemented",
+    "",
+    "Purpose:",
+    "  Read the Topic and tracked-profile signals owned by one Motion.",
+    "  Actionable rows have exact Motion attribution; pending and held rows remain inspectable with their reason and evidence.",
+    "",
+    "Output:",
+    "  Shows attribution state, canonical source URL or Topic, accepted/rejected source counts, and retained Agent provenance.",
+    "",
+    "API:",
+    "  GET /api/v1/accounts/:account_id/motions/:id/signals.json"
+  ].join("\n")],
+
   ["motions abm-companies", [
     "Usage:",
     `  ${MOTIONS_ABM_COMPANIES_LIST_USAGE.slice("Usage: ".length)}`,