@sellable/mcp 0.1.191 → 0.1.193

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;
         };
@@ -2376,6 +2394,8 @@ export declare function searchSignals(input: SignalSearchInput): Promise<{
         id: string;
         url: string | undefined;
         matchedKeyword: string | null;
+        searchType: "company" | "keyword" | "profile" | "post" | null;
+        displayLabel: string | null;
         authorName: string;
         authorHeadline: string;
         authorProfileUrl: string;
@@ -2393,6 +2413,9 @@ export declare function searchSignals(input: SignalSearchInput): Promise<{
     }[];
     keywordResults: {
         keyword: string;
+        searchType: "company" | "keyword" | "profile" | "post";
+        displayLabel: string;
+        tabId: string | null;
         postCount: number;
         avgEngagement: number | null;
         hasMore: boolean;
@@ -2608,25 +2631,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 +2648,7 @@ export declare function confirmLeadList(input: ConfirmLeadListInput): Promise<{
             selectedLeadListId: string;
             workflowTableId: string | null;
             reviewBatchRowIds: string[];
+            reviewBatchBasisHash: string | null;
             reviewBatchRowCount: number;
             copiedCampaignRowCount: number;
         };
@@ -2665,6 +2677,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

@@ -471,6 +471,8 @@ function summarizeSignalPost(post) {
         id: post.id,
         url: post.url,
         matchedKeyword: post.matchedKeyword ?? null,
+        searchType: post.searchType ?? null,
+        displayLabel: post.displayLabel ?? null,
         authorName: post.author?.name ?? "",
         authorHeadline: post.author?.headline ?? "",
         authorProfileUrl: post.author?.profileUrl ?? "",
@@ -500,6 +502,9 @@ function summarizeSignalSearchResponse(response) {
         .map(summarizeSignalPost);
     const keywordResults = (response.keywordResults ?? []).map((kw) => ({
         keyword: kw.keyword,
+        searchType: kw.searchType ?? "keyword",
+        displayLabel: kw.displayLabel ?? kw.keyword,
+        tabId: kw.tabId ?? null,
         postCount: kw.postCount,
         avgEngagement: kw.avgEngagement ?? null,
         hasMore: kw.hasMore ?? false,
@@ -529,7 +534,7 @@ function buildSourceImportWatchNarration({ provider, selectedPostCount, estimate
                 : "Apollo";
     const sourceDetail = provider === "signal-discovery"
         ? `${selectedPostCount ?? "selected"} approved post${selectedPostCount === 1 ? "" : "s"}${typeof estimatedEngagers === "number"
-            ? ` with up to ${estimatedEngagers.toLocaleString("en-US")} people to check before top-level scrape adjustment`
+            ? ` with about ${estimatedEngagers.toLocaleString("en-US")} people to check`
             : ""}`
         : `the approved ${providerLabel} source`;
     const targetDetail = typeof targetLeadCount === "number"
@@ -806,8 +811,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)} 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>`;
+        ? `**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>`;
     const message = `## Source Recommendation
 
 Start with LinkedIn posts.
@@ -821,7 +826,7 @@ I found ${recommendedCount.toLocaleString("en-US")} recommended LinkedIn post${r
 
 ### Recommended posts
 
-| Post | Why this post | Visible public activity | People we can check |
+| Post | Why this post | Public activity | People we can check |
 |---|---|---:|---:|
 ${tableRows || "| Recommended posts | Campaign-matched public activity | - | - |"}
 
@@ -1518,6 +1523,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 +2588,7 @@ export async function importLeads(input) {
             maxPostsToScrape: normalizePositiveInteger(maxPostsToScrape) ?? null,
             limitedSelectedPosts: importSelection.limited,
             targetLeadCount: cappedTargetLeadCount ?? null,
-            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
+            message: `Started scraping ${postsToScrape.length} posts (up to ~${result.estimatedEngagers} people to check). 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 +2750,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",
@@ -2873,7 +2882,7 @@ export async function confirmLeadList(input) {
                 rowCount: leadListRowCount,
                 status: typeof readiness.status === "string"
                     ? readiness.status
-                    : leadListConfig?.importStatus ?? null,
+                    : (leadListConfig?.importStatus ?? null),
                 targetLeadCount: typeof readiness.targetLeadCount === "number"
                     ? readiness.targetLeadCount
                     : typeof leadListConfig?.targetLeadCount === "number"
@@ -2988,6 +2997,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 +3067,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 +3078,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,
             },