@sellable/mcp 0.1.398 → 0.1.399

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index-dev.js CHANGED
File without changes
package/dist/index.js CHANGED
File without changes
@@ -373,7 +373,7 @@ export function getPostFindLeadsScoutRegistry() {
373
373
  codex: 'After confirm_lead_list copies source rows and the initial campaign-table execution slice exists, ask the filter-choice question immediately. Do not spawn anything before that question. After the answer, launch only Message Drafting. The filter-choice answer is the post-import user gate for this single worker; do not ask another question about starting it in step-wise or YOLO mode. The registry lookup is not a launch: after get_post_find_leads_scout_registry, immediately invoke Task/spawn_agent or the host background-agent mechanism before loading filter-leads.md, before saving rubrics, and before treating skip-filters as ready for message review. Both choices route through this kickoff; do not let filters_skipped jump straight from filter-choice to message-generation. If filters are chosen, the parent stays on Filter Rules and drafts/saves rubrics with MCP tools while Message Drafting runs in the background. If filters are skipped, move to Messages/message review only after Message Drafting has started or is ready; update_campaign(currentStep=messages) is not proof of launch. If the named Message Drafting custom agent is unavailable, spawn a generic gpt-5.5 xhigh Message Drafting background agent with the same lean campaign/table basis. When the background worker starts, persist workerDetails.messageDraftBuilder with statusSource "branch", status "branch-running", runId, startedAt, updatedAt, basisToken when known, and basis containing campaignId, selectedLeadListId, workflowTableId, filterChoice, and reviewBatchRowHash or reviewBatchRowIds; workerStatuses.messageDraftBuilder may be "running" as a simple badge only. Never put rich proof under workerStatuses and never use workerStatuses.messageDrafting. If no background-agent tool is callable, start the same full message branch inline before filter drafting or before skip-filter message review, record workerDetails.messageDraftBuilder with statusSource "parent-thread-fallback" and status "fallback-active", and require the same live context, prompt, assets, and validation gate before message review; do not wait until filters are saved and then call the registry.',
374
374
  claude: "After confirm_lead_list copies source rows and the initial campaign-table execution slice exists, ask the filter-choice question immediately. Do not invoke any Task/Agent before that question. After the answer, invoke only Message Drafting. If filters are chosen, parent drafts/saves rubrics with MCP tools while Message Drafting runs, asks filter approval, then joins Message Drafting. If filters are skipped, invoke only Message Drafting and move to Messages/message review.",
375
375
  parentThreadRule: 'Named agents are optional acceleration, but message drafting is not optional. The only normal background worker is Message Drafting. The filter-choice answer is the campaign-scoped go-ahead for this single post-import worker; do not ask another question to start it in step-wise or YOLO mode. If a named agent is unavailable, use a generic gpt-5.5 xhigh Message Drafting background agent. source work and filter work stay in the parent thread with MCP tools. If post-find-leads-message-scout is available, run it as the background Message Draft Builder after the filter-choice answer. The registry lookup is not a launch: get_post_find_leads_scout_registry only identifies the worker, and Message Drafting counts as started only after Task/spawn_agent or the host background-agent tool is invoked, or after the parent begins the same full message branch inline because no background-agent tool is callable. This launch must happen before loading filter-leads.md, save_rubrics, filter approval, or skip-filter message review; currentStep=messages is not proof of launch. If post-find-leads-message-scout is absent, do not customer-surface install status. Do not silently treat message drafting as started; the main thread must either launch the background worker or execute the same message branch from CampaignOffer state, selected source state, workflowTableId, and initial campaign-table execution slice rows. For a spawned worker, record workerDetails.messageDraftBuilder with statusSource branch / status branch-running, runId, startedAt, updatedAt, and basis containing campaignId, selectedLeadListId, workflowTableId, filterChoice, and reviewBatchRowHash or reviewBatchRowIds. workerStatuses.messageDraftBuilder is optional simple badge text only ("running", "ready", "blocked", "idle"); never put runId/statusSource/basis under workerStatuses and never use workerStatuses.messageDrafting. If no background-agent tool is callable, start that same full message branch inline before filter drafting or before skip-filter message review, record workerDetails.messageDraftBuilder with statusSource parent-thread-fallback / status fallback-active then ready, and require the same live context, prompt, assets, and validation gate before message review; do not report that as a background worker failure. If neither branch nor inline fallback can run, return blocked/retry-needed; do not wait until filters are saved and then call the registry. The Message Drafting handoff must be lean. Do not paste copied row counts, brief hashes, review-batch hashes, full reviewBatchRowIds, broad row data, or local debug artifacts into the spawn prompt. Local markdown/json files are not normal-path inputs. The filter-choice question is the first post-import user gate; do not load post-lead registries or filter references before it. Message drafting starts after the filter-choice answer, must load get_subskill_prompt({ subskillName: "generate-messages" }), and must load every required message asset named by generate-messages Mode 0 through get_subskill_asset before drafting. Reference Asset Loading means loading the required pre-draft reference pack before drafting; return blocked/retry-needed if required assets cannot be loaded; load ai-tells.md because it is never optional. The branch or parent-thread fallback loads the full generate-messages prompt and every referenced asset through get_subskill_asset. After generating/revising the candidate and before returning ready, must load get_subskill_prompt({ subskillName: "create-campaign-v2-validation" }) as the final internal validation gate, must read live campaign table state through scoped MCP/product tools, and must reject mismatched selectedLeadListId/workflowTableId/campaign/workspace input. Do not block when filters were chosen but leadScoringRubrics are not yet visible in the branch read; the parent owns save_rubrics and filter approval in parallel, so Message Drafting should return status ready with basisStatus usable_initial when campaign/list/table identity and the non-empty execution slice match. Do not use any alternate, local-artifact, or examples-only message prompt. User copy feedback, message QA, or rewrite requests before approve-message must be routed back to Message Drafting with the current recommendation, lean campaign/table basis, and latest user text; the parent must not rewrite or QA the template from memory and must not call update_campaign_brief before approve-message. The worker validates internally and returns only templateRecommendation, tokenFillRules, renderedGoodSample, status, approveOrReviseRecommendation, validationStatus, outputAt, outputHash, and blocked/retry detail. Do not render renderedFallbackSample, risk notes, or a qaReceipt on the normal happy path. On the filter path, save_rubrics keeps the browser on Filter Rules after save_rubrics so the user can approve the saved criteria; after saved-filter approval, move to Filter Leads with currentStep=apply-icp-rubric whether Message Drafting is ready or still running. Wait there for message approval. Enrichment, filtering, Generate Message cells, sender setup, sequence attach, and launch wait for template approval on the Use Template path. On the skip path, move to Messages/message review after Message Drafting has started or is ready and wait for message approval before enrichment or Settings. Do not render message review from checklist or shortcut instructions; message review requires a messageDraftRecommendation whose basis proves the generate-messages prompt, required message assets, and validation gate ran for the current campaign/table execution slice. Do not automatically rerun Message Drafting after filters/enrichment finish; show the initial draft by default and offer an enriched rewrite only with explicit user opt-in. Handoff and recommendation output are Markdown with labeled fields, not raw JSON.',
376
- prepareMessagesRule: `Default create-campaign stays on the existing reviewBatchLimit:15 first campaign-table execution slice. For plain post-mint fill/load/refill requests, load get_subskill_prompt({ subskillName: "refill-sends-workflow" }), then call resolve_campaign_fill_route({ intent:"plain" }) and get_campaign_refill_state before any mutation. Route outcomes are route:"evergreen_horizon", route:"active_campaigns", and route:"ask_create"; stay in the same campaignOfferId/campaignId context after minting. Plain fill is not an alias for fill_campaign_horizon or campaign creation. fill_campaign_horizon is evergreen-only and is not the generic regular-campaign fill path. Campaign creation is allowed only after route:"ask_create" and explicit user selection; it is never the default response to plain fill. Treat "fill up/load sends" as capacity-fill preparation: calculate the bounded target from sender capacity when needed, then use the refill workflow to decide same-campaign source replenishment, enrichment/prep, approval/ready state, scheduler reread, and sender-health blockers. Do not create warm-post-engager side campaigns. For already-running regular campaigns that need Signal Discovery source replenishment, use the guarded currentStep clear with clearCurrentStepIfMatches:"running", campaign-scoped provider prompt/search/select, and import_leads with the existing sourceLeadListId when a newly approved selected-post scrape would otherwise return reusedExistingSourceList. After confirm_lead_list copies rows into an existing table, avoid fixed maxRowsToCheck:100; inspect reviewBatch/table selectors or use adaptive/wider bounded prep so appended rows are included. Do not interpret checkedRows as enriched rows; it is only the table cursor. Prepared, approved, and ready_to_schedule rows are intermediate states; never call them scheduled unless a re-read proves scheduler-owned scheduled cells with non-null scheduledFor. Before source import, prep, or approval, require exact visible approval and a fresh get_campaign_refill_state reread; stop if freshness.stateHash or exact ids changed. For "approve X messages", use approvalMode:approve only when explicitly requested, but still do not launch. For "schedule X sends" or "fill sender sends", approve only when explicitly requested, then re-read campaign/table scheduled counts; if scheduler-owned scheduledFor cells are not present, report prepared/approved/ready - awaiting scheduler instead of success. Do not call start_campaign as part of fill/schedule horizon. Do not call start_campaign as part of refill sends. Launch/start is a separate explicit human action after the operator intentionally wants sends to go out, and it must still verify that the bounded cohort is the only approved cohort and must not broad approve-all. campaignId is CampaignOffer.id. If the user asks to stop preparation, the target is wrong, or status shows the wrong campaign/table, use cancel_campaign_message_preparation only for the exact active job. Low-level selectors are diagnostics and recovery only for this lane. start_campaign remains forbidden until explicit launch/start approval outside refill sends.`,
376
+ prepareMessagesRule: `Default create-campaign stays on the existing reviewBatchLimit:15 first campaign-table execution slice. For plain post-mint fill/load/refill requests, load get_subskill_prompt({ subskillName: "refill-sends-workflow" }), then call resolve_campaign_fill_route({ intent:"plain" }), list_senders, and get_campaign_refill_state for enough candidate campaigns to identify the campaign that most recently had scheduler-owned sends for the relevant sender set before any mutation. Route outcomes are route:"evergreen_horizon", route:"active_campaigns", and route:"ask_create"; stay in the same campaignOfferId/campaignId context after minting. Plain fill is not an alias for fill_campaign_horizon or campaign creation. fill_campaign_horizon is evergreen-only and is not the generic regular-campaign fill path. Campaign creation is allowed only after route:"ask_create" and explicit user selection; it is never the default response to plain fill. Treat "fill up/load sends" as capacity-fill preparation. In --yolo fill/refill mode, default to one best recent-send campaign and a two-send-day horizon: calculate the bounded gap from healthy sender daily capacity minus future scheduler-owned scheduled sends and ready-to-schedule rows, then prepare only that gap. Use the refill workflow to decide whether to enrich/prep more rows in that same recent-send campaign, add/import more rows to that same campaign/source path, use a different existing campaign only when the recent-send lane is blocked/exhausted, or ask what to create. Do not create warm-post-engager side campaigns. Surface sender-health blockers separately from prepared/approved/scheduled counts. User-facing refill decisions must be campaign-name-first and sender-name-first, with ids as proof/execution targets only. For already-running regular campaigns that need Signal Discovery source replenishment, use the guarded currentStep clear with clearCurrentStepIfMatches:"running", campaign-scoped provider prompt/search/select, and import_leads with the existing sourceLeadListId when a newly approved selected-post scrape would otherwise return reusedExistingSourceList. After confirm_lead_list copies rows into an existing table, avoid fixed maxRowsToCheck:100; if confirm_lead_list returns USER_ADDED_ROWS_LIMIT_EXCEEDED, create a bounded same-source split from selectedLeadListId with get_rows_minimal/load_csv_linkedin_leads, confirm that smaller source list into the same campaign, and operate on the reviewBatch first; inspect reviewBatch/table selectors or use adaptive/wider bounded prep so appended rows are included. Do not interpret checkedRows as enriched rows; it is only the table cursor. Prepared, approved, and ready_to_schedule rows are intermediate states; never call them scheduled unless a re-read proves scheduler-owned scheduled cells with non-null scheduledFor. Before source import, prep, or approval, require exact visible approval and a fresh get_campaign_refill_state reread; stop if freshness.stateHash or exact ids changed. For "approve X messages", use approvalMode:approve only when explicitly requested, but still do not launch. For "schedule X sends" or "fill sender sends", approve only when explicitly requested, then re-read campaign/table scheduled counts; if scheduler-owned scheduledFor cells are not present, report prepared/approved/ready - awaiting scheduler instead of success. Do not call start_campaign as part of fill/schedule horizon. Do not call start_campaign as part of refill sends. Launch/start is a separate explicit human action after the operator intentionally wants sends to go out, and it must still verify that the bounded cohort is the only approved cohort and must not broad approve-all. campaignId is CampaignOffer.id. If the user asks to stop preparation, the target is wrong, or status shows the wrong campaign/table, use cancel_campaign_message_preparation only for the exact active job. Low-level selectors are diagnostics and recovery only for this lane. start_campaign remains forbidden until explicit launch/start approval outside refill sends.`,
377
377
  },
