@sellable/mcp 0.1.336 → 0.1.337

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

@@ -0,0 +1,92 @@
+type RefillCampaignSendsInput = {
+    mode?: "plan" | "apply";
+    intent?: "plain" | "evergreen" | "active";
+    campaignIds?: string[];
+    tableIds?: string[];
+    sendWindowDays?: number;
+    targetDates?: string[];
+    targetScheduledSends?: number;
+    approvalMode?: "mark_ready" | "approve";
+    yolo?: boolean;
+    planRevision?: string;
+    actionIds?: string[];
+};
+export declare const refillCampaignSendsToolDefinitions: {
+    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;
+    };
+}[];
+export declare function refillCampaignSends(input: RefillCampaignSendsInput): Promise<unknown>;
+export {};

package/dist/tools/refill-campaign-sends.js

@@ -0,0 +1,91 @@
+import { getApi } from "../api.js";
+async function postRefillCampaignSends(body) {
+    const api = getApi();
+    return api.post("/api/v3/mcp/refill-campaign-sends", body);
+}
+export const refillCampaignSendsToolDefinitions = [
+    {
+        name: "refill_campaign_sends",
+        description: "Default mode is plan and read-only. Use this as the canonical tool for plain fill, refill sends, max out sends, load everyone up, and fill send window requests. It returns a campaign send refill plan for regular campaigns and evergreen campaigns, including campaign/table ids, senders, source state, current evergreen source audit evidence, funnel counts, blockers, stable planRevision, and immutable actionIds. It does not create campaigns, create side campaigns, use unsupported_campaign_type internal targets, does not launch or start campaigns, spend paid InMail opt-in, and does not raw-write scheduler fields. mode apply requires yolo: true, the fresh planRevision from the immediately preceding plan, and selected actionIds only; apply rejects changed caps, source ids, target dates, approval mode, or selectors. Evergreen source fallback is evidence-gated: audit the current evergreen source first and recommend the next source-ladder option only after current-source exhaustion or insufficient good-prospect yield is proven. Scheduled completion is not claimed until scheduler-owned cells are reread with non-null scheduledFor.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                mode: {
+                    type: "string",
+                    enum: ["plan", "apply"],
+                    default: "plan",
+                    description: 'Defaults to "plan"; plan mode is read-only and returns the plan of attack.',
+                },
+                intent: {
+                    type: "string",
+                    enum: ["plain", "evergreen", "active"],
+                    description: 'Use "plain" for generic fill/refill sends, "evergreen" for explicit evergreen, and "active" for exact active campaign refill.',
+                },
+                campaignIds: {
+                    type: "array",
+                    items: { type: "string" },
+                    maxItems: 25,
+                    description: "Optional exact CampaignOffer ids. Do not pass names.",
+                },
+                tableIds: {
+                    type: "array",
+                    items: { type: "string" },
+                    maxItems: 25,
+                    description: "Optional exact WorkflowTable ids. Do not pass names.",
+                },
+                sendWindowDays: {
+                    type: "number",
+                    minimum: 1,
+                    maximum: 30,
+                    description: "Optional send window size in days.",
+                },
+                targetDates: {
+                    type: "array",
+                    items: { type: "string" },
+                    maxItems: 30,
+                    description: "Optional ISO date keys for the send window.",
+                },
+                targetScheduledSends: {
+                    type: "number",
+                    minimum: 1,
+                    maximum: 500,
+                    description: "Optional bounded send target. This is not a launch request.",
+                },
+                approvalMode: {
+                    type: "string",
+                    enum: ["mark_ready", "approve"],
+                    description: "Planning preference. Use approve only when the user explicitly asked for approval; launch remains separate.",
+                },
+                yolo: {
+                    type: "boolean",
+                    description: "Required true for apply. Never use in production without explicit operator approval of exact workspace, campaign/table ids, action ids, caps/dates, and expected side effects.",
+                },
+                planRevision: {
+                    type: "string",
+                    description: "Required for apply. Copy from the fresh read-only plan response.",
+                },
+                actionIds: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "Required for apply. Select immutable actionIds from the fresh plan only.",
+                },
+            },
+            additionalProperties: false,
+        },
+    },
+];
+export function refillCampaignSends(input) {
+    return postRefillCampaignSends({
+        mode: input.mode ?? "plan",
+        intent: input.intent,
+        campaignIds: input.campaignIds,
+        tableIds: input.tableIds,
+        sendWindowDays: input.sendWindowDays,
+        targetScheduledSends: input.targetScheduledSends,
+        targetDates: input.targetDates,
+        approvalMode: input.approvalMode,
+        yolo: input.yolo,
+        planRevision: input.planRevision,
+        actionIds: input.actionIds,
+    });
+}

