salesprompter-cli 0.1.68 → 0.1.70

package/README.md

@@ -109,7 +109,7 @@ salesprompter affiliate:grow \
   --send-from 09:00 \
   --send-to 16:00
 
-# Review the persisted sequence and enrichment summary, then activate explicitly
+# Verify live campaign state, lead safety, and contact activity, then activate explicitly
 salesprompter affiliate:list
 salesprompter affiliate:status "$AFFILIATE_RUN_ID"
 salesprompter affiliate:analytics "$AFFILIATE_RUN_ID"
@@ -139,6 +139,19 @@ salesprompter products:collect \
 
 Use a signed-in in-app-browser worker with the loopback `GET /task` and `POST /page` protocol. Interrupted, bounded, challenged, or rate-limited runs remain checkpointed and do not create the complete artifact.
 
+Enrich that proven order with public product-page details, without changing its ranks or uploading it:
+
+```bash
+salesprompter products:collect-details \
+  --catalog ./data/products.complete.json \
+  --checkpoint ./data/products.details.checkpoint.json \
+  --raw-jsonl ./data/products.details.raw.jsonl \
+  --out ./data/products.with-details.json \
+  --relay-port 43118
+```
+
+The detail worker uses the same local `GET /task` lease protocol and posts only allowlisted product fields to `POST /detail`. Public URLs must be HTTPS; product images are capped at 2,048 characters, other URLs at 4,096, descriptions at 10,000, other strings at 200, roles/features at 100 entries, and customer companies at 50. The final artifact is created only after every rank has either a complete detail page or explicit unavailable-page proof.
+
 Download stored workspace leads without starting a new Sales Navigator scrape:
 
 ```bash

package/dist/cli.js

@@ -28,6 +28,7 @@ import { buildHistoricalVendorIcp, buildVendorIcp } from "./icp-templates.js";
 import { InstantlySyncProvider } from "./instantly.js";
 import { backfillLinkedInCompanies } from "./linkedin-companies.js";
 import { parseLinkedInCompanyPage } from "./linkedin-companies.js";
+import { collectLinkedInProductDetailsViaBrowserRelay } from "./linkedin-product-details.js";
 import { collectLinkedInProductsViaBrowserRelay } from "./linkedin-product-search.js";
 import { crawlLinkedInProductCategory } from "./linkedin-products.js";
 import { claimLinkedInSessionCookieForCli, claimValidatedSalesNavigatorSessionCookieForCli, createLinkedInSessionSupabaseClient, recordLinkedInSessionCookieAudit, resolveConfiguredEnvValue } from "./linkedin-session.js";
@@ -246,6 +247,57 @@ const AffiliateOutreachResponseSchema = z.object({
     status: z.literal("ok"),
     outreach: AffiliateOutreachRunSchema
 });
+const AffiliateOutreachHealthSchema = z.object({
+    checkedAt: DatabaseTimestampSchema,
+    liveChecked: z.boolean(),
+    done: z.boolean(),
+    verdict: z.enum([
+        "preparing",
+        "failed",
+        "unavailable",
+        "not_running",
+        "ready_to_activate",
+        "running",
+        "unsafe_running"
+    ]),
+    running: z.boolean(),
+    activationReady: z.boolean(),
+    safeToSend: z.boolean(),
+    dataPreparationComplete: z.boolean(),
+    campaign: z
+        .object({
+        id: z.string().min(1),
+        name: z.string().min(1).nullable(),
+        status: z.number().int().nullable(),
+        statusLabel: z.string().min(1),
+        dailyLimit: z.number().nonnegative().nullable(),
+        sendingAccountCount: z.number().int().nonnegative()
+    })
+        .nullable(),
+    leads: z
+        .object({
+        total: z.number().int().nonnegative(),
+        active: z.number().int().nonnegative(),
+        inactive: z.number().int().nonnegative(),
+        verified: z.number().int().nonnegative(),
+        pendingVerification: z.number().int().nonnegative(),
+        invalid: z.number().int().nonnegative(),
+        unsafe: z.number().int().nonnegative(),
+        contacted: z.number().int().nonnegative(),
+        replied: z.number().int().nonnegative(),
+        statusCounts: z.record(z.string(), z.number().int().nonnegative()),
+        verificationStatusCounts: z.record(z.string(), z.number().int().nonnegative())
+    })
+        .nullable(),
+    blockers: z.array(z.object({
+        code: z.string().min(1),
+        message: z.string().min(1),
+        count: z.number().int().nonnegative().optional()
+    }))
+});
+const AffiliateOutreachLiveStatusResponseSchema = AffiliateOutreachResponseSchema.extend({
+    health: AffiliateOutreachHealthSchema
+});
 const AffiliateOutreachSummarySchema = AffiliateOutreachRunBaseSchema;
 const AffiliateAudienceSummarySchema = z.object({
     public_token: z.string().min(1),
@@ -626,7 +678,7 @@ const cliPacks = [
         slug: "research",
         title: "Research",
         summary: "Scrape markets and enrich companies before outreach.",
-        commands: ["products:collect", "market:scrape", "companies:enrich"],
+        commands: ["products:collect", "products:collect-details", "market:scrape", "companies:enrich"],
         installStatus: "included"
     },
     {
@@ -677,6 +729,7 @@ const helpAliasByCommandName = new Map([
     ["linkedin-companies:scrape-local", "companies:scrape-linkedin"],
     ["dealroom-companies:scrape-local", "companies:scrape-dealroom"],
     ["linkedin-products:collect", "products:collect"],
+    ["linkedin-products:collect-details", "products:collect-details"],
     ["linkedin-products:scrape", "market:scrape"],
     ["salesnav:from-product-category", "leads:discover"],
     ["salesnav:people:collect", "leads:collect"],
@@ -728,6 +781,7 @@ const helpVisibleCommandNames = new Set([
     "linkedin-companies:scrape-local",
     "dealroom-companies:scrape-local",
     "linkedin-products:collect",
+    "linkedin-products:collect-details",
     "linkedin-products:scrape",
     "salesnav:from-product-category",
     "salesnav:people:collect",
@@ -6762,6 +6816,35 @@ async function getAffiliateOutreachViaApp(session, audienceRunId) {
     }), AffiliateOutreachResponseSchema);
     return value.outreach;
 }
+async function getAffiliateOutreachLiveStatusViaApp(session, audienceRunId) {
+    const { value } = await fetchCliJson(session, (currentSession) => {
+        const url = new URL(`/api/cli/affiliate-outreach/${encodeURIComponent(audienceRunId)}`, currentSession.apiBaseUrl);
+        url.searchParams.set("live", "1");
+        return fetch(url, {
+            headers: {
+                Authorization: `Bearer ${currentSession.accessToken}`
+            }
+        });
+    }, AffiliateOutreachLiveStatusResponseSchema);
+    return value;
+}
+function describeAffiliateOutreachHealth(health) {
+    const leads = health.leads;
+    if (health.done && leads) {
+        return `Done: the campaign is running with ${leads.verified}/${leads.total} verified leads.`;
+    }
+    if (health.verdict === "unsafe_running" && leads) {
+        return `Attention: the campaign is running with ${leads.unsafe} unsafe leads.`;
+    }
+    if (health.verdict === "ready_to_activate" && leads) {
+        return `Ready to activate: ${leads.verified}/${leads.total} leads are verified.`;
+    }
+    if (health.liveChecked && leads) {
+        const campaignState = health.campaign?.statusLabel ?? "unknown";
+        return `Not done: the campaign is ${campaignState}; ${leads.verified}/${leads.total} leads are verified; ${leads.contacted} contacted.`;
+    }
+    return health.blockers[0]?.message ?? "Live campaign status could not be verified.";
+}
 async function getAffiliateOutreachAnalyticsViaApp(session, audienceRunId) {
     const { value } = await fetchCliJson(session, (currentSession) => fetch(`${currentSession.apiBaseUrl}/api/cli/affiliate-outreach/${encodeURIComponent(audienceRunId)}/analytics`, {
         headers: {
@@ -15105,11 +15188,18 @@ program
 });
 program
     .command("affiliate:status <run-id>")
-    .description("Show enrichment, sequence, Instantly, and activation status for an affiliate run.")
+    .description("Verify whether an affiliate campaign is prepared, safe, and actually running.")
     .action(async (runId) => {
     const session = await requireAuthSession();
-    const outreach = await getAffiliateOutreachViaApp(session, z.string().uuid().parse(runId));
-    printOutput({ status: "ok", outreach });
+    const result = await getAffiliateOutreachLiveStatusViaApp(session, z.string().uuid().parse(runId));
+    printOutput({
+        status: "ok",
+        done: result.health.done,
+        verdict: result.health.verdict,
+        message: describeAffiliateOutreachHealth(result.health),
+        health: result.health,
+        outreach: result.outreach
+    });
 });
 program
     .command("affiliate:analytics <run-id>")
@@ -15349,6 +15439,38 @@ program
     });
     printOutput(result);
 });
+program
+    .command("linkedin-products:collect-details")
+    .alias("products:collect-details")
+    .description("Enrich a proven LinkedIn product ranking locally through a resumable loopback browser relay.")
+    .requiredOption("--catalog <path>", "Complete products:collect ranking artifact path")
+    .requiredOption("--checkpoint <path>", "Private resumable product-detail checkpoint JSON path")
+    .requiredOption("--raw-jsonl <path>", "Private append-only normalized product-detail evidence path")
+    .requiredOption("--out <path>", "Complete public-fields-only enriched artifact path")
+    .requiredOption("--relay-port <number>", "Loopback relay port for GET /task and POST /detail")
+    .option("--max-requests <number>", "Optional number of unique product-detail tasks to issue in this run")
+    .action(async (options) => {
+    const relayPort = z.coerce.number().int().min(1).max(65_535).parse(options.relayPort);
+    const maxRequests = options.maxRequests === undefined
+        ? undefined
+        : z.coerce.number().int().min(1).max(100_000).parse(options.maxRequests);
+    const idleTimeoutMs = process.env.SALESPROMPTER_LINKEDIN_PRODUCT_DETAILS_RELAY_IDLE_TIMEOUT_MS
+        ? z.coerce.number().int().min(100).max(86_400_000).parse(process.env.SALESPROMPTER_LINKEDIN_PRODUCT_DETAILS_RELAY_IDLE_TIMEOUT_MS)
+        : undefined;
+    const result = await collectLinkedInProductDetailsViaBrowserRelay({
+        catalogPath: path.resolve(String(options.catalog)),
+        checkpointPath: path.resolve(String(options.checkpoint)),
+        rawJsonlPath: path.resolve(String(options.rawJsonl)),
+        outPath: path.resolve(String(options.out)),
+        relayPort,
+        maxRequests,
+        idleTimeoutMs,
+        onListening: ({ taskUrl, detailUrl }) => {
+            writeProgress(`LinkedIn product detail relay ready: GET ${taskUrl} and POST ${detailUrl}`);
+        }
+    });
+    printOutput(result);
+});
 program
     .command("linkedin-products:scrape")
     .alias("market:scrape")