@sellable/mcp 0.1.416 → 0.1.418

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.
@@ -228,12 +228,16 @@ must choose a signal-led, event-led, job-post-led, or proof-led motion from the
228
228
  current brief and row evidence instead of inheriting a preset first-message
229
229
  template.
230
230
  Post-engager first messages should thank the prospect for the support on the
231
- sender-owned post before asking the light relevance question. Prefer the gold
232
- shape `Thanks for the support on my post about {{post_topic_line}}` over
231
+ sender-owned post and then stop. Do not add a relevance question, CTA, product
232
+ line, meeting ask, or extra paragraph after the thank-you opener unless the
233
+ operator explicitly asks for a longer first message. Prefer the gold shape
234
+ `Thanks for the support on my post about {{post_topic_line}}` over
233
235
  surveillance-flavored wording like `saw you pop up`, unless the sender explicitly
234
236
  asks for that older wording.
235
237
  Short form: use the CXConnect Post-Engager Warm Reply-Rate Pattern only when the source is sender-owned Post Engagers.
236
238
  Short form: Never use that warm post-engager pattern for Shared Signal Discovery or Shared Cold Fallback.
239
+ Short form: Post-engager warm first messages stop after the thank-you line.
240
+ Short form: Do not add `curious`, `open to`, `trying to`, product copy, or a CTA after the post-engager thank-you line.
237
241
 
238
242
  ### Shared Cold Fallback quality bar
239
243
 
@@ -245,6 +249,12 @@ must read like final create-campaign/generate-messages output.
245
249
  - Ask one clear buyer problem question.
246
250
  - Keep the product line minimal and buyer-readable; do not turn the note into a
247
251
  product-stack dump.
252
+ - Do not describe Sellable as a process checklist such as "campaign idea into
253
+ prospects, filters, messages, and sequence setup"; that reads like internal
254
+ product plumbing, not a buyer reason to reply.
255
+ - Do not use awkward product-process nouns in reviewed cold samples:
256
+ `sequence-prospects`, `dashboard overhead`, `campaign map`, `send-ready copy`,
257
+ `reviewed prospect lists`, or "one campaign would look like" as a default CTA.
248
258
  - Use no self-intro such as "We're building" or "We're working on a way" in the
249
259
  reviewed samples.
250
260
  - Use no opt-out shrug such as "If this isn't relevant, ignore me."
@@ -252,6 +262,39 @@ must read like final create-campaign/generate-messages output.
252
262
  samples. If two samples would still read the same after replacing names and
253
263
  companies, revise or rerun.
254
264
 
265
+ ### Shared Evergreen Signal Discovery hard gate
266
+
267
+ For Shared Signal Discovery and other shared evergreen lanes, signal-led copy
268
+ must be safer than the legacy weak-signal examples. These lanes are reused by
269
+ multiple senders, so the first line cannot sound like a scraped-activity excuse
270
+ or a founder self-intro.
271
+
272
+ - `hope this is relevant`, `might be interested`, and `saw you in a few conversations` are blocked openers for shared evergreen lanes.
273
+ - do not write first-person singular founder language such as `I'm building`,
274
+ `I've mapped`, `my company`, or `my team` unless exactly one sender can
275
+ credibly say it and the lane is not shared.
276
+ - Do not put internal workflow vocabulary in buyer-facing copy: `Codex`, `MCP`,
277
+ `Claude-style agent workflows`, `agent workflows`, `workflow table`, `lead
278
+ source`, or `signal discovery`.
279
+ - Do not use `Claude`, `Codex`, `MCP`, `agent`, `dashboard`, `workflow`,
280
+ `source`, `sequence`, `send-ready copy`, or `reviewed prospect list` as
281
+ buyer-facing explanation in shared evergreen samples unless the buyer's own
282
+ company/product category uses that exact word and the line still sounds human.
283
+ - Write a concrete signal/problem bridge instead of a relevance hedge. Good
284
+ shapes are `the AI-assisted GTM conversations keep coming back to [buyer
285
+ problem]`, `teams trying to turn LinkedIn signal into pipeline usually hit
286
+ [problem]`, or `when [observable business moment] is live, [buyer workflow]
287
+ gets harder to run consistently`.
288
+ - If the row evidence is too weak to write a concrete bridge, omit the source
289
+ line and start from a buyer problem, event, role, or company observation.
290
+ - Shared evergreen lanes must pass this gate before `confirmed`, before saving a
291
+ reusable template, and before any route-proof approval.
292
+
293
+ Short form: shared evergreen copy cannot use `hope this is relevant`.
294
+ Short form: shared evergreen copy cannot use `might be interested`.
295
+ Short form: shared evergreen copy cannot use `I'm building`.
296
+ Short form: write a concrete signal/problem bridge instead of a relevance hedge.
297
+
255
298
  ### Rich Personalization Contract
