@sellable/mcp 0.1.80 → 0.1.82

package/dist/tools/leads.js

@@ -18,6 +18,7 @@ const defaultLeadImportLimits = {
     apollo: { maxImportCount: 2500 },
     "sales-nav": { maxImportCount: 2500 },
     prospeo: { maxImportCount: 10000 },
+    "signal-discovery": { maxImportCount: 2500 },
 };
 const defaultSignalDiscoveryConfig = {
     selection: {
@@ -388,6 +389,25 @@ function summarizeSignalSearchResponse(response) {
         ],
     };
 }
+function normalizeImportProvider(provider) {
+    if (provider === "apollo-ai" || provider === "apollo")
+        return "apollo";
+    if (provider === "sales-nav")
+        return "sales-nav";
+    if (provider === "prospeo")
+        return "prospeo";
+    if (provider === "signal-discovery")
+        return "signal-discovery";
+    return undefined;
+}
+function assertPhase126ImportProvider(provider, campaignOfferId) {
+    if (!provider) {
+        throw new Error(`import_leads requires a supported leadSourceProvider for campaign ${campaignOfferId}. Provide provider or set campaign.leadSourceProvider to sales-nav, prospeo, or signal-discovery, then call get_provider_prompt({ provider, campaignOfferId }).`);
+    }
+    if (provider === "apollo") {
+        throw new Error(`Apollo is not offered as a Phase 126 post-mint source for campaign ${campaignOfferId}. Choose sales-nav, prospeo, or signal-discovery; call get_provider_prompt({ provider, campaignOfferId }), then retry import_leads.`);
+    }
+}
 export const leadToolDefinitions = [
     {
         name: "get_provider_prompt",
@@ -985,7 +1005,7 @@ export const leadToolDefinitions = [
     },
     {
         name: "confirm_lead_list",
-        description: "After the user confirms the lead list looks good, import it into the campaign table (clone) and update selectedLeadListId to the campaign table. Recommended post-confirm order: update_campaign(currentStep='filter-choice') -> wait_for_campaign_table_ready -> get_rows_minimal.",
+        description: "After the user confirms the lead list looks good, import it into the campaign table (clone). selectedLeadListId remains the source lead list; workflowTableId is the campaign table. Recommended post-confirm order: update_campaign(currentStep='filter-choice') -> wait_for_campaign_table_ready -> get_rows_minimal.",
         inputSchema: {
             type: "object",
             properties: {
@@ -1841,17 +1861,7 @@ export async function importLeads(input) {
         // Pull campaign once when we need provider or to determine default step behavior.
         const campaign = await api.get(`/api/v2/campaign-offers/${campaignOfferId}`);
         if (!provider) {
-            const leadSourceProvider = campaign.leadSourceProvider;
-            provider =
-                leadSourceProvider === "apollo-ai" || leadSourceProvider === "apollo"
-                    ? "apollo"
-                    : leadSourceProvider === "sales-nav"
-                        ? "sales-nav"
-                        : leadSourceProvider === "prospeo"
-                            ? "prospeo"
-                            : leadSourceProvider === "signal-discovery"
-                                ? "signal-discovery"
-                                : undefined;
+            provider = normalizeImportProvider(campaign.leadSourceProvider);
         }
         if (currentStep === undefined) {
             campaignCurrentStep = campaign.currentStep ?? null;
@@ -1875,6 +1885,7 @@ export async function importLeads(input) {
         : currentStep;
     const shouldSetCurrentStep = typeof effectiveCurrentStep === "string" && effectiveCurrentStep.length > 0;
     const normalizedMode = mode === "add" || mode === "replace" ? mode : undefined;
+    assertPhase126ImportProvider(provider, campaignOfferId);
     // If no sourceLeadListId but campaign has one selected, handle mode selection
     if (!sourceLeadListId && campaignSelectedLeadListId) {
         // If mode is provided but sourceLeadListId is missing, remind LLM to pass it
@@ -1896,7 +1907,7 @@ export async function importLeads(input) {
         }
         // No mode provided - ask user to choose
         return {
-            provider: provider || "apollo",
+            provider,
             leadListId: campaignSelectedLeadListId,
             existingLeadListId: campaignSelectedLeadListId,
             needsModeSelection: true,
@@ -1922,22 +1933,14 @@ export async function importLeads(input) {
             ],
         };
     }
-    const normalizedProvider = provider === "sales-nav" || provider === "prospeo" ? provider : "apollo";
-    const providerForGuard = provider === "sales-nav" ||
-        provider === "prospeo" ||
-        provider === "signal-discovery"
-        ? provider
-        : "apollo";
     assertProviderPromptLoaded({
-        provider: providerForGuard,
+        provider,
         campaignOfferId,
     });
-    const maxImportCount = getMaxImportCount(normalizedProvider);
+    const maxImportCount = getMaxImportCount(provider);
     const normalizedTargetLeadCount = normalizeTargetLeadCount(targetLeadCount, maxImportCount);
     const requestedLeadCount = normalizedTargetLeadCount ??
-        (normalizedProvider === "sales-nav" || normalizedProvider === "prospeo"
-            ? 100
-            : undefined);
+        (provider === "sales-nav" || provider === "prospeo" ? 100 : undefined);
     const cappedTargetLeadCount = requestedLeadCount !== undefined
         ? Math.min(requestedLeadCount, maxImportCount)
         : undefined;
@@ -1968,7 +1971,7 @@ export async function importLeads(input) {
             }
         }
         if (selectedPosts.length === 0) {
-            throw new Error("No posts selected. Call select_promising_posts first.");
+            throw new Error("No usable Signal Discovery posts are selected for import. Keep currentStep at provider/search, refine the search, switch provider, or call select_promising_posts with usable posts before import_leads.");
         }
         // De-duplicate selected posts by canonical URL to avoid double scraping.
         const uniqueByUrl = new Map();
@@ -2016,19 +2019,15 @@ export async function importLeads(input) {
             message: `Started scraping ${uniqueSelectedPosts.length} posts (~${result.estimatedEngagers} engagers). Leads will appear as scraping completes.`,
         };
     }
-    // === APOLLO / SALES NAV FLOW ===
+    // === SALES NAV / PROSPEO FLOW ===
     let leadListId = sourceLeadListId;
     let createdLeadList = null;
     // Create lead list if not provided
     if (!leadListId) {
         if (!searchId) {
-            throw new Error(`import_leads for ${provider || "apollo"} requires sourceLeadListId or searchId`);
+            throw new Error(`import_leads for ${provider} requires sourceLeadListId or searchId`);
         }
-        const providerLabel = provider === "sales-nav"
-            ? "Sales Nav"
-            : provider === "prospeo"
-                ? "Prospeo"
-                : "Apollo";
+        const providerLabel = provider === "sales-nav" ? "Sales Nav" : "Prospeo";
         const fallbackName = leadListName ||
             (searchName ? `${providerLabel} - ${searchName}` : undefined) ||
             `${providerLabel} Import ${new Date().toISOString().slice(0, 10)}`;
@@ -2052,6 +2051,7 @@ export async function importLeads(input) {
                 return api.post(`/api/v3/sales-nav/export`, {
                     searchId,
                     workflowTableId: leadListId,
+                    campaignOfferId,
                     targetLeadCount: cappedTargetLeadCount ?? 100,
                     ...(normalizedMode ? { mode: normalizedMode } : {}),
                 });
@@ -2059,16 +2059,12 @@ export async function importLeads(input) {
             if (provider === "prospeo") {
                 return api.post(`/api/v3/lead-lists/${leadListId}/prospeo-import/start`, {
                     searchId,
+                    campaignOfferId,
                     targetLeadCount: cappedTargetLeadCount,
                     ...(normalizedMode ? { mode: normalizedMode } : {}),
                 });
             }
-            // Apollo import flow (default)
-            return api.post(`/api/v3/lead-lists/${leadListId}/apollo-import/start`, {
-                searchId,
-                targetLeadCount: cappedTargetLeadCount,
-                ...(normalizedMode ? { mode: normalizedMode } : {}),
-            });
+            throw new Error(`Unsupported import provider ${provider}. Choose sales-nav, prospeo, or signal-discovery.`);
         };
         try {
             jobResult = await startImport();
@@ -2079,7 +2075,7 @@ export async function importLeads(input) {
                 const parsed = parseApiErrorBody(error.body) || {};
                 if (parsed.error === "lead_list_exists" || parsed.modeRequired) {
                     return {
-                        provider: provider || "apollo",
+                        provider,
                         leadListId,
                         existingLeadListId: leadListId,
                         needsModeSelection: true,
@@ -2119,7 +2115,7 @@ export async function importLeads(input) {
         ...(shouldSetCurrentStep ? { currentStep: effectiveCurrentStep } : {}),
     });
     return {
-        provider: provider || "apollo",
+        provider,
         leadListId,
         createdLeadList,
         jobResult,
@@ -2254,12 +2250,12 @@ export async function confirmLeadList(input) {
     }
     if (!readiness.ready) {
         if (readiness.reason === "missing_job_id") {
-            throw new Error("Import job ID is missing. Please provide the jobId for this import.");
+            throw new Error("Import job ID is missing. Keep the campaign at confirm-lead-list; provide the jobId, retry readiness, cancel the import, or re-run-source before confirming.");
         }
         if (readiness.reason === "import_failed") {
-            throw new Error("Import failed. Please retry before confirming.");
+            throw new Error("Import failed. Keep the campaign at confirm-lead-list; retry the provider import, cancel it, or re-run-source before confirming.");
         }
-        throw new Error("Import still in progress. Please wait for completion.");
+        throw new Error("Import still in progress. Keep the campaign at confirm-lead-list; retry readiness, cancel the import, or re-run-source before launching post-import scouts.");
     }
     const importResult = await api.post(`/api/v3/campaign-builder/import-leads`, {
         sourceLeadListId: resolvedLeadListId,

package/dist/tools/navigation.d.ts

@@ -9,15 +9,26 @@ export type CampaignOfferNavigation = {
     campaignBrief?: {
         content?: string | null;
     } | string | null;
+    useMessagingTemplate?: boolean | null;
+    messagingTemplateId?: string | null;
+    messagingTemplate?: unknown | null;
     leadSourceType?: string | null;
     leadSourceProvider?: string | null;
     selectedLeadListId?: string | null;
     workflowTableId?: string | null;
+    enableICPFilters?: boolean | null;
+    leadScoringRubrics?: Array<{
+        useCheckForScoring?: boolean | null;
+    }> | null;
+    senderIds?: string[] | null;
+    sequenceTemplate?: unknown | null;
+    campaignStatus?: string | null;
+    status?: string | null;
     currentStep?: string | null;
 };
 type NavigationDebugPayload = Record<string, unknown>;
 export declare function logNavigationDebug(event: string, payload?: NavigationDebugPayload, campaignId?: string | null): void;
-type CreateCampaignStepId = "campaign-created" | "pick-provider" | "provider-search" | "confirm-lead-list";
+type CreateCampaignStepId = "campaign-created" | "pick-provider" | "provider-search" | "confirm-lead-list" | "filter-rules" | "messages" | "settings" | "sequence" | "send" | "running";
 export declare const navigationToolDefinitions: {
     name: string;
     description: string;
@@ -42,6 +53,10 @@ type NavigationComputeOptions = {
     tableChecked: boolean;
     rowCount: number | null;
     hasWorkflowRows: boolean | null;
+    selectedLeadListChecked?: boolean;
+    selectedLeadListAccessible?: boolean | null;
+    selectedLeadListRowCount?: number | null;
+    workflowTableAccessible?: boolean | null;
     initialWarnings?: string[];
 };
 export declare function computeCampaignNavigationStateFromCampaign(campaign: CampaignOfferNavigation, options: NavigationComputeOptions): {
@@ -63,6 +78,12 @@ export declare function computeCampaignNavigationStateFromCampaign(campaign: Cam
         leadSourceProvider: string | null;
         selectedLeadListId: string | null;
         providerCurrentStep: string | null;
+        enableICPFilters: boolean | null;
+        activeRubricCount: number;
+        hasApprovedMessageTemplate: boolean;
+        senderCount: number;
+        hasSequenceTemplate: boolean;
+        campaignStatus: string | null;
     };
     warnings: string[];
 };
@@ -85,6 +106,12 @@ export declare function getCampaignNavigationState(input: GetCampaignNavigationS
         leadSourceProvider: string | null;
         selectedLeadListId: string | null;
         providerCurrentStep: string | null;
+        enableICPFilters: boolean | null;
+        activeRubricCount: number;
+        hasApprovedMessageTemplate: boolean;
+        senderCount: number;
+        hasSequenceTemplate: boolean;
+        campaignStatus: string | null;
     };
     warnings: string[];
 }>;

package/dist/tools/navigation.js

@@ -134,6 +134,56 @@ function getBriefContent(brief) {
         return brief;
     return brief.content || "";
 }
+function hasActiveRubrics(campaign) {
+    return (campaign.leadScoringRubrics?.some((rubric) => rubric.useCheckForScoring !== false) ?? false);
+}
+function hasApprovedMessageTemplate(campaign) {
+    if (campaign.messagingTemplateId || campaign.messagingTemplate)
+        return true;
+    const briefContent = getBriefContent(campaign.campaignBrief);
+    if (!briefContent.trim())
+        return false;
+    return (/approved message template/i.test(briefContent) &&
+        (/token fill rules/i.test(briefContent) ||
+            /token fill examples/i.test(briefContent) ||
+            /{{[^}]+}}/.test(briefContent)));
+}
+function hasSenderIds(campaign) {
+    return Array.isArray(campaign.senderIds) && campaign.senderIds.length > 0;
+}
+function hasSequenceTemplate(campaign) {
+    return Boolean(campaign.sequenceTemplate);
+}
+function isRunningCampaign(campaign) {
+    const status = String(campaign.campaignStatus ?? campaign.status ?? "")
+        .trim()
+        .toLowerCase();
+    return (campaign.currentStep === "running" ||
+        status === "running" ||
+        status === "active" ||
+        status === "started");
+}
+function shouldEvaluateTailState(campaign) {
+    const tailCurrentSteps = new Set([
+        "messages",
+        "auto-execute-leads",
+        "auto-execute-messaging",
+        "awaiting-user-greenlight",
+        "settings",
+        "sequence",
+        "send",
+        "claude-greenlight",
+        "running",
+    ]);
+    return ((campaign.currentStep
+        ? tailCurrentSteps.has(campaign.currentStep)
+        : false) ||
+        campaign.useMessagingTemplate === true ||
+        hasApprovedMessageTemplate(campaign) ||
+        hasSenderIds(campaign) ||
+        hasSequenceTemplate(campaign) ||
+        isRunningCampaign(campaign));
+}
 function checkCampaignCreated(campaign) {
     const missing = [];
     if (!campaign.id)
@@ -161,36 +211,94 @@ function checkProviderSearch(campaign) {
         missing.push("leadSourceProvider");
     return { stepId: "provider-search", missing };
 }
-function checkConfirmLeadList(campaign, hasWorkflowRows, enforceRowCheck) {
+function checkConfirmLeadList(campaign, hasWorkflowRows, enforceRowCheck, refs) {
     const missing = [];
     if (!campaign.selectedLeadListId)
         missing.push("selectedLeadListId");
     if (!campaign.workflowTableId)
         missing.push("workflowTableId");
+    if (campaign.selectedLeadListId &&
+        refs.selectedLeadListChecked &&
+        refs.selectedLeadListAccessible === false) {
+        missing.push("selectedLeadList");
+    }
+    if (campaign.workflowTableId && refs.workflowTableAccessible === false) {
+        missing.push("workflowTable");
+    }
     if (enforceRowCheck && hasWorkflowRows === false) {
         missing.push("workflowTableRows");
     }
     return { stepId: "confirm-lead-list", missing };
 }
+function checkRubrics(campaign) {
+    const missing = [];
+    const filtersRequired = campaign.enableICPFilters === true;
+    if (filtersRequired && !hasActiveRubrics(campaign)) {
+        missing.push("leadScoringRubrics");
+    }
+    return { stepId: "filter-rules", missing };
+}
+function checkMessages(campaign) {
+    const missing = [];
+    if (!hasApprovedMessageTemplate(campaign)) {
+        missing.push("approvedMessageTemplate");
+    }
+    return { stepId: "messages", missing };
+}
+function checkSettings(campaign) {
+    const missing = [];
+    if (!hasSenderIds(campaign))
+        missing.push("senderIds");
+    return { stepId: "settings", missing };
+}
+function checkSequence(campaign) {
+    const missing = [];
+    if (!hasSequenceTemplate(campaign))
+        missing.push("sequenceTemplate");
+    return { stepId: "sequence", missing };
+}
 function mapHeadlessToUiStep(step) {
     if (!step)
         return null;
-    if (step === "configure-columns" || step === "confirm-lead-list") {
-        return "leads";
-    }
     if (step === "create-offer")
         return "plan";
+    if (step === "select-lead-source")
+        return "choose-source";
     if (step === "pick-provider")
         return "pick-provider";
     if (step === "apollo" || step === "sales-nav" || step === "prospeo") {
         return "contact-search";
     }
+    if (step === "configure-columns" ||
+        step === "apollo-select-leads" ||
+        step === "sales-nav-select-leads" ||
+        step === "prospeo-select-leads" ||
+        step === "signal-discovery-results" ||
+        step === "confirm-lead-list") {
+        return "leads";
+    }
     if (step === "signal-discovery")
         return "signal-discovery";
-    if (step === "signal-discovery-results")
-        return "leads";
     if (step === "filter-choice")
         return "filter-choice";
+    if (step === "create-icp-rubric")
+        return "filter-rules";
+    if (step === "apply-icp-rubric" || step === "validate-sample") {
+        return "filter-leads";
+    }
+    if (step === "messages" ||
+        step === "auto-execute-leads" ||
+        step === "auto-execute-messaging") {
+        return "messages";
+    }
+    if (step === "settings" || step === "awaiting-user-greenlight") {
+        return "settings";
+    }
+    if (step === "sequence")
+        return "sequence";
+    if (step === "send" || step === "claude-greenlight" || step === "running") {
+        return "send";
+    }
     return null;
 }
 export const navigationToolDefinitions = [
@@ -227,6 +335,11 @@ export function computeCampaignNavigationStateFromCampaign(campaign, options) {
             leadSourceProvider: campaign.leadSourceProvider ?? null,
             selectedLeadListId: campaign.selectedLeadListId ?? null,
             workflowTableId: campaign.workflowTableId ?? null,
+            enableICPFilters: campaign.enableICPFilters ?? null,
+            activeRubricCount: campaign.leadScoringRubrics?.filter((rubric) => rubric.useCheckForScoring !== false).length ?? 0,
+            senderCount: campaign.senderIds?.length ?? 0,
+            hasSequenceTemplate: hasSequenceTemplate(campaign),
+            campaignStatus: campaign.campaignStatus ?? campaign.status ?? null,
             currentStep: campaign.currentStep ?? null,
         },
         options: {
@@ -234,6 +347,9 @@ export function computeCampaignNavigationStateFromCampaign(campaign, options) {
             tableChecked: options.tableChecked,
             rowCount: options.rowCount,
             hasWorkflowRows: options.hasWorkflowRows,
+            selectedLeadListChecked: options.selectedLeadListChecked ?? false,
+            selectedLeadListAccessible: options.selectedLeadListAccessible ?? null,
+            workflowTableAccessible: options.workflowTableAccessible ?? null,
             initialWarningsCount: options.initialWarnings?.length ?? 0,
         },
     }, campaign.id);
@@ -252,8 +368,19 @@ export function computeCampaignNavigationStateFromCampaign(campaign, options) {
         checkCampaignCreated(campaign),
         checkPickProvider(campaign),
         checkProviderSearch(campaign),
-        checkConfirmLeadList(campaign, options.hasWorkflowRows, enforceRowCheck),
+        checkConfirmLeadList(campaign, options.hasWorkflowRows, enforceRowCheck, {
+            selectedLeadListChecked: options.selectedLeadListChecked === true,
+            selectedLeadListAccessible: options.selectedLeadListAccessible ?? null,
+            workflowTableAccessible: options.workflowTableAccessible ?? null,
+        }),
     ];
+    if (campaign.enableICPFilters === true) {
+        checks.push(checkRubrics(campaign));
+    }
+    const evaluateTailState = shouldEvaluateTailState(campaign);
+    if (evaluateTailState) {
+        checks.push(checkMessages(campaign), checkSettings(campaign), checkSequence(campaign));
+    }
     let computedStep = "campaign-created";
     let blockedAt = null;
     let missing = [];
@@ -271,11 +398,24 @@ export function computeCampaignNavigationStateFromCampaign(campaign, options) {
         }
         computedStep = check.stepId;
     }
+    if (!blockedAt && evaluateTailState) {
+        computedStep = isRunningCampaign(campaign) ? "running" : "send";
+    }
     const expectedHeadlessStep = computedStep === "campaign-created"
         ? "create-offer"
         : computedStep === "provider-search"
             ? providerConfig?.currentStep || campaign.leadSourceProvider || null
-            : computedStep;
+            : computedStep === "filter-rules"
+                ? "create-icp-rubric"
+                : computedStep === "messages"
+                    ? "messages"
+                    : computedStep === "settings"
+                        ? "settings"
+                        : computedStep === "sequence"
+                            ? "sequence"
+                            : computedStep === "running"
+                                ? "running"
+                                : computedStep;
     const stepAligned = !campaign.currentStep || !expectedHeadlessStep
         ? null
         : campaign.currentStep === expectedHeadlessStep;
@@ -304,6 +444,12 @@ export function computeCampaignNavigationStateFromCampaign(campaign, options) {
             leadSourceProvider: campaign.leadSourceProvider ?? null,
             selectedLeadListId: campaign.selectedLeadListId ?? null,
             providerCurrentStep: providerConfig?.currentStep ?? null,
+            enableICPFilters: campaign.enableICPFilters ?? null,
+            activeRubricCount: campaign.leadScoringRubrics?.filter((rubric) => rubric.useCheckForScoring !== false).length ?? 0,
+            hasApprovedMessageTemplate: hasApprovedMessageTemplate(campaign),
+            senderCount: campaign.senderIds?.length ?? 0,
+            hasSequenceTemplate: hasSequenceTemplate(campaign),
+            campaignStatus: campaign.campaignStatus ?? campaign.status ?? null,
         },
         warnings,
     };
@@ -328,7 +474,31 @@ export async function getCampaignNavigationState(input) {
         campaignId: input.campaignId,
         includeTableCheck,
     }, input.campaignId);
-    const campaign = await api.get(`/api/v2/campaign-offers/${input.campaignId}`);
+    let campaign;
+    try {
+        campaign = await api.get(`/api/v2/campaign-offers/${input.campaignId}`);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        const unavailable = computeCampaignNavigationStateFromCampaign({
+            id: input.campaignId,
+            campaignBrief: null,
+            currentStep: null,
+        }, {
+            includeTableCheck,
+            tableChecked: false,
+            rowCount: null,
+            hasWorkflowRows: null,
+            initialWarnings: [
+                `Campaign is missing or inaccessible. Remediation: confirm the campaignId and active workspace, then retry. Detail: ${message}`,
+            ],
+        });
+        return {
+            ...unavailable,
+            blockedAt: "campaign-created",
+            missing: ["campaign"],
+        };
+    }
     logNavigationDebug("state.fetch_campaign.success", {
         campaignId: input.campaignId,
         workflowTableId: campaign.workflowTableId ?? null,
@@ -338,8 +508,39 @@ export async function getCampaignNavigationState(input) {
     }, input.campaignId);
     let tableRowCount = null;
     let hasWorkflowRows = null;
+    let workflowTableAccessible = campaign.workflowTableId
+        ? null
+        : true;
+    let selectedLeadListChecked = false;
+    let selectedLeadListAccessible = campaign.selectedLeadListId
+        ? null
+        : true;
+    let selectedLeadListRowCount = null;
     const warnings = [];
     let tableChecked = false;
+    if (includeTableCheck &&
+        campaign.selectedLeadListId &&
+        campaign.selectedLeadListId !== campaign.workflowTableId) {
+        try {
+            const rows = await getTableRowsMinimal(campaign.selectedLeadListId, {
+                limit: 1,
+                page: 1,
+            });
+            selectedLeadListChecked = true;
+            selectedLeadListAccessible = true;
+            selectedLeadListRowCount = rows.pagination?.totalCount ?? 0;
+        }
+        catch (error) {
+            selectedLeadListChecked = true;
+            selectedLeadListAccessible = false;
+            warnings.push(`Selected source list is inaccessible or deleted. Remediation: re-select or recreate the lead list before resuming. Detail: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    else if (campaign.selectedLeadListId) {
+        selectedLeadListChecked =
+            campaign.selectedLeadListId === campaign.workflowTableId;
+        selectedLeadListAccessible = null;
+    }
     if (includeTableCheck && campaign.workflowTableId) {
         logNavigationDebug("state.table_check.start", {
             campaignId: input.campaignId,
@@ -351,6 +552,7 @@ export async function getCampaignNavigationState(input) {
                 page: 1,
             });
             tableChecked = true;
+            workflowTableAccessible = true;
             tableRowCount = rows.pagination?.totalCount ?? 0;
             hasWorkflowRows = tableRowCount > 0;
             logNavigationDebug("state.table_check.success", {
@@ -361,7 +563,11 @@ export async function getCampaignNavigationState(input) {
             }, input.campaignId);
         }
         catch (error) {
-            warnings.push(`Failed to check workflow table rows: ${error instanceof Error ? error.message : String(error)}`);
+            tableChecked = true;
+            workflowTableAccessible = false;
+            tableRowCount = null;
+            hasWorkflowRows = null;
+            warnings.push(`Workflow table is inaccessible or deleted. Remediation: re-import confirmed leads before resuming. Detail: ${error instanceof Error ? error.message : String(error)}`);
             logNavigationDebug("state.table_check.error", {
                 campaignId: input.campaignId,
                 workflowTableId: campaign.workflowTableId,
@@ -374,6 +580,10 @@ export async function getCampaignNavigationState(input) {
         tableChecked,
         rowCount: tableRowCount,
         hasWorkflowRows,
+        selectedLeadListChecked,
+        selectedLeadListAccessible,
+        selectedLeadListRowCount,
+        workflowTableAccessible,
         initialWarnings: warnings,
     });
     logNavigationDebug("state.complete", {

package/dist/tools/prompts.js

@@ -283,7 +283,7 @@ export function getPostFindLeadsScoutRegistry() {
         joinGate: {
             afterAllComplete: true,
             requiredArtifacts: ["lead-filter.md", "message-validation.md"],
-            show: ["lead_filter_summary", "sample_message"],
+            show: ["readable_filters_with_reasons", "sample_message_for_approval"],
             nextStage: "message-review",
         },
         usage: {

package/dist/tools/provider-preflight.js

@@ -4,9 +4,8 @@ function scopedKey(provider, campaignOfferId) {
 }
 function resolveLoadedState(provider, campaignOfferId) {
     if (campaignOfferId) {
-        const campaignScoped = providerPromptLoadedState.get(scopedKey(provider, campaignOfferId));
-        if (campaignScoped)
-            return campaignScoped;
+        return (providerPromptLoadedState.get(scopedKey(provider, campaignOfferId)) ??
+            null);
     }
     const providerScoped = providerPromptLoadedState.get(scopedKey(provider));
     return providerScoped ?? null;