@audienti/cli 0.1.116 → 0.1.122

package/CHANGELOG.md

@@ -4,6 +4,42 @@ All notable changes to the Audienti CLI are documented here.
 
 ## [Unreleased]
 
+## [0.1.122] - 2026-10-19
+
+### Added
+
+- Create child accounts with `audienti accounts create --name <name> --parent <name-or-id> [--json]` and the shared API. Parent admins receive access; ambiguous parent names and duplicate child names fail clearly (#2943).
+
+## [0.1.121] - 2026-10-19
+
+### Added
+
+- Add `motions runs` to read account-scoped, paginated discovery history with run purposes, current saved-person outcomes, and blocked-search reasons.
+
+## [0.1.120] - 2026-10-19
+
+### Changed
+
+- Extend the existing `social-cookies activity` command with `--repair-task-id` and `--repair-id` for exact read-only browser repair details from the account-scoped activity API.
+
+## [0.1.119] - 2026-10-18
+
+### Changed
+
+- Extend the operator conversation-reader request and status API contract with bounded retries that retain failure evidence. This release adds no new CLI command.
+
+## [0.1.118] - 2026-10-16
+
+### Changed
+
+- Update the operator conversation-reader request and task-status API contract. This release adds no new CLI command.
+
+## [0.1.117] - 2026-10-12
+
+### Changed
+
+- Quick Start API `linkedin_sign_in` can now return `computer_needed` when LinkedIn requires the person to finish sign-in in their Computer. The `setup_state` read accepts an optional `computer_handoff_cookie_id`; it is used only when it matches the selected owner's current LinkedIn cookie in `approval_needed` state. The CLI does not start a Computer or perform the handoff.
+
 ## [0.1.116] - 2026-10-12
 
 ### Changed

package/README.md

@@ -78,6 +78,7 @@ Authenticate through the browser, then configure the default account context:
 ```bash
 audienti auth login
 audienti accounts list --json
+audienti accounts create --name Doppel --parent OMALab --json
 audienti accounts select <acct_id>
 audienti users list
 audienti users select <account_user_id|email|name|me>
@@ -232,6 +233,7 @@ audienti analytics motions --json
 audienti analytics icps --json
 audienti motions analytics <motn_id>
 audienti motions run-discovery <motn_id>
+audienti motions runs <motn_id> [--cursor <id>] [--limit <1-10>] [--json]
 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
@@ -878,3 +880,5 @@ Copyright (c) 2026 OMALab, Inc. All rights reserved. See [LICENSE](LICENSE).
 
 Batch import accepts up to 50 rows per API request. Split larger files before importing. Row destination IDs or new names override batch defaults; failed rows stay visible in the response.
 Bulk destinations: `audienti prospects set-destination <prsp_id> --type list --destination <list_id>` adds by default. Use `--name "New list"` to create a list, `--type experiment --name "Existing relationships"` to create a transition without setup, or `--mode move` for explicit reassignment. Add preserves existing memberships; experiment Add skips people assigned elsewhere.
+
+Create a child workspace with `audienti accounts create --name <name> --parent <name-or-id> [--json]`. The parent can be a visible name, unique name fragment, numeric ID, or prefixed ID. You must administer a root team account. All parent admins receive access to the child; ordinary members do not. Ambiguous names show matching IDs and stop. A duplicate child name under the same parent fails clearly. The response includes the new account ID. Creation keeps your selected account unchanged: use `audienti accounts select <new_acct_id>` or `--account <new_acct_id>` before creating a motion there.

package/package.json

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

package/skills/audienti/SKILL.md

@@ -111,6 +111,7 @@ context:
 ```bash
 audienti auth login
 audienti accounts list --json
+audienti accounts create --name Doppel --parent OMALab --json
 audienti accounts select <acct_id>
 audienti users select me
 ```
@@ -332,3 +333,5 @@ completed report later.
 - `tools email-find`, `linkedin-enrich`, `signals-find` and `write` return a run id immediately. Pass `--wait --json` to get results in one call, or poll `tools runs show <trun_id>` and read `tools runs results <trun_id>`. Nothing is sent and no prospects or experiments are created.
 - Pass `--request-key <key>` when retrying a submission; the same key and input return the same run.
 - `audienti network list|export` reads only the requester's own connected account's saved network. A 404 means the requester is not that account's owner. Coverage `unsupported_capture` or `not_yet_observed` is not zero.
+
+Create a child workspace with `audienti accounts create --name <name> --parent <name-or-id> [--json]`. The parent can be a visible name, unique name fragment, numeric ID, or prefixed ID. You must administer a root team account. All parent admins receive access to the child; ordinary members do not. Ambiguous names show matching IDs and stop. A duplicate child name under the same parent fails clearly. The response includes the new account ID. Creation keeps your selected account unchanged: use `audienti accounts select <new_acct_id>` or `--account <new_acct_id>` before creating a motion there.

package/src/api-client.js

@@ -40,6 +40,10 @@ export class AudientiClient {
     return this.requestJson("/api/v1/accounts.json");
   }
 
+  createAccount(body) {
+    return this.requestJson("/api/v1/accounts.json", { method: "POST", body });
+  }
+
   account(accountId) {
     return this.requestJson(accountPath(accountId, []));
   }
@@ -813,6 +817,10 @@ export class AudientiClient {
     });
   }
 
+  motionRuns(accountId, motionId, params = {}) {
+    return this.requestJson(accountPath(accountId, ["motions", motionId, "runs"], params));
+  }
+
   motionStatus(accountId, motionId) {
     return this.requestJson(accountPath(accountId, ["motions", motionId, "status"]));
   }

package/src/cli.js

@@ -149,6 +149,7 @@ const PAYMENT_SHOW_USAGE = "Usage: audienti payment show [--json] [--account <ac
 const PAYMENT_CODE_USAGE = "Usage: audienti payment code <signup_code> [--json] [--account <acct_id>]";
 const BRAND_PROFILE_SHOW_USAGE = "Usage: audienti brand-profile show [--json] [--account <acct_id>]";
 const BRAND_PROFILE_UPDATE_USAGE = "Usage: audienti brand-profile update [--voice <text>] [--style <text>] [--do-not-use <text>] [--json] [--account <acct_id>]";
+const ACCOUNTS_CREATE_USAGE = "Usage: audienti accounts create --name <text> --parent <name-or-id> [--json]";
 const ACCOUNTS_SHOW_USAGE = "Usage: audienti accounts show [<acct_id>] [--json] [--account <acct_id>]";
 const LINKEDIN_LOOKUPS_USAGE = "Usage: audienti linkedin-lookups <company-sizes|company-types|functions|industries|job-titles|locations|seniorities> [--query <text>] [--icp <icp_id>] [--json] [--account <acct_id>]";
 const LINKEDIN_LOOKUP_KINDS = new Map([
@@ -368,6 +369,7 @@ async function dispatch(argv, context) {
   if (normalizedResource === "config" && action === "list") return configList(rest, context);
   if (normalizedResource === "update" && action === "check") return updateCheck(rest, context);
   if (normalizedResource === "accounts" && action === "list") return accountsList(rest, context, { accountOverride });
+  if (normalizedResource === "accounts" && action === "create") return accountsCreate(rest, context);
   if (normalizedResource === "accounts" && action === "select") return accountsSelect(rest, context);
   if (normalizedResource === "accounts" && action === "show") return accountsShow(rest, context, { accountOverride });
   if (normalizedResource === "linkedin-lookups") return linkedinLookups(action, rest, context, { accountOverride });
@@ -450,6 +452,7 @@ async function dispatch(argv, context) {
   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 === "runs") return motionsRuns(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 === "profile-signals") return motionsProfileSignals(rest, context, { accountOverride });
@@ -1733,6 +1736,27 @@ async function accountsList(args, context, { accountOverride } = {}) {
   }
 }
 
+async function accountsCreate(args, context) {
+  const { values, positionals } = parseCommandArgs(args, {
+    ...jsonOptions(),
+    name: { type: "string" },
+    parent: { type: "string" }
+  });
+  if (positionals.length || !values.name?.trim() || !values.parent?.trim()) {
+    throw new CommandError(ACCOUNTS_CREATE_USAGE);
+  }
+
+  const config = await requireAuthenticatedConfig(context);
+  const client = clientFromConfig(config, context);
+  const parent = resolveAccountSelection(await client.accounts(), values.parent);
+  if (!parent) throw new CommandError(`Parent account "${values.parent}" does not exist or is not accessible.`);
+  if (!parent.prefix_id) throw new CommandError("Account payload is missing prefix_id.");
+
+  const account = await client.createAccount({ account: { name: values.name, parent_account_id: parent.prefix_id } });
+  if (values.json) return writeJson(context.stdout, account);
+  writeLine(context.stdout, `Created account: ${account.name} (${account.prefix_id})`);
+}
+
 async function accountsShow(args, context, { accountOverride } = {}) {
   const { values, positionals } = parseCommandArgs(args, jsonOptions());
   if (positionals.length > 1) throw new CommandError(ACCOUNTS_SHOW_USAGE);
@@ -1822,12 +1846,14 @@ function resolveAccountSelection(accounts, term) {
 
   const exactPrefix = accounts.find((candidate) => candidate.prefix_id === requested);
   if (exactPrefix) return exactPrefix;
+  const exactId = accounts.find((candidate) => String(candidate.id) === requested);
+  if (exactId) return exactId;
 
   const normalizedRequested = requested.toLowerCase();
-  const exactName = accounts.find((candidate) => String(candidate.name || "").toLowerCase() === normalizedRequested);
-  if (exactName) return exactName;
+  const exactNames = accounts.filter((candidate) => String(candidate.name || "").toLowerCase() === normalizedRequested);
+  if (exactNames.length === 1) return exactNames[0];
 
-  const matches = accounts.filter((candidate) => {
+  const matches = exactNames.length > 1 ? exactNames : accounts.filter((candidate) => {
     const prefixId = String(candidate.prefix_id || "").toLowerCase();
     const name = String(candidate.name || "").toLowerCase();
     return prefixId.includes(normalizedRequested) || name.includes(normalizedRequested);
@@ -3602,6 +3628,25 @@ async function motionsSignals(args, context, { accountOverride } = {}) {
   renderMotionDiscoverySignals(payload, context);
 }
 
+async function motionsRuns(args, context, { accountOverride } = {}) {
+  const { values, positionals } = parseCommandArgs(args, {
+    ...jsonOptions(), cursor: { type: "string" }, limit: { type: "string" }
+  });
+  if (positionals.length !== 1) throw new CommandError("Usage: audienti motions runs <motn_id> [--cursor <id>] [--limit <1-10>] [--json] [--account <acct_id>]");
+  const { client, accountId } = await requireAccountContext(context, { accountOverride });
+  const payload = await client.motionRuns(accountId, positionals[0], compactObject({
+    cursor: normalizeOptionalPositiveInteger(values.cursor, "--cursor"),
+    limit: normalizeOptionalPositiveInteger(values.limit, "--limit")
+  }));
+  if (values.json) return writeJson(context.stdout, payload);
+  for (const row of payload.runs || []) {
+    context.stdout.write(`#${row.id} ${row.purpose}: ${row.status} · ${row.outcome || "outcome unknown"} · seen ${row.seen_count} · submitted ${row.submitted_count} · saved ${row.promoted_count}\n`);
+    if (row.error_message) context.stdout.write(`  ${row.error_message}\n`);
+  }
+  if (!payload.runs?.length) context.stdout.write("No discovery runs on this page.\n");
+  if (payload.has_more) context.stdout.write(`More runs: --cursor ${payload.next_cursor}\n`);
+}
+
 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>]");
