@dench.com/cli 3.5.8-staging.350 → 3.6.0

package/leads.ts

@@ -651,14 +651,16 @@ export function listsHelp(): void {
 Usage:
   dench lists [--search "September"] [--limit 25] [--cursor <cursor>] [--json]
   dench lists show <id> [--json]
-  dench lists save --title "Shortlist" --people-file <people.json> [--filters-json '{...}'] [--json]
+  dench lists save --title "Shortlist" --people-file <people.json> [--filters-json '{...}'] [--saved] [--json]
+  dench lists save --title "Target accounts" --companies-file <companies.json> [--json]
+  dench lists save --title "Open roles" --jobs-file <jobs.json> [--json]
   dench lists rows <id> [--enrichment all|enriched|in_progress|no_contacts|failed|not_enriched] [--limit 100] [--cursor <cursor>] [--json]
   dench lists rename <id> "New name" [--json]
   dench lists update <id> [--title "New name"] [--filters-json '{"titles":["CTO"]}'] [--json]
   dench lists delete <id> [--json]
 
 Lists are saved searches from Find (people / companies / job postings).
-People lists are not Leads. Select profiles in Find and confirm enrichment;
+People lists are not CRM Leads. Searching and saving do not reveal new contact details;
 there is no mandatory per-profile ICP decision. Import only on explicit request, with the
 requested configured CRM status. Follow pagination until isDone, even across
 empty filtered pages. --rows uses original zero-based indices from lists rows.
@@ -668,9 +670,13 @@ empty filtered pages. --rows uses original zero-based indices from lists rows.
 Assessments files contain 1–100 {row, suggestion: {fit, score, reason}} items.
 Scores are AI relevance to the saved ICP, not conversion probabilities or CRM qualification.
 Create one with \`dench leads|companies|jobs find --save-as "Name"\`.
-Consolidate selected search profiles with \`dench lists save\`: --people-file
-is a JSON array of person rows, not a CSV or a whole tool response. It saves
+Consolidate selected search results with \`dench lists save\`: choose --people-file,
+--companies-file or --jobs-file. The JSON can be an array or a search response
+containing the matching people, companies or jobs array. It saves
 a new list without searching, enriching, changing source lists, or importing CRM rows.
+Pass --saved to show it in Find; otherwise it stays an unlisted draft accessible by id.
+Add a saved people list to a campaign with \`dench campaign add <campaign> --list <id>\`.
+Use \`--preview\` first to review the selection without importing or enrolling anyone.
 Delete removes the list, its exported CSV/JSONL files, and any linked watch.
 CRM lists (saved views on Leads/Companies/Job Postings) are managed with
 \`dench crm views list|get|create|rename|delete\`.
@@ -716,38 +722,67 @@ export async function runListsCommand(opts: {
   args.shift();
   if (verb === "save") {
     const title = getFlag(args, "--title")?.trim();
-    const peopleFile = getFlag(args, "--people-file");
+    const sources = [
+      {
+        kind: "people",
+        file: getFlag(args, "--people-file"),
+        label: "person",
+        names: ["fullName", "name"],
+      },
+      {
+        kind: "companies",
+        file: getFlag(args, "--companies-file"),
+        label: "company",
+        names: ["name"],
+      },
+      {
+        kind: "jobs",
+        file: getFlag(args, "--jobs-file"),
+        label: "job",
+        names: ["title"],
+      },
+    ].filter((source) => source.file);
     const filtersJson = getFlag(args, "--filters-json");
+    const saved = hasFlag(args, "--saved");
     assertNoUnknownFlags(args, "lists save");
-    if (!title || !peopleFile) {
+    if (!title || sources.length !== 1) {
       throw new FindCliError(
-        "dench lists save requires --title and --people-file",
+        "dench lists save requires --title and exactly one of --people-file, --companies-file or --jobs-file",
       );
     }
-    let people: unknown;
+    const source = sources[0];
+    const flag = `--${source.kind}-file`;
+    let rows: unknown;
     let filters: unknown;
     try {
-      people = JSON.parse(await readFile(peopleFile, "utf-8"));
+      const content: unknown = JSON.parse(
+        await readFile(source.file!, "utf-8"),
+      );
+      rows = Array.isArray(content)
+        ? content
+        : content && typeof content === "object"
+          ? (content as Record<string, unknown>)[source.kind]
+          : content;
     } catch {
       throw new FindCliError(
-        "--people-file must be a readable JSON file containing an array of person rows",
+        `${flag} must be a readable JSON file containing an array of ${source.label} rows`,
       );
     }
     if (
-      !Array.isArray(people) ||
-      people.length === 0 ||
-      people.some(
-        (person) =>
-          !person ||
-          typeof person !== "object" ||
-          Array.isArray(person) ||
-          ![person.fullName, person.name].some(
-            (name) => typeof name === "string" && name.trim(),
+      !Array.isArray(rows) ||
+      rows.length === 0 ||
+      rows.some(
+        (row) =>
+          !row ||
+          typeof row !== "object" ||
+          Array.isArray(row) ||
+          !source.names.some(
+            (name) => typeof row[name] === "string" && row[name].trim(),
           ),
       )
     ) {
       throw new FindCliError(
-        "--people-file must contain a non-empty array of person rows, each with name or fullName",
+        `${flag} must contain a non-empty array of ${source.label} rows, each with ${source.names.join(" or ")}`,
       );
     }
     if (filtersJson !== undefined) {
@@ -763,9 +798,10 @@ export async function runListsCommand(opts: {
     out(
       ctx,
       await callAction(ctx, api.saveFind, {
-        createdFrom: "find_people",
+        createdFrom: `find_${source.kind}`,
         title,
-        people,
+        [source.kind]: rows,
+        ...(saved ? { saved: true } : {}),
         ...(filters !== undefined ? { filters } : {}),
       }),
     );
@@ -1096,6 +1132,7 @@ export async function runLeadsCommand(opts: {
     out(ctx, {
       ...(artifact as Record<string, unknown>),
       metadata: result.metadata,
+      billing: result.billing ?? null,
       ...(companyList ? { companyList: companyListInfo(companyList) } : {}),
     });
   } catch (error) {
@@ -1345,6 +1382,7 @@ export async function runCompaniesCommand(opts: {
     out(ctx, {
       ...(artifact as Record<string, unknown>),
       metadata: result.metadata,
+      billing: result.billing ?? null,
     });
   } catch (error) {
     throw new FindCliError(