@sellable/mcp 0.1.328 → 0.1.329

package/dist/server.js

@@ -6,6 +6,7 @@ import { getAuthStatus } from "./tools/auth.js";
 import { handleAddColumn, handleCommitBlueprint, } from "./tools/blueprint-commit.js";
 import { bootstrapCreateCampaign } from "./tools/bootstrap.js";
 import { prepareCampaignAbTest } from "./tools/campaign-ab-test.js";
+import { fillCampaignHorizon } from "./tools/campaign-horizon-fill.js";
 import { cancelPrepareCampaignMessages, getPrepareCampaignMessagesStatus, startPrepareCampaignMessages, } from "./tools/campaign-message-preparation.js";
 import { getCampaignTableSchema, queueCampaignCells, reviseMessageTemplateAndRerun, selectCampaignCells, waitForCampaignProcessing, } from "./tools/campaign-processing.js";
 import { createCampaign, duplicateCampaign, getCampaign, getCampaignMessagesPreview, getCampaigns, pauseCampaign, startCampaign, updateCampaign, updateCampaignBrief, } from "./tools/campaigns.js";
@@ -178,6 +179,12 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
             case "get_campaign_messages_preview":
                 result = await getCampaignMessagesPreview(args);
                 break;
+            case "fill_campaign_horizon":
+                result = await fillCampaignHorizon(args);
+                if (args?.campaignId) {
+                    markCampaignContextDirty(args.campaignId, "fill_campaign_horizon");
+                }
+                break;
             case "start_campaign_message_preparation":
             case "start_prepare_campaign_messages":
                 result = await startPrepareCampaignMessages(args);

package/dist/tools/campaign-horizon-fill.d.ts

@@ -0,0 +1,93 @@
+type FillCampaignHorizonInput = {
+    action: "audit" | "apply";
+    campaignId: string;
+    tableId?: string;
+    stateRevision?: string;
+    excludedPostIds?: string[];
+    excludedPostUrls?: string[];
+    excludedAuthorProfileUrls?: string[];
+    excludedAuthorNames?: string[];
+    targetPreparedMessages?: number;
+    maxRowsToCheck?: number;
+    batchSize?: number;
+};
+export declare const campaignHorizonFillToolDefinitions: {
+    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;
+                minimum: number;
+                maximum: number;
+                description: string;
+            };
+            batchSize: {
+                type: string;
+                minimum: number;
+                maximum: number;
+                description: string;
+            };
+        };
+        required: string[];
+        additionalProperties: boolean;
+    };
+}[];
+export declare function fillCampaignHorizon(input: FillCampaignHorizonInput): Promise<unknown>;
+export {};

package/dist/tools/campaign-horizon-fill.js

