@sellable/install 0.1.260 → 0.1.261

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 capture/ideation, and post
35
- drafting run inside Claude Code or Codex, where the Sellable MCP tools and
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`,
@@ -37,7 +37,7 @@ function getInstallVersion() {
37
37
  }
38
38
  }
39
39
 
40
- const CODEX_PLUGIN_VERSION = "0.1.51";
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, or /sellable:create-post in Claude Code or Codex,
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,72 @@ 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. It also supports \`--until YYYY-MM-DD\` to fill through a specific
1948
+ sender-local date instead of the default two send-day horizon.
1949
+
1950
+ ## Bootstrap
1951
+
1952
+ MCP prompt and command access are required. Do not inspect repo files, run shell
1953
+ commands, use \`npm\`, \`node\`, local harness scripts, or read local prompt
1954
+ files to emulate this workflow.
1955
+
1956
+ If the Sellable MCP prompt tools are unavailable, stop and say this is a Codex
1957
+ install/reload problem. Tell the user to run
1958
+ \`curl -fsSL "https://app.sellable.dev/api/v2/cli/install" | sh\`, fully quit and reopen Codex
1959
+ Desktop, then start a new thread.
1960
+
1961
+ ## Execute Workflow
1962
+
1963
+ 1. Call \`mcp__sellable__get_auth_status({})\`.
1964
+ 2. Normalize invocation arguments with \`mcp__sellable__refill_sends({ yolo, senders, senderIds, senderNames, untilDate })\` when the host exposes typed MCP tools.
1965
+ 3. Load the canonical prompt via
1966
+ \`mcp__sellable__get_subskill_prompt({ subskillName: "refill-sends" })\`,
1967
+ then load \`mcp__sellable__get_subskill_prompt({ subskillName: "refill-sends-workflow" })\`.
1968
+ 4. Follow the canonical prompt exactly. Do not launch, start, archive, delete,
1969
+ or write scheduler rows as part of refill sends.
1970
+
1971
+ ## MCP Prompt Fallback
1972
+
1973
+ If exact subskill lookup fails, use
1974
+ \`mcp__sellable__search_subskill_prompts({ query: "refill-sends", includePublic: true, includeInternal: true })\`,
1975
+ then retry \`get_subskill_prompt\`.
1976
+ `, host, "refill-sends");
1977
+ }
1978
+
1860
1979
  function genericSellableSkillMd({ name, title, description, host = "shared" }) {
1861
1980
  return stampInstalledHost(`---
1862
1981
  name: ${name}
@@ -2330,6 +2449,12 @@ function codexPluginSkills() {
2330
2449
  description: "Capture ideas and draft LinkedIn posts in your voice",
2331
2450
  skillMd: createPostSkillMd(),
2332
2451
  },
2452
+ {
2453
+ dir: "sellable-refill-sends",
2454
+ displayName: "Sellable Refill Sends",
2455
+ description: "Refill sender sends with approval-gated campaign selection",
2456
+ skillMd: refillSendsSkillMd("codex"),
2457
+ },
2333
2458
  ];
2334
2459
  }
2335
2460
 
@@ -2555,6 +2680,16 @@ function claudeCommands() {
2555
2680
  argumentHint: "[post idea or source material]",
2556
2681
  skillMd: createPostSkillMd(),
2557
2682
  },
2683
+ {
2684
+ name: "refill-sends",
2685
+ title: "Refill Sends",
2686
+ filename: join("sellable", "refill-sends.md"),
2687
+ description:
2688
+ "Refill Sellable sender sends through the approval-gated refill workflow.",
2689
+ argumentHint: "[--yolo] [--sender name-or-id ...]",
2690
+ skillMd: refillSendsSkillMd("claude"),
2691
+ allowedTools: ["AskUserQuestion", ...REFILL_SENDS_ALLOWED_TOOLS],
2692
+ },
2558
2693
  {
2559
2694
  name: "create-evergreen-campaigns",
2560
2695
  title: "Create Evergreen Campaigns",
@@ -3852,6 +3987,7 @@ function printNextSteps(installedHosts, authReused) {
3852
3987
  { label: "Foundation", command: "/sellable:foundation" },
3853
3988
  { label: "Content", command: "/sellable:content" },
3854
3989
  { label: "Post", command: "/sellable:create-post" },
3990
+ { label: "Refill", command: "/sellable:refill-sends" },
3855
3991
  ]);
3856
3992
  console.log("");
3857
3993
  console.log("");
@@ -3863,6 +3999,7 @@ function printNextSteps(installedHosts, authReused) {
3863
3999
  { label: "Foundation", command: "$sellable:foundation" },
3864
4000
  { label: "Content", command: "$sellable:content" },
3865
4001
  { label: "Post", command: "$sellable:create-post" },
4002
+ { label: "Refill", command: "$sellable:refill-sends" },
3866
4003
  ]);
3867
4004
  console.log("");
3868
4005
  }
@@ -4153,11 +4290,13 @@ async function main() {
4153
4290
  console.log(` Claude Code: /sellable:foundation`);
4154
4291
  console.log(` Claude Code: /sellable:content`);
4155
4292
  console.log(` Claude Code: /sellable:create-post`);
4293
+ console.log(` Claude Code: /sellable:refill-sends`);
4156
4294
  console.log(` Codex: $sellable:create-campaign`);
4157
4295
  console.log(` Codex: $sellable:create-evergreen-campaigns`);
4158
4296
  console.log(` Codex: $sellable:foundation`);
4159
4297
  console.log(` Codex: $sellable:content`);
4160
4298
  console.log(` Codex: $sellable:create-post`);
4299
+ console.log(` Codex: $sellable:refill-sends`);
4161
4300
  process.exit(0);
4162
4301
  }
4163
4302
  if (rawArgs[0] === "prefs") {
@@ -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
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@sellable/install",
3
- "version": "0.1.260",
3
+ "version": "0.1.261",
4
4
  "type": "module",
5
5
  "description": "One-command installer for Sellable MCP in Claude Code and Codex",
6
6
  "bin": {
@@ -123,6 +123,7 @@ such as "fill campaigns", "fill up", "refill sends", "max out sends", or
123
123
  ```text
124
124
  get_subskill_prompt({ subskillName: "refill-sends-workflow" })
125
125
  resolve_campaign_fill_route({ intent:"plain" })
126
+ list_senders
126
127
  get_campaign_refill_state
127
128
  ```
128
129
 
@@ -133,15 +134,27 @@ campaign refill. Route outcomes are `route:"evergreen_horizon"`,
133
134
  returns `route:"ask_create"`, ask whether to create a normal campaign or
134
135
  evergreen campaigns. Campaign creation is allowed only after this route and
135
136
  explicit user selection; it is never the default response to plain fill. When
136
- more leads are needed, the refill workflow must recommend same-campaign
137
- source-ladder replenishment; do not create warm-post-engager side campaigns,
138
- on-demand campaigns, or unrelated campaigns. Surface sender-health blockers
139
- separately from prepared/approved/scheduled counts.
137
+ choosing among active targets, use refill-state scheduled-count evidence to
138
+ continue the campaign that most recently had scheduler-owned sends for the
139
+ relevant sender set; do not treat every active campaign as a refill candidate.
140
+ In `--yolo` fill/refill mode, default to one best recent-send campaign and a
141
+ two-send-day horizon: subtract future scheduler-owned scheduled sends and
142
+ ready-to-schedule rows from healthy sender daily capacity, then prepare only
143
+ that bounded gap.
144
+ When more leads are needed, the refill workflow must recommend same-campaign
145
+ source-ladder replenishment first; do not create warm-post-engager side
146
+ campaigns, on-demand campaigns, or unrelated campaigns. If same-source copy hits
147
+ `USER_ADDED_ROWS_LIMIT_EXCEEDED`, split the current source into a bounded
148
+ same-source LinkedIn profile list, confirm that smaller list into the same
149
+ campaign, and operate on the copied review batch first. Surface sender-health
150
+ blockers separately from prepared/approved/scheduled counts.
140
151
 
141
152
  Treat active fills as capacity-fill preparation: calculate the bounded target
142
153
  from sender capacity when needed, then use the refill workflow to decide source
143
- replenishment, enrichment/prep, approval policy, and scheduler proof. Mutation
144
- requires exact visible approval and a fresh `get_campaign_refill_state` reread.
154
+ replenishment, enrichment/prep, approval policy, and scheduler proof. Present
155
+ operator decisions by campaign name and sender name first, with campaign/table
156
+ ids as proof only. Mutation requires exact visible approval and a fresh
157
+ `get_campaign_refill_state` reread.
145
158
  For already-running regular campaigns that need Signal Discovery source
146
159
  replenishment, the refill workflow owns the guarded recovery: clear
147
160
  `currentStep` only with `clearCurrentStepIfMatches:"running"`, load the
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: create-evergreen-campaigns
3
3
  description: Reconcile a sender team's evergreen campaigns — create-or-reuse the standing campaigns (per-sender post engagers + shared signal/cold lanes) idempotently, and when asked for customer-ready/full setup, complete each customer-visible campaign to paused send review with brief, rows, generated review messages, one approval gate row, and sequence. Never duplicates, never launches.
4
- visibility: public
4
+ visibility: internal
5
5
  ---
6
6
 
7
7
  # Create Evergreen Campaigns
@@ -14,40 +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 })`. If the user did not name senders but
25
- `get_campaign_waterfall` returns an active managed evergreen/prod waterfall
26
- for the workspace, derive exact sender scopes from the waterfall `senderRefs`
27
- and canonical Post Engagers/shared slots before the first setup plan. Match
28
- `senderRefs` to `list_senders` by LinkedIn public identifier, display name,
29
- or obvious handle/name alias; record the mapping in the plan notes. Do not
30
- call setup with empty sender arrays when product-visible waterfall evidence
31
- identifies the evergreen sender scope.
32
- 2. If the plan is not current, lacks lane packets, or has
33
- `autoExecutable:false`, return the exact blocker before mutation.
34
- 3. Choose the worker runtime immediately. When running under Codex CLI or on VPS,
35
- the local Codex CLI fallback is the default accepted runtime. Use visible
36
- Codex app threads only when the callable thread tools are actually available.
37
- If shell execution is unavailable and no visible/durable thread surface is
38
- callable, return `blocked: missing_visible_or_durable_lane_worker_runtime`
39
- before mutation.
40
- 4. Write one compact prompt file per selected lane packet, create the receipt
41
- directory, and launch all lane workers in parallel with the literal Codex CLI
42
- worker command shape below. The parent does not create campaign shells.
43
- 5. Collect fresh durable receipts, verify with the original planRevision and
44
- selectedActionIds, then run the idempotency plan and show sample messages.
45
-
46
- Do not keep reasoning, re-reading prompts, or restating this workflow instead of
47
- dispatching workers. If the first worker cannot be launched after at most one
48
- short planning pass, return `blocked: worker_dispatch_deadline_exceeded` before
49
- directory setup or product mutation.
50
-
51
17
  <inputs>
52
18
  The invoking prompt names the senders ("create evergreen campaigns for csreyes92 and thomas"). Resolve each via `list_senders`.
53
19
 
@@ -92,32 +58,6 @@ Default evergreen plan per workspace (override only if the prompt specifies diff
92
58
  1. **`<Sender Name> - Post Engagers`** — one per sender (warm lane, highest priority)
93
59
  2. **`<Workspace/Team> - Shared Signal Discovery`** — one shared warm-signal campaign lane across senders
94
60
  3. **`<Workspace/Team> - Shared Cold Fallback`** — one shared cold/fallback campaign lane across senders
95
-
96
- Sender scope resolution is safety-critical. Do not pass
97
- `allConnectedSenders:true` unless the invoking prompt explicitly says "all
98
- connected senders", "every connected sender", "all seats", or names an
99
- equivalent all-sender scope. If the user says "all 4 campaigns", "the four
100
- evergreen campaigns", or names specific senders, resolve those exact senders
101
- and pass explicit `postEngagerSenderIds` plus `sharedSenderIds`; do not broaden
102
- the plan to every connected sender. If the prompt does not name senders but the
103
- active workspace has a product-visible managed evergreen/prod waterfall, derive
104
- the exact scope from that waterfall instead of using all connected senders:
105
- Post Engagers sender scope is the senderRefs that own person-specific
106
- Post Engagers slots; shared sender scope is the union of senderRefs on the
107
- shared Signal Discovery and Shared Cold Fallback waterfall slots. If the
108
- waterfall has one clear production evergreen program for the workspace, this is
109
- not ambiguous even when `list_senders` returns additional connected senders.
110
- In non-interactive or `--yolo` mode, when more than two connected senders exist
111
- and neither the prompt nor product-visible waterfall evidence identifies exact
112
- evergreen sender scope, stop before mutation with
113
- `blocked: ambiguous_post_engager_sender_scope` and report the sender ids/names
114
- needed for approval. Never let "workspace default" silently create Post
115
- Engagers lanes for extra senders.
116
- Short form: Do not pass `allConnectedSenders:true` unless the prompt explicitly says all/every connected sender.
117
- Short form: "all 4 campaigns" means explicit sender scope plus two shared lanes, not all connected senders.
118
- Short form: Product-visible managed evergreen/prod waterfall senderRefs are exact sender scope.
119
- Short form: Do not report `no_senders` while waterfall senderRefs can be mapped to list_senders.
120
- Short form: In `--yolo`, ambiguous multi-sender scope blocks before mutation.
121
61
  </inputs>
122
62
 
123
63
  <command_backed_workflow>
@@ -131,13 +71,6 @@ error, or does not return a current `planRevision` with lane packets, stop
131
71
  immediately with `blocked: setup_evergreen_campaigns_unavailable`. Do not fall
132
72
  back to ad hoc create-campaign calls, inventory-only guesses, or direct shell
133
73
  creation when the command-backed plan is missing.
134
- Exception: if an initial unscoped plan returns only `blocked:no_senders`, and
135
- the parent has already read `list_senders` plus a product-visible managed
136
- evergreen/prod waterfall with mappable `senderRefs`, immediately re-run the
137
- plan once with explicit derived `postEngagerSenderIds` and `sharedSenderIds`.
138
- Do not report `no_senders` to the user until that scoped plan has also failed.
139
- If senderRef mapping is partial, stop with
140
- `blocked: ambiguous_post_engager_sender_scope` and include the unmapped refs.
141
74
 
142
75
  MCP/product-visible proof only: every success claim must be observable through
143
76
  the installed Sellable MCP tools and product-visible readbacks a normal user or
@@ -282,8 +215,7 @@ After bounded delegated approval or safe `--yolo`, fan out lane worker tasks
282
215
  only from the current plan. Each worker receives the complete lane packet:
283
216
  workspace id, sender ids, lane key/type, existing campaign/table binding or
284
217
  create intent, source hints, caps, planRevision, actionId, allowed side effects,
285
- postconditions, the parent `postEngagerSenderIds`, the parent
286
- `sharedSenderIds`, and the packet's `workerDispatch` policy. Treat
218
+ postconditions, and the packet's `workerDispatch` policy. Treat
287
219
  `workerDispatch.requiresVisibleThreadOrDurableReceipt:true` as a hard
288
220
  execution boundary, not guidance. Read and preserve `workerDispatch.acceptedRuntimes`,
289
221
  `workerDispatch.rejectedRuntimes`, and `workerDispatch.receiptArtifactHint`
@@ -302,15 +234,6 @@ parent packet, do not mutate and do not use it as `setupPlanCall` proof; stop
302
234
  with `blocked: worker_plan_scope_drift` and ask the parent to re-plan.
303
235
  Short form: If a worker-local plan omits `postEngagerSenderIds:[]`, do not use it as `setupPlanCall` proof.
304
236
  Short form: stop with `blocked: worker_plan_scope_drift`.
305
- Every worker prompt must include both parent scope arrays as explicit fields:
306
- `Parent postEngagerSenderIds:` and `Parent sharedSenderIds:`. Workers must
307
- preserve parent postEngagerSenderIds even for shared lanes. Never run a
308
- shared-lane worker-local plan with `postEngagerSenderIds:[]` unless the parent
309
- `postEngagerSenderIds` is exactly `[]`. Every durable receipt must copy these
310
- arrays to top-level `parentPostEngagerSenderIds` and `parentSharedSenderIds`
311
- before completion.
312
- Short form: Workers must preserve parent postEngagerSenderIds even for shared lanes.
313
- Short form: Never run a shared-lane worker-local plan with `postEngagerSenderIds:[]` unless the parent `postEngagerSenderIds` is exactly `[]`.
314
237
 
315
238
  Worker fan-out must use visible or durable execution. Preferred in local Codex
316
239
  is a visible Codex thread created with the actual Codex app thread tools:
@@ -334,128 +257,35 @@ acceptable only when it writes a fresh durable per-lane receipt artifact as it
334
257
  works.
335
258
  When visible Codex app thread tools are unavailable but local Codex CLI is
336
259
  available, the accepted durable streaming-worker command shape is:
337
- `codex -a never -s danger-full-access exec --skip-git-repo-check -m <worker-model> -C <repo> -o <worker-final-file> -`.
260
+ `codex -a never -s danger-full-access exec -C <repo> -o <worker-final-file> -`.
338
261
  The approval and sandbox flags must come before the `exec` subcommand for Codex
339
- CLI builds that expose `-a`/`-s` only at top level. `--skip-git-repo-check` belongs after `exec` because current customer and VPS Codex CLI builds expose it
340
- 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
341
263
  `codex exec --ask-for-approval never ...` or `codex exec -a never ...`; those
342
264
  forms fail on current customer CLI installs. Pipe the lane packet prompt on
343
265
  stdin, require the worker to write `workerDispatch.receiptArtifactHint`, and
344
266
  pass exactly one lane packet per worker.
345
- When launching durable Codex CLI workers from an automation parent, pass an
346
- explicit supported worker model instead of relying on the Codex CLI default
347
- model. Use the parent runtime model when known, for example:
348
- `codex -a never -s danger-full-access exec --skip-git-repo-check -m <worker-model> -C <repo> -o <worker-final-file> -`.
349
- Do not rely on the Codex CLI default model; some customer and VPS installs
350
- default to unavailable model aliases. If the parent cannot identify a supported
351
- worker model and a test `codex exec -m <worker-model>` launch is rejected, stop
352
- with `blocked: worker_model_unavailable` before mutation.
353
- When wrapping multiple local Codex CLI workers in a shell launcher, run the
354
- wrapper with `/bin/bash -lc` or another explicitly chosen portable shell. Do not
355
- rely on zsh-specific behavior. Do not use `status` as a shell variable because
356
- zsh treats it as read-only; use `exit_code` or `rc` instead. Receipt polling
357
- must use `find <receipt-dir> -maxdepth 1 -name 'evg_*.json' -print` or an
358
- explicit nullglob-safe equivalent. Do not use naked `*.json` globs under zsh,
359
- and keep zero-receipt polls quiet with no `no matches found` diagnostics.
360
- Do not embed `<<'WORKER_PROMPT'` heredocs inside a single quoted or double
361
- quoted `/bin/bash -lc '...'` command string; nested quoting is brittle and can
362
- truncate the first worker before mutation. For multi-worker launchers, write one
363
- plain prompt file per lane under the current run directory, then start each
364
- worker with `codex -a never -s danger-full-access exec --skip-git-repo-check -m "$WORKER_MODEL" -C "$REPO" -o
365
- "$worker_final_file" - < "$worker_prompt_file"`. Keep launcher shell variables
366
- double-quoted and keep the prompt heredoc only in a standalone script/prompt-file
367
- write step, not inside an already quoted shell argument. If the first launcher
368
- attempt exits with a shell parse error or before starting the first worker,
369
- stop with `blocked: worker_launcher_quoting_failed` and do not retry by
370
- loosening sender scope or mutating in the parent.
371
- Do not use `nohup`, detached background workers, or any launcher that returns
372
- before the workers finish and before receipts/final files exist. A durable
373
- worker must run in a foreground command session, visible Codex thread, or a shell
374
- that stays alive until every worker has finished. If using background jobs inside
375
- one shell, the same shell must stay alive, wait for every worker PID, poll only
376
- the expected receipt paths, and record a per-worker exit code plus final-file
377
- paths and stderr/log paths before returning. If workers exit with empty logs and
378
- no final files because the subprocess detached or was reaped, stop with
379
- `blocked: worker_subprocess_detached_without_output` before parent verify.
380
- When launching multiple local Codex CLI workers from one shell, start each
381
- background job in the same shell that will call `wait`. Do not capture worker
382
- PIDs through command substitution, a subshell, a pipeline, or a helper function
383
- invoked as `worker_pid=$(launch_worker ...)`; those patterns make the captured
384
- PID non-waitable by the parent shell. Use the same-shell PID array pattern:
385
- `pids=(); codex ... > "$log_file" 2>&1 & pids+=("$!")`, then
386
- `for pid in "${pids[@]}"; do wait "$pid" || rc=1; done`. If `wait` reports
387
- `pid is not a child of this shell`, stop with
388
- `blocked: worker_subprocess_detached_without_output`.
389
- Short form: run the wrapper with `/bin/bash -lc`.
390
- Short form: Do not rely on zsh-specific behavior.
391
- Short form: Do not use `status` as a shell variable; use `exit_code` or `rc`.
392
- Short form: Do not capture worker PIDs through command substitution or a subshell.
393
- Short form: Use same-shell `pids+=("$!")` before waiting on every PID.
394
- Short form: Receipt polling uses `find <receipt-dir> -maxdepth 1 -name 'evg_*.json' -print`.
395
- Short form: Do not use naked `*.json` globs under zsh; no `no matches found` diagnostics.
396
- Short form: Do not embed `<<'WORKER_PROMPT'` heredocs inside a quoted `/bin/bash -lc` command string.
397
- Short form: Multi-worker launchers write prompt files and run `codex ... - < "$worker_prompt_file"`.
398
- Short form: Do not use `nohup`; keep the worker process attached until receipt or blocker.
399
- After the auto-executable plan returns, take at most one short planning pass to
400
- choose the visible/durable worker runtime and build the worker launch packet.
401
- Do not keep reasoning, re-reading prompts, or restating the workflow instead of
402
- dispatching. If the parent cannot name the callable worker runtime and prepare
403
- the first worker launch command/tool call immediately after that pass, stop with
404
- `blocked: worker_dispatch_deadline_exceeded` before directory setup or mutation.
405
267
  After creating receipt directories, dispatch workers immediately; do not perform extended parent reasoning, extra inventory, or prompt rewriting loops.
406
- Before any campaign shell creation, the parent must dispatch every selected lane
407
- worker from the current plan and record the visible thread id or
408
- `receiptArtifactPath` for each selected actionId. The parent must not call
409
- `create_campaign`, `import_leads`, `confirm_lead_list`, sequence tools, message
410
- preparation tools, or `setup_evergreen_campaigns` with `mode:"apply"` or any
411
- other mutating setup mode. In this wrapper, `setup_evergreen_campaigns` is
412
- plan/verify authority only; customer-visible creation belongs inside lane
413
- workers through `$sellable:create-campaign`. If a campaign/table id appears for
414
- a create lane before that lane has a recorded worker runtime and fresh receipt
415
- path/thread id, stop with `blocked: parent_mutated_before_worker_receipt` and
416
- do not continue setup in the parent.
417
- Short form: dispatch every selected lane worker before shell creation.
418
- Short form: do not call `setup_evergreen_campaigns` with `mode:"apply"` from the parent.
419
268
  Use a compact worker prompt: include lane packet JSON, original selectedActionIds,
420
- original planRevision, parent postEngagerSenderIds, parent sharedSenderIds,
421
- receiptArtifactPath, workspace id, sender ids, side-effect caps, and the
422
- instruction to load packaged prompts through MCP.
423
- The worker prompt must include the exact filter status rule:
424
- `filterDecisionReceipt.status:"applied"` only; never `completed`, `confirmed`,
425
- `done`, or any other alias.
426
- The worker prompt must include the generated-message write rule: `update_cell`
427
- is allowed only for the semantic Approved checkbox, never for generated message
428
- text/body/sample copy. Bad copy requires `revise_message_template_and_rerun` or
429
- brief/template revision plus Generate Message rerun; any generated-message cell
430
- override is `blocked: generated_message_cell_override`.
269
+ original planRevision, receiptArtifactPath, workspace id, sender ids,
270
+ side-effect caps, and the instruction to load packaged prompts through MCP.
431
271
  Do not paste the entire wrapper skill into worker prompts. If the parent cannot
432
272
  launch at least one visible/durable worker immediately after directory setup,
433
273
  stop with `blocked: worker_dispatch_stalled` before any mutation.
434
- After launching workers, poll only the expected current-run receipt paths from
435
- `workerDispatch.receiptArtifactHint`. If no worker receipt file appears within a
436
- bounded wait, for example 10 minutes in automation, stop with
437
- `blocked: worker_receipt_timeout`, include the worker ids/final-file paths/stderr
438
- if available, and do not create or repair campaign shells in the parent.
439
274
  Use only the repo-local `workerDispatch.receiptArtifactHint` returned by the
440
275
  current lane packet for receipt paths.
441
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.
442
277
  After the receipt-directory `mkdir`, the next shell/tool call must launch the first lane worker.
443
278
  Do not run `find`, `ls`, extra inventory, or another preflight between directory setup and the first worker launch.
444
- For the local Codex CLI fallback, use this literal durable CLI worker launch
445
- template and fill only the lane-specific placeholders. For one-off direct worker
446
- launches you may pipe a heredoc directly to `codex`; for multi-worker shell
447
- launchers, write the same prompt body to `<worker-prompt-file>` and launch the
448
- 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:
449
281
 
450
282
  ```
451
- codex -a never -s danger-full-access exec --skip-git-repo-check -m <worker-model> -C <repo> -o <worker-final-file> - <<'WORKER_PROMPT'
283
+ codex -a never -s danger-full-access exec -C <repo> -o <worker-final-file> - <<'WORKER_PROMPT'
452
284
  Use $sellable:create-evergreen-campaigns as the governing skill for this one lane worker.
453
285
 
454
286
  Workspace id: <workspaceId>
455
287
  Parent planRevision: <planRevision>
456
288
  Parent selectedActionIds: <selectedActionIds JSON>
457
- Parent postEngagerSenderIds: <postEngagerSenderIds JSON>
458
- Parent sharedSenderIds: <sharedSenderIds JSON>
459
289
  Action id: <actionId>
460
290
  Lane key: <laneKey>
461
291
  Allowed side effects: <allowedSideEffects JSON>
@@ -467,13 +297,8 @@ Worker lane packet JSON:
467
297
  Load `$sellable:create-campaign` and nested prompts/assets through Sellable MCP loaders.
468
298
  Use mcp__sellable only. Do not use admin tools, direct DB, Prisma, SQL, web search, or browser search.
469
299
  Do not launch, start, schedule, send, or use paid InMail.
470
- For filter proof, durable receipt status must be `filterDecisionReceipt.status:"applied"` only; never `completed`, `confirmed`, `done`, or aliases.
471
- For generated messages, `update_cell` is allowed only for the semantic Approved checkbox. Never use `update_cell` for generated message text/body/sample copy. Bad copy requires `revise_message_template_and_rerun` or brief/template revision plus Generate Message rerun. Any generated-message cell override is `blocked: generated_message_cell_override`.
472
300
  Complete only this lane, write the required durable receipt JSON, and stop.
473
301
  WORKER_PROMPT
474
-
475
- # Multi-worker launcher equivalent:
476
- codex -a never -s danger-full-access exec --skip-git-repo-check -m <worker-model> -C <repo> -o <worker-final-file> - < <worker-prompt-file>
477
302
  ```
478
303
 
479
304
  If any placeholder cannot be filled from the current lane packet, do not inspect
@@ -543,14 +368,7 @@ not a parent-thread summary. The receipt must include:
543
368
  `senderIds`, `campaignId`, `tableId`, and `createIntent`. Do not use
544
369
  `laneActionId`, `lanePacketActionId`, `delegatedPlanRevision`,
545
370
  `delegatedActionId`, or freeform `requestedCall` text as a substitute for
546
- these fields. For create lanes, `setupPlanCall.campaignId` and
547
- `setupPlanCall.tableId` must be the actual created campaign/table ids after
548
- creation and readback. If the parent lane packet carried null ids before
549
- creation, preserve that original packet only in a separate `parentLanePacket`
550
- object; do not leave `setupPlanCall.campaignId:null` or
551
- `setupPlanCall.tableId:null`.
552
- Short form: For create lanes, `setupPlanCall.campaignId` and `setupPlanCall.tableId` must be the actual created campaign/table ids.
553
- Short form: Do not leave `setupPlanCall.campaignId:null` or `setupPlanCall.tableId:null`.
371
+ these fields.
554
372
  - `createCampaignWorkflowReceipt`: proof the worker loaded the actual installed
555
373
  `$sellable:create-campaign` wrapper instead of doing ad hoc MCP calls. It must
556
374
  include `skillCommand:"$sellable:create-campaign"`,
@@ -605,26 +423,8 @@ not a parent-thread summary. The receipt must include:
605
423
  evidence field such as `rowCount`, `rowIdsHash`, or `rowEvidence`; do not
606
424
  leave those only in `searchSignalsProof`, `importProof`, `coldFallbackProof`,
607
425
  or narrative text for the parent/verifier to infer.
608
- - `filterDecisionReceipt`: saved/applied ICP filter proof for the current
609
- campaign/table basis. Customer-visible evergreen lanes must enable ICP
610
- filtering with `enableICPFilters:true`, call `save_rubrics`, and save at
611
- least three rubric/filter criteria before Message Drafting. Do not skip
612
- filtering for evergreen setup. Missing or skipped filter proof is
613
- `blocked: missing_filter_setup`.
614
- Before the worker exits, the durable JSON must contain
615
- `filterDecisionReceipt.status:"applied"`,
616
- `filterDecisionReceipt.enableICPFilters:true`, the current
617
- `workflowTableId`, and concrete saved-filter proof such as
618
- `filterDecisionReceipt.filterIds`, `filterDecisionReceipt.rubricIds`,
619
- `filterDecisionReceipt.savedRubricCount`, or
620
- `filterDecisionReceipt.headlineICPCriteria`.
621
- The exact status string is contractual: use `status:"applied"` only.
622
- Do not write `status:"completed"`, `status:"confirmed"`, `status:"saved"`,
623
- `status:"done"`, or any other alias after saving filters; the parent verifier
624
- rejects those aliases even when saved rubric proof exists.
625
- Short form: Filter receipt status must be exactly `applied`.
626
- Short form: Do not write `filterDecisionReceipt.status:"completed"`.
627
- 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.
628
428
  - `messageDraftingReceipt`: the Message Drafting proof described below,
629
429
  including packaged `generate-messages` prompt/assets and validation. Raw
630
430
  fields like `generateMessagesPromptLoadedToHasMoreFalse`,
@@ -660,10 +460,7 @@ not a parent-thread summary. The receipt must include:
660
460
  Before writing the durable receipt, run a receipt self-check. The top-level
661
461
  receipt must include top-level `planRevision`, `actionId`, `laneKey`,
662
462
  `laneType`, `workspaceId`, and `senderIds`, plus campaign/table/source ids and
663
- row/message/approval counts. It must also include top-level `receiptArtifactPath`,
664
- top-level `durableReceiptWritten:true`, top-level `receiptRunId`, and top-level
665
- `receiptWrittenAt`; do not leave `receiptArtifactPath` only under
666
- `createCampaignWorkflowReceipt` for the parent to patch during verify. Inside
463
+ row/message/approval counts. Inside
667
464
  `createCampaignStepReceipt.messageDraftingReceipt`, `sampleMessages[]` must
668
465
  include `rowId`, `generatedMessageText`, `verdict`, and `issues`. Do not
669
466
  substitute `message` for `generatedMessageText`. Do not substitute
@@ -675,8 +472,6 @@ before writing JSON; do not leave only raw objects like
675
472
  `get_campaign_message_preparation_status`, `attachRecommendedSequenceResult`,
676
473
  `finalCampaignRead`, or `finalTableRead`.
677
474
  Self-check shorthand: top-level `planRevision`, `actionId`, `laneKey`, `laneType`, `workspaceId`, and `senderIds` must exist before worker completion.
678
- Self-check shorthand: top-level `receiptArtifactPath`, `durableReceiptWritten:true`, `receiptRunId`, and `receiptWrittenAt` must exist before worker completion.
679
- Self-check shorthand: top-level `receiptWrittenAt` must exist before worker completion.
680
475
  Self-check shorthand: `campaignBriefReceipt.briefHash`,
681
476
  `campaignBriefReceipt.deliveryFormat`, `campaignBriefReceipt.tokenRules`,
682
477
  `campaignBriefReceipt.hardAvoids`, and `campaignBriefReceipt.sourceUseRules`
@@ -765,12 +560,7 @@ verification unless the same object also appears inside
765
560
  "sourceLadderReason": "<why the current source is valid before colder sources>"
766
561
  },
767
562
  "filterDecisionReceipt": {
768
- "status": "applied",
769
- "enableICPFilters": true,
770
- "filterIds": ["<saved filter/rubric id>"],
771
- "rubricIds": ["<saved rubric id>"],
772
- "headlineICPCriteria": ["<saved ICP criterion>", "<saved ICP criterion>", "<saved ICP criterion>"],
773
- "savedRubricCount": 3,
563
+ "status": "skipped",
774
564
  "workflowTableId": "<workflow table id>"
775
565
  },
776
566
  "messageDraftingReceipt": {
@@ -851,25 +641,6 @@ path itself in the worker thread:
851
641
  exactly one semantic Approved cell through `select_campaign_cells` and
852
642
  `update_cell`.
853
643
  Approval shorthand: approve exactly one semantic Approved cell.
854
- In this message-drafting path, `update_cell` is allowed only for the semantic
855
- Approved checkbox. Do not use `update_cell` or any row/cell write to edit
856
- generated message text, sample copy, or final message bodies in automation.
857
- If generated copy fails review, update the campaign brief/message template
858
- with `update_campaign_brief` or `revise_message_template_and_rerun`, then
859
- rerun Generate Message and review current-revision generated output. Receipt
860
- `sampleMessages` must come from generated current-revision cells after the
861
- brief/template rerun, not from hand-edited message cell overrides. If a lane
862
- used a generated-message body override, report
863
- `blocked: generated_message_cell_override` instead of success.
864
- Do not repair by overwriting bad generated message cells and then calling the
865
- overwritten cells `sampleMessages`.
866
- `messageDraftingReceipt.qualityReview.repairNote`,
867
- `messageDraftingReceipt.toolsUsed`, or any proof mentioning generated
868
- message cell repair through `update_cell` is self-incriminating and must be
869
- `blocked: generated_message_cell_override`.
870
- Short form: `update_cell` is allowed only for the semantic Approved checkbox.
871
- Short form: Do not use `update_cell` to edit generated message text.
872
- Short form: Bad copy requires brief/template revision plus Generate Message rerun.
873
644
  4. Poll `get_campaign_message_preparation_status` until no queued/active cells
874
645
  remain or a bounded stop reason is returned.
875
646
  5. Use `get_campaign_messages_preview` or `select_campaign_cells` to inspect
@@ -896,26 +667,6 @@ The only accepted statusSource values are exactly `branch` and
896
667
  `packaged-generate-messages-worker`; descriptive aliases such as
897
668
  `package-readback-local-thread` are rejected.
898
669
 
899
- Before any provider-specific source mutation for a newly created campaign,
900
- reread `get_campaign_navigation_state({ campaignId })` and use that product
901
- navigation state as the source-step authority. Do not jump from a shell directly
902
- into `contact-search`, and do not jump from a shell directly into
903
- `signal-discovery`. Advance through the product-visible source-selection step
904
- first, then load the provider prompt and write only the provider/source fields
905
- accepted for that current step. Never include sender reassignment fields in
906
- source-step updates, never include custom narration fields in source-step
907
- updates, and do not use guessed `currentStep` or watched narration payloads to
908
- force the flow forward. If `update_campaign` rejects the source transition
909
- twice, reread navigation/campaign state once; if the campaign is not already on
910
- the intended source step, stop the lane with
911
- `blocked: watched_source_transition_blocked` and include the rejected tool
912
- result plus the readback. Do not loop on rejected `update_campaign` transitions.
913
- Short form: do not jump from a shell directly into `contact-search`.
914
- Short form: do not jump from a shell directly into `signal-discovery`.
915
- Short form: never include sender reassignment fields in source-step updates.
916
- Short form: never include custom narration fields in source-step updates.
917
- Short form: do not loop on rejected `update_campaign` transitions.
918
-
919
670
  One lane may produce exactly one CampaignOffer/campaign id and one current
920
671
  workflow table id. For `intent:"create"`, the first successful
921
672
  `create_campaign` result establishes the lane's only allowed campaign/table
@@ -954,14 +705,9 @@ the prospect's engagement unless the selected source evidence proves that exact
954
705
  sender authored the post.
955
706
  Shared lanes must reject generic product-summary samples that explain the
956
707
  product in the same broad words for every row. Shared lanes must reject three
957
- nearly identical samples after stripping the leading name. Shared lanes must
958
- fail quality review when any reviewed sample has non-empty `issues`; do not
959
- approve or final-report samples with `verdict:"passed"` and non-empty `issues`.
960
- If any of these failures appears, revise or rerun the packaged
961
- create-campaign/generate-messages path from the lane worker before writing a
962
- success receipt.
963
- Short form: Shared lanes must fail quality review when any reviewed sample has non-empty `issues`.
964
- 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.
965
711
  The generated-message cells are not prompt proof: `currentRevisionGeneratedMessages`,
966
712
  Generate Message column counts, `messagesCount`, or rendered row previews prove
967
713
  only that table cells exist from the current brief/template, not that the
@@ -981,85 +727,10 @@ duplicate-lane blockers before you call the command finished. If verify blocks,
981
727
  report the blocker and repair only the missing postconditions from the same
982
728
  current plan.
983
729
 
984
- Before calling verify, the parent should build compact receipt objects from the
985
- durable receipt files and pass those compact objects to MCP. The compact receipt
986
- must preserve every verifier-owned field named above, including top-level ids,
987
- `createCampaignStepReceipt`, `researchSenderReceipt`, canonical
988
- filter/message/review/sequence/final proof, and at least three concrete sample
989
- messages. It should omit large raw
990
- search outputs, long post lists, full row arrays, raw provider responses, and
991
- debug-only narration fields. Do not pass multi-hundred-kilobyte raw receipt
992
- objects when a compact canonical receipt has the same proof; large raw verify
993
- payloads can stall local MCP bridges and make UAT ambiguous.
994
- Use a small Node JSON compactor for non-trivial compaction. Do not build complex
995
- inline `jq` filters inside nested quoted shell strings; quote failures are a
996
- UAT blocker and waste the verification run. The Node compactor must preserve
997
- every canonical verifier object under `createCampaignStepReceipt`, including
998
- `setupPlanCall`, `createCampaignWorkflowReceipt`, `researchSenderReceipt`,
999
- `campaignBriefReceipt`, `sourceDecisionReceipt`, `filterDecisionReceipt`,
1000
- `messageDraftingReceipt`, `reviewBatchReceipt`, `sequenceReceipt`,
1001
- `finalPausedSendProof`, and `verifyCall`.
1002
- When compacting, normalize `finalPausedSendProof.currentStep` and
1003
- `finalPausedSendProof.campaignStatus` from nested pause/navigation readbacks if
1004
- the worker receipt stored those values under `pauseCampaignResult`,
1005
- `navigationReadback`, or `navigationProof`; do not pass an empty
1006
- `finalPausedSendProof` object to verify.
1007
- Do not print or `jq .` full receipt JSON into the terminal. For local checks,
1008
- print only compact summaries such as file, actionId, laneKey, campaignId,
1009
- filter status, sample count, approved count, and final status.
1010
- Short form: Parent verify uses compact canonical receipt objects, not raw giant receipts.
1011
- Short form: Do not dump full receipt JSON with `jq .`.
1012
- Short form: Do not use complex inline `jq` for receipt compaction; use Node.
1013
- Short form: Compact receipts must preserve `researchSenderReceipt`.
1014
- Short form: Compact receipts must preserve direct `finalPausedSendProof.currentStep` and `campaignStatus`.
1015
- Short form: Never change planRevision/actionId/laneKey while compacting receipts.
1016
-
1017
- Parent repair dispatch uses the same compact discipline. If the parent sample
1018
- quality gate fails after a worker receipt, do not launch a repair worker by
1019
- embedding the full existing receipt JSON, raw row arrays, raw provider output,
1020
- or the full wrapper skill in the repair prompt. Build a compact repair packet
1021
- with only: workspace id, original planRevision, selectedActionIds, lane
1022
- actionId, laneKey, campaignId, tableId, parent sender scope arrays, receipt
1023
- artifact path, allowed repair side effects, failed sample snippets, failed
1024
- quality codes, and the banned phrase list. The repair prompt must say
1025
- `Do not include existing receipt JSON; load current product state through
1026
- Sellable MCP readbacks and rewrite the durable receipt from fresh readbacks`.
1027
- After the repair worker completes the final product readbacks
1028
- (`get_campaign_messages_preview`, `get_campaign`, navigation/table readback),
1029
- it must rewrite the durable receipt immediately before any extended narration,
1030
- analysis, or final answer. If the repair worker cannot rewrite the durable
1031
- receipt in one bounded pass, it must exit with
1032
- `blocked: repair_receipt_write_timeout`. The parent must treat an unchanged
1033
- receipt mtime, missing repair final file, or missing updated
1034
- `messageDraftingReceipt.sampleMessages` after repair as blocked, never success.
1035
- Short form: repair prompts use compact repair packets, not full receipt JSON.
1036
- Short form: Do not include existing receipt JSON in repair prompts.
1037
- Short form: repair workers write the durable receipt immediately after final readbacks.
1038
- Short form: missing repair receipt rewrite is `blocked: repair_receipt_write_timeout`.
1039
-
1040
730
  Message proof for every customer-visible lane must come from the current
1041
731
  campaign/table basis and include at least 3 generated review rows from the
1042
732
  packaged `generate-messages` path before completion is reported.
1043
733
  Parent-thread handwritten copy or setting `currentStep` is not proof.
1044
-
1045
- The parent must run its own sample-quality gate before final reporting, even
1046
- when worker receipts say `verdict:"passed"`. For Post Engagers lanes, reject
1047
- any sample that adds a relevance question, CTA, product line, or extra paragraph
1048
- after `Thank you for the support on my post about ...`; blocked phrases include
1049
- `curious`, `open to`, `trying to`, `worth seeing`, `want to see`, and any
1050
- Sellable/product explanation. For each shared lane, normalize the reviewed
1051
- sample messages by removing leading greeting/name lines, first names, and
1052
- whitespace-only differences; reject shared-lane samples when the message body is
1053
- identical after removing first names or when all samples share the same paragraph
1054
- skeleton. Also reject final shared-lane samples with `Hey <name>,` letter
1055
- punctuation, weak relevance hedges, internal workflow vocabulary, self-intros,
1056
- or any non-empty `issues`. Shared lanes must also reject mechanical
1057
- product-process wording such as `sequence-prospects`, `dashboard overhead`,
1058
- `campaign map`, `campaign idea into prospects`, `prospects, filters, messages`,
1059
- `send-ready copy`, or `reviewed prospect lists`. If the parent finds repeated
1060
- shared-lane sample copy, report `blocked: repeated_shared_lane_sample_copy`,
1061
- revise the campaign brief/template through the packaged workflow, rerun Generate
1062
- Message, and verify current-revision sample messages before final completion.
1063
734
  </command_backed_workflow>
1064
735
 
1065
736
  <objective>
@@ -1094,26 +765,19 @@ Message, and verify current-revision sample messages before final completion.
1094
765
  Short form: Do not pass the warm template into Shared Signal Discovery or Shared Cold Fallback.
1095
766
  Short form: Shared lanes must reject generic product-summary samples.
1096
767
  Short form: Shared lanes must reject three nearly identical samples.
1097
- Short form: Shared lanes must reject low-confidence relevance hedges.
1098
- Short form: Shared lanes must reject internal workflow vocabulary.
1099
768
  Short form: revise or rerun the packaged create-campaign/generate-messages path.
1100
769
  - **Post Engagers** first-message style: short, casual, references the
1101
- sender-authored post they engaged with, and stops after the thank-you
1102
- line. Use **no internal vocabulary, no pitch, no meeting ask, no product
1103
- line, and no relevance question** in message one:
770
+ sender-authored post they engaged with, closed question, **no internal
771
+ vocabulary, no pitch, no meeting ask** in message one:
1104
772
 
1105
773
  ```
1106
774
  {{first_name}}
1107
775
 
1108
776
  Hey there
1109
777
 
1110
- Thank you for the support on my post about {{post_topic_line}}
778
+ Thanks for the support on my post about {{post_topic_line}}
1111
779
  ```
1112
780
 
1113
- Do not add any paragraph after the thank-you line. In particular, do not
1114
- append `curious, are you trying...`, `open to...`, `worth seeing...`, or
1115
- Sellable/product copy to a Post Engagers first message.
1116
-
1117
781
  - **Shared Signal Discovery** first-message style: short, casual, references
1118
782
  the real observed signal/theme or public conversation. It may mention the
1119
783
  engagement source only when the source evidence supports it. Do not say
@@ -1127,28 +791,6 @@ Message, and verify current-revision sample messages before final completion.
1127
791
  say it. Prefer sender-agnostic company/team language such as "we're
1128
792
  helping CX teams..." or "at cxconnect.ai, we help..." and one clear
1129
793
  problem question.
1130
- Before Message Drafting runs, the campaign brief must already include
1131
- these shared-lane hard avoids and source-use rules. Do not rely on a
1132
- failed first generation batch to discover that self-intros, generic
1133
- product summaries, or repeated structure are bad. If the first generated
1134
- batch violates these rules, rerun, but record that as a repaired UAT path
1135
- rather than the desired zero-shot path.
1136
- Do not use low-confidence relevance hedges such as "hope this is
1137
- relevant" in Shared Signal Discovery samples. Translate source/tool terms
1138
- into prospect-facing business language; do not put internal workflow
1139
- vocabulary such as "Codex-style workflow", "MCP", "agent workflows",
1140
- "Claude Code", or "Claude-style agent workflows" in customer-facing
1141
- message one. Also avoid generic product-process nouns such as "dashboard",
1142
- "workflow", "source", "send-ready copy", "reviewed prospect lists",
1143
- "reviewed pipeline", "leads, filters, messages", "review-ready LinkedIn
1144
- sequence", "plain-language campaign idea into leads/filters/messages",
1145
- and "sequence" unless the recipient's own product/category makes that
1146
- exact word buyer-native.
1147
- Short form: Shared Signal Discovery uses no self-intro such as "I'm building Sellable".
1148
- Short form: Shared Signal Discovery uses no self-intro such as "We're building Sellable".
1149
- Short form: Shared Signal Discovery uses no "I've put together".
1150
- Short form: no low-confidence relevance hedge such as "hope this is relevant".
1151
- Short form: no internal workflow vocabulary such as "Codex-style workflow", "MCP", "agent workflows", "Claude Code", or "Claude-style agent workflows".
1152
794
  - **Shared Cold Fallback** first-message style: cold, direct, and cohesive.
1153
795
  It must not pretend there was engagement, must not say "saw you pop up",
1154
796
  and must not use a standalone name line followed by "Hey there" or other
@@ -1163,57 +805,14 @@ Message, and verify current-revision sample messages before final completion.
1163
805
  Sellable/Codex/Claude-Code feature summary
1164
806
  across prospects. This is a single-message cold path unless the approved
1165
807
  create-campaign message workflow proves a better delivery format.
1166
- Do not open with "hope this is relevant" or a similar low-confidence
1167
- relevance hedge. Do not use a repeated product-definition paragraph such
1168
- as "Sellable is a GTM system" across samples; every reviewed cold sample
1169
- should be specific enough to the role, company, or problem that the three
1170
- sample messages do not share the same body skeleton.
1171
- Do not use mechanical Sellable process language such as "campaign idea into
1172
- prospects, filters, messages, and sequence setup", "sequence-prospects",
1173
- "dashboard overhead", "campaign map", "send-ready copy", or "reviewed
1174
- prospect lists" in final cold samples. Say the buyer problem and one plain
1175
- outcome instead.
1176
- Before Message Drafting runs, the campaign brief must already forbid
1177
- self-intros, generic product summaries, opt-out shrugs, product-stack
1178
- dumps, and repeated template structure. Do not let the first generation
1179
- batch use "I'm building", "We're building", "I've put together", or
1180
- similar language and then rely on a cleanup rerun as the normal path.
1181
808
  Short form: Shared Cold Fallback must not pass just because the receipt says `generate-messages` loaded.
1182
809
  Short form: Shared Cold Fallback uses no self-intro such as "We're building".
1183
- Short form: Shared Cold Fallback uses no self-intro such as "I'm building Sellable".
1184
- Short form: Shared Cold Fallback uses no "I've put together".
1185
810
  Short form: Shared Cold Fallback uses no opt-out shrug such as "If this isn't relevant, ignore me".
1186
811
  Short form: Shared Cold Fallback uses no product-stack dump.
1187
- Short form: no low-confidence relevance hedge such as "hope this is relevant".
1188
- Short form: no repeated product-definition paragraph such as "Sellable is a GTM system".
1189
- - Customer-visible evergreen lanes must enable ICP filtering before Message
1190
- Drafting. This applies to Post Engagers, Shared Signal Discovery, and
1191
- Shared Cold Fallback. Do not skip filtering for evergreen setup, even when
1192
- the source is warm. Use the normal `$sellable:create-campaign` filter
1193
- workflow: set or save 3-5 headline ICP criteria, call `save_rubrics`, and
1194
- persist `enableICPFilters:true` on the campaign before generating
1195
- messages. Good evergreen filters should be light but real: role/budget
1196
- relevance, company/market fit, and obvious non-buyer exclusion. For
1197
- Post Engagers, keep filters permissive enough that warm source rows are not
1198
- over-pruned, but still save the filter rules. For shared lanes, filter for
1199
- buyers/operators relevant to the workspace offer and exclude students,
1200
- job seekers, vendors, and off-topic commenters. The receipt must show
1201
- `filterDecisionReceipt.status:"applied"`,
1202
- `filterDecisionReceipt.enableICPFilters:true`, current `workflowTableId`,
1203
- and saved filter/rubric proof with at least three saved rubric/filter
1204
- criteria (`filterIds`, `rubricIds`, `headlineICPCriteria`, or
1205
- `savedRubricCount`). Missing or skipped filter proof is
1206
- `blocked: missing_filter_setup`.
1207
- Short form: Customer-visible evergreen lanes must enable ICP filtering.
1208
- Short form: `enableICPFilters:true`.
1209
- Short form: Do not skip filtering for evergreen setup.
1210
- Short form: at least three saved rubric/filter criteria.
1211
- Short form: missing or skipped filter proof is `blocked: missing_filter_setup`.
1212
- Short form: run Message Drafting only after saved filters are applied.
1213
- - Every customer-visible lane must run Message Drafting from the current
1214
- campaign/table basis after source rows exist. The worker must load the full
1215
- packaged `generate-messages` prompt, every required asset, and
1216
- `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
1217
816
  callable in the packaged runtime, the worker must call
1218
817
  `start_campaign_message_preparation` and poll
1219
818
  `get_campaign_message_preparation_status` from the lane worker. The
@@ -1243,13 +842,10 @@ Message, and verify current-revision sample messages before final completion.
1243
842
  - A source/list decision has been resolved and campaign rows are loaded. If
1244
843
  there is no approved source or no rows can be copied, report `blocked` with
1245
844
  the missing source detail; do not call the campaign complete.
1246
- - The filter step is resolved with saved/applied filters. Customer-visible
1247
- evergreen lanes must have `enableICPFilters:true`, at least three saved
1248
- ICP filter/rubric criteria, and a receipt with
1249
- `filterDecisionReceipt.status:"applied"`. Do not skip filters for
1250
- evergreen setup. Do not leave customer-visible campaigns at
1251
- `filter-choice`, `filter-rules`, or `apply-icp-rubric` and report success.
1252
- 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.
1253
849
  - Message Drafting has run from the current campaign/table basis, using the
1254
850
  create-campaign message prompt/assets and validation gate. Updating
1255
851
  `currentStep:"messages"` is not proof. Parent-thread handwritten copy is
@@ -1268,17 +864,13 @@ Message, and verify current-revision sample messages before final completion.
1268
864
  reviewed sample messages. For Shared Cold Fallback, reject samples that
1269
865
  open with a standalone name followed by "Hey there" or a similarly generic
1270
866
  greeting. For Shared Cold Fallback, also reject samples with a self-intro
1271
- such as "We're building", "I'm building Sellable", or "I've put
1272
- together", an opt-out shrug such as "If this isn't relevant, ignore me",
1273
- 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
1274
869
  Sellable/Codex/Claude-Code feature summary across prospects. For all
1275
870
  shared lanes, reject generic product-summary samples, repeated
1276
- near-identical samples, low-confidence relevance hedges such as "hope this
1277
- is relevant", internal workflow vocabulary, any sample with non-empty
1278
- `issues`, and any preserved Post Engagers opener; revise or rerun the packaged
1279
- create-campaign/generate-messages path before reporting completion. Do not
1280
- approve or final-report samples with `verdict:"passed"` and non-empty
1281
- `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.
1282
874
  - The first review batch exists and at least 3 review rows have generated
1283
875
  messages from the approved brief. If fewer than 3 usable rows exist, report
1284
876
  the actual count and why.
@@ -1352,9 +944,7 @@ Message, and verify current-revision sample messages before final completion.
1352
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.
1353
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.
1354
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.
1355
- 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. Never approve or final-report sample text produced by manual `update_cell` body edits. 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.
1356
- If the `Sample Messaging Review` section is omitted, the command is incomplete even when the structural campaign setup succeeded.
1357
- 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:
1358
948
 
1359
949
  ```
1360
950
  Evergreen Reconcile — {date}
@@ -1363,17 +953,6 @@ Evergreen Reconcile — {date}
1363
953
  • Sellable.dev - Shared Signal Discovery: repaired (send review ready; 50 rows, 3 generated, 1 approved gate row, sequence attached, paused)
1364
954
  • Sellable.dev - Shared Cold Fallback: created (send review ready; 50 rows, 3 generated, 1 approved gate row, sequence attached, paused)
1365
955
  All campaigns remain unlaunched. Next: enrich/approve more rows when you want more items ready to schedule.
1366
-
1367
- Sample Messaging Review
1368
- • Christian Reyes - Post Engagers (`cmp_...`, row `row_...`, verdict: passed)
1369
- ```
1370
- {{full generated first message}}
1371
- ```
1372
- • Sellable.dev - Shared Cold Fallback (`cmp_...`, row `row_...`, verdict: passed)
1373
- ```
1374
- {{full generated first message}}
1375
- ```
1376
- If any sample is not quite right, ask the AI to update the campaign brief/message template and rerun Generate Message before launch.
1377
956
  ```
1378
957
  </objective>
1379
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,54 @@ 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", "refill sends",
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
+ - `--until <YYYY-MM-DD>`: fill through that sender-local date, inclusive,
70
+ instead of the default two send-day horizon.
71
+ - `senderIds: <id>, <id>` or `senderNames: <name>, <name>`: explicit selector
72
+ alternatives when the host preserves natural-language arguments better than
73
+ shell-style flags.
74
+ - `untilDate: YYYY-MM-DD`: explicit date selector alternative when the host
75
+ preserves natural-language arguments better than shell-style flags.
76
+
77
+ When the host can call typed MCP tools, start with:
78
+
79
+ ```text
80
+ refill_sends({ yolo?: boolean, senders?: string[], senderIds?: string[], senderNames?: string[], horizonSendDays?: number, untilDate?: "YYYY-MM-DD" })
81
+ ```
82
+
83
+ That command helper only normalizes arguments and returns the execution
84
+ contract. It does not mutate. Continue with the workflow below for route
85
+ selection, state rereads, approval gating, source import, preparation, and
86
+ bounded approval.
87
+
88
+ First call `get_auth_status({})`. If auth or active workspace is not OK, follow
89
+ the returned login/workspace guidance before route resolution. Do not run refill
90
+ research against an implicit or guessed workspace.
91
+
92
+ Treat "refill senders", "fill senders", "load everyone up", and "max out
93
+ senders" as sender-scoped requests. The target set is senders enrolled in active
94
+ campaign-backed sequence campaigns, not the first active campaign returned by a
95
+ resolver.
46
96
 
47
97
  Load the internal workflow prompt before taking any operational step:
48
98
 
@@ -51,10 +101,55 @@ get_subskill_prompt({ subskillName: "refill-sends-workflow" })
51
101
  ```
52
102
 
53
103
  Then follow that workflow exactly. The default path is read-only research:
54
- resolve the route, read target refill state, report the next safe step, and stop
55
- before mutation unless the user has explicitly approved the exact workspace,
56
- campaign/table/source ids, caps/dates, approval mode, expected side effects,
57
- and stop/rollback condition.
104
+ resolve the route, identify the sender-relevant campaign that most recently had
105
+ scheduler-owned sends, read refill state for that target, report the next safe
106
+ step using campaign names first, and stop before mutation unless the user has
107
+ explicitly approved the exact workspace, campaign/table/source ids, caps/dates,
108
+ approval mode, expected side effects, and stop/rollback condition.
109
+
110
+ For interactive Codex or Claude Code sessions, that approval must use the
111
+ host-native structured question gate, not plain chat:
112
+
113
+ - Codex: use `request_user_input`.
114
+ - Claude Code: use `AskUserQuestion`.
115
+
116
+ The approval question must present the final refill step with exactly two
117
+ choices: `Accept` and `Decline`. The question body must include the operator
118
+ output packet: workspace, sender scope, a campaign-by-campaign table with
119
+ campaign name, sender names, action, target count/cap, source/list, and
120
+ blocker/skip reason, then exact ids, expected side effects, forbidden actions,
121
+ and the stop condition. Treat `Accept` as permission for only the rendered
122
+ target, caps, mode, and side effects. Treat `Decline` as a hard stop with no
123
+ mutation.
124
+
125
+ If Christian includes `--yolo` in the same refill request, treat that flag as
126
+ auto-accept for the rendered bounded refill packet after the required fresh state
127
+ reread. For sender-scoped language with no named senders, `--yolo` means all
128
+ eligible healthy senders enrolled in active campaign-backed sequence campaigns in
129
+ the active workspace. Without `--yolo`, if Christian did not name senders, ask
130
+ which eligible enrolled senders to refill before choosing campaigns or mutating.
131
+
132
+ `--yolo` only covers the exact sender set, per-sender target campaigns, caps,
133
+ approval mode, and side effects in the packet. It does not authorize
134
+ launch/start, sending, archive or delete cleanup, direct scheduler writes, sender
135
+ reassignment, or campaigns outside those selected for the eligible sender set.
136
+ Stop and re-plan if the route, sender set, ids, caps, blockers, or side-effect
137
+ class drift before mutation.
138
+
139
+ In `--yolo`, the default two-day fill horizon is two send days unless
140
+ `--until`/`untilDate` is provided. If an until date is provided, compute bounded
141
+ gaps through that sender-local date inclusive, skipping no-send days and never
142
+ extending beyond that date without a new packet. For each target sender, compute
143
+ the bounded gap from that sender's healthy daily capacity, existing future
144
+ scheduler-owned scheduled sends, and rows already ready to schedule across
145
+ active campaigns enrolled with that sender. Then pick the best same-sender
146
+ campaign to fill the gap: prefer recent/future scheduler-owned sends for that
147
+ sender, then strongest recent result evidence, then source health. Do not stop
148
+ after filling only one sender when the request was sender-scoped. If a
149
+ same-source copy hits the campaign-table row cap, split the current source into
150
+ a bounded LinkedIn profile source list, confirm only that smaller list into the
151
+ same campaign, and operate on the copied review batch. Do not fall back to
152
+ on-demand campaigns or unrelated active-campaign fills.
58
153
 
59
154
  Public concepts are regular campaign and evergreen campaign. Internal direct
60
155
  campaign types are unsupported refill targets. `fill_campaign_horizon` is only a