@sellable/mcp 0.1.80 → 0.1.82

package/dist/tools/readiness.d.ts

@@ -1,5 +1,6 @@
 type WaitForCampaignTableReadyInput = {
     campaignId: string;
+    flowVersion?: "v1" | "v2";
     timeoutMs?: number;
     intervalMs?: number;
     requireRows?: boolean;
@@ -43,6 +44,11 @@ export declare const readinessToolDefinitions: ({
                 type: string;
                 description: string;
             };
+            flowVersion: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
             leadListId?: undefined;
             campaignOfferId?: undefined;
             provider?: undefined;
@@ -96,6 +102,7 @@ export declare const readinessToolDefinitions: ({
                 description: string;
             };
             campaignId?: undefined;
+            flowVersion?: undefined;
         };
         required: never[];
         additionalProperties: boolean;
@@ -108,8 +115,8 @@ export declare function waitForCampaignTableReady(input: WaitForCampaignTableRea
     elapsedMs: number;
     navigation: {
         campaignId: string;
-        computedStep: "campaign-created" | "pick-provider" | "provider-search" | "confirm-lead-list";
-        blockedAt: ("campaign-created" | "pick-provider" | "provider-search" | "confirm-lead-list") | null;
+        computedStep: "running" | "messages" | "settings" | "sequence" | "send" | "campaign-created" | "pick-provider" | "provider-search" | "confirm-lead-list" | "filter-rules";
+        blockedAt: ("running" | "messages" | "settings" | "sequence" | "send" | "campaign-created" | "pick-provider" | "provider-search" | "confirm-lead-list" | "filter-rules") | null;
         missing: string[];
         expectedHeadlessStep: string | null;
         headlessCurrentStep: string | null;
@@ -125,6 +132,12 @@ export declare function waitForCampaignTableReady(input: WaitForCampaignTableRea
             leadSourceProvider: string | null;
             selectedLeadListId: string | null;
             providerCurrentStep: string | null;
+            enableICPFilters: boolean | null;
+            activeRubricCount: number;
+            hasApprovedMessageTemplate: boolean;
+            senderCount: number;
+            hasSequenceTemplate: boolean;
+            campaignStatus: string | null;
         };
         warnings: string[];
     };
@@ -135,8 +148,8 @@ export declare function waitForCampaignTableReady(input: WaitForCampaignTableRea
     elapsedMs: number;
     navigation: {
         campaignId: string;
-        computedStep: "campaign-created" | "pick-provider" | "provider-search" | "confirm-lead-list";
-        blockedAt: ("campaign-created" | "pick-provider" | "provider-search" | "confirm-lead-list") | null;
+        computedStep: "running" | "messages" | "settings" | "sequence" | "send" | "campaign-created" | "pick-provider" | "provider-search" | "confirm-lead-list" | "filter-rules";
+        blockedAt: ("running" | "messages" | "settings" | "sequence" | "send" | "campaign-created" | "pick-provider" | "provider-search" | "confirm-lead-list" | "filter-rules") | null;
         missing: string[];
         expectedHeadlessStep: string | null;
         headlessCurrentStep: string | null;
@@ -152,6 +165,12 @@ export declare function waitForCampaignTableReady(input: WaitForCampaignTableRea
             leadSourceProvider: string | null;
             selectedLeadListId: string | null;
             providerCurrentStep: string | null;
+            enableICPFilters: boolean | null;
+            activeRubricCount: number;
+            hasApprovedMessageTemplate: boolean;
+            senderCount: number;
+            hasSequenceTemplate: boolean;
+            campaignStatus: string | null;
         };
         warnings: string[];
     };
@@ -164,8 +183,8 @@ export declare function waitForCampaignTableReady(input: WaitForCampaignTableRea
     elapsedMs: number;
     navigation: {
         campaignId: string;
-        computedStep: "campaign-created" | "pick-provider" | "provider-search" | "confirm-lead-list";
-        blockedAt: ("campaign-created" | "pick-provider" | "provider-search" | "confirm-lead-list") | null;
+        computedStep: "running" | "messages" | "settings" | "sequence" | "send" | "campaign-created" | "pick-provider" | "provider-search" | "confirm-lead-list" | "filter-rules";
+        blockedAt: ("running" | "messages" | "settings" | "sequence" | "send" | "campaign-created" | "pick-provider" | "provider-search" | "confirm-lead-list" | "filter-rules") | null;
         missing: string[];
         expectedHeadlessStep: string | null;
         headlessCurrentStep: string | null;
@@ -181,6 +200,12 @@ export declare function waitForCampaignTableReady(input: WaitForCampaignTableRea
             leadSourceProvider: string | null;
             selectedLeadListId: string | null;
             providerCurrentStep: string | null;
+            enableICPFilters: boolean | null;
+            activeRubricCount: number;
+            hasApprovedMessageTemplate: boolean;
+            senderCount: number;
+            hasSequenceTemplate: boolean;
+            campaignStatus: string | null;
         };
         warnings: string[];
     } | null;

package/dist/tools/readiness.js

@@ -67,6 +67,11 @@ export const readinessToolDefinitions = [
                     type: "boolean",
                     description: "When true (default), wait for at least one row to appear.",
                 },
+                flowVersion: {
+                    type: "string",
+                    enum: ["v1", "v2"],
+                    description: "Framework flow version used when hydrating campaign context (default: v1).",
+                },
             },
             required: ["campaignId"],
             additionalProperties: false,
@@ -148,7 +153,7 @@ export async function waitForCampaignTableReady(input) {
         const rowsSatisfied = requireRows ? hasRows : hasTable;
         const missingTableBits = navState.missing.filter((m) => m === "workflowTableId" || m === "workflowTableRows");
         if (hasTable && rowsSatisfied && missingTableBits.length === 0) {
-            const entry = hydrateCampaignContextFromNavigation(navState, "wait_for_campaign_table_ready");
+            const entry = hydrateCampaignContextFromNavigation(navState, "wait_for_campaign_table_ready", input.flowVersion ?? "v1");
             return {
                 ready: true,
                 attempts,

package/dist/tools/rubrics.d.ts

@@ -457,6 +457,8 @@ export declare function saveRubrics(input: SaveRubricsInput): Promise<{
     criteriaCount: number;
     deletedCount: number;
     enableICPFiltersSet: boolean;
+    rubrics: RubricItem[];
+    activeRubrics: RubricItem[];
 }>;
 export declare function checkRubric(input: CheckRubricInput): Promise<{
     success: boolean;

package/dist/tools/rubrics.js

@@ -545,6 +545,8 @@ export async function saveRubrics(input) {
         criteriaCount: normalizedDraft.length,
         deletedCount: deletedRubricIds.length,
         enableICPFiltersSet,
+        rubrics: result?.rubrics ?? normalizedDraft,
+        activeRubrics: result?.rubrics ?? normalizedDraft,
     };
 }
 export async function checkRubric(input) {

package/package.json

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

package/skills/create-campaign/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: create-campaign
-description: Create a Sellable campaign through the approval-gated workflow.
+description: Create a Sellable campaign through the shell-first CampaignOffer workflow.
 visibility: public
 allowed-tools:
   - mcp__sellable__get_auth_status
@@ -66,6 +66,14 @@ allowed-tools:
 
 Use this as the customer-facing entrypoint for Sellable campaign creation.
 
+CampaignOffer state is canonical; disk artifacts are a debug trail. The
+internal create-campaign-v2 flow still writes the diagnostics, and all 14 disk
+artifacts remain as debug outputs, but resume, gating, and handoff read campaign
+state first. The
+watchable campaign exists after the short brief; lead import is bounded to the
+first review batch, and enrichment/message generation waits until rubrics and
+the approved message template are saved on the campaign.
+
 ## Opening Turn Contract
 
 On the first visible response after this skill is invoked, do not narrate
@@ -75,7 +83,7 @@ or tool discovery. Start in product language:
 ```text
 I’ll help you launch this as a Sellable campaign. First I’ll confirm who we’re
 sending from and which company this is for, then I’ll turn that into a campaign
-brief before anything is created.
+brief before any leads are imported or anything can send.
 ```
 
 If a linked/local skill file is stale or missing, silently use the installed
@@ -91,7 +99,8 @@ clear business decisions, tradeoffs, and approval gates. Use product language:
 - "a couple setup choices", not `request_user_input`
 - "campaign brief", not prompt artifact
 - "lead source", not provider internals unless comparing source options
-- "nothing is created until you approve", not mutation jargon
+- "I can create a draft shell for you to watch, but no leads import and nothing
+  sends until you approve", not mutation jargon
 
 When explaining lead-source decisions, show the concrete counts behind the
 logic: lanes searched, timeframe, raw result counts, finalist posts or preview
@@ -130,7 +139,7 @@ Every approval gate must include artifact access after the readable inline
 content. Show a short `Open artifact:` line with the one key clickable markdown
 link for that stage. Do not show raw filesystem paths unless links cannot be
 created or the user asks. Do this for brief approval, lead-source
-approval/review, lead-filter review, message review, and final approval packet.
+approval/review, lead-filter review, and message review.
 The link is for deeper inspection; never use it as a substitute for showing the
 content in chat.
 
@@ -340,7 +349,7 @@ I can’t confirm it, I’ll ask for your LinkedIn URL or company website and us
 that to understand the company before we choose the target, offer, proof, and
 lead source.
 
-Then I’ll turn that into a campaign brief for you to approve before anything is created.
+Then I’ll turn that into a campaign brief for you to approve before any leads are imported or anything can send.
 ```
 
 Do not silently ask Codex intake or approval questions as plain chat when
@@ -374,7 +383,7 @@ No problem. You can still continue by switching Codex to Plan mode and running:
 
 $sellable:create-campaign
 
-I won’t create or change anything in Sellable until you approve the final campaign.
+I won’t import leads, attach a sequence, or start anything until the brief, source, filters, and message are set.
 ```
 
 Plain chat questions are only acceptable in non-interactive `codex exec`
@@ -520,12 +529,15 @@ updates.
    `mcp__sellable__get_subskill_prompt({ subskillName: "generate-messages", offset, limit })`
    calls until `hasMore` is false. Do not synthesize
    `message-validation.md` from the brief, lead review, or general knowledge.
-5. Treat message quality as the gate before minting. Do not create a campaign,
-   show a commit gate, or mint anything until `message-validation.md` proves
-   the full generate-messages workflow ran and `message-review.md` recommends
-   `approve-message` against the gold-standard rules.
-6. Do not create or mutate the live campaign until the approval gate returns
-   `approve`.
+5. Create the campaign shell early with the v1 brief so the user can open the
+   watch link and see useful setup state immediately. Import only the first
+   bounded review batch after the source is attached to the campaign; do not
+   queue workflow cells, attach a sequence, or start until
+   `message-validation.md` proves the full generate-messages workflow ran,
+   `message-review.md` approves the template, rubrics are saved, and the
+   approved message set is synced into the campaign brief.
+6. Keep `selectedLeadListId` as the source list and `workflowTableId` as the
+   campaign table. Do not use disk files as the post-mint source of truth.
 7. Do not ask the user to run another command.
 
 ## Fallback