@audienti/cli 0.1.75 → 0.1.77

package/src/cli.js

@@ -22,6 +22,12 @@ const API_MAX_LIST_LIMIT = 100;
 const DEFAULT_LOOKUP_TIMEOUT_SECONDS = 60;
 const DEFAULT_LOOKUP_POLL_INTERVAL_SECONDS = 2;
 const DEFAULT_AUTH_LOGIN_TIMEOUT_SECONDS = 180;
+// Start covers signup plus email confirmation, which takes longer than a sign-in.
+const DEFAULT_START_LOGIN_TIMEOUT_SECONDS = 900;
+const DEFAULT_SETUP_TIMEOUT_SECONDS = 300;
+const START_USAGE = "Usage: audienti start [--host https://app.audienti.com] [--no-open] [--json]";
+const SETUP_USAGE = "Usage: audienti setup [--url <company_url>] [--sell-to <who you sell to>] [--ask <what the prospect says yes to>] [--yes] [--json]";
+const SETUP_FLAGS_EXAMPLE = "audienti setup --url https://acme.com --sell-to \"<who you sell to>\" --ask \"<what they say yes to>\" --yes";
 const DEFAULT_WRITER_TEST_RUN_TIMEOUT_SECONDS = 180;
 const DEFAULT_WRITER_TEST_RUN_POLL_INTERVAL_SECONDS = 2;
 const PACKAGE_NAME = "@audienti/cli";
