salesprompter-cli 0.1.27 → 0.1.30

package/dist/cli.js

@@ -25,7 +25,7 @@ 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 } from "./linkedin-session.js";
+import { claimValidatedSalesNavigatorSessionCookieForCli, createLinkedInSessionSupabaseClient, resolveConfiguredEnvValue } from "./linkedin-session.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";
@@ -42,6 +42,14 @@ const runtimeOutputOptions = {
     quiet: false
 };
 const nullableOptionalString = z.string().min(1).nullish().transform((value) => value ?? undefined);
+const LinkedInCompanyBackfillClientIdStateSchema = z
+    .object({
+    clientId: z.number().int().positive(),
+    userId: z.string().optional(),
+    orgId: z.string().optional(),
+    updatedAt: z.string().datetime()
+})
+    .passthrough();
 const WorkspaceLeadSchema = LeadSchema.extend({
     companySize: nullableOptionalString.optional(),
     country: nullableOptionalString.optional()
@@ -66,6 +74,9 @@ const LinkedInCompanyBackfillLaunchResponseSchema = z.object({
     webhookUrl: z.string().url(),
     inputUrl: z.string().url().nullable(),
     containerId: z.string().min(1).nullable(),
+    selectedSessionCookieSha256: z.string().min(1).nullable().optional(),
+    selectedSessionUserEmail: z.string().min(1).nullable().optional(),
+    selectedSessionUserHandle: z.string().min(1).nullable().optional(),
     candidates: z.array(z.object({
         companyId: z.number().int().positive(),
         companyUrl: z.string().url(),
@@ -78,7 +89,10 @@ const LinkedInCompanyBackfillStatusResponseSchema = z.object({
     containerId: z.string().min(1),
     running: z.boolean(),
     processed: z.boolean(),
-    remaining: z.number().int().nonnegative()
+    remaining: z.number().int().nonnegative(),
+    failed: z.boolean().default(false),
+    failureCode: z.string().nullable().optional(),
+    failureMessage: z.string().nullable().optional()
 });
 const CliEmailEnrichmentCompaniesResponseSchema = z.object({
     clientId: z.number().int().positive(),
@@ -280,6 +294,7 @@ const cliPacks = [
 ];
 const helpAliasByCommandName = new Map([
     ["contacts:find-linkedin-urls", "contacts:resolve-profiles"],
+    ["companies:find-linkedin-urls", "companies:resolve-linkedin-urls"],
     ["contacts:process-emails", "contacts:resolve-emails"],
     ["linkedin-companies:backfill", "companies:enrich"],
     ["linkedin-products:scrape", "market:scrape"],
@@ -300,6 +315,7 @@ const helpVisibleCommandNames = new Set([
     "auth:whoami",
     "llm:ready",
     "contacts:find-linkedin-urls",
+    "companies:find-linkedin-urls",
     "contacts:process-emails",
     "auth:logout",
     "account:resolve",
@@ -339,6 +355,64 @@ function formatHelpArgumentTerm(argument) {
     }
     return argument.required ? `<${term}>` : `[${term}]`;
 }
+function parsePositiveClientIdValue(rawValue) {
+    if (rawValue == null) {
+        throw new Error("clientId is required and must be a positive integer.");
+    }
+    const asString = String(rawValue).trim();
+    if (!asString) {
+        throw new Error("clientId is required and must be a positive integer.");
+    }
+    return z.coerce.number().int().positive().parse(asString);
+}
+function getLinkedInCompanyBackfillClientStatePath() {
+    return path.join(getSalesprompterConfigDir(), "linkedin-companies-backfill.json");
+}
+async function readLinkedInCompanyBackfillClientIdFromCache(session) {
+    const path = getLinkedInCompanyBackfillClientStatePath();
+    try {
+        const content = await readFile(path, "utf8");
+        const parsed = JSON.parse(content);
+        const state = LinkedInCompanyBackfillClientIdStateSchema.parse(parsed);
+        if (session?.user?.id != null && state.userId != null && state.userId !== session.user.id) {
+            return undefined;
+        }
+        if (session?.user?.orgId != null &&
+            state.orgId != null &&
+            String(state.orgId) !== String(session.user.orgId)) {
+            return undefined;
+        }
+        return state.clientId;
+    }
+    catch {
+        return undefined;
+    }
+}
+async function writeLinkedInCompanyBackfillClientIdToCache(clientId, session) {
+    const filePath = getLinkedInCompanyBackfillClientStatePath();
+    const state = {
+        clientId,
+        userId: session?.user?.id,
+        orgId: session?.user?.orgId,
+        updatedAt: new Date().toISOString()
+    };
+    await mkdir(path.dirname(filePath), { recursive: true });
+    await writeFile(filePath, `${JSON.stringify(state, null, 2)}\n`, "utf8");
+}
+async function resolveLinkedInCompanyBackfillClientId(params) {
+    if (params.clientIdOption != null && String(params.clientIdOption).trim().length > 0) {
+        return parsePositiveClientIdValue(params.clientIdOption);
+    }
+    const envClientId = process.env.PIPEDREAM_CLIENT_ID?.trim() || process.env.SALESPROMPTER_CLIENT_ID?.trim();
+    if (envClientId) {
+        return parsePositiveClientIdValue(envClientId);
+    }
+    const cachedClientId = await readLinkedInCompanyBackfillClientIdFromCache(params.session);
+    if (cachedClientId != null) {
+        return cachedClientId;
+    }
+    throw new Error("Missing LinkedIn company backfill clientId. Pass --client-id, set PIPEDREAM_CLIENT_ID or SALESPROMPTER_CLIENT_ID, or run once with --client-id so the CLI can reuse it.");
+}
 function applyGlobalOutputOptions(actionCommand) {
     const globalOptions = actionCommand.optsWithGlobals();
     runtimeOutputOptions.json = Boolean(globalOptions.json);
@@ -920,6 +994,55 @@ function parseLinkedInUrlLookupInput(content) {
     }))
         .filter((row) => row.fullName.length > 0 || row.companyName.length > 0);
 }
+function parseLinkedInCompanyLookupInput(content) {
+    const trimmed = content.trim();
+    if (!trimmed) {
+        return [];
+    }
+    if (trimmed.startsWith("[")) {
+        const parsed = z
+            .array(z.object({
+            clientId: z.union([z.string(), z.number()]).nullish(),
+            companyName: z.string().nullish(),
+            name: z.string().nullish()
+        }))
+            .parse(JSON.parse(trimmed));
+        return parsed
+            .map((row) => ({
+            clientId: row.clientId == null ? null : String(row.clientId).trim() || null,
+            companyName: normalizeLookupWhitespace(row.companyName?.trim() || row.name?.trim() || "")
+        }))
+            .filter((row) => row.companyName.length > 0);
+    }
+    const lines = trimmed
+        .split(/\r?\n/)
+        .map((line) => line.trim())
+        .filter((line) => line.length > 0);
+    if (lines.length === 0) {
+        return [];
+    }
+    const delimiter = detectLooseDelimiter(lines[0] ?? "");
+    const headerValues = splitLooseDelimitedLine(lines[0] ?? "", delimiter).map((value) => value.trim().toLowerCase());
+    const hasHeader = headerValues.includes("companyname") ||
+        headerValues.includes("company_name") ||
+        headerValues.includes("name");
+    if (hasHeader) {
+        const companyNameIndex = headerValues.findIndex((value) => ["companyname", "company_name", "name"].includes(value));
+        const clientIdIndex = headerValues.findIndex((value) => ["clientid", "client_id"].includes(value));
+        return lines
+            .slice(1)
+            .map((line) => splitLooseDelimitedLine(line, delimiter).map((value) => value.trim()))
+            .map((columns) => ({
+            clientId: clientIdIndex >= 0 ? columns[clientIdIndex] || null : null,
+            companyName: normalizeLookupWhitespace(companyNameIndex >= 0 ? columns[companyNameIndex] || "" : "")
+        }))
+            .filter((row) => row.companyName.length > 0);
+    }
+    return lines.map((line) => ({
+        clientId: null,
+        companyName: normalizeLookupWhitespace(line)
+    }));
+}
 function toLinkedInUrlLookupContacts(rows, cleanedCompanyMap = new Map()) {
     return rows.flatMap((row, index) => {
         const contactId = String(index + 1);
@@ -972,19 +1095,19 @@ function toLinkedInUrlLookupContacts(rows, cleanedCompanyMap = new Map()) {
     });
 }
 function readPipedreamLinkedInEnrichmentConfig() {
-    const endpointUrl = process.env.SALESPROMPTER_LINKEDIN_ENRICHMENT_ENDPOINT_URL?.trim() ||
-        (process.env.PIPEDREAM_ENDPOINT_ID?.trim()
-            ? `https://${process.env.PIPEDREAM_ENDPOINT_ID.trim()}.m.pipedream.net`
+    const endpointUrl = resolveConfiguredEnvValue(process.env, "SALESPROMPTER_LINKEDIN_ENRICHMENT_ENDPOINT_URL") ||
+        (resolveConfiguredEnvValue(process.env, "PIPEDREAM_ENDPOINT_ID")
+            ? `https://${resolveConfiguredEnvValue(process.env, "PIPEDREAM_ENDPOINT_ID")?.trim()}.m.pipedream.net`
             : "");
     if (!endpointUrl) {
         throw new Error("Missing LinkedIn enrichment endpoint. Set SALESPROMPTER_LINKEDIN_ENRICHMENT_ENDPOINT_URL or PIPEDREAM_ENDPOINT_ID.");
     }
     return {
         endpointUrl,
-        secret: process.env.PIPEDREAM_SECRET_KEY?.trim() || "",
-        clientId: process.env.PIPEDREAM_CLIENT_ID?.trim() || "",
-        projectId: process.env.PIPEDREAM_PROJECT_ID?.trim() || "",
-        projectEnvironment: process.env.PIPEDREAM_PROJECT_ENVIRONMENT?.trim() || ""
+        secret: resolveConfiguredEnvValue(process.env, "PIPEDREAM_SECRET_KEY") || "",
+        clientId: resolveConfiguredEnvValue(process.env, "PIPEDREAM_CLIENT_ID") || "",
+        projectId: resolveConfiguredEnvValue(process.env, "PIPEDREAM_PROJECT_ID") || "",
+        projectEnvironment: resolveConfiguredEnvValue(process.env, "PIPEDREAM_PROJECT_ENVIRONMENT") || ""
     };
 }
 function deriveCsrfTokenFromCookie(cookie) {
@@ -1128,10 +1251,108 @@ function buildLinkedInLookupSearchVariants(contact) {
     }
     return variants;
 }
+function normalizeSalesNavLeadUrl(value) {
+    const trimmed = String(value ?? "").trim();
+    if (!trimmed) {
+        return null;
+    }
+    const directMatch = trimmed.match(/https:\/\/www\.linkedin\.com\/sales\/lead\/[^/?#]+/i);
+    if (directMatch) {
+        return directMatch[0] ?? null;
+    }
+    const disguisedLeadIdMatch = trimmed.match(/https:\/\/www\.linkedin\.com\/in\/(ACw[A-Za-z0-9_-]+)/i);
+    if (disguisedLeadIdMatch?.[1]) {
+        return `https://www.linkedin.com/sales/lead/${disguisedLeadIdMatch[1]}`;
+    }
+    return null;
+}
+function normalizePublicLinkedInProfileUrl(value) {
+    const trimmed = String(value ?? "").trim();
+    if (!trimmed) {
+        return null;
+    }
+    const publicMatch = trimmed.match(/https:\/\/www\.linkedin\.com\/in\/[^/?#]+\/?/i);
+    if (!publicMatch) {
+        return null;
+    }
+    const candidate = publicMatch[0] ?? null;
+    if (!candidate) {
+        return null;
+    }
+    return normalizeSalesNavLeadUrl(candidate) ? null : candidate;
+}
 function extractLinkedInProfileUrlFromSalesApiElement(element) {
-    const entityUrn = typeof element?.entityUrn === "string" ? element.entityUrn : "";
+    if (!element) {
+        return null;
+    }
+    const explicitCandidates = [
+        typeof element.linkedinProfileUrl === "string" ? element.linkedinProfileUrl : null,
+        typeof element.profileUrl === "string" ? element.profileUrl : null,
+        typeof element.url === "string" ? element.url : null
+    ].filter(Boolean);
+    for (const candidate of explicitCandidates) {
+        const normalized = normalizePublicLinkedInProfileUrl(candidate);
+        if (normalized) {
+            return normalized;
+        }
+    }
+    for (const value of collectNestedStrings(element)) {
+        const normalized = normalizePublicLinkedInProfileUrl(value);
+        if (normalized) {
+            return normalized;
+        }
+    }
+    return null;
+}
+function extractLinkedInSalesNavLeadUrlFromSalesApiElement(element) {
+    if (!element) {
+        return null;
+    }
+    const explicitCandidates = [
+        typeof element.salesNavProfileUrl === "string" ? element.salesNavProfileUrl : null,
+        typeof element.sales_nav_profile_url === "string" ? element.sales_nav_profile_url : null,
+        typeof element.url === "string" ? element.url : null
+    ].filter(Boolean);
+    for (const candidate of explicitCandidates) {
+        const normalized = normalizeSalesNavLeadUrl(candidate);
+        if (normalized) {
+            return normalized;
+        }
+    }
+    for (const value of collectNestedStrings(element)) {
+        const normalized = normalizeSalesNavLeadUrl(value);
+        if (normalized) {
+            return normalized;
+        }
+    }
+    const entityUrn = typeof element.entityUrn === "string" ? element.entityUrn : "";
     const salesIdMatch = entityUrn.match(/\(([^,]+),/);
-    return salesIdMatch ? `https://www.linkedin.com/in/${salesIdMatch[1]}` : null;
+    return salesIdMatch?.[1] ? `https://www.linkedin.com/sales/lead/${salesIdMatch[1]}` : null;
+}
+function extractLinkedInSalesNavCompanyUrlFromSalesApiElement(element) {
+    if (!element) {
+        return null;
+    }
+    const explicitCandidates = [
+        typeof element.salesNavCompanyUrl === "string" ? element.salesNavCompanyUrl : null,
+        typeof element.sales_nav_company_url === "string" ? element.sales_nav_company_url : null,
+        typeof element.url === "string" ? element.url : null
+    ].filter(Boolean);
+    for (const candidate of explicitCandidates) {
+        const directMatch = candidate.match(/https:\/\/www\.linkedin\.com\/sales\/company\/[^/?#]+/i);
+        if (directMatch) {
+            return directMatch[0] ?? null;
+        }
+    }
+    for (const value of collectNestedStrings(element)) {
+        const directMatch = value.match(/https:\/\/www\.linkedin\.com\/sales\/company\/[^/?#]+/i);
+        if (directMatch) {
+            return directMatch[0] ?? null;
+        }
+    }
+    const entityUrn = typeof element.entityUrn === "string" ? element.entityUrn : "";
+    const idMatch = entityUrn.match(/\(([^,]+),/);
+    return idMatch?.[1] ? `https://www.linkedin.com/sales/company/${idMatch[1]}` : null;
 }
 function collectNestedStrings(value, seen = new Set()) {
     if (value == null || seen.has(value)) {
@@ -1248,6 +1469,280 @@ function buildLinkedInCompanyLookupVariants(params) {
     }
     return variants;
 }
+function buildPublicLinkedInCompanySearchUrl(companyName) {
+    const baseUrl = process.env.SALESPROMPTER_LINKEDIN_COMPANY_SEARCH_BASE_URL?.trim() ||
+        "https://duckduckgo.com/html/";
+    const url = new URL(baseUrl);
+    url.searchParams.set("q", `site:linkedin.com/company "${companyName}"`);
+    return url.toString();
+}
+function getSerperApiKey(env = process.env) {
+    return env.SALESPROMPTER_SERPER_API_KEY?.trim() || env.SERPER_API_KEY?.trim() || "";
+}
+function getSerperSearchEndpoint(env = process.env) {
+    return env.SALESPROMPTER_SERPER_SEARCH_URL?.trim() || "https://google.serper.dev/search";
+}
+function buildSerperLinkedInCompanyQueries(companyName) {
+    const normalized = normalizeLookupWhitespace(companyName);
+    const coreName = normalized.split(/\s*[-,|]\s*/)[0]?.trim() || normalized.trim();
+    const searchable = normalizeLookupCompanyForSearch(normalized);
+    const loose = normalizeLooseMatchText(normalized).replace(/\s+/g, " ").trim();
+    const keywordTokens = loose
+        .split(/\s+/)
+        .filter((token) => token.length >= 4)
+        .filter((token) => !["oder", "with", "from", "handel", "beratung"].includes(token))
+        .slice(0, 4);
+    const keywordQuery = keywordTokens.join(" ");
+    return Array.from(new Set([
+        `site:linkedin.com/company "${companyName}"`,
+        `site:linkedin.com/company "${coreName}"`,
+        `site:linkedin.com/company ${searchable} linkedin`,
+        `site:linkedin.com/company ${loose} linkedin`,
+        keywordQuery ? `site:linkedin.com/company ${keywordQuery} linkedin` : ""
+    ])).filter((query) => query.length > 0);
+}
+function extractLinkedInCompanySearchCandidates(bodyText) {
+    const candidates = new Set();
+    const directMatches = bodyText.match(/https:\/\/www\.linkedin\.com\/company\/[^"'&<>\s)]+/gi) ?? [];
+    for (const match of directMatches) {
+        const handle = normalizeLinkedInCompanyHandle(match);
+        if (handle) {
+            candidates.add(normalizeLinkedInCompanyPage(handle));
+        }
+    }
+    const encodedMatches = bodyText.match(/https?%3A%2F%2Fwww\.linkedin\.com%2Fcompany%2F[^"'&<>\s)]+/gi) ?? [];
+    for (const match of encodedMatches) {
+        try {
+            const decoded = decodeURIComponent(match);
+            const handle = normalizeLinkedInCompanyHandle(decoded);
+            if (handle) {
+                candidates.add(normalizeLinkedInCompanyPage(handle));
+            }
+        }
+        catch {
+            // Ignore malformed encoded fragments from search result pages.
+        }
+    }
+    return Array.from(candidates);
+}
+function extractSerperLinkedInCompanyCandidates(payload) {
+    if (!payload || typeof payload !== "object") {
+        return [];
+    }
+    const organic = "organic" in payload && Array.isArray(payload.organic)
+        ? (payload.organic ?? [])
+        : [];
+    const candidates = new Set();
+    for (const result of organic) {
+        if (!result || typeof result !== "object") {
+            continue;
+        }
+        const link = "link" in result && typeof result.link === "string"
+            ? result.link
+            : "";
+        const handle = normalizeLinkedInCompanyHandle(link);
+        if (handle) {
+            candidates.add(normalizeLinkedInCompanyPage(handle));
+        }
+    }
+    return Array.from(candidates);
+}
+function decodeHtmlEntities(value) {
+    return value
+        .replace(/&amp;/gi, "&")
+        .replace(/&quot;/gi, '"')
+        .replace(/&#39;/gi, "'")
+        .replace(/&lt;/gi, "<")
+        .replace(/&gt;/gi, ">");
+}
+async function fetchLinkedInCompanyPageSignals(url, timeoutMs) {
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), Math.min(timeoutMs, 12_000));
+    try {
+        const response = await fetch(url, {
+            method: "GET",
+            signal: controller.signal,
+            headers: {
+                "user-agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/146.0.0.0 Safari/537.36"
+            }
+        });
+        const html = await response.text();
+        const finalUrl = response.url || url;
+        const title = decodeHtmlEntities(html.match(/<title[^>]*>([^<]+)/i)?.[1] || "") ||
+            decodeHtmlEntities(html.match(/<meta[^>]+property="og:title"[^>]+content="([^"]+)/i)?.[1] || "");
+        const description = decodeHtmlEntities(html.match(/<meta[^>]+name="description"[^>]+content="([^"]+)/i)?.[1] || "");
+        const bodyText = decodeHtmlEntities(html.replace(/<script[\s\S]*?<\/script>/gi, " ").replace(/<style[\s\S]*?<\/style>/gi, " ").replace(/<[^>]+>/g, " "));
+        const unavailableText = normalizeLooseMatchText(`${title} ${description} ${bodyText}`);
+        const unavailable = response.status >= 400 ||
+            unavailableText.includes("page not found") ||
+            unavailableText.includes("this page does not exist") ||
+            unavailableText.includes("page isnt available");
+        const handle = normalizeLinkedInCompanyHandle(finalUrl) ?? normalizeLinkedInCompanyHandle(url);
+        if (!handle) {
+            return null;
+        }
+        return {
+            normalizedUrl: normalizeLinkedInCompanyPage(handle),
+            title: normalizeLookupWhitespace(title),
+            description: normalizeLookupWhitespace(description),
+            bodyText: normalizeLookupWhitespace(bodyText),
+            unavailable
+        };
+    }
+    catch {
+        return null;
+    }
+    finally {
+        clearTimeout(timeout);
+    }
+}
+function scoreLinkedInCompanyPageSignals(companyName, signals) {
+    const inputTokens = normalizeLooseMatchText(companyName).split(/\s+/).filter((token) => token.length >= 4);
+    const haystack = normalizeLooseMatchText(`${signals.title} ${signals.description}`);
+    let score = 0;
+    for (const token of inputTokens) {
+        if (haystack.includes(token)) {
+            score += 12;
+        }
+    }
+    if (signals.description && normalizeLooseMatchText(signals.description).includes(normalizeLooseMatchText(companyName))) {
+        score += 50;
+    }
+    return score;
+}
+function scoreLinkedInCompanyUrlCandidate(companyName, url) {
+    const handle = normalizeLinkedInCompanyHandle(url);
+    if (!handle || /^\d+$/.test(handle)) {
+        return 0;
+    }
+    const normalizedCompanyWords = normalizeLookupCompanyForSearch(companyName)
+        .split(/\s+/)
+        .filter((part) => part.length >= 3);
+    const normalizedCompany = normalizedCompanyWords.join("");
+    const aggressiveCompany = aggressivelyCleanLookupCompanyName(companyName).replace(/\s+/g, "");
+    const normalizedHandle = handle.toLowerCase().replace(/[-_]/g, "");
+    const slugCompany = (slugify(companyName) || "").replace(/-/g, "");
+    let score = 0;
+    if (normalizedHandle === normalizedCompany || normalizedHandle === aggressiveCompany || normalizedHandle === slugCompany) {
+        score += 100;
+    }
+    if (normalizedCompany &&
+        (normalizedHandle.includes(normalizedCompany) || normalizedCompany.includes(normalizedHandle))) {
+        score += 60;
+    }
+    if (aggressiveCompany &&
+        (normalizedHandle.includes(aggressiveCompany) || aggressiveCompany.includes(normalizedHandle))) {
+        score += 40;
+    }
+    if (normalizedCompanyWords.length > 0) {
+        const primaryWord = normalizedCompanyWords[0] ?? "";
+        if (primaryWord && normalizedHandle.includes(primaryWord)) {
+            score += 35;
+        }
+        const overlap = normalizedCompanyWords.filter((word) => normalizedHandle.includes(word)).length;
+        score += Math.min(30, overlap * 10);
+    }
+    return score;
+}
+async function searchPublicLinkedInCompanyUrl(companyName, timeoutMs) {
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), Math.min(timeoutMs, 15_000));
+    try {
+        const response = await fetch(buildPublicLinkedInCompanySearchUrl(companyName), {
+            method: "GET",
+            signal: controller.signal,
+            headers: {
+                "user-agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/146.0.0.0 Safari/537.36"
+            }
+        });
+        if (!response.ok) {
+            return null;
+        }
+        const bodyText = await response.text();
+        const candidates = extractLinkedInCompanySearchCandidates(bodyText);
+        const ranked = candidates
+            .map((url) => ({ url, score: scoreLinkedInCompanyUrlCandidate(companyName, url) }))
+            .filter((candidate) => candidate.score > 0)
+            .sort((left, right) => right.score - left.score);
+        return ranked[0]?.url ?? candidates[0] ?? null;
+    }
+    catch (error) {
+        if (error.name === "AbortError") {
+            return null;
+        }
+        return null;
+    }
+    finally {
+        clearTimeout(timeout);
+    }
+}
+async function searchSerperLinkedInCompanyUrl(companyName, timeoutMs) {
+    const apiKey = getSerperApiKey();
+    if (!apiKey) {
+        return null;
+    }
+    for (const query of buildSerperLinkedInCompanyQueries(companyName)) {
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), Math.min(timeoutMs, 15_000));
+        try {
+            const response = await fetch(getSerperSearchEndpoint(), {
+                method: "POST",
+                signal: controller.signal,
+                headers: {
+                    "Content-Type": "application/json",
+                    "X-API-KEY": apiKey
+                },
+                body: JSON.stringify({
+                    q: query,
+                    num: 5
+                })
+            });
+            if (!response.ok) {
+                continue;
+            }
+            const parsed = (await response.json());
+            const candidates = extractSerperLinkedInCompanyCandidates(parsed);
+            const ranked = candidates
+                .map((url) => ({ url, score: scoreLinkedInCompanyUrlCandidate(companyName, url) }))
+                .filter((candidate) => candidate.score > 0)
+                .sort((left, right) => right.score - left.score);
+            let anySignalsFetched = false;
+            let bestValidated = null;
+            for (const candidate of ranked.slice(0, 3)) {
+                const signals = await fetchLinkedInCompanyPageSignals(candidate.url, timeoutMs);
+                if (!signals || signals.unavailable) {
+                    continue;
+                }
+                anySignalsFetched = true;
+                const validationScore = scoreLinkedInCompanyPageSignals(companyName, signals);
+                if (validationScore >= 24) {
+                    const combinedScore = candidate.score + validationScore;
+                    if (!bestValidated || combinedScore > bestValidated.score) {
+                        bestValidated = {
+                            url: signals.normalizedUrl,
+                            score: combinedScore
+                        };
+                    }
+                }
+            }
+            if (bestValidated) {
+                return bestValidated.url;
+            }
+            if (!anySignalsFetched && ranked[0]?.url) {
+                return ranked[0].url;
+            }
+        }
+        catch (error) {
+            if (error.name === "AbortError") {
+                continue;
+            }
+        }
+        finally {
+            clearTimeout(timeout);
+        }
+    }
+    return null;
+}
 async function invokeLinkedInUrlEnrichmentDirect(params) {
     const config = await readLinkedInDirectLookupConfig();
     const groupedContacts = new Map();
@@ -1279,6 +1774,7 @@ async function invokeLinkedInUrlEnrichmentDirect(params) {
             continue;
         }
         let matchedUrl = null;
+        let matchedSalesNavUrl = null;
         let lastError = null;
         for (const candidate of variations) {
             for (const searchVariant of buildLinkedInLookupSearchVariants(candidate)) {
@@ -1315,8 +1811,10 @@ async function invokeLinkedInUrlEnrichmentDirect(params) {
                     const data = (await response.json());
                     const profilesFound = data.paging?.total ?? 0;
                     if (profilesFound > 0) {
-                        matchedUrl = extractLinkedInProfileUrlFromSalesApiElement(data.elements?.[0]) ?? null;
-                        if (matchedUrl) {
+                        const first = data.elements?.[0];
+                        matchedUrl = extractLinkedInProfileUrlFromSalesApiElement(first) ?? null;
+                        matchedSalesNavUrl = extractLinkedInSalesNavLeadUrlFromSalesApiElement(first) ?? null;
+                        if (matchedUrl || matchedSalesNavUrl) {
                             break;
                         }
                     }
@@ -1327,18 +1825,19 @@ async function invokeLinkedInUrlEnrichmentDirect(params) {
                 finally {
                     clearTimeout(timeout);
                 }
-                if (matchedUrl || rateLimited) {
+                if (matchedUrl || matchedSalesNavUrl || rateLimited) {
                     break;
                 }
             }
-            if (matchedUrl || rateLimited) {
+            if (matchedUrl || matchedSalesNavUrl || rateLimited) {
                 break;
             }
         }
         results.push({
             contact_id: primary.contact_id,
-            linkedin_url: matchedUrl,
-            error: matchedUrl ? null : lastError
+            linkedin_url: matchedUrl ?? matchedSalesNavUrl,
+            sales_nav_profile_url: matchedSalesNavUrl,
+            error: matchedUrl || matchedSalesNavUrl ? null : lastError
         });
     }
     return {
@@ -1372,6 +1871,7 @@ async function invokeLinkedInCompanyEnrichmentDirect(params) {
             companyNameOriginal: contact.companyNameOriginal
         });
         let matchedCompanyUrl = null;
+        let matchedSalesNavCompanyUrl = null;
         let matchedCompanyName = null;
         let matchedCompanyEmployeeCount = null;
         let lastError = null;
@@ -1410,8 +1910,10 @@ async function invokeLinkedInCompanyEnrichmentDirect(params) {
                 const data = (await response.json());
                 const first = data.elements?.[0];
                 const companyUrl = extractLinkedInCompanyUrlFromSalesApiElement(first);
-                if (companyUrl) {
+                const salesNavCompanyUrl = extractLinkedInSalesNavCompanyUrlFromSalesApiElement(first);
+                if (companyUrl || salesNavCompanyUrl) {
                     matchedCompanyUrl = companyUrl;
+                    matchedSalesNavCompanyUrl = salesNavCompanyUrl;
                     matchedCompanyName = extractLinkedInCompanyNameFromSalesApiElement(first);
                     matchedCompanyEmployeeCount = extractLinkedInCompanyEmployeeCountFromSalesApiElement(first);
                     break;
@@ -1430,9 +1932,10 @@ async function invokeLinkedInCompanyEnrichmentDirect(params) {
         results.push({
             contact_id: contact.contact_id,
             linkedin_company_url: matchedCompanyUrl,
+            sales_nav_company_url: matchedSalesNavCompanyUrl,
             matched_company_name: matchedCompanyName,
             matched_company_employee_count: matchedCompanyEmployeeCount,
-            error: matchedCompanyUrl ? null : lastError
+            error: matchedCompanyUrl || matchedSalesNavCompanyUrl ? null : lastError
         });
     }
     return {
@@ -1513,6 +2016,67 @@ async function invokeLinkedInUrlEnrichmentWorkflow(params) {
         clearTimeout(timeout);
     }
 }
+function normalizeWorkflowLinkedInUrlResult(params) {
+    const contactIdsBySyntheticEmail = new Map(params.contacts
+        .filter((contact) => contact.email)
+        .map((contact) => [String(contact.email).toLowerCase(), contact.contact_id]));
+    const rowsByContactId = new Map();
+    const body = params.parsedBody && typeof params.parsedBody === "object" && !Array.isArray(params.parsedBody)
+        ? params.parsedBody
+        : null;
+    const workflowRows = [
+        ...(Array.isArray(body?.contacts) ? body?.contacts : []),
+        ...(Array.isArray(body?.profiles) ? body?.profiles : [])
+    ];
+    for (const contact of workflowRows) {
+        const explicitContactId = typeof contact.contact_id === "string"
+            ? contact.contact_id
+            : typeof contact.contact_id === "number"
+                ? String(contact.contact_id)
+                : "";
+        const emailKey = typeof contact.email === "string" ? contact.email.toLowerCase() : "";
+        const contactId = explicitContactId || contactIdsBySyntheticEmail.get(emailKey) || "";
+        const linkedinUrl = normalizePublicLinkedInProfileUrl(typeof contact.linkedin_profile_url === "string"
+            ? contact.linkedin_profile_url
+            : typeof contact.linkedinProfileUrl === "string"
+                ? contact.linkedinProfileUrl
+                : typeof contact.default_profile_url === "string"
+                    ? contact.default_profile_url
+                    : typeof contact.defaultProfileUrl === "string"
+                        ? contact.defaultProfileUrl
+                        : typeof contact.linkedin_url === "string"
+                            ? contact.linkedin_url
+                            : typeof contact.linkedinUrl === "string"
+                                ? contact.linkedinUrl
+                                : null);
+        const salesNavProfileUrl = normalizeSalesNavLeadUrl(typeof contact.sales_nav_profile_url === "string"
+            ? contact.sales_nav_profile_url
+            : typeof contact.salesNavProfileUrl === "string"
+                ? contact.salesNavProfileUrl
+                : typeof contact.linkedin_url === "string"
+                    ? contact.linkedin_url
+                    : typeof contact.linkedinUrl === "string"
+                        ? contact.linkedinUrl
+                        : null) ?? null;
+        const regularCompanyHandle = normalizeLinkedInCompanyHandle(typeof contact.regular_company_url === "string"
+            ? contact.regular_company_url
+            : typeof contact.regularCompanyUrl === "string"
+                ? contact.regularCompanyUrl
+                : "");
+        const linkedinCompanyUrl = extractLinkedInCompanyUrlFromSalesApiElement(contact) ??
+            (regularCompanyHandle ? normalizeLinkedInCompanyPage(regularCompanyHandle) : null);
+        const salesNavCompanyUrl = extractLinkedInSalesNavCompanyUrlFromSalesApiElement(contact);
+        if (contactId) {
+            rowsByContactId.set(contactId, {
+                linkedinUrl: linkedinUrl ?? salesNavProfileUrl,
+                salesNavProfileUrl,
+                linkedinCompanyUrl,
+                salesNavCompanyUrl
+            });
+        }
+    }
+    return rowsByContactId;
+}
 async function fetchSalesNavLookupCandidates(params) {
     const supabaseUrl = process.env.NEXT_PUBLIC_SUPABASE_URL?.trim();
     const serviceRoleKey = process.env.SUPABASE_SERVICE_ROLE_KEY?.trim();
@@ -1594,6 +2158,7 @@ async function resolveLinkedInUrlsFromSalesNavRows(params) {
             return right.score - left.score || Number(Boolean(rightUrl)) - Number(Boolean(leftUrl));
         });
         const best = ranked[0]?.candidate;
+        const salesNavProfileUrl = best?.salesNavProfileUrl ?? null;
         const linkedinUrl = best?.linkedInProfileUrl ?? best?.salesNavProfileUrl ?? null;
         const linkedinCompanyUrl = (() => {
             const handle = normalizeLinkedInCompanyHandle(best?.regularCompanyUrl ?? "") ??
@@ -1604,12 +2169,17 @@ async function resolveLinkedInUrlsFromSalesNavRows(params) {
             const numericCompanyUrl = typeof best?.companyUrl === "string" ? best.companyUrl.trim() : "";
             return numericCompanyUrl.length > 0 ? numericCompanyUrl : null;
         })();
+        const salesNavCompanyUrl = typeof best?.companyUrl === "string" && /\/sales\/company\//i.test(best.companyUrl)
+            ? best.companyUrl
+            : null;
         results.push({
             clientId: row.clientId,
             fullName: row.fullName,
             companyName: row.companyName,
             linkedinUrl,
+            salesNavProfileUrl,
             linkedinCompanyUrl,
+            salesNavCompanyUrl,
             found: Boolean(linkedinUrl),
             companyFound: Boolean(linkedinCompanyUrl),
             contactId: String(index + 1),
@@ -1679,7 +2249,16 @@ function normalizeLinkedInCompanyHandle(value) {
     }
     try {
         const url = new URL(trimmed);
-        if (!/(^|\.)linkedin\.com$/i.test(url.hostname)) {
+        const overrideHostname = (() => {
+            try {
+                const overrideBase = process.env.SALESPROMPTER_LINKEDIN_BASE_URL?.trim();
+                return overrideBase ? new URL(overrideBase).hostname : "";
+            }
+            catch {
+                return "";
+            }
+        })();
+        if (!/(^|\.)linkedin\.com$/i.test(url.hostname) && (!overrideHostname || url.hostname !== overrideHostname)) {
             return null;
         }
         const segments = url.pathname.split("/").filter((segment) => segment.length > 0);
@@ -1961,14 +2540,8 @@ function writeWizardSection(title, description) {
     }
     writeWizardLine();
 }
-function isOpaqueOrgId(value) {
-    return /^org_[A-Za-z0-9]+$/.test(value);
-}
 function getOrgLabel(session) {
     const label = session.user.orgName ?? session.user.orgSlug ?? session.user.orgId ?? null;
-    if (label && isOpaqueOrgId(label)) {
-        return null;
-    }
     return label;
 }
 function resolveSessionOrgId(session) {
@@ -2192,13 +2765,19 @@ async function promptYesNo(rl, prompt, defaultValue) {
 }
 async function ensureWizardSession(options) {
     if (shouldBypassAuth()) {
-        return null;
+        return {
+            session: null,
+            restoredFromCache: false
+        };
     }
     try {
         const session = await requireAuthSession();
         writeSessionSummary(session);
         writeWizardLine();
-        return session;
+        return {
+            session,
+            restoredFromCache: true
+        };
     }
     catch (error) {
         const message = error instanceof Error ? error.message : String(error);
@@ -2214,6 +2793,29 @@ async function ensureWizardSession(options) {
     });
     writeSessionSummary(result.session);
     writeWizardLine();
+    return {
+        session: result.session,
+        restoredFromCache: false
+    };
+}
+async function confirmWizardWorkspace(rl, session, options) {
+    const orgLabel = getOrgLabel(session);
+    const promptLabel = orgLabel ? `workspace ${orgLabel}` : "this signed-in account without a selected workspace";
+    const useCurrentWorkspace = await promptYesNo(rl, `Use ${promptLabel} for this CLI run?`, true);
+    if (useCurrentWorkspace) {
+        writeWizardLine();
+        return session;
+    }
+    writeWizardLine();
+    writeWizardLine("Choose the workspace for this CLI session in the browser.");
+    writeWizardLine();
+    await clearAuthSession();
+    const result = await performLogin({
+        apiUrl: options?.apiUrl ?? session.apiBaseUrl,
+        timeoutSeconds: options?.timeoutSeconds ?? 180
+    });
+    writeSessionSummary(result.session);
+    writeWizardLine();
     return result.session;
 }
 async function resolveLlmAuthReadiness() {
@@ -2891,6 +3493,49 @@ class SalesNavigatorExportRequestError extends Error {
         this.launchDiagnostics = options.launchDiagnostics ?? null;
     }
 }
+class CliApiRequestError extends Error {
+    statusCode;
+    errorCode;
+    constructor(message, options) {
+        super(message);
+        this.name = "CliApiRequestError";
+        this.statusCode = options.statusCode;
+        this.errorCode = options.errorCode;
+    }
+}
+class LinkedInCompanyBackfillBatchError extends Error {
+    failureCode;
+    constructor(message, options) {
+        super(message);
+        this.name = "LinkedInCompanyBackfillBatchError";
+        this.failureCode = options.failureCode;
+    }
+}
+function formatLinkedInCompanyBackfillSessionLabel(launch) {
+    const identity = launch.selectedSessionUserEmail?.trim() ||
+        launch.selectedSessionUserHandle?.trim() ||
+        null;
+    const shortHash = launch.selectedSessionCookieSha256?.trim()
+        ? launch.selectedSessionCookieSha256.trim().slice(0, 12)
+        : null;
+    if (identity && shortHash) {
+        return `${identity} (${shortHash})`;
+    }
+    return identity || shortHash || 'the selected LinkedIn session';
+}
+function isLinkedInCompanyBackfillInvalidSessionMessage(message) {
+    return /session cookie not valid anymore|expired session cookie|invalid session cookie|can't connect to linkedin with this session cookie|no valid credentials found|please log in to linkedin to get a new one/i.test(message);
+}
+function buildLinkedInCompanyBackfillSessionRecoveryMessage(labels) {
+    const uniqueLabels = Array.from(new Set(labels
+        .map((label) => label.trim())
+        .filter((label) => label.length > 0)));
+    if (uniqueLabels.length === 0) {
+        return "Company enrichment exhausted the LinkedIn session pool. Open LinkedIn Sales Navigator in Chrome, reconnect the Salesprompter extension, and retry companies:enrich.";
+    }
+    const attemptedSessions = uniqueLabels.join(", ");
+    return `Company enrichment exhausted the LinkedIn session pool. Phantombuster rejected ${uniqueLabels.length} synced LinkedIn session${uniqueLabels.length === 1 ? "" : "s"} as expired: ${attemptedSessions}. Open LinkedIn Sales Navigator in Chrome, reconnect the Salesprompter extension, and retry companies:enrich.`;
+}
 const SALES_NAVIGATOR_EXPORT_START_TIMEOUT_MS = 90_000;
 async function withRefreshableAuthSession(session, run, contextLabel = "Salesprompter session expired during crawl. Refreshing login...") {
     let currentSession = session;
@@ -2921,13 +3566,22 @@ async function fetchCliJson(session, request, schema) {
         const text = await response.text();
         const parsed = text.length > 0 ? JSON.parse(text) : {};
         if (!response.ok) {
+            const errorCode = typeof parsed === "object" &&
+                parsed !== null &&
+                "code" in parsed &&
+                typeof parsed.code === "string"
+                ? parsed.code
+                : undefined;
             const errorMessage = typeof parsed === "object" &&
                 parsed !== null &&
                 "error" in parsed &&
                 typeof parsed.error === "string"
                 ? parsed.error
                 : `request failed (${response.status})`;
-            throw new Error(errorMessage);
+            throw new CliApiRequestError(errorMessage, {
+                statusCode: response.status,
+                errorCode
+            });
         }
         return schema.parse(parsed);
     });
@@ -2986,7 +3640,13 @@ async function enrichDirectEmailCompaniesViaApp(session, payload) {
     return value;
 }
 async function fetchLinkedInCompaniesBackfillStatus(session, payload) {
-    const { value } = await fetchCliJson(session, (currentSession) => fetch(`${currentSession.apiBaseUrl}/api/cli/linkedin-companies/status?clientId=${encodeURIComponent(String(payload.clientId))}&containerId=${encodeURIComponent(payload.containerId)}`, {
+    const url = new URL('/api/cli/linkedin-companies/status', session.apiBaseUrl);
+    url.searchParams.set('clientId', String(payload.clientId));
+    url.searchParams.set('containerId', payload.containerId);
+    if (payload.selectedSessionCookieSha256?.trim()) {
+        url.searchParams.set('selectedSessionCookieSha256', payload.selectedSessionCookieSha256.trim());
+    }
+    const { value } = await fetchCliJson(session, (currentSession) => fetch(url.toString(), {
         method: "GET",
         headers: {
             Authorization: `Bearer ${currentSession.accessToken}`
@@ -3242,10 +3902,24 @@ async function drainLinkedInCompanyBackfill(session, payload) {
     let startedCompanies = 0;
     let remaining = 0;
     let consecutiveBusyPolls = 0;
+    let consecutiveRetryableFailures = 0;
+    const maxRetryableFailures = 3;
+    let consecutiveInvalidSessionFailures = 0;
+    const maxInvalidSessionFailures = 2;
+    const invalidSessionLabels = [];
+    const excludedSessionCookieSha256 = new Set();
+    const excludedUserEmails = new Set();
+    const excludedUserHandles = new Set();
+    let lastProcessedRemaining = null;
     for (;;) {
         let launched;
         try {
-            launched = await launchLinkedInCompaniesBackfill(session, payload);
+            launched = await launchLinkedInCompaniesBackfill(session, {
+                ...payload,
+                excludedSessionCookieSha256: Array.from(excludedSessionCookieSha256),
+                excludedUserEmails: Array.from(excludedUserEmails),
+                excludedUserHandles: Array.from(excludedUserHandles),
+            });
         }
         catch (error) {
             if (isSalesNavigatorAgentBusyError(error)) {
@@ -3256,6 +3930,19 @@ async function drainLinkedInCompanyBackfill(session, payload) {
                 await delay(30_000);
                 continue;
             }
+            if (isRecoverableLinkedInCompanyBackfillSessionFailure(error) &&
+                consecutiveInvalidSessionFailures < maxInvalidSessionFailures) {
+                consecutiveInvalidSessionFailures += 1;
+                writeProgress(`Company enrichment session expired. Trying another synced LinkedIn session (${consecutiveInvalidSessionFailures}/${maxInvalidSessionFailures})...`);
+                await delay(5_000);
+                continue;
+            }
+            if (isRecoverableLinkedInCompanyBackfillSessionFailure(error)) {
+                throw new Error(buildLinkedInCompanyBackfillSessionRecoveryMessage(invalidSessionLabels));
+            }
+            if (isCompanyBackfillSourceInvalidError(error)) {
+                throw new Error("Company enrichment source is broken. Refresh leadPool_inner_merged and recreate leadPool_new, then retry.");
+            }
             throw error;
         }
         consecutiveBusyPolls = 0;
@@ -3268,24 +3955,178 @@ async function drainLinkedInCompanyBackfill(session, payload) {
             };
         }
         batches += 1;
-        startedCompanies += launched.candidates.length;
-        writeProgress(`Started company enrichment batch ${batches} for ${launched.candidates.length} companies.`);
+        const launchedCompanies = launched.candidates.length;
+        startedCompanies += launchedCompanies;
+        let initialStatus;
+        try {
+            initialStatus = await waitForLinkedInCompanyBackfillStart(session, {
+                clientId: payload.clientId,
+                containerId: launched.containerId,
+                selectedSessionCookieSha256: launched.selectedSessionCookieSha256 ?? null,
+            });
+        }
+        catch (error) {
+            if (isRetryableLinkedInCompanyBackfillFailure(error) && consecutiveRetryableFailures < maxRetryableFailures) {
+                consecutiveRetryableFailures += 1;
+                batches -= 1;
+                startedCompanies -= launchedCompanies;
+                writeProgress(`Company enrichment batch failed before start (${error.message}). Retrying automatically (${consecutiveRetryableFailures}/${maxRetryableFailures})...`);
+                await delay(5_000);
+                continue;
+            }
+            throw error;
+        }
+        writeProgress(initialStatus.processed
+            ? `Finished company enrichment batch ${batches} for ${launchedCompanies} companies.`
+            : `Started company enrichment batch ${batches} for ${launchedCompanies} companies.`);
+        const batchStartedAt = Date.now();
+        let lastRunningHeartbeatAt = batchStartedAt;
+        let lastPendingPersistenceHeartbeatAt = batchStartedAt;
         for (;;) {
             const status = await fetchLinkedInCompaniesBackfillStatus(session, {
                 clientId: payload.clientId,
-                containerId: launched.containerId
+                containerId: launched.containerId,
+                selectedSessionCookieSha256: launched.selectedSessionCookieSha256 ?? null,
             });
             remaining = status.remaining;
+            if (!status.running && status.failed) {
+                const batchError = new LinkedInCompanyBackfillBatchError(status.failureMessage ?? "Company enrichment batch failed.", { failureCode: status.failureCode ?? undefined });
+                if (isRetryableLinkedInCompanyBackfillFailure(batchError) &&
+                    consecutiveRetryableFailures < maxRetryableFailures) {
+                    consecutiveRetryableFailures += 1;
+                    batches -= 1;
+                    startedCompanies -= launchedCompanies;
+                    writeProgress(`Company enrichment batch failed (${batchError.message}). Retrying automatically (${consecutiveRetryableFailures}/${maxRetryableFailures})...`);
+                    await delay(5_000);
+                    break;
+                }
+                if (isRecoverableLinkedInCompanyBackfillSessionFailure(batchError) &&
+                    consecutiveInvalidSessionFailures < maxInvalidSessionFailures) {
+                    consecutiveInvalidSessionFailures += 1;
+                    invalidSessionLabels.push(formatLinkedInCompanyBackfillSessionLabel(launched));
+                    if (launched.selectedSessionCookieSha256?.trim()) {
+                        excludedSessionCookieSha256.add(launched.selectedSessionCookieSha256.trim());
+                    }
+                    if (launched.selectedSessionUserEmail?.trim()) {
+                        excludedUserEmails.add(launched.selectedSessionUserEmail.trim());
+                    }
+                    if (launched.selectedSessionUserHandle?.trim()) {
+                        excludedUserHandles.add(launched.selectedSessionUserHandle.trim());
+                    }
+                    batches -= 1;
+                    startedCompanies -= launchedCompanies;
+                    writeProgress(`Company enrichment rejected ${formatLinkedInCompanyBackfillSessionLabel(launched)} as expired. Trying another synced LinkedIn session (${consecutiveInvalidSessionFailures}/${maxInvalidSessionFailures})...`);
+                    await delay(5_000);
+                    break;
+                }
+                if (isRecoverableLinkedInCompanyBackfillSessionFailure(batchError)) {
+                    invalidSessionLabels.push(formatLinkedInCompanyBackfillSessionLabel(launched));
+                    if (launched.selectedSessionCookieSha256?.trim()) {
+                        excludedSessionCookieSha256.add(launched.selectedSessionCookieSha256.trim());
+                    }
+                    if (launched.selectedSessionUserEmail?.trim()) {
+                        excludedUserEmails.add(launched.selectedSessionUserEmail.trim());
+                    }
+                    if (launched.selectedSessionUserHandle?.trim()) {
+                        excludedUserHandles.add(launched.selectedSessionUserHandle.trim());
+                    }
+                    throw new Error(buildLinkedInCompanyBackfillSessionRecoveryMessage(invalidSessionLabels));
+                }
+                throw batchError;
+            }
             if (!status.running && status.processed) {
+                if (lastProcessedRemaining !== null && status.remaining >= lastProcessedRemaining) {
+                    const settledStatus = await waitForLinkedInCompanyBackfillRemainingDrop(session, {
+                        clientId: payload.clientId,
+                        containerId: launched.containerId,
+                        selectedSessionCookieSha256: launched.selectedSessionCookieSha256 ?? null,
+                        previousRemaining: lastProcessedRemaining
+                    });
+                    remaining = settledStatus.remaining;
+                    if (remaining >= lastProcessedRemaining) {
+                        throw new Error(`Company enrichment batch ${batches} finished but remaining stayed at ${remaining}. Stopping to avoid duplicate launches.`);
+                    }
+                }
+                consecutiveRetryableFailures = 0;
+                consecutiveInvalidSessionFailures = 0;
+                lastProcessedRemaining = remaining;
+                const completionMessage = `Finished company enrichment batch ${batches} for ${launchedCompanies} companies.`;
                 writeProgress(remaining > 0
-                    ? `${remaining} companies still waiting. Starting the next batch...`
-                    : "Company enrichment finished.");
+                    ? `${completionMessage} ${remaining} companies still waiting. Starting the next batch...`
+                    : `${completionMessage} Company enrichment finished.`);
                 break;
             }
+            if (status.running) {
+                const now = Date.now();
+                if (now - lastRunningHeartbeatAt >= 30_000) {
+                    const elapsedSeconds = Math.max(1, Math.round((now - batchStartedAt) / 1000));
+                    writeProgress(`Company enrichment batch ${batches} is still running (${elapsedSeconds}s elapsed)...`);
+                    lastRunningHeartbeatAt = now;
+                }
+            }
+            else if (!status.processed) {
+                const now = Date.now();
+                if (now - lastPendingPersistenceHeartbeatAt >= 30_000) {
+                    writeProgress(`Company enrichment batch ${batches} finished remotely. Waiting for results to sync...`);
+                    lastPendingPersistenceHeartbeatAt = now;
+                }
+            }
             await delay(15_000);
         }
     }
 }
+async function waitForLinkedInCompanyBackfillStart(session, payload) {
+    const deadline = Date.now() + 45_000;
+    for (;;) {
+        const status = await fetchLinkedInCompaniesBackfillStatus(session, payload);
+        if (status.failed) {
+            throw new LinkedInCompanyBackfillBatchError(status.failureMessage ?? "Company enrichment batch failed.", { failureCode: status.failureCode ?? undefined });
+        }
+        if (status.running || status.processed) {
+            return status;
+        }
+        if (Date.now() >= deadline) {
+            return status;
+        }
+        await delay(5_000);
+    }
+}
+async function waitForLinkedInCompanyBackfillRemainingDrop(session, payload) {
+    const deadline = Date.now() + 90_000;
+    let latestStatus = await fetchLinkedInCompaniesBackfillStatus(session, payload);
+    let lastHeartbeatAt = Date.now();
+    while (Date.now() < deadline) {
+        if (latestStatus.failed) {
+            throw new LinkedInCompanyBackfillBatchError(latestStatus.failureMessage ?? "Company enrichment batch failed.", { failureCode: latestStatus.failureCode ?? undefined });
+        }
+        if (latestStatus.remaining < payload.previousRemaining) {
+            return latestStatus;
+        }
+        const now = Date.now();
+        if (now - lastHeartbeatAt >= 30_000) {
+            writeProgress(`Company enrichment batch finished. Waiting for backlog to update below ${payload.previousRemaining}...`);
+            lastHeartbeatAt = now;
+        }
+        await delay(10_000);
+        latestStatus = await fetchLinkedInCompaniesBackfillStatus(session, payload);
+    }
+    return latestStatus;
+}
+function isRetryableLinkedInCompanyBackfillFailure(error) {
+    return error instanceof LinkedInCompanyBackfillBatchError && error.failureCode === "input_empty";
+}
+function isRecoverableLinkedInCompanyBackfillSessionFailure(error) {
+    if (error instanceof LinkedInCompanyBackfillBatchError) {
+        return error.failureCode === "invalid_session" || isLinkedInCompanyBackfillInvalidSessionMessage(error.message);
+    }
+    if (error instanceof CliApiRequestError) {
+        return error.errorCode === "invalid_session" || isLinkedInCompanyBackfillInvalidSessionMessage(error.message);
+    }
+    return false;
+}
+function isCompanyBackfillSourceInvalidError(error) {
+    return error instanceof CliApiRequestError && error.errorCode === "company_backfill_source_invalid";
+}
 function isSalesNavigatorSessionError(error) {
     if (error instanceof SalesNavigatorExportRequestError) {
         if (error.errorCode === "invalid_session") {
@@ -3718,7 +4559,8 @@ async function ensureSalesNavigatorSessionPoolReady(queryUrl, options) {
             status: claimed ? "ok" : "skipped",
             selectedSessionUserEmail: claimed?.userEmail ?? null,
             selectedSessionUserHandle: claimed?.userHandle ?? null,
-            selectedSessionCookieSha256: claimed?.sessionCookieSha256 ?? null
+            selectedSessionCookieSha256: claimed?.sessionCookieSha256 ?? null,
+            selectedSessionLastIngestedSource: claimed?.lastIngestedSource ?? null
         });
         return {
             ready: true
@@ -3949,9 +4791,11 @@ async function executeSalesNavigatorCrawlJob(session, jobId, options) {
     let nextSessionPoolRetryAt = 0;
     let lastSessionPoolReadyAt = 0;
     const sessionPoolReadinessCooldownMs = 120_000;
+    let allowRetryClaimBeyondMaxSlices = false;
+    let allowedRetrySliceId = null;
     while (true) {
         while (!noMoreClaimableWork && inFlight.size < parallelExports) {
-            if (claimedSlices >= options.maxSlices) {
+            if (claimedSlices >= options.maxSlices && !allowRetryClaimBeyondMaxSlices) {
                 break;
             }
             if (inFlight.size === 0) {
@@ -4058,6 +4902,15 @@ async function executeSalesNavigatorCrawlJob(session, jobId, options) {
                 break;
             }
             const slice = claimed.value.slice;
+            if (claimedSlices >= options.maxSlices &&
+                allowRetryClaimBeyondMaxSlices &&
+                allowedRetrySliceId &&
+                slice.id !== allowedRetrySliceId) {
+                noMoreClaimableWork = true;
+                break;
+            }
+            allowRetryClaimBeyondMaxSlices = false;
+            allowedRetrySliceId = null;
             idlePollCount = 0;
             activeSlice = slice;
             const isNewSlice = !seenSliceIds.has(slice.id);
@@ -4087,6 +4940,8 @@ async function executeSalesNavigatorCrawlJob(session, jobId, options) {
         job = completed.value.job;
         activeSlice = completed.value.activeSlice;
         lastOutcome = completed.value.lastOutcome;
+        allowRetryClaimBeyondMaxSlices = lastOutcome?.outcome === "retryable_failed";
+        allowedRetrySliceId = lastOutcome?.outcome === "retryable_failed" ? completed.value.activeSlice.id : null;
         if (completed.value.forceSessionPoolRecheck) {
             lastSessionPoolReadyAt = 0;
             nextSessionPoolRetryAt = 0;
@@ -4097,6 +4952,11 @@ async function executeSalesNavigatorCrawlJob(session, jobId, options) {
         currentSession = status.session;
         job = status.value.job;
     }
+    else if (!isSalesNavigatorCrawlJobTerminal(job.status)) {
+        const status = await getSalesNavigatorCrawlStatus(currentSession, jobId, options.traceId);
+        currentSession = status.session;
+        job = status.value.job;
+    }
     await options.logger?.log("salesnav.crawl.job.completed", {
         jobId,
         status: job.status,
@@ -4339,12 +5199,15 @@ async function runWizard(options) {
     writeWizardLine("Salesprompter");
     writeWizardLine("Start with a company website, LinkedIn product page, or category URL. I will guide you from there.");
     writeWizardLine();
-    await ensureWizardSession(options);
     const rl = createInterface({
         input: process.stdin,
         output: process.stdout
     });
     try {
+        const wizardSession = await ensureWizardSession(options);
+        if (wizardSession.session && wizardSession.restoredFromCache) {
+            await confirmWizardWorkspace(rl, wizardSession.session, options);
+        }
         const flow = await promptChoice(rl, "What do you want help with?", [
             {
                 value: "product-market",
@@ -4406,6 +5269,15 @@ function buildCliError(error) {
         };
     }
     const message = error instanceof Error ? error.message : "Unknown error";
+    if (message === "linkedin_session_invalid" ||
+        isLinkedInCompanyBackfillInvalidSessionMessage(message) ||
+        /no eligible linkedin session cookies available for company backfill|company session preflight returned/i.test(message)) {
+        return {
+            status: "error",
+            code: "runtime_error",
+            message: buildLinkedInCompanyBackfillSessionRecoveryMessage([])
+        };
+    }
     if (message.includes("not logged in")) {
         return {
             status: "error",
@@ -4494,6 +5366,7 @@ const domainDecisionArraySchema = z.array(z.object({
     reason: z.enum([
         "linkedin-domain",
         "linkedin-website",
+        "better-company-match",
         "highest-hunter-count",
         "fallback-first-non-null",
         "no-domain"
@@ -4777,13 +5650,15 @@ program
     if (rows.length === 0) {
         throw new Error("No contact rows found. Provide TSV/CSV/JSON input via --in or stdin.");
     }
+    let authSession = null;
     let sessionOrgId = "";
     if (!shouldBypassAuth()) {
         try {
-            const session = await requireAuthSession();
-            sessionOrgId = session.user.orgId ?? "";
+            authSession = await requireAuthSession();
+            sessionOrgId = authSession.user.orgId ?? "";
         }
         catch {
+            authSession = null;
             sessionOrgId = "";
         }
     }
@@ -4810,25 +5685,119 @@ program
         orgId: String(options.orgId ?? "").trim() || undefined
     });
     let directAttempted = false;
+    let workflowAttempted = false;
     const missingRows = enrichedRows.filter((row) => !row.found);
     if (missingRows.length > 0) {
-        directAttempted = true;
         const directContacts = contacts.filter((contact) => missingRows.some((row) => row.contactId === contact.contact_id));
-        const result = await invokeLinkedInUrlEnrichmentDirect({
-            contacts: directContacts,
-            timeoutMs
-        });
-        const linkedInUrlByContactId = new Map(result.contacts.map((contact) => [contact.contact_id, contact.linkedin_url]));
-        for (const row of enrichedRows) {
-            if (row.found)
-                continue;
-            const linkedinUrl = linkedInUrlByContactId.get(row.contactId) ?? null;
-            if (linkedinUrl) {
-                row.linkedinUrl = linkedinUrl;
-                row.found = true;
-                row.source = "linkedin-direct";
+        let linkedInUrlByContactId = new Map();
+        try {
+            directAttempted = true;
+            const result = await invokeLinkedInUrlEnrichmentDirect({
+                contacts: directContacts,
+                timeoutMs
+            });
+            linkedInUrlByContactId = new Map(result.contacts.map((contact) => [
+                contact.contact_id,
+                {
+                    linkedinUrl: contact.linkedin_url ?? null,
+                    salesNavProfileUrl: contact.sales_nav_profile_url ?? null,
+                    linkedinCompanyUrl: null,
+                    salesNavCompanyUrl: null
+                }
+            ]));
+            for (const row of enrichedRows) {
+                if (row.found)
+                    continue;
+                const profile = linkedInUrlByContactId.get(row.contactId);
+                if (profile?.linkedinUrl) {
+                    row.linkedinUrl = profile.linkedinUrl;
+                    row.salesNavProfileUrl = profile.salesNavProfileUrl ?? row.salesNavProfileUrl ?? null;
+                    row.found = true;
+                    row.source = "linkedin-direct";
+                }
+            }
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            if (!/Missing LinkedIn direct lookup session/i.test(message)) {
+                throw error;
+            }
+            workflowAttempted = true;
+            const workflow = await invokeLinkedInUrlEnrichmentWorkflow({
+                contacts: directContacts,
+                externalUserId: String(options.orgId ?? "").trim() || sessionOrgId || "cli_direct_lookup",
+                timeoutMs
+            });
+            if (!workflow.response.ok) {
+                throw new Error(`LinkedIn enrichment workflow returned ${workflow.response.status}: ${workflow.bodyText.slice(0, 300)}`);
+            }
+            linkedInUrlByContactId = normalizeWorkflowLinkedInUrlResult({
+                parsedBody: workflow.parsedBody,
+                contacts: directContacts
+            });
+            for (const row of enrichedRows) {
+                if (row.found)
+                    continue;
+                const profile = linkedInUrlByContactId.get(row.contactId);
+                if (profile?.linkedinUrl) {
+                    row.linkedinUrl = profile.linkedinUrl;
+                    row.salesNavProfileUrl = profile.salesNavProfileUrl ?? row.salesNavProfileUrl ?? null;
+                    row.linkedinCompanyUrl = profile.linkedinCompanyUrl ?? row.linkedinCompanyUrl ?? null;
+                    row.salesNavCompanyUrl = profile.salesNavCompanyUrl ?? row.salesNavCompanyUrl ?? null;
+                    row.found = true;
+                    row.companyFound = Boolean(row.linkedinCompanyUrl || row.salesNavCompanyUrl);
+                    row.source = "workflow";
+                    row.companySource =
+                        row.linkedinCompanyUrl || row.salesNavCompanyUrl ? "workflow" : row.companySource ?? null;
+                }
+            }
+        }
+    }
+    const parsedClientIds = Array.from(new Set(rows
+        .map((row) => Number(row.clientId))
+        .filter((value) => Number.isFinite(value) && value > 0)));
+    if (authSession && parsedClientIds.length === 1) {
+        try {
+            const uniqueCompanies = Array.from(new Map(contacts
+                .filter((contact) => !contact.isVariation)
+                .map((contact) => {
+                const key = normalizeLookupCompanyForCleaning(contact.companyNameOriginal ?? contact.companyName);
+                return [
+                    key,
+                    {
+                        companyId: contact.contact_id,
+                        companyName: contact.companyNameOriginal ?? contact.companyName,
+                        companyNameCleaned: cleanedCompanyMap.get(key) ?? normalizeLookupWhitespace(contact.companyNameOriginal ?? contact.companyName)
+                    }
+                ];
+            })).values());
+            if (uniqueCompanies.length > 0) {
+                const appCompanyResult = await enrichDirectEmailCompaniesViaApp(authSession, {
+                    clientId: parsedClientIds[0],
+                    companies: uniqueCompanies
+                });
+                const companyByNormalizedName = new Map(appCompanyResult.companies.map((company) => [
+                    normalizeLookupCompanyForCleaning(company.companyName),
+                    company.linkedinCompanyPage ?? null
+                ]));
+                for (const row of enrichedRows) {
+                    if (row.linkedinCompanyUrl) {
+                        continue;
+                    }
+                    const normalizedName = normalizeLookupCompanyForCleaning(row.companyName);
+                    const linkedinCompanyUrl = companyByNormalizedName.get(normalizedName) ?? null;
+                    if (!linkedinCompanyUrl) {
+                        continue;
+                    }
+                    row.linkedinCompanyUrl = linkedinCompanyUrl;
+                    row.companyFound = true;
+                    row.companySource = "workflow";
+                }
             }
         }
+        catch (error) {
+            writeProgress(`Skipping app-backed company enrichment: ${error instanceof Error ? error.message : String(error)}`);
+        }
     }
     try {
         const companyResult = await invokeLinkedInCompanyEnrichmentDirect({
@@ -4839,6 +5808,7 @@ program
             contact.contact_id,
             {
                 linkedinCompanyUrl: contact.linkedin_company_url ?? null,
+                salesNavCompanyUrl: contact.sales_nav_company_url ?? null,
                 matchedCompanyName: contact.matched_company_name ?? null,
                 matchedCompanyEmployeeCount: contact.matched_company_employee_count ?? null
             }
@@ -4849,8 +5819,10 @@ program
                 continue;
             }
             row.linkedinCompanyUrl = company.linkedinCompanyUrl;
-            row.companyFound = Boolean(company.linkedinCompanyUrl);
-            row.companySource = company.linkedinCompanyUrl ? "linkedin-direct" : row.companySource ?? null;
+            row.salesNavCompanyUrl = company.salesNavCompanyUrl ?? row.salesNavCompanyUrl ?? null;
+            row.companyFound = Boolean(company.linkedinCompanyUrl || company.salesNavCompanyUrl);
+            row.companySource =
+                company.linkedinCompanyUrl || company.salesNavCompanyUrl ? "linkedin-direct" : row.companySource ?? null;
             row.matchedCompanyName = company.matchedCompanyName ?? row.matchedCompanyName ?? null;
             row.matchedCompanyEmployeeCount =
                 company.matchedCompanyEmployeeCount ?? row.matchedCompanyEmployeeCount ?? null;
@@ -4866,6 +5838,7 @@ program
         found: enrichedRows.filter((row) => row.found).length,
         companiesFound: enrichedRows.filter((row) => row.companyFound).length,
         directAttempted,
+        workflowAttempted,
         rows: enrichedRows
     };
     if (options.out) {
@@ -4873,6 +5846,164 @@ program
     }
     printOutput(payload);
 });
+program
+    .command("companies:find-linkedin-urls")
+    .alias("companies:resolve-linkedin-urls")
+    .description("Resolve LinkedIn company URLs from a pasted company list directly in the CLI.")
+    .option("--in <path>", "Input TSV/CSV/JSON file path. Omit to read from stdin.")
+    .option("--out <path>", "Optional output JSON path for the enriched rows.")
+    .option("--client-id <id>", "Optional clientId override for app-backed enrichment.")
+    .option("--timeout-ms <number>", "Lookup timeout in milliseconds", "30000")
+    .option("--company-cleaning <mode>", "Company cleaning mode: off, basic, or ai", "basic")
+    .option("--dry-run", "Preview the normalized payload without calling LinkedIn", false)
+    .action(async (options) => {
+    const timeoutMs = z.coerce.number().int().min(1000).max(300000).parse(options.timeoutMs);
+    const inputContent = options.in ? await readFile(options.in, "utf8") : await readAllStdin();
+    const rows = parseLinkedInCompanyLookupInput(inputContent);
+    if (rows.length === 0) {
+        throw new Error("No company rows found. Provide TSV/CSV/JSON input via --in or stdin.");
+    }
+    let authSession = null;
+    if (!shouldBypassAuth()) {
+        authSession = await requireAuthSession().catch(() => null);
+    }
+    const companyCleaningMode = resolveCompanyCleaningMode(String(options.companyCleaning ?? process.env.SALESPROMPTER_COMPANY_CLEANING_MODE ?? "basic"));
+    const lookupRows = rows.map((row) => ({
+        clientId: row.clientId,
+        fullName: "",
+        companyName: row.companyName
+    }));
+    const cleanedCompanyMap = await buildCompanyNameCleaningMap(lookupRows, companyCleaningMode);
+    const contacts = toLinkedInUrlLookupContacts(lookupRows, cleanedCompanyMap);
+    if (options.dryRun) {
+        const payload = {
+            status: "ok",
+            dryRun: true,
+            companyCleaningMode,
+            companies: contacts.length,
+            sample: contacts.slice(0, 5).map((contact) => ({
+                companyId: contact.contact_id,
+                companyName: contact.companyNameOriginal ?? contact.companyName,
+                companyNameCleaned: contact.companyName
+            }))
+        };
+        if (options.out) {
+            await writeJsonFile(options.out, payload);
+        }
+        printOutput(payload);
+        return;
+    }
+    const clientId = resolveDirectEmailEnrichmentClientId(rows.map((row) => ({
+        clientId: row.clientId,
+        companyName: row.companyName,
+        fullName: ""
+    })), options.clientId);
+    const results = contacts
+        .filter((contact) => !contact.isVariation)
+        .map((contact) => ({
+        clientId: String(clientId),
+        companyName: contact.companyNameOriginal ?? contact.companyName,
+        linkedinCompanyUrl: null,
+        salesNavCompanyUrl: null,
+        domain: null,
+        found: false,
+        source: null,
+        matchedCompanyName: null,
+        matchedCompanyEmployeeCount: null
+    }));
+    const resultByNormalizedName = new Map(results.map((row) => [normalizeLookupCompanyForCleaning(row.companyName), row]));
+    if (authSession) {
+        try {
+            const uniqueCompanies = contacts
+                .filter((contact) => !contact.isVariation)
+                .map((contact) => ({
+                companyId: contact.contact_id,
+                companyName: contact.companyNameOriginal ?? contact.companyName,
+                companyNameCleaned: cleanedCompanyMap.get(normalizeLookupCompanyForCleaning(contact.companyNameOriginal ?? contact.companyName)) ?? normalizeLookupWhitespace(contact.companyNameOriginal ?? contact.companyName)
+            }));
+            if (uniqueCompanies.length > 0) {
+                const enrichedCompanies = await enrichDirectEmailCompaniesViaApp(authSession, {
+                    clientId,
+                    companies: uniqueCompanies
+                });
+                for (const company of enrichedCompanies.companies) {
+                    const row = resultByNormalizedName.get(normalizeLookupCompanyForCleaning(company.companyName));
+                    if (!row) {
+                        continue;
+                    }
+                    row.domain = company.domain ?? row.domain ?? null;
+                    row.linkedinCompanyUrl = company.linkedinCompanyPage ?? row.linkedinCompanyUrl ?? null;
+                    row.found = Boolean(row.linkedinCompanyUrl || row.salesNavCompanyUrl);
+                    row.source = row.linkedinCompanyUrl ? "app" : row.source;
+                }
+            }
+        }
+        catch {
+            // Ignore app failures here and keep falling back to direct or public lookup.
+        }
+    }
+    try {
+        const companyResult = await invokeLinkedInCompanyEnrichmentDirect({
+            contacts,
+            timeoutMs
+        });
+        const companyByContactId = new Map(companyResult.contacts.map((contact) => [contact.contact_id, contact]));
+        for (const contact of contacts) {
+            if (contact.isVariation) {
+                continue;
+            }
+            const row = resultByNormalizedName.get(normalizeLookupCompanyForCleaning(contact.companyNameOriginal ?? contact.companyName));
+            const company = companyByContactId.get(contact.contact_id);
+            if (!row || !company) {
+                continue;
+            }
+            if (!row.linkedinCompanyUrl && company.linkedin_company_url) {
+                row.linkedinCompanyUrl = company.linkedin_company_url;
+            }
+            if (!row.salesNavCompanyUrl && company.sales_nav_company_url) {
+                row.salesNavCompanyUrl = company.sales_nav_company_url;
+            }
+            row.matchedCompanyName = company.matched_company_name ?? row.matchedCompanyName ?? null;
+            row.matchedCompanyEmployeeCount =
+                company.matched_company_employee_count ?? row.matchedCompanyEmployeeCount ?? null;
+            if ((company.linkedin_company_url || company.sales_nav_company_url) && row.source == null) {
+                row.source = "linkedin-direct";
+            }
+            row.found = Boolean(row.linkedinCompanyUrl || row.salesNavCompanyUrl);
+        }
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        if (!/Missing LinkedIn direct lookup session/i.test(message)) {
+            throw error;
+        }
+    }
+    for (const row of results) {
+        if (row.linkedinCompanyUrl) {
+            continue;
+        }
+        const linkedinCompanyUrl = (await searchSerperLinkedInCompanyUrl(row.companyName, timeoutMs)) ??
+            (await searchPublicLinkedInCompanyUrl(row.companyName, timeoutMs));
+        if (!linkedinCompanyUrl) {
+            continue;
+        }
+        row.linkedinCompanyUrl = linkedinCompanyUrl;
+        row.found = true;
+        if (row.source == null) {
+            row.source = "web-search";
+        }
+    }
+    const payload = {
+        status: "ok",
+        requested: rows.length,
+        found: results.filter((row) => row.found).length,
+        rows: results
+    };
+    if (options.out) {
+        await writeJsonFile(options.out, payload);
+    }
+    printOutput(payload);
+});
 program
     .command("auth:logout")
     .description("Remove local CLI auth session.")
@@ -4893,6 +6024,7 @@ program.hook("preAction", async (_thisCommand, actionCommand) => {
         commandName === "wizard" ||
         commandName === "llm:ready" ||
         commandName === "contacts:find-linkedin-urls" ||
+        commandName === "companies:find-linkedin-urls" ||
         commandName.startsWith("packs:") ||
         ((commandName === "list" || commandName === "add") && parentCommandName === "packs")) {
         return;
@@ -5176,16 +6308,21 @@ program
     .command("linkedin-companies:backfill")
     .alias("companies:enrich")
     .description("Backfill missing or unavailable company profiles for the current workspace.")
-    .requiredOption("--client-id <number>", "Legacy BigQuery clientId to backfill")
+    .option("--client-id <number>", "Legacy BigQuery clientId to backfill (optional if set in cache or env)")
     .option("--limit <number>", "Maximum companies to scrape in one run", "25")
     .option("--concurrency <number>", "How many LinkedIn company pages to scrape in parallel", "4")
     .option("--dry-run", "Preview the scrape result and generated MERGE SQL without writing to BigQuery", false)
     .action(async (options) => {
-    const clientId = z.coerce.number().int().positive().parse(options.clientId);
+    const authenticatedRun = !shouldBypassAuth() && !options.dryRun;
+    const session = authenticatedRun ? await requireAuthSession() : undefined;
+    const clientId = await resolveLinkedInCompanyBackfillClientId({
+        clientIdOption: options.clientId,
+        session
+    });
     const limit = z.coerce.number().int().min(1).max(500).parse(options.limit);
     const concurrency = z.coerce.number().int().min(1).max(20).parse(options.concurrency);
-    if (!options.dryRun && !shouldBypassAuth()) {
-        const session = await requireAuthSession();
+    await writeLinkedInCompanyBackfillClientIdToCache(clientId, session);
+    if (authenticatedRun && session) {
         const drained = await drainLinkedInCompanyBackfill(session, {
             clientId,
             limit
@@ -6983,7 +8120,17 @@ async function main() {
     }
     await program.parseAsync(process.argv);
 }
-main().catch((error) => {
+async function closeGlobalHttpDispatcher() {
+    try {
+        const undici = await import("undici");
+        await undici.getGlobalDispatcher().close();
+    }
+    catch {
+        // Best-effort shutdown for keep-alive sockets; ignore when undici is unavailable.
+    }
+}
+main()
+    .catch((error) => {
     if (error instanceof Error &&
         (error.message === "prompt cancelled" || error.message === "readline was closed")) {
         process.exitCode = 130;
@@ -6998,4 +8145,8 @@ main().catch((error) => {
         process.stderr.write(`${cliError.message}\n`);
     }
     process.exitCode = exitCodeForError(cliError.code);
+})
+    .finally(async () => {
+    await closeGlobalHttpDispatcher();
+    process.exit(process.exitCode ?? 0);
 });