salesprompter-cli 0.1.46 → 0.1.48

package/README.md

@@ -65,7 +65,11 @@ salesprompter companies:resolve-linkedin-urls --in ./companies.txt --out ./compa
 # When authenticated, Salesprompter first enriches company domains in the app, then the CLI builds the email batch.
 salesprompter contacts:resolve-emails --in ./contacts.tsv --out-dir ./email-run --dry-run
 
-# Preview an affiliate audience without touching LinkedIn
+# Collect a Sales Navigator people search into the active workspace
+salesprompter leads:collect \
+  --linkedin-url "$SALES_NAV_PEOPLE_URL" \
+  --max-results 1000
+
 salesprompter affiliate:launch \
   --affiliate-link "https://example.com/?ref=you" \
   --linkedin-url "https://www.linkedin.com/sales/search/people?query=..." \
@@ -110,7 +114,7 @@ salesprompter --help
 - Respect provider terms and customer data boundaries.
 - `affiliate:run` uses direct email enrichment first, then Phantombuster Email Finder for unresolved people before creating a draft Instantly campaign.
 - Affiliate preparation automatically creates three variants per step with spintax; `affiliate:regenerate-sequence` rebuilds and syncs them through the Salesprompter app.
-- `affiliate:enrich` reruns email recovery and adds only newly found addresses to an existing campaign. Pass `--source-audience-run-id` to merge a newer compatible audience into that campaign without creating a duplicate campaign.
+- `affiliate:enrich` starts durable email recovery and adds only newly found addresses to an existing campaign. It returns a background-processing status for large audiences instead of blocking the terminal. Pass `--source-audience-run-id` to merge a newer compatible audience into that campaign without creating a duplicate campaign.
 - A draft campaign does not send until `affiliate:activate` is run.
 - The CLI is designed for interactive users and agent-assisted workflows.
 - A repo-local Chrome extension compatibility copy is available in `chrome-extension/` for local LinkedIn session sync and popup copy/debug flows.

package/dist/cli.js

@@ -147,6 +147,14 @@ const AffiliateCampaignLaunchResponseSchema = z.object({
     })
         .passthrough()
         .optional(),
+    workspaceImport: z
+        .object({
+        runId: z.string().uuid(),
+        imported: z.number().int().nonnegative(),
+        upserted: z.number().int().nonnegative(),
+        previewUrl: z.string().min(1)
+    })
+        .optional(),
     previewUrl: z.string().nullable().optional(),
     next: z.string().optional()
 });
