@sellable/mcp 0.1.274 → 0.1.275

package/README.md

@@ -16,9 +16,10 @@ Each message gets 5+ minutes of Claude attention with deep research - no other t
 
 ### Prompt Source Of Truth
 
-There are four public Sellable entrypoints shared across hosts:
+There are five public Sellable entrypoints shared across hosts:
 
 - `sellable:create-campaign`
+- `sellable:create-ab-test`
 - `sellable:foundation`
 - `sellable:content`
 - `sellable:create-post`
@@ -29,6 +30,11 @@ the approval-gated workflow from:
 
 - `mcp/sellable/skills/create-campaign-v2/SKILL.md`
 
+The create-ab-test public wrapper prepares clean A/B split lead lists and
+review-copy campaigns from:
+
+- `mcp/sellable/skills/create-ab-test/SKILL.md`
+
 The foundation public wrapper loads the core identity/company memory workflow
 from:
 
@@ -148,8 +154,9 @@ The installer does the full local setup:
   `mcp__sellable__*` tools into skill sessions
 
 After the installer passes, fully quit and reopen Codex Desktop. Start a new
-thread and select `Sellable Create Campaign`, `Sellable Foundation`,
-`Sellable Content`, or `Sellable Create Post`; or invoke `$sellable:create-campaign`,
+thread and select `Sellable Create Campaign`, `Sellable Create A/B Test`,
+`Sellable Foundation`, `Sellable Content`, or `Sellable Create Post`; or invoke
+`$sellable:create-campaign`, `$sellable:create-ab-test`,
 `$sellable:foundation`, `$sellable:content`, or `$sellable:create-post`. If the app still says
 `mcp__sellable__*` tools are missing after the installer passes, check that
 `~/.codex/config.toml` contains both `[marketplaces.sellable]` and
@@ -162,19 +169,23 @@ the Sellable MCP tools for Codex Desktop.
 Use these names consistently:
 
 - Claude Code command: `/sellable:create-campaign`
+- Claude Code command: `/sellable:create-ab-test`
 - Claude Code command: `/sellable:foundation`
 - Claude Code command: `/sellable:content`
 - Claude Code command: `/sellable:create-post`
 - Codex command: `$sellable:create-campaign`
+- Codex command: `$sellable:create-ab-test`
 - Codex command: `$sellable:foundation`
 - Codex command: `$sellable:content`
 - Codex command: `$sellable:create-post`
 - Codex Desktop plugin: `sellable@sellable`
 - Codex visible skill: `Sellable Create Campaign`
+- Codex visible skill: `Sellable Create A/B Test`
 - Codex visible skill: `Sellable Foundation`
 - Codex visible skill: `Sellable Content`
 - Codex visible skill: `Sellable Create Post`
 - Codex skill frontmatter name: `create-campaign`
+- Codex skill frontmatter name: `create-ab-test`
 - Codex skill frontmatter name: `foundation`
 - Codex skill frontmatter name: `content`
 - Codex skill frontmatter name: `create-post`

package/dist/server.js

@@ -7,6 +7,7 @@ import { handleAddColumn, handleCommitBlueprint, } from "./tools/blueprint-commi
 import { bootstrapCreateCampaign } from "./tools/bootstrap.js";
 import { getCampaignTableSchema, queueCampaignCells, reviseMessageTemplateAndRerun, selectCampaignCells, waitForCampaignProcessing, } from "./tools/campaign-processing.js";
 import { createCampaign, duplicateCampaign, getCampaign, getCampaignMessagesPreview, getCampaigns, pauseCampaign, startCampaign, updateCampaign, updateCampaignBrief, } from "./tools/campaigns.js";
+import { prepareCampaignAbTest } from "./tools/campaign-ab-test.js";
 import { queueCells, updateCell } from "./tools/cells.js";
 import { handleStartCliLogin, handleWaitForCliLogin, } from "./tools/cli-login.js";
 import { calculateLinkedInHookPreviewTool, capturePostIdeaTool, getPostDraftTool, getPostIdeaTool, getPublishedPostTool, listPostDraftIterationsTool, listPostDraftsTool, listPostIdeasTool, listPublishedPostsTool, markPostPublishedTool, renderLinkedInPostPreviewTool, saveHookResearchTool, savePostDraftTool, updatePostDraftTool, updatePublishedPostMetricsTool, } from "./tools/content-posts.js";
