@sellable/mcp 0.1.135 → 0.1.137

package/dist/tools/navigation.js

@@ -243,6 +243,9 @@ function checkMessages(campaign) {
     if (!hasApprovedMessageTemplate(campaign)) {
         missing.push("approvedMessageTemplate");
     }
+    if (campaign.currentStep === "auto-execute-messaging") {
+        missing.push("generatedMessageReview");
+    }
     return { stepId: "messages", missing };
 }
 function checkSettings(campaign) {

package/dist/tools/processing.js

@@ -17,7 +17,7 @@ export const processingToolDefinitions = [
                 },
                 currentStep: {
                     type: ["string", "null"],
-                    description: "Headless workflow step ID",
+                    description: "Headless workflow step ID only when paired with the visible watch narration expected by the campaign-offers API; do not use as a separate step-only fixup after rubric, sender, sequence, or start work.",
                 },
                 enableICPFilters: {
                     type: "boolean",

package/dist/tools/prompts.d.ts

@@ -99,9 +99,7 @@ export interface SourceScoutRegistryResponse {
 export interface PostFindLeadsScoutRegistryResponse {
     version: number;
     trigger: "find_leads_source_approved";
-    requiredArtifacts?: string[];
     requiredInputs?: string[];
-    optionalDebugArtifacts?: string[];
     scouts: Array<{
         id: string;
         name: string;
@@ -125,12 +123,21 @@ export interface PostFindLeadsScoutRegistryResponse {
     }>;
     joinGate: {
         afterAllComplete: boolean;
-        requiredArtifacts?: string[];
         requiredState?: string[];
-        optionalDebugArtifacts?: string[];
+        noFilterRequiredState?: string[];
+        skipFilterRule?: string;
         show: string[];
         nextStage: string;
     };
+    messageDraftBranchContract?: {
+        firstAllowedStart: string;
+        forbiddenStarts: string[];
+        runtimeProofTransport: string;
+        runtimeProofRequiredFields: string[];
+        basisFields: string[];
+        compactOutputFields: string[];
+        reusePolicy?: string;
+    };
     usage: {
         codex: string;
         claude: string;

package/dist/tools/prompts.js

@@ -256,12 +256,13 @@ export function getPostFindLeadsScoutRegistry() {
         trigger: "find_leads_source_approved",
         requiredInputs: [
             "campaignId",
+            "campaign revision or campaignUpdatedAt",
             "campaignBrief",
             "source decision and selectedLeadList/source state",
             "workflowTableId",
-            "imported review-batch rows from selectedLeadList",
+            "imported review-batch rows from selectedLeadList with row ids/hash",
+            "filter choice and filter/rubric basis when present",
         ],
-        optionalDebugArtifacts: ["brief.md", "lead-review.md", "lead-sample.json"],
         scouts: scouts.map((agent) => ({
             id: String(agent.id || ""),
             name: String(agent.name || ""),
@@ -290,14 +291,57 @@ export function getPostFindLeadsScoutRegistry() {
         joinGate: {
             afterAllComplete: true,
             requiredState: ["leadScoringRubrics", "messageDraftRecommendation"],
-            optionalDebugArtifacts: ["lead-filter.md", "message-validation.md"],
+            noFilterRequiredState: ["messageDraftRecommendation"],
+            skipFilterRule: "leadScoringRubrics may be absent only when the user explicitly skips filters with enableICPFilters=false; messageDraftRecommendation is still required before template review.",
             show: ["readable_filters_with_reasons", "sample_message_for_approval"],
             nextStage: "message-review",
         },
+        messageDraftBranchContract: {
+            firstAllowedStart: "after confirm_lead_list imports a non-empty bounded review batch and get_rows_minimal confirms rows for workflowTableId",
+            forbiddenStarts: [
+                "source recommendation",
+                "provider import job alone",
+                "zero-row review batch",
+            ],
+            runtimeProofTransport: "CampaignOffer.watchNarration.workerDetails.messageDraftBuilder",
+            runtimeProofRequiredFields: [
+                "runId or fallbackId",
+                "statusSource",
+                "status",
+                "startedAt",
+                "updatedAt",
+                "basisToken",
+                "basis.selectedLeadListId",
+                "basis.workflowTableId",
+                "basis.reviewBatchRowHash or basis.reviewBatchRowIds",
+            ],
+            basisFields: [
+                "campaign revision or updatedAt",
+                "brief hash",
+                "selectedLeadListId",
+                "workflowTableId",
+                "bounded review-batch row ids/hash",
+                "filter choice",
+                "filter/rubric basis when present",
+            ],
+            compactOutputFields: [
+                "templateRecommendation",
+                "tokenFillRules",
+                "renderedSample",
+                "concerns",
+                "status",
+                "basisStatus",
+                "basisToken",
+                "outputAt",
+                "outputHash",
+                "error or retry detail",
+            ],
+            reusePolicy: "The first completed Message Draft Builder recommendation remains the default review candidate. Later Lead Fit Builder, Filter Leads, enrichment, or rubric completion may make an enriched rewrite available, but does not automatically retry or replace the initial draft unless campaign/brief/source/list/table/review-batch identity mismatches or the initial output failed.",
+        },
         usage: {
             codex: "After the user approves or auto-confirms the lead source, spawn both returned scout `name` values in one assistant turn only when the current Codex host exposes those custom agents.",
             claude: "After lead source approval, invoke both returned Task/Agent subagents in one assistant message only when the current Claude session lists those agents, so filter-leads and message generation run concurrently.",
-            parentThreadRule: "Named agents are optional acceleration. If they are absent, do not customer-surface install status; the main thread still orchestrates filter and message branches from CampaignOffer state, selected source state, workflowTableId, and imported review-batch rows. Debug markdown/json artifacts are optional only. The message branch must load the full generate-messages prompt and may use the create-campaign-v2 message-review safety gate as a supplemental approval check. Join before message review.",
+            parentThreadRule: "Named agents are optional acceleration. If they are absent, do not customer-surface install status; the main thread still orchestrates filter and message branches from CampaignOffer state, selected source state, workflowTableId, and imported review-batch rows. Local markdown/json files are not normal-path inputs. The message branch must load the full generate-messages prompt, must read live campaign/review-batch state through scoped MCP/product tools, must reject mismatched selectedLeadListId/workflowTableId/campaign/workspace input, and may use the create-campaign-v2 message-review safety gate as a supplemental approval check. Join before message review. Do not automatically rerun Message Draft Builder after filters/enrichment finish; show the initial draft by default and offer an enriched rewrite only with explicit user opt-in.",
         },
     };
 }

package/dist/tools/sequencer.d.ts

@@ -35,6 +35,7 @@ export type AttachRecommendedSequenceInput = {
 export type AttachRecommendedSequenceResponse = {
     success: boolean;
     version: number;
+    currentStep?: string;
     template?: {
         name?: string;
         entryNodeId?: string;

package/dist/tools/sequencer.js

@@ -85,7 +85,7 @@ export const sequencerToolDefinitions = [
                 },
                 currentStep: {
                     type: "string",
-                    description: "Optional CampaignOffer currentStep to persist with the sequence attach, usually 'send' after the recommended sequence is bound.",
+                    description: "Optional CampaignOffer currentStep to persist atomically with the sequence attach, usually 'send' after the recommended sequence is bound. The backend writes the matching watch narration; do not follow with a separate step-only update_campaign fixup.",
                 },
             },
             required: ["campaignId"],

package/package.json

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