@@ -469,6 +477,7 @@ const cliPacks = [
         summary: "Find leads from product and market inputs.",
         commands: [
             "leads:discover",
+            "leads:collect",
             "search:run",
             "search:status",
             "search:export",
@@ -506,6 +515,7 @@ const helpAliasByCommandName = new Map([
     ["dealroom-companies:scrape-local", "companies:scrape-dealroom"],
     ["linkedin-products:scrape", "market:scrape"],
     ["salesnav:from-product-category", "leads:discover"],
+    ["salesnav:people:collect", "leads:collect"],
     ["salesnav:crawl", "search:run"],
     ["salesnav:crawl:status", "search:status"],
     ["salesnav:export", "search:export"],
@@ -550,6 +560,7 @@ const helpVisibleCommandNames = new Set([
     "dealroom-companies:scrape-local",
     "linkedin-products:scrape",
     "salesnav:from-product-category",
+    "salesnav:people:collect",
     "salesnav:crawl",
     "salesnav:crawl:status",
     "salesnav:export",
@@ -6591,7 +6602,7 @@ async function enrichAffiliateOutreachViaApp(session, audienceRunId, sourceAudie
     const previousAttemptedAt = typeof before.stats.latestTopUp === "object" && before.stats.latestTopUp !== null
         ? String(before.stats.latestTopUp.attemptedAt ?? "")
         : "";
-    await fetchCliJson(session, (currentSession) => fetch(`${currentSession.apiBaseUrl}/api/cli/affiliate-outreach/${encodeURIComponent(audienceRunId)}/enrich`, {
+    const { value: started } = await fetchCliJson(session, (currentSession) => fetch(`${currentSession.apiBaseUrl}/api/cli/affiliate-outreach/${encodeURIComponent(audienceRunId)}/enrich`, {
         method: "POST",
         headers: {
             "Content-Type": "application/json",
@@ -6599,7 +6610,11 @@ async function enrichAffiliateOutreachViaApp(session, audienceRunId, sourceAudie
         },
         body: JSON.stringify({ sourceAudienceRunId })
     }), AffiliateOutreachEnrichStartResponseSchema);
-    const deadline = Date.now() + 10 * 60 * 1000;
+    const configuredWaitMs = Number(process.env.SALESPROMPTER_AFFILIATE_ENRICH_WAIT_MS);
+    const waitMs = Number.isFinite(configuredWaitMs) && configuredWaitMs >= 0
+        ? Math.min(10 * 60 * 1000, Math.trunc(configuredWaitMs))
+        : 15_000;
+    const deadline = Date.now() + waitMs;
     const configuredPollMs = Number(process.env.SALESPROMPTER_AFFILIATE_ENRICH_POLL_MS);
     const pollMs = Number.isFinite(configuredPollMs) && configuredPollMs > 0
         ? Math.max(10, Math.trunc(configuredPollMs))
@@ -6612,11 +6627,20 @@ async function enrichAffiliateOutreachViaApp(session, audienceRunId, sourceAudie
             ? current.stats.latestTopUp
             : null;
         const attemptedAt = String(latestTopUp?.attemptedAt ?? "");
-        if (attemptedAt && attemptedAt !== previousAttemptedAt) {
-            return current;
+        const complete = latestTopUp?.complete !== false;
+        if (attemptedAt && attemptedAt !== previousAttemptedAt && complete) {
+            return {
+                outreach: current,
+                processing: false,
+                workflowRunId: started.workflowRunId
+            };
         }
     }
-    throw new Error("Email recovery is still running after 10 minutes. Check affiliate:status and retry later.");
+    return {
+        outreach: before,
+        processing: true,
+        workflowRunId: started.workflowRunId
+    };
 }
 async function uploadLinkedInProductsCatalog(session, payload, batchSize = 100, traceId) {
     let imported = 0;
@@ -6780,6 +6804,10 @@ function buildSalesNavigatorApiRequestFromSearchUrl(searchUrl, config, count) {
 }
 function buildSalesNavigatorLeadApiUrlFromSearchUrl(searchUrl, count) {
     const source = new URL(searchUrl);
+    if (!source.searchParams.has("query") && source.hash.startsWith("#query=")) {
+        source.search = `?${source.hash.slice(1)}`;
+        source.hash = "";
+    }
     if (source.pathname.includes("/sales-api/salesApiLeadSearch")) {
         return source.toString();
     }
@@ -13185,6 +13213,99 @@ program
         }
     });
 });
+async function runSalesNavigatorPeopleCollectCommand(options) {
+    const linkedInUrl = z.string().url().parse(options.linkedinUrl);
+    const maxResults = z.coerce.number().int().min(1).max(100000).parse(options.maxResults);
+    const pageSize = z.coerce.number().int().min(1).max(100).parse(options.pageSize);
+    const normalizedSourceUrl = (() => {
+        const source = new URL(linkedInUrl);
+        if (!source.searchParams.has("query") && source.hash.startsWith("#query=")) {
+            source.search = `?${source.hash.slice(1)}`;
+            source.hash = "";
+        }
+        return source.toString();
+    })();
+    if (options.dryRun) {
+        const payload = {
+            status: "ok",
+            dryRun: true,
+            linkedInUrl: normalizedSourceUrl,
+            maxResults,
+            destination: "/leads/cli-imports"
+        };
+        if (options.out)
+            await writeJsonFile(options.out, payload);
+        return payload;
+    }
+    const session = await requireAuthSession();
+    const pageDelayMinMs = z.coerce.number().int().min(0).parse(options.pageDelayMinMs);
+    const pageDelayMaxMs = z.coerce.number().int().min(pageDelayMinMs).parse(options.pageDelayMaxMs);
+    const browserRelayPort = options.browserRelayPort == null
+        ? null
+        : z.coerce.number().int().min(0).max(65535).parse(options.browserRelayPort);
+    if (options.curlFile && browserRelayPort != null) {
+        throw new Error("Use either --curl-file or --browser-relay-port, not both.");
+    }
+    const parsedRequest = options.curlFile
+        ? parseSalesNavigatorCurlRequest(await readFile(path.resolve(String(options.curlFile)), "utf8"))
+        : browserRelayPort != null
+            ? {
+                url: buildSalesNavigatorLeadApiUrlFromSearchUrl(normalizedSourceUrl, pageSize),
+                headers: {}
+            }
+            : buildSalesNavigatorApiRequestFromSearchUrl(normalizedSourceUrl, await readLinkedInDirectLookupConfig(), pageSize);
+    if (!new URL(parsedRequest.url).pathname.includes("/sales-api/salesApiLeadSearch")) {
+        throw new Error("--curl-file must contain a /sales-api/salesApiLeadSearch request.");
+    }
+    const browserRelay = browserRelayPort == null
+        ? null
+        : await createLocalAccountSearchBrowserRelay(browserRelayPort);
+    let collected;
+    try {
+        collected = await fetchAllLocalSalesNavigatorPeople(parsedRequest, {
+            requestedProfiles: maxResults,
+            pageSize,
+            pageDelayMinMs,
+            pageDelayMaxMs,
+            retry: {
+                maxRetries: 2,
+                retryBaseDelayMs: 2_000,
+                retryMaxDelayMs: 10_000
+            },
+            executeRequest: browserRelay
+                ? (request) => browserRelay.request(request.url)
+                : undefined
+        });
+    }
+    finally {
+        await browserRelay?.close();
+    }
+    const imported = await importLocalSalesNavigatorPeopleViaApp(session, {
+        sourceQueryUrl: normalizedSourceUrl,
+        people: collected.people,
+        totalResults: collected.totalResults,
+        fetchedPages: collected.fetchedPages,
+        pacing: collected.pacing,
+        maxResultsPerSearch: maxResults,
+        numberOfProfiles: maxResults,
+        slicePreset: "local-salesnav-people"
+    });
+    const payload = {
+        status: "ok",
+        dryRun: false,
+        collected: collected.people.length,
+        totalResults: collected.totalResults,
+        fetchedPages: collected.fetchedPages,
+        runId: imported.runId,
+        imported: imported.imported,
+        upserted: imported.upserted,
+        workspaceUrl: `${session.apiBaseUrl}/leads/cli-imports?runId=` +
+            encodeURIComponent(imported.runId)
+    };
+    if (options.out)
+        await writeJsonFile(options.out, payload);
+    return payload;
+}
 async function runAffiliateLaunchCommand(options) {
     const affiliateLink = z.string().url().parse(options.affiliateLink);
     const linkedInUrl = z.string().url().parse(options.linkedinUrl);
@@ -13270,6 +13391,22 @@ function addAffiliateAudienceOptions(command) {
         .option("--dry-run", "Validate and preview without creating remote resources", false)
         .option("--out <path>", "Optional local JSON output path");
 }
+program
+    .command("salesnav:people:collect")
+    .alias("leads:collect")
+    .description("Collect a Sales Navigator people search into the active workspace.")
+    .requiredOption("--linkedin-url <url>", "Sales Navigator people search URL")
+    .option("--max-results <number>", "Maximum people to collect", "1000")
+    .option("--curl-file <path>", "Optional copied Sales Navigator Lead Search curl request")
+    .option("--browser-relay-port <number>", "Use the signed-in browser through a loopback relay")
+    .option("--page-size <number>", "Direct Sales Navigator page size", "100")
+    .option("--page-delay-min-ms <number>", "Minimum delay between direct pages", "5000")
+    .option("--page-delay-max-ms <number>", "Maximum delay between direct pages", "8000")
+    .option("--dry-run", "Validate without collecting or importing", false)
+    .option("--out <path>", "Optional local JSON output path")
+    .action(async (options) => {
+    printOutput(await runSalesNavigatorPeopleCollectCommand(options));
+});
 addAffiliateAudienceOptions(program
     .command("affiliate:launch")
     .description("Build an affiliate audience from an affiliate link and LinkedIn search URL."))
@@ -13360,13 +13497,17 @@ program
     .option("--source-audience-run-id <run-id>", "Use a newer compatible audience to top up this campaign")
     .action(async (runId, options) => {
     const session = await requireAuthSession();
-    const outreach = await enrichAffiliateOutreachViaApp(session, z.string().uuid().parse(runId), options.sourceAudienceRunId
+    const result = await enrichAffiliateOutreachViaApp(session, z.string().uuid().parse(runId), options.sourceAudienceRunId
         ? z.string().uuid().parse(options.sourceAudienceRunId)
         : undefined);
     printOutput({
         status: "ok",
-        outreach,
-        message: "Email recovery finished and new verified leads were added."
+        processing: result.processing,
+        workflowRunId: result.workflowRunId,
+        outreach: result.outreach,
+        message: result.processing
+            ? `Email recovery is running in the background. Check: salesprompter affiliate:status ${runId}`
+            : "Email recovery finished and new verified leads were added."
     });
 });
 program

package/package.json

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