@@ -207,6 +213,21 @@ 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 TOOLS_LINKEDIN_STRATEGY_REVIEW_DELETE_USAGE = "Usage: audienti tools linkedin-strategy-review delete <rprt_id> --confirm <yes|true|Y|y> [--json] [--account <acct_id>]";
+const LISTS_BULK_ADD_TAG_USAGE = "Usage: audienti lists bulk-add-tag --tag <tag> <list_id> [list_id...] [--json] [--account <acct_id>]";
+const LISTS_MERGE_USAGE = "Usage: audienti lists merge <list_id> <list_id> [--json] [--account <acct_id>]";
+const LISTS_EXPORT_USAGE = "Usage: audienti lists export <list_id> [--output <file.csv>] [--inactive-reason <reason>] [--json] [--account <acct_id>]";
+const LIST_ROUTING_RULES_TOGGLE_USAGE = "Usage: audienti lists routing-rules <list_id> toggle <rule_id> [--json] [--account <acct_id>]";
+const ICPS_BULK_ADD_TAG_USAGE = "Usage: audienti icps bulk-add-tag --tag <tag> <icp_id> [icp_id...] [--json] [--account <acct_id>]";
+const ICPS_CLONE_USAGE = "Usage: audienti icps clone <icp_id> [--json] [--account <acct_id>]";
+const ICPS_DELETE_USAGE = "Usage: audienti icps delete <icp_id> --confirm <yes|true|Y|y> [--json] [--account <acct_id>]";
+const ICPS_PROSPECTS_USAGE = "Usage: audienti icps prospects <icp_id> [--query <text>] [--limit <n>] [--offset <n> | --page <n>] [--profiles] [--json] [--account <acct_id>]";
+const OFFERS_REGENERATE_RESEARCH_USAGE = "Usage: audienti offers regenerate-research <offr_id> [--guidance <text>] [--json] [--account <acct_id>]";
+const OFFERS_UPDATE_WRITEUP_USAGE = "Usage: audienti offers update-writeup <offr_id> --description <text> [--json] [--account <acct_id>]";
+const OFFERS_ADD_ARTIFACTS_USAGE = "Usage: audienti offers add-artifacts <offr_id> <file> [file...] [--json] [--account <acct_id>]";
+const OFFERS_REMOVE_ARTIFACT_USAGE = "Usage: audienti offers remove-artifact <offr_id> <artifact_id> [--json] [--account <acct_id>]";
+const TASKS_UPDATE_USAGE = "Usage: audienti tasks update <ptsk_id> [--title <text>] [--due <time>] [--notes <text>] [--prospect <prsp_id|\"\">] [--list <list_id|\"\">] [--assigned-user <id|me>] [--json] [--account <acct_id>]";
+const TASKS_BULK_UPDATE_USAGE = "Usage: audienti tasks bulk-update --action <complete|reassign> [--assigned-user <id|me>] <ptsk_id> [ptsk_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",
@@ -272,6 +293,7 @@ export async function run(argv = process.argv.slice(2), deps = {}) {
 
 async function dispatch(argv, context) {
   const { args, accountOverride } = extractGlobalOptions(argv);
+  if (args.length === 0 && !(await readConfig({ env: context.env })).token) return start([], context);
   const helpTopic = helpTopicFromArgs(args);
 
   if (helpTopic) {
@@ -302,6 +324,8 @@ async function dispatch(argv, context) {
   if (normalizedResource === "users" && action === "select") return usersSelect(rest, context, { accountOverride });
   if (normalizedResource === "users" && action === "activity") return usersActivity(rest, context, { accountOverride });
   if (normalizedResource === "users" && action === "automation") return usersAutomation(rest, context, { accountOverride });
+  if (normalizedResource === "start") return start(args.slice(1), context);
+  if (normalizedResource === "setup" && (action === undefined || action.startsWith("--"))) return setupWizard(args.slice(1), 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 });
@@ -309,6 +333,10 @@ async function dispatch(argv, context) {
   if (normalizedResource === "offers" && action === "create") return offersCreate(rest, context, { accountOverride });
   if (normalizedResource === "offers" && action === "update") return offersUpdate(rest, context, { accountOverride });
   if (normalizedResource === "offers" && action === "delete") return offersDelete(rest, context, { accountOverride });
+  if (normalizedResource === "offers" && action === "regenerate-research") return offersRegenerateResearch(rest, context, { accountOverride });
+  if (normalizedResource === "offers" && action === "update-writeup") return offersUpdateWriteup(rest, context, { accountOverride });
+  if (normalizedResource === "offers" && action === "add-artifacts") return offersAddArtifacts(rest, context, { accountOverride });
+  if (normalizedResource === "offers" && action === "remove-artifact") return offersRemoveArtifact(rest, context, { accountOverride });
   if (normalizedResource === "icps" && action === "list") return icpsList(rest, context, { accountOverride });
   if (normalizedResource === "icps" && action === "show") return icpsShow(rest, context, { accountOverride });
   if (normalizedResource === "icps" && action === "analytics") return analyticsIcps(rest, context, { accountOverride });
@@ -318,6 +346,10 @@ async function dispatch(argv, context) {
   if (normalizedResource === "icps" && action === "restore") return icpsLifecycleMutation("restore", rest, context, { accountOverride });
   if (normalizedResource === "icps" && action === "add-tag") return icpsTagMutation("add", rest, context, { accountOverride });
   if (normalizedResource === "icps" && action === "remove-tag") return icpsTagMutation("remove", rest, context, { accountOverride });
+  if (normalizedResource === "icps" && action === "bulk-add-tag") return icpsBulkAddTag(rest, context, { accountOverride });
+  if (normalizedResource === "icps" && action === "clone") return icpsClone(rest, context, { accountOverride });
+  if (normalizedResource === "icps" && action === "delete") return icpsDelete(rest, context, { accountOverride });
+  if (normalizedResource === "icps" && action === "prospects") return icpsProspects(rest, context, { accountOverride });
   if (normalizedResource === "companies" && action === "search") return companiesSearch(rest, context, { accountOverride });
   if (normalizedResource === "dnc" && action === "list") return dncList(rest, context, { accountOverride });
   if (normalizedResource === "dnc" && action === "add") return dncAdd(rest, context, { accountOverride });
@@ -339,6 +371,8 @@ async function dispatch(argv, context) {
   if (normalizedResource === "tasks" && ["list", "manage"].includes(action)) return tasksList(rest, context, { accountOverride });
   if (normalizedResource === "tasks" && action === "add") return tasksAdd(rest, context, { accountOverride });
   if (normalizedResource === "tasks" && action === "complete") return tasksComplete(rest, context, { accountOverride });
+  if (normalizedResource === "tasks" && action === "update") return tasksUpdate(rest, context, { accountOverride });
+  if (normalizedResource === "tasks" && action === "bulk-update") return tasksBulkUpdate(rest, context, { accountOverride });
   if (normalizedResource === "lists" && action === "list") return listsList(rest, context, { accountOverride });
   if (normalizedResource === "lists" && action === "create") return listsCreate(rest, context, { accountOverride });
   if (normalizedResource === "lists" && action === "show") return listsShow(rest, context, { accountOverride });
@@ -346,6 +380,9 @@ async function dispatch(argv, context) {
   if (normalizedResource === "lists" && action === "add-tag") return listsTagMutation("add", rest, context, { accountOverride });
   if (normalizedResource === "lists" && action === "remove-tag") return listsTagMutation("remove", rest, context, { accountOverride });
   if (normalizedResource === "lists" && action === "delete") return listsDelete(rest, context, { accountOverride });
+  if (normalizedResource === "lists" && action === "bulk-add-tag") return listsBulkAddTag(rest, context, { accountOverride });
+  if (normalizedResource === "lists" && action === "merge") return listsMerge(rest, context, { accountOverride });
+  if (normalizedResource === "lists" && action === "export") return listsExport(rest, context, { accountOverride });
   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 });
@@ -409,6 +446,7 @@ async function dispatch(argv, 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 === "tools" && action === "linkedin-strategy-review") return toolsLinkedinStrategyReview(rest, context, { accountOverride });
   if (normalizedResource === "operator" && action === "failed-drafts") return operatorFailedDrafts(rest, context, { accountOverride });
   if (normalizedResource === "operator" && action === "queue") return operatorQueue(rest, context, { accountOverride });
   if (normalizedResource === "operator" && action === "next") return operatorNext(rest, context, { accountOverride });
@@ -567,25 +605,50 @@ async function authLogin(args, context) {
 
   const host = normalizeHost(values.host || DEFAULT_HOST);
   const timeoutSeconds = normalizeOptionalPositiveInteger(values["timeout-seconds"], "--timeout-seconds") || DEFAULT_AUTH_LOGIN_TIMEOUT_SECONDS;
+  const { client, user, payload } = await browserSignIn({
+    host,
+    timeoutSeconds,
+    open: !values["no-open"],
+    context,
+    announce(authUrl, callbackUrl) {
+      if (values.json) {
+        writeJson(context.stdout, {
+          kind: "auth_login_start",
+          auth_url: authUrl,
+          callback_url: callbackUrl,
+          timeout_seconds: timeoutSeconds
+        });
+      } else {
+        writeLine(context.stdout, "Open this URL to authenticate Audienti CLI:");
+        writeLine(context.stdout, authUrl);
+      }
+    }
+  });
+
+  const result = {
+    kind: "auth_login_complete",
+    host: client.host,
+    user: user?.name || payload.user_name || payload.user_email || user?.email || null,
+    account_id: payload.account_id || null,
+    account_name: payload.account_name || null
+  };
+
+  if (values.json) return writeJson(context.stdout, result);
+
+  writeLine(context.stdout, `Authenticated to ${client.host} as ${result.user || "current user"}.`);
+  if (result.account_id) writeLine(context.stdout, `Selected account ${result.account_name || result.account_id} (${result.account_id}).`);
+  if (!result.account_id) writeLine(context.stdout, "Run `audienti accounts list` to choose an account.");
+}
+
+async function browserSignIn({ host, timeoutSeconds, open, context, announce }) {
   const state = randomBytes(24).toString("hex");
   const callback = await createAuthCallbackServer({ state, context });
   const authUrl = new URL("/cli/auth", host);
   authUrl.searchParams.set("redirect_uri", callback.redirectUri);
   authUrl.searchParams.set("state", state);
 
-  if (values.json) {
-    writeJson(context.stdout, {
-      kind: "auth_login_start",
-      auth_url: authUrl.toString(),
-      callback_url: callback.redirectUri,
-      timeout_seconds: timeoutSeconds
-    });
-  } else {
-    writeLine(context.stdout, "Open this URL to authenticate Audienti CLI:");
-    writeLine(context.stdout, authUrl.toString());
-  }
-
-  if (!values["no-open"]) openBrowser(authUrl.toString(), context);
+  announce(authUrl.toString(), callback.redirectUri);
+  if (open) openBrowser(authUrl.toString(), context);
 
   let payload;
   try {
@@ -603,19 +666,473 @@ async function authLogin(args, context) {
     accountName: payload.account_name || undefined
   }, { env: context.env });
 
-  const result = {
-    kind: "auth_login_complete",
-    host: client.host,
-    user: user?.name || payload.user_name || payload.user_email || user?.email || null,
-    account_id: payload.account_id || null,
-    account_name: payload.account_name || null
+  return { client, user, payload };
+}
+
+async function start(args, context) {
+  const { values, positionals } = parseCommandArgs(args, {
+    ...jsonOptions(),
+    host: { type: "string" },
+    "no-open": { type: "boolean" }
+  });
+  if (positionals.length > 0) throw new CommandError(START_USAGE);
+
+  const interactive = stdinIsInteractive(context) && !values.json;
+  const say = (line = "") => {
+    if (!values.json) writeLine(context.stdout, line);
   };
+  let config = await readConfig({ env: context.env });
+  const host = normalizeHost(values.host || config.host || DEFAULT_HOST);
+
+  say("Welcome to Audienti.");
+  say("Audienti finds the people who fit your business, spots when they're ready to talk, and drafts the outreach.");
+  say("Nothing sends without your approval.");
+  say();
+
+  let session = await savedSession(config, context);
+  if (!session && !interactive) {
+    const payload = {
+      kind: "start",
+      status: "sign_in_required",
+      signed_in: false,
+      host,
+      sign_up_url: new URL("/users/sign_up", host).toString(),
+      sign_in_command: "audienti auth login",
+      next_command: "audienti start"
+    };
+    if (values.json) return writeJson(context.stdout, payload);
 
-  if (values.json) return writeJson(context.stdout, result);
+    say("Sign in or create an account to continue.");
+    say(`  New here? Create an account at ${payload.sign_up_url}`);
+    say("  Then run `audienti auth login` in a terminal (it opens your browser),");
+    say("  or save an API token with `audienti auth token <token>`.");
+    say("Next: run `audienti start` again.");
+    return 0;
+  }
 
-  writeLine(context.stdout, `Authenticated to ${client.host} as ${result.user || "current user"}.`);
-  if (result.account_id) writeLine(context.stdout, `Selected account ${result.account_name || result.account_id} (${result.account_id}).`);
-  if (!result.account_id) writeLine(context.stdout, "Run `audienti accounts list` to choose an account.");
+  const prompter = createPrompter(context);
+  try {
+    if (session) {
+      say(`You're signed in as ${session.label}.`);
+    } else {
+      say("First, sign in or create an account.");
+      const { client, user, payload } = await browserSignIn({
+        host,
+        timeoutSeconds: DEFAULT_START_LOGIN_TIMEOUT_SECONDS,
+        open: !values["no-open"],
+        context,
+        announce(authUrl) {
+          say("We'll open Audienti in your browser. New here? Choose \"sign up for an account\" on that page.");
+          say("If the browser doesn't open, visit:");
+          say(`  ${authUrl}`);
+          say("Waiting for you to finish in the browser (confirm your email if asked)...");
+        }
+      });
+      config = await readConfig({ env: context.env });
+      session = { client, label: user?.name || payload.user_name || user?.email || payload.user_email || "you" };
+      say(`Signed in as ${session.label}.`);
+    }
+
+    const account = await chooseStartAccount(session.client, config, { interactive, prompter, say });
+    const accountUser = account ? await chooseStartAccountUser(session.client, account, { interactive, prompter, say }) : null;
+    if (account) {
+      const sameAccount = account.prefix_id === config.accountId;
+      await writeConfig({
+        ...config,
+        accountId: account.prefix_id,
+        accountName: account.name,
+        accountUserId: accountUser ? String(accountUser.id) : sameAccount ? config.accountUserId : undefined,
+        accountUserName: accountUser ? accountUser.name : sameAccount ? config.accountUserName : undefined,
+        accountUserEmail: accountUser ? accountUser.email : sameAccount ? config.accountUserEmail : undefined
+      }, { env: context.env });
+    }
+
+    const status = !account ? "account_selection_required" : !accountUser ? "account_user_selection_required" : "ready";
+    const nextCommand = status === "account_selection_required"
+      ? "audienti accounts select <acct_id>"
+      : status === "account_user_selection_required"
+        ? "audienti users select <account_user_id|email|name|me>"
+        : interactive ? "audienti setup" : SETUP_FLAGS_EXAMPLE;
+
+    if (values.json) {
+      return writeJson(context.stdout, {
+        kind: "start",
+        status,
+        signed_in: true,
+        host: session.client.host,
+        user: session.label,
+        account: account ? { id: account.prefix_id, name: account.name } : null,
+        account_user: accountUser ? { id: accountUser.id, name: accountUser.name || null, email: accountUser.email || null } : null,
+        next_command: nextCommand
+      });
+    }
+
+    if (status !== "ready" || !interactive) {
+      say(`Next: ${nextCommand}`);
+      return 0;
+    }
+
+    say();
+    if (await askYesNo(prompter, "Set up your first motion now? [Y/n] ", { defaultYes: true })) {
+      say();
+      return setupWizard([], context, { prompter });
+    }
+
+    say("No problem. When you're ready, run: audienti setup");
+    return 0;
+  } finally {
+    prompter.close();
+  }
+}
+
+async function savedSession(config, context) {
+  if (!config.token) return null;
+
+  const client = clientFromConfig(config, context);
+  try {
+    const user = await client.me();
+    return { client, label: user?.name || user?.email || "you" };
+  } catch (error) {
+    if (error instanceof ApiError && error.status === 401) return null;
+    throw error;
+  }
+}
+
+async function chooseStartAccount(client, config, { interactive, prompter, say }) {
+  const accounts = await client.accounts();
+  if (!Array.isArray(accounts) || accounts.length === 0) {
+    throw new CommandError("This login has no Audienti account yet. Finish creating one in the browser, then run `audienti start` again.");
+  }
+
+  const saved = accounts.find((account) => account.prefix_id === config.accountId);
+  if (accounts.length === 1) {
+    say(`Using account ${accounts[0].name} (${accounts[0].prefix_id}).`);
+    return accounts[0];
+  }
+
+  if (!interactive) {
+    if (saved) {
+      say(`Using account ${saved.name} (${saved.prefix_id}).`);
+      return saved;
+    }
+    say("You have several accounts:");
+    for (const account of accounts) say(`  ${account.prefix_id}\t${account.name}`);
+    return null;
+  }
+
+  say("Which account should the CLI use?");
+  accounts.forEach((account, index) => {
+    say(`  ${index + 1}. ${account.name} (${account.prefix_id})${account === saved ? " - current" : ""}`);
+  });
+  const defaultIndex = saved ? accounts.indexOf(saved) + 1 : null;
+  const account = await askChoice(prompter, accounts, {
+    question: defaultIndex ? `Account [${defaultIndex}]: ` : "Account: ",
+    defaultChoice: saved,
+    resolve: (answer) => resolveAccountSelection(accounts, answer)
+  });
+  say(`Using account ${account.name} (${account.prefix_id}).`);
+  return account;
+}
+
+async function chooseStartAccountUser(client, account, { interactive, prompter, say }) {
+  const users = await client.users(account.prefix_id);
+  const rows = Array.isArray(users) ? users : [];
+  const currentUsers = rows.filter((candidate) => candidate.current);
+  const automatic = currentUsers.length === 1 ? currentUsers[0] : rows.length === 1 ? rows[0] : null;
+  if (automatic) {
+    say(`Working as ${accountUserLabel(automatic)}.`);
+    return automatic;
+  }
+
+  if (!interactive || rows.length === 0) {
+    say("Pick which account user you are:");
+    for (const accountUser of rows) say(`  ${accountUserLabel(accountUser)}`);
+    return null;
+  }
+
+  say("Which account user are you?");
+  rows.forEach((accountUser, index) => say(`  ${index + 1}. ${accountUserLabel(accountUser)}`));
+  const accountUser = await askChoice(prompter, rows, {
+    question: "Account user: ",
+    resolve: (answer) => resolveAccountUserSelection(rows, answer)
+  });
+  say(`Working as ${accountUserLabel(accountUser)}.`);
+  return accountUser;
+}
+
+async function askChoice(prompter, choices, { question, defaultChoice = null, resolve }) {
+  for (;;) {
+    const answer = await prompter.ask(question);
+    if (!answer && defaultChoice) return defaultChoice;
+
+    const number = Number(answer);
+    if (Number.isInteger(number) && number >= 1 && number <= choices.length) return choices[number - 1];
+
+    try {
+      const match = answer ? resolve(answer) : null;
+      if (match) return match;
+    } catch (error) {
+      if (!(error instanceof CommandError)) throw error;
+    }
+    prompter.say(`Type a number from 1 to ${choices.length}.`);
+  }
+}
+
+async function askYesNo(prompter, question, { defaultYes = false } = {}) {
+  for (;;) {
+    const answer = (await prompter.ask(question)).toLowerCase();
+    if (!answer) return defaultYes;
+    if (/^y(es)?$/.test(answer)) return true;
+    if (/^no?$/.test(answer)) return false;
+    prompter.say("Please answer y or n.");
+  }
+}
+
+function stdinIsInteractive(context) {
+  return Boolean(context.stdin && context.stdin.isTTY);
+}
+
+// One line reader per command run. The async iterator buffers lines typed
+// ahead of a question, so several questions can share one input stream.
+function createPrompter(context) {
+  let reader;
+  let lines;
+
+  return {
+    async ask(question) {
+      if (!lines) {
+        reader = createInterface({ input: context.stdin, terminal: false });
+        lines = reader[Symbol.asyncIterator]();
+      }
+      context.stdout.write(question);
+      const { value, done } = await lines.next();
+      if (done) throw new CommandError("Input ended before the questions were answered. Run the command again when you're ready.");
+      return String(value).trim();
+    },
+    say(line = "") {
+      writeLine(context.stdout, line);
+    },
+    close() {
+      reader?.close();
+    }
+  };
+}
+
+const SETUP_QUESTIONS = [
+  {
+    key: "url",
+    title: "What's your company website?",
+    good: "https://acme.com",
+    bad: "acme (not a full web address)",
+    skip: "Press Enter to use the website saved on your account."
+  },
+  {
+    key: "sell-to",
+    title: "Who do you sell to? One sentence.",
+    good: "Heads of finance at US software companies with 50-500 people.",
+    bad: "Everyone who could use our product.",
+    skip: "Press Enter to skip."
+  },
+  {
+    key: "ask",
+    title: "What do you want the prospect to say yes to?",
+    good: "A 20-minute call to see if our audit fits their month-end close.",
+    bad: "Buy now.",
+    skip: "Press Enter to skip."
+  }
+];
+
+async function setupWizard(args, context, { accountOverride, prompter: sharedPrompter } = {}) {
+  const { values, positionals } = parseCommandArgs(args, {
+    ...jsonOptions(),
+    url: { type: "string" },
+    "sell-to": { type: "string" },
+    ask: { type: "string" },
+    yes: { type: "boolean" }
+  });
+  if (positionals.length > 0) throw new CommandError(SETUP_USAGE);
+
+  const interactive = stdinIsInteractive(context) && !values.json;
+  const say = (line = "") => {
+    if (!values.json) writeLine(context.stdout, line);
+  };
+
+  if (!interactive && !values.url) {
+    throw new CommandError([
+      "No terminal is attached, so `audienti setup` can't ask questions.",
+      "Pass the answers as flags instead:",
+      `  ${SETUP_FLAGS_EXAMPLE}`,
+      SETUP_USAGE
+    ].join("\n"));
+  }
+
+  const config = await readConfig({ env: context.env });
+  if (!config.token) {
+    throw new CommandError("You're not signed in yet. Run `audienti start` to sign in or create an account, then run `audienti setup`.");
+  }
+  const accountId = accountOverride || config.accountId;
+  if (!accountId) {
+    throw new CommandError("No account is picked yet. Run `audienti start` to choose one, then run `audienti setup`.");
+  }
+  const client = clientFromConfig(config, context);
+  const prompter = sharedPrompter || createPrompter(context);
+
+  try {
+    const answers = { url: values.url, "sell-to": values["sell-to"], ask: values.ask };
+    if (interactive) {
+      say("Let's set up your first motion. Three quick questions.");
+      for (const [index, question] of SETUP_QUESTIONS.entries()) {
+        if (answers[question.key] !== undefined) continue;
+
+        say();
+        say(`${index + 1}/${SETUP_QUESTIONS.length}  ${question.title}`);
+        say(`     Good: ${question.good}`);
+        say(`     Bad:  ${question.bad}`);
+        say(`     ${question.skip}`);
+        answers[question.key] = await prompter.ask("> ");
+      }
+      say();
+    }
+
+    const sellTo = cleanSentence(answers["sell-to"]);
+    const ask = cleanSentence(answers.ask);
+    const requestBody = {
+      quick_start: compactObject({
+        company_url: String(answers.url || "").trim() || undefined,
+        feedback: setupFeedback({ sellTo, ask })
+      })
+    };
+
+    say("Reading your website and drafting your first motion. This usually takes a minute or two.");
+    let draft;
+    try {
+      draft = await client.createQuickStart(accountId, requestBody);
+    } catch (error) {
+      throw setupCreateError(error);
+    }
+
+    let polls = 0;
+    draft = await waitForQuickStartDraft(client, accountId, draft, context, {
+      timeoutSeconds: DEFAULT_SETUP_TIMEOUT_SECONDS,
+      pollIntervalSeconds: DEFAULT_LOOKUP_POLL_INTERVAL_SECONDS,
+      onPoll() {
+        polls += 1;
+        if (polls % 5 === 1) say(SETUP_PROGRESS[Math.min(Math.floor(polls / 5), SETUP_PROGRESS.length - 1)]);
+      }
+    });
+
+    if (draft?.status === "failed") throw setupDraftFailedError(draft?.error);
+    if (!quickStartReady(draft)) {
+      throw new CommandError("The draft is taking longer than usual. Nothing was created. Run `audienti setup` again in a few minutes.");
+    }
+
+    renderSetupDraft(draft, { ask }, say);
+
+    let confirmed = Boolean(values.yes);
+    if (!confirmed && interactive) confirmed = await askYesNo(prompter, "Create this? [y/N] ");
+
+    if (!confirmed) {
+      const payload = {
+        kind: "setup",
+        status: "draft_ready",
+        created: false,
+        draft,
+        next_command: interactive ? "audienti setup" : "Re-run with --yes to create it."
+      };
+      if (values.json) return writeJson(context.stdout, payload);
+
+      say("Nothing was created.");
+      say(interactive
+        ? "Run `audienti setup` again whenever you're ready. Changing your answers changes the draft."
+        : "Re-run the same command with --yes to create it.");
+      return 0;
+    }
+
+    const confirmation = await client.confirmQuickStart(accountId, draft.id, {});
+    const connectUrl = new URL("/user/social_cookies", client.host).toString();
+    if (values.json) {
+      return writeJson(context.stdout, {
+        kind: "setup",
+        status: "created",
+        created: true,
+        draft,
+        motion: confirmation?.motion || null,
+        reservation: confirmation?.reservation || null,
+        next_step: {
+          connect_linkedin_url: connectUrl,
+          check_command: "audienti setup play preflight"
+        }
+      });
+    }
+
+    const motion = confirmation?.motion || {};
+    say(`Created your first motion: ${display(motion.name)} (${display(motion.prefix_id)}).`);
+    say();
+    say("Next: connect your LinkedIn account so Audienti can reach people for you.");
+    say(`  Connect it here: ${connectUrl}`);
+    say("  Then check it with: audienti setup play preflight");
+    say("Nothing is sent until LinkedIn is connected, and nothing sends without your approval.");
+    return 0;
+  } finally {
+    if (!sharedPrompter) prompter.close();
+  }
+}
+
+const SETUP_PROGRESS = [
+  "Reading your website...",
+  "Working out who buys from you...",
+  "Drafting your offer and the first buying signals...",
+  "Still working. Thanks for waiting..."
+];
+
+function cleanSentence(value) {
+  return String(value || "").trim().replace(/[\s.]+$/, "");
+}
+
+function setupFeedback({ sellTo, ask }) {
+  const parts = [];
+  if (sellTo) parts.push(`We sell to: ${sellTo}.`);
+  if (ask) parts.push(`What we want the prospect to say yes to: ${ask}.`);
+  return parts.join(" ") || undefined;
+}
+
+function setupCreateError(error) {
+  if (!(error instanceof ApiError)) return error;
+
+  const reason = typeof error.body?.error === "string" ? cleanSentence(error.body.error) : null;
+  if (error.status === 401) {
+    return new CommandError("Your saved login no longer works. Run `audienti start` to sign in again.");
+  }
+  if (error.status === 403) {
+    return new CommandError("Only an account admin can replace the website already saved on this account. Run `audienti setup` again and press Enter at the website question to use the saved one.");
+  }
+  if (error.status === 422 && error.body?.status === "failed") return setupDraftFailedError(reason);
+  if (error.status === 422) {
+    return new CommandError(`That website didn't work: ${reason || "it was rejected"}. Use a full public address like https://acme.com, then run \`audienti setup\` again.`);
+  }
+  return error;
+}
+
+function setupDraftFailedError(reason) {
+  const detail = reason ? ` (${cleanSentence(reason)})` : "";
+  return new CommandError(`We couldn't draft a motion from that website${detail}. Nothing was created. Check the address or add a sentence about who you sell to, then run \`audienti setup\` again.`);
+}
+
+function renderSetupDraft(draft, { ask }, say) {
+  const preview = draft?.preview || {};
+  const icp = preview.icp || {};
+  const offer = preview.offer || {};
+  const titles = Array.isArray(icp.job_titles) && icp.job_titles.length ? ` (${icp.job_titles.join(", ")})` : "";
+
+  say("Here's the draft:");
+  if (preview.company_name || preview.product_or_service) {
+    say(`  Your business: ${[preview.company_name, preview.product_or_service].filter(Boolean).join(" - ")}`);
+  }
+  say(`  Who you'll reach: ${display(icp.name, "people who fit your website")}${titles}`);
+  say(`  Your offer: ${[offer.title, offer.description].filter(Boolean).join(" - ") || "drafted from your website"}`);
+  say(`  The ask: ${ask || "not set; the writer will suggest one"}`);
+  if (preview.premise) say(`  Why now: ${preview.premise}`);
+  say();
 }
 
 async function createAuthCallbackServer({ state, context }) {
@@ -1250,6 +1767,65 @@ async function offersDelete(args, context, { accountOverride } = {}) {
   writeLine(context.stdout, `Deleted offer ${display(payload?.name)} (${display(payload?.prefix_id)}).`);
 }
 
+async function offersRegenerateResearch(args, context, { accountOverride } = {}) {
+  const { values, positionals } = parseCommandArgs(args, { ...jsonOptions(), guidance: { type: "string" } });
+  if (positionals.length !== 1) throw new CommandError(OFFERS_REGENERATE_RESEARCH_USAGE);
+
+  const { client, accountId } = await requireAccountContext(context, { accountOverride });
+  const offer = await client.regenerateOfferResearch(accountId, positionals[0], compactObject({ guidance: values.guidance }));
+  if (values.json) return writeJson(context.stdout, offer);
+
+  writeLine(context.stdout, `Queued a new research write-up for offer ${display(offer?.name)} (${display(offer?.prefix_id)}).`);
+}
+
+async function offersUpdateWriteup(args, context, { accountOverride } = {}) {
+  const { values, positionals } = parseCommandArgs(args, { ...jsonOptions(), description: { type: "string" } });
+  if (positionals.length !== 1 || values.description === undefined) throw new CommandError(OFFERS_UPDATE_WRITEUP_USAGE);
+
+  const { client, accountId } = await requireAccountContext(context, { accountOverride });
+  const offer = await client.updateOfferWriteup(accountId, positionals[0], { offer: { description: values.description } });
+  if (values.json) return writeJson(context.stdout, offer);
+
+  writeLine(context.stdout, `Updated the write-up for offer ${display(offer?.name)} (${display(offer?.prefix_id)}).`);
+}
+
+async function offersAddArtifacts(args, context, { accountOverride } = {}) {
+  const { values, positionals } = parseCommandArgs(args, jsonOptions());
+  if (positionals.length < 2) throw new CommandError(OFFERS_ADD_ARTIFACTS_USAGE);
+
+  const [offerId, ...paths] = positionals;
+  const artifacts = [];
+  for (const path of paths) {
+    let data;
+    try {
+      data = await readFile(path);
+    } catch (error) {
+      throw new CommandError(`Cannot read ${path}: ${error.message}`);
+    }
+    artifacts.push({ filename: basename(path), data: data.toString("base64") });
+  }
+
+  const { client, accountId } = await requireAccountContext(context, { accountOverride });
+  const payload = await client.addOfferArtifacts(accountId, offerId, { artifacts });
+  if (values.json) return writeJson(context.stdout, payload);
+
+  const count = payload?.attached_count ?? artifacts.length;
+  writeLine(context.stdout, `Attached ${count} ${count === 1 ? "artifact" : "artifacts"} to offer ${display(payload?.offer_id || offerId)}.`);
+  renderOfferArtifacts(payload?.artifacts, context);
+}
+
+async function offersRemoveArtifact(args, context, { accountOverride } = {}) {
+  const { values, positionals } = parseCommandArgs(args, jsonOptions());
+  if (positionals.length !== 2) throw new CommandError(OFFERS_REMOVE_ARTIFACT_USAGE);
+
+  const [offerId, artifactId] = positionals;
+  const { client, accountId } = await requireAccountContext(context, { accountOverride });
+  const payload = await client.removeOfferArtifact(accountId, offerId, artifactId);
+  if (values.json) return writeJson(context.stdout, payload);
+
+  writeLine(context.stdout, `Removed artifact ${display(artifactId)} from offer ${display(payload?.offer_id || offerId)}.`);
+}
+
 async function icpsList(args, context, { accountOverride } = {}) {
   const { values, positionals } = parseCommandArgs(args, {
     ...jsonOptions(),
@@ -1359,6 +1935,68 @@ async function icpsTagMutation(action, args, context, { accountOverride } = {})
   if (Array.isArray(icp?.tags)) writeLine(context.stdout, `Tags: ${display(icp.tags.join(", "), "-")}`);
 }
 
+async function icpsBulkAddTag(args, context, { accountOverride } = {}) {
+  const { values, positionals } = parseCommandArgs(args, { ...jsonOptions(), tag: { type: "string" } });
+  if (positionals.length === 0 || !String(values.tag || "").trim()) throw new CommandError(ICPS_BULK_ADD_TAG_USAGE);
+
+  const { client, accountId } = await requireAccountContext(context, { accountOverride });
+  const icps = await client.bulkAddIcpTag(accountId, { icp_ids: positionals, tag: values.tag });
+  if (values.json) return writeJson(context.stdout, icps);
+
+  const count = Array.isArray(icps) ? icps.length : 0;
+  writeLine(context.stdout, `Added tag ${display(values.tag)} to ${count} ${count === 1 ? "ICP" : "ICPs"}.`);
+}
+
+async function icpsClone(args, context, { accountOverride } = {}) {
+  const { values, positionals } = parseCommandArgs(args, jsonOptions());
+  if (positionals.length !== 1) throw new CommandError(ICPS_CLONE_USAGE);
+
+  const { client, accountId } = await requireAccountContext(context, { accountOverride });
+  const icp = await client.cloneIcp(accountId, positionals[0]);
+  if (values.json) return writeJson(context.stdout, icp);
+
+  writeLine(context.stdout, `Cloned ICP as ${display(icp?.name)} (${display(icp?.prefix_id)}).`);
+}
+
+async function icpsDelete(args, context, { accountOverride } = {}) {
+  const { values, positionals } = parseCommandArgs(args, { ...jsonOptions(), confirm: { type: "string" } });
+  const normalizedConfirm = String(values.confirm || "").trim().toLowerCase();
+  if (positionals.length !== 1 || !DELETE_CONFIRMATION_VALUES.has(normalizedConfirm)) throw new CommandError(ICPS_DELETE_USAGE);
+
+  const { client, accountId } = await requireAccountContext(context, { accountOverride });
+  const payload = await client.deleteIcp(accountId, positionals[0]);
+  if (values.json) return writeJson(context.stdout, payload);
+
+  writeLine(context.stdout, `Deleted ICP ${display(payload?.name)} (${display(payload?.prefix_id)}).`);
+}
+
+async function icpsProspects(args, context, { accountOverride } = {}) {
+  const { values, positionals } = parseCommandArgs(args, {
+    ...jsonOptions(),
+    query: { type: "string" },
+    limit: { type: "string" },
+    offset: { type: "string" },
+    page: { type: "string" },
+    profiles: { type: "boolean" }
+  });
+  if (positionals.length !== 1) throw new CommandError(ICPS_PROSPECTS_USAGE);
+  if (values.page && values.offset) throw new CommandError("Choose one pagination mode: use either --page or --offset.");
+
+  const { client, accountId } = await requireAccountContext(context, { accountOverride });
+  const payload = await client.icpProspects(accountId, positionals[0], compactObject({
+    query: values.query,
+    limit: values.limit,
+    offset: values.offset,
+    page: values.page,
+    include_profiles: values.profiles
+  }));
+  if (values.json) return writeJson(context.stdout, payload);
+
+  renderProspects(payload, context, { profiles: values.profiles });
+  const meta = payload?.meta || {};
+  writeLine(context.stdout, `Showing ${display(meta.returned_count, 0)} of ${display(meta.total_count, 0)} matched prospects.`);
+}
+
 async function companiesSearch(args, context, { accountOverride } = {}) {
   const { values, positionals } = parseCommandArgs(args, {
     ...jsonOptions(),
@@ -1952,21 +2590,71 @@ async function tasksAdd(args, context, { accountOverride } = {}) {
   const payload = await client.createTask(accountId, { task });
   if (values.json) return writeJson(context.stdout, payload);
 
-  writeLine(context.stdout, `Created task ${display(payload?.prefix_id || payload?.id)}.`);
+  writeLine(context.stdout, `Created task ${display(payload?.prefix_id || payload?.id)}.`);
+  writeLine(context.stdout, `Title: ${display(payload?.title)}`);
+  if (payload?.notes) writeLine(context.stdout, `Description: ${payload.notes}`);
+  writeLine(context.stdout, `Due: ${display(payload?.due_at, "-")} | Association: ${taskAssociationLabel(payload)}`);
+}
+
+async function tasksComplete(args, context, { accountOverride } = {}) {
+  const { values, positionals } = parseCommandArgs(args, jsonOptions());
+  if (positionals.length !== 1) throw new CommandError(TASKS_COMPLETE_USAGE);
+
+  const { client, accountId } = await requireAccountContext(context, { accountOverride });
+  const payload = await client.completeTask(accountId, positionals[0]);
+  if (values.json) return writeJson(context.stdout, payload);
+
+  writeLine(context.stdout, `Completed task ${display(payload?.prefix_id || payload?.id || positionals[0])}.`);
+}
+
+async function tasksUpdate(args, context, { accountOverride } = {}) {
+  const { values, positionals } = parseCommandArgs(args, taskAddOptions());
+  const fields = {
+    title: values.title,
+    due_at: values.due,
+    notes: values.notes,
+    prospect_id: values.prospect,
+    list_id: values.list,
+    assignee_account_user_id: values["assigned-user"]
+  };
+  const sentFields = Object.entries(fields).filter(([, value]) => value !== undefined);
+  if (positionals.length !== 1 || sentFields.length === 0) throw new CommandError(TASKS_UPDATE_USAGE);
+  if (values.prospect && values.list) throw new CommandError("Use either --prospect or --list, not both.");
+
+  const { client, accountId, config } = await requireAccountContext(context, { accountOverride });
+  const task = Object.fromEntries(sentFields);
+  if (task.assignee_account_user_id !== undefined) {
+    task.assignee_account_user_id = resolveAccountUserId(task.assignee_account_user_id, config, { accountOverride }) ?? "";
+  }
+  const payload = await client.updateTask(accountId, positionals[0], { task });
+  if (values.json) return writeJson(context.stdout, payload);
+
+  writeLine(context.stdout, `Updated task ${display(payload?.prefix_id || payload?.id || positionals[0])}.`);
   writeLine(context.stdout, `Title: ${display(payload?.title)}`);
-  if (payload?.notes) writeLine(context.stdout, `Description: ${payload.notes}`);
   writeLine(context.stdout, `Due: ${display(payload?.due_at, "-")} | Association: ${taskAssociationLabel(payload)}`);
 }
 
-async function tasksComplete(args, context, { accountOverride } = {}) {
-  const { values, positionals } = parseCommandArgs(args, jsonOptions());
-  if (positionals.length !== 1) throw new CommandError(TASKS_COMPLETE_USAGE);
+async function tasksBulkUpdate(args, context, { accountOverride } = {}) {
+  const { values, positionals } = parseCommandArgs(args, {
+    ...jsonOptions(),
+    action: { type: "string" },
+    "assigned-user": { type: "string" }
+  });
+  const bulkAction = String(values.action || "").trim();
+  if (positionals.length === 0 || !["complete", "reassign"].includes(bulkAction)) throw new CommandError(TASKS_BULK_UPDATE_USAGE);
+  if (bulkAction === "reassign" && !values["assigned-user"]) throw new CommandError("--assigned-user is required with --action reassign.");
 
-  const { client, accountId } = await requireAccountContext(context, { accountOverride });
-  const payload = await client.completeTask(accountId, positionals[0]);
+  const { client, accountId, config } = await requireAccountContext(context, { accountOverride });
+  const payload = await client.bulkUpdateTasks(accountId, compactObject({
+    task_ids: positionals,
+    bulk_action: bulkAction,
+    assignee_account_user_id: bulkAction === "reassign" ? resolveAccountUserId(values["assigned-user"], config, { accountOverride }) : undefined
+  }));
   if (values.json) return writeJson(context.stdout, payload);
 
-  writeLine(context.stdout, `Completed task ${display(payload?.prefix_id || payload?.id || positionals[0])}.`);
+  const count = payload?.count ?? 0;
+  const noun = count === 1 ? "task" : "tasks";
+  writeLine(context.stdout, bulkAction === "complete" ? `Completed ${count} ${noun}.` : `Queued reassignment of ${count} ${noun}.`);
 }
 
 async function listsCreate(args, context, { accountOverride } = {}) {
@@ -2086,6 +2774,52 @@ async function listsDelete(args, context, { accountOverride } = {}) {
   }
 }
 
+async function listsBulkAddTag(args, context, { accountOverride } = {}) {
+  const { values, positionals } = parseCommandArgs(args, { ...jsonOptions(), tag: { type: "string" } });
+  if (positionals.length === 0 || !String(values.tag || "").trim()) throw new CommandError(LISTS_BULK_ADD_TAG_USAGE);
+
+  const { client, accountId } = await requireAccountContext(context, { accountOverride });
+  const lists = await client.bulkAddListTag(accountId, { list_ids: positionals, tag: values.tag });
+  if (values.json) return writeJson(context.stdout, lists);
+
+  const count = Array.isArray(lists) ? lists.length : 0;
+  writeLine(context.stdout, `Added tag ${display(values.tag)} to ${count} ${count === 1 ? "list" : "lists"}.`);
+}
+
+async function listsMerge(args, context, { accountOverride } = {}) {
+  const { values, positionals } = parseCommandArgs(args, jsonOptions());
+  if (positionals.length !== 2) throw new CommandError(LISTS_MERGE_USAGE);
+
+  const { client, accountId } = await requireAccountContext(context, { accountOverride });
+  const list = await client.mergeLists(accountId, { list_ids: positionals });
+  if (values.json) return writeJson(context.stdout, list);
+
+  writeLine(context.stdout, `Merged into list ${display(list?.name)} (${display(list?.prefix_id)}); the newer list was deleted.`);
+  writeLine(context.stdout, `Prospects: ${display(list?.prospect_count, 0)}`);
+}
+
+async function listsExport(args, context, { accountOverride } = {}) {
+  const { values, positionals } = parseCommandArgs(args, {
+    ...jsonOptions(),
+    output: { type: "string" },
+    "inactive-reason": { type: "string" }
+  });
+  if (positionals.length !== 1) throw new CommandError(LISTS_EXPORT_USAGE);
+
+  const listId = positionals[0];
+  const { client, accountId } = await requireAccountContext(context, { accountOverride });
+  const csv = String(await client.exportList(accountId, listId, compactObject({ inactive_reason: values["inactive-reason"] })) ?? "");
+
+  if (values.output) {
+    await writeFile(values.output, csv);
+    if (values.json) return writeJson(context.stdout, { list_id: listId, output: values.output, bytes: Buffer.byteLength(csv) });
+    return writeLine(context.stdout, `Wrote list ${display(listId)} CSV to ${values.output}.`);
+  }
+  if (values.json) return writeJson(context.stdout, { list_id: listId, csv });
+
+  context.stdout.write(csv);
+}
+
 async function listProspects(args, context, { accountOverride } = {}) {
   const { values, positionals } = parseCommandArgs(args, {
     ...jsonOptions(),
@@ -2167,7 +2901,7 @@ async function listsRemoveProspects(args, context, { accountOverride } = {}) {
 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>]");
+    throw new CommandError("Usage: audienti lists routing-rules <list_id> <list|create|update|remove|move|toggle|apply> [args] [--json] [--account <acct_id>]");
   }
 
   if (subaction === "list") return listRoutingRulesList(listId, rest, context, { accountOverride });
@@ -2175,9 +2909,10 @@ async function listsRoutingRules(args, 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 === "toggle") return listRoutingRulesToggle(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>]");
+  throw new CommandError("Usage: audienti lists routing-rules <list_id> <list|create|update|remove|move|toggle|apply> [args] [--json] [--account <acct_id>]");
 }
 
 async function listRoutingRulesList(listId, args, context, { accountOverride } = {}) {
@@ -2251,6 +2986,19 @@ async function listRoutingRulesMove(listId, args, context, { accountOverride } =
   renderListRoutingRules(payload, context);
 }
 
+async function listRoutingRulesToggle(listId, args, context, { accountOverride } = {}) {
+  const { values, positionals } = parseCommandArgs(args, jsonOptions());
+  if (positionals.length !== 1) throw new CommandError(LIST_ROUTING_RULES_TOGGLE_USAGE);
+
+  const { client, accountId } = await requireAccountContext(context, { accountOverride });
+  const payload = await client.toggleListRoutingRule(accountId, listId, positionals[0]);
+  if (values.json) return writeJson(context.stdout, payload);
+
+  const rule = payload?.routing_rule;
+  const state = rule?.enabled ? "Enabled" : "Disabled";
+  writeLine(context.stdout, `${state} routing rule ${display(rule?.name)} (${display(rule?.id || positionals[0])}) on list ${display(payload?.list_id || listId)}.`);
+}
+
 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);
@@ -3803,6 +4551,23 @@ async function toolsLinkedinReviewStatus(args, context, { accountOverride } = {}
   renderLinkedinReviewStatus(payload, context);
 }
 
+async function toolsLinkedinStrategyReview(args, context, { accountOverride } = {}) {
+  const [subaction, ...rest] = args;
+  if (subaction !== "delete") throw new CommandError(TOOLS_LINKEDIN_STRATEGY_REVIEW_DELETE_USAGE);
+
+  const { values, positionals } = parseCommandArgs(rest, { ...jsonOptions(), confirm: { type: "string" } });
+  const normalizedConfirm = String(values.confirm || "").trim().toLowerCase();
+  if (positionals.length !== 1 || !DELETE_CONFIRMATION_VALUES.has(normalizedConfirm)) {
+    throw new CommandError(TOOLS_LINKEDIN_STRATEGY_REVIEW_DELETE_USAGE);
+  }
+
+  const { client, accountId } = await requireAccountContext(context, { accountOverride });
+  const payload = await client.deleteLinkedinStrategyReview(accountId, positionals[0]);
+  if (values.json) return writeJson(context.stdout, payload);
+
+  writeLine(context.stdout, `Deleted LinkedIn strategy review report ${display(payload?.id || positionals[0])}.`);
+}
+
 async function operatorQueue(args, context, { accountOverride } = {}) {
   const { values, positionals } = parseCommandArgs(args, operatorFilterOptions(operatorPaginationOptions()));
   if (positionals.length > 0) throw new CommandError("Usage: audienti operator queue [--json] [filters] [--account <acct_id>]");
@@ -4140,9 +4905,8 @@ async function inboxOpsActionsInBatches(client, accountId, { operation, rows, dr
 }
 
 async function confirmInboxOpsAction(context) {
-  const input = context.stdin;
-  if (!input || !input.isTTY) return false;
-  const prompt = createInterface({ input, output: context.stdout });
+  if (!stdinIsInteractive(context)) return false;
+  const prompt = createInterface({ input: context.stdin, output: context.stdout });
   try {
     const answer = await prompt.question("Apply? [y/N] ");
     return /^y(es)?$/i.test(String(answer).trim());
@@ -6128,6 +6892,16 @@ function renderOffer(offer, context) {
   writeLine(context.stdout, `Offer: ${display(offer?.name)} (${display(offer?.prefix_id)})`);
   if (offer?.description) writeLine(context.stdout, `Description: ${offer.description}`);
   if (offer?.url) writeLine(context.stdout, `URL: ${offer.url}`);
+  if (Array.isArray(offer?.artifacts) && offer.artifacts.length > 0) renderOfferArtifacts(offer.artifacts, context);
+}
+
+function renderOfferArtifacts(artifacts, context) {
+  if (!Array.isArray(artifacts) || artifacts.length === 0) return writeLine(context.stdout, "No artifacts attached.");
+
+  writeLine(context.stdout, "ARTIFACT ID\tFILENAME\tTYPE\tBYTES");
+  for (const artifact of artifacts) {
+    writeLine(context.stdout, [display(artifact.id), display(artifact.filename), display(artifact.content_type, "-"), display(artifact.byte_size, 0)].join("\t"));
+  }
 }
 
 function renderIcps(icps, context) {
@@ -7825,13 +8599,14 @@ function quickStartTerminal(draft) {
   return quickStartReady(draft) || draft?.status === "failed";
 }
 
-async function waitForQuickStartDraft(client, accountId, initialDraft, context, { timeoutSeconds, pollIntervalSeconds }) {
+async function waitForQuickStartDraft(client, accountId, initialDraft, context, { timeoutSeconds, pollIntervalSeconds, onPoll }) {
   let draft = initialDraft;
   const deadline = context.now().getTime() + timeoutSeconds * 1000;
 
   while (!quickStartTerminal(draft)) {
     if (context.now().getTime() >= deadline) return draft;
 
+    onPoll?.();
     await context.sleep(pollIntervalSeconds * 1000);
     draft = await client.quickStart(accountId, draft.id);
   }
@@ -8889,6 +9664,8 @@ const HELP_TOPICS = new Map([
     "  audienti <command> [options]",
     "",
     "Start:",
+    "  audienti start                      Guided first run: sign in, pick your account",
+    "  audienti setup                      Guided setup of your first motion",
     "  audienti auth login                 Sign in through the browser",
     "  audienti auth token <token>         Save an API token",
     "  audienti accounts list             See accounts available to this token",
@@ -8971,15 +9748,23 @@ const HELP_TOPICS = new Map([
     "    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 lists bulk-add-tag --tag <tag> <list_id> [list_id...]",
+    "    audienti lists merge <list_id> <list_id>",
+    "    audienti lists export <list_id> [--output <file.csv>]",
     "    audienti tags list",
     "    audienti tags show <tag>",
     "    audienti tasks list [--status open]",
     "    audienti tasks add --title <text> --due <time>",
     "    audienti tasks complete <ptsk_id>",
+    "    audienti tasks update <ptsk_id> [--title <text>]",
+    "    audienti tasks bulk-update --action <complete|reassign> <ptsk_id> [ptsk_id...]",
     "    audienti offers list",
     "    audienti offers show <offr_id>",
     "    audienti offers update <offr_id> [--name <text>]",
     "    audienti offers delete <offr_id> --confirm <yes|true|Y|y>",
+    "    audienti offers regenerate-research <offr_id> [--guidance <text>]",
+    "    audienti offers update-writeup <offr_id> --description <text>",
+    "    audienti offers add-artifacts <offr_id> <file> [file...]",
     "    audienti icps list [--status <active|archived|all>] [--tag <tag>]",
     "    audienti icps show <icp_id>",
     "    audienti icps update <icp_id> [--tags <tag[,tag...]> | --payload <file.json>]",
@@ -8987,6 +9772,10 @@ const HELP_TOPICS = new Map([
     "    audienti icps restore <icp_id>",
     "    audienti icps add-tag <icp_id> <tag>",
     "    audienti icps remove-tag <icp_id> <tag>",
+    "    audienti icps bulk-add-tag --tag <tag> <icp_id> [icp_id...]",
+    "    audienti icps clone <icp_id>",
+    "    audienti icps delete <icp_id> --confirm <yes|true|Y|y>",
+    "    audienti icps prospects <icp_id> [--query <text>]",
     "    audienti companies search --query <text>",
     "    audienti linkedin-lookups <kind> [--query <text>]",
     "    audienti dnc list",
@@ -9338,16 +10127,47 @@ const HELP_TOPICS = new Map([
     "  Saves accountId and accountName in local CLI config."
   ].join("\n")],
 
+  ["start", [
+    "Usage:",
+    `  ${START_USAGE.slice("Usage: ".length)}`,
+    "",
+    "Status: implemented",
+    "",
+    "Purpose:",
+    "  Guided first run. Signs you in (or sends you to create an account) through the browser,",
+    "  picks your account and account user, then offers to run `audienti setup`.",
+    "  Running `audienti` with no arguments and no saved login starts here.",
+    "",
+    "Without a terminal:",
+    "  Never asks questions. Prints the sign-in command and the next step; `--json` returns them.",
+    "",
+    "Effect:",
+    "  Saves the login, accountId and accountUserId in local CLI config. Sends nothing."
+  ].join("\n")],
+
   ["setup", [
     "Usage:",
+    `  ${SETUP_USAGE.slice("Usage: ".length)}`,
     "  audienti setup play preflight [--principal <account_user_id|email|name|me>] [--platform linkedin] [--json]",
     "",
     "Status: implemented",
     "",
     "Purpose:",
+    "  `audienti setup` asks three questions (company website, who you sell to, what the prospect",
+    "  should say yes to), drafts an ICP, offer and motion with Quick Start, reads the draft back,",
+    "  and creates it only when you say yes. Nothing sends until LinkedIn is connected and approved.",
     "  Preflight account setup before an agent creates or activates an Audienti play.",
     "",
+    "Without a terminal:",
+    "  Pass --url (required) and optionally --sell-to and --ask. Add --yes to create the draft.",
+    "",
+    "API:",
+    "  POST /api/v1/accounts/:account_id/quick_start.json",
+    "  GET /api/v1/accounts/:account_id/quick_start/:draft_id.json",
+    "  POST /api/v1/accounts/:account_id/quick_start/:draft_id/confirm.json",
+    "",
     "Commands:",
+    "  audienti setup                 Guided setup of your first motion",
     "  audienti setup play preflight  Check connected-account readiness and direct setup URLs"
   ].join("\n")],
 
@@ -9528,6 +10348,10 @@ const HELP_TOPICS = new Map([
     "  audienti offers create --name <text> [--json]",
     "  audienti offers update <offr_id> [--name <text>] [--json]",
     "  audienti offers delete <offr_id> --confirm <yes|true|Y|y> [--json]",
+    "  audienti offers regenerate-research <offr_id> [--guidance <text>] [--json]",
+    "  audienti offers update-writeup <offr_id> --description <text> [--json]",
+    "  audienti offers add-artifacts <offr_id> <file> [file...] [--json]",
+    "  audienti offers remove-artifact <offr_id> <artifact_id> [--json]",
     "",
     "Status: implemented",
     "",
@@ -9639,6 +10463,10 @@ const HELP_TOPICS = new Map([
     "  audienti icps remove-tag <icp_id> <tag> [--json]",
     "  audienti icps archive <icp_id> [--json]",
     "  audienti icps restore <icp_id> [--json]",
+    "  audienti icps bulk-add-tag --tag <tag> <icp_id> [icp_id...] [--json]",
+    "  audienti icps clone <icp_id> [--json]",
+    "  audienti icps delete <icp_id> --confirm <yes|true|Y|y> [--json]",
+    "  audienti icps prospects <icp_id> [--query <text>] [--json]",
     "",
     "Status: implemented",
     "",
@@ -10337,6 +11165,8 @@ const HELP_TOPICS = new Map([
     `  ${TASKS_LIST_USAGE.slice("Usage: ".length)}`,
     `  ${TASKS_ADD_USAGE.slice("Usage: ".length)}`,
     `  ${TASKS_COMPLETE_USAGE.slice("Usage: ".length)}`,
+    `  ${TASKS_UPDATE_USAGE.slice("Usage: ".length)}`,
+    `  ${TASKS_BULK_UPDATE_USAGE.slice("Usage: ".length)}`,
     "",
     "Status: implemented",
     "",
@@ -10417,10 +11247,13 @@ const HELP_TOPICS = new Map([
     "  audienti lists add-tag <list_id> <tag> [--json]",
     "  audienti lists remove-tag <list_id> <tag> [--json]",
     "  audienti lists delete <list_id> --confirm <yes|true|Y|y> [--json]",
+    "  audienti lists bulk-add-tag --tag <tag> <list_id> [list_id...] [--json]",
+    "  audienti lists merge <list_id> <list_id> [--json]",
+    "  audienti lists export <list_id> [--output <file.csv>] [--json]",
     "  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]",
+    "  audienti lists routing-rules <list_id> <list|create|update|remove|move|toggle|apply> [args] [--json]",
     "",
     "Status: read, create, update, delete, membership, and routing-rule commands implemented",
     "",
@@ -10435,6 +11268,7 @@ const HELP_TOPICS = new Map([
     "  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> toggle <rule_id> [--json] [--account <acct_id>]",
     "  audienti lists routing-rules <list_id> apply [--json] [--account <acct_id>]",
     "",
     "Status: implemented",
@@ -10576,6 +11410,259 @@ const HELP_TOPICS = new Map([
     "  PATCH /api/v1/accounts/:account_id/lists/:id.json"
   ].join("\n")],
 
+  ["lists bulk-add-tag", [
+    "Usage:",
+    `  ${LISTS_BULK_ADD_TAG_USAGE.slice("Usage: ".length)}`,
+    "",
+    "Status: implemented",
+    "",
+    "Purpose:",
+    "  Add one normalized tag to several lists at once. All lists change or none do.",
+    "",
+    "Input shape:",
+    "  list_id: list_ prefix id or integer id; every id must belong to the account",
+    "  tag: string",
+    "",
+    "API:",
+    "  POST /api/v1/accounts/:account_id/lists/bulk_add_tag.json"
+  ].join("\n")],
+
+  ["lists merge", [
+    "Usage:",
+    `  ${LISTS_MERGE_USAGE.slice("Usage: ".length)}`,
+    "",
+    "Status: implemented",
+    "",
+    "Purpose:",
+    "  Merge two lists. The older list keeps its name and gains the newer list's tags, prospects, agents, and routing targets; the newer list is deleted.",
+    "  System and HubSpot-synced lists cannot be merged.",
+    "",
+    "Input shape:",
+    "  list_id: exactly two different list ids in the account",
+    "",
+    "API:",
+    "  POST /api/v1/accounts/:account_id/lists/merge_selected.json"
+  ].join("\n")],
+
+  ["lists export", [
+    "Usage:",
+    `  ${LISTS_EXPORT_USAGE.slice("Usage: ".length)}`,
+    "",
+    "Status: implemented",
+    "",
+    "Purpose:",
+    "  Download the list's prospects as CSV with the same columns as the web export.",
+    "  Prints to stdout unless --output is given.",
+    "",
+    "Input shape:",
+    "  list_id: list_ prefix id",
+    "  inactive-reason: optional filter for the inactive system list",
+    "",
+    "API:",
+    "  GET /api/v1/accounts/:account_id/lists/:id/export.json (returns text/csv)"
+  ].join("\n")],
+
+  ["lists routing-rules toggle", [
+    "Usage:",
+    `  ${LIST_ROUTING_RULES_TOGGLE_USAGE.slice("Usage: ".length)}`,
+    "",
+    "Status: implemented",
+    "",
+    "Purpose:",
+    "  Turn one routing rule on or off.",
+    "",
+    "Input shape:",
+    "  rule_id: routing rule id on the list",
+    "",
+    "API:",
+    "  PATCH /api/v1/accounts/:account_id/lists/:list_id/routing_rules/:id/toggle.json"
+  ].join("\n")],
+
+  ["icps bulk-add-tag", [
+    "Usage:",
+    `  ${ICPS_BULK_ADD_TAG_USAGE.slice("Usage: ".length)}`,
+    "",
+    "Status: implemented",
+    "",
+    "Purpose:",
+    "  Add one normalized tag to several ICPs at once. All ICPs change or none do.",
+    "",
+    "Input shape:",
+    "  icp_id: icpp_ prefix id or integer id; every id must belong to the account",
+    "  tag: string",
+    "",
+    "API:",
+    "  POST /api/v1/accounts/:account_id/icps/bulk_add_tag.json"
+  ].join("\n")],
+
+  ["icps clone", [
+    "Usage:",
+    `  ${ICPS_CLONE_USAGE.slice("Usage: ".length)}`,
+    "",
+    "Status: implemented",
+    "",
+    "Purpose:",
+    "  Copy an ICP and its audience rules under a new \"(Copy)\" name.",
+    "",
+    "Input shape:",
+    "  icp_id: icpp_ prefix id or integer id",
+    "",
+    "API:",
+    "  POST /api/v1/accounts/:account_id/icps/:id/clone.json"
+  ].join("\n")],
+
+  ["icps delete", [
+    "Usage:",
+    `  ${ICPS_DELETE_USAGE.slice("Usage: ".length)}`,
+    "",
+    "Status: implemented",
+    "",
+    "Purpose:",
+    "  Delete an ICP. ICPs still used by motions or agents are refused; archive them instead.",
+    "",
+    "Input shape:",
+    "  icp_id: icpp_ prefix id or integer id",
+    "  confirm: one of yes, true, Y, y",
+    "",
+    "API:",
+    "  DELETE /api/v1/accounts/:account_id/icps/:id.json"
+  ].join("\n")],
+
+  ["icps prospects", [
+    "Usage:",
+    `  ${ICPS_PROSPECTS_USAGE.slice("Usage: ".length)}`,
+    "",
+    "Status: implemented",
+    "",
+    "Purpose:",
+    "  List prospects matched to an ICP, newest first, optionally filtered by a text query.",
+    "",
+    "Input shape:",
+    "  icp_id: icpp_ prefix id or integer id",
+    "  limit: 1-100 (default 25)",
+    "",
+    "API:",
+    "  GET /api/v1/accounts/:account_id/icps/:id/prospects.json"
+  ].join("\n")],
+
+  ["offers regenerate-research", [
+    "Usage:",
+    `  ${OFFERS_REGENERATE_RESEARCH_USAGE.slice("Usage: ".length)}`,
+    "",
+    "Status: implemented",
+    "",
+    "Purpose:",
+    "  Queue a new research write-up for an offer, optionally steered by guidance. Returns once queued.",
+    "",
+    "Input shape:",
+    "  offr_id: offr_ prefixed id or integer id",
+    "  guidance: optional text",
+    "",
+    "API:",
+    "  POST /api/v1/accounts/:account_id/offers/:id/regenerate_research.json"
+  ].join("\n")],
+
+  ["offers update-writeup", [
+    "Usage:",
+    `  ${OFFERS_UPDATE_WRITEUP_USAGE.slice("Usage: ".length)}`,
+    "",
+    "Status: implemented",
+    "",
+    "Purpose:",
+    "  Replace an offer's write-up without queueing new research.",
+    "",
+    "Input shape:",
+    "  offr_id: offr_ prefixed id or integer id",
+    "  description: text",
+    "",
+    "API:",
+    "  PATCH /api/v1/accounts/:account_id/offers/:id/writeup.json"
+  ].join("\n")],
+
+  ["offers add-artifacts", [
+    "Usage:",
+    `  ${OFFERS_ADD_ARTIFACTS_USAGE.slice("Usage: ".length)}`,
+    "",
+    "Status: implemented",
+    "",
+    "Purpose:",
+    "  Attach local files to an offer as artifacts. `audienti offers show` lists attached artifacts.",
+    "",
+    "Input shape:",
+    "  offr_id: offr_ prefixed id or integer id",
+    "  file: local file path; sent as base64",
+    "",
+    "API:",
+    "  POST /api/v1/accounts/:account_id/offers/:offer_id/artifacts.json"
+  ].join("\n")],
+
+  ["offers remove-artifact", [
+    "Usage:",
+    `  ${OFFERS_REMOVE_ARTIFACT_USAGE.slice("Usage: ".length)}`,
+    "",
+    "Status: implemented",
+    "",
+    "Purpose:",
+    "  Remove one artifact from an offer.",
+    "",
+    "Input shape:",
+    "  artifact_id: id from `audienti offers show <offr_id>`",
+    "",
+    "API:",
+    "  DELETE /api/v1/accounts/:account_id/offers/:offer_id/artifacts/:id.json"
+  ].join("\n")],
+
+  ["tasks update", [
+    "Usage:",
+    `  ${TASKS_UPDATE_USAGE.slice("Usage: ".length)}`,
+    "",
+    "Status: implemented",
+    "",
+    "Purpose:",
+    "  Edit any task in the account. Only the options you pass change; pass an empty --prospect or --list to clear it.",
+    "",
+    "Input shape:",
+    "  task_id: ptsk_ prefix id or numeric id",
+    "  assigned-user: account user id or me",
+    "",
+    "API:",
+    "  PATCH /api/v1/accounts/:account_id/tasks/:id.json"
+  ].join("\n")],
+
+  ["tasks bulk-update", [
+    "Usage:",
+    `  ${TASKS_BULK_UPDATE_USAGE.slice("Usage: ".length)}`,
+    "",
+    "Status: implemented",
+    "",
+    "Purpose:",
+    "  Complete several tasks now, or queue their reassignment to one account user.",
+    "",
+    "Input shape:",
+    "  task_id: ptsk_ prefix ids; every id must belong to the account",
+    "  action: complete or reassign (reassign needs --assigned-user)",
+    "",
+    "API:",
+    "  PATCH /api/v1/accounts/:account_id/tasks/bulk_update.json"
+  ].join("\n")],
+
+  ["tools linkedin-strategy-review delete", [
+    "Usage:",
+    `  ${TOOLS_LINKEDIN_STRATEGY_REVIEW_DELETE_USAGE.slice("Usage: ".length)}`,
+    "",
+    "Status: implemented",
+    "",
+    "Purpose:",
+    "  Delete one LinkedIn strategy review report.",
+    "",
+    "Input shape:",
+    "  rprt_id: rprt_ report id of a strategy review",
+    "  confirm: one of yes, true, Y, y",
+    "",
+    "API:",
+    "  DELETE /api/v1/accounts/:account_id/tools/linkedin-strategy-review/reports/:id.json"
+  ].join("\n")],
+
   ["lists add-tag", [
     "Usage:",
     `  ${LISTS_ADD_TAG_USAGE.slice("Usage: ".length)}`,
@@ -12037,6 +13124,7 @@ const HELP_TOPICS = new Map([
     "  audienti tools linkedin-review reports [--limit <n>] [--json]",
     "  audienti tools linkedin-review show <rprt_id> [--json]",
     "  audienti tools linkedin-review status <rprt_id> [--json]",
+    "  audienti tools linkedin-strategy-review delete <rprt_id> --confirm <yes|true|Y|y> [--json]",
     "",
     "Status: implemented",
     "",
@@ -12047,7 +13135,8 @@ const HELP_TOPICS = new Map([
     "  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.",
-    "  audienti tools linkedin-review status  Show the current report stage and run status."
+    "  audienti tools linkedin-review status  Show the current report stage and run status.",
+    "  audienti tools linkedin-strategy-review delete  Delete one LinkedIn strategy review report."
   ].join("\n")],
 
   ["tools list", [