package/dist/tools/registry.d.ts

@@ -480,17 +480,89 @@ export declare const allTools: ({
     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;
+    inputSchema: {
+        type: string;
+        properties: {
+            action: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            campaignId: {
+                type: string;
+                description: string;
+            };
+            tableId: {
+                type: string;
+                description: string;
+            };
+            stateRevision: {
+                type: string;
+                description: string;
+            };
+            excludedPostIds: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                maxItems: number;
+                description: string;
+            };
+            excludedPostUrls: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                maxItems: number;
+                description: string;
+            };
+            excludedAuthorProfileUrls: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                maxItems: number;
+                description: string;
+            };
+            excludedAuthorNames: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                maxItems: number;
+                description: string;
             };
             targetPreparedMessages: {
                 type: string;
                 minimum: number;
                 maximum: number;
+                description: string;
             };
             maxRowsToCheck: {
                 type: string;
@@ -504,6 +576,46 @@ export declare const allTools: ({
                 maximum: number;
                 description: string;
             };
+        };
+        required: string[];
+        additionalProperties: boolean;
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            campaignId: {
+                type: string;
+                description: string;
+            };
+            tableId: {
+                type: string;
+            };
+            targetPreparedMessages: {
+                type: string;
+                minimum: number;
+                maximum: number;
+            };
+            maxRowsToCheck: {
+                type: string;
+                minimum: number;
+                maximum: number;
+                description: string;
+            };
+            batchSize: {
+                type: string;
+                minimum: number;
+                maximum: number;
+                description: string;
+            };
+            maxBatchRows: {
+                type: string;
+                minimum: number;
+                maximum: number;
+                description: string;
+            };
             approvalMode: {
                 type: string;
                 enum: string[];
@@ -540,6 +652,7 @@ export declare const allTools: ({
             targetPreparedMessages?: undefined;
             maxRowsToCheck?: undefined;
             batchSize?: undefined;
+            maxBatchRows?: undefined;
             approvalMode?: undefined;
             autoContinue?: undefined;
             disableLowPassRateStop?: undefined;
@@ -547,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;

package/dist/tools/registry.js

@@ -2,8 +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";
@@ -42,6 +45,9 @@ import { workspaceToolDefinitions } from "./workspaces.js";
 export const allTools = [
     ...campaignToolDefinitions,
     ...campaignAbTestToolDefinitions,
+    ...campaignFillRoutingToolDefinitions,
+    ...refillCampaignSendsToolDefinitions,
+    ...campaignHorizonFillToolDefinitions,
     ...campaignMessagePreparationToolDefinitions,
     ...campaignProcessingToolDefinitions,
     ...authToolDefinitions,

package/dist/tools/tables.d.ts

@@ -1,6 +1,10 @@
 export interface WorkflowTableListItem {
     id: string;
     name: string;
+    workspaceId: string | null;
+    status: string | null;
+    campaignStatus: string | null;
+    dashboardBucket: "active" | "archived";
     type: string | null;
     campaignOfferId: string | null;
     campaignBacked: boolean;

package/dist/tools/tables.js

@@ -6,7 +6,7 @@ import { getApi } from "../api.js";
 export const tableToolDefinitions = [
     {
         name: "list_tables",
-        description: "List all workflow tables in the active workspace. Returns metadata including whether each table is campaign-backed and whether it has a sequence attached.\n\n" +
+        description: "List all workflow tables in the active workspace. Returns metadata including workspaceId, workflow status, campaignStatus, dashboardBucket, whether each table is campaign-backed, and whether it has a sequence attached.\n\n" +
             "Unlike get_campaigns, this lists every WorkflowTable regardless of how it was created, including create_workflow_table, create_on_demand_table, and UI-created tables.",
         inputSchema: {
             type: "object",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sellable/mcp",
-  "version": "0.1.336",
+  "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

@@ -47,6 +47,9 @@ allowed-tools:
   - 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
   - mcp__sellable__cancel_campaign_message_preparation
@@ -113,27 +116,46 @@ 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
-`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 2500, then adapts later batches up to 250 rows while
-recalculating yield. If the user says "approve X messages", use
+`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
@@ -891,7 +913,11 @@ updates.
 
 1. Call `mcp__sellable__get_auth_status({})`.
 2. If auth is not OK with `error.type === "config"` or `error.type === "auth"`,
-   the user has not signed in yet. Run the FTUX magic-link handoff:
+   the user has not signed in yet. Run first-run login through the FTUX
+   magic-link handoff. If a browser page or tool guidance gives the user a
+   manual fallback, it must be
+   `sellable auth set <token> --workspace-id <workspace_id>`. Do not instruct
+   the user to hand-edit JSON auth config.
 
    a. Say to the user verbatim: