@audienti/cli 0.1.35 → 0.1.36

package/CHANGELOG.md

@@ -4,6 +4,12 @@ All notable changes to the Audienti CLI are documented here.
 
 ## [Unreleased]
 
+## [0.1.36] - 2026-08-22
+
+### Added
+
+- Add `audienti lists routing-rules` commands to inspect, create, update, remove, reorder, and apply the same account-scoped list routing rules available in the UI.
+
 ## [0.1.35] - 2026-08-18
 
 ### Added

package/README.md

@@ -4,7 +4,7 @@ Audienti CLI is the agent-first command-line client for the Audienti production
 API and the local bridge for Audienti's app-hosted MCP endpoint. It lets local
 coding agents and operators inspect accounts,
 create and manage plays, import prospects, build lists, manage task reminders,
-and work supported operator flows.
+configure list routing rules, and work supported operator flows.
 
 ## Install
 
@@ -163,6 +163,8 @@ audienti tasks add --title "Review Cristina" --due 2026-07-24T11:00 --prospect <
 audienti tasks complete <ptsk_id>
 audienti dnc list
 audienti company-rules list
+audienti lists routing-rules <list_id> list
+audienti lists routing-rules <list_id> apply
 audienti users activity --window 7d
 audienti analytics prospects --window 24h
 audienti analytics dashboard --play-tag wine_campaign
@@ -201,6 +203,38 @@ audienti tasks add --title "Review target account" --due 2026-07-24T11:00 --list
 audienti tasks complete <ptsk_id>
 ```
 
+To manage the same ordered rules shown in a list's Routing Rules UI, use a JSON
+payload for create and update operations:
+
+```bash
+audienti lists routing-rules <list_id> list
+audienti lists routing-rules <list_id> create --payload routing-rule.json
+audienti lists routing-rules <list_id> update <rule_id> --payload routing-rule.json
+audienti lists routing-rules <list_id> move <rule_id> up
+audienti lists routing-rules <list_id> remove <rule_id>
+audienti lists routing-rules <list_id> apply
+```
+
+```json
+{
+  "name": "VP prospects to Alice",
+  "enabled": true,
+  "action_kind": "assign_user",
+  "target_account_user_id": "alice@example.com",
+  "conditions": {
+    "seniorities": [
+      {"id": "5", "name": "Vice President", "negative": false}
+    ],
+    "seniority_match_mode": "at_least"
+  }
+}
+```
+
+Use `action_kind: "route_to_list"` with `target_list_id` to route to another
+working list. `apply` queues the existing list-routing background job, just like
+the UI; it reports that work was enqueued, not that every prospect has finished
+routing. Run `audienti lists routing-rules help` for the full condition contract.
+
 To inspect activity for prospects that entered the account during a specific
 cohort while keeping a separate activity window:
 

package/package.json

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

package/skills/audienti/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: audienti
-description: Use when the user wants to operate Audienti through the production CLI or app-hosted MCP endpoint, including account selection, plays, prospect imports, lists, message previews, analytics, or supported operator outcomes.
+description: Use when the user wants to operate Audienti through the production CLI or app-hosted MCP endpoint, including account selection, plays, prospect imports, lists and routing rules, message previews, analytics, or supported operator outcomes.
 ---
 
 # Audienti CLI and MCP
@@ -102,6 +102,10 @@ audienti prospects unlock <prsp_id> --json
 audienti users activity me --window 7d --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
+audienti lists routing-rules <list_id> create --payload routing-rule.json --json
+audienti lists routing-rules <list_id> move <rule_id> up --json
+audienti lists routing-rules <list_id> apply --json
 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
@@ -125,6 +129,12 @@ audienti writer test-run <prsp_id> --mode step --branch no-accept --step 3 --rep
 audienti writer test-run show <prsp_id> <rprt_id>
 ```
 
