@sellable/mcp 0.1.335 → 0.1.337

package/dist/tools/registry.d.ts

@@ -474,6 +474,35 @@ export declare const allTools: ({
         required: string[];
         additionalProperties: boolean;
     };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            intent: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            campaignId: {
+                type: string;
+                description: string;
+            };
+            tableId: {
+                type: string;
+                description: string;
+            };
+            limit: {
+                type: string;
+                minimum: number;
+                maximum: number;
+                description: string;
+            };
+        };
+        required: string[];
+        additionalProperties: boolean;
+    };
 } | {
     name: string;
     description: string;
@@ -631,6 +660,82 @@ export declare const allTools: ({
         additionalProperties: boolean;
         required?: undefined;
     };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            mode: {
+                type: string;
+                enum: string[];
+                default: string;
+                description: string;
+            };
+            intent: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            campaignIds: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                maxItems: number;
+                description: string;
+            };
+            tableIds: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                maxItems: number;
+                description: string;
+            };
+            sendWindowDays: {
+                type: string;
+                minimum: number;
+                maximum: number;
+                description: string;
+            };
+            targetDates: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                maxItems: number;
+                description: string;
+            };
+            targetScheduledSends: {
+                type: string;
+                minimum: number;
+                maximum: number;
+                description: string;
+            };
+            approvalMode: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            yolo: {
+                type: string;
+                description: string;
+            };
+            planRevision: {
+                type: string;
+                description: string;
+            };
+            actionIds: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+        };
+        additionalProperties: boolean;
+    };
 } | {
     name: string;
     description: string;
@@ -690,6 +795,8 @@ export declare const allTools: ({
             templateRevision?: undefined;
             timeoutMs?: undefined;
             intervalMs?: undefined;
+            rowIds?: undefined;
+            enrichCellIds?: undefined;
             templateMarkdown?: undefined;
             approvedMessageTemplate?: undefined;
         };
@@ -745,6 +852,8 @@ export declare const allTools: ({
             templateRevision?: undefined;
             timeoutMs?: undefined;
             intervalMs?: undefined;
+            rowIds?: undefined;
+            enrichCellIds?: undefined;
             templateMarkdown?: undefined;
             approvedMessageTemplate?: undefined;
         };
@@ -804,6 +913,8 @@ export declare const allTools: ({
             templateRevision?: undefined;
             timeoutMs?: undefined;
             intervalMs?: undefined;
+            rowIds?: undefined;
+            enrichCellIds?: undefined;
             templateMarkdown?: undefined;
             approvedMessageTemplate?: undefined;
         };
@@ -843,12 +954,52 @@ export declare const allTools: ({
             limit?: undefined;
             forceRerun?: undefined;
             reason?: undefined;
+            rowIds?: undefined;
+            enrichCellIds?: undefined;
             templateMarkdown?: undefined;
             approvedMessageTemplate?: undefined;
         };
         additionalProperties: boolean;
         required?: undefined;
     };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            tableId: {
+                type: string;
+            };
+            rowIds: {
+                type: string;
+                items: {
+                    type: string;
+                };
+            };
+            enrichCellIds: {
+                type: string;
+                items: {
+                    type: string;
+                };
+            };
+            campaignId?: undefined;
+            columnRole?: undefined;
+            rowSelector?: undefined;
+            limit?: undefined;
+            forceRerun?: undefined;
+            reason?: undefined;
+            minPassedCount?: undefined;
+            minGeneratedMessages?: undefined;
+            templateRevision?: undefined;
+            timeoutMs?: undefined;
+            intervalMs?: undefined;
+            templateMarkdown?: undefined;
+            approvedMessageTemplate?: undefined;
+        };
+        required: string[];
+        additionalProperties: boolean;
+    };
 } | {
     name: string;
     description: string;
@@ -899,6 +1050,8 @@ export declare const allTools: ({
             templateRevision?: undefined;
             timeoutMs?: undefined;
             intervalMs?: undefined;
+            rowIds?: undefined;
+            enrichCellIds?: undefined;
         };
         required: string[];
         additionalProperties: boolean;

package/dist/tools/registry.js

@@ -2,9 +2,11 @@ import { authToolDefinitions } from "./auth.js";
 import { blueprintCommitToolDefinitions } from "./blueprint-commit.js";
 import { bootstrapToolDefinitions } from "./bootstrap.js";
 import { campaignAbTestToolDefinitions } from "./campaign-ab-test.js";
+import { campaignFillRoutingToolDefinitions } from "./campaign-fill-routing.js";
 import { campaignHorizonFillToolDefinitions } from "./campaign-horizon-fill.js";
 import { campaignMessagePreparationToolDefinitions } from "./campaign-message-preparation.js";
 import { campaignProcessingToolDefinitions } from "./campaign-processing.js";
+import { refillCampaignSendsToolDefinitions } from "./refill-campaign-sends.js";
 import { campaignToolDefinitions } from "./campaigns.js";
 import { cellToolDefinitions } from "./cells.js";
 import { startCliLoginToolDef, waitForCliLoginToolDef } from "./cli-login.js";
@@ -43,6 +45,8 @@ import { workspaceToolDefinitions } from "./workspaces.js";
 export const allTools = [
     ...campaignToolDefinitions,
     ...campaignAbTestToolDefinitions,
+    ...campaignFillRoutingToolDefinitions,
+    ...refillCampaignSendsToolDefinitions,
     ...campaignHorizonFillToolDefinitions,
     ...campaignMessagePreparationToolDefinitions,
     ...campaignProcessingToolDefinitions,

package/package.json

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

package/skills/create-campaign/SKILL.md

@@ -44,8 +44,11 @@ allowed-tools:
   - mcp__sellable__save_rubrics
   - mcp__sellable__get_campaign_table_schema
   - mcp__sellable__select_campaign_cells
+  - mcp__sellable__record_campaign_review_batch
   - mcp__sellable__queue_campaign_cells
   - mcp__sellable__wait_for_campaign_processing
+  - mcp__sellable__refill_campaign_sends
+  - mcp__sellable__resolve_campaign_fill_route
   - mcp__sellable__fill_campaign_horizon
   - mcp__sellable__start_campaign_message_preparation
   - mcp__sellable__get_campaign_message_preparation_status
@@ -105,37 +108,54 @@ most one direct `enrich_with_prospeo` sample when row evidence is too thin.
 After filter approval, the browser should move to Filter Leads with
 `currentStep: "apply-icp-rubric"` and show template waiting/approval copy until
 the template is approved.
+If the bounded filter run later returns `0/N` passes, do not immediately find
+new leads. Load `references/sample-validation-loop.md`, run the zero-pass
+rule-relaxability audit, then choose exactly one recovery: revise saved
+rubrics, record a fresh same-source review batch, or change lead source. Change
+source only when safe relaxation and same-source sampling would still fail or
+would pass bad-fit rows.
 The default path stays the existing first campaign-table execution slice:
 review the normal `reviewBatchLimit:15`, approve reviewed draft rows, then move
-to Settings/sequence/final greenlight. Only call
-`fill_campaign_horizon` for explicit source-cleanup horizon-fill requests, such
-as "fill sends from Signal Discovery but not John Cutler posts." Run
-`fill_campaign_horizon({ action:"audit", ... })` first, then apply with the
-returned `stateRevision`. It imports/prepares at most 300 eligible non-excluded
-source rows in the first pass, caps prep batches at 100, skips existing rows
-from excluded post/author sources, and does not launch the campaign. If the
-user only asks for generic extra sends with no source cleanup, use
-`start_campaign_message_preparation` when the user explicitly asks for more
-prepared messages, a send count, or language like "fill up/load sends for these
-senders." Treat those requests as capacity-fill preparation: calculate the
-bounded target from sender capacity when needed, then let the preparation job
-queue pending `Enrich Prospect` cells, wait for ICP/rubric and Generate Message
-cells to cascade, and mark ready or approve only the target cohort. Do not
-count `checkedRows` as enriched rows; it is only the table cursor. Use
+to Settings/sequence/final greenlight. For any plain post-mint fill request
+such as "fill campaigns", "fill up", "refill sends", "max out sends", or
+"load sends", first call `refill_campaign_sends({ mode:"plan", intent:"plain" })`.
+If the user did not include `--yolo`, report the plan and stop. If the user did
+include `--yolo`, call plan first, inspect blockers, then call
+`refill_campaign_sends({ mode:"apply", yolo:true, planRevision, actionIds })`
+using only the selected immutable action IDs from the fresh plan. Plain fill is
+not an alias for `fill_campaign_horizon` or campaign creation. Keep
+`resolve_campaign_fill_route`, `fill_campaign_horizon`, and
+`start_campaign_message_preparation` as fallback/lower-level diagnostics only
+when `refill_campaign_sends` is unavailable or when the refill command itself
+returns an evergreen subplan. `fill_campaign_horizon` is evergreen-only and
+must not be used for regular campaign refill. When more leads are needed, the
+plan must recommend same-campaign source-ladder replenishment; do not create
+warm-post-engager side campaigns, on-demand campaigns, or unrelated campaigns.
+If fallback `resolve_campaign_fill_route` returns `route:"ask_create"`, ask
+whether to create a normal campaign or evergreen campaigns; campaign creation is
+never the default response to plain fill.
+Treat active fills as capacity-fill preparation: calculate the bounded target
+from sender capacity when needed, then let the preparation job queue pending
+`Enrich Prospect` cells, wait for ICP/rubric and Generate Message cells to
+cascade, and mark ready or approve only the target cohort. Do not count
+`checkedRows` as enriched rows; it is only the table cursor. Use
 `progress.enrichedRows`, `progress.needsEnrichRows`, `activeCellCount`,
-`preparedMessages`, `approvedRows`, target, estimated row budget remaining, and
-`stopReason` to explain progress. If the user says "prepare/generate X
-messages", set `targetPreparedMessages:X`, omit `maxRowsToCheck`, and keep
+`preparedMessages`, `approvedRows`, active preparation jobs, sender-health
+blockers, target, estimated row budget remaining, and `stopReason` to explain
+progress. If the user says "prepare/generate X messages", set
+`targetPreparedMessages:X`, omit `maxRowsToCheck`, and keep
 `approvalMode:"mark_ready"`. The backend calibrates on at least 100 actually
 enriched rows, estimates the row budget from observed rubric/pass yield, caps
 `maxRowsToCheck` at 300, then continues in batches capped at 100 newly checked
 rows. It will not pull another row batch while the current checked batch still
 has queueable or active cells. If the user says "approve X messages", use
 `approvalMode:"approve"` but still do not launch. If the user says "schedule X
-sends" or asks to fill sender sends, use `approvalMode:"approve"` to approve
-exactly the bounded X-message cohort during preparation, then continue through
-sender, sequence, and final launch greenlight; the launch path must verify that
-bounded cohort and must not broad approve-all.
+sends" or asks to fill sender sends, use `approvalMode:"approve"` only when
+the user explicitly asked for approval, approve exactly the bounded X-message
+cohort during preparation, then re-read scheduled counts; if scheduler-owned
+cells are not present, report prepared/approved/ready awaiting scheduler
+instead of success. Final launch remains a separate explicit user greenlight
+and must verify that bounded cohort and must not broad approve-all.
 When approving reviewed draft rows in the campaign table, resolve the actual
 visible `Approved` cells with `select_campaign_cells({ columnRole: "approved",
 rowSelector: { type: "rowIds", rowIds } })` and `update_cell` those returned
@@ -1085,7 +1105,11 @@ updates.
    rubrics and Message Drafting runs.
    After rubrics save, keep Filter Rules visible for approval; after approval,
    move to Filter Leads with `currentStep: "apply-icp-rubric"` and wait there
-   while Message Drafting finishes or the template is approved.
+   while Message Drafting finishes or the template is approved. After template
+   approval and bounded scoring, a `0/N` pass result must run the
+   sample-validation zero-pass rule-relaxability audit before any lead-source
+   revision; the three allowed recoveries are rubric revision, fresh
+   same-source sample, or source revision.
    If filters are skipped, launch Message Drafting before moving to
    Messages/message review; updating `currentStep` to `messages` is not proof
    that the background worker started. Queue the bounded campaign-table