@sellable/mcp 0.1.396 → 0.1.398
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 +0 -0
- package/dist/index.js +0 -0
- package/dist/tools/prompts.js +1 -1
- package/package.json +1 -1
- package/skills/create-campaign/SKILL.md +6 -12
- package/skills/create-evergreen-campaigns/SKILL.md +246 -27
- package/skills/refill-sends/SKILL.md +4 -8
- package/skills/refill-sends-workflow/SKILL.md +13 -90
package/dist/index-dev.js
CHANGED
|
File without changes
|
package/dist/index.js
CHANGED
|
File without changes
|
package/dist/tools/prompts.js
CHANGED
|
@@ -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" })
|
|
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.`,
|
|
377
377
|
},
|
|
378
378
|
};
|
|
379
379
|
}
|
package/package.json
CHANGED
|
@@ -123,7 +123,6 @@ 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
|
|
127
126
|
get_campaign_refill_state
|
|
128
127
|
```
|
|
129
128
|
|
|
@@ -134,20 +133,15 @@ campaign refill. Route outcomes are `route:"evergreen_horizon"`,
|
|
|
134
133
|
returns `route:"ask_create"`, ask whether to create a normal campaign or
|
|
135
134
|
evergreen campaigns. Campaign creation is allowed only after this route and
|
|
136
135
|
explicit user selection; it is never the default response to plain fill. When
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
|
|
140
|
-
|
|
141
|
-
source-ladder replenishment first; do not create warm-post-engager side
|
|
142
|
-
campaigns, on-demand campaigns, or unrelated campaigns. Surface sender-health
|
|
143
|
-
blockers separately from prepared/approved/scheduled counts.
|
|
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.
|
|
144
140
|
|
|
145
141
|
Treat active fills as capacity-fill preparation: calculate the bounded target
|
|
146
142
|
from sender capacity when needed, then use the refill workflow to decide source
|
|
147
|
-
replenishment, enrichment/prep, approval policy, and scheduler proof.
|
|
148
|
-
|
|
149
|
-
ids as proof only. Mutation requires exact visible approval and a fresh
|
|
150
|
-
`get_campaign_refill_state` reread.
|
|
143
|
+
replenishment, enrichment/prep, approval policy, and scheduler proof. Mutation
|
|
144
|
+
requires exact visible approval and a fresh `get_campaign_refill_state` reread.
|
|
151
145
|
For already-running regular campaigns that need Signal Discovery source
|
|
152
146
|
replenishment, the refill workflow owns the guarded recovery: clear
|
|
153
147
|
`currentStep` only with `clearCurrentStepIfMatches:"running"`, load the
|
|
@@ -58,6 +58,22 @@ 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.
|
|
61
77
|
</inputs>
|
|
62
78
|
|
|
63
79
|
<command_backed_workflow>
|
|
@@ -215,7 +231,8 @@ After bounded delegated approval or safe `--yolo`, fan out lane worker tasks
|
|
|
215
231
|
only from the current plan. Each worker receives the complete lane packet:
|
|
216
232
|
workspace id, sender ids, lane key/type, existing campaign/table binding or
|
|
217
233
|
create intent, source hints, caps, planRevision, actionId, allowed side effects,
|
|
218
|
-
postconditions,
|
|
234
|
+
postconditions, the parent `postEngagerSenderIds`, the parent
|
|
235
|
+
`sharedSenderIds`, and the packet's `workerDispatch` policy. Treat
|
|
219
236
|
`workerDispatch.requiresVisibleThreadOrDurableReceipt:true` as a hard
|
|
220
237
|
execution boundary, not guidance. Read and preserve `workerDispatch.acceptedRuntimes`,
|
|
221
238
|
`workerDispatch.rejectedRuntimes`, and `workerDispatch.receiptArtifactHint`
|
|
@@ -234,6 +251,15 @@ parent packet, do not mutate and do not use it as `setupPlanCall` proof; stop
|
|
|
234
251
|
with `blocked: worker_plan_scope_drift` and ask the parent to re-plan.
|
|
235
252
|
Short form: If a worker-local plan omits `postEngagerSenderIds:[]`, do not use it as `setupPlanCall` proof.
|
|
236
253
|
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 `[]`.
|
|
237
263
|
|
|
238
264
|
Worker fan-out must use visible or durable execution. Preferred in local Codex
|
|
239
265
|
is a visible Codex thread created with the actual Codex app thread tools:
|
|
@@ -264,10 +290,36 @@ CLI builds that expose `-a`/`-s` only at top level. Do not use
|
|
|
264
290
|
forms fail on current customer CLI installs. Pipe the lane packet prompt on
|
|
265
291
|
stdin, require the worker to write `workerDispatch.receiptArtifactHint`, and
|
|
266
292
|
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"`.
|
|
267
318
|
After creating receipt directories, dispatch workers immediately; do not perform extended parent reasoning, extra inventory, or prompt rewriting loops.
|
|
268
319
|
Use a compact worker prompt: include lane packet JSON, original selectedActionIds,
|
|
269
|
-
original planRevision,
|
|
270
|
-
side-effect caps, and the
|
|
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.
|
|
271
323
|
Do not paste the entire wrapper skill into worker prompts. If the parent cannot
|
|
272
324
|
launch at least one visible/durable worker immediately after directory setup,
|
|
273
325
|
stop with `blocked: worker_dispatch_stalled` before any mutation.
|
|
@@ -276,8 +328,11 @@ current lane packet for receipt paths.
|
|
|
276
328
|
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.
|
|
277
329
|
After the receipt-directory `mkdir`, the next shell/tool call must launch the first lane worker.
|
|
278
330
|
Do not run `find`, `ls`, extra inventory, or another preflight between directory setup and the first worker launch.
|
|
279
|
-
For the local Codex CLI fallback, use this literal durable CLI worker launch
|
|
280
|
-
and fill only the lane-specific placeholders
|
|
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:
|
|
281
336
|
|
|
282
337
|
```
|
|
283
338
|
codex -a never -s danger-full-access exec -C <repo> -o <worker-final-file> - <<'WORKER_PROMPT'
|
|
@@ -286,6 +341,8 @@ Use $sellable:create-evergreen-campaigns as the governing skill for this one lan
|
|
|
286
341
|
Workspace id: <workspaceId>
|
|
287
342
|
Parent planRevision: <planRevision>
|
|
288
343
|
Parent selectedActionIds: <selectedActionIds JSON>
|
|
344
|
+
Parent postEngagerSenderIds: <postEngagerSenderIds JSON>
|
|
345
|
+
Parent sharedSenderIds: <sharedSenderIds JSON>
|
|
289
346
|
Action id: <actionId>
|
|
290
347
|
Lane key: <laneKey>
|
|
291
348
|
Allowed side effects: <allowedSideEffects JSON>
|
|
@@ -299,6 +356,9 @@ Use mcp__sellable only. Do not use admin tools, direct DB, Prisma, SQL, web sear
|
|
|
299
356
|
Do not launch, start, schedule, send, or use paid InMail.
|
|
300
357
|
Complete only this lane, write the required durable receipt JSON, and stop.
|
|
301
358
|
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>
|
|
302
362
|
```
|
|
303
363
|
|
|
304
364
|
If any placeholder cannot be filled from the current lane packet, do not inspect
|
|
@@ -368,7 +428,14 @@ not a parent-thread summary. The receipt must include:
|
|
|
368
428
|
`senderIds`, `campaignId`, `tableId`, and `createIntent`. Do not use
|
|
369
429
|
`laneActionId`, `lanePacketActionId`, `delegatedPlanRevision`,
|
|
370
430
|
`delegatedActionId`, or freeform `requestedCall` text as a substitute for
|
|
371
|
-
these fields.
|
|
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`.
|
|
372
439
|
- `createCampaignWorkflowReceipt`: proof the worker loaded the actual installed
|
|
373
440
|
`$sellable:create-campaign` wrapper instead of doing ad hoc MCP calls. It must
|
|
374
441
|
include `skillCommand:"$sellable:create-campaign"`,
|
|
@@ -423,8 +490,25 @@ not a parent-thread summary. The receipt must include:
|
|
|
423
490
|
evidence field such as `rowCount`, `rowIdsHash`, or `rowEvidence`; do not
|
|
424
491
|
leave those only in `searchSignalsProof`, `importProof`, `coldFallbackProof`,
|
|
425
492
|
or narrative text for the parent/verifier to infer.
|
|
426
|
-
- `filterDecisionReceipt`: saved/applied filter
|
|
427
|
-
|
|
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"`.
|
|
428
512
|
- `messageDraftingReceipt`: the Message Drafting proof described below,
|
|
429
513
|
including packaged `generate-messages` prompt/assets and validation. Raw
|
|
430
514
|
fields like `generateMessagesPromptLoadedToHasMoreFalse`,
|
|
@@ -560,7 +644,12 @@ verification unless the same object also appears inside
|
|
|
560
644
|
"sourceLadderReason": "<why the current source is valid before colder sources>"
|
|
561
645
|
},
|
|
562
646
|
"filterDecisionReceipt": {
|
|
563
|
-
"status": "
|
|
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,
|
|
564
653
|
"workflowTableId": "<workflow table id>"
|
|
565
654
|
},
|
|
566
655
|
"messageDraftingReceipt": {
|
|
@@ -641,6 +730,19 @@ path itself in the worker thread:
|
|
|
641
730
|
exactly one semantic Approved cell through `select_campaign_cells` and
|
|
642
731
|
`update_cell`.
|
|
643
732
|
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.
|
|
644
746
|
4. Poll `get_campaign_message_preparation_status` until no queued/active cells
|
|
645
747
|
remain or a bounded stop reason is returned.
|
|
646
748
|
5. Use `get_campaign_messages_preview` or `select_campaign_cells` to inspect
|
|
@@ -667,6 +769,26 @@ The only accepted statusSource values are exactly `branch` and
|
|
|
667
769
|
`packaged-generate-messages-worker`; descriptive aliases such as
|
|
668
770
|
`package-readback-local-thread` are rejected.
|
|
669
771
|
|
|
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
|
+
|
|
670
792
|
One lane may produce exactly one CampaignOffer/campaign id and one current
|
|
671
793
|
workflow table id. For `intent:"create"`, the first successful
|
|
672
794
|
`create_campaign` result establishes the lane's only allowed campaign/table
|
|
@@ -705,9 +827,14 @@ the prospect's engagement unless the selected source evidence proves that exact
|
|
|
705
827
|
sender authored the post.
|
|
706
828
|
Shared lanes must reject generic product-summary samples that explain the
|
|
707
829
|
product in the same broad words for every row. Shared lanes must reject three
|
|
708
|
-
nearly identical samples after stripping the leading name.
|
|
709
|
-
|
|
710
|
-
|
|
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`.
|
|
711
838
|
The generated-message cells are not prompt proof: `currentRevisionGeneratedMessages`,
|
|
712
839
|
Generate Message column counts, `messagesCount`, or rendered row previews prove
|
|
713
840
|
only that table cells exist from the current brief/template, not that the
|
|
@@ -727,6 +854,22 @@ duplicate-lane blockers before you call the command finished. If verify blocks,
|
|
|
727
854
|
report the blocker and repair only the missing postconditions from the same
|
|
728
855
|
current plan.
|
|
729
856
|
|
|
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
|
+
|
|
730
873
|
Message proof for every customer-visible lane must come from the current
|
|
731
874
|
campaign/table basis and include at least 3 generated review rows from the
|
|
732
875
|
packaged `generate-messages` path before completion is reported.
|
|
@@ -765,6 +908,8 @@ Parent-thread handwritten copy or setting `currentStep` is not proof.
|
|
|
765
908
|
Short form: Do not pass the warm template into Shared Signal Discovery or Shared Cold Fallback.
|
|
766
909
|
Short form: Shared lanes must reject generic product-summary samples.
|
|
767
910
|
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.
|
|
768
913
|
Short form: revise or rerun the packaged create-campaign/generate-messages path.
|
|
769
914
|
- **Post Engagers** first-message style: short, casual, references the
|
|
770
915
|
sender-authored post they engaged with, closed question, **no internal
|
|
@@ -775,7 +920,7 @@ Parent-thread handwritten copy or setting `currentStep` is not proof.
|
|
|
775
920
|
|
|
776
921
|
Hey there
|
|
777
922
|
|
|
778
|
-
|
|
923
|
+
Thank you for the support on my post about {{post_topic_line}}
|
|
779
924
|
```
|
|
780
925
|
|
|
781
926
|
- **Shared Signal Discovery** first-message style: short, casual, references
|
|
@@ -791,6 +936,22 @@ Parent-thread handwritten copy or setting `currentStep` is not proof.
|
|
|
791
936
|
say it. Prefer sender-agnostic company/team language such as "we're
|
|
792
937
|
helping CX teams..." or "at cxconnect.ai, we help..." and one clear
|
|
793
938
|
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".
|
|
794
955
|
- **Shared Cold Fallback** first-message style: cold, direct, and cohesive.
|
|
795
956
|
It must not pretend there was engagement, must not say "saw you pop up",
|
|
796
957
|
and must not use a standalone name line followed by "Hey there" or other
|
|
@@ -805,14 +966,52 @@ Parent-thread handwritten copy or setting `currentStep` is not proof.
|
|
|
805
966
|
Sellable/Codex/Claude-Code feature summary
|
|
806
967
|
across prospects. This is a single-message cold path unless the approved
|
|
807
968
|
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.
|
|
808
979
|
Short form: Shared Cold Fallback must not pass just because the receipt says `generate-messages` loaded.
|
|
809
980
|
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".
|
|
810
983
|
Short form: Shared Cold Fallback uses no opt-out shrug such as "If this isn't relevant, ignore me".
|
|
811
984
|
Short form: Shared Cold Fallback uses no product-stack dump.
|
|
812
|
-
|
|
813
|
-
|
|
814
|
-
|
|
815
|
-
|
|
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
|
|
816
1015
|
callable in the packaged runtime, the worker must call
|
|
817
1016
|
`start_campaign_message_preparation` and poll
|
|
818
1017
|
`get_campaign_message_preparation_status` from the lane worker. The
|
|
@@ -842,10 +1041,13 @@ Parent-thread handwritten copy or setting `currentStep` is not proof.
|
|
|
842
1041
|
- A source/list decision has been resolved and campaign rows are loaded. If
|
|
843
1042
|
there is no approved source or no rows can be copied, report `blocked` with
|
|
844
1043
|
the missing source detail; do not call the campaign complete.
|
|
845
|
-
|
|
846
|
-
|
|
847
|
-
|
|
848
|
-
|
|
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.
|
|
849
1051
|
- Message Drafting has run from the current campaign/table basis, using the
|
|
850
1052
|
create-campaign message prompt/assets and validation gate. Updating
|
|
851
1053
|
`currentStep:"messages"` is not proof. Parent-thread handwritten copy is
|
|
@@ -864,13 +1066,17 @@ Parent-thread handwritten copy or setting `currentStep` is not proof.
|
|
|
864
1066
|
reviewed sample messages. For Shared Cold Fallback, reject samples that
|
|
865
1067
|
open with a standalone name followed by "Hey there" or a similarly generic
|
|
866
1068
|
greeting. For Shared Cold Fallback, also reject samples with a self-intro
|
|
867
|
-
such as "We're building",
|
|
868
|
-
|
|
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
|
|
869
1072
|
Sellable/Codex/Claude-Code feature summary across prospects. For all
|
|
870
1073
|
shared lanes, reject generic product-summary samples, repeated
|
|
871
|
-
near-identical samples,
|
|
872
|
-
|
|
873
|
-
|
|
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`.
|
|
874
1080
|
- The first review batch exists and at least 3 review rows have generated
|
|
875
1081
|
messages from the approved brief. If fewer than 3 usable rows exist, report
|
|
876
1082
|
the actual count and why.
|
|
@@ -944,7 +1150,9 @@ Parent-thread handwritten copy or setting `currentStep` is not proof.
|
|
|
944
1150
|
**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.
|
|
945
1151
|
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.
|
|
946
1152
|
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.
|
|
947
|
-
8. **
|
|
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:
|
|
948
1156
|
|
|
949
1157
|
```
|
|
950
1158
|
Evergreen Reconcile — {date}
|
|
@@ -953,6 +1161,17 @@ Evergreen Reconcile — {date}
|
|
|
953
1161
|
• Sellable.dev - Shared Signal Discovery: repaired (send review ready; 50 rows, 3 generated, 1 approved gate row, sequence attached, paused)
|
|
954
1162
|
• Sellable.dev - Shared Cold Fallback: created (send review ready; 50 rows, 3 generated, 1 approved gate row, sequence attached, paused)
|
|
955
1163
|
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.
|
|
956
1175
|
```
|
|
957
1176
|
</objective>
|
|
958
1177
|
|
|
@@ -5,9 +5,6 @@ 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
|
|
11
8
|
- mcp__sellable__resolve_campaign_fill_route
|
|
12
9
|
- mcp__sellable__get_campaign_refill_state
|
|
13
10
|
- mcp__sellable__fill_campaign_horizon
|
|
@@ -54,11 +51,10 @@ get_subskill_prompt({ subskillName: "refill-sends-workflow" })
|
|
|
54
51
|
```
|
|
55
52
|
|
|
56
53
|
Then follow that workflow exactly. The default path is read-only research:
|
|
57
|
-
resolve the route,
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
approval mode, expected side effects, and stop/rollback condition.
|
|
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.
|
|
62
58
|
|
|
63
59
|
Public concepts are regular campaign and evergreen campaign. Internal direct
|
|
64
60
|
campaign types are unsupported refill targets. `fill_campaign_horizon` is only a
|
|
@@ -3,9 +3,6 @@ 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
|
|
9
6
|
- mcp__sellable__resolve_campaign_fill_route
|
|
10
7
|
- mcp__sellable__get_campaign_refill_state
|
|
11
8
|
- mcp__sellable__fill_campaign_horizon
|
|
@@ -55,23 +52,11 @@ Plain phrases that enter here include "fill", "refill sends", "max out sends",
|
|
|
55
52
|
fill/load language, `intent:"active"` only when the user explicitly narrowed
|
|
56
53
|
to active regular campaigns, and `intent:"evergreen"` only when the user
|
|
57
54
|
explicitly asked for evergreen or horizon work.
|
|
58
|
-
2.
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
scheduler-owned sends in refill-state readbacks and report that inference.
|
|
64
|
-
Short form: infer from the most recent scheduler-owned sends when the sender set is not explicit.
|
|
65
|
-
3. Read `get_campaign_refill_state` for candidate campaigns from the resolver
|
|
66
|
-
result. For a broad `active_campaigns` route, inspect enough candidates to
|
|
67
|
-
identify the campaign or small campaign set that most recently had
|
|
68
|
-
scheduler-owned sends for the relevant sender set. Do not stop after the
|
|
69
|
-
first resolver target unless it is also the most recent sender-relevant send
|
|
70
|
-
lane.
|
|
71
|
-
Short form: Do not stop after the first resolver target unless recent-send evidence supports it.
|
|
72
|
-
4. Pick exact ids from the selected refill-state response. Do not use campaign
|
|
73
|
-
names or table names as target identifiers for tool calls.
|
|
74
|
-
5. Classify the target from refill state:
|
|
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:
|
|
75
60
|
- regular campaign: campaign-backed workflow table with normal source,
|
|
76
61
|
sequence, senders, and send/refill stages.
|
|
77
62
|
- evergreen campaign: managed always-on lane with current source evidence.
|
|
@@ -92,10 +77,7 @@ Use the refill-state response as the current facts receipt:
|
|
|
92
77
|
approved, ready to schedule, scheduled;
|
|
93
78
|
- active message prep job;
|
|
94
79
|
- scheduler-owned scheduled counts by date/action from cells with non-null
|
|
95
|
-
`scheduledFor`;
|
|
96
|
-
- latest scheduled send date, latest scheduled-cell update when present,
|
|
97
|
-
sender overlap with the requested or inferred sender set, and whether future
|
|
98
|
-
scheduled sends already exist;
|
|
80
|
+
`scheduledFor`;
|
|
99
81
|
- `freshness.stateHash` and exact campaign/table/workspace ids.
|
|
100
82
|
|
|
101
83
|
Empty or unsafe states stop with the blocker: no fillable target, missing or deleted campaign,
|
|
@@ -107,51 +89,9 @@ scheduler, or unsupported direct campaign type.
|
|
|
107
89
|
|
|
108
90
|
For regular campaign workspaces, rank regular campaigns from route and
|
|
109
91
|
`get_campaign_refill_state` evidence. Choose the best existing refill target.
|
|
110
|
-
The default refill interpretation is "continue the campaign that was actually
|
|
111
|
-
sending most recently for the relevant available senders", not "touch every
|
|
112
|
-
active campaign".
|
|
113
|
-
|
|
114
|
-
Rank candidates in this order:
|
|
115
|
-
|
|
116
|
-
1. **Sender match**: campaigns whose healthy sender ids match the user-named
|
|
117
|
-
senders, or the inferred sender set when the user said only "fill sends" or
|
|
118
|
-
"load senders". Do not include campaigns merely because they are active when
|
|
119
|
-
their sender set is unrelated.
|
|
120
|
-
2. **Recent sends**: campaigns with the newest scheduler-owned scheduled counts
|
|
121
|
-
and non-null `scheduledFor` cells for those senders. Future scheduled sends
|
|
122
|
-
are stronger continuation evidence than old historical sends; otherwise use
|
|
123
|
-
the latest scheduled send date / newest scheduled-cell update from refill
|
|
124
|
-
state.
|
|
125
|
-
3. **Continuation capacity**: campaigns with healthy senders, remaining daily
|
|
126
|
-
capacity, and a gap between current ready-to-schedule rows and the desired
|
|
127
|
-
sender capacity.
|
|
128
|
-
4. **Same-campaign source health**: prefer campaigns whose current source has
|
|
129
|
-
enough `sourceAvailable` inventory to prepare the gap. If source inventory
|
|
130
|
-
is low or exhausted, choose same-campaign row replenishment before switching
|
|
131
|
-
campaigns.
|
|
132
|
-
5. **Campaign scope**: keep the selected set small. Normally choose one
|
|
133
|
-
campaign; choose multiple only when the recent-send evidence shows multiple
|
|
134
|
-
distinct sender lanes are actively being filled.
|
|
135
|
-
|
|
136
92
|
Do not create side campaigns, warm-post-engager side campaigns, on-demand campaigns,
|
|
137
93
|
or unrelated campaigns as the default answer to a fill request.
|
|
138
94
|
|
|
139
|
-
For each selected campaign, decide the next action by the smallest sufficient
|
|
140
|
-
step:
|
|
141
|
-
|
|
142
|
-
- **Enrich/prep more rows in the same campaign** when sender health is good,
|
|
143
|
-
recent sends point to this campaign, and `sourceAvailable` can cover the
|
|
144
|
-
ready-to-schedule gap.
|
|
145
|
-
- **Add/import more rows to the same campaign/source path** when the campaign is
|
|
146
|
-
the right recent-send lane but source inventory or viable rows cannot cover
|
|
147
|
-
the gap.
|
|
148
|
-
- **Use a different existing campaign** only when the recent-send campaign is
|
|
149
|
-
blocked, archived, missing sequence/source/senders, disconnected, exhausted
|
|
150
|
-
with no viable same-campaign replenishment path, or the user explicitly asks
|
|
151
|
-
to move to another campaign.
|
|
152
|
-
- **Ask what to create** only after resolver/state evidence shows there is no
|
|
153
|
-
suitable existing campaign for the requested sender set.
|
|
154
|
-
|
|
155
95
|
When the best regular campaign is source-exhausted, recommend same-campaign source-ladder replenishment.
|
|
156
96
|
Keep `selectedLeadListId` source identity distinct
|
|
157
97
|
from the campaign `workflowTableId`.
|
|
@@ -206,10 +146,10 @@ returns to Running after same-campaign source rows are copied. Do not call
|
|
|
206
146
|
post-copy state transition.
|
|
207
147
|
|
|
208
148
|
Before any source mutation, show exact approval evidence: workspace id,
|
|
209
|
-
campaign
|
|
210
|
-
|
|
211
|
-
Then reread `get_campaign_refill_state`; if
|
|
212
|
-
changed, stop and ask for a fresh approval.
|
|
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.
|
|
213
153
|
|
|
214
154
|
After source import, call `wait_for_lead_list_ready` and `confirm_lead_list`
|
|
215
155
|
with the source-list id and campaign id. Imports append to the existing
|
|
@@ -251,13 +191,6 @@ bounded table scan, or set a bounded cap high enough to include appended rows
|
|
|
251
191
|
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
|
|
252
192
|
the whole budget on older rows and miss the refill batch.
|
|
253
193
|
|
|
254
|
-
Bound `targetPreparedMessages` to the actual ready-to-schedule gap for the
|
|
255
|
-
selected campaign and sender set. If `readyToSchedule` already covers the gap,
|
|
256
|
-
do not start prep; report that the campaign is already loaded and awaiting the
|
|
257
|
-
scheduler. If source inventory is available and the gap is small, prepare only
|
|
258
|
-
the gap instead of filling every active campaign.
|
|
259
|
-
Short form: prepare only the gap instead of filling every active campaign.
|
|
260
|
-
|
|
261
194
|
Scheduled success requires a post-action reread proving scheduler-owned cells
|
|
262
195
|
with non-null `scheduledFor`. Prepared, approved, and ready-to-schedule rows are
|
|
263
196
|
intermediate states; report them as awaiting scheduler unless scheduled cells
|
|
@@ -295,16 +228,6 @@ the current source or ask for more research instead of walking the ladder.
|
|
|
295
228
|
|
|
296
229
|
## Report
|
|
297
230
|
|
|
298
|
-
Report
|
|
299
|
-
|
|
300
|
-
|
|
301
|
-
- why they were selected, including last scheduled send date/future scheduled
|
|
302
|
-
send evidence and sender overlap;
|
|
303
|
-
- whether the smallest next step is enrich/prep more in that campaign, add rows
|
|
304
|
-
to that campaign/source, use a different existing campaign, or ask what to
|
|
305
|
-
create;
|
|
306
|
-
- source state, blockers, exact next primitive, approval required, and the
|
|
307
|
-
freshness hash used.
|
|
308
|
-
|
|
309
|
-
Keep ids visible but secondary: show them under "Exact target" or "Proof", not
|
|
310
|
-
as the main decision text. Say explicitly: nothing was launched and nothing was sent.
|
|
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.
|