+List routing-rule create and update commands accept the same normalized
+condition and action data as the list UI. Inspect the ordered rules first, use
+`audienti lists routing-rules help` for the payload contract, and treat `apply`
+as an asynchronous relaunch: it queues the existing routing job and does not
+mean every list member has finished routing.
+
 `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

@@ -268,6 +268,44 @@ export class AudientiClient {
     });
   }
 
+  listRoutingRules(accountId, listId) {
+    return this.requestJson(accountPath(accountId, ["lists", listId, "routing_rules"]));
+  }
+
+  createListRoutingRule(accountId, listId, body) {
+    return this.requestJson(accountPath(accountId, ["lists", listId, "routing_rules"]), {
+      method: "POST",
+      body
+    });
+  }
+
+  updateListRoutingRule(accountId, listId, ruleId, body) {
+    return this.requestJson(accountPath(accountId, ["lists", listId, "routing_rules", ruleId]), {
+      method: "PATCH",
+      body
+    });
+  }
+
+  removeListRoutingRule(accountId, listId, ruleId) {
+    return this.requestJson(accountPath(accountId, ["lists", listId, "routing_rules", ruleId]), {
+      method: "DELETE"
+    });
+  }
+
+  moveListRoutingRule(accountId, listId, ruleId, body) {
+    return this.requestJson(accountPath(accountId, ["lists", listId, "routing_rules", ruleId, "move"]), {
+      method: "PATCH",
+      body
+    });
+  }
+
+  applyListRoutingRules(accountId, listId) {
+    return this.requestJson(accountPath(accountId, ["lists", listId, "routing_rules", "apply"]), {
+      method: "POST",
+      body: {}
+    });
+  }
+
   motions(accountId) {
     return this.requestJson(accountPath(accountId, ["motions"]));
   }

package/src/cli.js

@@ -99,6 +99,12 @@ const ICPS_ADD_TAG_USAGE = "Usage: audienti icps add-tag <icp_id> <tag> [--json]
 const ICPS_REMOVE_TAG_USAGE = "Usage: audienti icps remove-tag <icp_id> <tag> [--json] [--account <acct_id>]";
 const LISTS_ADD_TAG_USAGE = "Usage: audienti lists add-tag <list_id> <tag> [--json] [--account <acct_id>]";
 const LISTS_REMOVE_TAG_USAGE = "Usage: audienti lists remove-tag <list_id> <tag> [--json] [--account <acct_id>]";
+const LIST_ROUTING_RULES_LIST_USAGE = "Usage: audienti lists routing-rules <list_id> list [--json] [--account <acct_id>]";
+const LIST_ROUTING_RULES_CREATE_USAGE = "Usage: audienti lists routing-rules <list_id> create --payload <file.json> [--json] [--account <acct_id>]";
+const LIST_ROUTING_RULES_UPDATE_USAGE = "Usage: audienti lists routing-rules <list_id> update <rule_id> --payload <file.json> [--json] [--account <acct_id>]";
+const LIST_ROUTING_RULES_REMOVE_USAGE = "Usage: audienti lists routing-rules <list_id> remove <rule_id> [--json] [--account <acct_id>]";
+const LIST_ROUTING_RULES_MOVE_USAGE = "Usage: audienti lists routing-rules <list_id> move <rule_id> <up|down> [--json] [--account <acct_id>]";
+const LIST_ROUTING_RULES_APPLY_USAGE = "Usage: audienti lists routing-rules <list_id> apply [--json] [--account <acct_id>]";
 const ANALYTICS_PROSPECTS_USAGE = "Usage: audienti analytics prospects [--window 24h] [--cohort-start YYYY-MM-DD --cohort-end YYYY-MM-DD] [--motion <motn_id>] [--list <list_id>] [--provenance <source>] [--user <account_user_id|email|name|me>] [--json] [--account <acct_id>]";
 const ANALYTICS_PROSPECTS_COHORT_ANALYSIS_USAGE = "Usage: audienti analytics prospects cohort-analysis [--weeks <n>] [--window 24h] [--motion <motn_id>] [--list <list_id>] [--provenance <source>] [--user <account_user_id|email|name|me>] [--json] [--account <acct_id>]";
 const ANALYTICS_USERS_USAGE = "Usage: audienti analytics users [--user <account_user_id|email|name|me>] [--window 30d | --start YYYY-MM-DD --end YYYY-MM-DD] [--cohort-start YYYY-MM-DD --cohort-end YYYY-MM-DD] [--motion <motn_id>] [--list <list_id>] [--provenance <source>] [--platform <linkedin|email|gmail>] [--json] [--account <acct_id>]";
@@ -237,6 +243,7 @@ async function dispatch(argv, context) {
   if (normalizedResource === "lists" && action === "prospects") return listProspects(rest, context, { accountOverride });
   if (normalizedResource === "lists" && action === "add-prospects") return listsAddProspects(rest, context, { accountOverride });
   if (normalizedResource === "lists" && action === "remove-prospects") return listsRemoveProspects(rest, context, { accountOverride });
+  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 === "status") return motionsStatus(rest, context, { accountOverride });
@@ -1491,6 +1498,104 @@ async function listsRemoveProspects(args, context, { accountOverride } = {}) {
   return rejected ? 1 : 0;
 }
 
+async function listsRoutingRules(args, context, { accountOverride } = {}) {
+  const [listId, subaction, ...rest] = args;
+  if (!listId || !subaction) {
+    throw new CommandError("Usage: audienti lists routing-rules <list_id> <list|create|update|remove|move|apply> [args] [--json] [--account <acct_id>]");
+  }
+
+  if (subaction === "list") return listRoutingRulesList(listId, rest, context, { accountOverride });
+  if (subaction === "create") return listRoutingRulesCreate(listId, rest, context, { accountOverride });
+  if (subaction === "update") return listRoutingRulesUpdate(listId, rest, context, { accountOverride });
+  if (["remove", "delete"].includes(subaction)) return listRoutingRulesRemove(listId, rest, context, { accountOverride });
+  if (subaction === "move") return listRoutingRulesMove(listId, rest, context, { accountOverride });
+  if (subaction === "apply") return listRoutingRulesApply(listId, rest, context, { accountOverride });
+
+  throw new CommandError("Usage: audienti lists routing-rules <list_id> <list|create|update|remove|move|apply> [args] [--json] [--account <acct_id>]");
+}
+
+async function listRoutingRulesList(listId, args, context, { accountOverride } = {}) {
+  const { values, positionals } = parseCommandArgs(args, jsonOptions());
+  if (positionals.length > 0) throw new CommandError(LIST_ROUTING_RULES_LIST_USAGE);
+
+  const { client, accountId } = await requireAccountContext(context, { accountOverride });
+  const payload = await client.listRoutingRules(accountId, listId);
+  if (values.json) return writeJson(context.stdout, payload);
+
+  renderListRoutingRules(payload, context);
+}
+
+async function listRoutingRulesCreate(listId, args, context, { accountOverride } = {}) {
+  const { values, positionals } = parseCommandArgs(args, {
+    ...jsonOptions(),
+    payload: {type: "string"}
+  });
+  if (positionals.length > 0 || !values.payload) throw new CommandError(LIST_ROUTING_RULES_CREATE_USAGE);
+
+  const ruleInput = await readJsonPayload(values.payload);
+  const { client, accountId } = await requireAccountContext(context, { accountOverride });
+  const payload = await client.createListRoutingRule(accountId, listId, {routing_rule: ruleInput});
+  if (values.json) return writeJson(context.stdout, payload);
+
+  const rule = payload?.routing_rule;
+  writeLine(context.stdout, `Created routing rule ${display(rule?.name)} (${display(rule?.id)}) on list ${display(payload?.list_id || listId)}.`);
+}
+
+async function listRoutingRulesUpdate(listId, args, context, { accountOverride } = {}) {
+  const { values, positionals } = parseCommandArgs(args, {
+    ...jsonOptions(),
+    payload: {type: "string"}
+  });
+  if (positionals.length !== 1 || !values.payload) throw new CommandError(LIST_ROUTING_RULES_UPDATE_USAGE);
+
+  const ruleInput = await readJsonPayload(values.payload);
+  const { client, accountId } = await requireAccountContext(context, { accountOverride });
+  const payload = await client.updateListRoutingRule(accountId, listId, positionals[0], {routing_rule: ruleInput});
+  if (values.json) return writeJson(context.stdout, payload);
+
+  const rule = payload?.routing_rule;
+  writeLine(context.stdout, `Updated routing rule ${display(rule?.name)} (${display(rule?.id)}) on list ${display(payload?.list_id || listId)}.`);
+}
+
+async function listRoutingRulesRemove(listId, args, context, { accountOverride } = {}) {
+  const { values, positionals } = parseCommandArgs(args, jsonOptions());
+  if (positionals.length !== 1) throw new CommandError(LIST_ROUTING_RULES_REMOVE_USAGE);
+
+  const { client, accountId } = await requireAccountContext(context, { accountOverride });
+  const payload = await client.removeListRoutingRule(accountId, listId, positionals[0]);
+  if (values.json) return writeJson(context.stdout, payload);
+
+  const rule = payload?.routing_rule;
+  writeLine(context.stdout, `Removed routing rule ${display(rule?.name)} (${display(rule?.id || positionals[0])}) from list ${display(listId)}.`);
+}
+
+async function listRoutingRulesMove(listId, args, context, { accountOverride } = {}) {
+  const { values, positionals } = parseCommandArgs(args, jsonOptions());
+  const [ruleId, direction] = positionals;
+  if (positionals.length !== 2 || !["up", "down"].includes(direction)) {
+    throw new CommandError(LIST_ROUTING_RULES_MOVE_USAGE);
+  }
+
+  const { client, accountId } = await requireAccountContext(context, { accountOverride });
+  const payload = await client.moveListRoutingRule(accountId, listId, ruleId, {direction});
+  if (values.json) return writeJson(context.stdout, payload);
+
+  const verb = payload?.moved ? "Moved" : "Could not move";
+  writeLine(context.stdout, `${verb} routing rule ${display(ruleId)} ${direction} on list ${display(payload?.list_id || listId)}.`);
+  renderListRoutingRules(payload, context);
+}
+
+async function listRoutingRulesApply(listId, args, context, { accountOverride } = {}) {
+  const { values, positionals } = parseCommandArgs(args, jsonOptions());
+  if (positionals.length > 0) throw new CommandError(LIST_ROUTING_RULES_APPLY_USAGE);
+
+  const { client, accountId } = await requireAccountContext(context, { accountOverride });
+  const payload = await client.applyListRoutingRules(accountId, listId);
+  if (values.json) return writeJson(context.stdout, payload);
+
+  writeLine(context.stdout, `Routing rules will be applied in the background to list ${display(payload?.list_id || listId)}.`);
+}
+
 async function motionsList(args, context, { accountOverride } = {}) {
   const { values, positionals } = parseCommandArgs(args, {
     ...jsonOptions(),
@@ -4132,6 +4237,30 @@ function renderList(list, context) {
   if (list?.description) writeLine(context.stdout, `Description: ${list.description}`);
 }
 
+function renderListRoutingRules(payload, context) {
+  const rules = Array.isArray(payload?.routing_rules) ? payload.routing_rules : [];
+  if (rules.length === 0) return writeLine(context.stdout, "No routing rules found.");
+
+  writeLine(context.stdout, "RULE ID\tPOSITION\tENABLED\tACTION\tTARGET\tNAME");
+  for (const rule of rules) {
+    writeLine(context.stdout, [
+      display(rule.id),
+      display(rule.position),
+      rule.enabled ? "yes" : "no",
+      display(rule.action_kind),
+      routingRuleTargetLabel(rule),
+      display(rule.name)
+    ].join("\t"));
+  }
+}
+
+function routingRuleTargetLabel(rule) {
+  return rule?.target_account_user?.name ||
+    rule?.target_account_user?.email ||
+    rule?.target_list?.name ||
+    "-";
+}
+
 function renderTags(tags, context) {
   if (!Array.isArray(tags) || tags.length === 0) return writeLine(context.stdout, "No tags found.");
 
@@ -6492,6 +6621,9 @@ const HELP_TOPICS = new Map([
     "    audienti lists prospects <list_id>",
     "    audienti lists add-tag <list_id> <tag>",
     "    audienti lists remove-tag <list_id> <tag>",
+    "    audienti lists routing-rules <list_id> list",
+    "    audienti lists routing-rules <list_id> create --payload <file.json>",
+    "    audienti lists routing-rules <list_id> apply",
     "    audienti tags list",
     "    audienti tags show <tag>",
     "    audienti tasks list [--status open]",
@@ -7472,13 +7604,63 @@ const HELP_TOPICS = new Map([
     "  audienti lists prospects <list_id> [--json]",
     "  audienti lists add-prospects <list_id> <prsp_id> [prsp_id...] [--json]",
     "  audienti lists remove-prospects <list_id> <prsp_id> [prsp_id...] [--json]",
+    "  audienti lists routing-rules <list_id> <list|create|update|remove|move|apply> [args] [--json]",
     "",
-    "Status: read, create, update, delete, and membership commands implemented",
+    "Status: read, create, update, delete, membership, and routing-rule commands implemented",
     "",
     "ID shape:",
     "  list_id: list_ prefix id"
   ].join("\n")],
 
+  ["lists routing-rules", [
+    "Usage:",
+    "  audienti lists routing-rules <list_id> list [--json] [--account <acct_id>]",
+    "  audienti lists routing-rules <list_id> create --payload <file.json> [--json] [--account <acct_id>]",
+    "  audienti lists routing-rules <list_id> update <rule_id> --payload <file.json> [--json] [--account <acct_id>]",
+    "  audienti lists routing-rules <list_id> remove <rule_id> [--json] [--account <acct_id>]",
+    "  audienti lists routing-rules <list_id> move <rule_id> <up|down> [--json] [--account <acct_id>]",
+    "  audienti lists routing-rules <list_id> apply [--json] [--account <acct_id>]",
+    "",
+    "Status: implemented",
+    "",
+    "Purpose:",
+    "  Configure, inspect, reorder, and relaunch the same routing rules available in the list UI.",
+    "  Apply only queues the existing background job; it does not wait for routing to finish.",
+    "",
+    "Payload shape:",
+    "  name: string",
+    "  enabled: boolean | optional",
+    "  position: non-negative integer | optional",
+    "  action_kind: assign_user | route_to_list",
+    "  target_account_user_id: account-user id, email, or me | required for assign_user",
+    "  target_list_id: list_ prefix id or numeric id | required for route_to_list",
+    "  conditions: object | optional",
+    "",
+    "Condition keys:",
+    "  locations, company_locations, seniorities, job_titles, bio_texts,",
+    "  company_sizes, company_types, company_keywords, seniority_match_mode, industry_groups",
+    "",
+    "Example payload file:",
+    "  {",
+    "    \"name\": \"VP prospects to Alice\",",
+    "    \"enabled\": true,",
+    "    \"action_kind\": \"assign_user\",",
+    "    \"target_account_user_id\": \"alice@example.com\",",
+    "    \"conditions\": {",
+    "      \"seniorities\": [{\"id\": \"5\", \"name\": \"Vice President\", \"negative\": false}],",
+    "      \"seniority_match_mode\": \"at_least\"",
+    "    }",
+    "  }",
+    "",
+    "API:",
+    "  GET /api/v1/accounts/:account_id/lists/:list_id/routing_rules.json",
+    "  POST /api/v1/accounts/:account_id/lists/:list_id/routing_rules.json",
+    "  PATCH /api/v1/accounts/:account_id/lists/:list_id/routing_rules/:id.json",
+    "  DELETE /api/v1/accounts/:account_id/lists/:list_id/routing_rules/:id.json",
+    "  PATCH /api/v1/accounts/:account_id/lists/:list_id/routing_rules/:id/move.json",
+    "  POST /api/v1/accounts/:account_id/lists/:list_id/routing_rules/apply.json"
+  ].join("\n")],
+
   ["lists list", [
     "Usage:",
     "  audienti lists list [--tag <tag>] [--json] [--account <acct_id>]",