@sellable/install 0.1.197 → 0.1.198
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/package.json
CHANGED
|
@@ -1,14 +1,24 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: create-ab-test
|
|
3
|
-
description: Create a Sellable campaign A/B test
|
|
3
|
+
description: Create a Sellable campaign A/B test by duplicating a full Campaign A.
|
|
4
4
|
visibility: public
|
|
5
5
|
allowed-tools:
|
|
6
6
|
- mcp__sellable__get_auth_status
|
|
7
|
+
- mcp__sellable__bootstrap_create_campaign
|
|
8
|
+
- mcp__sellable__get_subskill_prompt
|
|
9
|
+
- mcp__sellable__get_subskill_asset
|
|
7
10
|
- mcp__sellable__get_active_workspace
|
|
11
|
+
- mcp__sellable__fetch_linkedin_profile
|
|
12
|
+
- mcp__sellable__complete_sender_research
|
|
13
|
+
- mcp__sellable__create_campaign
|
|
14
|
+
- mcp__sellable__update_campaign_brief
|
|
15
|
+
- mcp__sellable__update_campaign
|
|
16
|
+
- mcp__sellable__save_rubrics
|
|
8
17
|
- mcp__sellable__get_campaign
|
|
9
18
|
- mcp__sellable__get_campaign_context
|
|
10
19
|
- mcp__sellable__get_campaign_navigation_state
|
|
11
20
|
- mcp__sellable__get_campaign_messages_preview
|
|
21
|
+
- mcp__sellable__duplicate_campaign
|
|
12
22
|
- mcp__sellable__prepare_campaign_ab_test
|
|
13
23
|
- mcp__sellable__load_csv_linkedin_leads
|
|
14
24
|
- mcp__sellable__wait_for_lead_list_ready
|
|
@@ -24,46 +34,65 @@ campaign-message approaches from the same source list.
|
|
|
24
34
|
|
|
25
35
|
## Opening Contract
|
|
26
36
|
|
|
27
|
-
Start by identifying the campaign idea and the one variable being tested.
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
campaign.
|
|
37
|
+
Start by identifying the campaign idea and the one variable being tested.
|
|
38
|
+
Campaign A must be a real, fully prepared Sellable campaign before this A/B
|
|
39
|
+
helper runs. If the user only supplied an idea, first run the normal
|
|
40
|
+
`$sellable:create-campaign` flow for Campaign A: research the sender/company,
|
|
41
|
+
create the campaign shell, build and approve the campaign brief, source or
|
|
42
|
+
attach leads when appropriate, save any approved ICP filters, and get the
|
|
43
|
+
message/template state into the campaign brief. Do not call
|
|
44
|
+
`prepare_campaign_ab_test` with only `campaignName`/`campaignBrief`.
|
|
45
|
+
|
|
46
|
+
Once Campaign A exists, the A/B step duplicates Campaign A through Sellable's
|
|
47
|
+
product duplicate path and applies only the B variant delta. This preserves the
|
|
48
|
+
approved brief, ICP filters, message setup, rubrics, and campaign-table
|
|
49
|
+
structure so the test differs only by the chosen variable and, if approved, the
|
|
50
|
+
split lead list.
|
|
34
51
|
|
|
35
52
|
## Required Flow
|
|
36
53
|
|
|
37
54
|
1. Decide the source mode:
|
|
38
|
-
- Existing
|
|
55
|
+
- Existing Campaign A: confirm the source campaign ID or resolve it with
|
|
39
56
|
`get_campaign`.
|
|
40
|
-
- Idea-
|
|
41
|
-
|
|
42
|
-
lead-list ID or use `load_csv_linkedin_leads` first.
|
|
57
|
+
- Idea-only request: run the full `$sellable:create-campaign` workflow first,
|
|
58
|
+
then use the created campaign ID as `sourceCampaignId`.
|
|
43
59
|
2. Confirm the A/B variable in plain language. Keep variant B as the explicit
|
|
44
60
|
change and leave variant A as the control unless the user names an A change.
|
|
45
|
-
3.
|
|
61
|
+
3. Inspect Campaign A with `get_campaign` and `get_campaign_context`. Confirm
|
|
62
|
+
the brief exists and includes the approved messaging/template state when the
|
|
63
|
+
campaign has reached message review.
|
|
64
|
+
4. If Campaign A has a clean `selectedLeadListId`, ask the user whether to split
|
|
65
|
+
Campaign A's lead list for this A/B test:
|
|
66
|
+
- Split the lead list: pass that clean list as `sourceLeadListId`.
|
|
67
|
+
- Do not split yet: omit `sourceLeadListId`; Campaign B is a duplicate for
|
|
68
|
+
review and no rows are imported.
|
|
69
|
+
Never silently split a list just because Campaign A has one.
|
|
70
|
+
5. If a source lead list is supplied, verify it is clean. A clean source list is
|
|
46
71
|
a lead-list or signal-lead-list table, not the generated campaign workflow
|
|
47
72
|
table.
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
73
|
+
6. Call `prepare_campaign_ab_test` with `dryRun: true` first.
|
|
74
|
+
7. Review split counts when applicable, campaign names, and variant brief deltas
|
|
75
|
+
with the user.
|
|
76
|
+
8. Only after review, call `prepare_campaign_ab_test` without `dryRun` using the
|
|
52
77
|
same `idempotencyKey` if one was returned or supplied.
|
|
53
|
-
|
|
54
|
-
explicit note that both campaigns are `not_started`.
|
|
78
|
+
9. Return Campaign A, duplicated Campaign B, split lead-list IDs when supplied,
|
|
79
|
+
counts, and the explicit note that both campaigns are `not_started`.
|
|
55
80
|
|
|
56
81
|
## Tool Inputs
|
|
57
82
|
|
|
58
83
|
Use one of these shapes:
|
|
59
84
|
|
|
60
|
-
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
85
|
+
- No split: pass `sourceCampaignId`, `variantName`, `variantBriefDelta`, and
|
|
86
|
+
any optional A-variant fields. The helper treats the source campaign as A and
|
|
87
|
+
duplicates it for B.
|
|
88
|
+
- Approved split: pass `sourceCampaignId`, the approved clean
|
|
89
|
+
`sourceLeadListId`, `variantName`, `variantBriefDelta`, and any optional split
|
|
90
|
+
or A-variant fields. The helper creates deterministic A/B split lead lists and
|
|
91
|
+
review-copy campaigns from Campaign A.
|
|
92
|
+
|
|
93
|
+
Do not pass `campaignName`, `campaignBrief`, `offerPositioning`,
|
|
94
|
+
`clientProspectId`, or `senderLinkedinUrl` to `prepare_campaign_ab_test`.
|
|
95
|
+
Those belong to the full create-campaign workflow that creates Campaign A.
|
|
67
96
|
|
|
68
97
|
## Anti-Patterns
|
|
69
98
|
|
|
@@ -82,18 +111,18 @@ If the source campaign has no clean source lead list, or the source list is
|
|
|
82
111
|
polluted with workflow/output columns, ask for the original CSV or clean source
|
|
83
112
|
list. Use `load_csv_linkedin_leads`; it strips Sellable workflow columns if a
|
|
84
113
|
contaminated CSV is supplied, then creates a clean lead list. If no clean source
|
|
85
|
-
is available,
|
|
114
|
+
is available, omit `sourceLeadListId` and create only the B duplicate for review.
|
|
86
115
|
|
|
87
116
|
## Output Contract
|
|
88
117
|
|
|
89
118
|
Report:
|
|
90
119
|
|
|
91
|
-
- source
|
|
92
|
-
campaign when no source campaign was provided
|
|
120
|
+
- source Campaign A ID
|
|
93
121
|
- source lead-list ID when supplied
|
|
94
122
|
- split strategy and counts when a source lead list was supplied
|
|
95
123
|
- duplicate/skipped lead counts when a source lead list was supplied
|
|
96
|
-
- A review campaign ID
|
|
97
|
-
-
|
|
124
|
+
- Campaign A ID, or A review-copy campaign ID when a split was approved
|
|
125
|
+
- duplicated Campaign B ID
|
|
126
|
+
- split lead-list IDs when supplied
|
|
98
127
|
- variant difference
|
|
99
128
|
- `launchState: not_started` for both campaigns
|