salesprompter-cli 0.1.53 → 0.1.55

package/README.md

@@ -72,7 +72,8 @@ salesprompter leads:collect \
 
 # Enrich one or more stored imports: Sales Navigator company -> official domain -> Hunter email
 # This updates workspace data only. It does not create or start outreach.
-# Stale imported company ids fall back to exact-name Account Search automatically.
+# Stale ids and raw legal-name misses use conservative exact-name recovery.
+# Hunter prefers official domains and can fall back to the exact company name.
 salesprompter leads:enrich-import \
   --run-id "$CLI_IMPORT_RUN_ID"
 
@@ -109,6 +110,17 @@ salesprompter packs:list
 salesprompter --help
 ```
 
+Download stored workspace leads without starting a new Sales Navigator scrape:
+
+```bash
+salesprompter leads:download --out ./salesprompter-leads.csv
+salesprompter leads:download --run-id <uuid> --emails-only --out ./run-leads.csv
+```
+
+Use `--search <value>` to match a person, title, or company. The command uses the
+active Salesprompter workspace and downloads the same filtered data available in
+the app's CLI imports view.
+
 ## Output modes
 
 - `--json` for machine-readable output

package/dist/cli.js

@@ -284,6 +284,8 @@ const CliImportHunterBatchResponseSchema = z.object({
     found: z.number().int().nonnegative(),
     notFound: z.number().int().nonnegative(),
     failed: z.number().int().nonnegative(),
+    domainLookups: z.number().int().nonnegative().default(0),
+    companyLookups: z.number().int().nonnegative().default(0),
     halted: z.boolean(),
     error: z.string().nullable()
 });
@@ -524,6 +526,7 @@ const cliPacks = [
         commands: [
             "leads:discover",
             "leads:collect",
+            "leads:download",
             "leads:enrich-import",
             "search:run",
             "search:status",
@@ -585,6 +588,7 @@ const helpVisibleCommandNames = new Set([
     "wizard",
     "auth:whoami",
     "llm:ready",
+    "leads:download",
     "contacts:find-linkedin-urls",
     "companies:find-linkedin-urls",
     "contacts:process-emails",
@@ -6755,8 +6759,65 @@ async function runCliImportEnrichmentAction(session, body, schema) {
     }), schema);
     return value;
 }
+function parseDownloadFilename(contentDisposition) {
+    const match = contentDisposition?.match(/filename="?([^";]+)"?/i);
+    return match?.[1]?.trim() || `salesprompter-leads-${new Date().toISOString().slice(0, 10)}.csv`;
+}
+async function runLeadsDownloadCommand(options) {
+    const session = await requireAuthSession();
+    const runId = options.runId ? z.string().uuid().parse(options.runId) : null;
+    const search = options.search?.trim() || null;
+    const { value } = await withRefreshableAuthSession(session, async (currentSession) => {
+        const url = new URL('/api/cli/leads/imports/export', currentSession.apiBaseUrl);
+        if (runId)
+            url.searchParams.set('runId', runId);
+        if (search)
+            url.searchParams.set('q', search);
+        if (options.emailsOnly)
+            url.searchParams.set('emailsOnly', '1');
+        const response = await fetch(url, {
+            headers: { Authorization: `Bearer ${currentSession.accessToken}` },
+        });
+        if (!response.ok) {
+            const raw = await response.text();
+            let message = `lead download failed (${response.status})`;
+            try {
+                const payload = JSON.parse(raw);
+                if (typeof payload.error === 'string')
+                    message = payload.error;
+            }
+            catch {
+                if (raw.trim())
+                    message = raw.trim();
+            }
+            throw new CliApiRequestError(message, { statusCode: response.status });
+        }
+        const countHeader = response.headers.get('x-salesprompter-lead-count');
+        return {
+            bytes: Buffer.from(await response.arrayBuffer()),
+            count: countHeader == null ? null : Number.parseInt(countHeader, 10),
+            filename: parseDownloadFilename(response.headers.get('content-disposition')),
+        };
+    });
+    const outputPath = path.resolve(options.out?.trim() || value.filename);
+    await mkdir(path.dirname(outputPath), { recursive: true });
+    await writeFile(outputPath, value.bytes);
+    return {
+        status: 'ok',
+        output: outputPath,
+        leads: Number.isFinite(value.count) ? value.count : null,
+        bytes: value.bytes.length,
+        runId,
+        search,
+        emailsOnly: options.emailsOnly,
+    };
+}
 async function getCliImportCompanyCandidatesViaApp(session, input) {
-    return runCliImportEnrichmentAction(session, { action: "company-candidates", ...input }, CliImportCompanyCandidatesResponseSchema);
+    return runCliImportEnrichmentAction(session, {
+        action: "company-candidates",
+        ...input,
+        retry: input.retryMode === "all",
+    }, CliImportCompanyCandidatesResponseSchema);
 }
 async function saveCliImportCompanyProfilesViaApp(session, profiles) {
     return runCliImportEnrichmentAction(session, { action: "save-companies", profiles }, CliImportCompanySaveResponseSchema);
@@ -13446,6 +13507,7 @@ function normalizeCompanyWebsite(value) {
     }
 }
 const CLI_IMPORT_COMPANY_DECORATION = "(entityUrn,name,employeeCount,employeeDisplayCount,employeeCountRange,account(saved,noteCount,listCount,crmStatus,starred),pictureInfo,companyPictureDisplayImage,companyBackgroundCoverImage,description,industry,location,headquarters,website,revenueRange,crmOpportunities,flagshipCompanyUrl,employeeGrowthPercentages,employees*~fs_salesProfile(entityUrn,firstName,lastName,fullName,pictureInfo,profilePictureDisplayImage),specialties,type,yearFounded)";
+const CLI_IMPORT_COMPANY_RESOLUTION_VERSION = "cleaned-search-v1";
 class CliImportCompanySessionError extends Error {
     constructor(message) {
         super(message);
@@ -13591,24 +13653,39 @@ async function resolveCliImportCompanyIdentity(candidate, config, timeoutMs, bro
     let account = null;
     if (!resolvedCompanyId && candidate.companyName) {
         accountSearchUsed = true;
-        const queryUrl = buildCliImportAccountSearchUrl(candidate.companyName);
-        const response = await fetchCliImportSalesNavigatorJson({
-            url: queryUrl,
-            config,
-            browserRelay,
-            timeoutMs,
-            label: `Sales Navigator Account Search for ${candidate.companyName}`,
+        const seenSearchNames = new Set();
+        const searchNames = [
+            candidate.companyName,
+            aggressivelyCleanLookupCompanyName(candidate.companyName),
+        ].filter((value) => {
+            const key = normalizeLookupWhitespace(value).toLowerCase();
+            if (!key || seenSearchNames.has(key))
+                return false;
+            seenSearchNames.add(key);
+            return true;
         });
-        if (response.status < 200 || response.status >= 300) {
-            throw new Error(`Sales Navigator Account Search for ${candidate.companyName} returned ${response.status}.`);
-        }
-        if (response.status >= 200 && response.status < 300 && response.body) {
-            const accounts = extractLocalSalesNavigatorElements(response.body)
-                .map((element) => typeof element === "object" && element !== null && !Array.isArray(element)
-                ? normalizeLocalSalesNavigatorAccount(element, queryUrl)
-                : null)
-                .filter((value) => value !== null);
-            account = exactCliImportAccountMatch(candidate, accounts);
+        for (const searchName of searchNames) {
+            const queryUrl = buildCliImportAccountSearchUrl(searchName);
+            const response = await fetchCliImportSalesNavigatorJson({
+                url: queryUrl,
+                config,
+                browserRelay,
+                timeoutMs,
+                label: `Sales Navigator Account Search for ${searchName}`,
+            });
+            if (response.status < 200 || response.status >= 300) {
+                throw new Error(`Sales Navigator Account Search for ${searchName} returned ${response.status}.`);
+            }
+            if (response.body) {
+                const accounts = extractLocalSalesNavigatorElements(response.body)
+                    .map((element) => typeof element === "object" && element !== null && !Array.isArray(element)
+                    ? normalizeLocalSalesNavigatorAccount(element, queryUrl)
+                    : null)
+                    .filter((value) => value !== null);
+                account = exactCliImportAccountMatch(candidate, accounts);
+            }
+            if (account)
+                break;
         }
         salesNavCompanyUrl =
             (typeof account?.salesNavCompanyUrl === "string"
@@ -13708,6 +13785,7 @@ function buildCliImportCompanyProfile(resolution, detail, input) {
             error: input.error ??
                 `Sales Navigator company detail returned ${input.status || "no result"}`,
             rawPayload: {
+                resolutionVersion: CLI_IMPORT_COMPANY_RESOLUTION_VERSION,
                 accountSearchUsed: resolution.accountSearchUsed,
                 httpStatus: input.status,
             },
@@ -13780,6 +13858,7 @@ function buildCliImportCompanyProfile(resolution, detail, input) {
         status: "enriched",
         error: null,
         rawPayload: {
+            resolutionVersion: CLI_IMPORT_COMPANY_RESOLUTION_VERSION,
             accountSearchUsed: resolution.accountSearchUsed,
             httpStatus: input.status,
             detail,
@@ -13791,6 +13870,12 @@ async function runSalesNavigatorImportEnrichmentCommand(options) {
     if (options.companiesOnly && options.hunterOnly) {
         throw new Error("Use either --companies-only or --hunter-only, not both.");
     }
+    if (options.retryCompanies && options.retryNotFoundCompanies) {
+        throw new Error("Use either --retry-companies or --retry-not-found-companies, not both.");
+    }
+    if (options.retryEmails && options.retryFailedEmails) {
+        throw new Error("Use either --retry-emails or --retry-failed-emails, not both.");
+    }
     const runIds = Array.from(new Set(options.runId.map((runId) => z.string().uuid().parse(runId))));
     const companyTimeoutMs = z.coerce.number().int().min(1000).max(120000).parse(options.companyTimeoutMs);
     const companyDelayMinMs = z.coerce.number().int().min(0).parse(options.companyDelayMinMs);
@@ -13805,13 +13890,24 @@ async function runSalesNavigatorImportEnrichmentCommand(options) {
     const session = await requireAuthSession();
     const startedAt = new Date().toISOString();
     const initialStatus = await getCliImportEnrichmentStatusViaApp(session, runIds);
+    const companyRetryMode = options.retryCompanies
+        ? "all"
+        : options.retryNotFoundCompanies
+            ? "not_found"
+            : "default";
+    const retryStatuses = options.retryEmails
+        ? ["not_found", "failed"]
+        : options.retryFailedEmails
+            ? ["failed"]
+            : [];
     if (options.dryRun) {
         const companyCandidates = options.hunterOnly
             ? []
             : (await getCliImportCompanyCandidatesViaApp(session, {
                 runIds,
                 limit: 1000,
-                retry: options.retryCompanies
+                retryMode: companyRetryMode,
+                resolutionVersion: CLI_IMPORT_COMPANY_RESOLUTION_VERSION,
             })).companies.slice(0, maxCompanies || undefined);
         return {
             status: "ok",
@@ -13819,6 +13915,9 @@ async function runSalesNavigatorImportEnrichmentCommand(options) {
             runIds,
             initial: initialStatus,
             companyCandidates: companyCandidates.length,
+            companyRetryMode,
+            hunterCompanyFallback: options.hunterCompanyFallback,
+            retryEmailStatuses: retryStatuses,
             next: options.companiesOnly
                 ? "company enrichment only"
                 : options.hunterOnly
@@ -13838,7 +13937,8 @@ async function runSalesNavigatorImportEnrichmentCommand(options) {
         const companyCandidates = (await getCliImportCompanyCandidatesViaApp(session, {
             runIds,
             limit: 1000,
-            retry: options.retryCompanies
+            retryMode: companyRetryMode,
+            resolutionVersion: CLI_IMPORT_COMPANY_RESOLUTION_VERSION,
         })).companies.slice(0, maxCompanies || undefined);
         companies.selected = companyCandidates.length;
         if (companyCandidates.length > 0) {
@@ -14088,15 +14188,21 @@ async function runSalesNavigatorImportEnrichmentCommand(options) {
         processed: 0,
         found: 0,
         notFound: 0,
-        failed: 0
+        failed: 0,
+        domainLookups: 0,
+        companyLookups: 0,
     };
     if (!options.companiesOnly) {
-        const retryBefore = options.retryEmails ? startedAt : null;
+        const retryBefore = options.retryEmails || options.retryFailedEmails
+            ? startedAt
+            : null;
         while (maxHunterBatches === 0 || hunter.batches < maxHunterBatches) {
             const batch = await runCliImportHunterBatchViaApp(session, {
                 runIds,
                 limit: hunterBatchSize,
-                retryBefore
+                retryBefore,
+                allowCompanyFallback: options.hunterCompanyFallback,
+                retryStatuses,
             });
             if (batch.selected === 0)
                 break;
@@ -14106,7 +14212,9 @@ async function runSalesNavigatorImportEnrichmentCommand(options) {
                 processed: hunter.processed + batch.processed,
                 found: hunter.found + batch.found,
                 notFound: hunter.notFound + batch.notFound,
-                failed: hunter.failed + batch.failed
+                failed: hunter.failed + batch.failed,
+                domainLookups: hunter.domainLookups + batch.domainLookups,
+                companyLookups: hunter.companyLookups + batch.companyLookups,
             };
             writeProgress(`Hunter enrichment: ${hunter.processed} checked, ${hunter.found} emails found.`);
             if (batch.halted) {
@@ -14231,6 +14339,17 @@ program
     .action(async (options) => {
     printOutput(await runSalesNavigatorPeopleCollectCommand(options));
 });
+program
+    .command("leads:download")
+    .alias("leads:export-csv")
+    .description("Download stored leads from the active Salesprompter workspace as CSV.")
+    .option("--run-id <uuid>", "Limit the CSV to one CLI import run")
+    .option("--search <value>", "Filter by person, title, or company")
+    .option("--emails-only", "Include only leads with a found email", false)
+    .option("--out <path>", "CSV output path; defaults to a dated filename")
+    .action(async (options) => {
+    printOutput(await runLeadsDownloadCommand(options));
+});
 program
     .command("salesnav:people:enrich")
     .alias("leads:enrich-import")
@@ -14245,9 +14364,12 @@ program
     .option("--hunter-batch-size <number>", "Hunter contacts checked per request", "100")
     .option("--max-hunter-batches <number>", "Maximum Hunter batches; 0 continues until no eligible people remain", "0")
     .option("--companies-only", "Stop after company profiles and domains", false)
-    .option("--hunter-only", "Skip company lookup and use already stored domains", false)
-    .option("--retry-companies", "Retry previously saved company failures", false)
-    .option("--retry-emails", "Retry previously checked unresolved emails once", false)
+    .option("--hunter-only", "Skip company lookup and use stored domains or company-name fallback", false)
+    .option("--retry-companies", "Refresh every previously saved company profile", false)
+    .option("--retry-not-found-companies", "Retry only previous exact company misses with the current resolver", false)
+    .option("--retry-emails", "Retry previous Hunter misses and failures once", false)
+    .option("--retry-failed-emails", "Retry only previous Hunter failures once", false)
+    .option("--no-hunter-company-fallback", "Require a verified domain and skip Hunter company-name fallback")
     .option("--dry-run", "Show scope without LinkedIn or Hunter requests", false)
     .option("--out <path>", "Optional JSON result path")
     .action(async (options) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "salesprompter-cli",
-  "version": "0.1.53",
+  "version": "0.1.55",
   "description": "Sales workflow CLI for guided lead generation, enrichment, scoring, and sync.",
   "author": "Daniel Sinewe <hello@danielsinewe.com>",
   "type": "module",