@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.
@@ -725,8 +725,8 @@ function buildFilterChoiceWatchNarration({ sourceLeadCount, reviewRowCount, samp
725
725
  function buildSignalDiscoverySearchWatchNarration() {
726
726
  return {
727
727
  stage: "find-leads",
728
- headline: "Searching Signal Discovery",
729
- visibleState: "The browser is showing Signal Discovery while LinkedIn post searches run.",
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 in Signal Discovery.`
738
- : "Signal Discovery results are visible for review.";
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 Signal Discovery posts",
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 in Signal Discovery.`,
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")} Signal Discovery post${selectedPostCount === 1 ? "" : "s"}`,
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 Signal Discovery first.
778
+ Use LinkedIn engagement first.
779
779
 
780
- **Goal:** ~${targetGoodFitLeads.toLocaleString("en-US")} headline-fit prospects that pass the Signal Discovery headline criteria<br>
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 Signal Discovery only when sampled/projected headline-fit rate is at least ${Math.round(minPlanningFitRate * 100)}%; below that, switch to Sales Nav recent activity<br>
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} Signal Discovery post${selectedCount === 1 ? "" : "s"}?**`;
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 Signal Discovery first.
3097
+ Use LinkedIn engagement first.
3093
3098
 
3094
- **Recommendation:** approve scraping the ${selectionResult.selectedCount} selected Signal Discovery post${selectionResult.selectedCount === 1 ? "" : "s"}.
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} Signal Discovery post${selectionResult.selectedCount === 1 ? "" : "s"}?**`;
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
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@sellable/mcp",
3
- "version": "0.1.156",
3
+ "version": "0.1.158",
4
4
  "type": "module",
5
5
  "description": "Sellable MCP server for Claude Code and Codex campaign workflows",
6
6
  "main": "dist/index.js",
@@ -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 Signal Discovery is recommended,
143
- name the exact post themes you will search. If relevant public conversations
144
- look unlikely, recommend the specific Sales Nav or Prospeo lane instead and say
145
- why. Do not call `search_signals`, `search_sales_nav`, `search_prospeo`,
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
- Signal Discovery, name how many selected posts will be scraped and the
165
- target engager/source-candidate volume. For Sales Nav or Prospeo, name the
166
- specific approved import lane and source lead count. Keep the internal
167
- 15-row campaign-table execution slice separate from source sampling.
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 Signal Discovery, the customer-facing approval card must use the exact
185
- action shape "Approve scraping N Signal Discovery posts?" and the chat summary
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 that pass the Signal Discovery
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 Signal Discovery only when sampled/projected
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 / Signal Discovery
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 Signal Discovery is recommended, name the exact
164
- post themes you will search. If the campaign looks unlikely to have relevant
165
- public conversations, recommend the specific Sales Nav or Prospeo lane instead
166
- and say why. An approval like "Approve Prospeo plan" satisfies this gate; persist
167
- the provider and search next. Do not ask a second source-plan question. Do not
168
- call `search_signals`, `search_sales_nav`, `search_prospeo`,
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 Signal Discovery falls
178
- below that floor, move to Sales Nav. If Sales Nav falls below that floor after
179
- reasonable refinement, move to Prospeo. Prospeo is the terminal fallback; if it
180
- also falls below 10%, tighten the ICP/source direction instead of inventing
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 Signal Discovery, state selected-post count, target engager/source-candidate
185
- volume, internal campaign-table execution-slice size, cleanup risk, and fallback;
186
- label the approval like "Approve scraping 3 Signal Discovery posts?" For Sales
187
- Nav or Prospeo, name the specific search/import lane and source lead count. Do
188
- not call `import_leads` or `confirm_lead_list` until this gate is approved.
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 Signal Discovery, use this compact source-action approval shape after
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 Signal Discovery first.
217
+ Use LinkedIn engagement first.
215
218
 
216
- **Goal:** ~300 headline-fit prospects that pass the Signal Discovery headline criteria<br>
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 Signal Discovery, the second gate is not "approve source" in the abstract.
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 ~150 good-fit prospect goal, 15% raw-engager assumption, selected-post
245
- table, total visible pool, estimated good-fit pool, 10% planning floor,
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 Signal Discovery posts?"
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
- Signal Discovery / LinkedIn engagement. Only try the next fallback after the
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 Signal Discovery falls
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 Signal Discovery scouting plan",
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 Signal Discovery scouting plan",
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 Signal Discovery posts",
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} Signal Discovery posts?",
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 from the brief,
156
- campaign rows, or user context when available, plus the general category
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 Signal Discovery, the promotion/select step is load-bearing. Use
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 Signal Discovery posts yet,
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`.