@sellable/mcp 0.1.274 → 0.1.276

package/dist/tools/csv-linkedin.js

@@ -1,5 +1,5 @@
 import { parse } from "csv-parse/sync";
-import { createHmac, randomBytes } from "node:crypto";
+import { createHash, createHmac, randomBytes } from "node:crypto";
 import { readFileSync, statSync } from "node:fs";
 import { basename, dirname, extname, isAbsolute, resolve } from "node:path";
 import { resolveWorkspaceRoot } from "../utils/workspace-root.js";
@@ -49,6 +49,86 @@ const CSV_LINKEDIN_LIMITS = {
     maxRows: MAX_CSV_LINKEDIN_UPLOAD_ROWS,
     maxCarryColumns: MAX_CSV_LINKEDIN_UPLOAD_CARRY_COLUMNS,
 };
+const RESERVED_WORKFLOW_COLUMNS = new Map([
+    "DNC Check",
+    "Enable ICP Filtering",
+    "ICP Score",
+    "ICP Alignment Notes",
+    "Passes Rubric",
+    "Generate Message",
+    "Message",
+    "Subject",
+    "Approved",
+    "Enable Scheduling",
+    "Scheduled",
+    "Scheduled At",
+    "Scheduled For",
+    "Sent",
+    "Sent At",
+    "Send Status",
+    "Delivery Status",
+    "Reply Status",
+    "Connection Status",
+    "Invite Status",
+    "InMail Status",
+    "DM Status",
+    "Status",
+    "Result",
+    "Error",
+    "Last Error",
+    "Generated Message",
+    "Message Draft",
+    "Message Status",
+    "Approval Status",
+    "Queued At",
+    "Processing Status",
+    "Workflow Status",
+    "Cell Status",
+].map((name) => [normalizeReservedWorkflowHeaderKey(name), name]));
+function normalizeReservedWorkflowHeaderKey(value) {
+    return value
+        .trim()
+        .replace(/\s*(?:\(\d+\)|[._-]\d+|\s+\d+)$/u, "")
+        .toLowerCase()
+        .replace(/[\s_.-]+/g, " ")
+        .replace(/[^a-z0-9 ]+/g, "")
+        .trim();
+}
+export function getReservedWorkflowColumnMatch(header) {
+    const key = normalizeReservedWorkflowHeaderKey(header);
+    if (!key) {
+        return null;
+    }
+    const canonicalName = RESERVED_WORKFLOW_COLUMNS.get(key);
+    if (!canonicalName) {
+        return null;
+    }
+    return {
+        canonicalName,
+        reason: "Sellable workflow/output columns are recreated by each campaign table and cannot be imported as lead source fields.",
+    };
+}
+function buildReservedColumnWarning(ignored) {
+    if (ignored.length === 0) {
+        return null;
+    }
+    const names = Array.from(new Set(ignored.map((column) => column.originalHeader)));
+    return `Detected campaign workflow columns and stripped them because Sellable recreates those columns in each campaign table: ${names.join(", ")}.`;
+}
+function hashJson(value) {
+    return createHash("sha256")
+        .update(JSON.stringify(value))
+        .digest("hex");
+}
+function buildContentFingerprint(params) {
+    return {
+        fileSha256: params.fileSha256,
+        sanitizedHeaderSha256: hashJson(params.headers),
+        selectedColumnsSha256: hashJson(params.selectedColumns),
+        ignoredReservedColumnsSha256: hashJson(params.ignoredReservedColumns),
+        rowCount: params.rowCount,
+    };
+}
 function normalizeHeaderKey(value) {
     return value
         .trim()
@@ -61,6 +141,17 @@ function compareStringArrays(left, right) {
     }
     return left.every((value, index) => value === right[index]);
 }
+function compareIgnoredReservedColumns(left, right) {
+    if (left.length !== right.length) {
+        return false;
+    }
+    return left.every((column, index) => {
+        const other = right[index];
+        return (column.originalHeader === other.originalHeader &&
+            column.canonicalName === other.canonicalName &&
+            column.reason === other.reason);
+    });
+}
 function getLimits() {
     return { ...CSV_LINKEDIN_LIMITS };
 }
@@ -100,6 +191,30 @@ function buildRowObjects(headers, dataRows) {
         return out;
     });
 }