@@ -215,6 +216,15 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                     markCampaignContextDirty(result.campaignOfferId, "duplicate_campaign");
                 }
                 break;
+            case "prepare_campaign_ab_test":
+                result = await prepareCampaignAbTest(args);
+                if (result?.variants?.A?.campaignId) {
+                    markCampaignContextDirty(result.variants.A.campaignId, "prepare_campaign_ab_test");
+                }
+                if (result?.variants?.B?.campaignId) {
+                    markCampaignContextDirty(result.variants.B.campaignId, "prepare_campaign_ab_test");
+                }
+                break;
             case "update_campaign_brief":
                 result = await updateCampaignBrief(args?.campaignId, args?.campaignBrief);
                 if (args?.campaignId) {

package/dist/tools/campaign-ab-test.d.ts

@@ -0,0 +1,72 @@
+export interface PrepareCampaignAbTestInput {
+    sourceCampaignId: string;
+    variantName: string;
+    variantBriefDelta: string;
+    variantALabel?: string;
+    variantABriefDelta?: string;
+    splitStrategy?: "alternating_stable_sort";
+    targetCounts?: {
+        a?: number;
+        b?: number;
+    };
+    dryRun?: boolean;
+    idempotencyKey?: string;
+}
+export declare const campaignAbTestToolDefinitions: {
+    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;
+    };
+}[];
+export declare function prepareCampaignAbTest(input: PrepareCampaignAbTestInput): Promise<unknown>;

package/dist/tools/campaign-ab-test.js

@@ -0,0 +1,60 @@
+import { getApi } from "../api.js";
+export const campaignAbTestToolDefinitions = [
+    {
+        name: "prepare_campaign_ab_test",
+        description: "Prepare a campaign A/B test from an existing campaign using its clean source lead list. Creates deterministic A/B split lead lists and review-copy campaigns, updates the variant brief, and never launches either campaign.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                sourceCampaignId: {
+                    type: "string",
+                    description: "Existing source campaign ID.",
+                },
+                variantName: {
+                    type: "string",
+                    description: "Short label for variant B, e.g. New CTA.",
+                },
+                variantBriefDelta: {
+                    type: "string",
+                    description: "The specific campaign brief/copy change for variant B.",
+                },
+                variantALabel: {
+                    type: "string",
+                    description: "Optional label for the control variant.",
+                },
+                variantABriefDelta: {
+                    type: "string",
+                    description: "Optional explicit brief change for variant A. Omit for unchanged control.",
+                },
+                splitStrategy: {
+                    type: "string",
+                    enum: ["alternating_stable_sort"],
+                    description: "Deterministic split strategy. Defaults to alternating_stable_sort.",
+                },
+                targetCounts: {
+                    type: "object",
+                    properties: {
+                        a: { type: "number" },
+                        b: { type: "number" },
+                    },
+                    additionalProperties: false,
+                    description: "Optional exact split counts. Omit for an even alternating split.",
+                },
+                dryRun: {
+                    type: "boolean",
+                    description: "When true, returns split plan and review names without creating campaigns/lists.",
+                },
+                idempotencyKey: {
+                    type: "string",
+                    description: "Optional stable key for retrying the same A/B preparation safely.",
+                },
+            },
+            required: ["sourceCampaignId", "variantName", "variantBriefDelta"],
+            additionalProperties: false,
+        },
+    },
+];
+export async function prepareCampaignAbTest(input) {
+    const api = getApi();
+    return api.post("/api/v3/mcp/campaign-ab-test", input);
+}

package/dist/tools/csv-linkedin.d.ts

@@ -9,6 +9,18 @@ export type CsvLinkedinLimits = {
     maxRows: number;
     maxCarryColumns: number;
 };
