@sellable/mcp 0.1.188 → 0.1.190

package/dist/tools/campaign-processing.js

@@ -0,0 +1,304 @@
+import { getApi } from "../api.js";
+import { resolveWaitTimeout } from "./readiness.js";
+const DEFAULT_TIMEOUT_MS = 90000;
+const DEFAULT_INTERVAL_MS = 2000;
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+function stableHash(value) {
+    const text = JSON.stringify(value, Object.keys(value).sort());
+    let hash = 2166136261;
+    for (let index = 0; index < text.length; index += 1) {
+        hash ^= text.charCodeAt(index);
+        hash = Math.imul(hash, 16777619);
+    }
+    return (hash >>> 0).toString(16).padStart(8, "0");
+}
+async function postCampaignProcessing(body) {
+    const api = getApi();
+    return api.post("/api/v3/mcp/campaign-processing", body);
+}
+async function resolveSchema(input) {
+    return postCampaignProcessing({
+        action: "schema",
+        campaignId: input.campaignId,
+        tableId: input.tableId,
+    });
+}
+export const campaignProcessingToolDefinitions = [
+    {
+        name: "get_campaign_table_schema",
+        description: "Return compact semantic campaign-table schema: column roles, row count, review-batch metadata, and current approved brief hash. Use for debugging or recovery, not normal queueing.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                campaignId: { type: "string" },
+                tableId: { type: "string" },
+            },
+            additionalProperties: false,
+        },
+    },
+    {
+        name: "select_campaign_cells",
+        description: "Dry-run semantic campaign-cell selection. Returns compact counts and a tiny sample, never bulky row data. Use before queue_campaign_cells only when debugging or explaining a recovery action.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                campaignId: { type: "string" },
+                tableId: { type: "string" },
+                columnRole: {
+                    type: "string",
+                    enum: [
+                        "enrich",
+                        "passesRubric",
+                        "icpScore",
+                        "generateMessage",
+                        "approved",
+                    ],
+                },
+                rowSelector: {
+                    type: "object",
+                    properties: {
+                        type: {
+                            type: "string",
+                            enum: [
+                                "reviewBatch",
+                                "rowIds",
+                                "passedRows",
+                                "needsGeneratedMessage",
+                                "staleGeneratedMessages",
+                            ],
+                        },
+                        basisHash: { type: "string" },
+                        rowIds: { type: "array", items: { type: "string" } },
+                        limit: { type: "number" },
+                    },
+                    required: ["type"],
+                    additionalProperties: false,
+                },
+                limit: { type: "number" },
+            },
+            required: ["columnRole", "rowSelector"],
+            additionalProperties: false,
+        },
+    },
+    {
+        name: "queue_campaign_cells",
+        description: "Resolve and queue campaign cells by semantic role and row selector. Normal create-campaign tail should use this instead of fetching rows only to discover cell IDs. Use forceRerun:true for message-template revisions.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                campaignId: { type: "string" },
+                tableId: { type: "string" },
+                columnRole: {
+                    type: "string",
+                    enum: ["enrich", "generateMessage", "approved"],
+                },
+                rowSelector: {
+                    type: "object",
+                    properties: {
+                        type: {
+                            type: "string",
+                            enum: [
+                                "reviewBatch",
+                                "rowIds",
+                                "passedRows",
+                                "needsGeneratedMessage",
+                                "staleGeneratedMessages",
+                            ],
+                        },
+                        basisHash: { type: "string" },
+                        rowIds: { type: "array", items: { type: "string" } },
+                        limit: { type: "number" },
+                    },
+                    required: ["type"],
+                    additionalProperties: false,
+                },
+                forceRerun: { type: "boolean" },
+                limit: { type: "number" },
+                reason: { type: "string" },
+            },
+            required: ["columnRole", "rowSelector"],
+            additionalProperties: false,
+        },
+    },
+    {
+        name: "wait_for_campaign_processing",
+        description: "Stats-only campaign processing wait. Use for fit/message readiness instead of wait_for_rubric_results when waiting on campaign-table processing. Generated messages are counted separately from rubric passes; current template revision is enforced through messageDraftBasis.approvedBriefHash.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                campaignId: { type: "string" },
+                tableId: { type: "string" },
+                minPassedCount: { type: "number" },
+                minGeneratedMessages: { type: "number" },
+                templateRevision: {
+                    type: "string",
+                    description: '"current" (default when minGeneratedMessages is set) or an explicit current approved brief hash.',
+                },
+                timeoutMs: { type: "number" },
+                intervalMs: { type: "number" },
+            },
+            additionalProperties: false,
+        },
+    },
+    {
+        name: "revise_message_template_and_rerun",
+        description: "Update the approved message template in the campaign brief, mark prior generated messages stale, reset unsent approvals, and force-rerun Generate Message cells. Does not directly overwrite row message cells.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                campaignId: { type: "string" },
+                tableId: { type: "string" },
+                templateMarkdown: { type: "string" },
+                approvedMessageTemplate: { type: "string" },
+                rowSelector: {
+                    type: "object",
+                    properties: {
+                        type: {
+                            type: "string",
+                            enum: [
+                                "passedRows",
+                                "needsGeneratedMessage",
+                                "staleGeneratedMessages",
+                                "rowIds",
+                            ],
+                        },
+                        rowIds: { type: "array", items: { type: "string" } },
+                        limit: { type: "number" },
+                    },
+                    required: ["type"],
+                    additionalProperties: false,
+                },
+                limit: { type: "number" },
+            },
+            required: ["campaignId"],
+            additionalProperties: false,
+        },
+    },
+];
+export async function getCampaignTableSchema(input) {
+    return resolveSchema(input);
+}
+export async function selectCampaignCells(input) {
+    return postCampaignProcessing({
+        action: "select",
+        ...input,
+    });
+}
+export async function queueCampaignCells(input) {
+    return postCampaignProcessing({
+        action: "queue",
+        ...input,
+    });
+}
+export async function reviseMessageTemplateAndRerun(input) {
+    return postCampaignProcessing({
+        action: "reviseTemplateAndRerun",
+        ...input,
+    });
+}
+export async function waitForCampaignProcessing(input) {
+    const api = getApi();
+    const schema = await resolveSchema(input);
+    const { effectiveTimeoutMs, guardApplied, requestedTimeoutMs } = resolveWaitTimeout(input.timeoutMs ?? DEFAULT_TIMEOUT_MS);
+    const intervalMs = Math.max(500, input.intervalMs ?? DEFAULT_INTERVAL_MS);
+    const minPassedCount = typeof input.minPassedCount === "number" &&
+        Number.isFinite(input.minPassedCount)
+        ? Math.max(1, Math.floor(input.minPassedCount))
+        : null;
+    const minGeneratedMessages = typeof input.minGeneratedMessages === "number" &&
+        Number.isFinite(input.minGeneratedMessages)
+        ? Math.max(1, Math.floor(input.minGeneratedMessages))
+        : null;
+    const templateRevision = input.templateRevision ?? (minGeneratedMessages !== null ? "current" : null);
+    const pollKey = stableHash({
+        tableId: schema.tableId,
+        minPassedCount,
+        minGeneratedMessages,
+        templateRevision,
+    });
+    const start = Date.now();
+    let attempts = 0;
+    let lastStats = null;
+    while (Date.now() - start <= effectiveTimeoutMs) {
+        attempts += 1;
+        const stats = await api.get(`/api/v3/workflow-tables/${schema.tableId}/stats`);
+        lastStats = stats;
+        const currentRevisionHash = stats.currentTemplateRevisionHash ?? null;
+        if (templateRevision &&
+            templateRevision !== "current" &&
+            currentRevisionHash &&
+            templateRevision !== currentRevisionHash) {
+            return {
+                ready: false,
+                reason: "template_revision_mismatch",
+                attempts,
+                elapsedMs: Date.now() - start,
+                tableId: schema.tableId,
+                pollKey,
+                requestedTemplateRevision: templateRevision,
+                currentTemplateRevisionHash: currentRevisionHash,
+                guidance: "The requested templateRevision is not current. Re-read campaign state or wait using templateRevision:'current'.",
+                stats,
+            };
+        }
+        const passed = stats.passRate?.passed ?? 0;
+        const generated = templateRevision === "current" || templateRevision !== null
+            ? (stats.currentRevisionGeneratedMessagesCount ?? 0)
+            : (stats.generatedMessagesCount ?? stats.messagesCount ?? 0);
+        const passFloorMet = minPassedCount === null || passed >= minPassedCount;
+        const generatedFloorMet = minGeneratedMessages === null || generated >= minGeneratedMessages;
+        if (passFloorMet && generatedFloorMet) {
+            return {
+                ready: true,
+                attempts,
+                elapsedMs: Date.now() - start,
+                tableId: schema.tableId,
+                pollKey,
+                floors: {
+                    minPassedCount,
+                    minGeneratedMessages,
+                    templateRevision,
+                },
+                result: {
+                    passedCount: passed,
+                    generatedMessagesCount: stats.generatedMessagesCount ?? stats.messagesCount ?? 0,
+                    currentRevisionGeneratedMessagesCount: stats.currentRevisionGeneratedMessagesCount ?? 0,
+                    staleGeneratedMessagesCount: stats.staleGeneratedMessagesCount ?? 0,
+                    generatedWithoutPassCount: stats.generatedWithoutPassCount ?? 0,
+                    currentTemplateRevisionHash: currentRevisionHash,
+                },
+                stats,
+            };
+        }
+        await sleep(intervalMs);
+    }
+    const passed = lastStats?.passRate?.passed ?? 0;
+    return {
+        ready: false,
+        reason: guardApplied ? "tool_timeout_guard" : "timeout",
+        attempts,
+        elapsedMs: Date.now() - start,
+        tableId: schema.tableId,
+        pollKey,
+        warning: guardApplied
+            ? `Stopped after ${effectiveTimeoutMs}ms to avoid host tool timeout (requested ${requestedTimeoutMs}ms).`
+            : undefined,
+        partialResult: {
+            passedCount: passed,
+            generatedMessagesCount: lastStats?.generatedMessagesCount ?? lastStats?.messagesCount ?? 0,
+            currentRevisionGeneratedMessagesCount: lastStats?.currentRevisionGeneratedMessagesCount ?? 0,
+            staleGeneratedMessagesCount: lastStats?.staleGeneratedMessagesCount ?? 0,
+            generatedWithoutPassCount: lastStats?.generatedWithoutPassCount ?? 0,
+            currentTemplateRevisionHash: lastStats?.currentTemplateRevisionHash ??
+                schema.currentApprovedBriefHash,
+            passFloorMet: minPassedCount === null || passed >= minPassedCount,
+            generatedFloorMet: minGeneratedMessages === null ||
+                (lastStats?.currentRevisionGeneratedMessagesCount ?? 0) >=
+                    minGeneratedMessages,
+        },
+        guidance: "Do not repoll with identical arguments after this timeout. Use the partial diagnostics to revise filters/messages, queue missing work, or surface the blocked sample state.",
+        stats: lastStats,
+    };
+}

