@sellable/mcp 0.1.507 → 0.1.509

package/dist/server.js

@@ -305,7 +305,10 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                 }
                 break;
             case "start_campaign":
-                result = await startCampaign(args?.campaignId);
+                result = await startCampaign({
+                    campaignId: args?.campaignId,
+                    workspaceId: args?.workspaceId,
+                });
                 if (args?.campaignId && result?.success) {
                     markCampaignContextDirty(args.campaignId, "start_campaign");
                 }

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

@@ -1,22 +1,15 @@
 type ApprovalMode = "mark_ready" | "approve";
 type RowSelector = {
-    type: "reviewBatch";
-    basisHash?: string;
-    limit?: number;
-} | {
-    type: "rowIds";
-    rowIds: string[];
-} | {
     type: "needsEnrichment";
     limit?: number;
 } | {
     type: "needsApproval";
     limit?: number;
 } | {
-    type: "passedRows";
+    type: "needsGeneratedMessage";
     limit?: number;
 } | {
-    type: "needsGeneratedMessage";
+    type: "reviewBatch";
     limit?: number;
 } | {
     type: "staleGeneratedMessages";
@@ -35,9 +28,13 @@ type StartPrepareMessagesInput = PrepareMessagesBaseInput & {
     batchSize?: number;
     maxBatchRows?: number;
     approvalMode?: ApprovalMode;
+    rowSelector?: RowSelector;
     autoContinue?: boolean;
     disableLowPassRateStop?: boolean;
-    rowSelector?: RowSelector;
+    requestHash?: string;
+    requestSource?: string;
+    senderId?: string;
+    actionType?: string;
 };
 type StatusPrepareMessagesInput = PrepareMessagesBaseInput;
 type CancelPrepareMessagesInput = PrepareMessagesBaseInput;
@@ -82,13 +79,6 @@ export declare const campaignMessagePreparationToolDefinitions: ({
                 enum: string[];
                 description: string;
             };
-            autoContinue: {
-                type: string;
-            };
-            disableLowPassRateStop: {
-                type: string;
-                description: string;
-            };
             rowSelector: {
                 type: string;
                 description: string;
@@ -97,15 +87,6 @@ export declare const campaignMessagePreparationToolDefinitions: ({
                         type: string;
                         enum: string[];
                     };
-                    basisHash: {
-                        type: string;
-                    };
-                    rowIds: {
-                        type: string;
-                        items: {
-                            type: string;
-                        };
-                    };
                     limit: {
                         type: string;
                         minimum: number;
@@ -115,6 +96,22 @@ export declare const campaignMessagePreparationToolDefinitions: ({
                 required: string[];
                 additionalProperties: boolean;
             };
+            autoContinue: {
+                type: string;
+            };
+            senderId: {
+                type: string;
+                description: string;
+            };
+            actionType: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            disableLowPassRateStop: {
+                type: string;
+                description: string;
+            };
             workspaceId: {
                 type: string;
                 description: string;
@@ -149,9 +146,11 @@ export declare const campaignMessagePreparationToolDefinitions: ({
             batchSize?: undefined;
             maxBatchRows?: undefined;
             approvalMode?: undefined;
+            rowSelector?: undefined;
             autoContinue?: undefined;
+            senderId?: undefined;
+            actionType?: undefined;
             disableLowPassRateStop?: undefined;
-            rowSelector?: undefined;
         };
         additionalProperties: boolean;
         required?: undefined;

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

@@ -43,34 +43,45 @@ 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.",
                 },
-                autoContinue: { type: "boolean" },
-                disableLowPassRateStop: {
-                    type: "boolean",
-                    description: "Operator override for explicit fill/exhaust requests. When true, keep processing eligible rows even if the enriched sample pass rate is low. Still bounded by targetPreparedMessages and maxRowsToCheck.",
-                },
                 rowSelector: {
                     type: "object",
-                    description: 'Optional row selector for scoped refill frontiers. Use {"type":"needsEnrichment","limit":N} to prepare the next unenriched/refill rows selected by get_refill_target_plan.',
+                    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: [
-                                "reviewBatch",
-                                "rowIds",
                                 "needsEnrichment",
                                 "needsApproval",
-                                "passedRows",
                                 "needsGeneratedMessage",
+                                "reviewBatch",
                                 "staleGeneratedMessages",
                             ],
                         },
-                        basisHash: { type: "string" },
-                        rowIds: { type: "array", items: { type: "string" } },
                         limit: { type: "number", minimum: 1, maximum: 500 },
                     },
                     required: ["type"],
                     additionalProperties: false,
                 },
+                autoContinue: { type: "boolean" },
+                senderId: {
+                    type: "string",
+                    description: "Optional refill-scope sender id. Used with actionType by refill_sends so preparation skips rows already attempted by other send actions.",
+                },
+                actionType: {
+                    type: "string",
+                    enum: [
+                        "send_invite",
+                        "send_dm",
+                        "send_inmail_open",
+                        "send_inmail_closed",
+                        "react_and_comment",
+                    ],
+                    description: "Optional refill-scope send action. InMail scopes treat open and paid InMail as one contact-reuse family.",
+                },
+                disableLowPassRateStop: {
+                    type: "boolean",
+                    description: "Operator override for explicit fill/exhaust requests. When true, keep processing eligible rows even if the enriched sample pass rate is low. Still bounded by targetPreparedMessages and maxRowsToCheck.",
+                },
                 workspaceId: {
                     type: "string",
                     description: "Explicit request-scoped workspace id for scheduled/yolo refill automation.",
@@ -120,9 +131,13 @@ export function startPrepareCampaignMessages(input) {
         batchSize: input.batchSize,
         maxBatchRows: input.maxBatchRows,
         approvalMode: input.approvalMode,
+        rowSelector: input.rowSelector,
         autoContinue: input.autoContinue,
         disableLowPassRateStop: input.disableLowPassRateStop,
-        rowSelector: input.rowSelector,
+        requestHash: input.requestHash,
+        requestSource: input.requestSource,
+        senderId: input.senderId,
+        actionType: input.actionType,
         ...(workspaceId ? { workspaceId } : {}),
     }, workspaceId ?? undefined);
 }

package/dist/tools/campaigns.d.ts

@@ -185,6 +185,7 @@ export declare const campaignToolDefinitions: ({
             useMessagingTemplate?: undefined;
             rubric?: undefined;
             flowVersion?: undefined;
+            workspaceId?: undefined;
         };
         required: string[];
         additionalProperties: boolean;
@@ -223,6 +224,7 @@ export declare const campaignToolDefinitions: ({
             useMessagingTemplate?: undefined;
             rubric?: undefined;
             flowVersion?: undefined;
+            workspaceId?: undefined;
         };
         required: never[];
         additionalProperties?: undefined;
@@ -261,6 +263,7 @@ export declare const campaignToolDefinitions: ({
             useMessagingTemplate?: undefined;
             rubric?: undefined;
             flowVersion?: undefined;
+            workspaceId?: undefined;
         };
         required: string[];
         additionalProperties?: undefined;
@@ -342,6 +345,7 @@ export declare const campaignToolDefinitions: ({
             useMessagingTemplate?: undefined;
             rubric?: undefined;
             flowVersion?: undefined;
+            workspaceId?: undefined;
         };
         required: string[];
         additionalProperties: boolean;
@@ -536,6 +540,7 @@ export declare const campaignToolDefinitions: ({
             useMessagingTemplate?: undefined;
             rubric?: undefined;
             flowVersion?: undefined;
+            workspaceId?: undefined;
         };
         required: never[];
         additionalProperties?: undefined;
@@ -741,6 +746,49 @@ export declare const campaignToolDefinitions: ({
             clientProspectId?: undefined;
             senderLinkedinUrl?: undefined;
             messageGenerationMode?: undefined;
+            workspaceId?: undefined;
+        };
+        required: string[];
+        additionalProperties?: undefined;
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            campaignId: {
+                type: string;
+                description: string;
+            };
+            workspaceId: {
+                type: string;
+                description: string;
+            };
+            limit?: undefined;
+            tableId?: undefined;
+            leadLimit?: undefined;
+            page?: undefined;
+            filters?: undefined;
+            name?: undefined;
+            clientProspectId?: undefined;
+            senderLinkedinUrl?: undefined;
+            offerPositioning?: undefined;
+            campaignBrief?: undefined;
+            messageGenerationMode?: undefined;
+            currentStep?: undefined;
+            watchNarration?: undefined;
+            leadSourceType?: undefined;
+            leadSourceProvider?: undefined;
+            selectedLeadListId?: undefined;
+            senderIds?: undefined;
+            currentStepTransition?: undefined;
+            clearCurrentStepIfMatches?: undefined;
+            interactionMode?: undefined;
+            enableICPFilters?: undefined;
+            useMessagingTemplate?: undefined;
+            rubric?: undefined;
+            flowVersion?: undefined;
         };
         required: string[];
         additionalProperties?: undefined;
@@ -782,6 +830,7 @@ export declare const campaignToolDefinitions: ({
             useMessagingTemplate?: undefined;
             rubric?: undefined;
             flowVersion?: undefined;
+            workspaceId?: undefined;
         };
         required: string[];
         additionalProperties?: undefined;
@@ -821,7 +870,11 @@ export interface UpdateCampaignResult {
     _campaign?: CampaignOfferNavigation;
 }
 export declare function updateCampaign(campaignId: string, input: UpdateCampaignInput): Promise<UpdateCampaignResult>;
-export declare function startCampaign(campaignId: string): Promise<{
+type StartCampaignInput = string | {
+    campaignId?: string | null;
+    workspaceId?: string | null;
+};
+export declare function startCampaign(input: StartCampaignInput): Promise<{
     success: boolean;
 }>;
 export declare function pauseCampaign(campaignId: string): Promise<{

package/dist/tools/campaigns.js

@@ -4,6 +4,7 @@ import { assertCreateCampaignPromptLoaded, assertNetNewCreateCampaignResearchRea
 import { setCampaignInteractionMode, } from "./interaction-mode.js";
 import { isLinkedInProfileInput, normalizeLinkedInProfileInput, } from "./linkedin-url.js";
 import { fetchCampaignRubrics } from "./processing.js";
+import { normalizeExplicitWorkspaceId, workspaceRequestOptions, } from "./workspace-context.js";
 const LEAD_SOURCE_PROVIDERS = {
     APOLLO: "apollo-ai",
     SALES_NAV: "sales-nav",
@@ -456,7 +457,7 @@ export const campaignToolDefinitions = [
     },
     {
         name: "start_campaign",
-        description: "Start a paused campaign, enabling the sweeper to send messages. This is an explicit human launch/start action and must not be used as part of fill-send-horizon, message preparation, or scheduling-proof flows.",
+        description: "Start a paused campaign, enabling the sweeper to send messages. This is an explicit human launch/start action. It is also allowed as the exact selected start_paused_campaign primitive from a bounded refill_sends target packet, using request-scoped workspaceId.",
         inputSchema: {
             type: "object",
             properties: {
@@ -464,6 +465,10 @@ export const campaignToolDefinitions = [
                     type: "string",
                     description: "Campaign ID to start",
                 },
+                workspaceId: {
+                    type: "string",
+                    description: "Explicit request-scoped workspace id for scheduled/yolo refill automation.",
+                },
             },
             required: ["campaignId"],
         },
@@ -1014,9 +1019,19 @@ export async function updateCampaign(campaignId, input) {
         _campaign: result,
     };
 }
-export async function startCampaign(campaignId) {
+export async function startCampaign(input) {
+    const campaignId = typeof input === "string" ? input : input.campaignId?.trim();
+    if (!campaignId) {
+        throw new Error("start_campaign requires campaignId");
+    }
+    const workspaceId = typeof input === "string"
+        ? null
+        : normalizeExplicitWorkspaceId(input.workspaceId);
+    const requestOptions = workspaceRequestOptions(workspaceId);
     const api = getApi();
-    return api.post(`/api/v3/campaigns/${campaignId}/start`);
+    return requestOptions
+        ? api.post(`/api/v3/campaigns/${campaignId}/start`, { workspaceId }, requestOptions)
+        : api.post(`/api/v3/campaigns/${campaignId}/start`);
 }
 export async function pauseCampaign(campaignId) {
     const api = getApi();

package/dist/tools/leads.d.ts

@@ -127,6 +127,7 @@ export type LookupSalesNavFilterInput = {
 };
 export type SignalSearchInput = {
     type?: "keywords" | "profile" | "post" | "company";
+    workspaceId?: string;
     keywords?: Array<{
         keyword: string;
         id?: string;
@@ -181,6 +182,8 @@ export type ConfirmLeadListInput = {
     reviewBatchLimit?: number;
     includeRawImportResult?: boolean;
     allowPartialSourceList?: boolean;
+    sourceRowIds?: string[];
+    sourceRowLimit?: number;
     /**
      * Deprecated alias for reviewBatchLimit. Confirming a lead list now copies the
      * confirmed source into the campaign table; this value no longer caps clone
@@ -190,6 +193,7 @@ export type ConfirmLeadListInput = {
 };
 export type SelectPromisingPostsInput = {
     campaignOfferId: string;
+    workspaceId?: string;
     selections: Array<{
         postId: string;
         reason: string;
@@ -295,6 +299,8 @@ export declare const leadToolDefinitions: ({
             keepInSync?: undefined;
             jobId?: undefined;
             reviewBatchLimit?: undefined;
+            sourceRowIds?: undefined;
+            sourceRowLimit?: undefined;
             allowPartialSourceList?: undefined;
             includeRawImportResult?: undefined;
             selections?: undefined;
@@ -489,6 +495,8 @@ export declare const leadToolDefinitions: ({
             keepInSync?: undefined;
             jobId?: undefined;
             reviewBatchLimit?: undefined;
+            sourceRowIds?: undefined;
+            sourceRowLimit?: undefined;
             allowPartialSourceList?: undefined;
             includeRawImportResult?: undefined;
             selections?: undefined;
@@ -582,6 +590,8 @@ export declare const leadToolDefinitions: ({
             keepInSync?: undefined;
             jobId?: undefined;
             reviewBatchLimit?: undefined;
+            sourceRowIds?: undefined;
+            sourceRowLimit?: undefined;
             allowPartialSourceList?: undefined;
             includeRawImportResult?: undefined;
             selections?: undefined;
@@ -747,6 +757,8 @@ export declare const leadToolDefinitions: ({
             keepInSync?: undefined;
             jobId?: undefined;
             reviewBatchLimit?: undefined;
+            sourceRowIds?: undefined;
+            sourceRowLimit?: undefined;
             allowPartialSourceList?: undefined;
             includeRawImportResult?: undefined;
             selections?: undefined;
@@ -854,6 +866,8 @@ export declare const leadToolDefinitions: ({
             keepInSync?: undefined;
             jobId?: undefined;
             reviewBatchLimit?: undefined;
+            sourceRowIds?: undefined;
+            sourceRowLimit?: undefined;
             allowPartialSourceList?: undefined;
             includeRawImportResult?: undefined;
             selections?: undefined;
@@ -970,6 +984,8 @@ export declare const leadToolDefinitions: ({
             keepInSync?: undefined;
             jobId?: undefined;
             reviewBatchLimit?: undefined;
+            sourceRowIds?: undefined;
+            sourceRowLimit?: undefined;
             allowPartialSourceList?: undefined;
             includeRawImportResult?: undefined;
             selections?: undefined;
@@ -1075,6 +1091,8 @@ export declare const leadToolDefinitions: ({
             keepInSync?: undefined;
             jobId?: undefined;
             reviewBatchLimit?: undefined;
+            sourceRowIds?: undefined;
+            sourceRowLimit?: undefined;
             allowPartialSourceList?: undefined;
             includeRawImportResult?: undefined;
             selections?: undefined;
@@ -1185,6 +1203,8 @@ export declare const leadToolDefinitions: ({
             keepInSync?: undefined;
             jobId?: undefined;
             reviewBatchLimit?: undefined;
+            sourceRowIds?: undefined;
+            sourceRowLimit?: undefined;
             allowPartialSourceList?: undefined;
             includeRawImportResult?: undefined;
             selections?: undefined;
@@ -1283,6 +1303,8 @@ export declare const leadToolDefinitions: ({
             keepInSync?: undefined;
             jobId?: undefined;
             reviewBatchLimit?: undefined;
+            sourceRowIds?: undefined;
+            sourceRowLimit?: undefined;
             allowPartialSourceList?: undefined;
             includeRawImportResult?: undefined;
             selections?: undefined;
@@ -2173,6 +2195,8 @@ export declare const leadToolDefinitions: ({
             keepInSync?: undefined;
             jobId?: undefined;
             reviewBatchLimit?: undefined;
+            sourceRowIds?: undefined;
+            sourceRowLimit?: undefined;
             allowPartialSourceList?: undefined;
             includeRawImportResult?: undefined;
             selections?: undefined;
@@ -2280,6 +2304,8 @@ export declare const leadToolDefinitions: ({
             keepInSync?: undefined;
             jobId?: undefined;
             reviewBatchLimit?: undefined;
+            sourceRowIds?: undefined;
+            sourceRowLimit?: undefined;
             allowPartialSourceList?: undefined;
             includeRawImportResult?: undefined;
             selections?: undefined;
@@ -3325,6 +3351,8 @@ export declare const leadToolDefinitions: ({
             keepInSync?: undefined;
             jobId?: undefined;
             reviewBatchLimit?: undefined;
+            sourceRowIds?: undefined;
+            sourceRowLimit?: undefined;
             allowPartialSourceList?: undefined;
             includeRawImportResult?: undefined;
             selections?: undefined;
@@ -3479,6 +3507,8 @@ export declare const leadToolDefinitions: ({
             keepInSync?: undefined;
             jobId?: undefined;
             reviewBatchLimit?: undefined;
+            sourceRowIds?: undefined;
+            sourceRowLimit?: undefined;
             allowPartialSourceList?: undefined;
             includeRawImportResult?: undefined;
             selections?: undefined;
@@ -3620,6 +3650,8 @@ export declare const leadToolDefinitions: ({
             keepInSync?: undefined;
             jobId?: undefined;
             reviewBatchLimit?: undefined;
+            sourceRowIds?: undefined;
+            sourceRowLimit?: undefined;
             allowPartialSourceList?: undefined;
             includeRawImportResult?: undefined;
             selections?: undefined;
@@ -3716,6 +3748,8 @@ export declare const leadToolDefinitions: ({
             keepInSync?: undefined;
             jobId?: undefined;
             reviewBatchLimit?: undefined;
+            sourceRowIds?: undefined;
+            sourceRowLimit?: undefined;
             allowPartialSourceList?: undefined;
             includeRawImportResult?: undefined;
             selections?: undefined;
@@ -3762,6 +3796,17 @@ export declare const leadToolDefinitions: ({
                 type: string;
                 description: string;
             };
+            sourceRowIds: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+            sourceRowLimit: {
+                type: string;
+                description: string;
+            };
             allowPartialSourceList: {
                 type: string;
                 description: string;
@@ -3971,6 +4016,8 @@ export declare const leadToolDefinitions: ({
             keepInSync?: undefined;
             jobId?: undefined;
             reviewBatchLimit?: undefined;
+            sourceRowIds?: undefined;
+            sourceRowLimit?: undefined;
             allowPartialSourceList?: undefined;
             includeRawImportResult?: undefined;
         };
@@ -4068,6 +4115,8 @@ export declare const leadToolDefinitions: ({
             keepInSync?: undefined;
             jobId?: undefined;
             reviewBatchLimit?: undefined;
+            sourceRowIds?: undefined;
+            sourceRowLimit?: undefined;
             allowPartialSourceList?: undefined;
             includeRawImportResult?: undefined;
             selections?: undefined;