salesprompter-cli 0.1.67 → 0.1.68

package/README.md

@@ -97,11 +97,12 @@ salesprompter affiliate:launch \
   --linkedin-url "https://www.linkedin.com/sales/search/people?query=..." \
   --max-results 100
 
-# End to end: collect, enrich emails, write a sequence, and create a draft Instantly campaign
-salesprompter affiliate:run \
+# End to end: collect, exclude customers, deduplicate, verify, enrich, and create a draft
+salesprompter affiliate:grow \
   --affiliate-link "https://example.com/?ref=you" \
   --linkedin-url "https://www.linkedin.com/sales/search/people?query=..." \
   --max-results 100 \
+  --seed-profile "https://www.linkedin.com/in/existing-customer" \
   --steps 3 \
   --timing-mode custom \
   --daily-limit 25 \
@@ -158,7 +159,9 @@ the app's CLI imports view.
 
 - Use your own authorized data access and workspace credentials.
 - 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:grow` is an alias for `affiliate:run`. It excludes repeated `--seed-profile` customers, removes profiles already stored in prior workspace affiliate audiences, and verifies the final persisted count before preparing Instantly.
+- If every collected profile is known or excluded, no audience or Instantly campaign is created. A stale Sales Navigator session also fails before persistence with a safe retry instruction.
+- Affiliate outreach uses direct email enrichment first, then Phantombuster Email Finder for unresolved people before creating a draft Instantly campaign.
 - Affiliate preparation uses exactly three emails with three observable variants per step; `affiliate:regenerate-sequence` rebuilds and syncs them through the Salesprompter app.
 - `affiliate:list` shows safe workspace summaries. `affiliate:analytics` shows aggregate and step/variant outcomes without exposing lead data; unsupported per-step meeting and won fields render as `n/a`.
 - `affiliate:run` defaults to `--timing-mode custom`, so its daily limit and weekday sending window are honored. Use `--timing-mode auto` only when capacity-derived scheduling is intended.

package/dist/cli.js

@@ -144,6 +144,18 @@ const AffiliateCampaignLaunchResponseSchema = z.object({
     extraction: z
         .object({
         provider: z.string().min(1),
+        runId: z.string().min(1).optional(),
+        resultCount: z.number().int().nonnegative().optional(),
+        deduplication: z
+            .object({
+            collectedCount: z.number().int().nonnegative(),
+            duplicateCount: z.number().int().nonnegative(),
+            withinBatchDuplicateCount: z.number().int().nonnegative(),
+            workspaceDuplicateCount: z.number().int().nonnegative(),
+            excludedSeedProfileCount: z.number().int().nonnegative(),
+            netNewCount: z.number().int().nonnegative(),
+        })
+            .optional(),
         monitorId: z.string().min(1).optional(),
         agentId: z.string().min(1).optional(),
         containerId: z.string().min(1).optional()
@@ -161,6 +173,21 @@ const AffiliateCampaignLaunchResponseSchema = z.object({
     previewUrl: z.string().nullable().optional(),
     next: z.string().optional()
 });
+const AffiliateAudienceVerificationSchema = z.object({
+    status: z.literal("ok"),
+    audience: z.object({
+        runId: z.string().uuid(),
+        status: z.enum(["launching", "running", "finished", "failed"]),
+        productDomain: z.string().min(1),
+        sourceType: z.string().min(1),
+        linkedInUrl: z.string().url(),
+        maxResults: z.number().int().positive(),
+        resultCount: z.number().int().nonnegative(),
+        provider: z.string().min(1).nullable(),
+        updatedAt: z.string().min(1),
+    }),
+    previewUrl: z.string().min(1),
+});
 const AffiliateCampaignLocalResultSchema = z
     .object({
     profileUrl: z.string().min(1),
@@ -6700,6 +6727,14 @@ async function launchAffiliateCampaignViaApp(session, payload) {
     }), AffiliateCampaignLaunchResponseSchema);
     return value;
 }
+async function verifyAffiliateCampaignViaApp(session, audienceRunId) {
+    const { value } = await fetchCliJson(session, (currentSession) => fetch(`${currentSession.apiBaseUrl}/api/cli/affiliate-campaigns/${encodeURIComponent(audienceRunId)}`, {
+        headers: {
+            Authorization: `Bearer ${currentSession.accessToken}`,
+        },
+    }), AffiliateAudienceVerificationSchema);
+    return value;
+}
 async function prepareAffiliateOutreachViaApp(session, payload) {
     const { value } = await fetchCliJson(session, (currentSession) => fetch(`${currentSession.apiBaseUrl}/api/cli/affiliate-outreach`, {
         method: "POST",
@@ -7935,7 +7970,7 @@ async function fetchLocalSalesNavigatorRequest(parsedRequest, retryOptions) {
                     retryDelayMs += await waitWithFullJitter(retryOptions.retryBaseDelayMs, retryOptions.retryMaxDelayMs, attempt);
                     continue;
                 }
-                throw new Error(`Sales Navigator request failed with HTTP ${response.status}: ${preview}`);
+                throw new LocalSalesNavigatorHttpError(response.status, text, `Sales Navigator request failed with HTTP ${response.status}: ${preview}`);
             }
             try {
                 return { body: JSON.parse(text), retryCount, retryDelayMs };
@@ -7945,7 +7980,8 @@ async function fetchLocalSalesNavigatorRequest(parsedRequest, retryOptions) {
             }
         }
         catch (error) {
-            if (error instanceof LocalSalesNavigatorRateLimitError) {
+            if (error instanceof LocalSalesNavigatorRateLimitError ||
+                error instanceof LocalSalesNavigatorHttpError) {
                 throw error;
             }
             if (attempt < retryOptions.maxRetries) {
@@ -14776,6 +14812,10 @@ async function runAffiliateLaunchCommand(options) {
             .max(accessibleResultLimit)
             .parse(options.maxResults);
     const session = await requireAuthSession();
+    const excludedProfileUrls = z
+        .array(z.string().url())
+        .max(100)
+        .parse(options.seedProfile ?? []);
     const isSalesNavigatorPeopleSearch = new URL(linkedInUrl).pathname.includes("/sales/search/people");
     let localResults;
     let localCollection;
@@ -14789,7 +14829,7 @@ async function runAffiliateLaunchCommand(options) {
         if (options.curlFile && browserRelayPort != null) {
             throw new Error("Use either --curl-file or --browser-relay-port, not both.");
         }
-        const parsedRequest = options.curlFile
+        let parsedRequest = options.curlFile
             ? parseSalesNavigatorCurlRequest(await readFile(path.resolve(String(options.curlFile)), "utf8"))
             : browserRelayPort != null
                 ? {
@@ -14805,7 +14845,7 @@ async function runAffiliateLaunchCommand(options) {
             : await createLocalAccountSearchBrowserRelay(browserRelayPort);
         let collected;
         try {
-            collected = await fetchAllLocalSalesNavigatorPeople(parsedRequest, {
+            const collect = async () => await fetchAllLocalSalesNavigatorPeople(parsedRequest, {
                 requestedProfiles: maxResults,
                 pageSize,
                 pageDelayMinMs,
@@ -14819,6 +14859,37 @@ async function runAffiliateLaunchCommand(options) {
                     ? (request) => browserRelay.request(request)
                     : undefined,
             });
+            try {
+                collected = await collect();
+            }
+            catch (error) {
+                const rejectedSession = error instanceof LocalSalesNavigatorHttpError &&
+                    (error.status === 401 || error.status === 403);
+                if (!rejectedSession ||
+                    options.curlFile ||
+                    browserRelay ||
+                    shouldDisableLinkedInDirectLookupAutodiscovery()) {
+                    throw error;
+                }
+                const extensionConfig = await readLocalLinkedInExtensionDirectLookupConfig();
+                if (!extensionConfig)
+                    throw error;
+                const extensionRequest = buildSalesNavigatorApiRequestFromSearchUrl(linkedInUrl, extensionConfig, pageSize);
+                if (extensionRequest.headers.cookie === parsedRequest.headers.cookie &&
+                    extensionRequest.headers["csrf-token"] === parsedRequest.headers["csrf-token"]) {
+                    throw error;
+                }
+                writeProgress("Stored Sales Navigator session was rejected; retrying with the latest extension-synced session.");
+                parsedRequest = extensionRequest;
+                collected = await collect();
+            }
+        }
+        catch (error) {
+            if (error instanceof LocalSalesNavigatorHttpError &&
+                (error.status === 401 || error.status === 403)) {
+                throw new Error("Sales Navigator rejected the available session. No audience was persisted. Refresh the Sales Navigator search in the signed-in browser, then rerun this command with a current --curl-file or --browser-relay-port. Workspace deduplication makes the retry safe.");
+            }
+            throw error;
         }
         finally {
             await browserRelay?.close();
@@ -14837,11 +14908,26 @@ async function runAffiliateLaunchCommand(options) {
         dryRun: Boolean(options.dryRun),
         localResults,
         localCollection,
+        ...(excludedProfileUrls.length > 0 ? { excludedProfileUrls } : {}),
     });
+    const runId = payload.extraction?.runId;
+    const verification = !options.dryRun && runId && z.string().uuid().safeParse(runId).success
+        ? await verifyAffiliateCampaignViaApp(session, runId)
+        : null;
+    if (verification) {
+        const expectedResultCount = payload.extraction?.resultCount;
+        if (verification.audience.status !== "finished") {
+            throw new Error(`Affiliate audience ${runId} was persisted but canonical status is ${verification.audience.status}, not finished.`);
+        }
+        if (expectedResultCount != null &&
+            verification.audience.resultCount !== expectedResultCount) {
+            throw new Error(`Affiliate audience ${runId} readback mismatch: created ${expectedResultCount}, stored ${verification.audience.resultCount}.`);
+        }
+    }
     if (options.out) {
-        await writeJsonFile(options.out, payload);
+        await writeJsonFile(options.out, { ...payload, verification });
     }
-    return { session, payload };
+    return { session, payload, verification };
 }
 function addAffiliateAudienceOptions(command) {
     return command
@@ -14850,6 +14936,7 @@ function addAffiliateAudienceOptions(command) {
         .option("--max-results <number>", "Maximum audience results (people searches: 2500; Connections of: 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("--seed-profile <url>", "Exclude a known customer or seed profile; repeat for multiple profiles", collectStringOptionValue, [])
         .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")
@@ -14915,12 +15002,13 @@ addAffiliateAudienceOptions(program
     .command("affiliate:launch")
     .description("Build an affiliate audience from an affiliate link and LinkedIn search URL."))
     .action(async (options) => {
-    const { payload } = await runAffiliateLaunchCommand(options);
-    printOutput(payload);
+    const { payload, verification } = await runAffiliateLaunchCommand(options);
+    printOutput({ ...payload, verification });
 });
 addAffiliateAudienceOptions(program
     .command("affiliate:run")
-    .description("Build an affiliate audience and prepare a reviewed Instantly campaign end to end."))
+    .alias("affiliate:grow")
+    .description("Collect, deduplicate, verify, and prepare a paused Instantly campaign end to end."))
     .option("--campaign-name <name>", "Optional Instantly campaign name")
     .option("--language <language>", "Sequence language", "English")
     .option("--steps <number>", "Exactly 3 sequence emails (fixed)", "3")
@@ -14938,6 +15026,13 @@ addAffiliateAudienceOptions(program
     if (options.dryRun) {
         printOutput({
             ...launched.payload,
+            verification: null,
+            journey: {
+                collection: "validated",
+                persistence: "not_requested",
+                outreach: "not_requested",
+                activation: "not_requested",
+            },
             outreach: {
                 status: "dry-run",
                 provider: "instantly",
@@ -14952,7 +15047,28 @@ addAffiliateAudienceOptions(program
         ? launched.payload.extraction.runId
         : null;
     if (!runId) {
-        throw new Error("The audience provider did not return a durable run id. End-to-end outreach requires a Sales Navigator people search.");
+        const deduplication = launched.payload.extraction?.deduplication;
+        if (deduplication?.netNewCount === 0) {
+            printOutput({
+                status: "ok",
+                audience: launched.payload,
+                verification: null,
+                journey: {
+                    collection: "complete",
+                    deduplication: "complete",
+                    persistence: "not_needed",
+                    outreach: "not_created",
+                    activation: "not_requested",
+                },
+                outreach: { status: "not_created", provider: "instantly" },
+                next: "Change the Sales Navigator cohort; every collected profile was already known or excluded.",
+            });
+            return;
+        }
+        throw new Error("The audience provider did not return a durable run id. End-to-end outreach requires a finished Sales Navigator people audience.");
+    }
+    if (!launched.verification) {
+        throw new Error(`Affiliate audience ${runId} was created but could not be independently verified. Outreach was not prepared.`);
     }
     const outreach = await prepareAffiliateOutreachViaApp(launched.session, {
         audienceRunId: z.string().uuid().parse(runId),
@@ -14964,6 +15080,16 @@ addAffiliateAudienceOptions(program
     printOutput({
         status: "ok",
         audience: launched.payload,
+        verification: launched.verification,
+        journey: {
+            collection: "complete",
+            deduplication: launched.payload.extraction?.deduplication
+                ? "complete"
+                : "not_reported",
+            persistence: "verified",
+            outreach: finalOutreach.status,
+            activation: finalOutreach.status === "active" ? "complete" : "not_requested",
+        },
         outreach: finalOutreach,
         next: finalOutreach.status === "ready"
             ? `Review the sequence, then run: salesprompter affiliate:activate ${runId}`

package/package.json

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