@sellable/mcp 0.1.406 → 0.1.408

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.
@@ -14,33 +14,6 @@ producing duplicates. This skill never launches campaigns; customer-visible
14
14
  completion stops at paused send review.
15
15
  </role>
16
16
 
17
- ## Operational Fast Path
18
-
19
- In automation or `--yolo` customer-visible setup, use this path before the
20
- long-form contract below:
21
-
22
- 1. Resolve the active workspace and explicit sender scopes, then call
23
- `setup_evergreen_campaigns({ mode:"plan", yolo:true, postEngagerSenderIds,
24
- sharedSenderIds })`.
25
- 2. If the plan is not current, lacks lane packets, or has
26
- `autoExecutable:false`, return the exact blocker before mutation.
27
- 3. Choose the worker runtime immediately. When running under Codex CLI or on VPS,
28
- the local Codex CLI fallback is the default accepted runtime. Use visible
29
- Codex app threads only when the callable thread tools are actually available.
30
- If shell execution is unavailable and no visible/durable thread surface is
31
- callable, return `blocked: missing_visible_or_durable_lane_worker_runtime`
32
- before mutation.
33
- 4. Write one compact prompt file per selected lane packet, create the receipt
34
- directory, and launch all lane workers in parallel with the literal Codex CLI
35
- worker command shape below. The parent does not create campaign shells.
36
- 5. Collect fresh durable receipts, verify with the original planRevision and
37
- selectedActionIds, then run the idempotency plan and show sample messages.
38
-
39
- Do not keep reasoning, re-reading prompts, or restating this workflow instead of
40
- dispatching workers. If the first worker cannot be launched after at most one
41
- short planning pass, return `blocked: worker_dispatch_deadline_exceeded` before
42
- directory setup or product mutation.
43
-
44
17
  <inputs>
45
18
  The invoking prompt names the senders ("create evergreen campaigns for csreyes92 and thomas"). Resolve each via `list_senders`.
46
19
 
