@sellable/mcp 0.1.504 → 0.1.506

package/dist/api.d.ts

@@ -23,12 +23,12 @@ export declare class SellableApi {
     private requestResponse;
     private request;
     get<T>(path: string, options?: ApiRequestOptions): Promise<T>;
-    getText(path: string): Promise<string>;
-    downloadToFile(requestPath: string, destinationPath: string): Promise<DownloadToFileResult>;
+    getText(path: string, options?: ApiRequestOptions): Promise<string>;
+    downloadToFile(requestPath: string, destinationPath: string, options?: ApiRequestOptions): Promise<DownloadToFileResult>;
     post<T>(path: string, body?: object, options?: ApiRequestOptions): Promise<T>;
-    put<T>(path: string, body?: object): Promise<T>;
-    patch<T>(path: string, body?: object): Promise<T>;
-    delete<T>(path: string): Promise<T>;
+    put<T>(path: string, body?: object, options?: ApiRequestOptions): Promise<T>;
+    patch<T>(path: string, body?: object, options?: ApiRequestOptions): Promise<T>;
+    delete<T>(path: string, options?: ApiRequestOptions): Promise<T>;
 }
 export declare function getApi(): SellableApi;
 export declare function resetApi(): void;

package/dist/api.js

@@ -64,12 +64,12 @@ export class SellableApi {
     async get(path, options) {
         return this.request("GET", path, undefined, options);
     }
-    async getText(path) {
-        const response = await this.requestResponse("GET", path);
+    async getText(path, options) {
+        const response = await this.requestResponse("GET", path, undefined, options);
         return response.text();
     }
-    async downloadToFile(requestPath, destinationPath) {
-        const response = await this.requestResponse("GET", requestPath);
+    async downloadToFile(requestPath, destinationPath, options) {
+        const response = await this.requestResponse("GET", requestPath, undefined, options);
         if (!response.body) {
             throw new SellableApiError(response.status, "Response body was empty for file download");
         }
@@ -98,14 +98,14 @@ export class SellableApi {
     async post(path, body, options) {
         return this.request("POST", path, body, options);
     }
-    async put(path, body) {
-        return this.request("PUT", path, body);
+    async put(path, body, options) {
+        return this.request("PUT", path, body, options);
     }
-    async patch(path, body) {
-        return this.request("PATCH", path, body);
+    async patch(path, body, options) {
+        return this.request("PATCH", path, body, options);
     }
-    async delete(path) {
-        return this.request("DELETE", path);
+    async delete(path, options) {
+        return this.request("DELETE", path, undefined, options);
     }
 }
 let apiInstance = null;

package/dist/server.js

@@ -511,7 +511,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                 result = await getEngagedPosts(args);
                 break;
             case "get_sender_routing":
-                result = await getSenderRoutingTool();
+                result = await getSenderRoutingTool(args);
                 break;
             case "set_sender_routing":
                 result = await setSenderRoutingTool(args);
@@ -523,7 +523,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                 result = await setCompanyInfoTool(args);
                 break;
             case "list_senders":
-                result = await listSenders();
+                result = await listSenders(args);
                 break;
             case "get_sender":
                 result = await getSender(args);

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

@@ -4,6 +4,7 @@ type ResolveCampaignFillRouteInput = {
     campaignId?: string;
     tableId?: string;
     limit?: number;
+    workspaceId?: string;
 };
 export declare const campaignFillRoutingToolDefinitions: {
     name: string;
@@ -30,6 +31,10 @@ export declare const campaignFillRoutingToolDefinitions: {
                 maximum: number;
                 description: string;
             };
+            workspaceId: {
+                type: string;
+                description: string;
+            };
         };
         required: string[];
         additionalProperties: boolean;

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

@@ -1,7 +1,11 @@
 import { getApi } from "../api.js";
-async function postCampaignFillRoute(body) {
+import { normalizeExplicitWorkspaceId, workspaceRequestOptions, } from "./workspace-context.js";
+async function postCampaignFillRoute(body, workspaceId) {
     const api = getApi();
-    return api.post("/api/v3/mcp/campaign-fill-routing", body);
+    const requestOptions = workspaceRequestOptions(workspaceId);
+    return requestOptions
+        ? api.post("/api/v3/mcp/campaign-fill-routing", body, requestOptions)
+        : api.post("/api/v3/mcp/campaign-fill-routing", body);
 }
 export const campaignFillRoutingToolDefinitions = [
     {
@@ -29,6 +33,10 @@ export const campaignFillRoutingToolDefinitions = [
                     maximum: 100,
                     description: "Maximum returned targets/skippedTargets.",
                 },
+                workspaceId: {
+                    type: "string",
+                    description: "Explicit request-scoped workspace id for scheduled/yolo refill automation. Pass this instead of switching the shared active workspace.",
+                },
             },
             required: ["intent"],
             additionalProperties: false,
@@ -36,10 +44,12 @@ export const campaignFillRoutingToolDefinitions = [
     },
 ];
 export function resolveCampaignFillRoute(input) {
+    const workspaceId = normalizeExplicitWorkspaceId(input.workspaceId);
     return postCampaignFillRoute({
         intent: input.intent,
         campaignId: input.campaignId,
         tableId: input.tableId,
         limit: input.limit,
-    });
+        ...(workspaceId ? { workspaceId } : {}),
+    }, workspaceId ?? undefined);
 }

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

@@ -1,15 +1,22 @@
 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: "needsGeneratedMessage";
+    type: "passedRows";
     limit?: number;
 } | {
-    type: "reviewBatch";
+    type: "needsGeneratedMessage";
     limit?: number;
 } | {
     type: "staleGeneratedMessages";
@@ -19,6 +26,7 @@ type PrepareMessagesBaseInput = {
     campaignId?: string;
     tableId?: string;
     jobId?: string;
+    workspaceId?: string;
 };
 type StartPrepareMessagesInput = PrepareMessagesBaseInput & {
     campaignId: string;
@@ -27,13 +35,9 @@ type StartPrepareMessagesInput = PrepareMessagesBaseInput & {
     batchSize?: number;
     maxBatchRows?: number;
     approvalMode?: ApprovalMode;
-    rowSelector?: RowSelector;
     autoContinue?: boolean;
     disableLowPassRateStop?: boolean;
-    requestHash?: string;
-    requestSource?: string;
-    senderId?: string;
-    actionType?: string;
+    rowSelector?: RowSelector;
 };
 type StatusPrepareMessagesInput = PrepareMessagesBaseInput;
 type CancelPrepareMessagesInput = PrepareMessagesBaseInput;
@@ -78,6 +82,13 @@ export declare const campaignMessagePreparationToolDefinitions: ({
                 enum: string[];
                 description: string;
             };
+            autoContinue: {
+                type: string;
+            };
+            disableLowPassRateStop: {
+                type: string;
+                description: string;
+            };
             rowSelector: {
                 type: string;
                 description: string;
@@ -86,6 +97,15 @@ export declare const campaignMessagePreparationToolDefinitions: ({
                         type: string;
                         enum: string[];
                     };
+                    basisHash: {
+                        type: string;
+                    };
+                    rowIds: {
+                        type: string;
+                        items: {
+                            type: string;
+                        };
+                    };
                     limit: {
                         type: string;
                         minimum: number;
@@ -95,19 +115,7 @@ export declare const campaignMessagePreparationToolDefinitions: ({
                 required: string[];
                 additionalProperties: boolean;
             };
-            autoContinue: {
-                type: string;
-            };
-            senderId: {
-                type: string;
-                description: string;
-            };
-            actionType: {
-                type: string;
-                enum: string[];
-                description: string;
-            };
-            disableLowPassRateStop: {
+            workspaceId: {
                 type: string;
                 description: string;
             };
@@ -132,16 +140,18 @@ export declare const campaignMessagePreparationToolDefinitions: ({
             tableId: {
                 type: string;
             };
+            workspaceId: {
+                type: string;
+                description?: undefined;
+            };
             targetPreparedMessages?: undefined;
             maxRowsToCheck?: undefined;
             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

@@ -1,7 +1,11 @@
 import { getApi } from "../api.js";
-async function postPrepareMessages(body) {
+import { normalizeExplicitWorkspaceId, workspaceRequestOptions, } from "./workspace-context.js";
+async function postPrepareMessages(body, workspaceId) {
     const api = getApi();
-    return api.post("/api/v3/mcp/campaign-message-preparation", body);
+    const requestOptions = workspaceRequestOptions(workspaceId);
+    return requestOptions
+        ? api.post("/api/v3/mcp/campaign-message-preparation", body, requestOptions)
+        : api.post("/api/v3/mcp/campaign-message-preparation", body);
 }
 export const campaignMessagePreparationToolDefinitions = [
     {
@@ -39,44 +43,37 @@ 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 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.',
+                    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.',
                     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: {
+                workspaceId: {
                     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.",
+                    description: "Explicit request-scoped workspace id for scheduled/yolo refill automation.",
                 },
             },
             required: ["campaignId"],
@@ -92,6 +89,7 @@ export const campaignMessagePreparationToolDefinitions = [
                 jobId: { type: "string" },
                 campaignId: { type: "string" },
                 tableId: { type: "string" },
+                workspaceId: { type: "string" },
             },
             additionalProperties: false,
         },
@@ -105,12 +103,14 @@ export const campaignMessagePreparationToolDefinitions = [
                 jobId: { type: "string" },
                 campaignId: { type: "string" },
                 tableId: { type: "string" },
+                workspaceId: { type: "string" },
             },
             additionalProperties: false,
         },
     },
 ];
 export function startPrepareCampaignMessages(input) {
+    const workspaceId = normalizeExplicitWorkspaceId(input.workspaceId);
     return postPrepareMessages({
         action: "start",
         campaignId: input.campaignId,
@@ -120,28 +120,29 @@ 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,
-        requestSource: input.requestSource,
-        senderId: input.senderId,
-        actionType: input.actionType,
-    });
+        rowSelector: input.rowSelector,
+        ...(workspaceId ? { workspaceId } : {}),
+    }, workspaceId ?? undefined);
 }
 export function getPrepareCampaignMessagesStatus(input) {
+    const workspaceId = normalizeExplicitWorkspaceId(input.workspaceId);
     return postPrepareMessages({
         action: "status",
         jobId: input.jobId,
         campaignId: input.campaignId,
         tableId: input.tableId,
-    });
+        ...(workspaceId ? { workspaceId } : {}),
+    }, workspaceId ?? undefined);
 }
 export function cancelPrepareCampaignMessages(input) {
+    const workspaceId = normalizeExplicitWorkspaceId(input.workspaceId);
     return postPrepareMessages({
         action: "cancel",
         jobId: input.jobId,
         campaignId: input.campaignId,
         tableId: input.tableId,
-    });
+        ...(workspaceId ? { workspaceId } : {}),
+    }, workspaceId ?? undefined);
 }

package/dist/tools/campaign-processing.d.ts

@@ -24,6 +24,7 @@ type RowSelector = {
 type SchemaInput = {
     campaignId?: string;
     tableId?: string;
+    workspaceId?: string;
 };
 type SelectInput = SchemaInput & {
     columnRole: ColumnRole;
@@ -100,6 +101,9 @@ export declare const campaignProcessingToolDefinitions: ({
             tableId: {
                 type: string;
             };
+            workspaceId: {
+                type: string;
+            };
             columnRole?: undefined;
             rowSelector?: undefined;
             limit?: undefined;
@@ -130,6 +134,9 @@ export declare const campaignProcessingToolDefinitions: ({
             tableId: {
                 type: string;
             };
+            workspaceId: {
+                type: string;
+            };
             columnRole: {
                 type: string;
                 enum: string[];
@@ -187,6 +194,9 @@ export declare const campaignProcessingToolDefinitions: ({
             tableId: {
                 type: string;
             };
+            workspaceId: {
+                type: string;
+            };
             columnRole: {
                 type: string;
                 enum: string[];
@@ -248,6 +258,9 @@ export declare const campaignProcessingToolDefinitions: ({
             tableId: {
                 type: string;
             };
+            workspaceId: {
+                type: string;
+            };
             minPassedCount: {
                 type: string;
             };
@@ -286,6 +299,9 @@ export declare const campaignProcessingToolDefinitions: ({
             tableId: {
                 type: string;
             };
+            workspaceId: {
+                type: string;
+            };
             rowIds: {
                 type: string;
                 items: {
@@ -327,6 +343,9 @@ export declare const campaignProcessingToolDefinitions: ({
             tableId: {
                 type: string;
             };
+            workspaceId: {
+                type: string;
+            };
             templateMarkdown: {
                 type: string;
             };

package/dist/tools/campaign-processing.js

@@ -1,5 +1,6 @@
 import { getApi } from "../api.js";
 import { resolveWaitTimeout } from "./readiness.js";
+import { normalizeExplicitWorkspaceId, workspaceRequestOptions, } from "./workspace-context.js";
 const DEFAULT_TIMEOUT_MS = 90000;
 const DEFAULT_INTERVAL_MS = 2000;
 function sleep(ms) {
@@ -14,16 +15,21 @@ function stableHash(value) {
     }
     return (hash >>> 0).toString(16).padStart(8, "0");
 }
-async function postCampaignProcessing(body) {
+async function postCampaignProcessing(body, workspaceId) {
     const api = getApi();
-    return api.post("/api/v3/mcp/campaign-processing", body);
+    const requestOptions = workspaceRequestOptions(workspaceId);
+    return requestOptions
+        ? api.post("/api/v3/mcp/campaign-processing", body, requestOptions)
+        : api.post("/api/v3/mcp/campaign-processing", body);
 }
 async function resolveSchema(input) {
+    const workspaceId = normalizeExplicitWorkspaceId(input.workspaceId);
     return postCampaignProcessing({
         action: "schema",
         campaignId: input.campaignId,
         tableId: input.tableId,
-    });
+        ...(workspaceId ? { workspaceId } : {}),
+    }, workspaceId ?? undefined);
 }
 export const campaignProcessingToolDefinitions = [
     {
@@ -34,6 +40,7 @@ export const campaignProcessingToolDefinitions = [
             properties: {
                 campaignId: { type: "string" },
                 tableId: { type: "string" },
+                workspaceId: { type: "string" },
             },
             additionalProperties: false,
         },
@@ -46,6 +53,7 @@ export const campaignProcessingToolDefinitions = [
             properties: {
                 campaignId: { type: "string" },
                 tableId: { type: "string" },
+                workspaceId: { type: "string" },
                 columnRole: {
                     type: "string",
                     enum: [
@@ -92,6 +100,7 @@ export const campaignProcessingToolDefinitions = [
             properties: {
                 campaignId: { type: "string" },
                 tableId: { type: "string" },
+                workspaceId: { type: "string" },
                 columnRole: {
                     type: "string",
                     enum: ["enrich", "generateMessage", "approved"],
@@ -134,6 +143,7 @@ export const campaignProcessingToolDefinitions = [
             properties: {
                 campaignId: { type: "string" },
                 tableId: { type: "string" },
+                workspaceId: { type: "string" },
                 minPassedCount: { type: "number" },
                 minGeneratedMessages: { type: "number" },
                 templateRevision: {
@@ -153,6 +163,7 @@ export const campaignProcessingToolDefinitions = [
             type: "object",
             properties: {
                 tableId: { type: "string" },
+                workspaceId: { type: "string" },
                 rowIds: { type: "array", items: { type: "string" } },
                 enrichCellIds: { type: "array", items: { type: "string" } },
             },
@@ -168,6 +179,7 @@ export const campaignProcessingToolDefinitions = [
             properties: {
                 campaignId: { type: "string" },
                 tableId: { type: "string" },
+                workspaceId: { type: "string" },
                 templateMarkdown: { type: "string" },
                 approvedMessageTemplate: { type: "string" },
                 rowSelector: {
@@ -199,28 +211,36 @@ export async function getCampaignTableSchema(input) {
     return resolveSchema(input);
 }
 export async function selectCampaignCells(input) {
+    const workspaceId = normalizeExplicitWorkspaceId(input.workspaceId);
     return postCampaignProcessing({
         action: "select",
         ...input,
-    });
+        ...(workspaceId ? { workspaceId } : {}),
+    }, workspaceId ?? undefined);
 }
 export async function queueCampaignCells(input) {
+    const workspaceId = normalizeExplicitWorkspaceId(input.workspaceId);
     return postCampaignProcessing({
         action: "queue",
         ...input,
-    });
+        ...(workspaceId ? { workspaceId } : {}),
+    }, workspaceId ?? undefined);
 }
 export async function recordCampaignReviewBatch(input) {
+    const workspaceId = normalizeExplicitWorkspaceId(input.workspaceId);
     return postCampaignProcessing({
         action: "recordReviewBatch",
         ...input,
-    });
+        ...(workspaceId ? { workspaceId } : {}),
+    }, workspaceId ?? undefined);
 }
 export async function reviseMessageTemplateAndRerun(input) {
+    const workspaceId = normalizeExplicitWorkspaceId(input.workspaceId);
     const result = await postCampaignProcessing({
         action: "reviseTemplateAndRerun",
         ...input,
-    });
+        ...(workspaceId ? { workspaceId } : {}),
+    }, workspaceId ?? undefined);
     const approvalsReset = typeof result.approvalsReset === "number" ? result.approvalsReset : 0;
     if (approvalsReset <= 0)
         return result;
@@ -328,6 +348,7 @@ function buildProcessingTimeoutRecovery({ input, schema, stats, minPassedCount,
 }
 export async function waitForCampaignProcessing(input) {
     const api = getApi();
+    const requestOptions = workspaceRequestOptions(input.workspaceId);
     const schema = await resolveSchema(input);
     const { effectiveTimeoutMs, guardApplied, requestedTimeoutMs } = resolveWaitTimeout(input.timeoutMs ?? DEFAULT_TIMEOUT_MS);
     const intervalMs = Math.max(500, input.intervalMs ?? DEFAULT_INTERVAL_MS);
@@ -352,7 +373,9 @@ export async function waitForCampaignProcessing(input) {
     let lastStats = null;
     while (Date.now() - start <= effectiveTimeoutMs) {
         attempts += 1;
-        const stats = await api.get(`/api/v3/workflow-tables/${schema.tableId}/stats`);
+        const stats = requestOptions
+            ? await api.get(`/api/v3/workflow-tables/${schema.tableId}/stats`, requestOptions)
+            : await api.get(`/api/v3/workflow-tables/${schema.tableId}/stats`);
         lastStats = stats;
         const currentRevisionHash = stats.currentTemplateRevisionHash ?? null;
         if (templateRevision &&

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

@@ -1,6 +1,7 @@
 type GetCampaignRefillStateInput = {
     campaignId?: string;
     tableId?: string;
+    workspaceId?: string;
 };
 export declare const campaignRefillStateToolDefinitions: {
     name: string;
@@ -16,6 +17,10 @@ export declare const campaignRefillStateToolDefinitions: {
                 type: string;
                 description: string;
             };
+            workspaceId: {
+                type: string;
+                description: string;
+            };
         };
         required: never[];
         additionalProperties: boolean;

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

@@ -1,7 +1,11 @@
 import { getApi } from "../api.js";
-async function postCampaignRefillState(body) {
+import { normalizeExplicitWorkspaceId, workspaceRequestOptions, } from "./workspace-context.js";
+async function postCampaignRefillState(body, workspaceId) {
     const api = getApi();
-    return api.post("/api/v3/mcp/campaign-refill-state", body);
+    const requestOptions = workspaceRequestOptions(workspaceId);
+    return requestOptions
+        ? api.post("/api/v3/mcp/campaign-refill-state", body, requestOptions)
+        : api.post("/api/v3/mcp/campaign-refill-state", body);
 }
 export const campaignRefillStateToolDefinitions = [
     {
@@ -18,6 +22,10 @@ export const campaignRefillStateToolDefinitions = [
                     type: "string",
                     description: "Optional exact WorkflowTable.id from resolve_campaign_fill_route. Do not pass table names.",
                 },
+                workspaceId: {
+                    type: "string",
+                    description: "Explicit request-scoped workspace id for scheduled/yolo refill automation. Pass this instead of switching the shared active workspace.",
+                },
             },
             required: [],
             additionalProperties: false,
@@ -25,8 +33,10 @@ export const campaignRefillStateToolDefinitions = [
     },
 ];
 export function getCampaignRefillState(input) {
+    const workspaceId = normalizeExplicitWorkspaceId(input.workspaceId);
     return postCampaignRefillState({
         campaignId: input.campaignId,
         tableId: input.tableId,
-    });
+        ...(workspaceId ? { workspaceId } : {}),
+    }, workspaceId ?? undefined);
 }