salesprompter-cli 0.1.64 → 0.1.66

package/README.md

@@ -73,6 +73,11 @@ salesprompter contacts:resolve-emails --in ./contacts.tsv --out-dir ./email-run
 salesprompter leads:collect \
   --linkedin-url "$SALES_NAV_PEOPLE_URL"
 
+# For large discovery runs, store the leads now and enrich selected imports later
+salesprompter leads:collect \
+  --linkedin-url "$SALES_NAV_PEOPLE_URL" \
+  --defer-email-enrichment
+
 # 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 ids and raw legal-name misses use conservative exact-name recovery.

package/dist/cli.js

@@ -186,21 +186,6 @@ const AffiliateStrictSequenceSchema = z.tuple([
     AffiliateStrictSequenceStepSchema.extend({ step: z.literal(2) }),
     AffiliateStrictSequenceStepSchema.extend({ step: z.literal(3) })
 ]);
-const AffiliateOutreachLeadSchema = z.object({
-    rowIndex: z.number().int().nonnegative(),
-    fullName: z.string().min(1),
-    firstName: z.string().min(1),
-    lastName: z.string().min(1),
-    jobTitle: z.string().nullable(),
-    companyName: z.string().min(1),
-    companyDomain: z.string().min(1),
-    location: z.string().nullable(),
-    profileUrl: z.string().nullable(),
-    email: z.string().email(),
-    emailScore: z.number().min(0).max(100),
-    acceptAll: z.boolean(),
-    emailSource: z.enum(["hunter", "phantombuster"]).optional()
-});
 const AffiliateOutreachRunBaseSchema = z.object({
     id: z.string().uuid(),
     audience_run_id: z.string().uuid(),
@@ -210,7 +195,6 @@ const AffiliateOutreachRunBaseSchema = z.object({
     instantly_campaign_id: z.string().min(1).nullable(),
     instantly_campaign_name: z.string().min(1).nullable(),
     sequence: z.array(AffiliateHistoricalSequenceStepSchema),
-    enriched_leads: z.array(AffiliateOutreachLeadSchema),
     stats: z.record(z.string(), z.unknown()),
     settings: z.record(z.string(), z.unknown()),
     error_message: z.string().nullable(),
@@ -234,9 +218,7 @@ const AffiliateOutreachResponseSchema = z.object({
     status: z.literal("ok"),
     outreach: AffiliateOutreachRunSchema
 });
-const AffiliateOutreachSummarySchema = AffiliateOutreachRunBaseSchema.omit({
-    enriched_leads: true
-});
+const AffiliateOutreachSummarySchema = AffiliateOutreachRunBaseSchema;
 const AffiliateAudienceSummarySchema = z.object({
     public_token: z.string().min(1),
     status: z.enum(["launching", "running", "finished", "failed"]),
@@ -314,6 +296,23 @@ const SalesNavigatorLocalImportResponseSchema = z.object({
     })
         .nullable()
         .optional(),
+    emailEnrichment: z
+        .object({
+        scheduled: z.boolean(),
+        deferred: z.boolean().optional(),
+        provider: z.string().min(1).optional(),
+        fallbackProvider: z.string().min(1).optional(),
+    })
+        .optional(),
+    enrichmentDeferred: z.boolean().optional(),
+    outreachStarted: z.literal(false).optional(),
+});
+const SalesNavigatorLocalImportCapabilitiesResponseSchema = z.object({
+    status: z.literal("ok"),
+    capabilities: z.object({
+        deferredEmailEnrichment: z.literal(true),
+    }),
+    outreachStarted: z.literal(false),
 });
 const PhantombusterContainersSyncResponseSchema = z.object({
     status: z.literal("ok"),
@@ -9293,6 +9292,9 @@ async function importLocalSalesNavigatorPeopleViaApp(session, payload) {
             totalResults: payload.totalResults,
             fetchedPages: payload.fetchedPages,
             people: payload.people,
+            ...(payload.startEmailEnrichment === false
+                ? { startEmailEnrichment: false }
+                : {}),
             rawPayload: {
                 ...payload.rawPayload,
                 clientId: workspaceClientId ?? undefined,
@@ -9323,6 +9325,20 @@ async function importLocalSalesNavigatorPeopleViaApp(session, payload) {
     }, SalesNavigatorLocalImportResponseSchema);
     return value;
 }
+async function requireDeferredEmailEnrichmentCapability(session) {
+    try {
+        const result = await fetchCliJson(session, (currentSession) => fetch(`${currentSession.apiBaseUrl}/api/cli/salesnav/local-import`, {
+            method: "GET",
+            headers: {
+                Authorization: `Bearer ${currentSession.accessToken}`,
+            },
+        }), SalesNavigatorLocalImportCapabilitiesResponseSchema);
+        return result.session;
+    }
+    catch {
+        throw new Error("This Salesprompter workspace cannot safely defer email enrichment yet. Update the app before collecting leads with --defer-email-enrichment.");
+    }
+}
 const SALESPROMPTER_SUPABASE_TABLES = {
     accountSearchRuns: "salesprompter_linkedin_sales_nav_account_search_runs",
     accountSearchSlices: "salesprompter_linkedin_sales_nav_account_search_slices",
@@ -13831,6 +13847,7 @@ async function runSalesNavigatorPeopleCollectCommand(options) {
             .max(accessibleResultLimit)
             .parse(options.maxResults);
     const complete = Boolean(options.complete || options.maxResults == null);
+    const emailEnrichmentDeferred = Boolean(options.deferEmailEnrichment);
     const checkpointPath = complete
         ? options.checkpoint
             ? path.resolve(options.checkpoint)
@@ -13845,13 +13862,18 @@ async function runSalesNavigatorPeopleCollectCommand(options) {
             accessibleResultLimit,
             complete,
             resumable: complete,
+            emailEnrichmentDeferred,
+            outreachStarted: false,
             destination: "/leads/cli-imports"
         };
         if (options.out)
             await writeJsonFile(options.out, payload);
         return payload;
     }
-    const session = await requireAuthSession();
+    let session = await requireAuthSession();
+    if (emailEnrichmentDeferred) {
+        session = await requireDeferredEmailEnrichmentCapability(session);
+    }
     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
@@ -13917,6 +13939,9 @@ async function runSalesNavigatorPeopleCollectCommand(options) {
         slicePreset: adaptiveCollection
             ? "local-salesnav-people-adaptive"
             : "local-salesnav-people",
+        ...(emailEnrichmentDeferred
+            ? { startEmailEnrichment: false }
+            : {}),
         rawPayload: adaptiveCollection
             ? {
                 collectionMode: adaptiveCollection.collectionMode,
@@ -13932,6 +13957,13 @@ async function runSalesNavigatorPeopleCollectCommand(options) {
                 accessibleResultLimit,
             },
     });
+    if (emailEnrichmentDeferred &&
+        !(imported.enrichmentDeferred === true &&
+            imported.emailEnrichment?.deferred === true &&
+            imported.emailEnrichment.scheduled === false &&
+            imported.outreachStarted === false)) {
+        throw new Error(`Import ${imported.runId} was stored, but the workspace did not confirm that email enrichment was deferred. Do not repeat the collection until that run's enrichment state is verified.`);
+    }
     const payload = {
         status: "ok",
         dryRun: false,
@@ -13960,6 +13992,10 @@ async function runSalesNavigatorPeopleCollectCommand(options) {
         runId: imported.runId,
         imported: imported.imported,
         upserted: imported.upserted,
+        emailEnrichmentDeferred: imported.enrichmentDeferred ??
+            imported.emailEnrichment?.deferred ??
+            false,
+        outreachStarted: imported.outreachStarted ?? false,
         workspaceUrl: `${session.apiBaseUrl}/leads/cli-imports?runId=` +
             encodeURIComponent(imported.runId)
     };
@@ -14825,6 +14861,7 @@ program
     .option("--max-results <number>", "Bounded collection size; defaults to exhaustive collection with a 2500-person window")
     .option("--complete", "Split oversized searches by company headcount and deduplicate the complete result", false)
     .option("--checkpoint <path>", "Optional resume checkpoint; exhaustive runs use a per-query checkpoint by default")
+    .option("--defer-email-enrichment", "Store leads without starting email enrichment", false)
     .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")

package/package.json

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