+export type CsvLinkedinIgnoredReservedColumn = {
+    originalHeader: string;
+    canonicalName: string;
+    reason: string;
+};
+export type CsvLinkedinContentFingerprint = {
+    fileSha256: string;
+    sanitizedHeaderSha256: string;
+    selectedColumnsSha256: string;
+    ignoredReservedColumnsSha256: string;
+    rowCount: number;
+};
 export type CsvLinkedinPreview = {
     resolvedFilePath: string;
     suggestedLeadListName: string;
@@ -26,6 +38,8 @@ export type CsvLinkedinPreview = {
     duplicateLinkedInCount: number;
     emptyLinkedInRowCount: number;
     duplicatePolicy: "first_wins";
+    ignoredReservedColumns: CsvLinkedinIgnoredReservedColumn[];
+    reservedColumnWarning: string | null;
     limits: CsvLinkedinLimits;
     warnings: string[];
     blockingErrors: string[];
@@ -38,6 +52,8 @@ export type CsvLinkedinConfirmationPayload = {
     fileMtimeMs: number;
     linkedInColumn: string;
     selectedColumns: string[];
+    ignoredReservedColumns: CsvLinkedinIgnoredReservedColumn[];
+    contentFingerprint: CsvLinkedinContentFingerprint;
 };
 export type PreparedLinkedinLeadRow = {
     row: Record<string, string>;
@@ -76,6 +92,9 @@ type ParsedCsvLinkedinFile = {
     headers: string[];
     rows: Array<Record<string, string>>;
     totalRows: number;
+    ignoredReservedColumns: CsvLinkedinIgnoredReservedColumn[];
+    reservedColumnWarning: string | null;
+    fileSha256: string;
     blockingErrors: string[];
     warnings: string[];
 };
@@ -86,6 +105,10 @@ export type LinkedInValidationResult = {
     valid: false;
     reason: string;
 };
+export declare function getReservedWorkflowColumnMatch(header: string): {
+    canonicalName: string;
+    reason: string;
+} | null;
 export declare function validateAndNormalizeLinkedInUrl(value: string): LinkedInValidationResult;
 export declare function makeLinkedinConfirmationToken(payload: CsvLinkedinConfirmationPayload): string;
 export declare function parseLinkedinConfirmationToken(token: string): CsvLinkedinConfirmationPayload;

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

@@ -135,7 +135,7 @@ export interface PostFindLeadsScoutRegistryResponse {
 }
 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 +179,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 +214,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",

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: {
@@ -1140,6 +1140,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,7 @@ 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 { campaignProcessingToolDefinitions } from "./campaign-processing.js";
 import { cellToolDefinitions } from "./cells.js";
 import { startCliLoginToolDef, waitForCliLoginToolDef } from "./cli-login.js";
@@ -31,6 +32,7 @@ import { verifyRowToolDefinitions } from "./verify-row.js";
 import { workspaceToolDefinitions } from "./workspaces.js";
 export const allTools = [
     ...campaignToolDefinitions,
+    ...campaignAbTestToolDefinitions,
     ...campaignProcessingToolDefinitions,
     ...authToolDefinitions,
     startCliLoginToolDef,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sellable/mcp",
-  "version": "0.1.274",
+  "version": "0.1.275",
   "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

package/skills/create-campaign/SKILL.md

@@ -109,6 +109,22 @@ page before importing, call `list_dnc_entries`. Confirm the active workspace
 name and ID in the response before any write. This is Sellable's workspace DNC
 list used by DNC Check.
 
+## A/B Campaign Requests
+
+If the user explicitly asks to create an A/B test, split an existing campaign
+into variants, duplicate a campaign for copy testing, or compare two campaign
+message approaches from the same source list, route them to
+`create-ab-test` instead of improvising inside this create-campaign workflow.
+
+Workflow/campaign table exports are decorated outputs for operator review and
+debugging. They are not source lead lists for A/B splitting or campaign
+duplication. Do not use `export_table_csv` from an enriched/generated campaign
+table and then reimport it as leads. If the user only has a contaminated CSV,
+`load_csv_linkedin_leads` strips Sellable workflow columns such as `ICP Score`,
+`Passes Rubric`, `Generate Message`, `Message`, and `Approved`, but the
+preferred A/B path is the dedicated `create-ab-test` workflow using
+`prepare_campaign_ab_test`.
+
 ## Opening Turn Contract
 
 On the first visible response after this skill is invoked, do not narrate