378
378
  };
379
379
  }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@sellable/mcp",
3
- "version": "0.1.398",
3
+ "version": "0.1.399",
4
4
  "type": "module",
5
5
  "description": "Sellable MCP server for Claude Code and Codex campaign workflows",
6
6
  "main": "dist/index.js",
@@ -123,6 +123,7 @@ such as "fill campaigns", "fill up", "refill sends", "max out sends", or
123
123
  ```text
124
124
  get_subskill_prompt({ subskillName: "refill-sends-workflow" })
125
125
  resolve_campaign_fill_route({ intent:"plain" })
126
+ list_senders
126
127
  get_campaign_refill_state
127
128
  ```
128
129
 
@@ -133,15 +134,27 @@ campaign refill. Route outcomes are `route:"evergreen_horizon"`,
133
134
  returns `route:"ask_create"`, ask whether to create a normal campaign or
134
135
  evergreen campaigns. Campaign creation is allowed only after this route and
135
136
  explicit user selection; it is never the default response to plain fill. When
136
- more leads are needed, the refill workflow must recommend same-campaign
137
- source-ladder replenishment; do not create warm-post-engager side campaigns,
138
- on-demand campaigns, or unrelated campaigns. Surface sender-health blockers
139
- separately from prepared/approved/scheduled counts.
137
+ choosing among active targets, use refill-state scheduled-count evidence to
138
+ continue the campaign that most recently had scheduler-owned sends for the
139
+ relevant sender set; do not treat every active campaign as a refill candidate.
140
+ In `--yolo` fill/refill mode, default to one best recent-send campaign and a
141
+ two-send-day horizon: subtract future scheduler-owned scheduled sends and
142
+ ready-to-schedule rows from healthy sender daily capacity, then prepare only
143
+ that bounded gap.
144
+ When more leads are needed, the refill workflow must recommend same-campaign
145
+ source-ladder replenishment first; do not create warm-post-engager side
146
+ campaigns, on-demand campaigns, or unrelated campaigns. If same-source copy hits
147
+ `USER_ADDED_ROWS_LIMIT_EXCEEDED`, split the current source into a bounded
148
+ same-source LinkedIn profile list, confirm that smaller list into the same
149
+ campaign, and operate on the copied review batch first. Surface sender-health
150
+ blockers separately from prepared/approved/scheduled counts.
140
151
 
141
152
  Treat active fills as capacity-fill preparation: calculate the bounded target
142
153
  from sender capacity when needed, then use the refill workflow to decide source
143
- replenishment, enrichment/prep, approval policy, and scheduler proof. Mutation
144
- requires exact visible approval and a fresh `get_campaign_refill_state` reread.
154
+ replenishment, enrichment/prep, approval policy, and scheduler proof. Present
155
+ operator decisions by campaign name and sender name first, with campaign/table
156
+ ids as proof only. Mutation requires exact visible approval and a fresh
157
+ `get_campaign_refill_state` reread.
145
158
  For already-running regular campaigns that need Signal Discovery source