256
299
 
257
300
  The `create-campaign` asset `references/ai-native-tokens.md` is the canonical
@@ -269,12 +312,15 @@ conditional good/bad fill reference.
269
312
  - Use this shape for any hook, bridge, or row-specific relevance line:
270
313
  `[PERSONALIZATION_LINE — Intent: write one short sentence that anchors the
271
314
  note to why this might matter now. DO: connect one observable role/company/
272
- activity signal to the buyer problem or offer with low-certainty language like
273
- "hope this is relevant if...", "saw you might be interested in...", "saw you in
274
- a few conversations around...", or "figured this might matter if...". DON'T: recap
275
- their resume, list companies, compliment their background, name a product their
276
- company sells, use source-citation phrasing, or use generic nouns like "your
277
- work".
315
+ activity signal to the buyer problem or offer with a permissioned bridge. For
316
+ shared evergreen lanes, do not use `hope this is relevant`, `might be
317
+ interested`, or `saw you in a few conversations`; use a concrete
318
+ signal/problem bridge instead. For non-evergreen weak-signal campaigns only,
319
+ legacy low-certainty language like "hope this is relevant if..." or "so may be
320
+ off, but this seemed relevant" can be considered when the source is otherwise
321
+ awkward. DON'T: recap their resume, list companies, compliment their
322
+ background, name a product their company sells, use source-citation phrasing, or
323
+ use generic nouns like "your work".
278
324
  FALLBACK: if unsupported, omit the entire line.]`
279
325
  - The rendered personalization line should usually be 6-14 words. If it needs
280
326
  two clauses, multiple companies, or abstract tags like `GTM`, `international
@@ -433,9 +479,9 @@ artifact.**
433
479
 
434
480
  Safer shapes:
435
481
 
436
- - `hope this is relevant if {{signal_topic}} is part of the plan`
437
- - `saw you might be interested in {{signal_topic}}, so hope this is relevant`
438
- - `saw you in a few conversations around {{signal_topic}}, so hope this is relevant`
482
+ - `hope this is relevant if {{signal_topic}} is part of the plan` for non-evergreen weak-signal campaigns only
483
+ - `saw you might be interested in {{signal_topic}}, so hope this is relevant` for non-evergreen weak-signal campaigns only
484
+ - `saw you in a few conversations around {{signal_topic}}, so hope this is relevant` for non-evergreen weak-signal campaigns only
439
485
  - `saw you in a few conversations about {{signal_topic}}, so may be off, but this seemed relevant`
440
486
  - `appreciate you showing some love on my post about {{signal_topic}}` only when the sender/client authored the source post and the row proves a reaction or comment
441
487
  - `thanks for showing support on my {{signal_topic}} post` only when the sender/client authored the source post and the row proves a reaction or comment
@@ -499,20 +545,22 @@ artifact.**
499
545
  magnet replies, or scraped conversations), it is acceptable to reference the
500
546
  conversation when it explains why the note exists. Keep it topic-level, not
501
547
  activity-log-level: `saw you in a few conversations around
