@sellable/mcp 0.1.417 → 0.1.419

package/README.md

@@ -66,8 +66,9 @@ reader value, validates proof/AI tells, and saves content artifacts under
 
 The refill-sends public command wrapper plans and executes approval-gated send
 refills. It supports `--yolo` and optional sender selectors such as
-`--sender "Christian Reyes"` or typed MCP calls to `refill_sends({ yolo,
-senders })` from:
+`--sender "Christian Reyes"`, optional through-date selectors such as
+`--until 2026-06-30`, or typed MCP calls to `refill_sends({ yolo, senders,
+untilDate })` from:
 
 - `mcp/sellable/skills/refill-sends/SKILL.md`
 
@@ -296,6 +297,7 @@ Use the refill command for sender send refills:
 
 ```
 /sellable:refill-sends --yolo
+/sellable:refill-sends --yolo --until 2026-06-30
 /sellable:refill-sends --sender "Christian Reyes" --sender "Thomas Nobbs"
 ```
 
@@ -323,6 +325,7 @@ Use the Codex refill command with the same flags:
 
 ```
 $sellable:refill-sends --yolo
+$sellable:refill-sends --yolo --until 2026-06-30
 $sellable:refill-sends --sender "Christian Reyes" --sender "Thomas Nobbs"
 ```
 

package/dist/tools/refill-sends.d.ts