146
159
  replenishment, the refill workflow owns the guarded recovery: clear
147
160
  `currentStep` only with `clearCurrentStepIfMatches:"running"`, load the
@@ -58,22 +58,6 @@ Default evergreen plan per workspace (override only if the prompt specifies diff
58
58
  1. **`<Sender Name> - Post Engagers`** — one per sender (warm lane, highest priority)
59
59
  2. **`<Workspace/Team> - Shared Signal Discovery`** — one shared warm-signal campaign lane across senders
60
60
  3. **`<Workspace/Team> - Shared Cold Fallback`** — one shared cold/fallback campaign lane across senders
61
-
62
- Sender scope resolution is safety-critical. Do not pass
63
- `allConnectedSenders:true` unless the invoking prompt explicitly says "all
64
- connected senders", "every connected sender", "all seats", or names an
65
- equivalent all-sender scope. If the user says "all 4 campaigns", "the four
66
- evergreen campaigns", or names specific senders, resolve those exact senders
67
- and pass explicit `postEngagerSenderIds` plus `sharedSenderIds`; do not broaden
68
- the plan to every connected sender. In non-interactive or `--yolo` mode, when
69
- more than two connected senders exist and the prompt does not explicitly
70
- authorize all connected senders, stop before mutation with
71
- `blocked: ambiguous_post_engager_sender_scope` and report the sender ids/names
72
- needed for approval. Never let "workspace default" silently create Post
73
- Engagers lanes for extra senders.
74
- Short form: Do not pass `allConnectedSenders:true` unless the prompt explicitly says all/every connected sender.
75
- Short form: "all 4 campaigns" means explicit sender scope plus two shared lanes, not all connected senders.
76
- Short form: In `--yolo`, ambiguous multi-sender scope blocks before mutation.
77
61
  </inputs>
78
62
 
79
63
  <command_backed_workflow>
@@ -231,8 +215,7 @@ After bounded delegated approval or safe `--yolo`, fan out lane worker tasks
231
215
  only from the current plan. Each worker receives the complete lane packet:
232
216
  workspace id, sender ids, lane key/type, existing campaign/table binding or
233
217
  create intent, source hints, caps, planRevision, actionId, allowed side effects,
234
- postconditions, the parent `postEngagerSenderIds`, the parent
235
- `sharedSenderIds`, and the packet's `workerDispatch` policy. Treat
218
+ postconditions, and the packet's `workerDispatch` policy. Treat
236
219
  `workerDispatch.requiresVisibleThreadOrDurableReceipt:true` as a hard
237
220
  execution boundary, not guidance. Read and preserve `workerDispatch.acceptedRuntimes`,
238
221
  `workerDispatch.rejectedRuntimes`, and `workerDispatch.receiptArtifactHint`
@@ -251,15 +234,6 @@ parent packet, do not mutate and do not use it as `setupPlanCall` proof; stop
251
234
  with `blocked: worker_plan_scope_drift` and ask the parent to re-plan.
252
235
  Short form: If a worker-local plan omits `postEngagerSenderIds:[]`, do not use it as `setupPlanCall` proof.
253
236
  Short form: stop with `blocked: worker_plan_scope_drift`.
254
- Every worker prompt must include both parent scope arrays as explicit fields:
255
- `Parent postEngagerSenderIds:` and `Parent sharedSenderIds:`. Workers must
256
- preserve parent postEngagerSenderIds even for shared lanes. Never run a
257
- shared-lane worker-local plan with `postEngagerSenderIds:[]` unless the parent
258
- `postEngagerSenderIds` is exactly `[]`. Every durable receipt must copy these
259
- arrays to top-level `parentPostEngagerSenderIds` and `parentSharedSenderIds`
260
- before completion.
261
- Short form: Workers must preserve parent postEngagerSenderIds even for shared lanes.
262
- Short form: Never run a shared-lane worker-local plan with `postEngagerSenderIds:[]` unless the parent `postEngagerSenderIds` is exactly `[]`.
263
237
 
264
238
  Worker fan-out must use visible or durable execution. Preferred in local Codex
265
239
  is a visible Codex thread created with the actual Codex app thread tools:
@@ -290,36 +264,10 @@ CLI builds that expose `-a`/`-s` only at top level. Do not use
290
264
  forms fail on current customer CLI installs. Pipe the lane packet prompt on
291
265
  stdin, require the worker to write `workerDispatch.receiptArtifactHint`, and
292
266
  pass exactly one lane packet per worker.
293
- When wrapping multiple local Codex CLI workers in a shell launcher, run the
294
- wrapper with `/bin/bash -lc` or another explicitly chosen portable shell. Do not
295
- rely on zsh-specific behavior. Do not use `status` as a shell variable because
296
- zsh treats it as read-only; use `exit_code` or `rc` instead. Receipt polling
297
- must use `find <receipt-dir> -maxdepth 1 -name 'evg_*.json' -print` or an
298
- explicit nullglob-safe equivalent. Do not use naked `*.json` globs under zsh,
299
- and keep zero-receipt polls quiet with no `no matches found` diagnostics.
300
- Do not embed `<<'WORKER_PROMPT'` heredocs inside a single quoted or double
301
- quoted `/bin/bash -lc '...'` command string; nested quoting is brittle and can
302
- truncate the first worker before mutation. For multi-worker launchers, write one
303
- plain prompt file per lane under the current run directory, then start each
304
- worker with `codex -a never -s danger-full-access exec -C "$REPO" -o
305
- "$worker_final_file" - < "$worker_prompt_file"`. Keep launcher shell variables
306
- double-quoted and keep the prompt heredoc only in a standalone script/prompt-file
307
- write step, not inside an already quoted shell argument. If the first launcher
308
- attempt exits with a shell parse error or before starting the first worker,
309
- stop with `blocked: worker_launcher_quoting_failed` and do not retry by
310
- loosening sender scope or mutating in the parent.
311
- Short form: run the wrapper with `/bin/bash -lc`.
312
- Short form: Do not rely on zsh-specific behavior.
313
- Short form: Do not use `status` as a shell variable; use `exit_code` or `rc`.
314
- Short form: Receipt polling uses `find <receipt-dir> -maxdepth 1 -name 'evg_*.json' -print`.
315
- Short form: Do not use naked `*.json` globs under zsh; no `no matches found` diagnostics.
316
- Short form: Do not embed `<<'WORKER_PROMPT'` heredocs inside a quoted `/bin/bash -lc` command string.
317
- Short form: Multi-worker launchers write prompt files and run `codex ... - < "$worker_prompt_file"`.
318
267
  After creating receipt directories, dispatch workers immediately; do not perform extended parent reasoning, extra inventory, or prompt rewriting loops.
319
268
  Use a compact worker prompt: include lane packet JSON, original selectedActionIds,
320
- original planRevision, parent postEngagerSenderIds, parent sharedSenderIds,
321
- receiptArtifactPath, workspace id, sender ids, side-effect caps, and the
322
- 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.
323
271
  Do not paste the entire wrapper skill into worker prompts. If the parent cannot
324
272
  launch at least one visible/durable worker immediately after directory setup,
325
273
  stop with `blocked: worker_dispatch_stalled` before any mutation.
@@ -328,11 +276,8 @@ current lane packet for receipt paths.
328
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.
329
277
  After the receipt-directory `mkdir`, the next shell/tool call must launch the first lane worker.
330
278
  Do not run `find`, `ls`, extra inventory, or another preflight between directory setup and the first worker launch.
331
- For the local Codex CLI fallback, use this literal durable CLI worker launch
332
- template and fill only the lane-specific placeholders. For one-off direct worker
333
- launches you may pipe a heredoc directly to `codex`; for multi-worker shell
334
- launchers, write the same prompt body to `<worker-prompt-file>` and launch the
335
- 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:
336
281
 
337
282
  ```
338
283
  codex -a never -s danger-full-access exec -C <repo> -o <worker-final-file> - <<'WORKER_PROMPT'
@@ -341,8 +286,6 @@ Use $sellable:create-evergreen-campaigns as the governing skill for this one lan
341
286
  Workspace id: <workspaceId>
342
287
  Parent planRevision: <planRevision>
343
288
  Parent selectedActionIds: <selectedActionIds JSON>
344
- Parent postEngagerSenderIds: <postEngagerSenderIds JSON>
345
- Parent sharedSenderIds: <sharedSenderIds JSON>
346
289
  Action id: <actionId>
347
290
  Lane key: <laneKey>
348
291
  Allowed side effects: <allowedSideEffects JSON>
@@ -356,9 +299,6 @@ Use mcp__sellable only. Do not use admin tools, direct DB, Prisma, SQL, web sear
356
299
  Do not launch, start, schedule, send, or use paid InMail.
357
300
  Complete only this lane, write the required durable receipt JSON, and stop.
358
301
  WORKER_PROMPT
359
-
360
- # Multi-worker launcher equivalent:
361
- codex -a never -s danger-full-access exec -C <repo> -o <worker-final-file> - < <worker-prompt-file>
362
302
  ```
363
303
 
364
304
  If any placeholder cannot be filled from the current lane packet, do not inspect
@@ -428,14 +368,7 @@ not a parent-thread summary. The receipt must include:
428
368
  `senderIds`, `campaignId`, `tableId`, and `createIntent`. Do not use
429
369
  `laneActionId`, `lanePacketActionId`, `delegatedPlanRevision`,
430
370
  `delegatedActionId`, or freeform `requestedCall` text as a substitute for
431
- these fields. For create lanes, `setupPlanCall.campaignId` and
432
- `setupPlanCall.tableId` must be the actual created campaign/table ids after
433
- creation and readback. If the parent lane packet carried null ids before
434
- creation, preserve that original packet only in a separate `parentLanePacket`
435
- object; do not leave `setupPlanCall.campaignId:null` or
436
- `setupPlanCall.tableId:null`.
437
- Short form: For create lanes, `setupPlanCall.campaignId` and `setupPlanCall.tableId` must be the actual created campaign/table ids.
438
- Short form: Do not leave `setupPlanCall.campaignId:null` or `setupPlanCall.tableId:null`.
371
+ these fields.
439
372
  - `createCampaignWorkflowReceipt`: proof the worker loaded the actual installed
440
373
  `$sellable:create-campaign` wrapper instead of doing ad hoc MCP calls. It must
441
374
  include `skillCommand:"$sellable:create-campaign"`,
@@ -490,25 +423,8 @@ not a parent-thread summary. The receipt must include:
490
423
  evidence field such as `rowCount`, `rowIdsHash`, or `rowEvidence`; do not
491
424
  leave those only in `searchSignalsProof`, `importProof`, `coldFallbackProof`,
492
425
  or narrative text for the parent/verifier to infer.
493
- - `filterDecisionReceipt`: saved/applied ICP filter proof for the current
494
- campaign/table basis. Customer-visible evergreen lanes must enable ICP
495
- filtering with `enableICPFilters:true`, call `save_rubrics`, and save at
496
- least three rubric/filter criteria before Message Drafting. Do not skip
497
- filtering for evergreen setup. Missing or skipped filter proof is
498
- `blocked: missing_filter_setup`.
499
- Before the worker exits, the durable JSON must contain
500
- `filterDecisionReceipt.status:"applied"`,
501
- `filterDecisionReceipt.enableICPFilters:true`, the current
502
- `workflowTableId`, and concrete saved-filter proof such as
503
- `filterDecisionReceipt.filterIds`, `filterDecisionReceipt.rubricIds`,
504
- `filterDecisionReceipt.savedRubricCount`, or
505
- `filterDecisionReceipt.headlineICPCriteria`.
506
- The exact status string is contractual: use `status:"applied"` only.
507
- Do not write `status:"confirmed"`, `status:"saved"`, `status:"done"`, or
508
- any other alias after saving filters; the parent verifier rejects those
509
- aliases even when saved rubric proof exists.
510
- Short form: Filter receipt status must be exactly `applied`.
511
- 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.
512
428
  - `messageDraftingReceipt`: the Message Drafting proof described below,
513
429
  including packaged `generate-messages` prompt/assets and validation. Raw
514
430
  fields like `generateMessagesPromptLoadedToHasMoreFalse`,
@@ -644,12 +560,7 @@ verification unless the same object also appears inside
644
560
  "sourceLadderReason": "<why the current source is valid before colder sources>"
645
561
  },
