@sellable/mcp 0.1.501 → 0.1.502

package/dist/tools/campaign-message-preparation.d.ts

@@ -1,4 +1,20 @@
 type ApprovalMode = "mark_ready" | "approve";
+type RowSelector = {
+    type: "needsEnrichment";
+    limit?: number;
+} | {
+    type: "needsApproval";
+    limit?: number;
+} | {
+    type: "needsGeneratedMessage";
+    limit?: number;
+} | {
+    type: "reviewBatch";
+    limit?: number;
+} | {
+    type: "staleGeneratedMessages";
+    limit?: number;
+};
 type PrepareMessagesBaseInput = {
     campaignId?: string;
     tableId?: string;
@@ -11,6 +27,7 @@ type StartPrepareMessagesInput = PrepareMessagesBaseInput & {
     batchSize?: number;
     maxBatchRows?: number;
     approvalMode?: ApprovalMode;
+    rowSelector?: RowSelector;
     autoContinue?: boolean;
     disableLowPassRateStop?: boolean;
     requestHash?: string;
@@ -61,6 +78,23 @@ export declare const campaignMessagePreparationToolDefinitions: ({
                 enum: string[];
                 description: string;
             };
+            rowSelector: {
+                type: string;
+                description: string;
+                properties: {
+                    type: {
+                        type: string;
+                        enum: string[];
+                    };
+                    limit: {
+                        type: string;
+                        minimum: number;
+                        maximum: number;
+                    };
+                };
+                required: string[];
+                additionalProperties: boolean;
+            };
             autoContinue: {
                 type: string;
             };
@@ -103,6 +137,7 @@ export declare const campaignMessagePreparationToolDefinitions: ({
             batchSize?: undefined;
             maxBatchRows?: undefined;
             approvalMode?: undefined;
+            rowSelector?: undefined;
             autoContinue?: undefined;
             senderId?: undefined;
             actionType?: undefined;

package/dist/tools/campaign-message-preparation.js

@@ -39,6 +39,25 @@ export const campaignMessagePreparationToolDefinitions = [
                     enum: ["mark_ready", "approve"],
                     description: "Defaults to mark_ready. Use approve only when the user explicitly asks to flip Approved cells. Approval is not scheduling; it only makes the bounded cohort eligible for downstream scheduler ownership.",
                 },
+                rowSelector: {
+                    type: "object",
+                    description: 'Optional semantic row selector for refill frontiers. For regular refill preparation, use {type:"needsEnrichment"} so the backend starts at the actual unenriched table frontier instead of a generic prefix scan.',
+                    properties: {
+                        type: {
+                            type: "string",
+                            enum: [
+                                "needsEnrichment",
+                                "needsApproval",
+                                "needsGeneratedMessage",
+                                "reviewBatch",
+                                "staleGeneratedMessages",
+                            ],
+                        },
+                        limit: { type: "number", minimum: 1, maximum: 500 },
+                    },
+                    required: ["type"],
+                    additionalProperties: false,
+                },
                 autoContinue: { type: "boolean" },
                 senderId: {
                     type: "string",
@@ -101,6 +120,7 @@ export function startPrepareCampaignMessages(input) {
         batchSize: input.batchSize,
         maxBatchRows: input.maxBatchRows,
         approvalMode: input.approvalMode,
+        rowSelector: input.rowSelector,
         autoContinue: input.autoContinue,
         disableLowPassRateStop: input.disableLowPassRateStop,
         requestHash: input.requestHash,

package/dist/tools/refill-sends.js

@@ -336,6 +336,22 @@ function stringArray(value) {
         return [];
     return value.filter((item) => typeof item === "string");
 }
+function prepareRowSelectorValue(value) {
+    const selector = recordValue(value);
+    const type = stringValue(selector?.type);
+    if (type !== "needsEnrichment" &&
+        type !== "needsApproval" &&
+        type !== "needsGeneratedMessage" &&
+        type !== "reviewBatch" &&
+        type !== "staleGeneratedMessages") {
+        return undefined;
+    }
+    const limit = numberValue(selector?.limit);
+    return {
+        type,
+        ...(limit && limit > 0 ? { limit: Math.floor(limit) } : {}),
+    };
+}
 function uniqueStrings(values) {
     const seen = new Set();
     const result = [];
@@ -526,6 +542,9 @@ function refillPrepareRequestHash(params) {
         actionSourceLeadListId(params.action) ?? "no-source-list",
         actionActionType(params.action) ?? "no-action-type",
         params.approvalMode,
+        params.rowSelector
+            ? `${params.rowSelector.type}:${params.rowSelector.limit ?? "no-limit"}`
+            : "no-row-selector",
     ].join(":");
 }
 function boundedApprovalLimit(action) {
@@ -741,6 +760,7 @@ async function executeOneYoloPrimitive(action) {
             const tableId = actionTableId(action) ?? undefined;
             const toolInput = actionToolInput(action);
             const targetPreparedMessages = numberValue(toolInput.targetPreparedMessages);
+            const rowSelector = prepareRowSelectorValue(toolInput.rowSelector);
             const approvalMode = toolInput.approvalMode === "approve" ? "approve" : "mark_ready";
             if (!campaignId ||
                 !targetPreparedMessages ||
@@ -756,6 +776,7 @@ async function executeOneYoloPrimitive(action) {
                 targetPreparedMessages,
                 maxRowsToCheck: numberValue(toolInput.maxRowsToCheck) ?? 300,
                 approvalMode,
+                rowSelector,
                 autoContinue: true,
                 disableLowPassRateStop: true,
                 senderId: actionSenderId(action) ?? undefined,
@@ -765,6 +786,7 @@ async function executeOneYoloPrimitive(action) {
                     campaignId,
                     tableId,
                     approvalMode,
+                    rowSelector,
                 }),
                 requestSource: "refill_sends",
             });

package/dist/tools/registry.d.ts

@@ -601,6 +601,7 @@ export declare const allTools: ({
             batchSize?: undefined;
             maxBatchRows?: undefined;
             approvalMode?: undefined;
+            rowSelector?: undefined;
             autoContinue?: undefined;
             senderId?: undefined;
             actionType?: undefined;

package/package.json

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