502
- {{signal_topic}}, so hope this is relevant` is acceptable; `saw you
503
- commented on {{post_context}}` and `your LinkedIn activity around...` are
504
- not. Reserve `raise your hand` phrasing for explicit lead-magnet comments,
505
- replies, or opt-ins. For ordinary thread discovery, use `saw you in a few
506
- conversations around {{signal_topic}}...` or `found you in a thread about
507
- {{signal_topic}}...`.
548
+ {{signal_topic}}, so hope this is relevant` is acceptable only for
549
+ non-evergreen weak-signal campaigns; it is blocked for Shared Evergreen
550
+ Signal Discovery. `saw you commented on {{post_context}}` and `your LinkedIn
551
+ activity around...` are not acceptable. Reserve `raise your hand` phrasing
552
+ for explicit lead-magnet comments, replies, or opt-ins. For ordinary shared
553
+ evergreen thread discovery, either translate the topic into a concrete
554
+ buyer/problem bridge or omit the source line.
508
555
 
509
556
  Keep the apologetic nature, but aim it at uncertainty, not surveillance.
510
- Good: `saw you in a few conversations about outbound, so may be off, but
511
- this seemed relevant`, `may be off, but if outbound is relevant to what
512
- you're working on...`, `if this is not relevant to your outbound workflow,
513
- ignore me`, `hope
514
- this is relevant if...`. Bad: `your role at {{company}} looked close...`,
515
- because it asserts fit from a title and tells the buyer about themselves.
557
+ Good for non-evergreen weak-signal campaigns: `saw you in a few
558
+ conversations about outbound, so may be off, but this seemed relevant`, `may
559
+ be off, but if outbound is relevant to what you're working on...`, or `hope
560
+ this is relevant if...`. For shared evergreen lanes, these hedges are not
561
+ enough; use a concrete signal/problem bridge or omit the source line. Bad:
562
+ `your role at {{company}} looked close...`, because it asserts fit from a
563
+ title and tells the buyer about themselves.
516
564
 
517
565
  Block wordier source narration such as `you might not remember the thread,
518
566
  but I found you through a {{signal_topic}} discussion and your
@@ -1509,7 +1557,10 @@ Before `confirmed`, run the selected winner against these gates:
1509
1557
  the lead sample. If desire is inferred, use tentative framing like
1510
1558
  `hope this is relevant if...`, `saw you might be interested in...`,
1511
1559
  `saw you in a few conversations around...`, `figured this might matter if...`,
1512
- or `if you've ever wanted...`.
1560
+ or `if you've ever wanted...`. Exception: for Shared Signal Discovery and
1561
+ other shared evergreen lanes, `hope this is relevant`, `might be interested`,
1562
+ and `saw you in a few conversations` are blocked; use a concrete
1563
+ signal/problem bridge or omit the source line.
1513
1564
  - **Buyer-first opener:** after the greeting, the first substantive line
1514
1565
  should usually enter the buyer's world: a real signal, current-state
1515
1566
  pain, buyer-owned priority, or useful artifact. Sender-origin can come
@@ -1810,8 +1861,11 @@ about`, or `clearly relevant` are BLOCKED. Source-y phrases such as
1810
1861
  `saw you might be interested in [topic], so hope this is relevant`, `saw you
1811
1862
  in a few conversations around [topic], so hope this is relevant`, `found you
1812
1863
  in a few conversations about [topic], so may be off, but this seemed
1813
- relevant`, `figured this might matter if [workflow] is live at [company]`, or a similarly natural
1814
- line. Longer source-recap forms such as `you might not remember the thread,
1864
+ relevant`, `figured this might matter if [workflow] is live at [company]`, or
1865
+ a similarly natural line. For shared evergreen lanes, skip the `hope this is
1866
+ relevant` / `might be interested` / `saw you in a few conversations` versions
1867
+ and use the concrete bridge version. Longer source-recap forms such as `you
1868
+ might not remember the thread,
1815
1869
  but I found you through a [topic] discussion...` are BLOCKED; they narrate
1816
1870
  the scrape path instead of creating buyer relevance.
1817
1871
  - **Engagement reference is opt-in, not the default opener:** do not
@@ -1956,9 +2010,9 @@ matters to the buyer, why this might be relevant, or the operator-reality that
1956
2010
  led to it. Acceptable openers:
1957
2011
 
1958
2012
  - `Hey {{first_name}}, [one plain sentence about what we built].`
1959
- - `Hey {{first_name}}, hope this is relevant if [buyer context] is still on your plate.`
1960
- - `Hey {{first_name}}, saw you might be interested in [topic], so hope this is relevant.`
1961
- - `Hey {{first_name}}, saw you in a few conversations around [topic], so hope this is relevant.`
2013
+ - `Hey {{first_name}}, hope this is relevant if [buyer context] is still on your plate.` Not for shared evergreen lanes.
2014
+ - `Hey {{first_name}}, saw you might be interested in [topic], so hope this is relevant.` Not for shared evergreen lanes.
2015
+ - `Hey {{first_name}}, saw you in a few conversations around [topic], so hope this is relevant.` Not for shared evergreen lanes.
1962
2016
  - `Hey {{first_name}}, found you in a thread about [topic], so may be off, but this seemed relevant.`
1963
2017
  - `Hey {{first_name}}, saw you raise your hand for [topic], so figured this was (hopefully) worth sending.` Only use this for explicit lead-magnet comments, replies, or opt-ins.
1964
2018
  - `Hey {{first_name}}, saw you raise your hand for [topic] (creepy to reach out based on that, i know) - but this felt too on the nose to ignore.` Only use this for explicit lead-magnet comments, replies, or opt-ins.
@@ -2219,9 +2273,9 @@ Rules:
2219
2273
  - if `lead-sample.json` carries **any** per-lead signal for this lead — a recent post, a recent hire, a visible tool in the headline, a topic engagement, a public initiative — the **message must reference it specifically**. Category-level copy is rejected.
2220
2274
  - default placement is **Block 3**, not Block 1. Keep Block 1 substance-first unless the archived motion clearly earns a signal-led opener without falling into source-citation / talk-at phrasing.
2221
2275
  - acceptable signal use by default:
2222
- - `"Hope this is relevant if [topic] is part of the plan."`
2223
- - `"Saw you might be interested in [topic], so hope this is relevant."`
2224
- - `"Saw you in a few conversations around [topic], so hope this is relevant."`
2276
+ - `"Hope this is relevant if [topic] is part of the plan."` Non-evergreen weak-signal only; blocked for shared evergreen lanes.
2277
+ - `"Saw you might be interested in [topic], so hope this is relevant."` Non-evergreen weak-signal only; blocked for shared evergreen lanes.
2278
+ - `"Saw you in a few conversations around [topic], so hope this is relevant."` Non-evergreen weak-signal only; blocked for shared evergreen lanes.
2225
2279
  - `"Saw you in a few conversations about [topic], so may be off, but this seemed relevant."`
2226
2280
  - `"Found you in a thread about [topic], so may be off, but this seemed relevant."`
2227
2281
  - `"Thought of {{company}} because [observable signal] points at [problem]."`
@@ -2239,6 +2293,11 @@ Rules:
2239
2293
  - `"Saw you raise your hand for [topic], so figured this was worth sending."`
2240
2294
  - `"Figured this was worth sending."`
2241
2295
  - signal-led opener shape is a **special case**, not the default. Use it only when the archived motion truly depends on it and the line can stay natural. For LinkedIn-post-sourced campaigns, prefer `"saw you in a few conversations around [topic], so hope this is relevant"` or `"found you in a thread about [topic], so may be off, but this seemed relevant"` when referencing the source makes the outreach feel less random. Avoid activity-log phrasing such as `"you commented on..."`, `"you reacted to..."`, or `"your LinkedIn activity..."` unless the approved motion is the deliberately self-aware raise-hand line for an explicit lead-magnet comment, reply, or opt-in.
2296
+ - For Shared Evergreen Signal Discovery, do not use the weak signal-led opener
2297
+ shapes above. Translate the source into a concrete problem bridge, e.g.
2298
+ `"The AI-assisted GTM conversations keep coming back to one problem: turning
2299
+ good LinkedIn signal into review-ready pipeline without another dashboard."`
2300
+ Then connect the product in buyer language.
2242
2301
  - tokenized engagement-source opener shape is BLOCKED by default:
