@sellable/mcp 0.1.277 → 0.1.278

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

@@ -1,11 +1,6 @@
 export interface PrepareCampaignAbTestInput {
-    sourceCampaignId?: string;
+    sourceCampaignId: string;
     sourceLeadListId?: string;
-    campaignName?: string;
-    campaignBrief?: string;
-    offerPositioning?: Record<string, unknown>;
-    clientProspectId?: string;
-    senderLinkedinUrl?: string;
     variantName: string;
     variantBriefDelta: string;
     variantALabel?: string;
@@ -32,27 +27,6 @@ export declare const campaignAbTestToolDefinitions: {
                 type: string;
                 description: string;
             };
-            campaignName: {
-                type: string;
-                description: string;
-            };
-            campaignBrief: {
-                type: string;
-                description: string;
-            };
-            offerPositioning: {
-                type: string;
-                additionalProperties: boolean;
-                description: string;
-            };
-            clientProspectId: {
-                type: string;
-                description: string;
-            };
-            senderLinkedinUrl: {
-                type: string;
-                description: string;
-            };
             variantName: {
                 type: string;
                 description: string;

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

@@ -2,38 +2,17 @@ import { getApi } from "../api.js";
 export const campaignAbTestToolDefinitions = [
     {
         name: "prepare_campaign_ab_test",
-        description: "Prepare a campaign A/B test from an existing campaign, a clean source lead list, or just a campaign idea. If sourceCampaignId is omitted, pass campaignName and campaignBrief so the tool creates the A campaign first and duplicates it for B. sourceLeadListId is optional; when provided the tool also creates deterministic A/B split lead lists and imports those rows. The tool never launches either campaign.",
+        description: "Prepare a campaign A/B test from a full Campaign A created through the Sellable create-campaign workflow. The helper duplicates the source campaign through the product duplicate path so B preserves the approved brief, ICP filters, message setup, and campaign-table structure before applying the B delta. sourceLeadListId is optional and must only be supplied after asking whether to split Campaign A's clean selected lead list. The tool never launches either campaign.",
         inputSchema: {
             type: "object",
             properties: {
                 sourceCampaignId: {
                     type: "string",
-                    description: "Optional existing source campaign ID. If omitted, campaignName and campaignBrief are required.",
+                    description: "Required Campaign A ID. Create Campaign A through the full Sellable create-campaign workflow before calling this helper.",
                 },
                 sourceLeadListId: {
                     type: "string",
-                    description: "Optional clean source lead-list table ID. When supplied, rows are split into A/B lead lists and imported into the draft campaigns.",
-                },
-                campaignName: {
-                    type: "string",
-                    description: "Base campaign name generated from the user's idea when sourceCampaignId is omitted.",
-                },
-                campaignBrief: {
-                    type: "string",
-                    description: "Base campaign brief generated from the user's idea when sourceCampaignId is omitted.",
-                },
-                offerPositioning: {
-                    type: "object",
-                    additionalProperties: true,
-                    description: "Optional offer positioning JSON to store on the newly created A campaign.",
-                },
-                clientProspectId: {
-                    type: "string",
-                    description: "Optional client prospect ID to store on the newly created A campaign.",
-                },
-                senderLinkedinUrl: {
-                    type: "string",
-                    description: "Optional sender LinkedIn profile URL to preserve in A/B metadata.",
+                    description: "Optional clean source lead-list table ID from Campaign A. Only pass this after the user approves splitting Campaign A's lead list; when supplied, rows are split into A/B lead lists and imported into review-copy campaigns.",
                 },
                 variantName: {
                     type: "string",
@@ -74,7 +53,7 @@ export const campaignAbTestToolDefinitions = [
                     description: "Optional stable key for retrying the same A/B preparation safely.",
                 },
             },
-            required: ["variantName", "variantBriefDelta"],
+            required: ["sourceCampaignId", "variantName", "variantBriefDelta"],
             additionalProperties: false,
         },
     },

package/dist/tools/registry.d.ts

@@ -1214,27 +1214,6 @@ export declare const allTools: ({
                 type: string;
                 description: string;
             };
-            campaignName: {
-                type: string;
-                description: string;
-            };
-            campaignBrief: {
-                type: string;
-                description: string;
-            };
-            offerPositioning: {
-                type: string;
-                additionalProperties: boolean;
-                description: string;
-            };
-            clientProspectId: {
-                type: string;
-                description: string;
-            };
-            senderLinkedinUrl: {
-                type: string;
-                description: string;
-            };
             variantName: {
                 type: string;
                 description: string;

package/package.json

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

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

@@ -1,14 +1,24 @@
 ---
 name: create-ab-test
-description: Create a Sellable campaign A/B test from a clean source lead list.
+description: Create a Sellable campaign A/B test by duplicating a full Campaign A.
 visibility: public
 allowed-tools:
   - mcp__sellable__get_auth_status
+  - mcp__sellable__bootstrap_create_campaign
+  - mcp__sellable__get_subskill_prompt
+  - mcp__sellable__get_subskill_asset
   - mcp__sellable__get_active_workspace
+  - mcp__sellable__fetch_linkedin_profile
+  - mcp__sellable__complete_sender_research
+  - mcp__sellable__create_campaign
+  - mcp__sellable__update_campaign_brief
+  - mcp__sellable__update_campaign
+  - mcp__sellable__save_rubrics
   - mcp__sellable__get_campaign
   - mcp__sellable__get_campaign_context
   - mcp__sellable__get_campaign_navigation_state
   - mcp__sellable__get_campaign_messages_preview
+  - mcp__sellable__duplicate_campaign
   - mcp__sellable__prepare_campaign_ab_test
   - mcp__sellable__load_csv_linkedin_leads
   - mcp__sellable__wait_for_lead_list_ready
@@ -24,46 +34,65 @@ campaign-message approaches from the same source list.
 
 ## Opening Contract
 
-Start by identifying the campaign idea and the one variable being tested. A
-source campaign and clean source lead list are both optional: use an existing
-campaign when the user already has one, use a clean source lead list when leads
-are already available, or use only the idea by writing a campaign name and base
-brief for A. The tool creates A first, duplicates A into B, applies the B delta,
-and stops for review. The goal is two review-copy campaigns, not a launched
-campaign.
+Start by identifying the campaign idea and the one variable being tested.
+Campaign A must be a real, fully prepared Sellable campaign before this A/B
+helper runs. If the user only supplied an idea, first run the normal
+`$sellable:create-campaign` flow for Campaign A: research the sender/company,
+create the campaign shell, build and approve the campaign brief, source or
+attach leads when appropriate, save any approved ICP filters, and get the
+message/template state into the campaign brief. Do not call
+`prepare_campaign_ab_test` with only `campaignName`/`campaignBrief`.
+
+Once Campaign A exists, the A/B step duplicates Campaign A through Sellable's
+product duplicate path and applies only the B variant delta. This preserves the
+approved brief, ICP filters, message setup, rubrics, and campaign-table
+structure so the test differs only by the chosen variable and, if approved, the
+split lead list.
 
 ## Required Flow
 
 1. Decide the source mode:
-   - Existing campaign mode: confirm the source campaign ID or resolve it with
+   - Existing Campaign A: confirm the source campaign ID or resolve it with
      `get_campaign`.
-   - Idea-first mode: write a proper campaign name and base campaign brief from
-     the user's idea. If the user also has leads, confirm the clean source
-     lead-list ID or use `load_csv_linkedin_leads` first.
+   - Idea-only request: run the full `$sellable:create-campaign` workflow first,
+     then use the created campaign ID as `sourceCampaignId`.
 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. If a source lead list is supplied, verify it is clean. A clean source list is
+3. Inspect Campaign A with `get_campaign` and `get_campaign_context`. Confirm
+   the brief exists and includes the approved messaging/template state when the
+   campaign has reached message review.
+4. If Campaign A has a clean `selectedLeadListId`, ask the user whether to split
+   Campaign A's lead list for this A/B test:
+   - Split the lead list: pass that clean list as `sourceLeadListId`.
+   - Do not split yet: omit `sourceLeadListId`; Campaign B is a duplicate for
+     review and no rows are imported.
+   Never silently split a list just because Campaign A has one.
+5. If a source lead list is supplied, verify it is clean. A clean source list is
    a lead-list or signal-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
+6. Call `prepare_campaign_ab_test` with `dryRun: true` first.
+7. Review split counts when applicable, campaign names, and variant brief deltas
+   with the user.
+8. 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`.
+9. Return Campaign A, duplicated Campaign B, split lead-list IDs when supplied,
+   counts, and the explicit note that both campaigns are `not_started`.
 
 ## Tool Inputs
 
 Use one of these shapes:
 
-- Existing campaign mode: pass `sourceCampaignId`, `variantName`,
-  `variantBriefDelta`, and any optional split or A-variant fields.
-- Idea-first mode: omit `sourceCampaignId`, pass `campaignName`,
-  `campaignBrief`, `variantName`, and `variantBriefDelta`. If a clean lead list
-  is available, also pass `sourceLeadListId`; otherwise leave it out. The tool
-  creates the A campaign, then duplicates A to create B and applies the B brief
-  delta.
+- No split: pass `sourceCampaignId`, `variantName`, `variantBriefDelta`, and
+  any optional A-variant fields. The helper treats the source campaign as A and
+  duplicates it for B.
+- Approved split: pass `sourceCampaignId`, the approved clean
+  `sourceLeadListId`, `variantName`, `variantBriefDelta`, and any optional split
+  or A-variant fields. The helper creates deterministic A/B split lead lists and
+  review-copy campaigns from Campaign A.
+
+Do not pass `campaignName`, `campaignBrief`, `offerPositioning`,
+`clientProspectId`, or `senderLinkedinUrl` to `prepare_campaign_ab_test`.
+Those belong to the full create-campaign workflow that creates Campaign A.
 
 ## Anti-Patterns
 
@@ -82,18 +111,18 @@ 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. If no clean source
-is available, continue in idea-first mode without `sourceLeadListId`.
+is available, omit `sourceLeadListId` and create only the B duplicate for review.
 
 ## Output Contract
 
 Report:
 
-- source campaign ID, or note that the A campaign was created as the source
-  campaign when no source campaign was provided
+- source Campaign A ID
 - source lead-list ID when supplied
 - split strategy and counts when a source lead list was supplied
 - duplicate/skipped lead counts when a source lead list was supplied
-- A review campaign ID and split lead-list ID when supplied
-- B review campaign ID and split lead-list ID when supplied
+- Campaign A ID, or A review-copy campaign ID when a split was approved
+- duplicated Campaign B ID
+- split lead-list IDs when supplied
 - variant difference
 - `launchState: not_started` for both campaigns