@sellable/mcp 0.1.147 → 0.1.149

package/dist/tools/leads.d.ts

@@ -9,6 +9,9 @@ export declare function selectSignalPostsForImport<T extends SignalPostForImport
 }): {
     posts: T[];
     estimatedEngagers: number;
+    availableEngagers: number;
+    targetEngagerCount: number | null;
+    targetReached: boolean;
     limited: boolean;
 };
 export type GetProviderPromptInput = {

package/dist/tools/leads.js

@@ -343,13 +343,18 @@ export function selectSignalPostsForImport(posts, options) {
     const normalizedTargetEngagers = normalizePositiveInteger(options.targetEngagerCount);
     const normalizedMaxPosts = normalizePositiveInteger(options.maxPostsToScrape);
     if (!normalizedTargetEngagers && !normalizedMaxPosts) {
+        const availableEngagers = posts.reduce((sum, post) => sum + post.likes + post.comments, 0);
         return {
             posts,
-            estimatedEngagers: posts.reduce((sum, post) => sum + post.likes + post.comments, 0),
+            estimatedEngagers: availableEngagers,
+            availableEngagers,
+            targetEngagerCount: null,
+            targetReached: true,
             limited: false,
         };
     }
     const ranked = [...posts].sort((a, b) => b.likes + b.comments - (a.likes + a.comments));
+    const availableEngagers = ranked.reduce((sum, post) => sum + post.likes + post.comments, 0);
     const selected = [];
     let estimatedEngagers = 0;
     for (const post of ranked) {
@@ -366,6 +371,10 @@ export function selectSignalPostsForImport(posts, options) {
     return {
         posts: selected.length > 0 ? selected : ranked,
         estimatedEngagers,
+        availableEngagers,
+        targetEngagerCount: normalizedTargetEngagers ?? null,
+        targetReached: !normalizedTargetEngagers ||
+            estimatedEngagers >= normalizedTargetEngagers,
         limited: selected.length > 0 && selected.length < posts.length,
     };
 }
@@ -2312,12 +2321,19 @@ export async function importLeads(input) {
             maxPostsToScrape,
         });
         const postsToScrape = importSelection.posts;
+        if (!importSelection.targetReached && importSelection.targetEngagerCount) {
+            const capClause = importSelection.availableEngagers >= importSelection.targetEngagerCount
+                ? ` The selected posts can cover the target, but maxPostsToScrape=${normalizePositiveInteger(maxPostsToScrape)} prevents reaching it. Increase maxPostsToScrape or remove that cap.`
+                : " Select/promote more right-content posts, run another narrow Signal Discovery search, or switch to Sales Nav recent activity if the lane cannot produce enough source candidates.";
+            throw new Error(`Signal Discovery selected posts only cover about ${importSelection.estimatedEngagers.toLocaleString("en-US")} visible engagers, below the approved ${importSelection.targetEngagerCount.toLocaleString("en-US")} source-candidate target. Do not scrape this under-capacity post set.${capClause}`);
+        }
         const effectiveHeadlineICPCriteria = headlineICPCriteria && headlineICPCriteria.length > 0
             ? headlineICPCriteria
             : rubricGuidelines;
         // Start the scrape job
         const result = await api.post(`/api/v3/campaigns/${campaignOfferId}/signal-leads/create`, {
             posts: postsToScrape,
+            targetEngagerCount: importSelection.targetEngagerCount ?? undefined,
             ...(effectiveHeadlineICPCriteria &&
                 effectiveHeadlineICPCriteria.length > 0
                 ? {
@@ -2577,6 +2593,19 @@ export async function confirmLeadList(input) {
     const leadListConfig = leadListMeta.table?.config ?? null;
     const leadListRowCount = leadListMeta.rowCount ?? 0;
     const importProgress = leadListConfig?.importProgress ?? null;
+    const signalSourceTargetLeadCount = resolvedProvider === "signal-discovery" &&
+        typeof leadListConfig?.targetLeadCount === "number" &&
+        Number.isFinite(leadListConfig.targetLeadCount) &&
+        leadListConfig.targetLeadCount > 0
+        ? leadListConfig.targetLeadCount
+        : null;
+    if (resolvedProvider === "signal-discovery" &&
+        signalSourceTargetLeadCount !== null &&
+        leadListConfig?.importStatus === "complete" &&
+        leadListRowCount > 0 &&
+        leadListRowCount < signalSourceTargetLeadCount) {
+        throw new Error(`Signal Discovery source list is under capacity: it completed with ${leadListRowCount.toLocaleString("en-US")} source candidates, below the approved ${signalSourceTargetLeadCount.toLocaleString("en-US")} source-candidate target. Do not import the bounded review batch from this source. Select more posts, rerun Signal Discovery, or move to Sales Nav/Prospeo.`);
+    }
     const progressProcessed = typeof importProgress?.processed === "number"
         ? importProgress.processed
         : null;

package/dist/tools/readiness.js

@@ -101,7 +101,7 @@ export const readinessToolDefinitions = [
                 },
                 targetLeadCount: {
                     type: "number",
-                    description: "Target number of leads requested. Used as a fallback completion check when status is unavailable.",
+                    description: "Target number of leads requested. Used as a fallback completion check when status is unavailable. For Signal Discovery, pass the approved source-candidate target; if the completed source list lands below it, the tool returns source_under_capacity instead of ready.",
                 },
                 timeoutMs: {
                     type: "number",
@@ -472,6 +472,23 @@ export async function waitForLeadListReady(input) {
                 }
             }
             if ((!requireRows || rowCount > 0) && importComplete) {
+                if (provider === "signal-discovery" &&
+                    typeof targetLeadCount === "number" &&
+                    rowCount > 0 &&
+                    rowCount < targetLeadCount) {
+                    return {
+                        ready: false,
+                        reason: "source_under_capacity",
+                        leadListId,
+                        provider: provider ?? null,
+                        attempts,
+                        elapsedMs: Date.now() - start,
+                        rowCount,
+                        status: lastStatus,
+                        targetLeadCount,
+                        error: `Signal Discovery completed with ${rowCount.toLocaleString("en-US")} source candidates, below the approved ${targetLeadCount.toLocaleString("en-US")} source-candidate target. Do not confirm this lead list; select more posts, rerun source discovery, or move to Sales Nav/Prospeo.`,
+                    };
+                }
                 return {
                     ready: true,
                     leadListId,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sellable/mcp",
-  "version": "0.1.147",
+  "version": "0.1.149",
   "type": "module",
   "description": "Sellable MCP server for Claude Code and Codex campaign workflows",
   "main": "dist/index.js",

package/skills/create-campaign-v2/references/step-13-import-leads.md

@@ -127,9 +127,11 @@ rate with a conservative cleanup factor, cap the source candidates at the
 approved provider limit, and select only enough posts to reach that engager
 count. The planning floor is 10% projected fit after cleanup; if Signal
 Discovery falls below that floor, do not import the source list. Route back to
-find-leads and move to Sales Nav recent activity instead. The subsequent
-`confirm_lead_list` call still uses `targetLeadCount: <importLimit>` so only the
-bounded review batch enters the campaign table.
+find-leads and move to Sales Nav recent activity instead. After the scrape,
+`wait_for_lead_list_ready` must clear the approved source-candidate target; if
+it reports `source_under_capacity`, do not call `confirm_lead_list`. The
+subsequent `confirm_lead_list` call still uses `targetLeadCount: <importLimit>`
+so only the bounded review batch enters the campaign table.
 
 For supplied direct lists, `confirm_lead_list` must receive
 `targetLeadCount: <importLimit>` or explicit `sourceRowIds` so a 100-row source

package/skills/providers/signal-discovery.md

@@ -459,6 +459,9 @@ targetLeadCount, targetEngagerCount, maxPostsToScrape })` for the approved
 source-capacity plan without asking for another yes/no gate. Then
 `confirm_lead_list` imports only the bounded review batch into the campaign
 table. Do not confuse the source-candidate target with the review-batch size.
+If the completed source scrape comes back below the approved source-candidate
+target, do not call `confirm_lead_list`; select more posts, rerun source
+discovery, or move to Sales Nav.
 
 The promotion/select step is required campaign state. Use post IDs from the
 current campaign-scoped search result, not stale IDs copied from a source review