salesprompter-cli 0.1.40 → 0.1.42

package/dist/sales-navigator.js

@@ -8,6 +8,16 @@ export class SalesNavigatorSliceTooBroadError extends Error {
         this.details = options?.details;
     }
 }
+export class SalesNavigatorCrawlStopError extends Error {
+    totalResults;
+    details;
+    constructor(message, options) {
+        super(message);
+        this.name = "SalesNavigatorCrawlStopError";
+        this.totalResults = options?.totalResults ?? null;
+        this.details = options?.details;
+    }
+}
 export const DEFAULT_SALES_NAVIGATOR_PEOPLE_SLICE_FILTERS = [
     {
         type: "FUNCTION",
@@ -81,6 +91,7 @@ export const DEFAULT_SALES_NAVIGATOR_PEOPLE_SLICE_FILTERS = [
     },
 ];
 const LINKEDIN_SALES_NAVIGATOR_PEOPLE_SEARCH_URL = "https://www.linkedin.com/sales/search/people";
+const LINKEDIN_SALES_NAVIGATOR_ACCOUNT_SEARCH_URL = "https://www.linkedin.com/sales/search/company";
 export const DEFAULT_SALES_NAVIGATOR_CRAWL_BASELINE_FILTERS = [
     {
         type: "FUNCTION",
@@ -215,6 +226,46 @@ export const DEFAULT_SALES_NAVIGATOR_CRAWL_DIMENSIONS = [
         ],
     },
 ];
+export const DEFAULT_SALES_NAVIGATOR_ACCOUNT_CRAWL_DIMENSIONS = [
+    {
+        key: "company-headcount",
+        filterType: "COMPANY_HEADCOUNT",
+        values: [
+            { id: "B", text: "1-10", selectionType: "INCLUDED" },
+            { id: "C", text: "11-50", selectionType: "INCLUDED" },
+            { id: "D", text: "51-200", selectionType: "INCLUDED" },
+            { id: "E", text: "201-500", selectionType: "INCLUDED" },
+            { id: "F", text: "501-1000", selectionType: "INCLUDED" },
+            { id: "G", text: "1001-5000", selectionType: "INCLUDED" },
+            { id: "H", text: "5001-10,000", selectionType: "INCLUDED" },
+            { id: "I", text: "10,000+", selectionType: "INCLUDED" },
+        ],
+    },
+    {
+        key: "number-of-followers",
+        filterType: "NUM_OF_FOLLOWERS",
+        values: [
+            { id: "NFR1", text: "1-10", selectionType: "INCLUDED" },
+            { id: "NFR2", text: "11-100", selectionType: "INCLUDED" },
+            { id: "NFR3", text: "101-1000", selectionType: "INCLUDED" },
+            { id: "NFR4", text: "1001-5000", selectionType: "INCLUDED" },
+            { id: "NFR5", text: "5001+", selectionType: "INCLUDED" },
+        ],
+    },
+    {
+        key: "company-type",
+        filterType: "COMPANY_TYPE",
+        values: [
+            { id: "P", text: "Privately Held", selectionType: "INCLUDED" },
+            { id: "C", text: "Public Company", selectionType: "INCLUDED" },
+            { text: "Partnership", selectionType: "INCLUDED" },
+            { text: "Self Owned", selectionType: "INCLUDED" },
+            { text: "Non Profit", selectionType: "INCLUDED" },
+            { text: "Educational Institution", selectionType: "INCLUDED" },
+            { text: "Government Agency", selectionType: "INCLUDED" },
+        ],
+    },
+];
 function ensureLinkedInSalesPeopleSearchUrl(url) {
     if (!/(^|\.)linkedin\.com$/i.test(url.hostname)) {
         throw new Error("Expected a linkedin.com Sales Navigator URL.");
@@ -226,6 +277,24 @@ function ensureLinkedInSalesPeopleSearchUrl(url) {
         throw new Error("Sales Navigator URL is missing the query parameter.");
     }
 }
+function ensureLinkedInSalesAccountSearchUrl(url) {
+    if (!/(^|\.)linkedin\.com$/i.test(url.hostname)) {
+        throw new Error("Expected a linkedin.com Sales Navigator URL.");
+    }
+    if (!/^\/sales\/search\/company/i.test(url.pathname)) {
+        throw new Error("Expected a LinkedIn Sales Navigator account search URL.");
+    }
+    if (!url.searchParams.has("query")) {
+        throw new Error("Sales Navigator URL is missing the query parameter.");
+    }
+}
+function ensureLinkedInSalesSearchUrl(url, searchType) {
+    if (searchType === "account") {
+        ensureLinkedInSalesAccountSearchUrl(url);
+        return;
+    }
+    ensureLinkedInSalesPeopleSearchUrl(url);
+}
 function splitTopLevelCommaSeparated(value) {
     const parts = [];
     let depth = 0;
@@ -357,19 +426,36 @@ function canonicalizeSalesNavigatorQueryValue(queryValue) {
     const { filtersContent } = findFiltersListBounds(queryValue);
     return `(filters:List(${filtersContent}))`;
 }
-function canonicalizeSalesNavigatorPeopleSearchUrl(sourceQueryUrl) {
+function canonicalizeSalesNavigatorSearchUrl(sourceQueryUrl, searchType = "people") {
     const url = new URL(sourceQueryUrl);
-    ensureLinkedInSalesPeopleSearchUrl(url);
+    ensureLinkedInSalesSearchUrl(url, searchType);
     const queryValue = url.searchParams.get("query");
     if (!queryValue) {
         throw new Error("Sales Navigator URL is missing the query parameter.");
     }
-    const canonicalUrl = new URL(LINKEDIN_SALES_NAVIGATOR_PEOPLE_SEARCH_URL);
+    const canonicalUrl = new URL(searchType === "account"
+        ? LINKEDIN_SALES_NAVIGATOR_ACCOUNT_SEARCH_URL
+        : LINKEDIN_SALES_NAVIGATOR_PEOPLE_SEARCH_URL);
     canonicalUrl.searchParams.set("query", canonicalizeSalesNavigatorQueryValue(queryValue));
     return canonicalUrl;
 }
 export function buildSalesNavigatorPeopleQuery(sourceQueryUrl, filters) {
-    const url = canonicalizeSalesNavigatorPeopleSearchUrl(sourceQueryUrl);
+    const url = canonicalizeSalesNavigatorSearchUrl(sourceQueryUrl, "people");
+    const queryValue = url.searchParams.get("query");
+    if (!queryValue) {
+        throw new Error("Sales Navigator URL is missing the query parameter.");
+    }
+    const appliedFilters = dedupeSalesNavigatorFilters(filters);
+    const slicedQueryValue = applySalesNavigatorFiltersToQueryValue(queryValue, appliedFilters);
+    url.searchParams.set("query", slicedQueryValue);
+    return {
+        sourceQueryUrl: canonicalizeSalesNavigatorSearchUrl(sourceQueryUrl, "people").toString(),
+        slicedQueryUrl: url.toString(),
+        appliedFilters,
+    };
+}
+export function buildSalesNavigatorAccountQuery(sourceQueryUrl, filters) {
+    const url = canonicalizeSalesNavigatorSearchUrl(sourceQueryUrl, "account");
     const queryValue = url.searchParams.get("query");
     if (!queryValue) {
         throw new Error("Sales Navigator URL is missing the query parameter.");
@@ -378,7 +464,7 @@ export function buildSalesNavigatorPeopleQuery(sourceQueryUrl, filters) {
     const slicedQueryValue = applySalesNavigatorFiltersToQueryValue(queryValue, appliedFilters);
     url.searchParams.set("query", slicedQueryValue);
     return {
-        sourceQueryUrl: canonicalizeSalesNavigatorPeopleSearchUrl(sourceQueryUrl).toString(),
+        sourceQueryUrl: canonicalizeSalesNavigatorSearchUrl(sourceQueryUrl, "account").toString(),
         slicedQueryUrl: url.toString(),
         appliedFilters,
     };
@@ -392,6 +478,15 @@ export function buildSalesNavigatorPeopleSearchUrl(filters) {
     url.searchParams.set("query", `(filters:List(${appliedFilters.map((filter) => buildFilterBlock(filter)).join(",")}))`);
     return url.toString();
 }
+export function buildSalesNavigatorAccountSearchUrl(filters) {
+    const appliedFilters = dedupeSalesNavigatorFilters(filters);
+    if (appliedFilters.length === 0) {
+        throw new Error("Sales Navigator account search requires at least one filter.");
+    }
+    const url = new URL(LINKEDIN_SALES_NAVIGATOR_ACCOUNT_SEARCH_URL);
+    url.searchParams.set("query", `(filters:List(${appliedFilters.map((filter) => buildFilterBlock(filter)).join(",")}))`);
+    return url.toString();
+}
 function inferSalesNavigatorFunctionFilters(options) {
     const titleHaystack = options.title.trim();
     const categoryHaystack = [options.categoryName, options.categorySlug]
@@ -507,8 +602,13 @@ export function deriveSalesNavigatorTitleQuerySeeds(options) {
 export function buildSalesNavigatorPeopleSlice(sourceQueryUrl, filters = DEFAULT_SALES_NAVIGATOR_PEOPLE_SLICE_FILTERS) {
     return buildSalesNavigatorPeopleQuery(sourceQueryUrl, filters);
 }
+export function buildSalesNavigatorAccountSlice(sourceQueryUrl, filters = []) {
+    return buildSalesNavigatorAccountQuery(sourceQueryUrl, filters);
+}
 export function createSalesNavigatorCrawlSeed(options) {
-    const sliced = buildSalesNavigatorPeopleQuery(options.sourceQueryUrl, options.baselineFilters ?? []);
+    const sliced = options.searchType === "account"
+        ? buildSalesNavigatorAccountQuery(options.sourceQueryUrl, options.baselineFilters ?? [])
+        : buildSalesNavigatorPeopleQuery(options.sourceQueryUrl, options.baselineFilters ?? []);
     return {
         ...sliced,
         depth: 0,
@@ -519,7 +619,7 @@ export function createSalesNavigatorCrawlSeed(options) {
         splitTrail: [],
     };
 }
-export function expandSalesNavigatorCrawlAttempt(attempt, dimension) {
+export function expandSalesNavigatorCrawlAttempt(attempt, dimension, searchType = "people") {
     return dimension.values.map((value) => {
         const filters = dedupeSalesNavigatorFilters([
             ...attempt.appliedFilters.filter((filter) => filter.type !== dimension.filterType),
@@ -533,7 +633,9 @@ export function expandSalesNavigatorCrawlAttempt(attempt, dimension) {
                 ],
             },
         ]);
-        const sliced = buildSalesNavigatorPeopleQuery(attempt.sourceQueryUrl, filters);
+        const sliced = searchType === "account"
+            ? buildSalesNavigatorAccountQuery(attempt.sourceQueryUrl, filters)
+            : buildSalesNavigatorPeopleQuery(attempt.sourceQueryUrl, filters);
         return {
             ...sliced,
             depth: attempt.depth + 1,
@@ -555,12 +657,364 @@ export function expandSalesNavigatorCrawlAttempt(attempt, dimension) {
         };
     });
 }
+export function buildSalesNavigatorResidualCrawlAttempt(attempt, dimension, searchType = "people") {
+    const residualValues = dimension.values.map((value) => ({
+        ...value,
+        selectionType: "EXCLUDED",
+    }));
+    const filters = dedupeSalesNavigatorFilters([
+        ...attempt.appliedFilters.filter((filter) => filter.type !== dimension.filterType),
+        {
+            type: dimension.filterType,
+            values: residualValues,
+        },
+    ]);
+    const sliced = searchType === "account"
+        ? buildSalesNavigatorAccountQuery(attempt.sourceQueryUrl, filters)
+        : buildSalesNavigatorPeopleQuery(attempt.sourceQueryUrl, filters);
+    return {
+        ...sliced,
+        depth: attempt.depth + 1,
+        retryCount: 0,
+        maxResultsPerSearch: attempt.maxResultsPerSearch,
+        numberOfProfiles: attempt.numberOfProfiles,
+        slicePreset: attempt.slicePreset,
+        splitTrail: [
+            ...attempt.splitTrail,
+            {
+                key: `${dimension.key}-residual`,
+                filterType: dimension.filterType,
+                value: {
+                    text: `Not in ${dimension.key}`,
+                    selectionType: "EXCLUDED",
+                },
+            },
+        ],
+    };
+}
 export function buildSalesNavigatorCrawlPreview(options) {
     const root = createSalesNavigatorCrawlSeed(options);
     const dimensions = options.dimensions ?? DEFAULT_SALES_NAVIGATOR_CRAWL_DIMENSIONS;
-    const firstSplit = dimensions[0] ? expandSalesNavigatorCrawlAttempt(root, dimensions[0]) : [];
+    const firstSplit = dimensions[0]
+        ? expandSalesNavigatorCrawlAttempt(root, dimensions[0], options.searchType)
+        : [];
     return { root, firstSplit, dimensions };
 }
+function salesNavigatorDimensionKeyFromTrailKey(key) {
+    return key.endsWith("-residual") ? key.slice(0, -"-residual".length) : key;
+}
+function getUnusedSalesNavigatorDimensions(attempt, dimensions) {
+    const usedKeys = new Set(attempt.splitTrail.map((entry) => salesNavigatorDimensionKeyFromTrailKey(entry.key)));
+    return dimensions.filter((dimension) => !usedKeys.has(dimension.key));
+}
+function buildSalesNavigatorAdaptiveChildren(attempt, dimension, options) {
+    const expandedChildren = expandSalesNavigatorCrawlAttempt(attempt, dimension, options.searchType);
+    const residualChildren = options.includeResidualExclusionSlices
+        ? [
+            buildSalesNavigatorResidualCrawlAttempt(attempt, dimension, options.searchType),
+        ]
+        : [];
+    return [...expandedChildren, ...residualChildren];
+}
+function getSalesNavigatorAttemptDimensionValues(attempt, dimension) {
+    const trailEntry = attempt.splitTrail.at(-1);
+    if (trailEntry?.key !== dimension.key) {
+        return null;
+    }
+    const filter = attempt.appliedFilters.find((entry) => entry.type === dimension.filterType);
+    if (!filter || filter.values.length !== 1) {
+        return null;
+    }
+    if (filter.values.some((value) => (value.selectionType ?? "INCLUDED") !== "INCLUDED")) {
+        return null;
+    }
+    return filter.values;
+}
+function buildSalesNavigatorCombinedCrawlAttempt(attempt, dimension, children, searchType = "people") {
+    const values = children.flatMap((child) => getSalesNavigatorAttemptDimensionValues(child.attempt, dimension) ?? []);
+    const filters = dedupeSalesNavigatorFilters([
+        ...attempt.appliedFilters.filter((filter) => filter.type !== dimension.filterType),
+        {
+            type: dimension.filterType,
+            values: values.map((value) => ({
+                ...value,
+                selectionType: value.selectionType ?? "INCLUDED",
+            })),
+        },
+    ]);
+    const sliced = searchType === "account"
+        ? buildSalesNavigatorAccountQuery(attempt.sourceQueryUrl, filters)
+        : buildSalesNavigatorPeopleQuery(attempt.sourceQueryUrl, filters);
+    const valueText = values.map((value) => value.text).join(" + ");
+    return {
+        ...sliced,
+        depth: attempt.depth + 1,
+        retryCount: 0,
+        maxResultsPerSearch: attempt.maxResultsPerSearch,
+        numberOfProfiles: attempt.numberOfProfiles,
+        slicePreset: attempt.slicePreset,
+        splitTrail: [
+            ...attempt.splitTrail,
+            {
+                key: dimension.key,
+                filterType: dimension.filterType,
+                value: {
+                    text: valueText,
+                    selectionType: "INCLUDED",
+                },
+            },
+        ],
+    };
+}
+async function coalesceSalesNavigatorUnderCapChildren(options) {
+    const packable = [];
+    const fixed = [];
+    for (const summary of options.summaries) {
+        const values = getSalesNavigatorAttemptDimensionValues(summary.attempt, options.dimension);
+        if (!values ||
+            summary.totalResults == null ||
+            summary.totalResults > summary.attempt.maxResultsPerSearch) {
+            fixed.push(summary);
+            continue;
+        }
+        packable.push(summary);
+    }
+    if (packable.length <= 1) {
+        return options.summaries;
+    }
+    const bins = [];
+    const ordered = [...packable].sort((left, right) => (right.totalResults ?? 0) - (left.totalResults ?? 0));
+    for (const item of ordered) {
+        let placed = false;
+        for (const bin of bins) {
+            const combinedAttempt = buildSalesNavigatorCombinedCrawlAttempt(options.parentAttempt, options.dimension, [...bin.children, item], options.searchType);
+            const combinedSummary = await probeSalesNavigatorAdaptiveAttempt(combinedAttempt, options.probeSlice, options.probeCache);
+            if (combinedSummary.totalResults != null &&
+                combinedSummary.totalResults <= combinedAttempt.maxResultsPerSearch) {
+                bin.children.push(item);
+                bin.summary = {
+                    attempt: combinedAttempt,
+                    totalResults: combinedSummary.totalResults,
+                };
+                placed = true;
+                break;
+            }
+        }
+        if (!placed) {
+            bins.push({
+                children: [item],
+                summary: item,
+            });
+        }
+    }
+    return [
+        ...bins.map((bin) => bin.summary),
+        ...fixed,
+    ];
+}
+function summarizeSalesNavigatorAdaptiveSplitCandidate(summaries, maxResultsPerSearch, estimate) {
+    const knownTotals = summaries
+        .map((summary) => summary.totalResults)
+        .filter((total) => typeof total === "number");
+    const knownChildren = knownTotals.length;
+    const oversizedChildren = knownTotals.filter((total) => total > maxResultsPerSearch).length;
+    const largestChildTotal = knownTotals.length > 0 ? Math.max(...knownTotals) : null;
+    const underCapTotals = knownTotals.filter((total) => total <= maxResultsPerSearch);
+    const utilization = underCapTotals.length === 0
+        ? 0
+        : underCapTotals.reduce((sum, total) => sum + total / maxResultsPerSearch, 0) / underCapTotals.length;
+    const largestPenalty = largestChildTotal == null
+        ? maxResultsPerSearch * 2
+        : Math.max(0, largestChildTotal - maxResultsPerSearch) /
+            maxResultsPerSearch;
+    return {
+        knownChildren,
+        oversizedChildren,
+        largestChildTotal,
+        estimatedFinalBatches: estimate.estimatedFinalBatches,
+        unresolvedChildren: estimate.unresolvedChildren,
+        score: estimate.unresolvedChildren * 1_000_000 +
+            estimate.estimatedFinalBatches * 1_000 +
+            oversizedChildren * 100 +
+            largestPenalty * 10 -
+            utilization,
+    };
+}
+async function estimateSalesNavigatorMinimumFinalBatches(options) {
+    const remainingDimensions = getUnusedSalesNavigatorDimensions(options.attempt, options.dimensions);
+    if (remainingDimensions.length === 0 ||
+        options.attempt.depth >= options.maxSplitDepth) {
+        return {
+            estimatedFinalBatches: 1,
+            unresolvedChildren: 1,
+            largestChildTotal: null,
+        };
+    }
+    const candidateEstimates = [];
+    for (const dimension of remainingDimensions) {
+        const rawChildren = buildSalesNavigatorAdaptiveChildren(options.attempt, dimension, options);
+        const rawSummaries = [];
+        for (const child of rawChildren) {
+            rawSummaries.push({
+                attempt: child,
+                ...(await probeSalesNavigatorAdaptiveAttempt(child, options.probeSlice, options.probeCache)),
+            });
+        }
+        const summaries = await coalesceSalesNavigatorUnderCapChildren({
+            parentAttempt: options.attempt,
+            dimension,
+            summaries: rawSummaries,
+            searchType: options.searchType,
+            probeSlice: options.probeSlice,
+            probeCache: options.probeCache,
+        });
+        let estimatedFinalBatches = 0;
+        let unresolvedChildren = 0;
+        let largestChildTotal = null;
+        for (const summary of summaries) {
+            if (summary.totalResults != null) {
+                largestChildTotal =
+                    largestChildTotal == null
+                        ? summary.totalResults
+                        : Math.max(largestChildTotal, summary.totalResults);
+            }
+            if (summary.totalResults != null &&
+                summary.totalResults <= summary.attempt.maxResultsPerSearch) {
+                estimatedFinalBatches += 1;
+                continue;
+            }
+            const childEstimate = await estimateSalesNavigatorMinimumFinalBatches({
+                ...options,
+                attempt: summary.attempt,
+            });
+            estimatedFinalBatches += childEstimate.estimatedFinalBatches;
+            unresolvedChildren += childEstimate.unresolvedChildren;
+            if (childEstimate.largestChildTotal != null) {
+                largestChildTotal =
+                    largestChildTotal == null
+                        ? childEstimate.largestChildTotal
+                        : Math.max(largestChildTotal, childEstimate.largestChildTotal);
+            }
+        }
+        candidateEstimates.push({
+            estimatedFinalBatches,
+            unresolvedChildren,
+            largestChildTotal,
+        });
+    }
+    candidateEstimates.sort((left, right) => {
+        if (left.unresolvedChildren !== right.unresolvedChildren) {
+            return left.unresolvedChildren - right.unresolvedChildren;
+        }
+        if (left.estimatedFinalBatches !== right.estimatedFinalBatches) {
+            return left.estimatedFinalBatches - right.estimatedFinalBatches;
+        }
+        return dimensionsSortValue(right.largestChildTotal) -
+            dimensionsSortValue(left.largestChildTotal);
+    });
+    return candidateEstimates[0] ?? {
+        estimatedFinalBatches: 1,
+        unresolvedChildren: 1,
+        largestChildTotal: null,
+    };
+}
+async function probeSalesNavigatorAdaptiveAttempt(attempt, probeSlice, probeCache) {
+    let cached = probeCache.get(attempt.slicedQueryUrl);
+    if (!cached) {
+        cached = probeSlice(attempt);
+        probeCache.set(attempt.slicedQueryUrl, cached);
+    }
+    return await cached;
+}
+async function chooseSalesNavigatorAdaptiveSplitCandidate(options) {
+    const candidates = [];
+    const probeCache = new Map();
+    for (const dimension of options.dimensions) {
+        const children = buildSalesNavigatorAdaptiveChildren(options.attempt, dimension, options).filter((child) => !options.seenQueryUrls.has(child.slicedQueryUrl));
+        if (children.length === 0) {
+            continue;
+        }
+        const summaries = [];
+        for (const child of children) {
+            summaries.push({
+                attempt: child,
+                ...(await probeSalesNavigatorAdaptiveAttempt(child, options.probeSlice, probeCache)),
+            });
+        }
+        const coalescedSummaries = await coalesceSalesNavigatorUnderCapChildren({
+            parentAttempt: options.attempt,
+            dimension,
+            summaries,
+            searchType: options.searchType,
+            probeSlice: options.probeSlice,
+            probeCache,
+        });
+        const coalescedChildren = coalescedSummaries.map((summary) => summary.attempt);
+        let estimatedFinalBatches = 0;
+        let unresolvedChildren = 0;
+        let largestChildTotal = null;
+        for (const summary of coalescedSummaries) {
+            if (summary.totalResults != null) {
+                largestChildTotal =
+                    largestChildTotal == null
+                        ? summary.totalResults
+                        : Math.max(largestChildTotal, summary.totalResults);
+            }
+            if (summary.totalResults != null &&
+                summary.totalResults <= summary.attempt.maxResultsPerSearch) {
+                estimatedFinalBatches += 1;
+                continue;
+            }
+            const childEstimate = await estimateSalesNavigatorMinimumFinalBatches({
+                attempt: summary.attempt,
+                dimensions: options.dimensions,
+                maxSplitDepth: options.maxSplitDepth,
+                searchType: options.searchType,
+                includeResidualExclusionSlices: options.includeResidualExclusionSlices,
+                probeSlice: options.probeSlice,
+                probeCache,
+            });
+            estimatedFinalBatches += childEstimate.estimatedFinalBatches;
+            unresolvedChildren += childEstimate.unresolvedChildren;
+            if (childEstimate.largestChildTotal != null) {
+                largestChildTotal =
+                    largestChildTotal == null
+                        ? childEstimate.largestChildTotal
+                        : Math.max(largestChildTotal, childEstimate.largestChildTotal);
+            }
+        }
+        const score = summarizeSalesNavigatorAdaptiveSplitCandidate(coalescedSummaries, options.attempt.maxResultsPerSearch, {
+            estimatedFinalBatches,
+            unresolvedChildren,
+        });
+        const largestTotal = largestChildTotal == null
+            ? score.largestChildTotal
+            : score.largestChildTotal == null
+                ? largestChildTotal
+                : Math.max(largestChildTotal, score.largestChildTotal);
+        candidates.push({
+            dimension,
+            children: coalescedChildren,
+            summaries: coalescedSummaries,
+            ...score,
+            largestChildTotal: largestTotal,
+        });
+    }
+    candidates.sort((left, right) => {
+        if (left.score !== right.score) {
+            return left.score - right.score;
+        }
+        if (left.oversizedChildren !== right.oversizedChildren) {
+            return left.oversizedChildren - right.oversizedChildren;
+        }
+        return dimensionsSortValue(right.largestChildTotal) -
+            dimensionsSortValue(left.largestChildTotal);
+    });
+    return candidates[0] ?? null;
+}
+function dimensionsSortValue(value) {
+    return value ?? -1;
+}
 export async function executeSalesNavigatorAdaptiveCrawl(options) {
     const dimensions = options.dimensions ?? DEFAULT_SALES_NAVIGATOR_CRAWL_DIMENSIONS;
     const maxSplitDepth = Math.min(options.maxSplitDepth ?? dimensions.length, dimensions.length);
@@ -577,6 +1031,7 @@ export async function executeSalesNavigatorAdaptiveCrawl(options) {
             maxResultsPerSearch: options.maxResultsPerSearch,
             numberOfProfiles: options.numberOfProfiles,
             slicePreset: options.slicePreset,
+            searchType: options.searchType,
         }),
     ];
     const seenQueryUrls = new Set(queue.map((attempt) => attempt.slicedQueryUrl));
@@ -597,9 +1052,18 @@ export async function executeSalesNavigatorAdaptiveCrawl(options) {
             exported.push({ attempt, result });
         }
         catch (error) {
+            if (error instanceof SalesNavigatorCrawlStopError) {
+                failed.push({
+                    attempt,
+                    error: error.message,
+                    totalResults: error.totalResults,
+                });
+                truncated = true;
+                break;
+            }
             if (error instanceof SalesNavigatorSliceTooBroadError) {
-                const nextDimension = dimensions[attempt.depth];
-                if (!nextDimension || attempt.depth >= maxSplitDepth) {
+                const remainingDimensions = getUnusedSalesNavigatorDimensions(attempt, dimensions);
+                if (remainingDimensions.length === 0 || attempt.depth >= maxSplitDepth) {
                     unresolved.push({
                         attempt,
                         error: error.message,
@@ -607,7 +1071,48 @@ export async function executeSalesNavigatorAdaptiveCrawl(options) {
                     });
                     continue;
                 }
-                const children = expandSalesNavigatorCrawlAttempt(attempt, nextDimension).filter((child) => {
+                let nextDimension = remainingDimensions[0];
+                let children = [];
+                let probeSummary;
+                let strategy = "fixed-order";
+                if (options.adaptiveSplitProbing && options.probeSlice) {
+                    const candidate = await chooseSalesNavigatorAdaptiveSplitCandidate({
+                        attempt,
+                        dimensions: remainingDimensions,
+                        searchType: options.searchType,
+                        includeResidualExclusionSlices: options.includeResidualExclusionSlices,
+                        seenQueryUrls,
+                        maxSplitDepth,
+                        probeSlice: options.probeSlice,
+                    });
+                    if (candidate) {
+                        nextDimension = candidate.dimension;
+                        children = candidate.children;
+                        strategy = "adaptive-probe";
+                        probeSummary = [
+                            {
+                                dimension: candidate.dimension.key,
+                                childCount: candidate.children.length,
+                                knownChildren: candidate.knownChildren,
+                                oversizedChildren: candidate.oversizedChildren,
+                                largestChildTotal: candidate.largestChildTotal,
+                                estimatedFinalBatches: candidate.estimatedFinalBatches,
+                                unresolvedChildren: candidate.unresolvedChildren,
+                                score: candidate.score,
+                            },
+                        ];
+                    }
+                }
+                if (children.length === 0) {
+                    const expandedChildren = expandSalesNavigatorCrawlAttempt(attempt, nextDimension, options.searchType);
+                    const residualChildren = options.includeResidualExclusionSlices
+                        ? [
+                            buildSalesNavigatorResidualCrawlAttempt(attempt, nextDimension, options.searchType),
+                        ]
+                        : [];
+                    children = [...expandedChildren, ...residualChildren];
+                }
+                children = children.filter((child) => {
                     if (seenQueryUrls.has(child.slicedQueryUrl)) {
                         return false;
                     }
@@ -627,6 +1132,8 @@ export async function executeSalesNavigatorAdaptiveCrawl(options) {
                     totalResults: error.totalResults,
                     nextDimension: nextDimension.key,
                     childCount: children.length,
+                    strategy,
+                    probeSummary,
                 });
                 queue.push(...children);
                 continue;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "salesprompter-cli",
-  "version": "0.1.40",
+  "version": "0.1.42",
   "description": "Sales workflow CLI for guided lead generation, enrichment, scoring, and sync.",
   "author": "Daniel Sinewe <hello@danielsinewe.com>",
   "type": "module",
@@ -66,8 +66,10 @@
   "dependencies": {
     "@google-cloud/bigquery": "^8.1.1",
     "@supabase/supabase-js": "^2.99.1",
+    "@types/pg": "^8.20.0",
     "cheerio": "^1.2.0",
     "commander": "^14.0.1",
+    "pg": "^8.21.0",
     "zod": "^4.1.5"
   },
   "overrides": {