@sellable/mcp 0.1.299 → 0.1.300

package/dist/tools/readiness.d.ts

@@ -284,6 +284,7 @@ export declare function waitForLeadListReady(input: WaitForLeadListReadyInput):
     error?: undefined;
     sourceShortfall?: undefined;
     warning?: undefined;
+    materializing?: undefined;
 } | {
     ready: boolean;
     reason: string;
@@ -297,6 +298,7 @@ export declare function waitForLeadListReady(input: WaitForLeadListReadyInput):
     error?: undefined;
     sourceShortfall?: undefined;
     warning?: undefined;
+    materializing?: undefined;
 } | {
     ready: boolean;
     reason: string;
@@ -310,6 +312,7 @@ export declare function waitForLeadListReady(input: WaitForLeadListReadyInput):
     error: string;
     sourceShortfall?: undefined;
     warning?: undefined;
+    materializing?: undefined;
 } | {
     ready: boolean;
     reason: string;
@@ -323,6 +326,7 @@ export declare function waitForLeadListReady(input: WaitForLeadListReadyInput):
     error: string | null;
     sourceShortfall?: undefined;
     warning?: undefined;
+    materializing?: undefined;
 } | {
     ready: boolean;
     leadListId: string;
@@ -336,6 +340,7 @@ export declare function waitForLeadListReady(input: WaitForLeadListReadyInput):
     warning: string | undefined;
     reason?: undefined;
     error?: undefined;
+    materializing?: undefined;
 } | {
     ready: boolean;
     reason: string;
@@ -346,6 +351,7 @@ export declare function waitForLeadListReady(input: WaitForLeadListReadyInput):
     rowCount: number | null;
     status: string | undefined;
     targetLeadCount: number | undefined;
+    materializing: boolean | undefined;
     warning: string | undefined;
     error: string | undefined;
     sourceShortfall?: undefined;

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. For Signal Discovery, pass the approved source-candidate target; if the completed source list lands below it, the tool still returns ready with a source_shortfall warning so the confirmed list can be copied and campaign setup can proceed.",
+                    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 still returns ready with a source_shortfall warning after completed source rows are stable so the confirmed list can be copied and campaign setup can proceed.",
                 },
                 timeoutMs: {
                     type: "number",
@@ -209,6 +209,8 @@ export async function waitForLeadListReady(input) {
     let missingJobId = false;
     let signalPendingSince = null;
     let signalPendingFingerprint = null;
+    let signalCompleteFingerprint = null;
+    let materializingSourceRows = false;
     while (Date.now() - start <= effectiveTimeoutMs) {
         attempts += 1;
         try {
@@ -472,6 +474,26 @@ export async function waitForLeadListReady(input) {
                 }
             }
             if ((!requireRows || rowCount > 0) && importComplete) {
+                const shouldVerifyStableSignalRows = provider === "signal-discovery" &&
+                    requireComplete &&
+                    rowCount > 0 &&
+                    configStatus === "complete";
+                if (shouldVerifyStableSignalRows) {
+                    const nextCompleteFingerprint = JSON.stringify({
+                        rowCount,
+                        status: configStatus,
+                        phase: importProgress?.phase ?? null,
+                        processed: importProgress?.processed ?? null,
+                        total: importProgress?.total ?? null,
+                        leadsImported: importProgress?.leadsImported ?? null,
+                    });
+                    if (signalCompleteFingerprint !== nextCompleteFingerprint) {
+                        signalCompleteFingerprint = nextCompleteFingerprint;
+                        materializingSourceRows = true;
+                        await sleep(intervalMs);
+                        continue;
+                    }
+                }
                 const signalSourceShortfallTarget = provider === "signal-discovery" && typeof targetLeadCount === "number"
                     ? targetLeadCount
                     : null;
@@ -503,13 +525,15 @@ export async function waitForLeadListReady(input) {
     const stillRunningWithRows = requireComplete && timedOutWithRows;
     const timeoutReason = missingJobId
         ? "missing_job_id"
-        : stillRunningWithRows
-            ? "import_still_running"
-            : timedOutWithRows
-                ? "timeout_with_rows"
-                : guardApplied
-                    ? "tool_timeout_guard"
-                    : "timeout";
+        : materializingSourceRows
+            ? "materializing"
+            : stillRunningWithRows
+                ? "import_still_running"
+                : timedOutWithRows
+                    ? "timeout_with_rows"
+                    : guardApplied
+                        ? "tool_timeout_guard"
+                        : "timeout";
     return {
         ready: !requireComplete && !missingJobId && timedOutWithRows,
         reason: timeoutReason,
@@ -520,13 +544,16 @@ export async function waitForLeadListReady(input) {
         rowCount: lastRowCount,
         status: lastStatus ?? undefined,
         targetLeadCount: targetLeadCount ?? undefined,
-        warning: stillRunningWithRows
-            ? `Import still appears to be running with ${lastRowCount?.toLocaleString("en-US") ?? "some"} row(s) available. Re-run wait_for_lead_list_ready to keep polling, or only call confirm_lead_list with allowPartialSourceList after the user explicitly asks to continue early.`
-            : !missingJobId && timedOutWithRows
-                ? "Timed out waiting for import status, but rows exist."
-                : guardApplied
-                    ? `Stopped after ${effectiveTimeoutMs}ms to avoid host tool timeout (requested ${requestedTimeoutMs}ms). Re-run wait_for_lead_list_ready to keep polling.`
-                    : undefined,
+        materializing: materializingSourceRows || undefined,
+        warning: materializingSourceRows
+            ? `Source import completed but source rows are still materializing. Re-run wait_for_lead_list_ready before confirm_lead_list; do not call confirm_lead_list until this tool returns ready: true.`
+            : stillRunningWithRows
+                ? `Import still appears to be running with ${lastRowCount?.toLocaleString("en-US") ?? "some"} row(s) available. Re-run wait_for_lead_list_ready to keep polling, or only call confirm_lead_list with allowPartialSourceList after the user explicitly asks to continue early.`
+                : !missingJobId && timedOutWithRows
+                    ? "Timed out waiting for import status, but rows exist."
+                    : guardApplied
+                        ? `Stopped after ${effectiveTimeoutMs}ms to avoid host tool timeout (requested ${requestedTimeoutMs}ms). Re-run wait_for_lead_list_ready to keep polling.`
+                        : undefined,
         error: lastError ?? undefined,
     };
 }

package/package.json

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