salesprompter-cli 0.1.37 → 0.1.39

package/dist/cli.js

@@ -1,5 +1,6 @@
 #!/usr/bin/env node
 import { spawn } from "node:child_process";
+import { createHash } from "node:crypto";
 import { access, appendFile, mkdir, readFile, readdir, stat, writeFile } from "node:fs/promises";
 import { createRequire } from "node:module";
 import os from "node:os";
@@ -25,7 +26,8 @@ import { InstantlySyncProvider } from "./instantly.js";
 import { backfillLinkedInCompanies } from "./linkedin-companies.js";
 import { parseLinkedInCompanyPage } from "./linkedin-companies.js";
 import { crawlLinkedInProductCategory } from "./linkedin-products.js";
-import { claimValidatedSalesNavigatorSessionCookieForCli, createLinkedInSessionSupabaseClient, resolveConfiguredEnvValue } from "./linkedin-session.js";
+import { claimValidatedSalesNavigatorSessionCookieForCli, createLinkedInSessionSupabaseClient, probeSalesNavigatorSearchSession, resolveConfiguredEnvValue } from "./linkedin-session.js";
+import { extractLiAtCookieValue } from "./linkedin-session-contracts.js";
 import { buildLeadlistsFunnelQueries } from "./leadlists-funnel.js";
 import { readJsonFile, splitCsv, writeJsonFile, writeTextFile } from "./io.js";
 import { buildSalesNavigatorCrawlPreview, createSalesNavigatorCrawlSeed, DEFAULT_SALES_NAVIGATOR_CRAWL_DIMENSIONS, buildSalesNavigatorPeopleSlice, deriveSalesNavigatorTitleQuerySeeds, expandSalesNavigatorCrawlAttempt, SalesNavigatorSliceTooBroadError } from "./sales-navigator.js";
@@ -122,6 +124,20 @@ const LinkedInCompanyBackfillStatusResponseSchema = z.object({
     failureCode: z.string().nullable().optional(),
     failureMessage: z.string().nullable().optional()
 });
+const LeadPoolEmailFinderProcessResponseSchema = z.object({
+    success: z.boolean(),
+    provider: z.string().optional(),
+    selected: z.number().int().nonnegative(),
+    found: z.number().int().nonnegative(),
+    notFound: z.number().int().nonnegative(),
+    failed: z.number().int().nonnegative(),
+    durationMs: z.number().nonnegative(),
+    launched: z.boolean().optional(),
+    agentId: z.string().nullable().optional(),
+    containerId: z.string().nullable().optional(),
+    csvInputUrl: z.string().nullable().optional(),
+    processedAt: z.string()
+});
 const PhantombusterContainersSyncResponseSchema = z.object({
     status: z.literal("ok"),
     agentIds: z.array(z.string().min(1)),
@@ -5717,6 +5733,24 @@ async function syncPhantombusterContainersViaApp(session, payload) {
     }), PhantombusterContainersSyncResponseSchema);
     return value;
 }