package/dist/tools/leads.d.ts

@@ -146,6 +146,7 @@ export type ConfirmLeadListInput = {
     keepInSync?: boolean;
     jobId?: string;
     reviewBatchLimit?: number;
+    includeRawImportResult?: boolean;
     allowPartialSourceList?: boolean;
     /**
      * Deprecated alias for reviewBatchLimit. Confirming a lead list now copies the
@@ -246,6 +247,7 @@ export declare const leadToolDefinitions: ({
             jobId?: undefined;
             reviewBatchLimit?: undefined;
             allowPartialSourceList?: undefined;
+            includeRawImportResult?: undefined;
             selections?: undefined;
             selectionMode?: undefined;
         };
@@ -423,6 +425,7 @@ export declare const leadToolDefinitions: ({
             jobId?: undefined;
             reviewBatchLimit?: undefined;
             allowPartialSourceList?: undefined;
+            includeRawImportResult?: undefined;
             selections?: undefined;
             selectionMode?: undefined;
         };
@@ -499,6 +502,7 @@ export declare const leadToolDefinitions: ({
             jobId?: undefined;
             reviewBatchLimit?: undefined;
             allowPartialSourceList?: undefined;
+            includeRawImportResult?: undefined;
             selections?: undefined;
             selectionMode?: undefined;
         };
@@ -647,6 +651,7 @@ export declare const leadToolDefinitions: ({
             jobId?: undefined;
             reviewBatchLimit?: undefined;
             allowPartialSourceList?: undefined;
+            includeRawImportResult?: undefined;
             selections?: undefined;
             selectionMode?: undefined;
         };
@@ -737,6 +742,7 @@ export declare const leadToolDefinitions: ({
             jobId?: undefined;
             reviewBatchLimit?: undefined;
             allowPartialSourceList?: undefined;
+            includeRawImportResult?: undefined;
             selections?: undefined;
             selectionMode?: undefined;
         };
@@ -836,6 +842,7 @@ export declare const leadToolDefinitions: ({
             jobId?: undefined;
             reviewBatchLimit?: undefined;
             allowPartialSourceList?: undefined;
+            includeRawImportResult?: undefined;
             selections?: undefined;
             selectionMode?: undefined;
         };
@@ -917,6 +924,7 @@ export declare const leadToolDefinitions: ({
             jobId?: undefined;
             reviewBatchLimit?: undefined;
             allowPartialSourceList?: undefined;
+            includeRawImportResult?: undefined;
             selections?: undefined;
             selectionMode?: undefined;
         };
@@ -1537,6 +1545,7 @@ export declare const leadToolDefinitions: ({
             jobId?: undefined;
             reviewBatchLimit?: undefined;
             allowPartialSourceList?: undefined;
+            includeRawImportResult?: undefined;
             selections?: undefined;
             selectionMode?: undefined;
         };
@@ -1670,6 +1679,7 @@ export declare const leadToolDefinitions: ({
             jobId?: undefined;
             reviewBatchLimit?: undefined;
             allowPartialSourceList?: undefined;
+            includeRawImportResult?: undefined;
             selections?: undefined;
             selectionMode?: undefined;
         };
@@ -1791,6 +1801,7 @@ export declare const leadToolDefinitions: ({
             jobId?: undefined;
             reviewBatchLimit?: undefined;
             allowPartialSourceList?: undefined;
+            includeRawImportResult?: undefined;
             selections?: undefined;
             selectionMode?: undefined;
         };
@@ -1870,6 +1881,7 @@ export declare const leadToolDefinitions: ({
             jobId?: undefined;
             reviewBatchLimit?: undefined;
             allowPartialSourceList?: undefined;
+            includeRawImportResult?: undefined;
             selections?: undefined;
             selectionMode?: undefined;
         };
@@ -1921,6 +1933,10 @@ export declare const leadToolDefinitions: ({
                 type: string;
                 description: string;
             };
+            includeRawImportResult: {
+                type: string;
+                description: string;
+            };
             provider?: undefined;
             searchMode?: undefined;
             organization_num_employees_ranges?: undefined;
@@ -2083,6 +2099,7 @@ export declare const leadToolDefinitions: ({
             jobId?: undefined;
             reviewBatchLimit?: undefined;
             allowPartialSourceList?: undefined;
+            includeRawImportResult?: undefined;
         };
         required: string[];
     };
@@ -2164,6 +2181,7 @@ export declare const leadToolDefinitions: ({
             jobId?: undefined;
             reviewBatchLimit?: undefined;
             allowPartialSourceList?: undefined;
+            includeRawImportResult?: undefined;
             selections?: undefined;
             selectionMode?: undefined;
         };
@@ -2608,25 +2626,13 @@ export declare function cancelLeadImport(input: CancelLeadImportInput): Promise<
     previousStatus?: undefined;
 }>;
 export declare function confirmLeadList(input: ConfirmLeadListInput): Promise<{
-    sourceLeadListId: string;
-    campaignTableId: string | null;
-    importResult: {
-        workflowTableId?: string;
-        campaignTableId?: string;
-        campaignTableName?: string;
-        leadsImported?: number;
-        leadsSkipped?: number;
-        rowIds?: string[];
-        requestedTargetLeadCount?: number;
-        sourceRowLimit?: number;
-        async?: boolean;
-        hybrid?: boolean;
-        campaignTableReady?: boolean;
-        importStatus?: string | null;
-        remainingRowCount?: number | null;
-        rowCount?: number | null;
-        sourceRowCount?: number | null;
-        clonedSourceRowCount?: number | null;
+    reviewBatch: {
+        tableId: string | null;
+        rowCount: number;
+        rowIds: string[];
+        enrichCellIds: string[];
+        basisHash: string | null;
+        recordedAt: string | null;
     };
     messageDraftBuilder: {
         firstAllowedStartPoint: string;
@@ -2637,6 +2643,7 @@ export declare function confirmLeadList(input: ConfirmLeadListInput): Promise<{
             selectedLeadListId: string;
             workflowTableId: string | null;
             reviewBatchRowIds: string[];
+            reviewBatchBasisHash: string | null;
             reviewBatchRowCount: number;
             copiedCampaignRowCount: number;
         };
@@ -2665,6 +2672,43 @@ export declare function confirmLeadList(input: ConfirmLeadListInput): Promise<{
         warning: string | null;
     };
     message: string;
+    importResult?: {
+        workflowTableId?: string;
+        campaignTableId?: string;
+        campaignTableName?: string;
+        leadsImported?: number;
+        leadsSkipped?: number;
+        rowIds?: string[];
+        requestedTargetLeadCount?: number;
+        sourceRowLimit?: number;
+        async?: boolean;
+        hybrid?: boolean;
+        campaignTableReady?: boolean;
+        importStatus?: string | null;
+        remainingRowCount?: number | null;
+        rowCount?: number | null;
+        sourceRowCount?: number | null;
+        clonedSourceRowCount?: number | null;
+    } | undefined;
+    sourceLeadListId: string;
+    campaignTableId: string | null;
+    importSummary: {
+        workflowTableId: string | null;
+        campaignTableId: string | null;
+        campaignTableName: string | null;
+        leadsImported: number | null;
+        leadsSkipped: number | null;
+        rowCount: number;
+        requestedTargetLeadCount: number | null;
+        sourceRowLimit: number | null;
+        async: boolean;
+        hybrid: boolean;
+        campaignTableReady: true;
+        importStatus: string | null;
+        remainingRowCount: number;
+        sourceRowCount: number | null;
+        clonedSourceRowCount: number | null;
+    };
 }>;
 export declare function getProviderPrompt(input: GetProviderPromptInput): string;
 export declare function selectPromisingPosts(input: SelectPromisingPostsInput): Promise<{

package/dist/tools/leads.js

@@ -529,7 +529,7 @@ function buildSourceImportWatchNarration({ provider, selectedPostCount, estimate
                 : "Apollo";
     const sourceDetail = provider === "signal-discovery"
         ? `${selectedPostCount ?? "selected"} approved post${selectedPostCount === 1 ? "" : "s"}${typeof estimatedEngagers === "number"
-            ? ` with about ${estimatedEngagers.toLocaleString("en-US")} people to check`
+            ? ` with up to ${estimatedEngagers.toLocaleString("en-US")} people to check before top-level scrape adjustment`
             : ""}`
         : `the approved ${providerLabel} source`;
     const targetDetail = typeof targetLeadCount === "number"
@@ -806,8 +806,8 @@ function buildSignalDiscoverySourceRecommendation({ selectedPosts, targetEngager
         ? "the approved buyer-search target"
         : `the ${Math.round(defaultFitRate * 100)}% starting estimate`;
     const selectedPoolCopy = recommendedCount < selectedCount
-        ? `**Posts considered:** ${selectedCount.toLocaleString("en-US")} selected posts with ${formatApproxInteger(totalVisibleEngagement)} public reactions/comments<br>\n**Recommended first set:** ${recommendedCount.toLocaleString("en-US")} post${recommendedCount === 1 ? "" : "s"} with ${formatApproxInteger(recommendedVisibleEngagement)} public reactions/comments and up to ${formatApproxInteger(scrapePlan.estimatedEngagers)} people to check<br>`
-        : `**Public activity in the selected posts:** ${formatApproxInteger(totalVisibleEngagement)} reactions/comments<br>\n**People we can check from this set:** up to ${formatApproxInteger(scrapePlan.estimatedEngagers)}<br>`;
+        ? `**Posts considered:** ${selectedCount.toLocaleString("en-US")} selected posts with ${formatApproxInteger(totalVisibleEngagement)} visible public reactions/comments<br>\n**Recommended first set:** ${recommendedCount.toLocaleString("en-US")} post${recommendedCount === 1 ? "" : "s"} with ${formatApproxInteger(recommendedVisibleEngagement)} visible public reactions/comments and up to ${formatApproxInteger(scrapePlan.estimatedEngagers)} people to check before top-level comment and dedupe adjustment<br>`
+        : `**Visible public activity in the selected posts:** ${formatApproxInteger(totalVisibleEngagement)} reactions/comments<br>\n**People we can check from this set:** up to ${formatApproxInteger(scrapePlan.estimatedEngagers)} before top-level comment and dedupe adjustment<br>`;
     const message = `## Source Recommendation
 
 Start with LinkedIn posts.
@@ -821,7 +821,7 @@ I found ${recommendedCount.toLocaleString("en-US")} recommended LinkedIn post${r
 
 ### Recommended posts
 
-| Post | Why this post | Public activity | People we can check |
+| Post | Why this post | Visible public activity | People we can check |
 |---|---|---:|---:|
 ${tableRows || "| Recommended posts | Campaign-matched public activity | - | - |"}
 
@@ -1518,6 +1518,10 @@ export const leadToolDefinitions = [
                     type: "boolean",
                     description: "Set true after user approval when interaction mode requires confirmation for confirm/import.",
                 },
+                includeRawImportResult: {
+                    type: "boolean",
+                    description: "Debug only. When true, include the raw import response; default compact output omits large row-id payloads.",
+                },
             },
             required: ["campaignOfferId"],
         },
@@ -2579,7 +2583,7 @@ export async function importLeads(input) {
             maxPostsToScrape: normalizePositiveInteger(maxPostsToScrape) ?? null,
             limitedSelectedPosts: importSelection.limited,
             targetLeadCount: cappedTargetLeadCount ?? null,
-            message: `Started scraping ${postsToScrape.length} posts (~${result.estimatedEngagers} people to check). Leads will appear as scraping completes.${importSelection.limited
+            message: `Started scraping ${postsToScrape.length} posts (up to ~${result.estimatedEngagers} people to check before top-level scrape adjustment). Leads will appear as scraping completes.${importSelection.limited
                 ? ` Limited from ${uniqueSelectedPosts.length} selected posts by the approved source-capacity scrape plan.`
                 : ""} The watched campaign has been moved to confirm-lead-list with import progress copy. Keep calling wait_for_lead_list_ready until it reports ready, failed, or cancelled before confirm_lead_list; only confirm a partial list with allowPartialSourceList after the user explicitly asks to keep going early. Do not call update_campaign to fix that step.`,
         };
@@ -2741,7 +2745,7 @@ export async function cancelLeadImport(input) {
 }
 export async function confirmLeadList(input) {
     const api = getApi();
-    const { campaignOfferId, currentStep, confirmed, sourceLeadListId, campaignName, keepInSync, jobId, reviewBatchLimit, allowPartialSourceList, targetLeadCount, } = input;
+    const { campaignOfferId, currentStep, confirmed, sourceLeadListId, campaignName, keepInSync, jobId, reviewBatchLimit, includeRawImportResult, allowPartialSourceList, targetLeadCount, } = input;
     assertInteractionApproval({
         campaignId: campaignOfferId,
         action: "confirm-lead-list",
@@ -2988,6 +2992,50 @@ export async function confirmLeadList(input) {
             reviewSampleRows = [];
         }
     }
+    const sampleReviewRowIds = reviewSampleRows
+        .map((row) => row.id)
+        .filter((rowId) => typeof rowId === "string");
+    const reviewBatchRowIds = importedRowIds.length > 0
+        ? importedRowIds.slice(0, keptReviewRowCount)
+        : sampleReviewRowIds.slice(0, keptReviewRowCount);
+    const reviewBatchEnrichCellIds = reviewSampleRows
+        .map((row) => row.enrichCellId)
+        .filter((cellId) => typeof cellId === "string");
+    let recordedReviewBatch = null;
+    if (campaignTableId && reviewBatchRowIds.length > 0) {
+        const recordResult = await api.post("/api/v3/mcp/campaign-processing", {
+            action: "recordReviewBatch",
+            tableId: campaignTableId,
+            rowIds: reviewBatchRowIds,
+            enrichCellIds: reviewBatchEnrichCellIds,
+        });
+        recordedReviewBatch = recordResult.reviewBatch ?? null;
+    }
+    const compactReviewBatch = {
+        tableId: campaignTableId ?? null,
+        rowCount: recordedReviewBatch?.rowCount ?? reviewBatchRowIds.length,
+        rowIds: recordedReviewBatch?.rowIds ?? reviewBatchRowIds,
+        enrichCellIds: recordedReviewBatch?.enrichCellIds ?? reviewBatchEnrichCellIds,
+        basisHash: recordedReviewBatch?.basisHash ?? null,
+        recordedAt: recordedReviewBatch?.recordedAt ?? null,
+    };
+    const importSummary = {
+        workflowTableId: campaignTableId ?? null,
+        campaignTableId: campaignTableId ?? null,
+        campaignTableName: importResult.campaignTableName ?? null,
+        leadsImported: importResult.leadsImported ?? null,
+        leadsSkipped: importResult.leadsSkipped ?? null,
+        rowCount: importResult.rowCount ?? importedRowCount,
+        requestedTargetLeadCount: importResult.requestedTargetLeadCount ?? null,
+        sourceRowLimit: importResult.sourceRowLimit ?? null,
+        async: importResult.async ?? false,
+        hybrid: importResult.hybrid ?? false,
+        campaignTableReady,
+        importStatus: importResult.importStatus ?? null,
+        remainingRowCount,
+        sourceRowCount: importResult.sourceRowCount ?? null,
+        clonedSourceRowCount: importResult.clonedSourceRowCount ?? null,
+    };
     // Persist currentStep if the caller asked for it. Do NOT touch
     // selectedLeadListId here: the campaign table id is already saved to
     // CampaignOffer.workflowTableId by /api/v3/campaign-builder/import-leads,
@@ -3014,7 +3062,9 @@ export async function confirmLeadList(input) {
     return {
         sourceLeadListId: resolvedLeadListId,
         campaignTableId: campaignTableId ?? null,
-        importResult,
+        importSummary,
+        ...(includeRawImportResult ? { importResult } : {}),
+        reviewBatch: compactReviewBatch,
         messageDraftBuilder: {
             firstAllowedStartPoint: "confirm_lead_list",
             startAllowed: true,
@@ -3023,7 +3073,8 @@ export async function confirmLeadList(input) {
                 campaignOfferId,
                 selectedLeadListId: resolvedLeadListId,
                 workflowTableId: campaignTableId ?? null,
-                reviewBatchRowIds: importedRowIds.slice(0, keptReviewRowCount),
+                reviewBatchRowIds,
+                reviewBatchBasisHash: compactReviewBatch.basisHash,
                 reviewBatchRowCount: keptReviewRowCount,
                 copiedCampaignRowCount: importedRowCount,
             },

package/dist/tools/prompts.js

@@ -315,7 +315,7 @@ export function getPostFindLeadsScoutRegistry() {
                 "basis.workflowTableId",
                 "basis.reviewSampleRowHash or basis.reviewSampleRowIds",
             ],
-            promptRequired: 'get_subskill_prompt({ subskillName: "generate-messages", offset, limit }) until hasMore=false',
+            promptRequired: 'get_subskill_prompt({ subskillName: "generate-messages-compact" }); load generate-messages-compact/references/examples-critique-revision.md only for critique, revision, or close-call examples',
             basisFields: [
                 "campaign revision or updatedAt",
                 "brief hash",
@@ -342,7 +342,7 @@ export function getPostFindLeadsScoutRegistry() {
         usage: {
             codex: "After confirm_lead_list copies source rows and the initial campaign-table execution slice exists, ask the filter-choice question immediately. Do not spawn returned post-lead scout names before that question. Once the user answers, spawn Message Draft Builder from the same campaign/table basis. If the user chooses filters, also spawn Lead Fit Builder, move to Filter Rules, save rubrics, ask for filter approval, then keep the browser on Filter Leads and show `Filters saved + waiting for message approval` while the message recommendation is reviewed. If filters are skipped, move to Messages/message review.",
             claude: "After confirm_lead_list copies source rows and the initial campaign-table execution slice exists, ask the filter-choice question immediately. Do not invoke returned post-lead Task/Agent names before that question. Once the user answers, invoke Message Draft Builder from the same campaign/table basis. If the user chooses filters, also invoke Lead Fit Builder, move to Filter Rules, save rubrics, ask for filter approval, then keep the browser on Filter Leads and show `Filters saved + waiting for message approval` while the message recommendation is reviewed. If filters are skipped, move to Messages/message review.",
-            parentThreadRule: 'Named agents are optional acceleration, but message drafting is not optional. If post-find-leads-message-scout is available, run it as the background Message Draft Builder after the filter-choice answer. If it is absent, do not customer-surface install status; the main thread must execute the same message branch from CampaignOffer state, selected source state, workflowTableId, and initial campaign-table execution slice rows. Local markdown/json files are not normal-path inputs. The filter-choice question is the first post-import user gate; do not load post-lead registries, filter references, or the full generate-messages prompt before it. Message drafting starts after the filter-choice answer, must load get_subskill_prompt({ subskillName: "generate-messages", offset, limit }) until hasMore=false, must read live campaign table state through scoped MCP/product tools, and must reject mismatched selectedLeadListId/workflowTableId/campaign/workspace input. On the filter path, keep the browser on Filter Rules after save_rubrics so the user can approve the saved criteria; only then move to Filter Leads, show `Filters saved + waiting for message approval`, and wait there for message approval. Enrichment, filtering, Generate Message cells, sender setup, sequence attach, and launch wait for template approval on the Use Template path. On the skip path, move to Messages/message review and wait for message approval before enrichment or Settings. Do not render message review from checklist or shortcut instructions; message review requires a messageDraftRecommendation whose basis proves the full generate-messages prompt ran for the current campaign/table execution slice. Do not automatically rerun Message Draft Builder after filters/enrichment finish; show the initial draft by default and offer an enriched rewrite only with explicit user opt-in.',
+            parentThreadRule: 'Named agents are optional acceleration, but message drafting is not optional. If post-find-leads-message-scout is available, run it as the background Message Draft Builder after the filter-choice answer. If it is absent, do not customer-surface install status; the main thread must execute the same message branch from CampaignOffer state, selected source state, workflowTableId, and initial campaign-table execution slice rows. Local markdown/json files are not normal-path inputs. The filter-choice question is the first post-import user gate; do not load post-lead registries, filter references, or the full legacy generate-messages prompt before it. Message drafting starts after the filter-choice answer, must load get_subskill_prompt({ subskillName: "generate-messages-compact" }), must read live campaign table state through scoped MCP/product tools, and must reject mismatched selectedLeadListId/workflowTableId/campaign/workspace input. Load generate-messages-compact/references/examples-critique-revision.md only for critique, revision, or close-call examples. On the filter path, keep the browser on Filter Rules after save_rubrics so the user can approve the saved criteria; only then move to Filter Leads, show `Filters saved + waiting for message approval`, and wait there for message approval. Enrichment, filtering, Generate Message cells, sender setup, sequence attach, and launch wait for template approval on the Use Template path. On the skip path, move to Messages/message review and wait for message approval before enrichment or Settings. Do not render message review from checklist or shortcut instructions; message review requires a messageDraftRecommendation whose basis proves the generate-messages-compact prompt ran for the current campaign/table execution slice. Do not automatically rerun Message Draft Builder after filters/enrichment finish; show the initial draft by default and offer an enriched rewrite only with explicit user opt-in.',
         },
     };
 }