@sellable/mcp 0.1.156 → 0.1.158
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/dist/tools/leads.js +19 -14
- package/package.json +1 -1
- package/skills/create-campaign/SKILL.md +15 -13
- package/skills/create-campaign-v2/SKILL.md +23 -20
- package/skills/create-campaign-v2/SOUL.md +6 -6
- package/skills/create-campaign-v2/core/flow.v2.json +4 -4
- package/skills/create-campaign-v2/references/filter-leads.md +3 -3
- package/skills/create-campaign-v2-tail/SKILL.md +2 -2
package/dist/tools/leads.js
CHANGED
|
@@ -725,8 +725,8 @@ function buildFilterChoiceWatchNarration({ sourceLeadCount, reviewRowCount, samp
|
|
|
725
725
|
function buildSignalDiscoverySearchWatchNarration() {
|
|
726
726
|
return {
|
|
727
727
|
stage: "find-leads",
|
|
728
|
-
headline: "Searching
|
|
729
|
-
visibleState: "The browser is showing
|
|
728
|
+
headline: "Searching LinkedIn posts",
|
|
729
|
+
visibleState: "The browser is showing the LinkedIn post search step while approved themes run.",
|
|
730
730
|
agentIntent: "Codex is searching the approved post themes and will ask before scraping selected engagers into a source list.",
|
|
731
731
|
nextAction: "Review selected posts before scraping",
|
|
732
732
|
safety: "Scrape approval is the next gate.",
|
|
@@ -734,11 +734,11 @@ function buildSignalDiscoverySearchWatchNarration() {
|
|
|
734
734
|
}
|
|
735
735
|
function buildSignalDiscoveryResultsWatchNarration(postsReturned) {
|
|
736
736
|
const postCopy = typeof postsReturned === "number"
|
|
737
|
-
? `${postsReturned.toLocaleString("en-US")} post${postsReturned === 1 ? "" : "s"} matched the approved search themes and are visible
|
|
738
|
-
: "
|
|
737
|
+
? `${postsReturned.toLocaleString("en-US")} post${postsReturned === 1 ? "" : "s"} matched the approved search themes and are visible for review.`
|
|
738
|
+
: "LinkedIn post results are visible for review.";
|
|
739
739
|
return {
|
|
740
740
|
stage: "find-leads",
|
|
741
|
-
headline: "Review
|
|
741
|
+
headline: "Review LinkedIn posts",
|
|
742
742
|
visibleState: postCopy,
|
|
743
743
|
agentIntent: "Codex is promoting the strongest posts, then it will ask before scraping the selected engager pool.",
|
|
744
744
|
nextAction: "Approve selected posts before scraping",
|
|
@@ -749,9 +749,9 @@ function buildSelectedPostApprovalWatchNarration(selectedPostCount) {
|
|
|
749
749
|
return {
|
|
750
750
|
stage: "find-leads",
|
|
751
751
|
headline: "Approve selected-post scrape",
|
|
752
|
-
visibleState: `${selectedPostCount.toLocaleString("en-US")} LinkedIn post${selectedPostCount === 1 ? "" : "s"} selected
|
|
752
|
+
visibleState: `${selectedPostCount.toLocaleString("en-US")} LinkedIn post${selectedPostCount === 1 ? "" : "s"} selected for the source test.`,
|
|
753
753
|
agentIntent: "Codex is asking before scraping this selected engager pool into a source list.",
|
|
754
|
-
nextAction: `Approve scraping ${selectedPostCount.toLocaleString("en-US")}
|
|
754
|
+
nextAction: `Approve scraping ${selectedPostCount.toLocaleString("en-US")} selected LinkedIn post${selectedPostCount === 1 ? "" : "s"}`,
|
|
755
755
|
safety: "Scrape approval is the next gate.",
|
|
756
756
|
};
|
|
757
757
|
}
|
|
@@ -775,12 +775,12 @@ function buildSignalDiscoverySourceRecommendation({ selectedPosts, }) {
|
|
|
775
775
|
const estimatedGoodFit = totalEngagement * defaultFitRate;
|
|
776
776
|
return `## Source Recommendation
|
|
777
777
|
|
|
778
|
-
Use
|
|
778
|
+
Use LinkedIn engagement first.
|
|
779
779
|
|
|
780
|
-
**Goal:** ~${targetGoodFitLeads.toLocaleString("en-US")} headline-fit prospects
|
|
780
|
+
**Goal:** ~${targetGoodFitLeads.toLocaleString("en-US")} headline-fit prospects from relevant LinkedIn engagement<br>
|
|
781
781
|
**Working assumption:** ~${Math.round(defaultFitRate * 100)}% of raw post engagers pass headline filtering unless a real sample supports a different rate<br>
|
|
782
782
|
**Engagers needed:** ~${sourceCandidateTarget.toLocaleString("en-US")} raw engagers<br>
|
|
783
|
-
**Planning floor:** continue with
|
|
783
|
+
**Planning floor:** continue with LinkedIn engagement only when sampled/projected headline-fit rate is at least ${Math.round(minPlanningFitRate * 100)}%; below that, switch to Sales Nav recent activity<br>
|
|
784
784
|
**Review checkpoint:** copy the confirmed source list into the campaign, then process the first ${reviewBatchSize.toLocaleString("en-US")} leads for fit and message review before scaling
|
|
785
785
|
|
|
786
786
|
### Selected posts
|
|
@@ -804,7 +804,7 @@ This gives enough volume to target ~${targetGoodFitLeads.toLocaleString("en-US")
|
|
|
804
804
|
|
|
805
805
|
Approval card should say:
|
|
806
806
|
|
|
807
|
-
**Approve scraping ${selectedCount}
|
|
807
|
+
**Approve scraping ${selectedCount} selected LinkedIn post${selectedCount === 1 ? "" : "s"}?**`;
|
|
808
808
|
}
|
|
809
809
|
function normalizeImportProvider(provider) {
|
|
810
810
|
if (provider === "apollo-ai" || provider === "apollo")
|
|
@@ -2324,11 +2324,16 @@ export async function importLeads(input) {
|
|
|
2324
2324
|
const sourcingSteps = new Set([
|
|
2325
2325
|
null,
|
|
2326
2326
|
"pick-provider",
|
|
2327
|
+
"contact-search",
|
|
2327
2328
|
"apollo",
|
|
2329
|
+
"apollo-select-leads",
|
|
2328
2330
|
"sales-nav",
|
|
2331
|
+
"sales-nav-select-leads",
|
|
2329
2332
|
"prospeo",
|
|
2333
|
+
"prospeo-select-leads",
|
|
2330
2334
|
"signal-discovery",
|
|
2331
2335
|
"signal-discovery-results",
|
|
2336
|
+
"leads",
|
|
2332
2337
|
]);
|
|
2333
2338
|
const shouldDefaultStep = currentStep === undefined && sourcingSteps.has(campaignCurrentStep ?? null);
|
|
2334
2339
|
const effectiveCurrentStep = shouldDefaultStep
|
|
@@ -3089,15 +3094,15 @@ export async function selectPromisingPosts(input) {
|
|
|
3089
3094
|
const { reviewBatchSize } = getSignalDiscoverySourcePlanDefaults();
|
|
3090
3095
|
sourceRecommendation = `## Source Recommendation
|
|
3091
3096
|
|
|
3092
|
-
Use
|
|
3097
|
+
Use LinkedIn engagement first.
|
|
3093
3098
|
|
|
3094
|
-
**Recommendation:** approve scraping the ${selectionResult.selectedCount} selected
|
|
3099
|
+
**Recommendation:** approve scraping the ${selectionResult.selectedCount} selected LinkedIn post${selectionResult.selectedCount === 1 ? "" : "s"}.
|
|
3095
3100
|
|
|
3096
3101
|
**First pass:** build the source list, copy it into the campaign, then process only the first ${reviewBatchSize.toLocaleString("en-US")} leads so we can inspect quality before scaling.
|
|
3097
3102
|
|
|
3098
3103
|
Approval card should say:
|
|
3099
3104
|
|
|
3100
|
-
**Approve scraping ${selectionResult.selectedCount}
|
|
3105
|
+
**Approve scraping ${selectionResult.selectedCount} selected LinkedIn post${selectionResult.selectedCount === 1 ? "" : "s"}?**`;
|
|
3101
3106
|
}
|
|
3102
3107
|
return {
|
|
3103
3108
|
success: true,
|
package/package.json
CHANGED
|
@@ -139,10 +139,12 @@ should say:
|
|
|
139
139
|
- what approval covers in one concise line
|
|
140
140
|
|
|
141
141
|
Do not surface blanket source heuristics as product copy. Make the
|
|
142
|
-
recommendation specific to the campaign. If
|
|
143
|
-
name the exact post themes you will search
|
|
144
|
-
|
|
145
|
-
|
|
142
|
+
recommendation specific to the campaign. If LinkedIn engagement is recommended,
|
|
143
|
+
name the exact post themes you will search and avoid using "Signal Discovery" in
|
|
144
|
+
customer-facing chat; that is the internal provider/app label. If relevant
|
|
145
|
+
public conversations look unlikely, recommend the specific Sales Nav or Prospeo
|
|
146
|
+
lane instead and say why. Do not call `search_signals`, `search_sales_nav`,
|
|
147
|
+
`search_prospeo`,
|
|
146
148
|
`fetch_post_engagers`, or provider-scoped subagents until the user approves this
|
|
147
149
|
source plan or explicitly chooses a different source.
|
|
148
150
|
|
|
@@ -161,10 +163,11 @@ precision, and referral paths, but it does not provide hiring-by-role filters;
|
|
|
161
163
|
say that distinction plainly in the source-plan gate.
|
|
162
164
|
|
|
163
165
|
After scouting, ask for a second approval on the concrete source action. For
|
|
164
|
-
|
|
165
|
-
target engager/source-candidate volume. For
|
|
166
|
-
specific approved import lane and source lead
|
|
167
|
-
15-row campaign-table execution slice separate from
|
|
166
|
+
LinkedIn engagement (`signal-discovery` internally), name how many selected
|
|
167
|
+
posts will be scraped and the target engager/source-candidate volume. For
|
|
168
|
+
Sales Nav or Prospeo, name the specific approved import lane and source lead
|
|
169
|
+
count. Keep the internal 15-row campaign-table execution slice separate from
|
|
170
|
+
source sampling.
|
|
168
171
|
|
|
169
172
|
Do not call `import_leads` or `confirm_lead_list` until this second approval is
|
|
170
173
|
granted.
|
|
@@ -181,16 +184,15 @@ granted.
|
|
|
181
184
|
should `confirm_lead_list({ reviewBatchLimit: 15 })` copy confirmed rows into
|
|
182
185
|
the campaign table and return the initial campaign-table execution slice rows.
|
|
183
186
|
|
|
184
|
-
For
|
|
185
|
-
action shape "Approve scraping N
|
|
187
|
+
For LinkedIn engagement, the customer-facing approval card must use the exact
|
|
188
|
+
action shape "Approve scraping N selected LinkedIn posts?" and the chat summary
|
|
186
189
|
should be a compact `## Source Recommendation` block with:
|
|
187
190
|
|
|
188
|
-
- goal: about 300 headline-fit prospects
|
|
189
|
-
headline criteria for now
|
|
191
|
+
- goal: about 300 headline-fit prospects from relevant LinkedIn engagement
|
|
190
192
|
- source-candidate plan: use sample math first: target headline-fit prospects
|
|
191
193
|
divided by sampled headline-pass rate. If there is no stronger sample, use
|
|
192
194
|
about 1,500 raw engagers from the 20% working headline-pass assumption.
|
|
193
|
-
- planning floor: continue with
|
|
195
|
+
- planning floor: continue with LinkedIn engagement only when sampled/projected
|
|
194
196
|
headline-fit rate is at least 10%; below that, move to Sales Nav recent
|
|
195
197
|
activity instead of scraping noisy engagers. Do not use the 10% floor as the
|
|
196
198
|
scrape-count denominator when the actual sample rate is higher.
|
|
@@ -133,7 +133,7 @@ copy.
|
|
|
133
133
|
|
|
134
134
|
Default source order when the user has not supplied a source:
|
|
135
135
|
|
|
136
|
-
1. LinkedIn post engagement
|
|
136
|
+
1. LinkedIn post engagement (internal provider: `signal-discovery`)
|
|
137
137
|
2. Sales Nav recent activity
|
|
138
138
|
3. broader Sales Nav role/title filters
|
|
139
139
|
4. Prospeo account/contact expansion
|
|
@@ -160,12 +160,14 @@ the question, and this first approval authorizes source scouting/search only:
|
|
|
160
160
|
- that approval authorizes scouting/search only, not lead import or sending
|
|
161
161
|
|
|
162
162
|
Do not surface blanket source heuristics as product copy. Make the recommendation
|
|
163
|
-
specific to the campaign. If
|
|
164
|
-
post themes you will search
|
|
165
|
-
|
|
166
|
-
|
|
167
|
-
|
|
168
|
-
|
|
163
|
+
specific to the campaign. If LinkedIn engagement is recommended, name the exact
|
|
164
|
+
post themes you will search and avoid using "Signal Discovery" in
|
|
165
|
+
customer-facing chat; that is the internal provider/app label. If the campaign
|
|
166
|
+
looks unlikely to have relevant public conversations, recommend the specific
|
|
167
|
+
Sales Nav or Prospeo lane instead and say why. An approval like "Approve Prospeo
|
|
168
|
+
plan" satisfies this gate; persist the provider and search next. Do not ask a
|
|
169
|
+
second source-plan question. Do not call `search_signals`, `search_sales_nav`,
|
|
170
|
+
`search_prospeo`,
|
|
169
171
|
`fetch_post_engagers`, or provider-scoped subagents until the user approves this
|
|
170
172
|
source plan or explicitly chooses a different source.
|
|
171
173
|
|
|
@@ -174,18 +176,19 @@ sequential by default. Run `source-scout-linkedin-engagement`,
|
|
|
174
176
|
`source-scout-sales-nav`, and `source-scout-prospeo-contact` in parallel only
|
|
175
177
|
when the user explicitly requested source comparison, a prior lane failed, or
|
|
176
178
|
the first viable lane is borderline and a cheap fallback check is needed.
|
|
177
|
-
Use a 10% planning floor after conservative cleanup. If
|
|
178
|
-
below that floor, move to Sales Nav. If Sales Nav falls below that floor
|
|
179
|
-
reasonable refinement, move to Prospeo. Prospeo is the terminal fallback;
|
|
180
|
-
also falls below 10%, tighten the ICP/source direction instead of
|
|
181
|
-
another provider.
|
|
179
|
+
Use a 10% planning floor after conservative cleanup. If LinkedIn engagement
|
|
180
|
+
falls below that floor, move to Sales Nav. If Sales Nav falls below that floor
|
|
181
|
+
after reasonable refinement, move to Prospeo. Prospeo is the terminal fallback;
|
|
182
|
+
if it also falls below 10%, tighten the ICP/source direction instead of
|
|
183
|
+
inventing another provider.
|
|
182
184
|
|
|
183
185
|
After scouting, show a second approval gate for the concrete source action.
|
|
184
|
-
For
|
|
185
|
-
volume, internal campaign-table
|
|
186
|
-
|
|
187
|
-
|
|
188
|
-
not call `import_leads` or
|
|
186
|
+
For LinkedIn engagement (`signal-discovery` internally), state selected-post
|
|
187
|
+
count, target engager/source-candidate volume, internal campaign-table
|
|
188
|
+
execution-slice size, cleanup risk, and fallback; label the approval like
|
|
189
|
+
"Approve scraping 3 selected LinkedIn posts?" For Sales Nav or Prospeo, name the
|
|
190
|
+
specific search/import lane and source lead count. Do not call `import_leads` or
|
|
191
|
+
`confirm_lead_list` until this gate is approved.
|
|
189
192
|
|
|
190
193
|
For Sales Nav and Prospeo, do not ask to import only the internal 15-row
|
|
191
194
|
campaign-table execution slice at the source-action gate. First-page samples are
|
|
@@ -205,15 +208,15 @@ export count, not the campaign execution-slice size. For Signal Discovery, pass
|
|
|
205
208
|
`confirmed: true`; the tool owns moving the watch UI to source-list progress
|
|
206
209
|
after a lead-list/job id exists.
|
|
207
210
|
|
|
208
|
-
For
|
|
211
|
+
For LinkedIn engagement, use this compact source-action approval shape after
|
|
209
212
|
selected posts exist:
|
|
210
213
|
|
|
211
214
|
```markdown
|
|
212
215
|
## Source Recommendation
|
|
213
216
|
|
|
214
|
-
Use
|
|
217
|
+
Use LinkedIn engagement first.
|
|
215
218
|
|
|
216
|
-
**Goal:** ~300 headline-fit prospects
|
|
219
|
+
**Goal:** ~300 headline-fit prospects from relevant LinkedIn engagement<br>
|
|
217
220
|
**Working assumption:** ~20% of raw post engagers pass headline filtering unless a real sample supports a different rate<br>
|
|
218
221
|
**Engagers needed:** ~1,500 raw engagers<br>
|
|
219
222
|
**Planning floor:** continue only when sampled/projected headline-fit rate is at least 10%; below that, switch to Sales Nav recent activity<br>
|
|
@@ -239,12 +239,12 @@ source. That approval only authorizes scouting/search. Second, after the
|
|
|
239
239
|
source evidence exists, show counts, samples, fit math, cleanup risk, and ask
|
|
240
240
|
for source approval before import.
|
|
241
241
|
|
|
242
|
-
For
|
|
242
|
+
For LinkedIn engagement, the second gate is not "approve source" in the abstract.
|
|
243
243
|
It is a concrete scrape approval: show a compact `## Source Recommendation`
|
|
244
|
-
with the ~
|
|
245
|
-
table, total visible pool, estimated
|
|
244
|
+
with the ~300 headline-fit prospect goal, source sample assumption, selected-post
|
|
245
|
+
table, total visible pool, estimated headline-fit pool, 10% planning floor,
|
|
246
246
|
first-pass campaign setup, and fallback. The approval question should be "Approve
|
|
247
|
-
scraping N
|
|
247
|
+
scraping N selected LinkedIn posts?"
|
|
248
248
|
|
|
249
249
|
That scrape approval is single-use. Once the user approves it, do not replay
|
|
250
250
|
the source card or ask for the same approval again. Acknowledge the approval in
|
|
@@ -254,13 +254,13 @@ one sentence and call `import_leads` for the approved source immediately.
|
|
|
254
254
|
|
|
255
255
|
Source selection is sequential by default. Start with the first recommended
|
|
256
256
|
source lane from `flow.v2.json`; for the current campaign shape that is usually
|
|
257
|
-
|
|
257
|
+
LinkedIn engagement. Only try the next fallback after the
|
|
258
258
|
current lane is not viable, the user asks for a comparison, or the first lane is
|
|
259
259
|
borderline and needs a second source to avoid a bad recommendation. The fallback
|
|
260
260
|
order must stay plain: use Sales Nav to find ICP people who are actively posting
|
|
261
261
|
on LinkedIn; if that is not enough, search Sales Nav by titles; if that is still
|
|
262
262
|
not enough, use Prospeo for a broader account/contact path.
|
|
263
|
-
Use a 10% planning floor after conservative cleanup. If
|
|
263
|
+
Use a 10% planning floor after conservative cleanup. If LinkedIn engagement falls
|
|
264
264
|
below that floor, move to Sales Nav. If Sales Nav falls below that floor after
|
|
265
265
|
reasonable refinement, move to Prospeo. Prospeo is the terminal fallback; if it
|
|
266
266
|
also falls below 10%, tighten the ICP/source direction instead of inventing
|
|
@@ -399,14 +399,14 @@
|
|
|
399
399
|
"what approval authorizes"
|
|
400
400
|
],
|
|
401
401
|
"choices": [
|
|
402
|
-
"Approve
|
|
402
|
+
"Approve LinkedIn engagement scouting plan",
|
|
403
403
|
"Approve Sales Nav scouting plan",
|
|
404
404
|
"Approve Prospeo scouting plan",
|
|
405
405
|
"Choose different source",
|
|
406
406
|
"Pause here"
|
|
407
407
|
],
|
|
408
408
|
"approvalChoiceLabelsByProvider": {
|
|
409
|
-
"signal-discovery": "Approve
|
|
409
|
+
"signal-discovery": "Approve LinkedIn engagement scouting plan",
|
|
410
410
|
"sales-nav": "Approve Sales Nav scouting plan",
|
|
411
411
|
"prospeo": "Approve Prospeo scouting plan"
|
|
412
412
|
},
|
|
@@ -508,13 +508,13 @@
|
|
|
508
508
|
"action": "ask_source_review_choice",
|
|
509
509
|
"uses": "request_user_input",
|
|
510
510
|
"choices": [
|
|
511
|
-
"Approve scraping N
|
|
511
|
+
"Approve scraping N selected LinkedIn posts",
|
|
512
512
|
"Run the approved source import",
|
|
513
513
|
"Revise source",
|
|
514
514
|
"Pause here"
|
|
515
515
|
],
|
|
516
516
|
"approvalChoiceLabelsByProvider": {
|
|
517
|
-
"signal-discovery": "Approve scraping {selectedPostCount}
|
|
517
|
+
"signal-discovery": "Approve scraping {selectedPostCount} selected LinkedIn posts?",
|
|
518
518
|
"sales-nav": "Import the approved Sales Nav source list",
|
|
519
519
|
"prospeo": "Import the approved Prospeo source list"
|
|
520
520
|
},
|
|
@@ -152,9 +152,9 @@ Use this test:
|
|
|
152
152
|
- Did the campaign rows show adjacent companies that the customer would likely
|
|
153
153
|
reject only after seeing the list?
|
|
154
154
|
|
|
155
|
-
If yes, add an explicit exclude rule. Include named competitors
|
|
156
|
-
campaign rows, or user context when available, plus the general
|
|
157
|
-
exclusion so new lookalike competitors are also blocked.
|
|
155
|
+
If yes, add an explicit exclude rule. Use the review batch as evidence. Include named competitors
|
|
156
|
+
from the brief, campaign rows, or user context when available, plus the general
|
|
157
|
+
category exclusion so new lookalike competitors are also blocked.
|
|
158
158
|
|
|
159
159
|
## Marketplace Safety
|
|
160
160
|
|
|
@@ -236,14 +236,14 @@ campaignOfferId, confirmed: true })` -> `search_signals({ campaignOfferId,
|
|
|
236
236
|
selectionMode: "replace", selections, headlineICPCriteria })` ->
|
|
237
237
|
`import_leads({ campaignOfferId, provider: "signal-discovery",
|
|
238
238
|
targetEngagerCount: 1500 })`.
|
|
239
|
-
For
|
|
239
|
+
For LinkedIn engagement (`signal-discovery` internally), the promotion/select step is load-bearing. Use
|
|
240
240
|
post IDs from the current campaign-scoped `search_signals` response or
|
|
241
241
|
posts the user has visibly promoted in the campaign UI. Never use post IDs
|
|
242
242
|
copied only from a source-scout summary unless they have been re-resolved
|
|
243
243
|
through the current campaign search state. After `select_promising_posts`,
|
|
244
244
|
require `selectedCount > 0` before calling `import_leads`. If it returns
|
|
245
245
|
`selectedCount: 0`, do not switch providers and do not retry import.
|
|
246
|
-
Explain that the campaign has no promoted
|
|
246
|
+
Explain that the campaign has no promoted LinkedIn posts yet,
|
|
247
247
|
re-run a narrow campaign-scoped `search_signals` call to recover current
|
|
248
248
|
post rows, or ask the user to promote the desired posts in the UI and then
|
|
249
249
|
retry `import_leads`.
|