+async function runLeadPoolEmailFinderViaApp(session, payload) {
+    const url = new URL("/api/leadpool/process-hunter-emails", session.apiBaseUrl);
+    url.searchParams.set("provider", payload.provider);
+    url.searchParams.set("limit", String(payload.limit));
+    if (payload.concurrency != null) {
+        url.searchParams.set("concurrency", String(payload.concurrency));
+    }
+    if (payload.retryNotFoundAfterDays != null) {
+        url.searchParams.set("retryNotFoundAfterDays", String(payload.retryNotFoundAfterDays));
+    }
+    const { value } = await fetchCliJson(session, (currentSession) => fetch(url.toString(), {
+        method: "POST",
+        headers: {
+            Authorization: `Bearer ${currentSession.accessToken}`
+        }
+    }), LeadPoolEmailFinderProcessResponseSchema);
+    return value;
+}
 function serializeSalesNavigatorFiltersForApi(filters) {
     return filters.map((filter) => ({
         type: filter.type,
@@ -5869,6 +5903,15 @@ async function runSalesNavigatorExport(session, payload, traceId, logOptions = {
     }
 }
 async function startSalesNavigatorExport(session, payload, traceId) {
+    const exportSession = await resolveSalesNavigatorExportSessionOverride(payload.slicedQueryUrl, {
+        source: "cli_salesnav_export_start"
+    });
+    const sessionOverridePayload = exportSession
+        ? {
+            sessionCookie: exportSession.sessionCookie,
+            selectedSessionCookieSha256: exportSession.selectedSessionCookieSha256
+        }
+        : {};
     return await fetchCliJson(session, (currentSession) => fetch(`${currentSession.apiBaseUrl}/api/cli/salesnav/export`, {
         method: "POST",
         signal: AbortSignal.timeout(SALES_NAVIGATOR_EXPORT_START_TIMEOUT_MS),
@@ -5879,7 +5922,8 @@ async function startSalesNavigatorExport(session, payload, traceId) {
         },
         body: JSON.stringify({
             ...payload,
-            appliedFilters: serializeSalesNavigatorFiltersForApi(payload.appliedFilters)
+            appliedFilters: serializeSalesNavigatorFiltersForApi(payload.appliedFilters),
+            ...sessionOverridePayload
         })
     }), SalesNavigatorExportStartResponseSchema);
 }
@@ -6686,25 +6730,95 @@ function buildSalesNavigatorSliceFailureReport(slice, error, options) {
 function formatSalesNavigatorSplitTrail(splitTrail) {
     return splitTrail.map((entry) => `${entry.key}:${entry.value.text}`);
 }
+let cachedSalesNavigatorExportSessionOverride = null;
+function hashSalesNavigatorSessionCookieForPhantombuster(sessionCookie) {
+    const liAt = extractLiAtCookieValue(sessionCookie);
+    if (!liAt) {
+        return null;
+    }
+    return createHash("sha256").update(liAt).digest("hex");
+}
+function normalizeSalesNavigatorSessionCookieForPhantombuster(sessionCookie) {
+    return extractLiAtCookieValue(sessionCookie) ?? sessionCookie;
+}
+function cacheSalesNavigatorExportSessionOverride(queryUrl, value) {
+    cachedSalesNavigatorExportSessionOverride = {
+        queryUrl,
+        expiresAt: Date.now() + 120_000,
+        value
+    };
+    return value;
+}
+async function resolveSalesNavigatorExportSessionOverride(queryUrl, options) {
+    if (cachedSalesNavigatorExportSessionOverride &&
+        cachedSalesNavigatorExportSessionOverride.queryUrl === queryUrl &&
+        cachedSalesNavigatorExportSessionOverride.expiresAt > Date.now()) {
+        return cachedSalesNavigatorExportSessionOverride.value;
+    }
+    const localExtensionConfig = await readLocalLinkedInExtensionDirectLookupConfig();
+    if (localExtensionConfig?.cookie) {
+        const selectedSessionCookieSha256 = hashSalesNavigatorSessionCookieForPhantombuster(localExtensionConfig.cookie);
+        if (process.env.SALESPROMPTER_SALESNAV_EXPORT_SKIP_EXTENSION_PREFLIGHT === "1") {
+            return cacheSalesNavigatorExportSessionOverride(queryUrl, {
+                sessionCookie: normalizeSalesNavigatorSessionCookieForPhantombuster(localExtensionConfig.cookie),
+                selectedSessionCookieSha256,
+                source: "chrome_extension"
+            });
+        }
+        const probe = await probeSalesNavigatorSearchSession(localExtensionConfig.cookie, queryUrl, {
+            timeoutMs: 8000
+        });
+        await options.logger?.log("salesnav.export.session.chrome_extension.preflight", {
+            source: options.source,
+            queryUrl,
+            status: probe.status,
+            selectedSessionCookieSha256,
+            finalUrl: probe.finalUrl,
+            validationError: probe.validationError
+        });
+        if (probe.status === "ok") {
+            return cacheSalesNavigatorExportSessionOverride(queryUrl, {
+                sessionCookie: normalizeSalesNavigatorSessionCookieForPhantombuster(localExtensionConfig.cookie),
+                selectedSessionCookieSha256,
+                source: "chrome_extension"
+            });
+        }
+    }
+    const claimed = await claimValidatedSalesNavigatorSessionCookieForCli({
+        queryUrl,
+        source: options.source,
+        env: process.env
+    });
+    if (claimed?.sessionCookie) {
+        return cacheSalesNavigatorExportSessionOverride(queryUrl, {
+            sessionCookie: normalizeSalesNavigatorSessionCookieForPhantombuster(claimed.sessionCookie),
+            selectedSessionCookieSha256: claimed.sessionCookieSha256 ??
+                hashSalesNavigatorSessionCookieForPhantombuster(claimed.sessionCookie),
+            source: "session_vault"
+        });
+    }
+    if (localExtensionConfig?.cookie &&
+        process.env.SALESPROMPTER_SALESNAV_EXPORT_REQUIRE_FRESH_SESSION === "1") {
+        throw new Error("The local Salesprompter Chrome extension session cookie is not valid for Sales Navigator. Reconnect the extension, then retry the CLI command.");
+    }
+    if (process.env.SALESPROMPTER_CLI_MANAGE_LINKEDIN_SESSIONS === "1") {
+        throw new Error("No validated LinkedIn Sales Navigator session cookie is available from the CLI-managed session pool.");
+    }
+    return null;
+}
 async function ensureSalesNavigatorSessionPoolReady(queryUrl, options) {
     try {
         await options.logger?.log("salesnav.session_pool.preflight.started", {
             source: options.source,
             queryUrl
         });
-        const claimed = await claimValidatedSalesNavigatorSessionCookieForCli({
-            queryUrl,
-            source: options.source,
-            env: process.env
-        });
+        const claimed = await resolveSalesNavigatorExportSessionOverride(queryUrl, options);
         await options.logger?.log("salesnav.session_pool.preflight.completed", {
             source: options.source,
             queryUrl,
             status: claimed ? "ok" : "skipped",
-            selectedSessionUserEmail: claimed?.userEmail ?? null,
-            selectedSessionUserHandle: claimed?.userHandle ?? null,
-            selectedSessionCookieSha256: claimed?.sessionCookieSha256 ?? null,
-            selectedSessionLastIngestedSource: claimed?.lastIngestedSource ?? null
+            selectedSessionSource: claimed?.source ?? "app_managed",
+            selectedSessionCookieSha256: claimed?.selectedSessionCookieSha256 ?? null
         });
         return {
             ready: true
@@ -10681,6 +10795,8 @@ program
     .requiredOption("--out-dir <path>", "Output directory for artifacts")
     .option("--trace-id <traceId>", "Trace id for this batch")
     .option("--endpoint-url <url>", "Override the enrichment workflow endpoint")
+    .option("--provider <provider>", "Email finder provider for workspace queue: hunter or phantombuster", "hunter")
+    .option("--retry-not-found-after-days <number>", "Retry stale Email not found rows after this many days", "1")
     .option("--timeout-ms <number>", "Workflow trigger timeout in milliseconds", "30000")
     .option("--company-cleaning <mode>", "Company cleaning mode for direct input: off, basic, or ai", "basic")
     .option("--dry-run", "Preview the next batch without starting background processing", false)
@@ -10689,7 +10805,69 @@ program
     const outDir = z.string().min(1).parse(options.outDir);
     const timeoutMs = z.coerce.number().int().min(1000).max(300000).parse(options.timeoutMs);
     const usingDirectInput = typeof options.in === "string" && options.in.trim().length > 0;
+    const provider = z.enum(["hunter", "phantombuster"]).parse(String(options.provider ?? "hunter").trim().toLowerCase());
+    const retryNotFoundAfterDays = z.coerce.number().int().min(0).max(30).parse(options.retryNotFoundAfterDays);
     const companyCleaningMode = resolveCompanyCleaningMode(String(options.companyCleaning ?? process.env.SALESPROMPTER_COMPANY_CLEANING_MODE ?? "basic"));
+    if (provider === "phantombuster" && !usingDirectInput) {
+        await mkdir(outDir, { recursive: true });
+        const traceId = z.string().min(1).parse(options.traceId ?? `salesprompter-cli-email-phantombuster-${Date.now()}`);
+        const requestPath = `${outDir}/email-enrichment-request-phantombuster.json`;
+        const responsePath = `${outDir}/email-enrichment-response-phantombuster.json`;
+        const requestPayload = {
+            traceId,
+            provider,
+            limit,
+            retryNotFoundAfterDays
+        };
+        await writeJsonFile(requestPath, requestPayload);
+        if (options.dryRun) {
+            printOutput({
+                status: "ok",
+                provider,
+                limit,
+                traceId,
+                dryRun: true,
+                mode: "workspace-queue",
+                contactsQueued: null,
+                started: false,
+                artifacts: {
+                    inputSqlPath: null,
+                    inputRowsPath: null,
+                    directReportPath: null,
+                    requestPath,
+                    responsePath: null
+                }
+            });
+            return;
+        }
+        const session = await requireAuthSession();
+        const result = await runLeadPoolEmailFinderViaApp(session, {
+            provider,
+            limit,
+            retryNotFoundAfterDays
+        });
+        await writeJsonFile(responsePath, result);
+        printOutput({
+            status: result.success ? "ok" : "partial",
+            provider,
+            limit,
+            traceId,
+            dryRun: false,
+            mode: "workspace-queue",
+            contactsQueued: result.selected,
+            started: Boolean(result.launched),
+            agentId: result.agentId ?? null,
+            containerId: result.containerId ?? null,
+            artifacts: {
+                inputSqlPath: null,
+                inputRowsPath: null,
+                directReportPath: null,
+                requestPath,
+                responsePath
+            }
+        });
+        return;
+    }
     let clientId;
     let queueRows;
     let directReportRows = null;

package/package.json

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