+function stripReservedWorkflowColumns(headers, dataRows) {
+    const keepIndexes = [];
+    const ignoredReservedColumns = [];
+    headers.forEach((header, index) => {
+        const match = getReservedWorkflowColumnMatch(header);
+        if (!match) {
+            keepIndexes.push(index);
+            return;
+        }
+        ignoredReservedColumns.push({
+            originalHeader: header,
+            canonicalName: match.canonicalName,
+            reason: match.reason,
+        });
+    });
+    if (ignoredReservedColumns.length === 0) {
+        return { headers, dataRows, ignoredReservedColumns };
+    }
+    return {
+        headers: keepIndexes.map((index) => headers[index]),
+        dataRows: dataRows.map((row) => keepIndexes.map((index) => String(row[index] ?? ""))),
+        ignoredReservedColumns,
+    };
+}
 function resolveHeaderSelection(headers, requested, kind) {
     const trimmed = requested.trim();
     if (!trimmed) {
@@ -516,7 +631,17 @@ export function matchesLinkedinConfirmationToken(token, payload) {
         parsed.fileSizeBytes === payload.fileSizeBytes &&
         parsed.fileMtimeMs === payload.fileMtimeMs &&
         parsed.linkedInColumn === payload.linkedInColumn &&
-        compareStringArrays(parsed.selectedColumns, payload.selectedColumns));
+        compareStringArrays(parsed.selectedColumns, payload.selectedColumns) &&
+        compareIgnoredReservedColumns(parsed.ignoredReservedColumns, payload.ignoredReservedColumns) &&
+        parsed.contentFingerprint.fileSha256 ===
+            payload.contentFingerprint.fileSha256 &&
+        parsed.contentFingerprint.sanitizedHeaderSha256 ===
+            payload.contentFingerprint.sanitizedHeaderSha256 &&
+        parsed.contentFingerprint.selectedColumnsSha256 ===
+            payload.contentFingerprint.selectedColumnsSha256 &&
+        parsed.contentFingerprint.ignoredReservedColumnsSha256 ===
+            payload.contentFingerprint.ignoredReservedColumnsSha256 &&
+        parsed.contentFingerprint.rowCount === payload.contentFingerprint.rowCount);
 }
 export function parseCsvLinkedinFile(input) {
     const resolvedFilePath = resolveCsvLinkedinPath(input.filePath, input.workspaceRoot);
@@ -536,8 +661,9 @@ export function parseCsvLinkedinFile(input) {
         blockingErrors.push(`CSV file exceeds the ${MAX_CSV_LINKEDIN_UPLOAD_BYTES} byte limit.`);
     }
     let rawRows;
+    let content;
     try {
-        const content = readFileSync(resolvedFilePath, "utf8");
+        content = readFileSync(resolvedFilePath, "utf8");
         rawRows = parse(content, {
             bom: true,
             columns: false,
@@ -559,6 +685,9 @@ export function parseCsvLinkedinFile(input) {
             headers: [],
             rows: [],
             totalRows: 0,
+            ignoredReservedColumns: [],
+            reservedColumnWarning: null,
+            fileSha256: "",
             blockingErrors,
             warnings,
         };
@@ -567,6 +696,14 @@ export function parseCsvLinkedinFile(input) {
     const dataRows = rawRows
         .slice(1)
         .map((row) => row.map((value) => String(value ?? "")));
+    const fileSha256 = createHash("sha256").update(content).digest("hex");
+    const stripped = stripReservedWorkflowColumns(headers, dataRows);
+    const sanitizedHeaders = stripped.headers;
+    const sanitizedDataRows = stripped.dataRows;
+    const reservedColumnWarning = buildReservedColumnWarning(stripped.ignoredReservedColumns);
+    if (reservedColumnWarning) {
+        warnings.push(reservedColumnWarning);
+    }
     if (headers.length === 0) {
         blockingErrors.push("CSV file must include at least one header column.");
     }
@@ -574,7 +711,10 @@ export function parseCsvLinkedinFile(input) {
     if (blankHeaderCount > 0) {
         blockingErrors.push("CSV header row contains blank column names.");
     }
-    const duplicateHeaders = findDuplicateHeaders(headers);
+    if (sanitizedHeaders.length === 0 && headers.length > 0) {
+        blockingErrors.push("CSV looks like a campaign workflow export rather than a clean LinkedIn lead list; all usable columns were Sellable workflow/output columns.");
+    }
+    const duplicateHeaders = findDuplicateHeaders(sanitizedHeaders);
     if (duplicateHeaders.length > 0) {
         blockingErrors.push(`CSV header row contains duplicate columns: ${duplicateHeaders.join(", ")}`);
     }
@@ -585,7 +725,9 @@ export function parseCsvLinkedinFile(input) {
     if (dataRows.length > MAX_CSV_LINKEDIN_UPLOAD_ROWS) {
         blockingErrors.push(`CSV contains ${dataRows.length} data rows, which exceeds the ${MAX_CSV_LINKEDIN_UPLOAD_ROWS} row limit.`);
     }
-    const rows = blockingErrors.length > 0 ? [] : buildRowObjects(headers, dataRows);
+    const rows = blockingErrors.length > 0
+        ? []
+        : buildRowObjects(sanitizedHeaders, sanitizedDataRows);
     if (rows.length === 0 && dataRows.length === 0) {
         warnings.push("CSV contains headers but no data rows.");
     }
@@ -594,9 +736,12 @@ export function parseCsvLinkedinFile(input) {
         suggestedLeadListName: buildLeadListNameSuggestion(resolvedFilePath),
         fileSizeBytes: stats.size,
         fileMtimeMs: stats.mtimeMs,
-        headers,
+        headers: sanitizedHeaders,
         rows,
         totalRows: dataRows.length,
+        ignoredReservedColumns: stripped.ignoredReservedColumns,
+        reservedColumnWarning,
+        fileSha256,
         blockingErrors,
         warnings,
     };
@@ -752,8 +897,13 @@ export function buildCsvLinkedinPreview(input) {
             duplicateCount: 0,
             emptyCount: 0,
         };
+    if (!resolvedLinkedInColumn && parsed.ignoredReservedColumns.length > 0) {
+        blockingErrors.push("CSV looks like a campaign workflow export rather than a clean LinkedIn lead list; after stripping Sellable workflow/output columns, no LinkedIn profile URL column was available.");
+    }
     if (resolvedLinkedInColumn && prepared.rows.length === 0) {
-        blockingErrors.push("CSV did not produce any valid LinkedIn profile URLs after validation.");
+        blockingErrors.push(parsed.ignoredReservedColumns.length > 0
+            ? "CSV looks like a campaign workflow export rather than a clean LinkedIn lead list; no valid LinkedIn profile URLs remained after stripping Sellable workflow/output columns."
+            : "CSV did not produce any valid LinkedIn profile URLs after validation.");
     }
     if (prepared.invalidCount > 0) {
         warnings.push(`Skipped ${prepared.invalidCount} invalid LinkedIn URL row(s).`);
@@ -772,6 +922,14 @@ export function buildCsvLinkedinPreview(input) {
             fileMtimeMs: parsed.fileMtimeMs,
             linkedInColumn: resolvedLinkedInColumn,
             selectedColumns,
+            ignoredReservedColumns: parsed.ignoredReservedColumns,
+            contentFingerprint: buildContentFingerprint({
+                fileSha256: parsed.fileSha256,
+                headers,
+                selectedColumns,
+                ignoredReservedColumns: parsed.ignoredReservedColumns,
+                rowCount: parsed.totalRows,
+            }),
         }
         : null;
     return {
@@ -792,6 +950,8 @@ export function buildCsvLinkedinPreview(input) {
             duplicateLinkedInCount: prepared.duplicateCount,
             emptyLinkedInRowCount: prepared.emptyCount,
             duplicatePolicy: "first_wins",
+            ignoredReservedColumns: parsed.ignoredReservedColumns,
+            reservedColumnWarning: parsed.reservedColumnWarning,
             limits: getLimits(),
             warnings,
             blockingErrors,

package/dist/tools/leads.d.ts

@@ -4151,6 +4151,8 @@ export declare function loadCsvLinkedinLeads(input: LoadCsvLinkedinLeadsInput):
     invalidCount: number;
     duplicateCount: number;
     emptyLinkedInRowCount: number;
+    ignoredReservedColumns: import("./csv-linkedin.js").CsvLinkedinIgnoredReservedColumn[];
+    reservedColumnWarning: string | null;
     duplicatePolicy: "first_wins";
     limits: import("./csv-linkedin.js").CsvLinkedinLimits;
     warnings: string[];
@@ -4186,6 +4188,8 @@ export declare function loadCsvLinkedinLeads(input: LoadCsvLinkedinLeadsInput):
     invalidCount?: undefined;
     duplicateCount?: undefined;
     emptyLinkedInRowCount?: undefined;
+    ignoredReservedColumns?: undefined;
+    reservedColumnWarning?: undefined;
     duplicatePolicy?: undefined;
     limits?: undefined;
     warnings?: undefined;
@@ -4225,6 +4229,8 @@ export declare function loadCsvLinkedinLeads(input: LoadCsvLinkedinLeadsInput):
     invalidCount?: undefined;
     duplicateCount?: undefined;
     emptyLinkedInRowCount?: undefined;
+    ignoredReservedColumns?: undefined;
+    reservedColumnWarning?: undefined;
     duplicatePolicy?: undefined;
     limits?: undefined;
     warnings?: undefined;

package/dist/tools/leads.js

@@ -2348,6 +2348,7 @@ function normalizeLinkedinConfirmationPayload(payload) {
     return {
         ...payload,
         selectedColumns: [...payload.selectedColumns],
+        ignoredReservedColumns: [...(payload.ignoredReservedColumns ?? [])],
     };
 }
 function compareStringArrays(left, right) {
@@ -3367,6 +3368,11 @@ export async function loadCsvLinkedinLeads(input) {
             fileMtimeMs: previewBuild.fileMtimeMs,
             linkedInColumn: previewBuild.resolvedLinkedInColumn ?? "",
             selectedColumns: previewBuild.preview.selectedColumns,
+            ignoredReservedColumns: previewBuild.preview.ignoredReservedColumns,
+            contentFingerprint: previewBuild.preview.confirmationToken
+                ? parseLinkedinConfirmationToken(previewBuild.preview.confirmationToken)
+                    .contentFingerprint
+                : tokenPayload.contentFingerprint,
         };
         if (!matchesLinkedinConfirmationToken(input.confirmationToken, currentPayload)) {
             throw new Error("CSV file changed after preview. Re-run load_csv_linkedin_leads preview before confirming.");
@@ -3480,6 +3486,8 @@ export async function loadCsvLinkedinLeads(input) {
             invalidCount: previewBuild.preview.invalidLinkedInRowCount,
             duplicateCount: previewBuild.preview.duplicateLinkedInCount,
             emptyLinkedInRowCount: previewBuild.preview.emptyLinkedInRowCount,
+            ignoredReservedColumns: previewBuild.preview.ignoredReservedColumns,
+            reservedColumnWarning: previewBuild.preview.reservedColumnWarning,
             duplicatePolicy: previewBuild.preview.duplicatePolicy,
             limits: previewBuild.preview.limits,
             warnings: previewBuild.preview.warnings,

package/dist/tools/prompts.d.ts

@@ -82,6 +82,7 @@ export interface SourceScoutRegistryResponse {
         codex: string;
         claude: string;
         parentThreadRule: string;
+        prepareMessagesRule?: string;
     };
 }
 export interface PostFindLeadsScoutRegistryResponse {
@@ -131,11 +132,12 @@ export interface PostFindLeadsScoutRegistryResponse {
         codex: string;
         claude: string;
         parentThreadRule: string;
+        prepareMessagesRule?: string;
     };
 }
 export declare const DEFAULT_SUBSKILL_PROMPT_CHUNK_CHARS = 48000;
 export declare const MAX_SUBSKILL_PROMPT_CHUNK_CHARS = 48000;
-export declare const ALLOWED_SUBSKILL_PROMPT_NAMES: readonly ["building-gtm-tables", "content", "create-campaign", "create-campaign-brief", "create-campaign-v2", "create-campaign-v2-tail", "create-campaign-v2-validation", "create-post", "create-rubric", "engage", "enrich-prospects", "find-leads", "foundation", "generate-messages", "interview", "load-voice", "research", "research-prospect", "research-sender", "workflow-sequences"];
+export declare const ALLOWED_SUBSKILL_PROMPT_NAMES: readonly ["building-gtm-tables", "content", "create-ab-test", "create-campaign", "create-campaign-brief", "create-campaign-v2", "create-campaign-v2-tail", "create-campaign-v2-validation", "create-post", "create-rubric", "engage", "enrich-prospects", "find-leads", "foundation", "generate-messages", "interview", "load-voice", "research", "research-prospect", "research-sender", "workflow-sequences"];
 export declare const promptToolDefinitions: ({
     name: string;
     description: string;
@@ -179,7 +181,7 @@ export declare const promptToolDefinitions: ({
         properties: {
             subskillName: {
                 type: string;
-                enum: readonly ["building-gtm-tables", "content", "create-campaign", "create-campaign-brief", "create-campaign-v2", "create-campaign-v2-tail", "create-campaign-v2-validation", "create-post", "create-rubric", "engage", "enrich-prospects", "find-leads", "foundation", "generate-messages", "interview", "load-voice", "research", "research-prospect", "research-sender", "workflow-sequences"];
+                enum: readonly ["building-gtm-tables", "content", "create-ab-test", "create-campaign", "create-campaign-brief", "create-campaign-v2", "create-campaign-v2-tail", "create-campaign-v2-validation", "create-post", "create-rubric", "engage", "enrich-prospects", "find-leads", "foundation", "generate-messages", "interview", "load-voice", "research", "research-prospect", "research-sender", "workflow-sequences"];
                 description: string;
             };
             offset: {
@@ -214,7 +216,7 @@ export declare const promptToolDefinitions: ({
         properties: {
             subskillName: {
                 type: string;
-                enum: readonly ["building-gtm-tables", "content", "create-campaign", "create-campaign-brief", "create-campaign-v2", "create-campaign-v2-tail", "create-campaign-v2-validation", "create-post", "create-rubric", "engage", "enrich-prospects", "find-leads", "foundation", "generate-messages", "interview", "load-voice", "research", "research-prospect", "research-sender", "workflow-sequences"];
+                enum: readonly ["building-gtm-tables", "content", "create-ab-test", "create-campaign", "create-campaign-brief", "create-campaign-v2", "create-campaign-v2-tail", "create-campaign-v2-validation", "create-post", "create-rubric", "engage", "enrich-prospects", "find-leads", "foundation", "generate-messages", "interview", "load-voice", "research", "research-prospect", "research-sender", "workflow-sequences"];
                 description: string;
             };
             assetPath: {

package/dist/tools/prompts.js

@@ -19,6 +19,7 @@ const DEPRECATED_SUBSKILL_PROMPT_REPLACEMENTS = {
 export const ALLOWED_SUBSKILL_PROMPT_NAMES = [
     "building-gtm-tables",
     "content",
+    "create-ab-test",
     "create-campaign",
     "create-campaign-brief",
     "create-campaign-v2",
@@ -365,6 +366,7 @@ export function getPostFindLeadsScoutRegistry() {
             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 anything before that question. After the answer, launch only Message Drafting whenever Codex agent-launch policy is satisfied. The registry lookup is not a launch: after get_post_find_leads_scout_registry, immediately invoke Task/spawn_agent or the host background-agent mechanism before loading filter-leads.md or saving rubrics. If filters are chosen, the parent stays on Filter Rules and drafts/saves rubrics with MCP tools while Message Drafting runs in the background. If filters are skipped, move to Messages/message review after Message Drafting is ready. Treat YOLO/autonomous mode as campaign-scoped permission for this single post-import worker; do not ask for another permission click in YOLO. If the user has not enabled YOLO and has not explicitly asked for background agents/subagents/parallel agents/delegation/message bg agent in this campaign, ask once before loading the long message prompt in the parent. If permission is granted and the named Message Drafting custom agent is unavailable, spawn a generic gpt-5.5 xhigh Message Drafting background agent with the same lean campaign/table basis. If no background-agent tool is callable, start the same full message branch inline before filter drafting, or return blocked/retry-needed; do not wait until filters are saved and then call the registry.",
             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 any Task/Agent before that question. After the answer, invoke only Message Drafting. If filters are chosen, parent drafts/saves rubrics with MCP tools while Message Drafting runs, asks filter approval, then joins Message Drafting. If filters are skipped, invoke only Message Drafting and move to Messages/message review.",
             parentThreadRule: 'Named agents are optional acceleration, but message drafting is not optional. The only normal background worker is Message Drafting. YOLO/autonomous mode counts as campaign-scoped permission for this single post-import worker; do not ask for another permission click in YOLO. If a named agent is unavailable after permission, use a generic gpt-5.5 xhigh Message Drafting background agent. source work and filter work stay in the parent thread with MCP tools. If post-find-leads-message-scout is available, run it as the background Message Draft Builder after the filter-choice answer. The registry lookup is not a launch: get_post_find_leads_scout_registry only identifies the worker, and Message Drafting counts as started only after Task/spawn_agent or the host background-agent tool is invoked, or after the parent begins the same full message branch inline because no background-agent tool is callable. This launch must happen before loading filter-leads.md, save_rubrics, or filter approval. If post-find-leads-message-scout is absent, do not customer-surface install status. Do not silently fall back to parent-thread message drafting; the main thread must execute the same message branch from CampaignOffer state, selected source state, workflowTableId, and initial campaign-table execution slice rows. If no background-agent tool is callable, start that same full message branch inline before filter drafting, or return blocked/retry-needed; do not wait until filters are saved and then call the registry. The Message Drafting handoff must be lean. Do not paste copied row counts, brief hashes, review-batch hashes, full reviewBatchRowIds, broad row data, or local debug artifacts into the spawn prompt. 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 or filter references before it. Message drafting starts after the filter-choice answer, must load get_subskill_prompt({ subskillName: "generate-messages" }), and must load every required message asset named by generate-messages Mode 0 through get_subskill_asset before drafting. Reference Asset Loading means loading the required pre-draft reference pack before drafting; return blocked/retry-needed if required assets cannot be loaded; load ai-tells.md because it is never optional. The branch loads the full generate-messages prompt and every referenced asset through get_subskill_asset. After generating/revising the candidate and before returning ready, must load get_subskill_prompt({ subskillName: "create-campaign-v2-validation" }) as the final internal validation gate, must read live campaign table state through scoped MCP/product tools, and must reject mismatched selectedLeadListId/workflowTableId/campaign/workspace input. Do not block when filters were chosen but leadScoringRubrics are not yet visible in the branch read; the parent owns save_rubrics and filter approval in parallel, so Message Drafting should return status ready with basisStatus usable_initial when the campaign/list/table and non-empty execution slice match. Do not use any alternate, local-artifact, or examples-only message prompt. User copy feedback, message QA, or rewrite requests before approve-message must be routed back to Message Drafting with the current recommendation, lean campaign/table basis, and latest user text; the parent must not rewrite or QA the template from memory and must not call update_campaign_brief before approve-message. The worker validates internally and returns only templateRecommendation, tokenFillRules, renderedGoodSample, status, approveOrReviseRecommendation, validationStatus, outputAt, outputHash, and blocked/retry detail. Do not render renderedFallbackSample, risk notes, or a qaReceipt on the normal happy path. On the filter path, save_rubrics keeps 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 after Message Drafting is ready 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 prompt, required message assets, and validation gate ran for the current campaign/table execution slice. Do not automatically rerun Message Drafting after filters/enrichment finish; show the initial draft by default and offer an enriched rewrite only with explicit user opt-in. Handoff and recommendation output are Markdown with labeled fields, not raw JSON.',
+            prepareMessagesRule: 'After message approval, prefer start_prepare_campaign_messages for target-ready preparation such as prepare 100 messages checking up to 300 rows. campaignId is CampaignOffer.id. approvalMode defaults to mark_ready; approvalMode approve requires explicit user intent to flip Approved cells. Poll get_prepare_campaign_messages_status and summarize checked rows, prepared/approved count, target, rows remaining, and stop reason. If the user asks to stop preparation, the target is wrong, or status shows the wrong campaign/table, call cancel_prepare_campaign_messages; otherwise do not cancel a healthy prepare run. Low-level selectors are diagnostics and recovery only for this lane. start_campaign remains forbidden until final launch greenlight.',
         },
     };
 }

package/dist/tools/registry.d.ts

@@ -225,7 +225,7 @@ export declare const allTools: ({
         properties: {
             subskillName: {
                 type: string;
-                enum: readonly ["building-gtm-tables", "content", "create-campaign", "create-campaign-brief", "create-campaign-v2", "create-campaign-v2-tail", "create-campaign-v2-validation", "create-post", "create-rubric", "engage", "enrich-prospects", "find-leads", "foundation", "generate-messages", "interview", "load-voice", "research", "research-prospect", "research-sender", "workflow-sequences"];
+                enum: readonly ["building-gtm-tables", "content", "create-ab-test", "create-campaign", "create-campaign-brief", "create-campaign-v2", "create-campaign-v2-tail", "create-campaign-v2-validation", "create-post", "create-rubric", "engage", "enrich-prospects", "find-leads", "foundation", "generate-messages", "interview", "load-voice", "research", "research-prospect", "research-sender", "workflow-sequences"];
                 description: string;
             };
             offset: {
@@ -260,7 +260,7 @@ export declare const allTools: ({
         properties: {
             subskillName: {
                 type: string;
-                enum: readonly ["building-gtm-tables", "content", "create-campaign", "create-campaign-brief", "create-campaign-v2", "create-campaign-v2-tail", "create-campaign-v2-validation", "create-post", "create-rubric", "engage", "enrich-prospects", "find-leads", "foundation", "generate-messages", "interview", "load-voice", "research", "research-prospect", "research-sender", "workflow-sequences"];
+                enum: readonly ["building-gtm-tables", "content", "create-ab-test", "create-campaign", "create-campaign-brief", "create-campaign-v2", "create-campaign-v2-tail", "create-campaign-v2-validation", "create-post", "create-rubric", "engage", "enrich-prospects", "find-leads", "foundation", "generate-messages", "interview", "load-voice", "research", "research-prospect", "research-sender", "workflow-sequences"];
                 description: string;
             };
             assetPath: {
@@ -659,6 +659,66 @@ export declare const allTools: ({
         required: string[];
         additionalProperties: boolean;
     };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            campaignId: {
+                type: string;
+                description: string;
+            };
+            tableId: {
+                type: string;
+            };
+            targetPreparedMessages: {
+                type: string;
+            };
+            maxRowsToCheck: {
+                type: string;
+            };
+            batchSize: {
+                type: string;
+            };
+            approvalMode: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            autoContinue: {
+                type: string;
+            };
+            jobId?: undefined;
+        };
+        required: string[];
+        additionalProperties: boolean;
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            jobId: {
+                type: string;
+            };
+            campaignId: {
+                type: string;
+                description?: undefined;
+            };
+            tableId: {
+                type: string;
+            };
+            targetPreparedMessages?: undefined;
+            maxRowsToCheck?: undefined;
+            batchSize?: undefined;
+            approvalMode?: undefined;
+            autoContinue?: undefined;
+        };
+        additionalProperties: boolean;
+        required?: undefined;
+    };
 } | {
     name: string;
     description: string;
@@ -1140,6 +1200,62 @@ export declare const allTools: ({
         required: string[];
         additionalProperties?: undefined;
     };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            sourceCampaignId: {
+                type: string;
+                description: string;
+            };
+            variantName: {
+                type: string;
+                description: string;
+            };
+            variantBriefDelta: {
+                type: string;
+                description: string;
+            };
+            variantALabel: {
+                type: string;
+                description: string;
+            };
+            variantABriefDelta: {
+                type: string;
+                description: string;
+            };
+            splitStrategy: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            targetCounts: {
+                type: string;
+                properties: {
+                    a: {
+                        type: string;
+                    };
+                    b: {
+                        type: string;
+                    };
+                };
+                additionalProperties: boolean;
+                description: string;
+            };
+            dryRun: {
+                type: string;
+                description: string;
+            };
+            idempotencyKey: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+        additionalProperties: boolean;
+    };
 } | {
     name: string;
     description: string;

package/dist/tools/registry.js

@@ -2,6 +2,8 @@ import { authToolDefinitions } from "./auth.js";
 import { blueprintCommitToolDefinitions } from "./blueprint-commit.js";
 import { bootstrapToolDefinitions } from "./bootstrap.js";
 import { campaignToolDefinitions } from "./campaigns.js";
+import { campaignAbTestToolDefinitions } from "./campaign-ab-test.js";
+import { campaignMessagePreparationToolDefinitions } from "./campaign-message-preparation.js";
 import { campaignProcessingToolDefinitions } from "./campaign-processing.js";
 import { cellToolDefinitions } from "./cells.js";
 import { startCliLoginToolDef, waitForCliLoginToolDef } from "./cli-login.js";
@@ -31,6 +33,8 @@ import { verifyRowToolDefinitions } from "./verify-row.js";
 import { workspaceToolDefinitions } from "./workspaces.js";
 export const allTools = [
     ...campaignToolDefinitions,
+    ...campaignAbTestToolDefinitions,
+    ...campaignMessagePreparationToolDefinitions,
     ...campaignProcessingToolDefinitions,
     ...authToolDefinitions,
     startCliLoginToolDef,

package/package.json

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

package/skills/create-ab-test/SKILL.md

@@ -0,0 +1,77 @@
+---
+name: create-ab-test
+description: Create a Sellable campaign A/B test from a clean source lead list.
+visibility: public
+allowed-tools:
+  - mcp__sellable__get_auth_status
+  - mcp__sellable__get_active_workspace
+  - mcp__sellable__get_campaign
+  - mcp__sellable__get_campaign_context
+  - mcp__sellable__get_campaign_navigation_state
+  - mcp__sellable__get_campaign_messages_preview
+  - mcp__sellable__prepare_campaign_ab_test
+  - mcp__sellable__load_csv_linkedin_leads
+  - mcp__sellable__wait_for_lead_list_ready
+  - mcp__sellable__get_table_rows
+  - mcp__sellable__get_rows_minimal
+---
+
+# Sellable Create A/B Test
+
+Use this workflow when the user asks to create an A/B campaign test, split a
+campaign into variants, duplicate a campaign for copy testing, or compare two
+campaign-message approaches from the same source list.
+
+## Opening Contract
+
+Start by identifying the source campaign, the one variable being tested, and
+the clean source lead origin. Then prepare the split and stop for review. The
+goal is two review-copy campaigns with clean split source lists, not a launched
+campaign.
+
+## Required Flow
+
+1. Confirm the source campaign ID or resolve it with `get_campaign`.
+2. Confirm the A/B variable in plain language. Keep variant B as the explicit
+   change and leave variant A as the control unless the user names an A change.
+3. Verify the campaign has a clean source lead list. A clean source list is a
+   lead-list table, not the generated campaign workflow table.
+4. Call `prepare_campaign_ab_test` with `dryRun: true` first.
+5. Review split counts, duplicate/skipped counts, campaign names, and variant
+   brief deltas with the user.
+6. Only after review, call `prepare_campaign_ab_test` without `dryRun` using the
+   same `idempotencyKey` if one was returned or supplied.
+7. Return the A and B campaign IDs, split lead-list IDs, counts, and the
+   explicit note that both campaigns are `not_started`.
+
+## Anti-Patterns
+
+- Do not call `export_table_csv` from an enriched/generated campaign workflow
+  table as the lead source for A/B splitting.
+- Do not reimport workflow output columns such as `ICP Score`, `Passes Rubric`,
+  `Generate Message`, `Message`, `Approved`, scheduling, status, result, or
+  error columns.
+- Do not use broad workflow-table selectors to split decorated campaign rows.
+- Do not call `start_campaign`, approve launch, attach senders for launch, or
+  trigger live sends in this workflow.
+
+## Clean Source Fallback
+
+If the source campaign has no clean source lead list, or the source list is
+polluted with workflow/output columns, ask for the original CSV or clean source
+list. Use `load_csv_linkedin_leads`; it strips Sellable workflow columns if a
+contaminated CSV is supplied, then creates a clean lead list. After the clean
+source is confirmed, retry `prepare_campaign_ab_test`.
+
+## Output Contract
+
+Report:
+
+- source campaign ID
+- source lead-list ID
+- split strategy and counts
+- duplicate/skipped lead counts
+- A review campaign ID and split lead-list ID
+- B review campaign ID and split lead-list ID
+- variant difference
+- `launchState: not_started` for both campaigns