@sellable/install 0.1.254 → 0.1.256
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md
CHANGED
|
@@ -31,9 +31,9 @@ agent command for launching a campaign:
|
|
|
31
31
|
sellable create
|
|
32
32
|
```
|
|
33
33
|
|
|
34
|
-
Campaign creation, foundation memory, content
|
|
35
|
-
drafting run inside Claude Code or Codex, where the
|
|
36
|
-
approval flows are available.
|
|
34
|
+
Campaign creation, sender send refills, foundation memory, content
|
|
35
|
+
capture/ideation, and post drafting run inside Claude Code or Codex, where the
|
|
36
|
+
Sellable MCP tools and approval flows are available.
|
|
37
37
|
|
|
38
38
|
Install is auth-free by default. The normal path is first-run login: launch a
|
|
39
39
|
Sellable workflow in Claude Code or Codex and the agent handles Sellable
|
|
@@ -100,12 +100,14 @@ Use the same public entrypoints in both hosts:
|
|
|
100
100
|
- Claude Code: `/sellable:foundation`
|
|
101
101
|
- Claude Code: `/sellable:content`
|
|
102
102
|
- Claude Code: `/sellable:create-post`
|
|
103
|
+
- Claude Code: `/sellable:refill-sends`
|
|
103
104
|
- Codex: `$sellable:create-campaign`
|
|
104
105
|
- Codex: `$sellable:create-ab-test`
|
|
105
106
|
- Codex: `$sellable:create-evergreen-campaigns`
|
|
106
107
|
- Codex: `$sellable:foundation`
|
|
107
108
|
- Codex: `$sellable:content`
|
|
108
109
|
- Codex: `$sellable:create-post`
|
|
110
|
+
- Codex: `$sellable:refill-sends`
|
|
109
111
|
- Codex Desktop plugin: `sellable@sellable`
|
|
110
112
|
- Codex visible skill: `Sellable Create Campaign`
|
|
111
113
|
- Codex visible skill: `Sellable Create A/B Test`
|
|
@@ -113,7 +115,9 @@ Use the same public entrypoints in both hosts:
|
|
|
113
115
|
- Codex visible skill: `Sellable Foundation`
|
|
114
116
|
- Codex visible skill: `Sellable Content`
|
|
115
117
|
- Codex visible skill: `Sellable Create Post`
|
|
118
|
+
- Codex visible skill: `Sellable Refill Sends`
|
|
116
119
|
- Internal MCP workflow prompt: `create-campaign-v2`
|
|
120
|
+
- Internal MCP workflow prompt: `refill-sends-workflow`
|
|
117
121
|
- Internal/backward-compatible memory prompt: `interview`
|
|
118
122
|
|
|
119
123
|
Do not ask users to run `/sellable:create-campaign-v2`,
|
package/bin/sellable-install.mjs
CHANGED
|
@@ -37,7 +37,7 @@ function getInstallVersion() {
|
|
|
37
37
|
}
|
|
38
38
|
}
|
|
39
39
|
|
|
40
|
-
const CODEX_PLUGIN_VERSION = "0.1.
|
|
40
|
+
const CODEX_PLUGIN_VERSION = "0.1.52";
|
|
41
41
|
const CODEX_PLUGIN_COMPAT_VERSIONS = [
|
|
42
42
|
"0.1.8",
|
|
43
43
|
"0.1.9",
|
|
@@ -73,6 +73,7 @@ const CODEX_PLUGIN_COMPAT_VERSIONS = [
|
|
|
73
73
|
"0.1.39",
|
|
74
74
|
"0.1.40",
|
|
75
75
|
"0.1.41",
|
|
76
|
+
"0.1.51",
|
|
76
77
|
];
|
|
77
78
|
const RAW_INSTALL_PACKAGE_SPEC =
|
|
78
79
|
process.env.SELLABLE_INSTALL_PACKAGE_SPEC || "@sellable/install@latest";
|
|
@@ -187,7 +188,8 @@ Options:
|
|
|
187
188
|
Auth:
|
|
188
189
|
Install is auth-free by default. Sign in happens on the first run of
|
|
189
190
|
/sellable:create-campaign, /sellable:create-evergreen-campaigns,
|
|
190
|
-
/sellable:foundation, /sellable:content,
|
|
191
|
+
/sellable:foundation, /sellable:content, /sellable:create-post, or
|
|
192
|
+
/sellable:refill-sends in Claude Code or Codex,
|
|
191
193
|
where the agent walks you through signup or sign-in and stores credentials
|
|
192
194
|
in ~/.sellable/config.json.
|
|
193
195
|
|
|
@@ -217,6 +219,7 @@ function printCreateCommandHint() {
|
|
|
217
219
|
{ label: "Foundation", command: "/sellable:foundation" },
|
|
218
220
|
{ label: "Content", command: "/sellable:content" },
|
|
219
221
|
{ label: "Post", command: "/sellable:create-post" },
|
|
222
|
+
{ label: "Refill", command: "/sellable:refill-sends" },
|
|
220
223
|
]);
|
|
221
224
|
console.log("");
|
|
222
225
|
console.log("");
|
|
@@ -227,6 +230,7 @@ function printCreateCommandHint() {
|
|
|
227
230
|
{ label: "Foundation", command: "$sellable:foundation" },
|
|
228
231
|
{ label: "Content", command: "$sellable:content" },
|
|
229
232
|
{ label: "Post", command: "$sellable:create-post" },
|
|
233
|
+
{ label: "Refill", command: "$sellable:refill-sends" },
|
|
230
234
|
]);
|
|
231
235
|
console.log("");
|
|
232
236
|
console.log(` ${"─".repeat(63)}`);
|
|
@@ -874,7 +878,7 @@ function codexPluginManifest(opts) {
|
|
|
874
878
|
name: "sellable",
|
|
875
879
|
version: CODEX_PLUGIN_VERSION,
|
|
876
880
|
description:
|
|
877
|
-
"Sellable MCP tools for campaign creation, foundation memory, content, and workflow sequencing.",
|
|
881
|
+
"Sellable MCP tools for campaign creation, send refills, foundation memory, content, and workflow sequencing.",
|
|
878
882
|
author: {
|
|
879
883
|
name: "Sellable",
|
|
880
884
|
url: "https://sellable.dev/",
|
|
@@ -888,7 +892,7 @@ function codexPluginManifest(opts) {
|
|
|
888
892
|
displayName: "Sellable",
|
|
889
893
|
shortDescription: "Sellable MCP tools for outbound campaign workflows",
|
|
890
894
|
longDescription:
|
|
891
|
-
"Loads the Sellable MCP server into Codex Desktop so Sellable skills can create campaigns, find leads, draft messages, and manage approval-gated launch workflows.",
|
|
895
|
+
"Loads the Sellable MCP server into Codex Desktop so Sellable skills can create campaigns, refill sends, find leads, draft messages, and manage approval-gated launch workflows.",
|
|
892
896
|
developerName: "Sellable",
|
|
893
897
|
category: "Productivity",
|
|
894
898
|
capabilities: ["Interactive", "Write"],
|
|
@@ -897,6 +901,7 @@ function codexPluginManifest(opts) {
|
|
|
897
901
|
termsOfServiceURL: "https://sellable.dev/terms",
|
|
898
902
|
defaultPrompt: [
|
|
899
903
|
"Create a Sellable campaign",
|
|
904
|
+
"Refill Sellable sends",
|
|
900
905
|
"Find LinkedIn leads",
|
|
901
906
|
"Build an outbound sequence",
|
|
902
907
|
],
|
|
@@ -1040,6 +1045,54 @@ const CREATE_EVERGREEN_CAMPAIGNS_ALLOWED_TOOLS = [
|
|
|
1040
1045
|
"codex_app.send_message_to_thread",
|
|
1041
1046
|
];
|
|
1042
1047
|
|
|
1048
|
+
const REFILL_SENDS_ALLOWED_TOOLS = [
|
|
1049
|
+
"mcp__sellable__refill_sends",
|
|
1050
|
+
"mcp__sellable__get_auth_status",
|
|
1051
|
+
"mcp__sellable__start_cli_login",
|
|
1052
|
+
"mcp__sellable__wait_for_cli_login",
|
|
1053
|
+
"mcp__sellable__get_active_workspace",
|
|
1054
|
+
"mcp__sellable__list_workspaces",
|
|
1055
|
+
"mcp__sellable__set_active_workspace",
|
|
1056
|
+
"mcp__sellable__get_subskill_prompt",
|
|
1057
|
+
"mcp__sellable__search_subskill_prompts",
|
|
1058
|
+
"mcp__sellable__list_senders",
|
|
1059
|
+
"mcp__sellable__get_sender_routing",
|
|
1060
|
+
"mcp__sellable__get_campaign_waterfall",
|
|
1061
|
+
"mcp__sellable__resolve_campaign_fill_route",
|
|
1062
|
+
"mcp__sellable__get_campaign_refill_state",
|
|
1063
|
+
"mcp__sellable__fill_campaign_horizon",
|
|
1064
|
+
"mcp__sellable__get_campaign",
|
|
1065
|
+
"mcp__sellable__get_campaign_context",
|
|
1066
|
+
"mcp__sellable__update_campaign",
|
|
1067
|
+
"mcp__sellable__get_provider_prompt",
|
|
1068
|
+
"mcp__sellable__get_campaign_message_preparation_status",
|
|
1069
|
+
"mcp__sellable__start_campaign_message_preparation",
|
|
1070
|
+
"mcp__sellable__cancel_campaign_message_preparation",
|
|
1071
|
+
"mcp__sellable__import_leads",
|
|
1072
|
+
"mcp__sellable__wait_for_lead_list_ready",
|
|
1073
|
+
"mcp__sellable__confirm_lead_list",
|
|
1074
|
+
"mcp__sellable__search_signals",
|
|
1075
|
+
"mcp__sellable__select_promising_posts",
|
|
1076
|
+
"mcp__sellable__fetch_post_engagers",
|
|
1077
|
+
"mcp__sellable__search_sales_nav",
|
|
1078
|
+
"mcp__sellable__lookup_sales_nav_filter",
|
|
1079
|
+
"mcp__sellable__search_prospeo",
|
|
1080
|
+
"mcp__sellable__search_prospeo_companies",
|
|
1081
|
+
"mcp__sellable__confirm_prospeo_company_accounts",
|
|
1082
|
+
"mcp__sellable__load_csv_linkedin_leads",
|
|
1083
|
+
"mcp__sellable__load_csv_domains",
|
|
1084
|
+
"mcp__sellable__list_dnc_entries",
|
|
1085
|
+
"mcp__sellable__load_csv_dnc_entries",
|
|
1086
|
+
"mcp__sellable__get_rows",
|
|
1087
|
+
"mcp__sellable__get_rows_minimal",
|
|
1088
|
+
"mcp__sellable__get_table_rows",
|
|
1089
|
+
"mcp__sellable__get_campaign_table_schema",
|
|
1090
|
+
"mcp__sellable__select_campaign_cells",
|
|
1091
|
+
"mcp__sellable__queue_campaign_cells",
|
|
1092
|
+
"mcp__sellable__wait_for_campaign_processing",
|
|
1093
|
+
"mcp__sellable__get_sender",
|
|
1094
|
+
];
|
|
1095
|
+
|
|
1043
1096
|
function allowedToolsYaml(tools) {
|
|
1044
1097
|
return [...new Set(tools)].map((tool) => ` - ${tool}`).join("\n");
|
|
1045
1098
|
}
|
|
@@ -1857,6 +1910,71 @@ then retry \`get_subskill_prompt\`.
|
|
|
1857
1910
|
`, host, "create-evergreen-campaigns");
|
|
1858
1911
|
}
|
|
1859
1912
|
|
|
1913
|
+
function refillSendsSkillMd(host = "shared") {
|
|
1914
|
+
try {
|
|
1915
|
+
const here = dirname(fileURLToPath(import.meta.url));
|
|
1916
|
+
const templatePath = join(
|
|
1917
|
+
here,
|
|
1918
|
+
"..",
|
|
1919
|
+
"skill-templates",
|
|
1920
|
+
"refill-sends.md"
|
|
1921
|
+
);
|
|
1922
|
+
if (existsSync(templatePath)) {
|
|
1923
|
+
return stampInstalledHost(
|
|
1924
|
+
addOrReplaceAllowedTools(
|
|
1925
|
+
readFileSync(templatePath, "utf8"),
|
|
1926
|
+
REFILL_SENDS_ALLOWED_TOOLS
|
|
1927
|
+
),
|
|
1928
|
+
host,
|
|
1929
|
+
"refill-sends"
|
|
1930
|
+
);
|
|
1931
|
+
}
|
|
1932
|
+
} catch {
|
|
1933
|
+
// fall through to hardcoded fallback below
|
|
1934
|
+
}
|
|
1935
|
+
return stampInstalledHost(`---
|
|
1936
|
+
name: refill-sends
|
|
1937
|
+
description: Refill Sellable sender sends through the approval-gated refill workflow.
|
|
1938
|
+
visibility: public
|
|
1939
|
+
allowed-tools:
|
|
1940
|
+
${allowedToolsYaml(REFILL_SENDS_ALLOWED_TOOLS)}
|
|
1941
|
+
---
|
|
1942
|
+
|
|
1943
|
+
# Sellable Refill Sends
|
|
1944
|
+
|
|
1945
|
+
Use this as the customer-facing entrypoint for the Sellable \`refill-sends\`
|
|
1946
|
+
workflow. It supports \`--yolo\` and optional repeated \`--sender <name-or-id>\`
|
|
1947
|
+
selectors.
|
|
1948
|
+
|
|
1949
|
+
## Bootstrap
|
|
1950
|
+
|
|
1951
|
+
MCP prompt and command access are required. Do not inspect repo files, run shell
|
|
1952
|
+
commands, use \`npm\`, \`node\`, local harness scripts, or read local prompt
|
|
1953
|
+
files to emulate this workflow.
|
|
1954
|
+
|
|
1955
|
+
If the Sellable MCP prompt tools are unavailable, stop and say this is a Codex
|
|
1956
|
+
install/reload problem. Tell the user to run
|
|
1957
|
+
\`curl -fsSL "https://app.sellable.dev/api/v2/cli/install" | sh\`, fully quit and reopen Codex
|
|
1958
|
+
Desktop, then start a new thread.
|
|
1959
|
+
|
|
1960
|
+
## Execute Workflow
|
|
1961
|
+
|
|
1962
|
+
1. Call \`mcp__sellable__get_auth_status({})\`.
|
|
1963
|
+
2. Normalize invocation arguments with \`mcp__sellable__refill_sends({ yolo, senders, senderIds, senderNames })\` when the host exposes typed MCP tools.
|
|
1964
|
+
3. Load the canonical prompt via
|
|
1965
|
+
\`mcp__sellable__get_subskill_prompt({ subskillName: "refill-sends" })\`,
|
|
1966
|
+
then load \`mcp__sellable__get_subskill_prompt({ subskillName: "refill-sends-workflow" })\`.
|
|
1967
|
+
4. Follow the canonical prompt exactly. Do not launch, start, archive, delete,
|
|
1968
|
+
or write scheduler rows as part of refill sends.
|
|
1969
|
+
|
|
1970
|
+
## MCP Prompt Fallback
|
|
1971
|
+
|
|
1972
|
+
If exact subskill lookup fails, use
|
|
1973
|
+
\`mcp__sellable__search_subskill_prompts({ query: "refill-sends", includePublic: true, includeInternal: true })\`,
|
|
1974
|
+
then retry \`get_subskill_prompt\`.
|
|
1975
|
+
`, host, "refill-sends");
|
|
1976
|
+
}
|
|
1977
|
+
|
|
1860
1978
|
function genericSellableSkillMd({ name, title, description, host = "shared" }) {
|
|
1861
1979
|
return stampInstalledHost(`---
|
|
1862
1980
|
name: ${name}
|
|
@@ -2330,6 +2448,12 @@ function codexPluginSkills() {
|
|
|
2330
2448
|
description: "Capture ideas and draft LinkedIn posts in your voice",
|
|
2331
2449
|
skillMd: createPostSkillMd(),
|
|
2332
2450
|
},
|
|
2451
|
+
{
|
|
2452
|
+
dir: "sellable-refill-sends",
|
|
2453
|
+
displayName: "Sellable Refill Sends",
|
|
2454
|
+
description: "Refill sender sends with approval-gated campaign selection",
|
|
2455
|
+
skillMd: refillSendsSkillMd("codex"),
|
|
2456
|
+
},
|
|
2333
2457
|
];
|
|
2334
2458
|
}
|
|
2335
2459
|
|
|
@@ -2555,6 +2679,16 @@ function claudeCommands() {
|
|
|
2555
2679
|
argumentHint: "[post idea or source material]",
|
|
2556
2680
|
skillMd: createPostSkillMd(),
|
|
2557
2681
|
},
|
|
2682
|
+
{
|
|
2683
|
+
name: "refill-sends",
|
|
2684
|
+
title: "Refill Sends",
|
|
2685
|
+
filename: join("sellable", "refill-sends.md"),
|
|
2686
|
+
description:
|
|
2687
|
+
"Refill Sellable sender sends through the approval-gated refill workflow.",
|
|
2688
|
+
argumentHint: "[--yolo] [--sender name-or-id ...]",
|
|
2689
|
+
skillMd: refillSendsSkillMd("claude"),
|
|
2690
|
+
allowedTools: ["AskUserQuestion", ...REFILL_SENDS_ALLOWED_TOOLS],
|
|
2691
|
+
},
|
|
2558
2692
|
{
|
|
2559
2693
|
name: "create-evergreen-campaigns",
|
|
2560
2694
|
title: "Create Evergreen Campaigns",
|
|
@@ -3852,6 +3986,7 @@ function printNextSteps(installedHosts, authReused) {
|
|
|
3852
3986
|
{ label: "Foundation", command: "/sellable:foundation" },
|
|
3853
3987
|
{ label: "Content", command: "/sellable:content" },
|
|
3854
3988
|
{ label: "Post", command: "/sellable:create-post" },
|
|
3989
|
+
{ label: "Refill", command: "/sellable:refill-sends" },
|
|
3855
3990
|
]);
|
|
3856
3991
|
console.log("");
|
|
3857
3992
|
console.log("");
|
|
@@ -3863,6 +3998,7 @@ function printNextSteps(installedHosts, authReused) {
|
|
|
3863
3998
|
{ label: "Foundation", command: "$sellable:foundation" },
|
|
3864
3999
|
{ label: "Content", command: "$sellable:content" },
|
|
3865
4000
|
{ label: "Post", command: "$sellable:create-post" },
|
|
4001
|
+
{ label: "Refill", command: "$sellable:refill-sends" },
|
|
3866
4002
|
]);
|
|
3867
4003
|
console.log("");
|
|
3868
4004
|
}
|
|
@@ -4153,11 +4289,13 @@ async function main() {
|
|
|
4153
4289
|
console.log(` Claude Code: /sellable:foundation`);
|
|
4154
4290
|
console.log(` Claude Code: /sellable:content`);
|
|
4155
4291
|
console.log(` Claude Code: /sellable:create-post`);
|
|
4292
|
+
console.log(` Claude Code: /sellable:refill-sends`);
|
|
4156
4293
|
console.log(` Codex: $sellable:create-campaign`);
|
|
4157
4294
|
console.log(` Codex: $sellable:create-evergreen-campaigns`);
|
|
4158
4295
|
console.log(` Codex: $sellable:foundation`);
|
|
4159
4296
|
console.log(` Codex: $sellable:content`);
|
|
4160
4297
|
console.log(` Codex: $sellable:create-post`);
|
|
4298
|
+
console.log(` Codex: $sellable:refill-sends`);
|
|
4161
4299
|
process.exit(0);
|
|
4162
4300
|
}
|
|
4163
4301
|
if (rawArgs[0] === "prefs") {
|
package/lib/runtime-verify.mjs
CHANGED
|
@@ -30,6 +30,7 @@ export const REQUIRED_SELLABLE_MCP_TOOLS = [
|
|
|
30
30
|
"attach_recommended_sequence",
|
|
31
31
|
"resolve_campaign_fill_route",
|
|
32
32
|
"get_campaign_refill_state",
|
|
33
|
+
"refill_sends",
|
|
33
34
|
"setup_evergreen_campaigns",
|
|
34
35
|
"start_campaign_message_preparation",
|
|
35
36
|
"get_campaign_message_preparation_status",
|
|
@@ -70,6 +71,14 @@ export const CREATE_CAMPAIGN_SMOKE_CALLS = [
|
|
|
70
71
|
limit: 1200,
|
|
71
72
|
},
|
|
72
73
|
},
|
|
74
|
+
{
|
|
75
|
+
name: "refill_sends",
|
|
76
|
+
arguments: {
|
|
77
|
+
yolo: false,
|
|
78
|
+
senders: ["smoke"],
|
|
79
|
+
horizonSendDays: 2,
|
|
80
|
+
},
|
|
81
|
+
},
|
|
73
82
|
{
|
|
74
83
|
name: "get_subskill_asset",
|
|
75
84
|
arguments: {
|
package/package.json
CHANGED
|
@@ -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
|
-
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
|
|
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.
|
|
144
|
-
|
|
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
|
|
@@ -14,33 +14,6 @@ producing duplicates. This skill never launches campaigns; customer-visible
|
|
|
14
14
|
completion stops at paused send review.
|
|
15
15
|
</role>
|
|
16
16
|
|
|
17
|
-
## Operational Fast Path
|
|
18
|
-
|
|
19
|
-
In automation or `--yolo` customer-visible setup, use this path before the
|
|
20
|
-
long-form contract below:
|
|
21
|
-
|
|
22
|
-
1. Resolve the active workspace and explicit sender scopes, then call
|
|
23
|
-
`setup_evergreen_campaigns({ mode:"plan", yolo:true, postEngagerSenderIds,
|
|
24
|
-
sharedSenderIds })`.
|
|
25
|
-
2. If the plan is not current, lacks lane packets, or has
|
|
26
|
-
`autoExecutable:false`, return the exact blocker before mutation.
|
|
27
|
-
3. Choose the worker runtime immediately. When running under Codex CLI or on VPS,
|
|
28
|
-
the local Codex CLI fallback is the default accepted runtime. Use visible
|
|
29
|
-
Codex app threads only when the callable thread tools are actually available.
|
|
30
|
-
If shell execution is unavailable and no visible/durable thread surface is
|
|
31
|
-
callable, return `blocked: missing_visible_or_durable_lane_worker_runtime`
|
|
32
|
-
before mutation.
|
|
33
|
-
4. Write one compact prompt file per selected lane packet, create the receipt
|
|
34
|
-
directory, and launch all lane workers in parallel with the literal Codex CLI
|
|
35
|
-
worker command shape below. The parent does not create campaign shells.
|
|
36
|
-
5. Collect fresh durable receipts, verify with the original planRevision and
|
|
37
|
-
selectedActionIds, then run the idempotency plan and show sample messages.
|
|
38
|
-
|
|
39
|
-
Do not keep reasoning, re-reading prompts, or restating this workflow instead of
|
|
40
|
-
dispatching workers. If the first worker cannot be launched after at most one
|
|
41
|
-
short planning pass, return `blocked: worker_dispatch_deadline_exceeded` before
|
|
42
|
-
directory setup or product mutation.
|
|
43
|
-
|
|
44
17
|
<inputs>
|
|
45
18
|
The invoking prompt names the senders ("create evergreen campaigns for csreyes92 and thomas"). Resolve each via `list_senders`.
|
|
46
19
|
|
|
@@ -85,22 +58,6 @@ Default evergreen plan per workspace (override only if the prompt specifies diff
|
|
|
85
58
|
1. **`<Sender Name> - Post Engagers`** — one per sender (warm lane, highest priority)
|
|
86
59
|
2. **`<Workspace/Team> - Shared Signal Discovery`** — one shared warm-signal campaign lane across senders
|
|
87
60
|
3. **`<Workspace/Team> - Shared Cold Fallback`** — one shared cold/fallback campaign lane across senders
|
|
88
|
-
|
|
89
|
-
Sender scope resolution is safety-critical. Do not pass
|
|
90
|
-
`allConnectedSenders:true` unless the invoking prompt explicitly says "all
|
|
91
|
-
connected senders", "every connected sender", "all seats", or names an
|
|
92
|
-
equivalent all-sender scope. If the user says "all 4 campaigns", "the four
|
|
93
|
-
evergreen campaigns", or names specific senders, resolve those exact senders
|
|
94
|
-
and pass explicit `postEngagerSenderIds` plus `sharedSenderIds`; do not broaden
|
|
95
|
-
the plan to every connected sender. In non-interactive or `--yolo` mode, when
|
|
96
|
-
more than two connected senders exist and the prompt does not explicitly
|
|
97
|
-
authorize all connected senders, stop before mutation with
|
|
98
|
-
`blocked: ambiguous_post_engager_sender_scope` and report the sender ids/names
|
|
99
|
-
needed for approval. Never let "workspace default" silently create Post
|
|
100
|
-
Engagers lanes for extra senders.
|
|
101
|
-
Short form: Do not pass `allConnectedSenders:true` unless the prompt explicitly says all/every connected sender.
|
|
102
|
-
Short form: "all 4 campaigns" means explicit sender scope plus two shared lanes, not all connected senders.
|
|
103
|
-
Short form: In `--yolo`, ambiguous multi-sender scope blocks before mutation.
|
|
104
61
|
</inputs>
|
|
105
62
|
|
|
106
63
|
<command_backed_workflow>
|
|
@@ -258,8 +215,7 @@ After bounded delegated approval or safe `--yolo`, fan out lane worker tasks
|
|
|
258
215
|
only from the current plan. Each worker receives the complete lane packet:
|
|
259
216
|
workspace id, sender ids, lane key/type, existing campaign/table binding or
|
|
260
217
|
create intent, source hints, caps, planRevision, actionId, allowed side effects,
|
|
261
|
-
postconditions, the
|
|
262
|
-
`sharedSenderIds`, and the packet's `workerDispatch` policy. Treat
|
|
218
|
+
postconditions, and the packet's `workerDispatch` policy. Treat
|
|
263
219
|
`workerDispatch.requiresVisibleThreadOrDurableReceipt:true` as a hard
|
|
264
220
|
execution boundary, not guidance. Read and preserve `workerDispatch.acceptedRuntimes`,
|
|
265
221
|
`workerDispatch.rejectedRuntimes`, and `workerDispatch.receiptArtifactHint`
|
|
@@ -278,15 +234,6 @@ parent packet, do not mutate and do not use it as `setupPlanCall` proof; stop
|
|
|
278
234
|
with `blocked: worker_plan_scope_drift` and ask the parent to re-plan.
|
|
279
235
|
Short form: If a worker-local plan omits `postEngagerSenderIds:[]`, do not use it as `setupPlanCall` proof.
|
|
280
236
|
Short form: stop with `blocked: worker_plan_scope_drift`.
|
|
281
|
-
Every worker prompt must include both parent scope arrays as explicit fields:
|
|
282
|
-
`Parent postEngagerSenderIds:` and `Parent sharedSenderIds:`. Workers must
|
|
283
|
-
preserve parent postEngagerSenderIds even for shared lanes. Never run a
|
|
284
|
-
shared-lane worker-local plan with `postEngagerSenderIds:[]` unless the parent
|
|
285
|
-
`postEngagerSenderIds` is exactly `[]`. Every durable receipt must copy these
|
|
286
|
-
arrays to top-level `parentPostEngagerSenderIds` and `parentSharedSenderIds`
|
|
287
|
-
before completion.
|
|
288
|
-
Short form: Workers must preserve parent postEngagerSenderIds even for shared lanes.
|
|
289
|
-
Short form: Never run a shared-lane worker-local plan with `postEngagerSenderIds:[]` unless the parent `postEngagerSenderIds` is exactly `[]`.
|
|
290
237
|
|
|
291
238
|
Worker fan-out must use visible or durable execution. Preferred in local Codex
|
|
292
239
|
is a visible Codex thread created with the actual Codex app thread tools:
|
|
@@ -310,120 +257,35 @@ acceptable only when it writes a fresh durable per-lane receipt artifact as it
|
|
|
310
257
|
works.
|
|
311
258
|
When visible Codex app thread tools are unavailable but local Codex CLI is
|
|
312
259
|
available, the accepted durable streaming-worker command shape is:
|
|
313
|
-
`codex -a never -s danger-full-access exec
|
|
260
|
+
`codex -a never -s danger-full-access exec -C <repo> -o <worker-final-file> -`.
|
|
314
261
|
The approval and sandbox flags must come before the `exec` subcommand for Codex
|
|
315
|
-
CLI builds that expose `-a`/`-s` only at top level.
|
|
316
|
-
as an `exec` subcommand flag, not a top-level flag. Do not use
|
|
262
|
+
CLI builds that expose `-a`/`-s` only at top level. Do not use
|
|
317
263
|
`codex exec --ask-for-approval never ...` or `codex exec -a never ...`; those
|
|
318
264
|
forms fail on current customer CLI installs. Pipe the lane packet prompt on
|
|
319
265
|
stdin, require the worker to write `workerDispatch.receiptArtifactHint`, and
|
|
320
266
|
pass exactly one lane packet per worker.
|
|
321
|
-
When launching durable Codex CLI workers from an automation parent, pass an
|
|
322
|
-
explicit supported worker model instead of relying on the Codex CLI default
|
|
323
|
-
model. Use the parent runtime model when known, for example:
|
|
324
|
-
`codex -a never -s danger-full-access exec --skip-git-repo-check -m <worker-model> -C <repo> -o <worker-final-file> -`.
|
|
325
|
-
Do not rely on the Codex CLI default model; some customer and VPS installs
|
|
326
|
-
default to unavailable model aliases. If the parent cannot identify a supported
|
|
327
|
-
worker model and a test `codex exec -m <worker-model>` launch is rejected, stop
|
|
328
|
-
with `blocked: worker_model_unavailable` before mutation.
|
|
329
|
-
When wrapping multiple local Codex CLI workers in a shell launcher, run the
|
|
330
|
-
wrapper with `/bin/bash -lc` or another explicitly chosen portable shell. Do not
|
|
331
|
-
rely on zsh-specific behavior. Do not use `status` as a shell variable because
|
|
332
|
-
zsh treats it as read-only; use `exit_code` or `rc` instead. Receipt polling
|
|
333
|
-
must use `find <receipt-dir> -maxdepth 1 -name 'evg_*.json' -print` or an
|
|
334
|
-
explicit nullglob-safe equivalent. Do not use naked `*.json` globs under zsh,
|
|
335
|
-
and keep zero-receipt polls quiet with no `no matches found` diagnostics.
|
|
336
|
-
Do not embed `<<'WORKER_PROMPT'` heredocs inside a single quoted or double
|
|
337
|
-
quoted `/bin/bash -lc '...'` command string; nested quoting is brittle and can
|
|
338
|
-
truncate the first worker before mutation. For multi-worker launchers, write one
|
|
339
|
-
plain prompt file per lane under the current run directory, then start each
|
|
340
|
-
worker with `codex -a never -s danger-full-access exec --skip-git-repo-check -m "$WORKER_MODEL" -C "$REPO" -o
|
|
341
|
-
"$worker_final_file" - < "$worker_prompt_file"`. Keep launcher shell variables
|
|
342
|
-
double-quoted and keep the prompt heredoc only in a standalone script/prompt-file
|
|
343
|
-
write step, not inside an already quoted shell argument. If the first launcher
|
|
344
|
-
attempt exits with a shell parse error or before starting the first worker,
|
|
345
|
-
stop with `blocked: worker_launcher_quoting_failed` and do not retry by
|
|
346
|
-
loosening sender scope or mutating in the parent.
|
|
347
|
-
Do not use `nohup`, detached background workers, or any launcher that returns
|
|
348
|
-
before the workers finish and before receipts/final files exist. A durable
|
|
349
|
-
worker must run in a foreground command session, visible Codex thread, or a shell
|
|
350
|
-
that stays alive until every worker has finished. If using background jobs inside
|
|
351
|
-
one shell, the same shell must stay alive, wait for every worker PID, poll only
|
|
352
|
-
the expected receipt paths, and record a per-worker exit code plus final-file
|
|
353
|
-
paths and stderr/log paths before returning. If workers exit with empty logs and
|
|
354
|
-
no final files because the subprocess detached or was reaped, stop with
|
|
355
|
-
`blocked: worker_subprocess_detached_without_output` before parent verify.
|
|
356
|
-
When launching multiple local Codex CLI workers from one shell, start each
|
|
357
|
-
background job in the same shell that will call `wait`. Do not capture worker
|
|
358
|
-
PIDs through command substitution, a subshell, a pipeline, or a helper function
|
|
359
|
-
invoked as `worker_pid=$(launch_worker ...)`; those patterns make the captured
|
|
360
|
-
PID non-waitable by the parent shell. Use the same-shell PID array pattern:
|
|
361
|
-
`pids=(); codex ... > "$log_file" 2>&1 & pids+=("$!")`, then
|
|
362
|
-
`for pid in "${pids[@]}"; do wait "$pid" || rc=1; done`. If `wait` reports
|
|
363
|
-
`pid is not a child of this shell`, stop with
|
|
364
|
-
`blocked: worker_subprocess_detached_without_output`.
|
|
365
|
-
Short form: run the wrapper with `/bin/bash -lc`.
|
|
366
|
-
Short form: Do not rely on zsh-specific behavior.
|
|
367
|
-
Short form: Do not use `status` as a shell variable; use `exit_code` or `rc`.
|
|
368
|
-
Short form: Do not capture worker PIDs through command substitution or a subshell.
|
|
369
|
-
Short form: Use same-shell `pids+=("$!")` before waiting on every PID.
|
|
370
|
-
Short form: Receipt polling uses `find <receipt-dir> -maxdepth 1 -name 'evg_*.json' -print`.
|
|
371
|
-
Short form: Do not use naked `*.json` globs under zsh; no `no matches found` diagnostics.
|
|
372
|
-
Short form: Do not embed `<<'WORKER_PROMPT'` heredocs inside a quoted `/bin/bash -lc` command string.
|
|
373
|
-
Short form: Multi-worker launchers write prompt files and run `codex ... - < "$worker_prompt_file"`.
|
|
374
|
-
Short form: Do not use `nohup`; keep the worker process attached until receipt or blocker.
|
|
375
|
-
After the auto-executable plan returns, take at most one short planning pass to
|
|
376
|
-
choose the visible/durable worker runtime and build the worker launch packet.
|
|
377
|
-
Do not keep reasoning, re-reading prompts, or restating the workflow instead of
|
|
378
|
-
dispatching. If the parent cannot name the callable worker runtime and prepare
|
|
379
|
-
the first worker launch command/tool call immediately after that pass, stop with
|
|
380
|
-
`blocked: worker_dispatch_deadline_exceeded` before directory setup or mutation.
|
|
381
267
|
After creating receipt directories, dispatch workers immediately; do not perform extended parent reasoning, extra inventory, or prompt rewriting loops.
|
|
382
|
-
Before any campaign shell creation, the parent must dispatch every selected lane
|
|
383
|
-
worker from the current plan and record the visible thread id or
|
|
384
|
-
`receiptArtifactPath` for each selected actionId. The parent must not call
|
|
385
|
-
`create_campaign`, `import_leads`, `confirm_lead_list`, sequence tools, message
|
|
386
|
-
preparation tools, or `setup_evergreen_campaigns` with `mode:"apply"` or any
|
|
387
|
-
other mutating setup mode. In this wrapper, `setup_evergreen_campaigns` is
|
|
388
|
-
plan/verify authority only; customer-visible creation belongs inside lane
|
|
389
|
-
workers through `$sellable:create-campaign`. If a campaign/table id appears for
|
|
390
|
-
a create lane before that lane has a recorded worker runtime and fresh receipt
|
|
391
|
-
path/thread id, stop with `blocked: parent_mutated_before_worker_receipt` and
|
|
392
|
-
do not continue setup in the parent.
|
|
393
|
-
Short form: dispatch every selected lane worker before shell creation.
|
|
394
|
-
Short form: do not call `setup_evergreen_campaigns` with `mode:"apply"` from the parent.
|
|
395
268
|
Use a compact worker prompt: include lane packet JSON, original selectedActionIds,
|
|
396
|
-
original planRevision,
|
|
397
|
-
|
|
398
|
-
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.
|
|
399
271
|
Do not paste the entire wrapper skill into worker prompts. If the parent cannot
|
|
400
272
|
launch at least one visible/durable worker immediately after directory setup,
|
|
401
273
|
stop with `blocked: worker_dispatch_stalled` before any mutation.
|
|
402
|
-
After launching workers, poll only the expected current-run receipt paths from
|
|
403
|
-
`workerDispatch.receiptArtifactHint`. If no worker receipt file appears within a
|
|
404
|
-
bounded wait, for example 10 minutes in automation, stop with
|
|
405
|
-
`blocked: worker_receipt_timeout`, include the worker ids/final-file paths/stderr
|
|
406
|
-
if available, and do not create or repair campaign shells in the parent.
|
|
407
274
|
Use only the repo-local `workerDispatch.receiptArtifactHint` returned by the
|
|
408
275
|
current lane packet for receipt paths.
|
|
409
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.
|
|
410
277
|
After the receipt-directory `mkdir`, the next shell/tool call must launch the first lane worker.
|
|
411
278
|
Do not run `find`, `ls`, extra inventory, or another preflight between directory setup and the first worker launch.
|
|
412
|
-
For the local Codex CLI fallback, use this literal durable CLI worker launch
|
|
413
|
-
|
|
414
|
-
launches you may pipe a heredoc directly to `codex`; for multi-worker shell
|
|
415
|
-
launchers, write the same prompt body to `<worker-prompt-file>` and launch the
|
|
416
|
-
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:
|
|
417
281
|
|
|
418
282
|
```
|
|
419
|
-
codex -a never -s danger-full-access exec
|
|
283
|
+
codex -a never -s danger-full-access exec -C <repo> -o <worker-final-file> - <<'WORKER_PROMPT'
|
|
420
284
|
Use $sellable:create-evergreen-campaigns as the governing skill for this one lane worker.
|
|
421
285
|
|
|
422
286
|
Workspace id: <workspaceId>
|
|
423
287
|
Parent planRevision: <planRevision>
|
|
424
288
|
Parent selectedActionIds: <selectedActionIds JSON>
|
|
425
|
-
Parent postEngagerSenderIds: <postEngagerSenderIds JSON>
|
|
426
|
-
Parent sharedSenderIds: <sharedSenderIds JSON>
|
|
427
289
|
Action id: <actionId>
|
|
428
290
|
Lane key: <laneKey>
|
|
429
291
|
Allowed side effects: <allowedSideEffects JSON>
|
|
@@ -437,9 +299,6 @@ Use mcp__sellable only. Do not use admin tools, direct DB, Prisma, SQL, web sear
|
|
|
437
299
|
Do not launch, start, schedule, send, or use paid InMail.
|
|
438
300
|
Complete only this lane, write the required durable receipt JSON, and stop.
|
|
439
301
|
WORKER_PROMPT
|
|
440
|
-
|
|
441
|
-
# Multi-worker launcher equivalent:
|
|
442
|
-
codex -a never -s danger-full-access exec --skip-git-repo-check -m <worker-model> -C <repo> -o <worker-final-file> - < <worker-prompt-file>
|
|
443
302
|
```
|
|
444
303
|
|
|
445
304
|
If any placeholder cannot be filled from the current lane packet, do not inspect
|
|
@@ -509,14 +368,7 @@ not a parent-thread summary. The receipt must include:
|
|
|
509
368
|
`senderIds`, `campaignId`, `tableId`, and `createIntent`. Do not use
|
|
510
369
|
`laneActionId`, `lanePacketActionId`, `delegatedPlanRevision`,
|
|
511
370
|
`delegatedActionId`, or freeform `requestedCall` text as a substitute for
|
|
512
|
-
these fields.
|
|
513
|
-
`setupPlanCall.tableId` must be the actual created campaign/table ids after
|
|
514
|
-
creation and readback. If the parent lane packet carried null ids before
|
|
515
|
-
creation, preserve that original packet only in a separate `parentLanePacket`
|
|
516
|
-
object; do not leave `setupPlanCall.campaignId:null` or
|
|
517
|
-
`setupPlanCall.tableId:null`.
|
|
518
|
-
Short form: For create lanes, `setupPlanCall.campaignId` and `setupPlanCall.tableId` must be the actual created campaign/table ids.
|
|
519
|
-
Short form: Do not leave `setupPlanCall.campaignId:null` or `setupPlanCall.tableId:null`.
|
|
371
|
+
these fields.
|
|
520
372
|
- `createCampaignWorkflowReceipt`: proof the worker loaded the actual installed
|
|
521
373
|
`$sellable:create-campaign` wrapper instead of doing ad hoc MCP calls. It must
|
|
522
374
|
include `skillCommand:"$sellable:create-campaign"`,
|
|
@@ -571,25 +423,8 @@ not a parent-thread summary. The receipt must include:
|
|
|
571
423
|
evidence field such as `rowCount`, `rowIdsHash`, or `rowEvidence`; do not
|
|
572
424
|
leave those only in `searchSignalsProof`, `importProof`, `coldFallbackProof`,
|
|
573
425
|
or narrative text for the parent/verifier to infer.
|
|
574
|
-
- `filterDecisionReceipt`: saved/applied
|
|
575
|
-
campaign/table basis.
|
|
576
|
-
filtering with `enableICPFilters:true`, call `save_rubrics`, and save at
|
|
577
|
-
least three rubric/filter criteria before Message Drafting. Do not skip
|
|
578
|
-
filtering for evergreen setup. Missing or skipped filter proof is
|
|
579
|
-
`blocked: missing_filter_setup`.
|
|
580
|
-
Before the worker exits, the durable JSON must contain
|
|
581
|
-
`filterDecisionReceipt.status:"applied"`,
|
|
582
|
-
`filterDecisionReceipt.enableICPFilters:true`, the current
|
|
583
|
-
`workflowTableId`, and concrete saved-filter proof such as
|
|
584
|
-
`filterDecisionReceipt.filterIds`, `filterDecisionReceipt.rubricIds`,
|
|
585
|
-
`filterDecisionReceipt.savedRubricCount`, or
|
|
586
|
-
`filterDecisionReceipt.headlineICPCriteria`.
|
|
587
|
-
The exact status string is contractual: use `status:"applied"` only.
|
|
588
|
-
Do not write `status:"confirmed"`, `status:"saved"`, `status:"done"`, or
|
|
589
|
-
any other alias after saving filters; the parent verifier rejects those
|
|
590
|
-
aliases even when saved rubric proof exists.
|
|
591
|
-
Short form: Filter receipt status must be exactly `applied`.
|
|
592
|
-
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.
|
|
593
428
|
- `messageDraftingReceipt`: the Message Drafting proof described below,
|
|
594
429
|
including packaged `generate-messages` prompt/assets and validation. Raw
|
|
595
430
|
fields like `generateMessagesPromptLoadedToHasMoreFalse`,
|
|
@@ -625,10 +460,7 @@ not a parent-thread summary. The receipt must include:
|
|
|
625
460
|
Before writing the durable receipt, run a receipt self-check. The top-level
|
|
626
461
|
receipt must include top-level `planRevision`, `actionId`, `laneKey`,
|
|
627
462
|
`laneType`, `workspaceId`, and `senderIds`, plus campaign/table/source ids and
|
|
628
|
-
row/message/approval counts.
|
|
629
|
-
top-level `durableReceiptWritten:true`, top-level `receiptRunId`, and top-level
|
|
630
|
-
`receiptWrittenAt`; do not leave `receiptArtifactPath` only under
|
|
631
|
-
`createCampaignWorkflowReceipt` for the parent to patch during verify. Inside
|
|
463
|
+
row/message/approval counts. Inside
|
|
632
464
|
`createCampaignStepReceipt.messageDraftingReceipt`, `sampleMessages[]` must
|
|
633
465
|
include `rowId`, `generatedMessageText`, `verdict`, and `issues`. Do not
|
|
634
466
|
substitute `message` for `generatedMessageText`. Do not substitute
|
|
@@ -640,8 +472,6 @@ before writing JSON; do not leave only raw objects like
|
|
|
640
472
|
`get_campaign_message_preparation_status`, `attachRecommendedSequenceResult`,
|
|
641
473
|
`finalCampaignRead`, or `finalTableRead`.
|
|
642
474
|
Self-check shorthand: top-level `planRevision`, `actionId`, `laneKey`, `laneType`, `workspaceId`, and `senderIds` must exist before worker completion.
|
|
643
|
-
Self-check shorthand: top-level `receiptArtifactPath`, `durableReceiptWritten:true`, `receiptRunId`, and `receiptWrittenAt` must exist before worker completion.
|
|
644
|
-
Self-check shorthand: top-level `receiptWrittenAt` must exist before worker completion.
|
|
645
475
|
Self-check shorthand: `campaignBriefReceipt.briefHash`,
|
|
646
476
|
`campaignBriefReceipt.deliveryFormat`, `campaignBriefReceipt.tokenRules`,
|
|
647
477
|
`campaignBriefReceipt.hardAvoids`, and `campaignBriefReceipt.sourceUseRules`
|
|
@@ -730,12 +560,7 @@ verification unless the same object also appears inside
|
|
|
730
560
|
"sourceLadderReason": "<why the current source is valid before colder sources>"
|
|
731
561
|
},
|
|
732
562
|
"filterDecisionReceipt": {
|
|
733
|
-
"status": "
|
|
734
|
-
"enableICPFilters": true,
|
|
735
|
-
"filterIds": ["<saved filter/rubric id>"],
|
|
736
|
-
"rubricIds": ["<saved rubric id>"],
|
|
737
|
-
"headlineICPCriteria": ["<saved ICP criterion>", "<saved ICP criterion>", "<saved ICP criterion>"],
|
|
738
|
-
"savedRubricCount": 3,
|
|
563
|
+
"status": "skipped",
|
|
739
564
|
"workflowTableId": "<workflow table id>"
|
|
740
565
|
},
|
|
741
566
|
"messageDraftingReceipt": {
|
|
@@ -816,19 +641,6 @@ path itself in the worker thread:
|
|
|
816
641
|
exactly one semantic Approved cell through `select_campaign_cells` and
|
|
817
642
|
`update_cell`.
|
|
818
643
|
Approval shorthand: approve exactly one semantic Approved cell.
|
|
819
|
-
In this message-drafting path, `update_cell` is allowed only for the semantic
|
|
820
|
-
Approved checkbox. Do not use `update_cell` or any row/cell write to edit
|
|
821
|
-
generated message text, sample copy, or final message bodies in automation.
|
|
822
|
-
If generated copy fails review, update the campaign brief/message template
|
|
823
|
-
with `update_campaign_brief` or `revise_message_template_and_rerun`, then
|
|
824
|
-
rerun Generate Message and review current-revision generated output. Receipt
|
|
825
|
-
`sampleMessages` must come from generated current-revision cells after the
|
|
826
|
-
brief/template rerun, not from hand-edited message cell overrides. If a lane
|
|
827
|
-
used a generated-message body override, report
|
|
828
|
-
`blocked: generated_message_cell_override` instead of success.
|
|
829
|
-
Short form: `update_cell` is allowed only for the semantic Approved checkbox.
|
|
830
|
-
Short form: Do not use `update_cell` to edit generated message text.
|
|
831
|
-
Short form: Bad copy requires brief/template revision plus Generate Message rerun.
|
|
832
644
|
4. Poll `get_campaign_message_preparation_status` until no queued/active cells
|
|
833
645
|
remain or a bounded stop reason is returned.
|
|
834
646
|
5. Use `get_campaign_messages_preview` or `select_campaign_cells` to inspect
|
|
@@ -855,26 +667,6 @@ The only accepted statusSource values are exactly `branch` and
|
|
|
855
667
|
`packaged-generate-messages-worker`; descriptive aliases such as
|
|
856
668
|
`package-readback-local-thread` are rejected.
|
|
857
669
|
|
|
858
|
-
Before any provider-specific source mutation for a newly created campaign,
|
|
859
|
-
reread `get_campaign_navigation_state({ campaignId })` and use that product
|
|
860
|
-
navigation state as the source-step authority. Do not jump from a shell directly
|
|
861
|
-
into `contact-search`, and do not jump from a shell directly into
|
|
862
|
-
`signal-discovery`. Advance through the product-visible source-selection step
|
|
863
|
-
first, then load the provider prompt and write only the provider/source fields
|
|
864
|
-
accepted for that current step. Never include sender reassignment fields in
|
|
865
|
-
source-step updates, never include custom narration fields in source-step
|
|
866
|
-
updates, and do not use guessed `currentStep` or watched narration payloads to
|
|
867
|
-
force the flow forward. If `update_campaign` rejects the source transition
|
|
868
|
-
twice, reread navigation/campaign state once; if the campaign is not already on
|
|
869
|
-
the intended source step, stop the lane with
|
|
870
|
-
`blocked: watched_source_transition_blocked` and include the rejected tool
|
|
871
|
-
result plus the readback. Do not loop on rejected `update_campaign` transitions.
|
|
872
|
-
Short form: do not jump from a shell directly into `contact-search`.
|
|
873
|
-
Short form: do not jump from a shell directly into `signal-discovery`.
|
|
874
|
-
Short form: never include sender reassignment fields in source-step updates.
|
|
875
|
-
Short form: never include custom narration fields in source-step updates.
|
|
876
|
-
Short form: do not loop on rejected `update_campaign` transitions.
|
|
877
|
-
|
|
878
670
|
One lane may produce exactly one CampaignOffer/campaign id and one current
|
|
879
671
|
workflow table id. For `intent:"create"`, the first successful
|
|
880
672
|
`create_campaign` result establishes the lane's only allowed campaign/table
|
|
@@ -913,14 +705,9 @@ the prospect's engagement unless the selected source evidence proves that exact
|
|
|
913
705
|
sender authored the post.
|
|
914
706
|
Shared lanes must reject generic product-summary samples that explain the
|
|
915
707
|
product in the same broad words for every row. Shared lanes must reject three
|
|
916
|
-
nearly identical samples after stripping the leading name.
|
|
917
|
-
|
|
918
|
-
|
|
919
|
-
If any of these failures appears, revise or rerun the packaged
|
|
920
|
-
create-campaign/generate-messages path from the lane worker before writing a
|
|
921
|
-
success receipt.
|
|
922
|
-
Short form: Shared lanes must fail quality review when any reviewed sample has non-empty `issues`.
|
|
923
|
-
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.
|
|
924
711
|
The generated-message cells are not prompt proof: `currentRevisionGeneratedMessages`,
|
|
925
712
|
Generate Message column counts, `messagesCount`, or rendered row previews prove
|
|
926
713
|
only that table cells exist from the current brief/template, not that the
|
|
@@ -940,37 +727,10 @@ duplicate-lane blockers before you call the command finished. If verify blocks,
|
|
|
940
727
|
report the blocker and repair only the missing postconditions from the same
|
|
941
728
|
current plan.
|
|
942
729
|
|
|
943
|
-
Before calling verify, the parent should build compact receipt objects from the
|
|
944
|
-
durable receipt files and pass those compact objects to MCP. The compact receipt
|
|
945
|
-
must preserve every verifier-owned field named above, including top-level ids,
|
|
946
|
-
`createCampaignStepReceipt`, canonical filter/message/review/sequence/final
|
|
947
|
-
proof, and at least three concrete sample messages. It should omit large raw
|
|
948
|
-
search outputs, long post lists, full row arrays, raw provider responses, and
|
|
949
|
-
debug-only narration fields. Do not pass multi-hundred-kilobyte raw receipt
|
|
950
|
-
objects when a compact canonical receipt has the same proof; large raw verify
|
|
951
|
-
payloads can stall local MCP bridges and make UAT ambiguous.
|
|
952
|
-
Do not print or `jq .` full receipt JSON into the terminal. For local checks,
|
|
953
|
-
print only compact summaries such as file, actionId, laneKey, campaignId,
|
|
954
|
-
filter status, sample count, approved count, and final status.
|
|
955
|
-
Short form: Parent verify uses compact canonical receipt objects, not raw giant receipts.
|
|
956
|
-
Short form: Do not dump full receipt JSON with `jq .`.
|
|
957
|
-
Short form: Never change planRevision/actionId/laneKey while compacting receipts.
|
|
958
|
-
|
|
959
730
|
Message proof for every customer-visible lane must come from the current
|
|
960
731
|
campaign/table basis and include at least 3 generated review rows from the
|
|
961
732
|
packaged `generate-messages` path before completion is reported.
|
|
962
733
|
Parent-thread handwritten copy or setting `currentStep` is not proof.
|
|
963
|
-
|
|
964
|
-
The parent must run its own sample-quality gate before final reporting, even
|
|
965
|
-
when worker receipts say `verdict:"passed"`. For each shared lane, normalize the
|
|
966
|
-
reviewed sample messages by removing leading greeting/name lines, first names,
|
|
967
|
-
and whitespace-only differences; reject shared-lane samples when the message body is identical after removing first names or when all samples share the same
|
|
968
|
-
paragraph skeleton. Also reject final shared-lane samples with `Hey <name>,`
|
|
969
|
-
letter punctuation, weak relevance hedges, internal workflow vocabulary,
|
|
970
|
-
self-intros, or any non-empty `issues`. If the parent finds repeated shared-lane
|
|
971
|
-
sample copy, report `blocked: repeated_shared_lane_sample_copy`, revise the
|
|
972
|
-
campaign brief/template through the packaged workflow, rerun Generate Message,
|
|
973
|
-
and verify current-revision sample messages before final completion.
|
|
974
734
|
</command_backed_workflow>
|
|
975
735
|
|
|
976
736
|
<objective>
|
|
@@ -1005,8 +765,6 @@ and verify current-revision sample messages before final completion.
|
|
|
1005
765
|
Short form: Do not pass the warm template into Shared Signal Discovery or Shared Cold Fallback.
|
|
1006
766
|
Short form: Shared lanes must reject generic product-summary samples.
|
|
1007
767
|
Short form: Shared lanes must reject three nearly identical samples.
|
|
1008
|
-
Short form: Shared lanes must reject low-confidence relevance hedges.
|
|
1009
|
-
Short form: Shared lanes must reject internal workflow vocabulary.
|
|
1010
768
|
Short form: revise or rerun the packaged create-campaign/generate-messages path.
|
|
1011
769
|
- **Post Engagers** first-message style: short, casual, references the
|
|
1012
770
|
sender-authored post they engaged with, closed question, **no internal
|
|
@@ -1017,7 +775,7 @@ and verify current-revision sample messages before final completion.
|
|
|
1017
775
|
|
|
1018
776
|
Hey there
|
|
1019
777
|
|
|
1020
|
-
|
|
778
|
+
Thanks for the support on my post about {{post_topic_line}}
|
|
1021
779
|
```
|
|
1022
780
|
|
|
1023
781
|
- **Shared Signal Discovery** first-message style: short, casual, references
|
|
@@ -1033,22 +791,6 @@ and verify current-revision sample messages before final completion.
|
|
|
1033
791
|
say it. Prefer sender-agnostic company/team language such as "we're
|
|
1034
792
|
helping CX teams..." or "at cxconnect.ai, we help..." and one clear
|
|
1035
793
|
problem question.
|
|
1036
|
-
Before Message Drafting runs, the campaign brief must already include
|
|
1037
|
-
these shared-lane hard avoids and source-use rules. Do not rely on a
|
|
1038
|
-
failed first generation batch to discover that self-intros, generic
|
|
1039
|
-
product summaries, or repeated structure are bad. If the first generated
|
|
1040
|
-
batch violates these rules, rerun, but record that as a repaired UAT path
|
|
1041
|
-
rather than the desired zero-shot path.
|
|
1042
|
-
Do not use low-confidence relevance hedges such as "hope this is
|
|
1043
|
-
relevant" in Shared Signal Discovery samples. Translate source/tool terms
|
|
1044
|
-
into prospect-facing business language; do not put internal workflow
|
|
1045
|
-
vocabulary such as "Codex-style workflow", "MCP", "agent workflows", or
|
|
1046
|
-
"Claude-style agent workflows" in customer-facing message one.
|
|
1047
|
-
Short form: Shared Signal Discovery uses no self-intro such as "I'm building Sellable".
|
|
1048
|
-
Short form: Shared Signal Discovery uses no self-intro such as "We're building Sellable".
|
|
1049
|
-
Short form: Shared Signal Discovery uses no "I've put together".
|
|
1050
|
-
Short form: no low-confidence relevance hedge such as "hope this is relevant".
|
|
1051
|
-
Short form: no internal workflow vocabulary such as "Codex-style workflow", "MCP", "agent workflows", or "Claude-style agent workflows".
|
|
1052
794
|
- **Shared Cold Fallback** first-message style: cold, direct, and cohesive.
|
|
1053
795
|
It must not pretend there was engagement, must not say "saw you pop up",
|
|
1054
796
|
and must not use a standalone name line followed by "Hey there" or other
|
|
@@ -1063,52 +805,14 @@ and verify current-revision sample messages before final completion.
|
|
|
1063
805
|
Sellable/Codex/Claude-Code feature summary
|
|
1064
806
|
across prospects. This is a single-message cold path unless the approved
|
|
1065
807
|
create-campaign message workflow proves a better delivery format.
|
|
1066
|
-
Do not open with "hope this is relevant" or a similar low-confidence
|
|
1067
|
-
relevance hedge. Do not use a repeated product-definition paragraph such
|
|
1068
|
-
as "Sellable is a GTM system" across samples; every reviewed cold sample
|
|
1069
|
-
should be specific enough to the role, company, or problem that the three
|
|
1070
|
-
sample messages do not share the same body skeleton.
|
|
1071
|
-
Before Message Drafting runs, the campaign brief must already forbid
|
|
1072
|
-
self-intros, generic product summaries, opt-out shrugs, product-stack
|
|
1073
|
-
dumps, and repeated template structure. Do not let the first generation
|
|
1074
|
-
batch use "I'm building", "We're building", "I've put together", or
|
|
1075
|
-
similar language and then rely on a cleanup rerun as the normal path.
|
|
1076
808
|
Short form: Shared Cold Fallback must not pass just because the receipt says `generate-messages` loaded.
|
|
1077
809
|
Short form: Shared Cold Fallback uses no self-intro such as "We're building".
|
|
1078
|
-
Short form: Shared Cold Fallback uses no self-intro such as "I'm building Sellable".
|
|
1079
|
-
Short form: Shared Cold Fallback uses no "I've put together".
|
|
1080
810
|
Short form: Shared Cold Fallback uses no opt-out shrug such as "If this isn't relevant, ignore me".
|
|
1081
811
|
Short form: Shared Cold Fallback uses no product-stack dump.
|
|
1082
|
-
|
|
1083
|
-
|
|
1084
|
-
|
|
1085
|
-
|
|
1086
|
-
Shared Cold Fallback. Do not skip filtering for evergreen setup, even when
|
|
1087
|
-
the source is warm. Use the normal `$sellable:create-campaign` filter
|
|
1088
|
-
workflow: set or save 3-5 headline ICP criteria, call `save_rubrics`, and
|
|
1089
|
-
persist `enableICPFilters:true` on the campaign before generating
|
|
1090
|
-
messages. Good evergreen filters should be light but real: role/budget
|
|
1091
|
-
relevance, company/market fit, and obvious non-buyer exclusion. For
|
|
1092
|
-
Post Engagers, keep filters permissive enough that warm source rows are not
|
|
1093
|
-
over-pruned, but still save the filter rules. For shared lanes, filter for
|
|
1094
|
-
buyers/operators relevant to the workspace offer and exclude students,
|
|
1095
|
-
job seekers, vendors, and off-topic commenters. The receipt must show
|
|
1096
|
-
`filterDecisionReceipt.status:"applied"`,
|
|
1097
|
-
`filterDecisionReceipt.enableICPFilters:true`, current `workflowTableId`,
|
|
1098
|
-
and saved filter/rubric proof with at least three saved rubric/filter
|
|
1099
|
-
criteria (`filterIds`, `rubricIds`, `headlineICPCriteria`, or
|
|
1100
|
-
`savedRubricCount`). Missing or skipped filter proof is
|
|
1101
|
-
`blocked: missing_filter_setup`.
|
|
1102
|
-
Short form: Customer-visible evergreen lanes must enable ICP filtering.
|
|
1103
|
-
Short form: `enableICPFilters:true`.
|
|
1104
|
-
Short form: Do not skip filtering for evergreen setup.
|
|
1105
|
-
Short form: at least three saved rubric/filter criteria.
|
|
1106
|
-
Short form: missing or skipped filter proof is `blocked: missing_filter_setup`.
|
|
1107
|
-
Short form: run Message Drafting only after saved filters are applied.
|
|
1108
|
-
- Every customer-visible lane must run Message Drafting from the current
|
|
1109
|
-
campaign/table basis after source rows exist. The worker must load the full
|
|
1110
|
-
packaged `generate-messages` prompt, every required asset, and
|
|
1111
|
-
`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
|
|
1112
816
|
callable in the packaged runtime, the worker must call
|
|
1113
817
|
`start_campaign_message_preparation` and poll
|
|
1114
818
|
`get_campaign_message_preparation_status` from the lane worker. The
|
|
@@ -1138,13 +842,10 @@ and verify current-revision sample messages before final completion.
|
|
|
1138
842
|
- A source/list decision has been resolved and campaign rows are loaded. If
|
|
1139
843
|
there is no approved source or no rows can be copied, report `blocked` with
|
|
1140
844
|
the missing source detail; do not call the campaign complete.
|
|
1141
|
-
|
|
1142
|
-
|
|
1143
|
-
|
|
1144
|
-
|
|
1145
|
-
evergreen setup. Do not leave customer-visible campaigns at
|
|
1146
|
-
`filter-choice`, `filter-rules`, or `apply-icp-rubric` and report success.
|
|
1147
|
-
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.
|
|
1148
849
|
- Message Drafting has run from the current campaign/table basis, using the
|
|
1149
850
|
create-campaign message prompt/assets and validation gate. Updating
|
|
1150
851
|
`currentStep:"messages"` is not proof. Parent-thread handwritten copy is
|
|
@@ -1163,17 +864,13 @@ and verify current-revision sample messages before final completion.
|
|
|
1163
864
|
reviewed sample messages. For Shared Cold Fallback, reject samples that
|
|
1164
865
|
open with a standalone name followed by "Hey there" or a similarly generic
|
|
1165
866
|
greeting. For Shared Cold Fallback, also reject samples with a self-intro
|
|
1166
|
-
such as "We're building",
|
|
1167
|
-
|
|
1168
|
-
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
|
|
1169
869
|
Sellable/Codex/Claude-Code feature summary across prospects. For all
|
|
1170
870
|
shared lanes, reject generic product-summary samples, repeated
|
|
1171
|
-
near-identical samples,
|
|
1172
|
-
|
|
1173
|
-
|
|
1174
|
-
create-campaign/generate-messages path before reporting completion. Do not
|
|
1175
|
-
approve or final-report samples with `verdict:"passed"` and non-empty
|
|
1176
|
-
`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.
|
|
1177
874
|
- The first review batch exists and at least 3 review rows have generated
|
|
1178
875
|
messages from the approved brief. If fewer than 3 usable rows exist, report
|
|
1179
876
|
the actual count and why.
|
|
@@ -1247,9 +944,7 @@ and verify current-revision sample messages before final completion.
|
|
|
1247
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.
|
|
1248
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.
|
|
1249
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.
|
|
1250
|
-
8. **
|
|
1251
|
-
If the `Sample Messaging Review` section is omitted, the command is incomplete even when the structural campaign setup succeeded.
|
|
1252
|
-
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:
|
|
1253
948
|
|
|
1254
949
|
```
|
|
1255
950
|
Evergreen Reconcile — {date}
|
|
@@ -1258,17 +953,6 @@ Evergreen Reconcile — {date}
|
|
|
1258
953
|
• Sellable.dev - Shared Signal Discovery: repaired (send review ready; 50 rows, 3 generated, 1 approved gate row, sequence attached, paused)
|
|
1259
954
|
• Sellable.dev - Shared Cold Fallback: created (send review ready; 50 rows, 3 generated, 1 approved gate row, sequence attached, paused)
|
|
1260
955
|
All campaigns remain unlaunched. Next: enrich/approve more rows when you want more items ready to schedule.
|
|
1261
|
-
|
|
1262
|
-
Sample Messaging Review
|
|
1263
|
-
• Christian Reyes - Post Engagers (`cmp_...`, row `row_...`, verdict: passed)
|
|
1264
|
-
```
|
|
1265
|
-
{{full generated first message}}
|
|
1266
|
-
```
|
|
1267
|
-
• Sellable.dev - Shared Cold Fallback (`cmp_...`, row `row_...`, verdict: passed)
|
|
1268
|
-
```
|
|
1269
|
-
{{full generated first message}}
|
|
1270
|
-
```
|
|
1271
|
-
If any sample is not quite right, ask the AI to update the campaign brief/message template and rerun Generate Message before launch.
|
|
1272
956
|
```
|
|
1273
957
|
</objective>
|
|
1274
958
|
|
|
@@ -3,8 +3,18 @@ name: refill-sends
|
|
|
3
3
|
description: Plan regular campaign and evergreen campaign send refill work through the skill-led refill workflow.
|
|
4
4
|
visibility: public
|
|
5
5
|
allowed-tools:
|
|
6
|
+
- mcp__sellable__refill_sends
|
|
7
|
+
- mcp__sellable__get_auth_status
|
|
8
|
+
- mcp__sellable__start_cli_login
|
|
9
|
+
- mcp__sellable__wait_for_cli_login
|
|
10
|
+
- mcp__sellable__get_active_workspace
|
|
11
|
+
- mcp__sellable__list_workspaces
|
|
12
|
+
- mcp__sellable__set_active_workspace
|
|
6
13
|
- mcp__sellable__get_subskill_prompt
|
|
7
14
|
- mcp__sellable__search_subskill_prompts
|
|
15
|
+
- mcp__sellable__list_senders
|
|
16
|
+
- mcp__sellable__get_sender_routing
|
|
17
|
+
- mcp__sellable__get_campaign_waterfall
|
|
8
18
|
- mcp__sellable__resolve_campaign_fill_route
|
|
9
19
|
- mcp__sellable__get_campaign_refill_state
|
|
10
20
|
- mcp__sellable__fill_campaign_horizon
|
|
@@ -35,14 +45,50 @@ allowed-tools:
|
|
|
35
45
|
- mcp__sellable__get_table_rows
|
|
36
46
|
- mcp__sellable__get_campaign_table_schema
|
|
37
47
|
- mcp__sellable__select_campaign_cells
|
|
48
|
+
- mcp__sellable__queue_campaign_cells
|
|
38
49
|
- mcp__sellable__wait_for_campaign_processing
|
|
39
50
|
- mcp__sellable__get_sender
|
|
40
51
|
---
|
|
41
52
|
|
|
42
53
|
# Refill Sends
|
|
43
54
|
|
|
44
|
-
Use this public wrapper for plain operator requests such as "fill",
|
|
45
|
-
"max out sends", "load everyone up", or "fill horizon sends".
|
|
55
|
+
Use this public command wrapper for plain operator requests such as "fill",
|
|
56
|
+
"refill sends", "max out sends", "load everyone up", or "fill horizon sends".
|
|
57
|
+
|
|
58
|
+
Host command names:
|
|
59
|
+
|
|
60
|
+
- Claude Code: `/sellable:refill-sends`
|
|
61
|
+
- Codex: `$sellable:refill-sends`
|
|
62
|
+
|
|
63
|
+
Accepted invocation flags in the same user request:
|
|
64
|
+
|
|
65
|
+
- `--yolo`: auto-accept the rendered bounded refill packet after the required
|
|
66
|
+
fresh state reread.
|
|
67
|
+
- `--sender <name-or-id>`: scope to a specific sender; repeat for multiple
|
|
68
|
+
senders.
|
|
69
|
+
- `senderIds: <id>, <id>` or `senderNames: <name>, <name>`: explicit selector
|
|
70
|
+
alternatives when the host preserves natural-language arguments better than
|
|
71
|
+
shell-style flags.
|
|
72
|
+
|
|
73
|
+
When the host can call typed MCP tools, start with:
|
|
74
|
+
|
|
75
|
+
```text
|
|
76
|
+
refill_sends({ yolo?: boolean, senders?: string[], senderIds?: string[], senderNames?: string[], horizonSendDays?: number })
|
|
77
|
+
```
|
|
78
|
+
|
|
79
|
+
That command helper only normalizes arguments and returns the execution
|
|
80
|
+
contract. It does not mutate. Continue with the workflow below for route
|
|
81
|
+
selection, state rereads, approval gating, source import, preparation, and
|
|
82
|
+
bounded approval.
|
|
83
|
+
|
|
84
|
+
First call `get_auth_status({})`. If auth or active workspace is not OK, follow
|
|
85
|
+
the returned login/workspace guidance before route resolution. Do not run refill
|
|
86
|
+
research against an implicit or guessed workspace.
|
|
87
|
+
|
|
88
|
+
Treat "refill senders", "fill senders", "load everyone up", and "max out
|
|
89
|
+
senders" as sender-scoped requests. The target set is senders enrolled in active
|
|
90
|
+
campaign-backed sequence campaigns, not the first active campaign returned by a
|
|
91
|
+
resolver.
|
|
46
92
|
|
|
47
93
|
Load the internal workflow prompt before taking any operational step:
|
|
48
94
|
|
|
@@ -51,10 +97,52 @@ get_subskill_prompt({ subskillName: "refill-sends-workflow" })
|
|
|
51
97
|
```
|
|
52
98
|
|
|
53
99
|
Then follow that workflow exactly. The default path is read-only research:
|
|
54
|
-
resolve the route,
|
|
55
|
-
|
|
56
|
-
campaign
|
|
57
|
-
|
|
100
|
+
resolve the route, identify the sender-relevant campaign that most recently had
|
|
101
|
+
scheduler-owned sends, read refill state for that target, report the next safe
|
|
102
|
+
step using campaign names first, and stop before mutation unless the user has
|
|
103
|
+
explicitly approved the exact workspace, campaign/table/source ids, caps/dates,
|
|
104
|
+
approval mode, expected side effects, and stop/rollback condition.
|
|
105
|
+
|
|
106
|
+
For interactive Codex or Claude Code sessions, that approval must use the
|
|
107
|
+
host-native structured question gate, not plain chat:
|
|
108
|
+
|
|
109
|
+
- Codex: use `request_user_input`.
|
|
110
|
+
- Claude Code: use `AskUserQuestion`.
|
|
111
|
+
|
|
112
|
+
The approval question must present the final refill step with exactly two
|
|
113
|
+
choices: `Accept` and `Decline`. The question body must include the operator
|
|
114
|
+
output packet: workspace, sender scope, a campaign-by-campaign table with
|
|
115
|
+
campaign name, sender names, action, target count/cap, source/list, and
|
|
116
|
+
blocker/skip reason, then exact ids, expected side effects, forbidden actions,
|
|
117
|
+
and the stop condition. Treat `Accept` as permission for only the rendered
|
|
118
|
+
target, caps, mode, and side effects. Treat `Decline` as a hard stop with no
|
|
119
|
+
mutation.
|
|
120
|
+
|
|
121
|
+
If Christian includes `--yolo` in the same refill request, treat that flag as
|
|
122
|
+
auto-accept for the rendered bounded refill packet after the required fresh state
|
|
123
|
+
reread. For sender-scoped language with no named senders, `--yolo` means all
|
|
124
|
+
eligible healthy senders enrolled in active campaign-backed sequence campaigns in
|
|
125
|
+
the active workspace. Without `--yolo`, if Christian did not name senders, ask
|
|
126
|
+
which eligible enrolled senders to refill before choosing campaigns or mutating.
|
|
127
|
+
|
|
128
|
+
`--yolo` only covers the exact sender set, per-sender target campaigns, caps,
|
|
129
|
+
approval mode, and side effects in the packet. It does not authorize
|
|
130
|
+
launch/start, sending, archive or delete cleanup, direct scheduler writes, sender
|
|
131
|
+
reassignment, or campaigns outside those selected for the eligible sender set.
|
|
132
|
+
Stop and re-plan if the route, sender set, ids, caps, blockers, or side-effect
|
|
133
|
+
class drift before mutation.
|
|
134
|
+
|
|
135
|
+
In `--yolo`, the default two-day fill horizon is two send days. For each target
|
|
136
|
+
sender, compute the bounded gap from that sender's healthy daily capacity,
|
|
137
|
+
existing future scheduler-owned scheduled sends, and rows already ready to
|
|
138
|
+
schedule across active campaigns enrolled with that sender. Then pick the best
|
|
139
|
+
same-sender campaign to fill the gap: prefer recent/future scheduler-owned sends
|
|
140
|
+
for that sender, then strongest recent result evidence, then source health. Do
|
|
141
|
+
not stop after filling only one sender when the request was sender-scoped. If a
|
|
142
|
+
same-source copy hits the campaign-table row cap, split the current source into
|
|
143
|
+
a bounded LinkedIn profile source list, confirm only that smaller list into the
|
|
144
|
+
same campaign, and operate on the copied review batch. Do not fall back to
|
|
145
|
+
on-demand campaigns or unrelated active-campaign fills.
|
|
58
146
|
|
|
59
147
|
Public concepts are regular campaign and evergreen campaign. Internal direct
|
|
60
148
|
campaign types are unsupported refill targets. `fill_campaign_horizon` is only a
|