@@ -85,22 +58,6 @@ Default evergreen plan per workspace (override only if the prompt specifies diff
85
58
  1. **`<Sender Name> - Post Engagers`** — one per sender (warm lane, highest priority)
86
59
  2. **`<Workspace/Team> - Shared Signal Discovery`** — one shared warm-signal campaign lane across senders
87
60
  3. **`<Workspace/Team> - Shared Cold Fallback`** — one shared cold/fallback campaign lane across senders
88
-
89
- Sender scope resolution is safety-critical. Do not pass
90
- `allConnectedSenders:true` unless the invoking prompt explicitly says "all
91
- connected senders", "every connected sender", "all seats", or names an
92
- equivalent all-sender scope. If the user says "all 4 campaigns", "the four
93
- evergreen campaigns", or names specific senders, resolve those exact senders
94
- and pass explicit `postEngagerSenderIds` plus `sharedSenderIds`; do not broaden
95
- the plan to every connected sender. In non-interactive or `--yolo` mode, when
96
- more than two connected senders exist and the prompt does not explicitly
97
- authorize all connected senders, stop before mutation with
98
- `blocked: ambiguous_post_engager_sender_scope` and report the sender ids/names
99
- needed for approval. Never let "workspace default" silently create Post
100
- Engagers lanes for extra senders.
101
- Short form: Do not pass `allConnectedSenders:true` unless the prompt explicitly says all/every connected sender.
102
- Short form: "all 4 campaigns" means explicit sender scope plus two shared lanes, not all connected senders.
103
- Short form: In `--yolo`, ambiguous multi-sender scope blocks before mutation.
104
61
  </inputs>
105
62
 
106
63
  <command_backed_workflow>
@@ -258,8 +215,7 @@ After bounded delegated approval or safe `--yolo`, fan out lane worker tasks
258
215
  only from the current plan. Each worker receives the complete lane packet:
259
216
  workspace id, sender ids, lane key/type, existing campaign/table binding or
260
217
  create intent, source hints, caps, planRevision, actionId, allowed side effects,
261
- postconditions, the parent `postEngagerSenderIds`, the parent
262
- `sharedSenderIds`, and the packet's `workerDispatch` policy. Treat
218
+ postconditions, and the packet's `workerDispatch` policy. Treat
263
219
  `workerDispatch.requiresVisibleThreadOrDurableReceipt:true` as a hard
264
220
  execution boundary, not guidance. Read and preserve `workerDispatch.acceptedRuntimes`,
265
221
  `workerDispatch.rejectedRuntimes`, and `workerDispatch.receiptArtifactHint`
@@ -278,15 +234,6 @@ parent packet, do not mutate and do not use it as `setupPlanCall` proof; stop
278
234
  with `blocked: worker_plan_scope_drift` and ask the parent to re-plan.
279
235
  Short form: If a worker-local plan omits `postEngagerSenderIds:[]`, do not use it as `setupPlanCall` proof.
280
236
  Short form: stop with `blocked: worker_plan_scope_drift`.
281
- Every worker prompt must include both parent scope arrays as explicit fields:
282
- `Parent postEngagerSenderIds:` and `Parent sharedSenderIds:`. Workers must
283
- preserve parent postEngagerSenderIds even for shared lanes. Never run a
284
- shared-lane worker-local plan with `postEngagerSenderIds:[]` unless the parent
285
- `postEngagerSenderIds` is exactly `[]`. Every durable receipt must copy these
286
- arrays to top-level `parentPostEngagerSenderIds` and `parentSharedSenderIds`
287
- before completion.
288
- Short form: Workers must preserve parent postEngagerSenderIds even for shared lanes.
289
- Short form: Never run a shared-lane worker-local plan with `postEngagerSenderIds:[]` unless the parent `postEngagerSenderIds` is exactly `[]`.
290
237
 
291
238
  Worker fan-out must use visible or durable execution. Preferred in local Codex
292
239
  is a visible Codex thread created with the actual Codex app thread tools:
@@ -310,109 +257,35 @@ acceptable only when it writes a fresh durable per-lane receipt artifact as it
310
257
  works.
311
258
  When visible Codex app thread tools are unavailable but local Codex CLI is
312
259
  available, the accepted durable streaming-worker command shape is:
313
- `codex -a never -s danger-full-access exec --skip-git-repo-check -m <worker-model> -C <repo> -o <worker-final-file> -`.
260
+ `codex -a never -s danger-full-access exec -C <repo> -o <worker-final-file> -`.
314
261
  The approval and sandbox flags must come before the `exec` subcommand for Codex
315
- CLI builds that expose `-a`/`-s` only at top level. `--skip-git-repo-check` belongs after `exec` because current customer and VPS Codex CLI builds expose it
316
- as an `exec` subcommand flag, not a top-level flag. Do not use
262
+ CLI builds that expose `-a`/`-s` only at top level. Do not use
317
263
  `codex exec --ask-for-approval never ...` or `codex exec -a never ...`; those
318
264
  forms fail on current customer CLI installs. Pipe the lane packet prompt on
319
265
  stdin, require the worker to write `workerDispatch.receiptArtifactHint`, and
320
266
  pass exactly one lane packet per worker.
321
- When launching durable Codex CLI workers from an automation parent, pass an
322
- explicit supported worker model instead of relying on the Codex CLI default
323
- model. Use the parent runtime model when known, for example:
324
- `codex -a never -s danger-full-access exec --skip-git-repo-check -m <worker-model> -C <repo> -o <worker-final-file> -`.
325
- Do not rely on the Codex CLI default model; some customer and VPS installs
326
- default to unavailable model aliases. If the parent cannot identify a supported
327
- worker model and a test `codex exec -m <worker-model>` launch is rejected, stop
328
- with `blocked: worker_model_unavailable` before mutation.
329
- When wrapping multiple local Codex CLI workers in a shell launcher, run the
330
- wrapper with `/bin/bash -lc` or another explicitly chosen portable shell. Do not
331
- rely on zsh-specific behavior. Do not use `status` as a shell variable because
332
- zsh treats it as read-only; use `exit_code` or `rc` instead. Receipt polling
333
- must use `find <receipt-dir> -maxdepth 1 -name 'evg_*.json' -print` or an
334
- explicit nullglob-safe equivalent. Do not use naked `*.json` globs under zsh,
335
- and keep zero-receipt polls quiet with no `no matches found` diagnostics.
336
- Do not embed `<<'WORKER_PROMPT'` heredocs inside a single quoted or double
337
- quoted `/bin/bash -lc '...'` command string; nested quoting is brittle and can
338
- truncate the first worker before mutation. For multi-worker launchers, write one
339
- plain prompt file per lane under the current run directory, then start each
340
- worker with `codex -a never -s danger-full-access exec --skip-git-repo-check -m "$WORKER_MODEL" -C "$REPO" -o
341
- "$worker_final_file" - < "$worker_prompt_file"`. Keep launcher shell variables
342
- double-quoted and keep the prompt heredoc only in a standalone script/prompt-file
343
- write step, not inside an already quoted shell argument. If the first launcher
344
- attempt exits with a shell parse error or before starting the first worker,
345
- stop with `blocked: worker_launcher_quoting_failed` and do not retry by
346
- loosening sender scope or mutating in the parent.
347
- Do not use `nohup`, detached background workers, or any launcher that returns
348
- before the workers finish and before receipts/final files exist. A durable
349
- worker must run in a foreground command session, visible Codex thread, or a shell
350
- that stays alive until every worker has finished. If using background jobs inside
351
- one shell, the same shell must stay alive, wait for every worker PID, poll only
352
- the expected receipt paths, and record a per-worker exit code plus final-file
353
- paths and stderr/log paths before returning. If workers exit with empty logs and
354
- no final files because the subprocess detached or was reaped, stop with
355
- `blocked: worker_subprocess_detached_without_output` before parent verify.
356
- Short form: run the wrapper with `/bin/bash -lc`.
357
- Short form: Do not rely on zsh-specific behavior.
358
- Short form: Do not use `status` as a shell variable; use `exit_code` or `rc`.
359
- Short form: Receipt polling uses `find <receipt-dir> -maxdepth 1 -name 'evg_*.json' -print`.
360
- Short form: Do not use naked `*.json` globs under zsh; no `no matches found` diagnostics.
361
- Short form: Do not embed `<<'WORKER_PROMPT'` heredocs inside a quoted `/bin/bash -lc` command string.
362
- Short form: Multi-worker launchers write prompt files and run `codex ... - < "$worker_prompt_file"`.
363
- Short form: Do not use `nohup`; keep the worker process attached until receipt or blocker.
364
- After the auto-executable plan returns, take at most one short planning pass to
365
- choose the visible/durable worker runtime and build the worker launch packet.
366
- Do not keep reasoning, re-reading prompts, or restating the workflow instead of
367
- dispatching. If the parent cannot name the callable worker runtime and prepare
368
- the first worker launch command/tool call immediately after that pass, stop with
369
- `blocked: worker_dispatch_deadline_exceeded` before directory setup or mutation.
370
267
  After creating receipt directories, dispatch workers immediately; do not perform extended parent reasoning, extra inventory, or prompt rewriting loops.
371
- Before any campaign shell creation, the parent must dispatch every selected lane
372
- worker from the current plan and record the visible thread id or
373
- `receiptArtifactPath` for each selected actionId. The parent must not call
374
- `create_campaign`, `import_leads`, `confirm_lead_list`, sequence tools, message
375
- preparation tools, or `setup_evergreen_campaigns` with `mode:"apply"` or any
376
- other mutating setup mode. In this wrapper, `setup_evergreen_campaigns` is
377
- plan/verify authority only; customer-visible creation belongs inside lane
378
- workers through `$sellable:create-campaign`. If a campaign/table id appears for
379
- a create lane before that lane has a recorded worker runtime and fresh receipt
380
- path/thread id, stop with `blocked: parent_mutated_before_worker_receipt` and
381
- do not continue setup in the parent.
382
- Short form: dispatch every selected lane worker before shell creation.
383
- Short form: do not call `setup_evergreen_campaigns` with `mode:"apply"` from the parent.
384
268
  Use a compact worker prompt: include lane packet JSON, original selectedActionIds,
385
- original planRevision, parent postEngagerSenderIds, parent sharedSenderIds,
386
- receiptArtifactPath, workspace id, sender ids, side-effect caps, and the
387
- instruction to load packaged prompts through MCP.
269
+ original planRevision, receiptArtifactPath, workspace id, sender ids,
270
+ side-effect caps, and the instruction to load packaged prompts through MCP.
388
271
  Do not paste the entire wrapper skill into worker prompts. If the parent cannot
389
272
  launch at least one visible/durable worker immediately after directory setup,
390
273
  stop with `blocked: worker_dispatch_stalled` before any mutation.
391
- After launching workers, poll only the expected current-run receipt paths from
392
- `workerDispatch.receiptArtifactHint`. If no worker receipt file appears within a
393
- bounded wait, for example 10 minutes in automation, stop with
394
- `blocked: worker_receipt_timeout`, include the worker ids/final-file paths/stderr
395
- if available, and do not create or repair campaign shells in the parent.
396
274
  Use only the repo-local `workerDispatch.receiptArtifactHint` returned by the
397
275
  current lane packet for receipt paths.
398
276
  Do not hardcode machine-specific paths, workspace ids, campaign ids, sender ids, or UAT/phase artifact paths in this MCP prompt or any worker prompt.
399
277
  After the receipt-directory `mkdir`, the next shell/tool call must launch the first lane worker.
400
278
  Do not run `find`, `ls`, extra inventory, or another preflight between directory setup and the first worker launch.
401
- For the local Codex CLI fallback, use this literal durable CLI worker launch
402
- template and fill only the lane-specific placeholders. For one-off direct worker
403
- launches you may pipe a heredoc directly to `codex`; for multi-worker shell
404
- launchers, write the same prompt body to `<worker-prompt-file>` and launch the
405
- worker with stdin redirected from that file:
279
+ For the local Codex CLI fallback, use this literal durable CLI worker launch template
280
+ and fill only the lane-specific placeholders:
406
281
 
407
282
  ```
408
- codex -a never -s danger-full-access exec --skip-git-repo-check -m <worker-model> -C <repo> -o <worker-final-file> - <<'WORKER_PROMPT'
283
+ codex -a never -s danger-full-access exec -C <repo> -o <worker-final-file> - <<'WORKER_PROMPT'
409
284
  Use $sellable:create-evergreen-campaigns as the governing skill for this one lane worker.
410
285
 
411
286
  Workspace id: <workspaceId>
412
287
  Parent planRevision: <planRevision>
413
288
  Parent selectedActionIds: <selectedActionIds JSON>
414
- Parent postEngagerSenderIds: <postEngagerSenderIds JSON>
415
- Parent sharedSenderIds: <sharedSenderIds JSON>
416
289
  Action id: <actionId>
417
290
  Lane key: <laneKey>
418
291
  Allowed side effects: <allowedSideEffects JSON>
@@ -426,9 +299,6 @@ Use mcp__sellable only. Do not use admin tools, direct DB, Prisma, SQL, web sear
426
299
  Do not launch, start, schedule, send, or use paid InMail.
427
300
  Complete only this lane, write the required durable receipt JSON, and stop.
428
301
  WORKER_PROMPT
429
-
430
- # Multi-worker launcher equivalent:
431
- codex -a never -s danger-full-access exec --skip-git-repo-check -m <worker-model> -C <repo> -o <worker-final-file> - < <worker-prompt-file>
432
302
  ```
433
303
 
434
304
  If any placeholder cannot be filled from the current lane packet, do not inspect
@@ -498,14 +368,7 @@ not a parent-thread summary. The receipt must include:
498
368
  `senderIds`, `campaignId`, `tableId`, and `createIntent`. Do not use
499
369
  `laneActionId`, `lanePacketActionId`, `delegatedPlanRevision`,
500
370
  `delegatedActionId`, or freeform `requestedCall` text as a substitute for
501
- these fields. For create lanes, `setupPlanCall.campaignId` and
502
- `setupPlanCall.tableId` must be the actual created campaign/table ids after
503
- creation and readback. If the parent lane packet carried null ids before
504
- creation, preserve that original packet only in a separate `parentLanePacket`
505
- object; do not leave `setupPlanCall.campaignId:null` or
506
- `setupPlanCall.tableId:null`.
507
- Short form: For create lanes, `setupPlanCall.campaignId` and `setupPlanCall.tableId` must be the actual created campaign/table ids.
508
- Short form: Do not leave `setupPlanCall.campaignId:null` or `setupPlanCall.tableId:null`.
371
+ these fields.
509
372
  - `createCampaignWorkflowReceipt`: proof the worker loaded the actual installed
510
373
  `$sellable:create-campaign` wrapper instead of doing ad hoc MCP calls. It must
511
374
  include `skillCommand:"$sellable:create-campaign"`,
@@ -560,25 +423,8 @@ not a parent-thread summary. The receipt must include:
560
423
  evidence field such as `rowCount`, `rowIdsHash`, or `rowEvidence`; do not
561
424
  leave those only in `searchSignalsProof`, `importProof`, `coldFallbackProof`,
562
425
  or narrative text for the parent/verifier to infer.
563
- - `filterDecisionReceipt`: saved/applied ICP filter proof for the current
564
- campaign/table basis. Customer-visible evergreen lanes must enable ICP
565
- filtering with `enableICPFilters:true`, call `save_rubrics`, and save at
566
- least three rubric/filter criteria before Message Drafting. Do not skip
567
- filtering for evergreen setup. Missing or skipped filter proof is
568
- `blocked: missing_filter_setup`.
569
- Before the worker exits, the durable JSON must contain
570
- `filterDecisionReceipt.status:"applied"`,
571
- `filterDecisionReceipt.enableICPFilters:true`, the current
572
- `workflowTableId`, and concrete saved-filter proof such as
573
- `filterDecisionReceipt.filterIds`, `filterDecisionReceipt.rubricIds`,
574
- `filterDecisionReceipt.savedRubricCount`, or
575
- `filterDecisionReceipt.headlineICPCriteria`.
576
- The exact status string is contractual: use `status:"applied"` only.
577
- Do not write `status:"confirmed"`, `status:"saved"`, `status:"done"`, or
578
- any other alias after saving filters; the parent verifier rejects those
579
- aliases even when saved rubric proof exists.
580
- Short form: Filter receipt status must be exactly `applied`.
581
- Short form: Do not write `filterDecisionReceipt.status:"confirmed"`.
426
+ - `filterDecisionReceipt`: saved/applied filter ids or explicit skip-filter
427
+ decision with current campaign/table basis.
582
428
  - `messageDraftingReceipt`: the Message Drafting proof described below,
583
429
  including packaged `generate-messages` prompt/assets and validation. Raw
584
430
  fields like `generateMessagesPromptLoadedToHasMoreFalse`,
@@ -614,10 +460,7 @@ not a parent-thread summary. The receipt must include:
614
460
  Before writing the durable receipt, run a receipt self-check. The top-level
615
461
  receipt must include top-level `planRevision`, `actionId`, `laneKey`,
616
462
  `laneType`, `workspaceId`, and `senderIds`, plus campaign/table/source ids and
617
- row/message/approval counts. It must also include top-level `receiptArtifactPath`,
618
- top-level `durableReceiptWritten:true`, top-level `receiptRunId`, and top-level
619
- `receiptWrittenAt`; do not leave `receiptArtifactPath` only under
620
- `createCampaignWorkflowReceipt` for the parent to patch during verify. Inside
463
+ row/message/approval counts. Inside
621
464
  `createCampaignStepReceipt.messageDraftingReceipt`, `sampleMessages[]` must
622
465
  include `rowId`, `generatedMessageText`, `verdict`, and `issues`. Do not
623
466
  substitute `message` for `generatedMessageText`. Do not substitute
@@ -629,8 +472,6 @@ before writing JSON; do not leave only raw objects like
629
472
  `get_campaign_message_preparation_status`, `attachRecommendedSequenceResult`,
630
473
  `finalCampaignRead`, or `finalTableRead`.
631
474
  Self-check shorthand: top-level `planRevision`, `actionId`, `laneKey`, `laneType`, `workspaceId`, and `senderIds` must exist before worker completion.
632
- Self-check shorthand: top-level `receiptArtifactPath`, `durableReceiptWritten:true`, `receiptRunId`, and `receiptWrittenAt` must exist before worker completion.
633
- Self-check shorthand: top-level `receiptWrittenAt` must exist before worker completion.
634
475
  Self-check shorthand: `campaignBriefReceipt.briefHash`,
635
476
  `campaignBriefReceipt.deliveryFormat`, `campaignBriefReceipt.tokenRules`,
636
477
  `campaignBriefReceipt.hardAvoids`, and `campaignBriefReceipt.sourceUseRules`
@@ -719,12 +560,7 @@ verification unless the same object also appears inside
719
560
  "sourceLadderReason": "<why the current source is valid before colder sources>"
720
561
  },
