@sellable/mcp 0.1.804 → 0.1.805

package/dist/agent-tool-names.d.ts

@@ -10,7 +10,7 @@ export declare const SELLABLE_MCP_TOOL_NAMES: readonly ["add_column", "add_on_de
  * `compileAgentToolPolicy`, so editing it cannot move the fleet-pinned
  * `policyHash`.
  */
-export declare const MUTATING_TOOL_NAMES: readonly ["pause_campaign", "archive_campaign", "update_campaign", "fill_campaign_horizon", "set_campaign_waterfall_order", "set_sender_routing", "send_inbox_draft", "send_inbox_manual_reply", "load_csv_dnc_entries", "update_cell", "queue_cells", "refill_v3_fill_ready", "refill_v3_edit_selected_campaign", "refill_v3_advance", "refill_v3_continue"];
+export declare const MUTATING_TOOL_NAMES: readonly ["pause_campaign", "archive_campaign", "update_campaign", "fill_campaign_horizon", "set_campaign_waterfall_order", "set_sender_routing", "send_inbox_draft", "send_inbox_manual_reply", "load_csv_dnc_entries", "update_cell", "queue_cells", "check_rubric", "queue_campaign_cells", "start_campaign_message_preparation", "refill_v3_fill_ready", "refill_v3_edit_selected_campaign", "refill_v3_advance", "refill_v3_continue"];
 export declare function isMutatingTool(name: string): boolean;
 export declare const CROSS_WORKSPACE_EXPLICIT_WORKSPACE_REQUIRED: {
     readonly code: "cross_workspace_explicit_workspace_required";

package/dist/agent-tool-names.js

@@ -207,6 +207,11 @@ export const MUTATING_TOOL_NAMES = [
     "load_csv_dnc_entries",
     "update_cell",
     "queue_cells",
+    // Campaign-maintenance compatibility mutations share the semantic campaign
+    // processing owner, but still require an explicit cross-workspace target.
+    "check_rubric",
+    "queue_campaign_cells",
+    "start_campaign_message_preparation",
     // Phase 146.5 Plan 08: the bounded Refill V3 mutation. Its sibling
     // `refill_v3_world_state` is an OBSERVATION and deliberately stays out.
     "refill_v3_fill_ready",

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

@@ -44,7 +44,7 @@ function sanitizePreparationResponse(value) {
 export const campaignMessagePreparationToolDefinitions = [
     {
         name: "start_campaign_message_preparation",
-        description: 'Start a bounded message-preparation job for a specific existing CampaignOffer campaignId/tableId. This is the active_campaigns existing-row path after resolve_campaign_fill_route, exact target re-read, and active prep-job check; it is not campaign creation and not evergreen horizon fill. It never launches the campaign, sends messages, or directly writes scheduledFor. The job processes rows top-down by WorkflowTableRow.position, queues pending Enrich Prospect cells first, lets ICP/rubric and Generate Message cascade, then marks ready or approves only the bounded cohort. Use this or rowSelector:{type:"needsEnrichment"} for regular refill frontiers; needsGeneratedMessage is only for already-passed generated-message repair and can skip earlier unenriched rows. Prepared/approved/ready rows are intermediate only; scheduled completion requires a later re-read proving scheduler-owned scheduled cells with non-null scheduledFor. Surface active preparation jobs, exhausted source rows, disconnected Sales Nav/deleted sender accounts, missing sequence state, and other sender-health blockers separately from prepared/approved/scheduled counts. Omit maxRowsToCheck and batchSize for the adaptive default: calibrate on at least 100 actually-enriched rows, estimate the row budget from observed rubric/pass yield, cap rows at 300, and process at most 100 newly checked rows at a time. The worker will not pull another row batch while the current checked batch still has queueable or active cells. Do not interpret checkedRows as enriched rows; use progress.enrichedRows, needsEnrichRows, activeCellCount, preparedMessages, approvedMessages, and stopReason.',
+        description: "Start a bounded message-preparation job for a specific existing CampaignOffer campaignId/tableId. This is a shared execution primitive used by campaign setup and the fenced Refill V3 coordinator; for fill/refill-sends intent, call refill_v3_advance instead of manually reconstructing the loop. Compatibility/recovery callers may use it only after resolve_campaign_fill_route, an exact target re-read, and an active prep-job check. It is not campaign creation or evergreen horizon fill, and it never launches the campaign, sends messages, directly writes scheduledFor, or rewrites scheduled/attempted outreach. The job processes eligible rows top-down by WorkflowTableRow.position, queues pending Enrich Prospect cells first, lets ICP/rubric and Generate Message cascade, then marks ready or approves only the bounded cohort. needsGeneratedMessage is only for already-passed generated-message repair and can skip earlier unenriched rows. Prepared/approved/ready rows are intermediate only; scheduled completion requires a later re-read proving scheduler-owned scheduled cells with non-null scheduledFor. Surface active preparation jobs, exhausted source rows, disconnected Sales Nav/deleted sender accounts, missing sequence state, and other sender-health blockers separately from prepared/approved/scheduled counts. Omit maxRowsToCheck and batchSize for the adaptive default: calibrate on at least 100 actually-enriched rows, estimate the row budget from observed rubric/pass yield, cap rows at 300, and process at most 100 newly checked rows at a time. The worker will not pull another row batch while the current checked batch still has queueable or active cells. Do not interpret checkedRows as enriched rows; use progress.enrichedRows, needsEnrichRows, activeCellCount, preparedMessages, approvedMessages, and stopReason. Cross-workspace Agent calls must pass workspaceId.",
         inputSchema: {
             type: "object",
             properties: {

package/dist/tools/campaign-processing.js

@@ -419,7 +419,7 @@ export const campaignProcessingToolDefinitions = [
     },
     {
         name: "queue_campaign_cells",
-        description: 'Resolve and queue campaign cells by semantic role and row selector. Normal create-campaign tail should use this instead of fetching rows only to discover cell IDs. For regular refill enrichment, queue columnRole:"enrich" with rowSelector:{type:"needsEnrichment"} or use start_campaign_message_preparation for the full top-down prep loop. For approval, rowSelector:{type:"needsApproval"} selects current generated rows missing Approved=true, but mutating Approved cells still requires explicit bounded approval. Do not use needsGeneratedMessage as a refill cursor because it only selects already-passed rows. forceRerun retries the selected cells only; it never changes the approved template or synthesizes messageTemplateRevision authority.',
+        description: 'Resolve and queue campaign cells by semantic role and bounded row selector. This is the shared campaign-setup, rubric-maintenance, and recovery owner; use it instead of fetching rows only to discover raw cell IDs. For any fill/refill-sends intent, do not call this tool directly: use refill_v3_advance so V3 owns target selection, fencing, and continuation. For approval, rowSelector:{type:"needsApproval"} selects current generated rows missing Approved=true, but mutating Approved cells still requires explicit bounded approval. Do not use needsGeneratedMessage as a top-down cursor because it only selects already-passed rows. forceRerun retries the selected cells only; it never changes the approved template, rewrites scheduled/attempted outreach, or synthesizes messageTemplateRevision authority. Cross-workspace Agent calls must pass workspaceId.',
         inputSchema: {
             type: "object",
             properties: {

package/dist/tools/cells.js

@@ -24,7 +24,7 @@ export const cellToolDefinitions = [
     },
     {
         name: "queue_cells",
-        description: "Queue explicit cells for processing. In create-campaign-v2 Filter Leads, pass only initial campaign-table execution-slice enrichCellId values from get_rows_minimal; do not pass icpCellId values or full-table cells because the workflow cascade handles downstream ICP scoring.",
+        description: "Legacy exact-cell compatibility/recovery tool. Prefer queue_campaign_cells for campaign work because it resolves semantic column roles and bounded row selectors. For fill/refill intent, use refill_v3_advance instead of reconstructing the refill loop. If exact IDs are required for recovery, pass only the bounded cells already returned by a product owner; do not queue full-table or downstream ICP cells. Cross-workspace Agent calls must pass workspaceId.",
         inputSchema: {
             type: "object",
             properties: {

package/dist/tools/registry.d.ts

@@ -11106,6 +11106,7 @@ export declare const allTools: ({
             updates?: undefined;
             checkName?: undefined;
             maxProspects?: undefined;
+            workspaceId?: undefined;
             tableId?: undefined;
             targetCount?: undefined;
             minPassedCount?: undefined;
@@ -11140,6 +11141,7 @@ export declare const allTools: ({
             updates?: undefined;
             checkName?: undefined;
             maxProspects?: undefined;
+            workspaceId?: undefined;
             tableId?: undefined;
             targetCount?: undefined;
             minPassedCount?: undefined;
@@ -11203,6 +11205,7 @@ export declare const allTools: ({
             updates?: undefined;
             checkName?: undefined;
             maxProspects?: undefined;
+            workspaceId?: undefined;
             tableId?: undefined;
             targetCount?: undefined;
             minPassedCount?: undefined;
@@ -11262,6 +11265,7 @@ export declare const allTools: ({
             updates?: undefined;
             checkName?: undefined;
             maxProspects?: undefined;
+            workspaceId?: undefined;
             tableId?: undefined;
             targetCount?: undefined;
             minPassedCount?: undefined;
@@ -11323,6 +11327,7 @@ export declare const allTools: ({
             rubric?: undefined;
             checkName?: undefined;
             maxProspects?: undefined;
+            workspaceId?: undefined;
             tableId?: undefined;
             targetCount?: undefined;
             minPassedCount?: undefined;
@@ -11354,6 +11359,7 @@ export declare const allTools: ({
             rubricId?: undefined;
             updates?: undefined;
             maxProspects?: undefined;
+            workspaceId?: undefined;
             tableId?: undefined;
             targetCount?: undefined;
             minPassedCount?: undefined;
@@ -11379,6 +11385,10 @@ export declare const allTools: ({
                 type: string;
                 description: string;
             };
+            workspaceId: {
+                type: string;
+                description: string;
+            };
             leadScoringRubrics?: undefined;
             requiredCheckNames?: undefined;
             rubric?: undefined;

package/dist/tools/rubrics.d.ts

@@ -27,6 +27,7 @@ type DeleteRubricItemInput = {
 type CheckRubricInput = {
     campaignOfferId: string;
     maxProspects?: number;
+    workspaceId?: string;
 };
 type WaitForRubricResultsInput = {
     campaignOfferId?: string;
@@ -112,6 +113,7 @@ export declare const rubricToolDefinitions: ({
             updates?: undefined;
             checkName?: undefined;
             maxProspects?: undefined;
+            workspaceId?: undefined;
             tableId?: undefined;
             targetCount?: undefined;
             minPassedCount?: undefined;
@@ -146,6 +148,7 @@ export declare const rubricToolDefinitions: ({
             updates?: undefined;
             checkName?: undefined;
             maxProspects?: undefined;
+            workspaceId?: undefined;
             tableId?: undefined;
             targetCount?: undefined;
             minPassedCount?: undefined;
@@ -209,6 +212,7 @@ export declare const rubricToolDefinitions: ({
             updates?: undefined;
             checkName?: undefined;
             maxProspects?: undefined;
+            workspaceId?: undefined;
             tableId?: undefined;
             targetCount?: undefined;
             minPassedCount?: undefined;
@@ -268,6 +272,7 @@ export declare const rubricToolDefinitions: ({
             updates?: undefined;
             checkName?: undefined;
             maxProspects?: undefined;
+            workspaceId?: undefined;
             tableId?: undefined;
             targetCount?: undefined;
             minPassedCount?: undefined;
@@ -329,6 +334,7 @@ export declare const rubricToolDefinitions: ({
             rubric?: undefined;
             checkName?: undefined;
             maxProspects?: undefined;
+            workspaceId?: undefined;
             tableId?: undefined;
             targetCount?: undefined;
             minPassedCount?: undefined;
@@ -360,6 +366,7 @@ export declare const rubricToolDefinitions: ({
             rubricId?: undefined;
             updates?: undefined;
             maxProspects?: undefined;
+            workspaceId?: undefined;
             tableId?: undefined;
             targetCount?: undefined;
             minPassedCount?: undefined;
@@ -385,6 +392,10 @@ export declare const rubricToolDefinitions: ({
                 type: string;
                 description: string;
             };
+            workspaceId: {
+                type: string;
+                description: string;
+            };
             leadScoringRubrics?: undefined;
             requiredCheckNames?: undefined;
             rubric?: undefined;
@@ -447,6 +458,7 @@ export declare const rubricToolDefinitions: ({
             updates?: undefined;
             checkName?: undefined;
             maxProspects?: undefined;
+            workspaceId?: undefined;
         };
         required: never[];
         additionalProperties: boolean;
@@ -503,15 +515,6 @@ export declare function saveRubrics(input: SaveRubricsInput): Promise<{
     activeRubrics: RubricItem[];
 }>;
 export declare function checkRubric(input: CheckRubricInput): Promise<{
-    success: boolean;
-    message: string;
-    processedRows: number;
-    tableId: string;
-    queuedCount?: undefined;
-    dispatchedCount?: undefined;
-    failedCount?: undefined;
-    skippedCount?: undefined;
-} | {
     success: boolean;
     message: string;
     processedRows: number;

package/dist/tools/rubrics.js

@@ -1,4 +1,5 @@
 import { getApi } from "../api.js";
+import { queueCampaignCells } from "./campaign-processing.js";
 import { fetchCampaignRubrics, upsertRubricV3, } from "./processing.js";
 import { getTableRowsMinimal } from "./rows.js";
 const rubricDrafts = new Map();
@@ -362,7 +363,7 @@ export const rubricToolDefinitions = [
     },
     {
         name: "check_rubric",
-        description: "Queue enrichment + scoring for a sample of prospects (default 7). Requires saved rubrics.",
+        description: "Legacy compatibility/recovery alias for a bounded saved-rubric sample. It delegates to queue_campaign_cells with the semantic Enrich Prospect role and never discovers raw cell IDs. Do not use it for fill/refill intent; use refill_v3_advance. Normal campaign setup and maintenance should call queue_campaign_cells directly. Cross-workspace Agent calls must pass workspaceId.",
         inputSchema: {
             type: "object",
             properties: {
@@ -374,6 +375,10 @@ export const rubricToolDefinitions = [
                     type: "number",
                     description: `Number of prospects to test (default ${DEFAULT_MAX_PROSPECTS}, max ${MAX_PROSPECTS_LIMIT}).`,
                 },
+                workspaceId: {
+                    type: "string",
+                    description: "Explicit target workspace id.",
+                },
             },
             required: ["campaignOfferId"],
             additionalProperties: false,
@@ -628,75 +633,57 @@ export async function saveRubrics(input) {
     };
 }
 export async function checkRubric(input) {
-    const maxProspects = resolveMaxProspects(input.maxProspects);
-    const campaign = await fetchCampaignOffer(input.campaignOfferId);
-    if (campaign.enableICPFilters !== true) {
-        throw new Error("ICP filtering is not enabled. Save and apply rubrics before running check_rubric.");
-    }
-    const draft = getDraftRubrics(input.campaignOfferId);
-    const rubrics = normalizeCampaignRubrics((draft || campaign.leadScoringRubrics || []).filter((r) => r.useCheckForScoring !== false));
-    if (rubrics.length === 0) {
-        throw new Error("No active rubric criteria found. Use draft_rubrics and save_rubrics first.");
-    }
-    const unsavedRubrics = rubrics.filter((r) => !r.id);
-    if (unsavedRubrics.length > 0) {
-        throw new Error(`${unsavedRubrics.length} rubric criteria are not saved to database. Call save_rubrics before check_rubric.`);
-    }
-    const workflowTableId = campaign.workflowTableId;
-    if (!workflowTableId) {
-        throw new Error("No workflow table found. Complete the Find Leads step first to create a workflow table with leads.");
-    }
-    const api = getApi();
-    const tableResponse = await api.get(`/api/v3/campaigns/${input.campaignOfferId}/workflow-table`);
-    const workflowTable = tableResponse.workflowTable;
-    if (!workflowTable) {
-        throw new Error("Workflow table not found for this campaign.");
-    }
-    const enrichColumn = workflowTable.columns?.find((col) => col.columnType === "enrich_person");
-    if (!enrichColumn) {
-        throw new Error("No Enrich Person column found in workflow table. The table may not be set up correctly.");
-    }
-    const rows = workflowTable.rows || [];
-    const cellsToQueue = [];
-    for (const row of rows) {
-        if (cellsToQueue.length >= maxProspects)
-            break;
-        const enrichCell = row.cells?.find((cell) => cell.columnId === enrichColumn.id);
-        if (!enrichCell)
-            continue;
-        const queueableStatuses = ["pending", "error", "dependency_blocked"];
-        if (queueableStatuses.includes(enrichCell.status || "")) {
-            cellsToQueue.push(enrichCell.id);
+    const workspaceId = typeof input.workspaceId === "string" && input.workspaceId.trim()
+        ? input.workspaceId.trim()
+        : undefined;
+    const execute = async () => {
+        const maxProspects = resolveMaxProspects(input.maxProspects);
+        const campaign = await fetchCampaignOffer(input.campaignOfferId);
+        if (campaign.enableICPFilters !== true) {
+            throw new Error("ICP filtering is not enabled. Save and apply rubrics before running check_rubric.");
         }
-    }
-    if (cellsToQueue.length === 0) {
+        const draft = getDraftRubrics(input.campaignOfferId);
+        const rubrics = normalizeCampaignRubrics((draft || campaign.leadScoringRubrics || []).filter((rubric) => rubric.useCheckForScoring !== false));
+        if (rubrics.length === 0) {
+            throw new Error("No active rubric criteria found. Use draft_rubrics and save_rubrics first.");
+        }
+        const unsavedRubrics = rubrics.filter((rubric) => !rubric.id);
+        if (unsavedRubrics.length > 0) {
+            throw new Error(`${unsavedRubrics.length} rubric criteria are not saved to database. Call save_rubrics before check_rubric.`);
+        }
+        const workflowTableId = campaign.workflowTableId;
+        if (!workflowTableId) {
+            throw new Error("No workflow table found. Complete the Find Leads step first to create a workflow table with leads.");
+        }
+        const result = (await queueCampaignCells({
+            campaignId: input.campaignOfferId,
+            tableId: workflowTableId,
+            ...(workspaceId ? { workspaceId } : {}),
+            columnRole: "enrich",
+            rowSelector: { type: "needsEnrichment", limit: maxProspects },
+            limit: maxProspects,
+            reason: "check_rubric compatibility sample",
+        }));
+        const queuedCount = result.queue?.queued ?? 0;
+        const failedCount = result.queue?.failed ?? 0;
+        const skippedCount = result.queue?.skipped ?? 0;
+        const dispatchedCount = result.queue?.dispatched ?? queuedCount;
         return {
             success: true,
-            message: "No rows need processing. All enrich cells are either completed, cached, or currently processing.",
-            processedRows: 0,
-            tableId: workflowTable.id,
+            message: queuedCount === 0
+                ? "No rows need processing. All semantic Enrich Prospect cells are completed, cached, or currently processing."
+                : `Queued ${queuedCount} prospects for enrichment and scoring.${failedCount > 0 ? ` (${failedCount} failed to dispatch)` : ""}`,
+            processedRows: queuedCount,
+            queuedCount,
+            dispatchedCount,
+            failedCount,
+            skippedCount,
+            tableId: workflowTableId,
         };
-    }
-    // Use the same robust batch queue path as Launch "Enrich All":
-    // atomically queue + dispatch with lock protection.
-    const queueResult = await api.post(`/api/v3/workflow-tables/cells/queue-batch`, {
-        tableId: workflowTable.id,
-        cellIds: cellsToQueue,
-    });
-    const queuedCount = queueResult?.queued ?? 0;
-    const failedCount = queueResult?.failed ?? 0;
-    const skippedCount = queueResult?.skipped ?? 0;
-    const dispatchedCount = queueResult?.dispatched ?? queuedCount;
-    return {
-        success: true,
-        message: `Queued ${queuedCount} prospects for enrichment and scoring.${failedCount > 0 ? ` (${failedCount} failed to dispatch)` : ""}`,
-        processedRows: queuedCount,
-        queuedCount,
-        dispatchedCount,
-        failedCount,
-        skippedCount,
-        tableId: workflowTable.id,
     };
+    return workspaceId
+        ? getApi().withWorkspaceId(workspaceId, execute)
+        : execute();
 }
 export async function waitForRubricResults(input) {
     const api = getApi();

package/package.json

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

package/skills/create-rubric/SKILL.md

@@ -53,12 +53,14 @@ Create and save a comprehensive lead scoring rubric that:
 
 ## Rubric Validation + Results
 
-- `mcp__sellable__get_rows_minimal` - Read initial campaign-table execution-slice cell IDs
-- `mcp__sellable__queue_cells` - Queue only bounded sample `enrichCellId` values
+- `mcp__sellable__queue_campaign_cells` - Queue a bounded sample by semantic
+  `columnRole:"enrich"` and row selector; pass `workspaceId` in cross-workspace
+  Agent mode
 - `mcp__sellable__wait_for_rubric_results` - Poll pass-rate results
 
-`check_rubric` is legacy/recovery only. Do not use it in normal
-create-campaign-v2 runs.
+`check_rubric` and `queue_cells` are legacy/recovery only. Do not use either in
+normal create-campaign-v2 runs, and do not use any of these tools for refill
+intent; Refill V3 owns refill execution.
 
 </tools>
 
@@ -304,11 +306,10 @@ rubric editing, ask the user if we should kick off enrichment for a sample:
 
 ## Phase 6: Enrich + Score a Sample
 
-1. Call `get_rows_minimal({ tableId, limit: 5 })` or use the caller-provided
-   review/process sample rows.
-2. Call `queue_cells({ tableId, cellIds })` with only pending/error
-   `enrichCellId` values. Do not pass `icpCellId` values or full-table cells;
-   the workflow cascade handles downstream ICP scoring after enrichment.
+1. Use the caller-provided bounded review/process sample.
+2. Call `queue_campaign_cells({ campaignId, tableId, columnRole: "enrich",
+rowSelector: { type: "reviewBatch" }, workspaceId })`. The semantic owner
+   resolves Enrich Prospect and preserves the workflow cascade into scoring.
 3. Call `wait_for_rubric_results` with `targetCount: 5` and `minPassedCount: 1`
    — polls until ICP scores land.
 4. Summarize pass rate (`passed/completed`, percent) and recommend: