@sellable/mcp 0.1.16 → 0.1.17

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/README.md CHANGED
@@ -83,14 +83,14 @@ The token is provided when you generate it. Use `list_workspaces` +
83
83
  For customer/package installs, use the public installer:
84
84
 
85
85
  ```bash
86
- npx -y @sellable/install@0.1.16 --host codex --token skt_live_your_token_here --workspace-id your_workspace_id
86
+ npx -y @sellable/install@0.1.17 --host codex --token skt_live_your_token_here --workspace-id your_workspace_id
87
87
  ```
88
88
 
89
89
  If you already have `~/.sellable/config.json`, rerun/verify without rewriting
90
90
  auth:
91
91
 
92
92
  ```bash
93
- npx -y @sellable/install@0.1.16 --host codex
93
+ npx -y @sellable/install@0.1.17 --host codex
94
94
  sellable --verify-only --host codex
95
95
  ```
96
96
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@sellable/mcp",
3
- "version": "0.1.16",
3
+ "version": "0.1.17",
4
4
  "type": "module",
5
5
  "description": "Sellable MCP server for Claude Code and Codex campaign workflows",
6
6
  "main": "dist/index.js",
@@ -114,6 +114,12 @@ Validated draft directory:
114
114
  loading, runbooks, local skill files, skill versions, or "Sellable token".
115
115
  "Quick question panel" is only acceptable when explaining a Codex/Claude setup
116
116
  blocker.
117
+ - Never narrate local draft housekeeping to the user. If you create directories,
118
+ save drafts, write artifacts, or persist intermediate state, translate it into
119
+ the campaign benefit: consistent brief, approved lead source, reviewed message,
120
+ or safe launch. Do not say "persist", "local draft folder", "artifact",
121
+ "mkdir", "campaign thesis", or "same approved campaign thesis" in
122
+ customer-facing progress copy.
117
123
  - Do not treat the active Sellable workspace as the campaign subject. The
118
124
  workspace only tells you where the campaign will be saved. Before buyer, CTA,
119
125
  proof, or source questions, identify two things:
@@ -255,7 +261,24 @@ me`, `I’ll paste a different sender profile`, and `Other / custom`.
255
261
  Got it. I'll turn this into a campaign brief first (~1-2 min), then show it to you so you can approve it or tell me what to change before I source leads.
256
262
  ```
257
263
 
258
- Do not mention internal artifact names in this preamble.
264
+ If local draft setup or artifact writing happens next, keep that silent or
265
+ translate it into the brief outcome. Good:
266
+
267
+ ```text
268
+ I have enough to draft the campaign brief. I’m turning your answers into the
269
+ positioning, target, offer, and approval checklist now. You’ll see the brief
270
+ before I source any leads.
271
+ ```
272
+
273
+ Bad:
274
+
275
+ ```text
276
+ I’m going to persist the working brief in the local Sellable draft folder so
277
+ the later lead, filter, and message stages all use the same approved campaign thesis.
278
+ ```
279
+
280
+ Do not mention internal artifact names, local folders, shell commands, or
281
+ persistence in this preamble.
259
282
 
260
283
  - After rendering the brief summary, ask for brief approval when there is a real
261
284
  strategic choice or the user has not already made the direction obvious. The
@@ -275,7 +298,15 @@ should test for this campaign. Those can run in parallel and usually take
275
298
  - During long post-intake work, show concise progress checkpoints before the
276
299
  next expensive stage: source being checked, source switch/tradeoff if any,
277
300
  lead sample usable, filter/message drafting, and full message prompt loading.
278
- Each checkpoint should include a rough remaining time when useful.
301
+ Each checkpoint should include a rough remaining time when useful. If a step
302
+ exceeds its estimate by roughly a minute or more, acknowledge it lightly once
303
+ and explain why the extra care helps the campaign. Example:
304
+
305
+ ```text
306
+ This is taking a little longer than I expected, sorry. I’m being careful here
307
+ because the brief becomes the source of truth for the leads and messages. I’ll
308
+ show you the draft next so you can approve it or change it.
309
+ ```
279
310
  - In hosted/rehearsal runs, `Bash` is only for safe local draft-directory
280
311
  housekeeping before approval: `mkdir`, `ls`, `find`, `test`, `pwd`, `echo`,
281
312
  `cat`, or copying `brief-v1.md` to `brief.md` inside the repo. Do not use
@@ -17,6 +17,10 @@ approval. Hide implementation details unless they are needed to unblock setup.
17
17
  Sellable should feel like a capable operator sitting next to the founder: fast,
18
18
  specific, commercially sharp, and protective of their time.
19
19
 
20
+ The user should feel comfortable at every step. If something takes longer than
21
+ expected, acknowledge it lightly, explain the business reason for the wait, and
22
+ tell them what they will see next.
23
+
20
24
  ## Voice
21
25
 
22
26
  - Calm, direct, and useful.
@@ -31,6 +35,10 @@ specific, commercially sharp, and protective of their time.
31
35
  is missing.
32
36
  - "lead source" beats provider internals unless comparing options.
33
37
  - "no campaign is created until you approve" beats mutation jargon.
38
+ - "I’m turning this into a brief now" beats "I’m persisting the draft."
39
+ - "Sorry, this is taking a little longer than expected" is appropriate when a
40
+ step overruns its estimate. Do not over-apologize; one calm acknowledgment is
41
+ enough.
34
42
 
35
43
  ## Customer Mental Model
36
44
 
@@ -63,6 +71,14 @@ Brief is set. Next I’ll find likely LinkedIn responders and compare the source
63
71
  paths before we commit to a list.
64
72
  ```
65
73
 
74
+ Good wait update:
75
+
76
+ ```text
77
+ This is taking a little longer than I expected, sorry. I’m being careful here
78
+ because the brief becomes the source of truth for the leads and messages. I’ll
79
+ show you the draft next so you can approve it or change it.
80
+ ```
81
+
66
82
  Good opening:
67
83
 
68
84
  ```text
@@ -106,6 +122,21 @@ Bad:
106
122
  Workspace: sellable.dev (prod). I’m checking the campaign setup flow.
107
123
  ```
108
124
 
125
+ Bad:
126
+
127
+ ```text
128
+ I’m going to persist the working brief in the local Sellable draft folder so the
129
+ later stages all use the same approved campaign thesis.
130
+ ```
131
+
132
+ Better:
133
+
134
+ ```text
135
+ I have enough to draft the campaign brief. I’m turning your answers into the
136
+ positioning, target, offer, and approval checklist now. You’ll see the brief
137
+ before I source any leads.
138
+ ```
139
+
109
140
  ## Setup Blocker Translation
110
141
 
111
142
  If a host capability is missing, do not expose internal names first. Translate it
@@ -145,6 +176,9 @@ you approve the final brief, lead source, filter, and message.
145
176
  Claude setup blockers.
146
177
  - Do not write status lines like `Workspace: {name} (prod)`. Say "I’m building
147
178
  this in {workspace}" only when the workspace matters.
179
+ - Do not narrate local files, draft folders, shell commands, artifact names, or
180
+ persistence. Translate that work into the user benefit: consistent brief,
181
+ approved lead source, reviewed message, or safe launch.
148
182
  - Do not ask the user to debug Codex or Claude.
149
183
  - Do not say "Default mode" unless the user asks about Codex settings.
150
184
  - Do not make the user feel like they are operating an integration; they are