646
562
  "filterDecisionReceipt": {
647
- "status": "applied",
648
- "enableICPFilters": true,
649
- "filterIds": ["<saved filter/rubric id>"],
650
- "rubricIds": ["<saved rubric id>"],
651
- "headlineICPCriteria": ["<saved ICP criterion>", "<saved ICP criterion>", "<saved ICP criterion>"],
652
- "savedRubricCount": 3,
563
+ "status": "skipped",
653
564
  "workflowTableId": "<workflow table id>"
654
565
  },
655
566
  "messageDraftingReceipt": {
@@ -730,19 +641,6 @@ path itself in the worker thread:
730
641
  exactly one semantic Approved cell through `select_campaign_cells` and
731
642
  `update_cell`.
732
643
  Approval shorthand: approve exactly one semantic Approved cell.
733
- In this message-drafting path, `update_cell` is allowed only for the semantic
734
- Approved checkbox. Do not use `update_cell` or any row/cell write to edit
735
- generated message text, sample copy, or final message bodies in automation.
736
- If generated copy fails review, update the campaign brief/message template
737
- with `update_campaign_brief` or `revise_message_template_and_rerun`, then
738
- rerun Generate Message and review current-revision generated output. Receipt
739
- `sampleMessages` must come from generated current-revision cells after the
740
- brief/template rerun, not from hand-edited message cell overrides. If a lane
741
- used a generated-message body override, report
742
- `blocked: generated_message_cell_override` instead of success.
743
- Short form: `update_cell` is allowed only for the semantic Approved checkbox.
744
- Short form: Do not use `update_cell` to edit generated message text.
745
- Short form: Bad copy requires brief/template revision plus Generate Message rerun.
746
644
  4. Poll `get_campaign_message_preparation_status` until no queued/active cells
747
645
  remain or a bounded stop reason is returned.
748
646
  5. Use `get_campaign_messages_preview` or `select_campaign_cells` to inspect
@@ -769,26 +667,6 @@ The only accepted statusSource values are exactly `branch` and
769
667
  `packaged-generate-messages-worker`; descriptive aliases such as
770
668
  `package-readback-local-thread` are rejected.
771
669
 
772
- Before any provider-specific source mutation for a newly created campaign,
773
- reread `get_campaign_navigation_state({ campaignId })` and use that product
774
- navigation state as the source-step authority. Do not jump from a shell directly
775
- into `contact-search`, and do not jump from a shell directly into
776
- `signal-discovery`. Advance through the product-visible source-selection step
777
- first, then load the provider prompt and write only the provider/source fields
778
- accepted for that current step. Never include sender reassignment fields in
779
- source-step updates, never include custom narration fields in source-step
780
- updates, and do not use guessed `currentStep` or watched narration payloads to
781
- force the flow forward. If `update_campaign` rejects the source transition
782
- twice, reread navigation/campaign state once; if the campaign is not already on
783
- the intended source step, stop the lane with
784
- `blocked: watched_source_transition_blocked` and include the rejected tool
785
- result plus the readback. Do not loop on rejected `update_campaign` transitions.
786
- Short form: do not jump from a shell directly into `contact-search`.
787
- Short form: do not jump from a shell directly into `signal-discovery`.
788
- Short form: never include sender reassignment fields in source-step updates.
789
- Short form: never include custom narration fields in source-step updates.
790
- Short form: do not loop on rejected `update_campaign` transitions.
791
-
792
670
  One lane may produce exactly one CampaignOffer/campaign id and one current
793
671
  workflow table id. For `intent:"create"`, the first successful
794
672
  `create_campaign` result establishes the lane's only allowed campaign/table
@@ -827,14 +705,9 @@ the prospect's engagement unless the selected source evidence proves that exact
827
705
  sender authored the post.
828
706
  Shared lanes must reject generic product-summary samples that explain the
829
707
  product in the same broad words for every row. Shared lanes must reject three
830
- nearly identical samples after stripping the leading name. Shared lanes must
831
- fail quality review when any reviewed sample has non-empty `issues`; do not
832
- approve or final-report samples with `verdict:"passed"` and non-empty `issues`.
833
- If any of these failures appears, revise or rerun the packaged
834
- create-campaign/generate-messages path from the lane worker before writing a
835
- success receipt.
836
- Short form: Shared lanes must fail quality review when any reviewed sample has non-empty `issues`.
837
- 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.
838
711
  The generated-message cells are not prompt proof: `currentRevisionGeneratedMessages`,
839
712
  Generate Message column counts, `messagesCount`, or rendered row previews prove
840
713
  only that table cells exist from the current brief/template, not that the
@@ -854,22 +727,6 @@ duplicate-lane blockers before you call the command finished. If verify blocks,
854
727
  report the blocker and repair only the missing postconditions from the same
855
728
  current plan.
856
729
 
857
- Before calling verify, the parent should build compact receipt objects from the
858
- durable receipt files and pass those compact objects to MCP. The compact receipt
859
- must preserve every verifier-owned field named above, including top-level ids,
860
- `createCampaignStepReceipt`, canonical filter/message/review/sequence/final
861
- proof, and at least three concrete sample messages. It should omit large raw
862
- search outputs, long post lists, full row arrays, raw provider responses, and
863
- debug-only narration fields. Do not pass multi-hundred-kilobyte raw receipt
864
- objects when a compact canonical receipt has the same proof; large raw verify
865
- payloads can stall local MCP bridges and make UAT ambiguous.
866
- Do not print or `jq .` full receipt JSON into the terminal. For local checks,
867
- print only compact summaries such as file, actionId, laneKey, campaignId,
868
- filter status, sample count, approved count, and final status.
869
- Short form: Parent verify uses compact canonical receipt objects, not raw giant receipts.
870
- Short form: Do not dump full receipt JSON with `jq .`.
871
- Short form: Never change planRevision/actionId/laneKey while compacting receipts.
872
-
873
730
  Message proof for every customer-visible lane must come from the current
874
731
  campaign/table basis and include at least 3 generated review rows from the
875
732
  packaged `generate-messages` path before completion is reported.
@@ -908,8 +765,6 @@ Parent-thread handwritten copy or setting `currentStep` is not proof.
908
765
  Short form: Do not pass the warm template into Shared Signal Discovery or Shared Cold Fallback.
909
766
  Short form: Shared lanes must reject generic product-summary samples.
910
767
  Short form: Shared lanes must reject three nearly identical samples.
911
- Short form: Shared lanes must reject low-confidence relevance hedges.
912
- Short form: Shared lanes must reject internal workflow vocabulary.
913
768
  Short form: revise or rerun the packaged create-campaign/generate-messages path.
914
769
  - **Post Engagers** first-message style: short, casual, references the
915
770
  sender-authored post they engaged with, closed question, **no internal
@@ -920,7 +775,7 @@ Parent-thread handwritten copy or setting `currentStep` is not proof.
920
775
 
921
776
  Hey there
922
777
 
923
- Thank you for the support on my post about {{post_topic_line}}
778
+ Thanks for the support on my post about {{post_topic_line}}
924
779
  ```
925
780
 
926
781
  - **Shared Signal Discovery** first-message style: short, casual, references
@@ -936,22 +791,6 @@ Parent-thread handwritten copy or setting `currentStep` is not proof.
936
791
  say it. Prefer sender-agnostic company/team language such as "we're
937
792
  helping CX teams..." or "at cxconnect.ai, we help..." and one clear
938
793
  problem question.
939
- Before Message Drafting runs, the campaign brief must already include
940
- these shared-lane hard avoids and source-use rules. Do not rely on a
941
- failed first generation batch to discover that self-intros, generic
942
- product summaries, or repeated structure are bad. If the first generated
943
- batch violates these rules, rerun, but record that as a repaired UAT path
944
- rather than the desired zero-shot path.
945
- Do not use low-confidence relevance hedges such as "hope this is
946
- relevant" in Shared Signal Discovery samples. Translate source/tool terms
947
- into prospect-facing business language; do not put internal workflow
948
- vocabulary such as "Codex-style workflow", "MCP", "agent workflows", or
949
- "Claude-style agent workflows" in customer-facing message one.
950
- Short form: Shared Signal Discovery uses no self-intro such as "I'm building Sellable".
951
- Short form: Shared Signal Discovery uses no self-intro such as "We're building Sellable".
952
- Short form: Shared Signal Discovery uses no "I've put together".
953
- Short form: no low-confidence relevance hedge such as "hope this is relevant".
954
- Short form: no internal workflow vocabulary such as "Codex-style workflow", "MCP", "agent workflows", or "Claude-style agent workflows".
955
794
  - **Shared Cold Fallback** first-message style: cold, direct, and cohesive.
956
795
  It must not pretend there was engagement, must not say "saw you pop up",
957
796
  and must not use a standalone name line followed by "Hey there" or other
@@ -966,52 +805,14 @@ Parent-thread handwritten copy or setting `currentStep` is not proof.
966
805
  Sellable/Codex/Claude-Code feature summary
967
806
  across prospects. This is a single-message cold path unless the approved
968
807
  create-campaign message workflow proves a better delivery format.
969
- Do not open with "hope this is relevant" or a similar low-confidence
970
- relevance hedge. Do not use a repeated product-definition paragraph such
971
- as "Sellable is a GTM system" across samples; every reviewed cold sample
972
- should be specific enough to the role, company, or problem that the three
973
- sample messages do not share the same body skeleton.
974
- Before Message Drafting runs, the campaign brief must already forbid
975
- self-intros, generic product summaries, opt-out shrugs, product-stack
976
- dumps, and repeated template structure. Do not let the first generation
977
- batch use "I'm building", "We're building", "I've put together", or
978
- similar language and then rely on a cleanup rerun as the normal path.
979
808
  Short form: Shared Cold Fallback must not pass just because the receipt says `generate-messages` loaded.
980
809
  Short form: Shared Cold Fallback uses no self-intro such as "We're building".
981
- Short form: Shared Cold Fallback uses no self-intro such as "I'm building Sellable".
982
- Short form: Shared Cold Fallback uses no "I've put together".
983
810
  Short form: Shared Cold Fallback uses no opt-out shrug such as "If this isn't relevant, ignore me".
984
811
  Short form: Shared Cold Fallback uses no product-stack dump.
985
- Short form: no low-confidence relevance hedge such as "hope this is relevant".
986
- Short form: no repeated product-definition paragraph such as "Sellable is a GTM system".
987
- - Customer-visible evergreen lanes must enable ICP filtering before Message
988
- Drafting. This applies to Post Engagers, Shared Signal Discovery, and
989
- Shared Cold Fallback. Do not skip filtering for evergreen setup, even when
990
- the source is warm. Use the normal `$sellable:create-campaign` filter
991
- workflow: set or save 3-5 headline ICP criteria, call `save_rubrics`, and
992
- persist `enableICPFilters:true` on the campaign before generating
993
- messages. Good evergreen filters should be light but real: role/budget
994
- relevance, company/market fit, and obvious non-buyer exclusion. For
995
- Post Engagers, keep filters permissive enough that warm source rows are not
996
- over-pruned, but still save the filter rules. For shared lanes, filter for
997
- buyers/operators relevant to the workspace offer and exclude students,
998
- job seekers, vendors, and off-topic commenters. The receipt must show
999
- `filterDecisionReceipt.status:"applied"`,
1000
- `filterDecisionReceipt.enableICPFilters:true`, current `workflowTableId`,
1001
- and saved filter/rubric proof with at least three saved rubric/filter
1002
- criteria (`filterIds`, `rubricIds`, `headlineICPCriteria`, or
1003
- `savedRubricCount`). Missing or skipped filter proof is
1004
- `blocked: missing_filter_setup`.
1005
- Short form: Customer-visible evergreen lanes must enable ICP filtering.
1006
- Short form: `enableICPFilters:true`.
1007
- Short form: Do not skip filtering for evergreen setup.
1008
- Short form: at least three saved rubric/filter criteria.
1009
- Short form: missing or skipped filter proof is `blocked: missing_filter_setup`.
1010
- Short form: run Message Drafting only after saved filters are applied.
1011
- - Every customer-visible lane must run Message Drafting from the current
1012
- campaign/table basis after source rows exist. The worker must load the full
1013
- packaged `generate-messages` prompt, every required asset, and
1014
- `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
1015
816
  callable in the packaged runtime, the worker must call
1016
817
  `start_campaign_message_preparation` and poll
1017
818
  `get_campaign_message_preparation_status` from the lane worker. The
@@ -1041,13 +842,10 @@ Parent-thread handwritten copy or setting `currentStep` is not proof.
1041
842
  - A source/list decision has been resolved and campaign rows are loaded. If
1042
843
  there is no approved source or no rows can be copied, report `blocked` with
1043
844
  the missing source detail; do not call the campaign complete.
1044
- - The filter step is resolved with saved/applied filters. Customer-visible
1045
- evergreen lanes must have `enableICPFilters:true`, at least three saved
1046
- ICP filter/rubric criteria, and a receipt with
1047
- `filterDecisionReceipt.status:"applied"`. Do not skip filters for
1048
- evergreen setup. Do not leave customer-visible campaigns at
1049
- `filter-choice`, `filter-rules`, or `apply-icp-rubric` and report success.
1050
- 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.
1051
849
  - Message Drafting has run from the current campaign/table basis, using the
1052
850
  create-campaign message prompt/assets and validation gate. Updating
1053
851
  `currentStep:"messages"` is not proof. Parent-thread handwritten copy is
@@ -1066,17 +864,13 @@ Parent-thread handwritten copy or setting `currentStep` is not proof.
1066
864
  reviewed sample messages. For Shared Cold Fallback, reject samples that
1067
865
  open with a standalone name followed by "Hey there" or a similarly generic
1068
866
  greeting. For Shared Cold Fallback, also reject samples with a self-intro
1069
- such as "We're building", "I'm building Sellable", or "I've put
1070
- together", an opt-out shrug such as "If this isn't relevant, ignore me",
1071
- 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
1072
869
  Sellable/Codex/Claude-Code feature summary across prospects. For all
1073
870
  shared lanes, reject generic product-summary samples, repeated
1074
- near-identical samples, low-confidence relevance hedges such as "hope this
1075
- is relevant", internal workflow vocabulary, any sample with non-empty
1076
- `issues`, and any preserved Post Engagers opener; revise or rerun the packaged
1077
- create-campaign/generate-messages path before reporting completion. Do not
1078
- approve or final-report samples with `verdict:"passed"` and non-empty
1079
- `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.
1080
874
  - The first review batch exists and at least 3 review rows have generated
1081
875
  messages from the approved brief. If fewer than 3 usable rows exist, report
1082
876
  the actual count and why.
@@ -1150,9 +944,7 @@ Parent-thread handwritten copy or setting `currentStep` is not proof.
1150
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.
1151
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.
1152
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.
1153
- 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.
1154
- If the `Sample Messaging Review` section is omitted, the command is incomplete even when the structural campaign setup succeeded.
1155
- 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:
1156
948
 
1157
949
  ```
1158
950
  Evergreen Reconcile — {date}
@@ -1161,17 +953,6 @@ Evergreen Reconcile — {date}
1161
953
  • Sellable.dev - Shared Signal Discovery: repaired (send review ready; 50 rows, 3 generated, 1 approved gate row, sequence attached, paused)
1162
954
  • Sellable.dev - Shared Cold Fallback: created (send review ready; 50 rows, 3 generated, 1 approved gate row, sequence attached, paused)
1163
955
  All campaigns remain unlaunched. Next: enrich/approve more rows when you want more items ready to schedule.
1164
-
1165
- Sample Messaging Review
1166
- • Christian Reyes - Post Engagers (`cmp_...`, row `row_...`, verdict: passed)
1167
- ```
1168
- {{full generated first message}}
1169
- ```
1170
- • Sellable.dev - Shared Cold Fallback (`cmp_...`, row `row_...`, verdict: passed)
1171
- ```
1172
- {{full generated first message}}
1173
- ```
1174
- If any sample is not quite right, ask the AI to update the campaign brief/message template and rerun Generate Message before launch.
1175
956
  ```
1176
957
  </objective>
1177
958
 
@@ -5,6 +5,9 @@ visibility: public
5
5
  allowed-tools:
6
6
  - mcp__sellable__get_subskill_prompt
7
7
  - mcp__sellable__search_subskill_prompts
8
+ - mcp__sellable__list_senders
9
+ - mcp__sellable__get_sender_routing
10
+ - mcp__sellable__get_campaign_waterfall
8
11
  - mcp__sellable__resolve_campaign_fill_route
9
12
  - mcp__sellable__get_campaign_refill_state
10
13
  - mcp__sellable__fill_campaign_horizon
@@ -35,6 +38,7 @@ allowed-tools:
35
38
  - mcp__sellable__get_table_rows
36
39
  - mcp__sellable__get_campaign_table_schema
37
40
  - mcp__sellable__select_campaign_cells
41
+ - mcp__sellable__queue_campaign_cells
38
42
  - mcp__sellable__wait_for_campaign_processing
39
43
  - mcp__sellable__get_sender
40
44
  ---
@@ -51,10 +55,39 @@ get_subskill_prompt({ subskillName: "refill-sends-workflow" })
51
55
  ```
52
56
 
53
57
  Then follow that workflow exactly. The default path is read-only research:
54
- resolve the route, read target refill state, report the next safe step, and stop
55
- before mutation unless the user has explicitly approved the exact workspace,
56
- campaign/table/source ids, caps/dates, approval mode, expected side effects,
57
- and stop/rollback condition.
58
+ resolve the route, identify the sender-relevant campaign that most recently had
59
+ scheduler-owned sends, read refill state for that target, report the next safe
60
+ step using campaign names first, and stop before mutation unless the user has
61
+ explicitly approved the exact workspace, campaign/table/source ids, caps/dates,
62
+ approval mode, expected side effects, and stop/rollback condition.
63
+
64
+ For interactive Codex or Claude Code sessions, that approval must use the
65
+ host-native structured question gate, not plain chat:
66
+
67
+ - Codex: use `request_user_input`.
68
+ - Claude Code: use `AskUserQuestion`.
69
+
70
+ The approval question must present the final refill step with exactly two
71
+ choices: `Accept` and `Decline`. Treat `Accept` as permission for only the
72
+ rendered target, caps, mode, and side effects. Treat `Decline` as a hard stop
73
+ with no mutation.
74
+
75
+ If Christian includes `--yolo` in the same refill request, treat that flag as
76
+ auto-accept for the rendered bounded refill packet after the required fresh state
77
+ reread. `--yolo` only covers the exact target, caps, approval mode, and side
78
+ effects in the packet. It does not authorize launch/start, sending, archive or
79
+ delete cleanup, direct scheduler writes, sender reassignment, or any expanded
80
+ target set. Stop and re-plan if the route, ids, caps, blockers, or side-effect
81
+ class drift before mutation.
82
+
83
+ In `--yolo`, the default two-day fill horizon is two send days. The workflow must pick
84
+ the best recent-send campaign first, not every active campaign, and compute the
85
+ bounded gap from healthy sender daily capacity, existing future scheduled sends,
86
+ and rows already ready to schedule. If a same-source copy hits the campaign-table
87
+ row cap, split the current source into a bounded LinkedIn profile source list,
88
+ confirm only that smaller list into the same campaign, and operate on the copied
89
+ review batch. Do not fall back to on-demand campaigns or broad active-campaign
90
+ fills.
58
91
 
59
92
  Public concepts are regular campaign and evergreen campaign. Internal direct
60
93
  campaign types are unsupported refill targets. `fill_campaign_horizon` is only a
@@ -3,6 +3,9 @@ name: refill-sends-workflow
3
3
  description: Internal skill-led refill sends workflow for regular campaigns and evergreen campaigns.
4
4
  visibility: internal
5
5
  allowed-tools:
6
+ - mcp__sellable__list_senders
7
+ - mcp__sellable__get_sender_routing
8
+ - mcp__sellable__get_campaign_waterfall
6
9
  - mcp__sellable__resolve_campaign_fill_route
7
10
  - mcp__sellable__get_campaign_refill_state
8
11
  - mcp__sellable__fill_campaign_horizon
@@ -33,6 +36,7 @@ allowed-tools:
33
36
  - mcp__sellable__get_table_rows
34
37
  - mcp__sellable__get_campaign_table_schema
35
38
  - mcp__sellable__select_campaign_cells
39
+ - mcp__sellable__queue_campaign_cells
36
40
  - mcp__sellable__wait_for_campaign_processing
37
41
  - mcp__sellable__get_sender
38
42
  ---
@@ -52,11 +56,27 @@ Plain phrases that enter here include "fill", "refill sends", "max out sends",
52
56
  fill/load language, `intent:"active"` only when the user explicitly narrowed
53
57
  to active regular campaigns, and `intent:"evergreen"` only when the user
54
58
  explicitly asked for evergreen or horizon work.
55
- 2. Pick exact ids from the resolver result. Do not use campaign names or table
56
- names as target identifiers.
57
- 3. Call `get_campaign_refill_state` for the selected `campaignId` or `tableId`.
58
- This must be the next target-specific research primitive.
59
- 4. Classify the target from refill state:
59
+ 2. Resolve sender context before choosing a target. Call `list_senders`; when a
60
+ managed program is involved, also call `get_campaign_waterfall`, and call
61
+ `get_sender_routing` when territory rules may constrain sender eligibility.
62
+ If the user named senders, map those names to exact sender ids. If the user
63
+ did not name senders, infer the relevant senders from the most recent
64
+ scheduler-owned sends in refill-state readbacks and report that inference.
65
+ Short form: infer from the most recent scheduler-owned sends when the sender set is not explicit.
66
+ 3. Read `get_campaign_refill_state` for candidate campaigns from the resolver
67
+ result. For a broad `active_campaigns` route, inspect enough candidates to
68
+ identify the campaign or small campaign set that most recently had
69
+ scheduler-owned sends for the relevant sender set. Do not stop after the
70
+ first resolver target unless it is also the most recent sender-relevant send
71
+ lane.
72
+ Short form: Do not stop after the first resolver target unless recent-send evidence supports it.
73
+ In `--yolo` mode, selecting every active campaign is a scope error. Pick the
74
+ single highest-ranked recent-send campaign unless the refill-state evidence
75
+ proves multiple distinct sender lanes need separate two-day fills.
76
+ Short form: `--yolo` selects the best recent-send campaign first, not all active campaigns.
77
+ 4. Pick exact ids from the selected refill-state response. Do not use campaign
78
+ names or table names as target identifiers for tool calls.
79
+ 5. Classify the target from refill state:
60
80
  - regular campaign: campaign-backed workflow table with normal source,
61
81
  sequence, senders, and send/refill stages.
62
82
  - evergreen campaign: managed always-on lane with current source evidence.
@@ -77,7 +97,10 @@ Use the refill-state response as the current facts receipt:
77
97
  approved, ready to schedule, scheduled;
78
98
  - active message prep job;
79
99
  - scheduler-owned scheduled counts by date/action from cells with non-null
80
- `scheduledFor`;
100
+ `scheduledFor`; treat these as the last sends/continuation signal;
101
+ - latest scheduled send date, latest scheduled-cell update when present,
102
+ sender overlap with the requested or inferred sender set, and whether future
103
+ scheduled sends already exist;
81
104
  - `freshness.stateHash` and exact campaign/table/workspace ids.
82
105
 
83
106
  Empty or unsafe states stop with the blocker: no fillable target, missing or deleted campaign,
@@ -89,9 +112,61 @@ scheduler, or unsupported direct campaign type.
89
112
 
90
113
  For regular campaign workspaces, rank regular campaigns from route and
91
114
  `get_campaign_refill_state` evidence. Choose the best existing refill target.
115
+ The default refill interpretation is "continue the campaign that was actually
116
+ sending most recently for the relevant available senders", not "touch every
117
+ active campaign".
118
+
119
+ Default `--yolo` horizon is two send days when the user asks to fill, refill,
120
+ load, or max sends without naming a different horizon. Compute the target from
121
+ the selected campaign's healthy sender daily capacity for the next two send
122
+ days, minus already scheduler-owned future scheduled sends for those days and
123
+ minus rows already ready to schedule. If `readyToSchedule` already covers the
124
+ two-day gap, do not add rows or prep; report that the selected campaign is loaded
125
+ and awaiting the scheduler. If the gap is positive, prepare only the gap and keep
126
+ all source-copy/prep caps tied to that two-day packet.
127
+ Short form: default `--yolo` refill target is the selected campaign's two-day send gap.
128
+
129
+ Rank candidates in this order:
130
+
131
+ 1. **Sender match**: campaigns whose healthy sender ids match the user-named
132
+ senders, or the inferred sender set when the user said only "fill sends" or
133
+ "load senders". Do not include campaigns merely because they are active when
134
+ their sender set is unrelated.
135
+ 2. **Recent sends**: campaigns with the newest scheduler-owned scheduled counts
136
+ and non-null `scheduledFor` cells for those senders. Future scheduled sends
137
+ are stronger continuation evidence than old historical sends; otherwise use
138
+ the latest scheduled send date / newest scheduled-cell update from refill
139
+ state.
140
+ 3. **Continuation capacity**: campaigns with healthy senders, remaining daily
141
+ capacity, and a gap between current ready-to-schedule rows and the desired
142
+ sender capacity.
143
+ 4. **Same-campaign source health**: prefer campaigns whose current source has
144
+ enough `sourceAvailable` inventory to prepare the gap. If source inventory
145
+ is low or exhausted, choose same-campaign row replenishment before switching
146
+ campaigns.
147
+ 5. **Campaign scope**: keep the selected set small. Normally choose one
148
+ campaign; choose multiple only when the recent-send evidence shows multiple
149
+ distinct sender lanes are actively being filled.
150
+
92
151
  Do not create side campaigns, warm-post-engager side campaigns, on-demand campaigns,
93
152
  or unrelated campaigns as the default answer to a fill request.
94
153
 
154
+ For each selected campaign, decide the next action by the smallest sufficient
155
+ step:
156
+
157
+ - **Enrich/prep more rows in the same campaign** when sender health is good,
158
+ recent sends point to this campaign, and `sourceAvailable` can cover the
159
+ ready-to-schedule gap.
160
+ - **Add/import more rows to the same campaign/source path** when the campaign is
161
+ the right recent-send lane but source inventory or viable rows cannot cover
162
+ the gap.
163
+ - **Use a different existing campaign** only when the recent-send campaign is
164
+ blocked, archived, missing sequence/source/senders, disconnected, exhausted
165
+ with no viable same-campaign replenishment path, or the user explicitly asks
166
+ to move to another campaign.
167
+ - **Ask what to create** only after resolver/state evidence shows there is no
168
+ suitable existing campaign for the requested sender set.
169
+
95
170
  When the best regular campaign is source-exhausted, recommend same-campaign source-ladder replenishment.
96
171
  Keep `selectedLeadListId` source identity distinct
97
172
  from the campaign `workflowTableId`.
@@ -109,6 +184,30 @@ Source replenishment choices:
109
184
  source prospects into the same campaign/source-list path, then confirm
110
185
  readiness.
111
186
 
187
+ When reusing an existing source list on an already-large campaign, handle the
188
+ campaign-table row cap automatically in `--yolo` mode. If `confirm_lead_list`
189
+ fails with `USER_ADDED_ROWS_LIMIT_EXCEEDED`, parse `remainingRows`,
190
+ `currentRows`, `requestedRows`, and `maxRows`; do not stop just because the full
191
+ source list is too large. Instead, create a bounded same-source split:
192
+
193
+ 1. choose a split size no larger than `remainingRows`, the two-day refill row
194
+ budget, and the first-pass processing cap unless the packet named a higher
195
+ cap;
196
+ 2. read compact rows from the current `selectedLeadListId` with
197
+ `get_rows_minimal`;
198
+ 3. create a temporary bounded LinkedIn profile source list with
199
+ `load_csv_linkedin_leads`, preserving useful source columns such as post URL,
200
+ post author, engagement type/text, keyword, confidence, and why;
201
+ 4. call `confirm_lead_list` with that bounded source-list id, the same campaign
202
+ id, and `currentStep:"running"` for ACTIVE campaigns;
203
+ 5. verify the campaign table row count and review batch with
204
+ `get_campaign_table_schema` before any prep/approval.
205
+
206
+ Do not use `add_on_demand_leads` or create an on-demand table as the automatic
207
+ regular-campaign fallback. The fallback must stay same-campaign and
208
+ source-list-backed.
209
+ Short form: row-cap fallback means bounded same-source split, not stop or on-demand.
210
+
112
211
  ### Running Campaign Signal Discovery Recovery
113
212
 
114
213
  For an already-running regular campaign that needs same-campaign Signal
@@ -146,10 +245,10 @@ returns to Running after same-campaign source rows are copied. Do not call
146
245
  post-copy state transition.
147
246
 
148
247
  Before any source mutation, show exact approval evidence: workspace id,
149
- campaign id, workflow table id, source/provider id, source-list id when known,
150
- import caps, target dates/caps, dedupe/DNC/provider exclusion expectations, and
151
- expected row side effects. Then reread `get_campaign_refill_state`; if
152
- `freshness.stateHash` or exact ids changed, stop and ask for a fresh approval.
248
+ campaign name, campaign id, workflow table id, source/provider id, source-list
249
+ id when known, import caps, target dates/caps, dedupe/DNC/provider exclusion expectations, and expected row side effects. Present the campaign name and plain-English reason first; include ids only as proof and execution targets.
250
+ Then reread `get_campaign_refill_state`; if `freshness.stateHash` or exact ids
251
+ changed, stop and ask for a fresh approval.
153
252
 
154
253
  After source import, call `wait_for_lead_list_ready` and `confirm_lead_list`
155
254
  with the source-list id and campaign id. Imports append to the existing
@@ -179,18 +278,71 @@ Before prep or approval mutation, reread `get_campaign_refill_state` and compare
179
278
  If they changed, stop. A second concurrent refill run must see the first run's
180
279
  import/prep state on reread and avoid duplicate work.
181
280
 
281
+ After the final reread and before the first mutating refill primitive, render
282
+ one final approval packet in campaign-name-first language, then ask a
283
+ host-native structured question with exactly two choices: `Accept` and
284
+ `Decline`. The question is the execution boundary.
285
+ Short form: exactly two choices: `Accept` and `Decline`.
286
+
287
+ - In Codex interactive sessions, use `request_user_input`.
288
+ - In Claude Code interactive sessions, use `AskUserQuestion`.
289
+ - The `Accept` choice must name the exact campaign, workspace id, campaign id,
290
+ workflow table id, source/action ids when relevant, caps/dates, approval mode,
291
+ expected side effects, and stop/rollback condition.
292
+ - The `Decline` choice must stop with no mutation.
293
+ - Do not proceed from a plain chat "ok", "yes", "go", or "do it" when the
294
+ structured question tool is available. If the structured question tool is not
295
+ available in an interactive session, stop and tell the user the quick question
296
+ panel is required for refill approvals. In non-interactive exec/automation,
297
+ print the approval packet and stop before mutation.
298
+
299
+ `--yolo` mode is explicit auto-accept. If Christian includes `--yolo` in the
300
+ same refill request, do not ask the `Accept` / `Decline` question. Instead:
301
+
302
+ 1. render the same final approval packet;
303
+ 2. reread `get_campaign_refill_state`;
304
+ 3. verify the route, workspace id, campaign id, table id, source/action ids,
305
+ caps/dates, approval mode, blockers, and side-effect class still match the
306
+ packet;
307
+ 4. execute only the exact packet.
308
+
309
+ `--yolo` never authorizes launch/start, sending, archive/delete cleanup, raw
310
+ scheduler writes, sender reassignment, unrelated campaigns, expanded campaign
311
+ sets, or higher caps than the packet named. If any state or scope drifts, stop
312
+ and re-plan instead of auto-accepting the changed action.
313
+ Short form: expanded campaign sets are not covered by `--yolo`.
314
+ Short form: direct scheduler writes are not covered by `--yolo`.
315
+ Short form: stop and re-plan instead of auto-accepting the changed action.
316
+
182
317
  After same-campaign source copy, inspect the actual campaign-table position of
183
318
  the copied rows before starting prep. Newly copied rows often land after the first 100 table rows. Use `get_campaign_table_schema` to read the `reviewBatch`,
184
319
  then use `select_campaign_cells` diagnostics against
185
320
  `rowSelector:{ type:"reviewBatch" }` for `enrich`, `generateMessage`, and
186
321
  `approved` roles when needed.
187
322
 
323
+ For bounded split refills, operate on the review batch first. Queue
324
+ `queue_campaign_cells` for `columnRole:"enrich"` on
325
+ `rowSelector:{ type:"reviewBatch" }`, wait for campaign processing, then queue
326
+ `columnRole:"generateMessage"` for the same review batch or
327
+ `needsGeneratedMessage` rows. If the bounded packet explicitly uses
328
+ `approvalMode:"approve"` because the user asked to fill/schedule sends or
329
+ provided `--yolo` for a two-day send fill, approve only the bounded review-batch
330
+ cohort after current generated messages exist. Do not broad approve existing
331
+ table rows.
332
+
188
333
  If review-batch enrich cells are pending or Generate Message cells are
189
334
  dependency-blocked, omit `maxRowsToCheck` so the adaptive prep job can cover the
190
335
  bounded table scan, or set a bounded cap high enough to include appended rows
191
336
  when row count evidence requires it. Do not run a fixed `maxRowsToCheck:100` prep pass after appending rows to a larger existing campaign table; it can spend
192
337
  the whole budget on older rows and miss the refill batch.
193
338
 
339
+ Bound `targetPreparedMessages` to the actual ready-to-schedule gap for the
340
+ selected campaign and sender set. If `readyToSchedule` already covers the gap,
341
+ do not start prep; report that the campaign is already loaded and awaiting the
342
+ scheduler. If source inventory is available and the gap is small, prepare only
343
+ the gap instead of filling every active campaign.
344
+ Short form: prepare only the gap instead of filling every active campaign.
345
+
194
346
  Scheduled success requires a post-action reread proving scheduler-owned cells
195
347
  with non-null `scheduledFor`. Prepared, approved, and ready-to-schedule rows are
196
348
  intermediate states; report them as awaiting scheduler unless scheduled cells
@@ -225,9 +377,24 @@ the current source or ask for more research instead of walking the ladder.
225
377
  - No mutation in production unless Christian explicitly approves exact
226
378
  workspace, campaign/table ids, source/action ids, caps/dates, approval mode,
227
379
  expected side effects, and rollback/stop condition.
380
+ - In interactive Codex or Claude Code, that explicit approval must be collected
381
+ through the host-native `Accept` / `Decline` question gate.
382
+ - `--yolo` in the current refill request is explicit auto-accept for the
383
+ rendered bounded refill packet only; it does not loosen the launch/send,
384
+ scheduler-write, archive/delete, or drift rules above.
228
385
 
229
386
  ## Report
230
387
 
231
- Report the selected target, target type, source state, blockers, exact next
232
- primitive, approval required, and the freshness hash used. Say explicitly that
233
- nothing was launched and nothing was sent.
388
+ Report in campaign-name-first language:
389
+
390
+ - selected campaign name(s), target type, and sender names;
391
+ - why they were selected, including last scheduled send date/future scheduled
392
+ send evidence and sender overlap;
393
+ - whether the smallest next step is enrich/prep more in that campaign, add rows
394
+ to that campaign/source, use a different existing campaign, or ask what to
395
+ create;
396
+ - source state, blockers, exact next primitive, approval required, and the
397
+ freshness hash used.
398
+
399
+ Keep ids visible but secondary: show them under "Exact target" or "Proof", not
400
+ as the main decision text. Say explicitly: nothing was launched and nothing was sent.