@@ -10621,6 +10666,7 @@ const HELP_TOPICS = new Map([
   ["skills list", "Usage:\n  audienti skills list [--json]\n\nList bundled skills and marketplace discovery metadata without network or login."],
   ["skills show", "Usage:\n  audienti skills show <name> [--json]\n\nPrint bundled skill instructions, or upstream source links and host-specific install commands. Read each upstream README for its dependencies. Installation is a separate action."],
   ["tools gift-research", "Usage:\n  audienti tools gift-research --url <website> [--json]\n\nGive the agent the website-gift-research skill and the supplied HTTP(S) URL. The agent browses using its own tools. The CLI does not fetch the website, call Audienti, require login, create gifts or return research results.\n\nRead the skill without a website:\n  audienti skills show audienti-gift-research"],
+  ["motions runs", "Usage:\n  audienti motions runs <motn_id> [--cursor <id>] [--limit <1-10>] [--json] [--account <acct_id>]\n\nList account-scoped discovery runs with read-only pagination."],
   ["", [
     "Usage:",
     "  audienti <command> [options]",
@@ -10657,6 +10703,7 @@ const HELP_TOPICS = new Map([
     "    audienti motions list",
     "    audienti motions show <motn_id>",
     "    audienti motions analytics <motn_id>",
+    "    audienti motions runs <motn_id> [--cursor <id>] [--limit <1-10>] [--json]",
     "    audienti motions run-discovery <motn_id>",
     "    audienti motions quick-start --url <company_url> --confirm --wait",
     "    audienti motions prospects <motn_id>",
@@ -10982,6 +11029,7 @@ const HELP_TOPICS = new Map([
   ["accounts", [
     "Usage:",
     "  audienti accounts list [--json]",
+    `  ${ACCOUNTS_CREATE_USAGE.slice("Usage: ".length)}`,
     "  audienti accounts show [<acct_id>] [--json]",
     "  audienti accounts select <acct_id>",
     "",
@@ -11026,6 +11074,21 @@ const HELP_TOPICS = new Map([
     "  The CLI only requests work; provider traversal remains owned by the server worker."
   ].join("\n")],
 
+  ["accounts create", [
+    "Usage:",
+    `  ${ACCOUNTS_CREATE_USAGE.slice("Usage: ".length)}`,
+    "",
+    "Creates a child under a root team account you administer and copies its admins.",
+    "--parent accepts an accessible account name, unique fragment, numeric ID or prefixed ID.",
+    "Ambiguous names list matching IDs; use an ID to choose. Duplicate child names fail clearly.",
+    "Returns the new account ID. Your selected account does not change.",
+    "Use audienti accounts select <new_acct_id> or --account <new_acct_id> for subsequent commands.",
+    "",
+    "API: POST /api/v1/accounts.json",
+    "",
+    "Example:",
+    "  audienti accounts create --name Doppel --parent OMALab --json"
+  ].join("\n")],
   ["accounts list", [
     "Usage:",
     "  audienti accounts list [--json] [--account <acct_id>]",
@@ -13019,6 +13082,7 @@ const HELP_TOPICS = new Map([
     "  audienti motions show <motn_id> [--json]",
     "  audienti motions signals <motn_id> [--json]",
     "  audienti motions status <motn_id> [--json]",
+    "  audienti motions runs <motn_id> [--cursor <id>] [--limit <1-10>] [--json]",
     "  audienti motions run-discovery <motn_id> [--target-count <n>] [--json]",
     "  audienti motions quick-start --url <company_url> [--confirm] [--wait] [--json]",
     "  audienti motions setup-state [--json]",
@@ -15936,20 +16000,21 @@ const PARITY_ACTION_COMMANDS = new Map([
     done: (_positionals, payload) => describeSocialCookie(payload?.social_cookie)
   }],
   ["social-cookies activity", {
-    usage: "audienti social-cookies activity <scok_id> [--section <actions|status|sync|browser>] [--window <1h|24h|7d|30d>] [--task-type <type>] [--page <n>]",
+    usage: "audienti social-cookies activity <scok_id> [--section <actions|status|sync|browser>] [--window <1h|24h|7d|30d>] [--task-type <type>] [--task-id <id>] [--repair-id <id>] [--page <n>]",
     purpose: "Read a social account's action, sync, and browser activity without changing work.",
     api: "GET /api/v1/accounts/:account_id/social_cookies/:id/activity.json",
     json: true,
     options: {
       section: { type: "string" }, window: { type: "string" }, "task-type": { type: "string" },
       page: { type: "string" }, "per-page": { type: "string" }, "event-id": { type: "string" },
-      "task-id": { type: "string" }, "session-id": { type: "string" }, status: { type: "string" },
+      "task-id": { type: "string" }, "repair-task-id": { type: "string" }, "repair-id": { type: "string" }, "session-id": { type: "string" }, status: { type: "string" },
       "action-type": { type: "string" }, "automation-filter": { type: "string" }, query: { type: "string" },
       "created-from": { type: "string" }, "created-to": { type: "string" }
     },
     run: (client, accountId, [id], values) => client.socialCookieActivity(accountId, id, compactObject({
       section: values.section, window: values.window, task_type: values["task-type"], page: values.page,
       per_page: values["per-page"], event_id: values["event-id"], task_id: values["task-id"],
+      repair_task_id: values["repair-task-id"], repair_id: values["repair-id"],
       session_id: values["session-id"], status: values.status, action_type: values["action-type"],
       automation_filter: values["automation-filter"], query: values.query,
       created_from: values["created-from"], created_to: values["created-to"]