721
562
  "filterDecisionReceipt": {
722
- "status": "applied",
723
- "enableICPFilters": true,
724
- "filterIds": ["<saved filter/rubric id>"],
725
- "rubricIds": ["<saved rubric id>"],
726
- "headlineICPCriteria": ["<saved ICP criterion>", "<saved ICP criterion>", "<saved ICP criterion>"],
727
- "savedRubricCount": 3,
563
+ "status": "skipped",
728
564
  "workflowTableId": "<workflow table id>"
729
565
  },
730
566
  "messageDraftingReceipt": {
@@ -805,19 +641,6 @@ path itself in the worker thread:
805
641
  exactly one semantic Approved cell through `select_campaign_cells` and
806
642
  `update_cell`.
807
643
  Approval shorthand: approve exactly one semantic Approved cell.
808
- In this message-drafting path, `update_cell` is allowed only for the semantic
809
- Approved checkbox. Do not use `update_cell` or any row/cell write to edit
810
- generated message text, sample copy, or final message bodies in automation.
811
- If generated copy fails review, update the campaign brief/message template
812
- with `update_campaign_brief` or `revise_message_template_and_rerun`, then
813
- rerun Generate Message and review current-revision generated output. Receipt
814
- `sampleMessages` must come from generated current-revision cells after the
815
- brief/template rerun, not from hand-edited message cell overrides. If a lane
816
- used a generated-message body override, report
817
- `blocked: generated_message_cell_override` instead of success.
818
- Short form: `update_cell` is allowed only for the semantic Approved checkbox.
819
- Short form: Do not use `update_cell` to edit generated message text.
820
- Short form: Bad copy requires brief/template revision plus Generate Message rerun.
821
644
  4. Poll `get_campaign_message_preparation_status` until no queued/active cells
822
645
  remain or a bounded stop reason is returned.
823
646
  5. Use `get_campaign_messages_preview` or `select_campaign_cells` to inspect
@@ -844,26 +667,6 @@ The only accepted statusSource values are exactly `branch` and
844
667
  `packaged-generate-messages-worker`; descriptive aliases such as
845
668
  `package-readback-local-thread` are rejected.
846
669
 
847
- Before any provider-specific source mutation for a newly created campaign,
848
- reread `get_campaign_navigation_state({ campaignId })` and use that product
849
- navigation state as the source-step authority. Do not jump from a shell directly
850
- into `contact-search`, and do not jump from a shell directly into
851
- `signal-discovery`. Advance through the product-visible source-selection step
852
- first, then load the provider prompt and write only the provider/source fields
853
- accepted for that current step. Never include sender reassignment fields in
854
- source-step updates, never include custom narration fields in source-step
855
- updates, and do not use guessed `currentStep` or watched narration payloads to
856
- force the flow forward. If `update_campaign` rejects the source transition
857
- twice, reread navigation/campaign state once; if the campaign is not already on
858
- the intended source step, stop the lane with
859
- `blocked: watched_source_transition_blocked` and include the rejected tool
860
- result plus the readback. Do not loop on rejected `update_campaign` transitions.
861
- Short form: do not jump from a shell directly into `contact-search`.
862
- Short form: do not jump from a shell directly into `signal-discovery`.
863
- Short form: never include sender reassignment fields in source-step updates.
864
- Short form: never include custom narration fields in source-step updates.
865
- Short form: do not loop on rejected `update_campaign` transitions.
866
-
867
670
  One lane may produce exactly one CampaignOffer/campaign id and one current
868
671
  workflow table id. For `intent:"create"`, the first successful
869
672
  `create_campaign` result establishes the lane's only allowed campaign/table
@@ -902,14 +705,9 @@ the prospect's engagement unless the selected source evidence proves that exact
902
705
  sender authored the post.
903
706
  Shared lanes must reject generic product-summary samples that explain the
904
707
  product in the same broad words for every row. Shared lanes must reject three
905
- nearly identical samples after stripping the leading name. Shared lanes must
906
- fail quality review when any reviewed sample has non-empty `issues`; do not
907
- approve or final-report samples with `verdict:"passed"` and non-empty `issues`.
908
- If any of these failures appears, revise or rerun the packaged
909
- create-campaign/generate-messages path from the lane worker before writing a
910
- success receipt.
911
- Short form: Shared lanes must fail quality review when any reviewed sample has non-empty `issues`.
912
- Short form: Do not approve or final-report samples with `verdict:"passed"` and non-empty `issues`.
708
+ nearly identical samples after stripping the leading name. If either failure
709
+ appears, revise or rerun the packaged create-campaign/generate-messages path
710
+ from the lane worker before writing a success receipt.
913
711
  The generated-message cells are not prompt proof: `currentRevisionGeneratedMessages`,
914
712
  Generate Message column counts, `messagesCount`, or rendered row previews prove
915
713
  only that table cells exist from the current brief/template, not that the
@@ -929,37 +727,10 @@ duplicate-lane blockers before you call the command finished. If verify blocks,
929
727
  report the blocker and repair only the missing postconditions from the same
930
728
  current plan.
931
729
 
932
- Before calling verify, the parent should build compact receipt objects from the
933
- durable receipt files and pass those compact objects to MCP. The compact receipt
934
- must preserve every verifier-owned field named above, including top-level ids,
935
- `createCampaignStepReceipt`, canonical filter/message/review/sequence/final
936
- proof, and at least three concrete sample messages. It should omit large raw
937
- search outputs, long post lists, full row arrays, raw provider responses, and
938
- debug-only narration fields. Do not pass multi-hundred-kilobyte raw receipt
939
- objects when a compact canonical receipt has the same proof; large raw verify
940
- payloads can stall local MCP bridges and make UAT ambiguous.
941
- Do not print or `jq .` full receipt JSON into the terminal. For local checks,
942
- print only compact summaries such as file, actionId, laneKey, campaignId,
943
- filter status, sample count, approved count, and final status.
944
- Short form: Parent verify uses compact canonical receipt objects, not raw giant receipts.
945
- Short form: Do not dump full receipt JSON with `jq .`.
946
- Short form: Never change planRevision/actionId/laneKey while compacting receipts.
947
-
948
730
  Message proof for every customer-visible lane must come from the current
949
731
  campaign/table basis and include at least 3 generated review rows from the
950
732
  packaged `generate-messages` path before completion is reported.
951
733
  Parent-thread handwritten copy or setting `currentStep` is not proof.
952
-
953
- The parent must run its own sample-quality gate before final reporting, even
954
- when worker receipts say `verdict:"passed"`. For each shared lane, normalize the
955
- reviewed sample messages by removing leading greeting/name lines, first names,
956
- and whitespace-only differences; reject shared-lane samples when the message body is identical after removing first names or when all samples share the same
957
- paragraph skeleton. Also reject final shared-lane samples with `Hey <name>,`
958
- letter punctuation, weak relevance hedges, internal workflow vocabulary,
959
- self-intros, or any non-empty `issues`. If the parent finds repeated shared-lane
960
- sample copy, report `blocked: repeated_shared_lane_sample_copy`, revise the
961
- campaign brief/template through the packaged workflow, rerun Generate Message,
962
- and verify current-revision sample messages before final completion.
963
734
  </command_backed_workflow>
964
735
 
965
736
  <objective>
@@ -994,8 +765,6 @@ and verify current-revision sample messages before final completion.
994
765
  Short form: Do not pass the warm template into Shared Signal Discovery or Shared Cold Fallback.
995
766
  Short form: Shared lanes must reject generic product-summary samples.
996
767
  Short form: Shared lanes must reject three nearly identical samples.
997
- Short form: Shared lanes must reject low-confidence relevance hedges.
998
- Short form: Shared lanes must reject internal workflow vocabulary.
999
768
  Short form: revise or rerun the packaged create-campaign/generate-messages path.
1000
769
  - **Post Engagers** first-message style: short, casual, references the
1001
770
  sender-authored post they engaged with, closed question, **no internal
@@ -1006,7 +775,7 @@ and verify current-revision sample messages before final completion.
1006
775
 
1007
776
  Hey there
1008
777
 
1009
- Thank you for the support on my post about {{post_topic_line}}
778
+ Thanks for the support on my post about {{post_topic_line}}
1010
779
  ```
1011
780
 
1012
781
  - **Shared Signal Discovery** first-message style: short, casual, references
@@ -1022,22 +791,6 @@ and verify current-revision sample messages before final completion.
1022
791
  say it. Prefer sender-agnostic company/team language such as "we're
1023
792
  helping CX teams..." or "at cxconnect.ai, we help..." and one clear
1024
793
  problem question.
1025
- Before Message Drafting runs, the campaign brief must already include
1026
- these shared-lane hard avoids and source-use rules. Do not rely on a
1027
- failed first generation batch to discover that self-intros, generic
1028
- product summaries, or repeated structure are bad. If the first generated
1029
- batch violates these rules, rerun, but record that as a repaired UAT path
1030
- rather than the desired zero-shot path.
1031
- Do not use low-confidence relevance hedges such as "hope this is
1032
- relevant" in Shared Signal Discovery samples. Translate source/tool terms
1033
- into prospect-facing business language; do not put internal workflow
1034
- vocabulary such as "Codex-style workflow", "MCP", "agent workflows", or
1035
- "Claude-style agent workflows" in customer-facing message one.
1036
- Short form: Shared Signal Discovery uses no self-intro such as "I'm building Sellable".
1037
- Short form: Shared Signal Discovery uses no self-intro such as "We're building Sellable".
1038
- Short form: Shared Signal Discovery uses no "I've put together".
1039
- Short form: no low-confidence relevance hedge such as "hope this is relevant".
1040
- Short form: no internal workflow vocabulary such as "Codex-style workflow", "MCP", "agent workflows", or "Claude-style agent workflows".
1041
794
  - **Shared Cold Fallback** first-message style: cold, direct, and cohesive.
1042
795
  It must not pretend there was engagement, must not say "saw you pop up",
1043
796
  and must not use a standalone name line followed by "Hey there" or other
@@ -1052,52 +805,14 @@ and verify current-revision sample messages before final completion.
1052
805
  Sellable/Codex/Claude-Code feature summary
1053
806
  across prospects. This is a single-message cold path unless the approved
1054
807
  create-campaign message workflow proves a better delivery format.
1055
- Do not open with "hope this is relevant" or a similar low-confidence
1056
- relevance hedge. Do not use a repeated product-definition paragraph such
1057
- as "Sellable is a GTM system" across samples; every reviewed cold sample
1058
- should be specific enough to the role, company, or problem that the three
1059
- sample messages do not share the same body skeleton.
1060
- Before Message Drafting runs, the campaign brief must already forbid
1061
- self-intros, generic product summaries, opt-out shrugs, product-stack
1062
- dumps, and repeated template structure. Do not let the first generation
1063
- batch use "I'm building", "We're building", "I've put together", or
1064
- similar language and then rely on a cleanup rerun as the normal path.
1065
808
  Short form: Shared Cold Fallback must not pass just because the receipt says `generate-messages` loaded.
1066
809
  Short form: Shared Cold Fallback uses no self-intro such as "We're building".
1067
- Short form: Shared Cold Fallback uses no self-intro such as "I'm building Sellable".
1068
- Short form: Shared Cold Fallback uses no "I've put together".
1069
810
  Short form: Shared Cold Fallback uses no opt-out shrug such as "If this isn't relevant, ignore me".
1070
811
  Short form: Shared Cold Fallback uses no product-stack dump.
1071
- Short form: no low-confidence relevance hedge such as "hope this is relevant".
1072
- Short form: no repeated product-definition paragraph such as "Sellable is a GTM system".
1073
- - Customer-visible evergreen lanes must enable ICP filtering before Message
1074
- Drafting. This applies to Post Engagers, Shared Signal Discovery, and
1075
- Shared Cold Fallback. Do not skip filtering for evergreen setup, even when
1076
- the source is warm. Use the normal `$sellable:create-campaign` filter
1077
- workflow: set or save 3-5 headline ICP criteria, call `save_rubrics`, and
1078
- persist `enableICPFilters:true` on the campaign before generating
1079
- messages. Good evergreen filters should be light but real: role/budget
1080
- relevance, company/market fit, and obvious non-buyer exclusion. For
1081
- Post Engagers, keep filters permissive enough that warm source rows are not
1082
- over-pruned, but still save the filter rules. For shared lanes, filter for
1083
- buyers/operators relevant to the workspace offer and exclude students,
1084
- job seekers, vendors, and off-topic commenters. The receipt must show
1085
- `filterDecisionReceipt.status:"applied"`,
1086
- `filterDecisionReceipt.enableICPFilters:true`, current `workflowTableId`,
1087
- and saved filter/rubric proof with at least three saved rubric/filter
1088
- criteria (`filterIds`, `rubricIds`, `headlineICPCriteria`, or
1089
- `savedRubricCount`). Missing or skipped filter proof is
1090
- `blocked: missing_filter_setup`.
1091
- Short form: Customer-visible evergreen lanes must enable ICP filtering.
1092
- Short form: `enableICPFilters:true`.
1093
- Short form: Do not skip filtering for evergreen setup.
1094
- Short form: at least three saved rubric/filter criteria.
1095
- Short form: missing or skipped filter proof is `blocked: missing_filter_setup`.
1096
- Short form: run Message Drafting only after saved filters are applied.
1097
- - Every customer-visible lane must run Message Drafting from the current
1098
- campaign/table basis after source rows exist. The worker must load the full
1099
- packaged `generate-messages` prompt, every required asset, and
1100
- `create-campaign-v2-validation`; if the internal branch handoff is not
812
+ - Every customer-visible lane must run Message Drafting from the current
813
+ campaign/table basis after source rows exist. The worker must load the full
814
+ packaged `generate-messages` prompt, every required asset, and
815
+ `create-campaign-v2-validation`; if the internal branch handoff is not
1101
816
  callable in the packaged runtime, the worker must call
1102
817
  `start_campaign_message_preparation` and poll
1103
818
  `get_campaign_message_preparation_status` from the lane worker. The
@@ -1127,13 +842,10 @@ and verify current-revision sample messages before final completion.
1127
842
  - A source/list decision has been resolved and campaign rows are loaded. If
1128
843
  there is no approved source or no rows can be copied, report `blocked` with
1129
844
  the missing source detail; do not call the campaign complete.
1130
- - The filter step is resolved with saved/applied filters. Customer-visible
1131
- evergreen lanes must have `enableICPFilters:true`, at least three saved
1132
- ICP filter/rubric criteria, and a receipt with
1133
- `filterDecisionReceipt.status:"applied"`. Do not skip filters for
1134
- evergreen setup. Do not leave customer-visible campaigns at
1135
- `filter-choice`, `filter-rules`, or `apply-icp-rubric` and report success.
1136
- Do not proceed to Message Drafting until saved filters are applied.
845
+ - The filter step is resolved: either saved/applied filters are present, or
846
+ the campaign explicitly skipped filters. Do not leave customer-visible
847
+ campaigns at `filter-choice`, `filter-rules`, or `apply-icp-rubric` and
848
+ report success.
1137
849
  - Message Drafting has run from the current campaign/table basis, using the
1138
850
  create-campaign message prompt/assets and validation gate. Updating
1139
851
  `currentStep:"messages"` is not proof. Parent-thread handwritten copy is
@@ -1152,17 +864,13 @@ and verify current-revision sample messages before final completion.
1152
864
  reviewed sample messages. For Shared Cold Fallback, reject samples that
1153
865
  open with a standalone name followed by "Hey there" or a similarly generic
1154
866
  greeting. For Shared Cold Fallback, also reject samples with a self-intro
1155
- such as "We're building", "I'm building Sellable", or "I've put
1156
- together", an opt-out shrug such as "If this isn't relevant, ignore me",
1157
- or a product-stack dump that repeats the same
867
+ such as "We're building", an opt-out shrug such as "If this isn't
868
+ relevant, ignore me", or a product-stack dump that repeats the same
1158
869
  Sellable/Codex/Claude-Code feature summary across prospects. For all
1159
870
  shared lanes, reject generic product-summary samples, repeated
1160
- near-identical samples, low-confidence relevance hedges such as "hope this
1161
- is relevant", internal workflow vocabulary, any sample with non-empty
1162
- `issues`, and any preserved Post Engagers opener; revise or rerun the packaged
1163
- create-campaign/generate-messages path before reporting completion. Do not
1164
- approve or final-report samples with `verdict:"passed"` and non-empty
1165
- `issues`.
871
+ near-identical samples, and any preserved Post Engagers opener; revise or
872
+ rerun the packaged create-campaign/generate-messages path before reporting
873
+ completion.
1166
874
  - The first review batch exists and at least 3 review rows have generated
1167
875
  messages from the approved brief. If fewer than 3 usable rows exist, report
1168
876
  the actual count and why.
@@ -1236,9 +944,7 @@ and verify current-revision sample messages before final completion.
1236
944
  **Also confirm the delivery format and keep config in sync.** Ask the user whether DM lanes should send multiline (paragraph-per-message) or as a single message. Record the answer as the brief's `Delivery format:` line, and when multiline is chosen, set `actionConfig.sendEachParagraphAsMessage: true` on that campaign's `send_dm` column via `update_column` (config edits run no cells and nothing sends from unlaunched campaigns). Never set the paragraph-split flag on InMail columns — the option does not apply to InMail.
1237
945
  6. **Interactive polish mode only: prove the template on one real row.** For ONE campaign that has at least one lead row (add one via `add_on_demand_leads` if every lane is empty and the user provides/approves a test lead), generate a message for exactly one row (`queue_campaign_cells` with `columnRole: "generateMessage"`, `rowSelector: { type: "reviewBatch", limit: 1 }` or the single row's ID), wait for it, then show the user the generated message next to the template — AND show how it would split if paragraph-per-message sending is enabled (list each paragraph as `msg 1:`, `msg 2:`, …) so the user confirms each one reads like a real typed message. Check alignment: tone, structure, no internal vocabulary, correct token substitution, no letter punctuation. Do NOT approve the row or generate for more rows — one sample only.
1238
946
  7. **Automation mode template/config audit**: inspect existing send-lane briefs for a `Delivery format:` line and chat-native warm template. If a send lane is missing the line and the prompt allows cleanup, update only the campaign brief metadata with the safest default for that lane (`Delivery format: single message (LinkedIn DM; line breaks remain inside one generated message; no follow-up until reply)`). If cleanup is not allowed, flag it. Do not generate a sample row in automation mode unless the invocation explicitly asks for sample proof. In structure-only automation, do not generate a sample row unless the invocation explicitly asks for sample proof. In customer-visible completion, follow the Customer-Visible Completion Contract instead.
1239
- 8. **Final customer-facing completion must include sample messaging**: after customer-visible verify and the idempotency rerun pass, add a `Sample Messaging Review` section to the final answer. For every completed lane, show at least one full generated first message for every completed lane with campaign name, campaign id, row id, and verdict. Extract samples from nested `createCampaignStepReceipt.messageDraftingReceipt.sampleMessages`, not from top-level summaries; extract samples from nested `createCampaignStepReceipt.messageDraftingReceipt.sampleMessages` when building the final answer. Prefer the approved route-proof row when it is quality-valid; otherwise use the best reviewed generated row from the verified receipt. A final `passed` sample must have `issues:[]`; if every reviewed sample has issues, report the lane as needing message revision instead of presenting a passed sample. Do not summarize the sample into a copy theme. Show the actual message text so the user can inspect tone and specificity. If any sample is not quite right, tell the user they can ask the AI to update the campaign brief/message template and rerun Generate Message before launch. Never suggest launching, scheduling, or sending as the next step from this command.
1240
- If the `Sample Messaging Review` section is omitted, the command is incomplete even when the structural campaign setup succeeded.
1241
- 9. **Report the reconcile plan and result** — every slot tagged `reused`, `created`, `repaired`, `flagged`, or `blocked`, plus template/sample details only when that mode ran:
947
+ 8. **Report the reconcile plan and result** every slot tagged `reused`, `created`, `repaired`, `flagged`, or `blocked`, plus template/sample details only when that mode ran:
1242
948
 
1243
949
  ```
1244
950
  Evergreen Reconcile — {date}
@@ -1247,17 +953,6 @@ Evergreen Reconcile — {date}
1247
953
  • Sellable.dev - Shared Signal Discovery: repaired (send review ready; 50 rows, 3 generated, 1 approved gate row, sequence attached, paused)
1248
954
  • Sellable.dev - Shared Cold Fallback: created (send review ready; 50 rows, 3 generated, 1 approved gate row, sequence attached, paused)
1249
955
  All campaigns remain unlaunched. Next: enrich/approve more rows when you want more items ready to schedule.
1250
-
1251
- Sample Messaging Review
1252
- • Christian Reyes - Post Engagers (`cmp_...`, row `row_...`, verdict: passed)
1253
- ```
1254
- {{full generated first message}}
1255
- ```
1256
- • Sellable.dev - Shared Cold Fallback (`cmp_...`, row `row_...`, verdict: passed)
1257
- ```
1258
- {{full generated first message}}
1259
- ```
1260
- If any sample is not quite right, ask the AI to update the campaign brief/message template and rerun Generate Message before launch.
1261
956
  ```
1262
957
  </objective>
1263
958