2243
2302
  `{{first_name}}, saw you {{engagement_context}} on {{post_context}}` reads
2244
2303
  like surveillance unless the filled line is explicitly self-aware and
@@ -2247,7 +2306,9 @@ Rules:
2247
2306
  this is relevant`, `saw you in a few conversations around [topic], so hope this
2248
2307
  is relevant`, `saw you in a few conversations about [topic], so may be off,
2249
2308
  but this seemed relevant`, or `found you in a thread about [topic], so may be
2250
- off, but this seemed relevant`. Use the self-aware raise-hand shapes only when
2309
+ off, but this seemed relevant`. For shared evergreen lanes, those weak signal
2310
+ bridges are blocked; use a concrete signal/problem bridge instead. Use the
2311
+ self-aware raise-hand shapes only when
2251
2312
  the source was an explicit lead-magnet comment, reply, or opt-in: `saw you raise
2252
2313
  your hand for [topic], so figured this was (hopefully) worth sending` or `saw you
2253
2314
  raise your hand for [topic] (creepy to reach out based on that, i know) - but
@@ -66,18 +66,14 @@ Accepted invocation flags in the same user request:
66
66
  fresh state reread.
67
67
  - `--sender <name-or-id>`: scope to a specific sender; repeat for multiple
68
68
  senders.
69
- - `--until <YYYY-MM-DD>`: fill through that sender-local date, inclusive,
70
- instead of the default two send-day horizon.
71
69
  - `senderIds: <id>, <id>` or `senderNames: <name>, <name>`: explicit selector
72
70
  alternatives when the host preserves natural-language arguments better than
73
71
  shell-style flags.
74
- - `untilDate: YYYY-MM-DD`: explicit date selector alternative when the host
75
- preserves natural-language arguments better than shell-style flags.
76
72
 
77
73
  When the host can call typed MCP tools, start with:
78
74
 
79
75
  ```text
80
- refill_sends({ yolo?: boolean, senders?: string[], senderIds?: string[], senderNames?: string[], horizonSendDays?: number, untilDate?: "YYYY-MM-DD" })
76
+ refill_sends({ yolo?: boolean, senders?: string[], senderIds?: string[], senderNames?: string[], horizonSendDays?: number })
81
77
  ```
82
78
 
83
79
  That command helper only normalizes arguments and returns the execution
@@ -136,16 +132,13 @@ reassignment, or campaigns outside those selected for the eligible sender set.
136
132
  Stop and re-plan if the route, sender set, ids, caps, blockers, or side-effect
137
133
  class drift before mutation.
138
134
 
139
- In `--yolo`, the default two-day fill horizon is two send days unless
140
- `--until`/`untilDate` is provided. If an until date is provided, compute bounded
141
- gaps through that sender-local date inclusive, skipping no-send days and never
142
- extending beyond that date without a new packet. For each target sender, compute
143
- the bounded gap from that sender's healthy daily capacity, existing future
144
- scheduler-owned scheduled sends, and rows already ready to schedule across
145
- active campaigns enrolled with that sender. Then pick the best same-sender
146
- campaign to fill the gap: prefer recent/future scheduler-owned sends for that
147
- sender, then strongest recent result evidence, then source health. Do not stop
148
- after filling only one sender when the request was sender-scoped. If a
135
+ In `--yolo`, the default two-day fill horizon is two send days. For each target
136
+ sender, compute the bounded gap from that sender's healthy daily capacity,
137
+ existing future scheduler-owned scheduled sends, and rows already ready to
138
+ schedule across active campaigns enrolled with that sender. Then pick the best
139
+ same-sender campaign to fill the gap: prefer recent/future scheduler-owned sends
140
+ for that sender, then strongest recent result evidence, then source health. Do
141
+ not stop after filling only one sender when the request was sender-scoped. If a
149
142
  same-source copy hits the campaign-table row cap, split the current source into
150
143
  a bounded LinkedIn profile source list, confirm only that smaller list into the
151
144
  same campaign, and operate on the copied review batch. Do not fall back to