@@ -6,6 +6,7 @@ type RefillSendsCommandInput = {
     senderIds?: string[];
     senderNames?: string[];
     horizonSendDays?: number;
+    untilDate?: string;
     campaignId?: string;
     tableId?: string;
     intent?: RefillSendsIntent;
@@ -48,6 +49,11 @@ export declare const refillSendsToolDefinitions: {
                 maximum: number;
                 description: string;
             };
+            untilDate: {
+                type: string;
+                pattern: string;
+                description: string;
+            };
             campaignId: {
                 type: string;
                 description: string;
@@ -78,7 +84,19 @@ export declare function refillSendsCommand(input?: RefillSendsCommandInput): {
     workflowPromptName: string;
     yolo: boolean;
     intent: RefillSendsIntent;
-    horizonSendDays: number;
+    untilDate: string | null;
+    horizonSendDays: number | null;
+    fillWindow: {
+        mode: string;
+        untilDate: string;
+        description: string;
+        horizonSendDays?: undefined;
+    } | {
+        mode: string;
+        horizonSendDays: number | null;
+        description: string;
+        untilDate?: undefined;
+    };
     approvalMode: RefillSendsApprovalMode;
     campaignId: string | null;
     tableId: string | null;
@@ -101,7 +119,8 @@ export declare function refillSendsCommand(input?: RefillSendsCommandInput): {
                 senders: string[];
                 senderIds: string[];
                 senderNames: string[];
-                horizonSendDays: number;
+                untilDate: string | null;
+                horizonSendDays: number | null;
                 campaignId: string | undefined;
                 tableId: string | undefined;
                 intent: RefillSendsIntent;

package/dist/tools/refill-sends.js

@@ -14,6 +14,25 @@ function normalizeHorizonSendDays(value) {
     }
     return Math.max(1, Math.min(7, Math.floor(value)));
 }
+function normalizeUntilDate(value) {
+    if (value === undefined || value === null || value === "")
+        return null;
+    if (typeof value !== "string") {
+        throw new Error("untilDate must be a string in YYYY-MM-DD format.");
+    }
+    const trimmed = value.trim();
+    if (!/^\d{4}-\d{2}-\d{2}$/.test(trimmed)) {
+        throw new Error("untilDate must use YYYY-MM-DD format.");
+    }
+    const [year, month, day] = trimmed.split("-").map((part) => Number(part));
+    const parsed = new Date(Date.UTC(year, month - 1, day));
+    if (parsed.getUTCFullYear() !== year ||
+        parsed.getUTCMonth() !== month - 1 ||
+        parsed.getUTCDate() !== day) {
+        throw new Error("untilDate must be a valid calendar date.");
+    }
+    return trimmed;
+}
 export const refillSendsToolDefinitions = [
     {
         name: "refill_sends",
@@ -44,7 +63,12 @@ export const refillSendsToolDefinitions = [
                     type: "number",
                     minimum: 1,
                     maximum: 7,
-                    description: "Number of sender-local send days to fill. Defaults to 2.",
+                    description: "Number of sender-local send days to fill. Defaults to 2 when untilDate is not provided.",
+                },
+                untilDate: {
+                    type: "string",
+                    pattern: "^\\d{4}-\\d{2}-\\d{2}$",
+                    description: "Optional sender-local YYYY-MM-DD date to fill through, inclusive. Overrides the default two send-day horizon.",
                 },
                 campaignId: {
                     type: "string",
@@ -76,7 +100,10 @@ export function refillSendsCommand(input = {}) {
     const senderNames = normalizeStrings(input.senderNames);
     const hasSenderSelectors = senders.length > 0 || senderIds.length > 0 || senderNames.length > 0;
     const yolo = input.yolo === true;
-    const horizonSendDays = normalizeHorizonSendDays(input.horizonSendDays);
+    const untilDate = normalizeUntilDate(input.untilDate);
+    const horizonSendDays = untilDate
+        ? null
+        : normalizeHorizonSendDays(input.horizonSendDays);
     const intent = input.intent ?? "plain";
     const approvalMode = input.approvalMode ?? (yolo ? "approve" : "mark_ready");
     const senderScope = hasSenderSelectors
@@ -91,7 +118,19 @@ export function refillSendsCommand(input = {}) {
         workflowPromptName: "refill-sends-workflow",
         yolo,
         intent,
+        untilDate,
         horizonSendDays,
+        fillWindow: untilDate
+            ? {
+                mode: "until_date",
+                untilDate,
+                description: "Fill through this sender-local date inclusive, skipping no-send days and never extending beyond the date without a new packet.",
+            }
+            : {
+                mode: "horizon_send_days",
+                horizonSendDays,
+                description: "Fill the default bounded horizon by sender-local send days.",
+            },
         approvalMode,
         campaignId: input.campaignId ?? null,
         tableId: input.tableId ?? null,
@@ -105,6 +144,9 @@ export function refillSendsCommand(input = {}) {
             'Load get_subskill_prompt({ subskillName: "refill-sends-workflow" }) before any product operation.',
             `Resolve route with resolve_campaign_fill_route({ intent: "${intent}"${input.campaignId ? `, campaignId: "${input.campaignId}"` : ""}${input.tableId ? `, tableId: "${input.tableId}"` : ""} }).`,
             "Call list_senders and get_sender_routing, then resolve sender selectors against active enrolled campaign-backed sequence senders.",
+            untilDate
+                ? `Use fill window untilDate="${untilDate}" as the inclusive sender-local through date; do not extend beyond that date without a new approval packet.`
+                : `Use the default fill window of ${horizonSendDays} sender-local send days.`,
             "Read get_campaign_refill_state for enough exact candidate campaigns to pick the best per-sender target by recent/future scheduler-owned sends, then recent result evidence, then source health.",
             "Fresh reread get_campaign_refill_state immediately before any import, prep, approval, or horizon-fill mutation.",
         ],
@@ -125,10 +167,12 @@ export function refillSendsCommand(input = {}) {
         hostExamples: {
             claude: [
                 "/sellable:refill-sends --yolo",
+                "/sellable:refill-sends --yolo --until 2026-06-30",
                 '/sellable:refill-sends --sender "Christian Reyes" --sender "Thomas Nobbs"',
             ],
             codex: [
                 "$sellable:refill-sends --yolo",
+                "$sellable:refill-sends --yolo --until 2026-06-30",
                 '$sellable:refill-sends --sender "Christian Reyes" --sender "Thomas Nobbs"',
             ],
             mcpTool: {
@@ -138,6 +182,7 @@ export function refillSendsCommand(input = {}) {
                     senders,
                     senderIds,
                     senderNames,
+                    untilDate,
                     horizonSendDays,
                     campaignId: input.campaignId,
                     tableId: input.tableId,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sellable/mcp",
-  "version": "0.1.417",
+  "version": "0.1.419",
   "type": "module",
   "description": "Sellable MCP server for Claude Code and Codex campaign workflows",
   "main": "dist/index.js",

package/skills/create-evergreen-campaigns/SKILL.md

@@ -234,7 +234,15 @@ blocker and would make the whole yolo plan non-autoExecutable even though the
 operator asked to leave it untouched. Inventory and waterfall proof may mention
 the protected lane, but selectedActionIds and lane workers must cover only the
 shared lane packets.
+If the operator says to preserve existing active/live campaigns, preserve an
+ACTIVE Post Engagers lane the same way: treat it as protected inventory, exclude
+it from `postEngagerSenderIds` for the execution plan, and select only the
+remaining missing/reusable shared-lane actionIds. Do not let a protected active
+Post Engagers reuse packet block shared-lane verification or repair. Report the
+protected active lane in inventory/final notes, but do not dispatch a worker for
+it and do not include it in `selectedActionIds`.
 Short form: Do not include the protected active Post Engagers lane as a reuse packet when the operator requested only shared lane execution.
+Short form: "preserve existing active/live campaigns" means exclude ACTIVE Post Engagers from yolo execution, not block all shared-lane work.
 
 When senders are ambiguous, ask which sender ids belong in the Post Engagers
 sender scope and which belong in the shared lane sender scope before planning.
@@ -346,6 +354,14 @@ When launching durable Codex CLI workers from an automation parent, pass an
 explicit supported worker model instead of relying on the Codex CLI default
 model. Use the parent runtime model when known, for example:
 `codex -a never -s danger-full-access exec --skip-git-repo-check -m <worker-model> -C <repo> -o <worker-final-file> -`.
+In Codex CLI, the parent runtime model is visible in the run header as
+`model: <model-name>`. Copy that exact model string into child worker launches
+first. If the parent header says `model: gpt-5.5`, launch workers with
+`-m gpt-5.5`; do not invent or probe nearby aliases such as `gpt-5.3-codex`,
+`gpt-5.2`, `gpt-5-codex`, `codex-latest`, or `codex-mini-latest` before trying
+the exact parent model. A one-line probe must count as supported only when it
+exits 0 and returns the requested output; a session header followed by a
+`not supported` error is rejected, not accepted.
 Do not rely on the Codex CLI default model; some customer and VPS installs
 default to unavailable model aliases. If the parent cannot identify a supported
 worker model and a test `codex exec -m <worker-model>` launch is rejected, stop
@@ -1033,6 +1049,13 @@ canonical lane receipt. Repair workers must stage successful repaired receipts
 under `repair-staged/` first; only after fresh MCP readbacks, improved current
 samples, exactly one approved generated route-proof row, and a local JSON
 self-check pass may the worker atomically replace the canonical lane receipt.
+Repair workers must not call `setup_evergreen_campaigns({ mode:"verify" })`
+or `setup_evergreen_campaigns({ mode:"plan" })`; parent verification and
+idempotency are parent responsibilities after all selected lane receipts are
+ready. A stale-plan/action response from any accidental repair-worker verify
+call is not a product-state blocker and must not prevent a repaired receipt from
+replacing the canonical receipt when fresh product readbacks and local
+sample/receipt checks pass.
 After the repair worker completes the final product readbacks
 (`get_campaign_messages_preview`, `get_campaign`, navigation/table readback),
 it must stage and then rewrite the durable receipt immediately before any
@@ -1049,6 +1072,8 @@ Short form: repair prompts use compact repair packets, not full receipt JSON.
 Short form: Do not include existing receipt JSON in repair prompts.
 Short form: repair workers stage repaired receipts before replacing canonical receipts.
 Short form: repair blockers never overwrite canonical success receipts.
+Short form: repair workers do not call setup_evergreen_campaigns verify or plan.
+Short form: parent owns setup_evergreen_campaigns verify and idempotency.
 Short form: repair workers write the durable receipt immediately after final readbacks.
 Short form: missing repair receipt rewrite is `blocked: repair_receipt_write_timeout`.
 

package/skills/refill-sends/SKILL.md

@@ -66,14 +66,18 @@ Accepted invocation flags in the same user request:
   fresh state reread.
 - `--sender <name-or-id>`: scope to a specific sender; repeat for multiple
   senders.
+- `--until <YYYY-MM-DD>`: fill through that sender-local date, inclusive,
+  instead of the default two send-day horizon.
 - `senderIds: <id>, <id>` or `senderNames: <name>, <name>`: explicit selector
   alternatives when the host preserves natural-language arguments better than
   shell-style flags.
+- `untilDate: YYYY-MM-DD`: explicit date selector alternative when the host
+  preserves natural-language arguments better than shell-style flags.
 
 When the host can call typed MCP tools, start with:
 
 ```text
-refill_sends({ yolo?: boolean, senders?: string[], senderIds?: string[], senderNames?: string[], horizonSendDays?: number })
+refill_sends({ yolo?: boolean, senders?: string[], senderIds?: string[], senderNames?: string[], horizonSendDays?: number, untilDate?: "YYYY-MM-DD" })
 ```
 
 That command helper only normalizes arguments and returns the execution
@@ -132,13 +136,16 @@ reassignment, or campaigns outside those selected for the eligible sender set.
 Stop and re-plan if the route, sender set, ids, caps, blockers, or side-effect
 class drift before mutation.
 
-In `--yolo`, the default two-day fill horizon is two send days. For each target
-sender, compute the bounded gap from that sender's healthy daily capacity,
-existing future scheduler-owned scheduled sends, and rows already ready to
-schedule across active campaigns enrolled with that sender. Then pick the best
-same-sender campaign to fill the gap: prefer recent/future scheduler-owned sends
-for that sender, then strongest recent result evidence, then source health. Do
-not stop after filling only one sender when the request was sender-scoped. If a
+In `--yolo`, the default two-day fill horizon is two send days unless
+`--until`/`untilDate` is provided. If an until date is provided, compute bounded
+gaps through that sender-local date inclusive, skipping no-send days and never
+extending beyond that date without a new packet. For each target sender, compute
+the bounded gap from that sender's healthy daily capacity, existing future
+scheduler-owned scheduled sends, and rows already ready to schedule across
+active campaigns enrolled with that sender. Then pick the best same-sender
+campaign to fill the gap: prefer recent/future scheduler-owned sends for that
+sender, then strongest recent result evidence, then source health. Do not stop
+after filling only one sender when the request was sender-scoped. If a
 same-source copy hits the campaign-table row cap, split the current source into
 a bounded LinkedIn profile source list, confirm only that smaller list into the
 same campaign, and operate on the copied review batch. Do not fall back to