@@ -0,0 +1,92 @@
+import { getApi } from "../api.js";
+async function postHorizonFill(body) {
+    const api = getApi();
+    return api.post("/api/v3/mcp/campaign-horizon-fill", body);
+}
+export const campaignHorizonFillToolDefinitions = [
+    {
+        name: "fill_campaign_horizon",
+        description: "Audit or apply a bounded CampaignOffer horizon fill from Signal Discovery/source lead-list rows. Use audit first to get stateRevision, then apply with that stateRevision. Apply imports at most 300 eligible non-excluded source rows, starts bounded message preparation in approval mode, skips rows from excluded posts/authors, and does not start or launch the campaign.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                action: {
+                    type: "string",
+                    enum: ["audit", "apply"],
+                    description: 'Use "audit" to inspect counts/receipt without writes. Use "apply" with the audit stateRevision to import/prep.',
+                },
+                campaignId: {
+                    type: "string",
+                    description: "CampaignOffer.id for the campaign to fill.",
+                },
+                tableId: {
+                    type: "string",
+                    description: "Optional workflow table id. Must match the campaign workflowTableId when provided.",
+                },
+                stateRevision: {
+                    type: "string",
+                    description: "Required for apply. Copy from the immediately preceding audit receipt.",
+                },
+                excludedPostIds: {
+                    type: "array",
+                    items: { type: "string" },
+                    maxItems: 100,
+                    description: "Exact SignalSearchPost ids to exclude from import/preparation.",
+                },
+                excludedPostUrls: {
+                    type: "array",
+                    items: { type: "string" },
+                    maxItems: 100,
+                    description: "Exact LinkedIn post URLs to exclude from import/preparation.",
+                },
+                excludedAuthorProfileUrls: {
+                    type: "array",
+                    items: { type: "string" },
+                    maxItems: 100,
+                    description: "Exact LinkedIn author profile URLs whose source rows should be excluded.",
+                },
+                excludedAuthorNames: {
+                    type: "array",
+                    items: { type: "string" },
+                    maxItems: 25,
+                    description: "Exact author names to exclude only when they resolve unambiguously inside campaign Signal Discovery posts.",
+                },
+                targetPreparedMessages: {
+                    type: "number",
+                    minimum: 1,
+                    maximum: 300,
+                    description: "Prepared/approved message target for the first pass. Backend caps this at 300.",
+                },
+                maxRowsToCheck: {
+                    type: "number",
+                    minimum: 1,
+                    maximum: 300,
+                    description: "Hard first-pass row cap. Backend caps import and prep at 300 rows.",
+                },
+                batchSize: {
+                    type: "number",
+                    minimum: 1,
+                    maximum: 100,
+                    description: "Preparation batch size. Backend caps newly checked rows at 100 per batch.",
+                },
+            },
+            required: ["action", "campaignId"],
+            additionalProperties: false,
+        },
+    },
+];
+export function fillCampaignHorizon(input) {
+    return postHorizonFill({
+        action: input.action,
+        campaignId: input.campaignId,
+        tableId: input.tableId,
+        stateRevision: input.stateRevision,
+        excludedPostIds: input.excludedPostIds,
+        excludedPostUrls: input.excludedPostUrls,
+        excludedAuthorProfileUrls: input.excludedAuthorProfileUrls,
+        excludedAuthorNames: input.excludedAuthorNames,
+        targetPreparedMessages: input.targetPreparedMessages,
+        maxRowsToCheck: input.maxRowsToCheck,
+        batchSize: input.batchSize,
+    });
+}

package/dist/tools/registry.d.ts

@@ -474,6 +474,83 @@ export declare const allTools: ({
         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;
+                minimum: number;
+                maximum: number;
+                description: string;
+            };
+            batchSize: {
+                type: string;
+                minimum: number;
+                maximum: number;
+                description: string;
+            };
+        };
+        required: string[];
+        additionalProperties: boolean;
+    };
 } | {
     name: string;
     description: string;

package/dist/tools/registry.js

@@ -2,6 +2,7 @@ import { authToolDefinitions } from "./auth.js";
 import { blueprintCommitToolDefinitions } from "./blueprint-commit.js";
 import { bootstrapToolDefinitions } from "./bootstrap.js";
 import { campaignAbTestToolDefinitions } from "./campaign-ab-test.js";
+import { campaignHorizonFillToolDefinitions } from "./campaign-horizon-fill.js";
 import { campaignMessagePreparationToolDefinitions } from "./campaign-message-preparation.js";
 import { campaignProcessingToolDefinitions } from "./campaign-processing.js";
 import { campaignToolDefinitions } from "./campaigns.js";
@@ -42,6 +43,7 @@ import { workspaceToolDefinitions } from "./workspaces.js";
 export const allTools = [
     ...campaignToolDefinitions,
     ...campaignAbTestToolDefinitions,
+    ...campaignHorizonFillToolDefinitions,
     ...campaignMessagePreparationToolDefinitions,
     ...campaignProcessingToolDefinitions,
     ...authToolDefinitions,

package/package.json

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

package/skills/create-campaign/SKILL.md

@@ -46,6 +46,7 @@ allowed-tools:
   - mcp__sellable__select_campaign_cells
   - mcp__sellable__queue_campaign_cells
   - mcp__sellable__wait_for_campaign_processing
+  - mcp__sellable__fill_campaign_horizon
   - mcp__sellable__start_campaign_message_preparation
   - mcp__sellable__get_campaign_message_preparation_status
   - mcp__sellable__cancel_campaign_message_preparation
@@ -107,6 +108,13 @@ the template is approved.
 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