@sellable/mcp 0.1.292 → 0.1.294

package/README.md

@@ -307,13 +307,15 @@ Parallel execution contract:
   review batch and rows are proven, ask the filter-choice question immediately.
   Do not load this registry or deep filter/message prompts before that question.
   Once the user answers, launch Message Drafting from the same campaign/table
-  basis. If the user chooses filters, keep filter/rubric work in the parent
-  thread: show Filter Rules, load `references/filter-leads.md`, save rubrics,
-  then ask for filter approval. After approval, move to Filter Leads and show
+  basis. This launch is required whether filters are chosen or skipped. If the
+  user chooses filters, keep filter/rubric work in the parent thread: show
+  Filter Rules, load `references/filter-leads.md`, save rubrics, then ask for
+  filter approval. After approval, move to Filter Leads and show
   `Filters saved + waiting for message approval` while the message
-  recommendation is reviewed. If filters are skipped, move to Messages/message
-  review. Enrichment/filtering and Generate Message cells wait for message
-  approval.
+  recommendation is reviewed. If filters are skipped, start Message Drafting
+  first, then move to Messages/message review; `currentStep=messages` is not
+  proof of worker kickoff. Enrichment/filtering and Generate Message cells wait
+  for message approval.
 - Source scouts and Prospect Filters are not normal create-campaign background
   agents. Only Message Drafting may spawn as a background/custom agent on the
   normal path; if it cannot be launched and the user does not approve inline

package/dist/tools/engage-discovery.d.ts

@@ -9,6 +9,14 @@ type ReachSignals = {
     reachAdjustedScore: number;
     confidence: "high" | "medium" | "low";
 };
+type EngagementPostMedia = {
+    imageUrls: string[];
+    videoThumbnailUrl?: string;
+    videoUrl?: string;
+    articleImageUrl?: string;
+    articleUrl?: string;
+    mediaTypes: string[];
+};
 export type EngagementPost = {
     postId: string;
     url: string;
@@ -27,6 +35,7 @@ export type EngagementPost = {
         total: number;
     };
     reachSignals?: ReachSignals;
+    media?: EngagementPostMedia;
     contentPreview: string;
 };
 export type SearchEngagementPostsInput = {

package/dist/tools/engage-discovery.js

@@ -2,7 +2,7 @@ import { getApi } from "../api.js";
 export const engageDiscoveryToolDefinitions = [
     {
         name: "search_engagement_posts",
-        description: "Search for high-signal LinkedIn posts by keyword for engagement/comment drafting. Designed for the engage skill (no campaignOfferId required). Filters by recency and engagement, and can exclude already-engaged URLs.",
+        description: "Search for high-signal LinkedIn posts by keyword for engagement/comment drafting. Designed for the engage skill (no campaignOfferId required). Filters by recency and engagement, can exclude already-engaged URLs, and returns source media hints when the scraper provides images, video covers, or article images.",
         inputSchema: {
             type: "object",
             properties: {
@@ -74,6 +74,50 @@ function safeNumber(value) {
 function round3(value) {
     return Number(value.toFixed(3));
 }
+function normalizeMedia(raw) {
+    if (!raw || typeof raw !== "object")
+        return undefined;
+    const imageUrls = Array.isArray(raw.imageUrls)
+        ? raw.imageUrls
+            .map((url) => (typeof url === "string" ? url.trim() : ""))
+            .filter(Boolean)
+        : [];
+    const videoThumbnailUrl = typeof raw.videoThumbnailUrl === "string" && raw.videoThumbnailUrl.trim()
+        ? raw.videoThumbnailUrl.trim()
+        : undefined;
+    const videoUrl = typeof raw.videoUrl === "string" && raw.videoUrl.trim()
+        ? raw.videoUrl.trim()
+        : undefined;
+    const articleImageUrl = typeof raw.articleImageUrl === "string" && raw.articleImageUrl.trim()
+        ? raw.articleImageUrl.trim()
+        : undefined;
+    const articleUrl = typeof raw.articleUrl === "string" && raw.articleUrl.trim()
+        ? raw.articleUrl.trim()
+        : undefined;
+    const mediaTypes = Array.from(new Set([
+        ...(Array.isArray(raw.mediaTypes)
+            ? raw.mediaTypes.map((type) => typeof type === "string" ? type.trim() : "")
+            : []),
+        imageUrls.length > 0 ? "image" : "",
+        videoThumbnailUrl || videoUrl ? "video" : "",
+        articleImageUrl || articleUrl ? "article" : "",
+    ].filter(Boolean)));
+    if (imageUrls.length === 0 &&
+        !videoThumbnailUrl &&
+        !videoUrl &&
+        !articleImageUrl &&
+        !articleUrl) {
+        return undefined;
+    }
+    return {
+        imageUrls,
+        ...(videoThumbnailUrl ? { videoThumbnailUrl } : {}),
+        ...(videoUrl ? { videoUrl } : {}),
+        ...(articleImageUrl ? { articleImageUrl } : {}),
+        ...(articleUrl ? { articleUrl } : {}),
+        mediaTypes,
+    };
+}
 function parseFollowerCount(author) {
     const direct = safeNumber(author?.followerCount);
     if (direct > 0)
@@ -218,6 +262,7 @@ export async function searchEngagementPosts(input) {
             targetFollowerMin,
             targetFollowerMax,
         });
+        const media = normalizeMedia(p?.media);
         kept.push({
             postId: String(p?.id || ""),
             url,
@@ -233,6 +278,7 @@ export async function searchEngagementPosts(input) {
             },
             engagement: { likes, comments, shares, total },
             ...(reachSignals ? { reachSignals } : {}),
+            ...(media ? { media } : {}),
             contentPreview: previewText(String(p?.content || ""), 220),
         });
     }

package/dist/tools/leads.d.ts

@@ -5,6 +5,14 @@ type SignalPostForImportSelection = {
     likes: number;
     comments: number;
 };
+type SignalPostMedia = {
+    imageUrls: string[];
+    videoThumbnailUrl?: string;
+    videoUrl?: string;
+    articleImageUrl?: string;
+    articleUrl?: string;
+    mediaTypes: string[];
+};
 export declare function selectSignalPostsForImport<T extends SignalPostForImportSelection>(posts: T[], options: {
     targetEngagerCount?: number;
     maxPostsToScrape?: number;
@@ -4406,6 +4414,7 @@ export declare function searchSignals(input: SignalSearchInput): Promise<{
     selectionTarget: number;
     recommendedPostIds: string[];
     topPosts: {
+        media?: SignalPostMedia | undefined;
         id: string;
         url: string | undefined;
         matchedKeyword: string | null;

package/dist/tools/leads.js

@@ -3,8 +3,8 @@ import { dirname, join, resolve } from "path";
 import { getApi, SellableApiError } from "../api.js";
 import { resolveSkillsDir } from "../skills.js";
 import { resolveWorkspaceRoot } from "../utils/workspace-root.js";
-import { buildCsvDomainPreview, matchesConfirmationToken, parseConfirmationToken, projectCsvCarryRows, } from "./csv-domains.js";
 import { listDncEntries, loadCsvDncEntries, } from "./csv-dnc.js";
+import { buildCsvDomainPreview, matchesConfirmationToken, parseConfirmationToken, projectCsvCarryRows, } from "./csv-domains.js";
 import { buildCsvLinkedinPreview, matchesLinkedinConfirmationToken, parseLinkedinConfirmationToken, uploadCsvLinkedinFile, } from "./csv-linkedin.js";
 import { assertInteractionApproval } from "./interaction-mode.js";
 import { assertProviderPromptLoaded, markProviderPromptLoaded, } from "./provider-preflight.js";
@@ -727,6 +727,52 @@ function truncate(text, max = 220) {
         return clean;
     return `${clean.slice(0, max - 1)}...`;
 }
+function normalizeSignalPostMedia(raw) {
+    if (!raw || typeof raw !== "object")
+        return undefined;
+    const media = raw;
+    const imageUrls = Array.isArray(media.imageUrls)
+        ? media.imageUrls
+            .map((url) => (typeof url === "string" ? url.trim() : ""))
+            .filter(Boolean)
+        : [];
+    const videoThumbnailUrl = typeof media.videoThumbnailUrl === "string" &&
+        media.videoThumbnailUrl.trim()
+        ? media.videoThumbnailUrl.trim()
+        : undefined;
+    const videoUrl = typeof media.videoUrl === "string" && media.videoUrl.trim()
+        ? media.videoUrl.trim()
+        : undefined;
+    const articleImageUrl = typeof media.articleImageUrl === "string" && media.articleImageUrl.trim()
+        ? media.articleImageUrl.trim()
+        : undefined;
+    const articleUrl = typeof media.articleUrl === "string" && media.articleUrl.trim()
+        ? media.articleUrl.trim()
+        : undefined;
+    const mediaTypes = Array.from(new Set([
+        ...(Array.isArray(media.mediaTypes)
+            ? media.mediaTypes.map((type) => typeof type === "string" ? type.trim() : "")
+            : []),
+        imageUrls.length > 0 ? "image" : "",
+        videoThumbnailUrl || videoUrl ? "video" : "",
+        articleImageUrl || articleUrl ? "article" : "",
+    ].filter(Boolean)));
+    if (imageUrls.length === 0 &&
+        !videoThumbnailUrl &&
+        !videoUrl &&
+        !articleImageUrl &&
+        !articleUrl) {
+        return undefined;
+    }
+    return {
+        imageUrls,
+        ...(videoThumbnailUrl ? { videoThumbnailUrl } : {}),
+        ...(videoUrl ? { videoUrl } : {}),
+        ...(articleImageUrl ? { articleImageUrl } : {}),
+        ...(articleUrl ? { articleUrl } : {}),
+        mediaTypes,
+    };
+}
 function normalizePostUrl(url) {
     if (!url)
         return null;
@@ -764,6 +810,7 @@ function summarizeSignalPost(post) {
     const likes = post.engagement?.likes ?? 0;
     const comments = post.engagement?.comments ?? 0;
     const shares = post.engagement?.shares ?? 0;
+    const media = normalizeSignalPostMedia(post.media);
     return {
         id: post.id,
         url: post.url,
@@ -784,6 +831,7 @@ function summarizeSignalPost(post) {
         },
         score: Number(post._score.toFixed(2)),
         excerpt: truncate(post.content),
+        ...(media ? { media } : {}),
     };
 }
 function summarizeSignalSearchResponse(response) {
@@ -2697,9 +2745,7 @@ function normalizeMcpCompanyIcp(filters) {
     if (!isPlainObject(icp)) {
         return;
     }
-    const scope = typeof icp.geographic_scope === "string"
-        ? icp.geographic_scope.trim()
-        : "";
+    const scope = typeof icp.geographic_scope === "string" ? icp.geographic_scope.trim() : "";
     const scopeMarkets = expandMcpCompanyIcpMarket(scope);
     if (scopeMarkets.length > 0) {
         icp.geographic_scope = "multi_country";
@@ -2708,9 +2754,7 @@ function normalizeMcpCompanyIcp(filters) {
             ...normalizeMcpCompanyIcpMarkets(icp.geographic_markets),
         ]);
     }
-    else if (scope &&
-        scope !== "single_country" &&
-        scope !== "multi_country") {
+    else if (scope && scope !== "single_country" && scope !== "multi_country") {
         delete icp.geographic_scope;
     }
     if (icp.geographic_markets !== undefined) {
@@ -2791,8 +2835,7 @@ function normalizeMcpSeedMatchAll(filters, concreteSeedCount, omittedFilters = [
     if (!isPlainObject(filters.company_lookalike)) {
         return;
     }
-    if (filters.company_lookalike.match_all === true &&
-        concreteSeedCount < 2) {
+    if (filters.company_lookalike.match_all === true && concreteSeedCount < 2) {
         omittedFilters.push({
             field: "company_lookalike.match_all",
             reason: "Dropped match_all because fewer than two concrete approved lookalike seeds remained after MCP seed normalization.",
@@ -2900,7 +2943,9 @@ function normalizeStringArray(input) {
         .filter((value) => value.length > 0);
 }
 function normalizeMcpSeeds(input, kind) {
-    return uniqueStrings(normalizeStringArray(input).filter((seed) => kind === "domain" ? isLikelyConcreteDomain(seed) : isLikelyConcreteSeedCompany(seed)));
+    return uniqueStrings(normalizeStringArray(input).filter((seed) => kind === "domain"
+        ? isLikelyConcreteDomain(seed)
+        : isLikelyConcreteSeedCompany(seed)));
 }
 function isLikelyConcreteDomain(input) {
     return /^[a-z0-9.-]+\.[a-z]{2,}$/i.test(input);
@@ -3111,13 +3156,7 @@ function buildProspeoPeopleSearchFallbackInput(input, error) {
     const fallbackFilters = {
         person_name_or_job_title: keyword,
         person_seniority: {
-            include: [
-                "C-Suite",
-                "Vice President",
-                "Head",
-                "Director",
-                "Manager",
-            ],
+            include: ["C-Suite", "Vice President", "Head", "Director", "Manager"],
         },
         max_person_per_company: typeof filters.max_person_per_company === "number"
             ? filters.max_person_per_company

package/dist/tools/linkedin.d.ts

@@ -185,7 +185,15 @@ interface RawLinkedInPost {
         authorPublicIdentifier?: string;
     };
     text?: string;
-    content?: string;
+    content?: string | {
+        images?: unknown;
+        article?: unknown;
+        video?: unknown;
+    };
+    media?: unknown;
+    postImages?: unknown;
+    postVideo?: unknown;
+    article?: unknown;
     activityDate?: string;
     postedAt?: string | {
         date?: string;
@@ -219,6 +227,15 @@ interface SerializedPost {
     comments: number;
     url: string;
     isRepost: boolean;
+    media?: SerializedPostMedia;
+}
+interface SerializedPostMedia {
+    imageUrls: string[];
+    videoThumbnailUrl?: string;
+    videoUrl?: string;
+    articleImageUrl?: string;
+    articleUrl?: string;
+    mediaTypes: string[];
 }
 export declare function serializeLinkedInPosts(rawPosts: RawLinkedInPost[] | undefined, context: string): SerializedPost[];
 export declare function fetchLinkedInPosts(linkedinUrl: string, limit?: number): Promise<{

package/dist/tools/linkedin.js

@@ -157,14 +157,105 @@ function normalizePostUrl(post) {
         post.header?.linkedinUrl ||
         "");
 }
+function collectImageUrls(value, urls = new Set()) {
+    if (!value)
+        return urls;
+    if (typeof value === "string" && /^https?:\/\//i.test(value)) {
+        urls.add(value);
+        return urls;
+    }
+    if (Array.isArray(value)) {
+        for (const item of value)
+            collectImageUrls(item, urls);
+        return urls;
+    }
+    if (typeof value !== "object")
+        return urls;
+    const objectValue = value;
+    for (const key of ["url", "imageUrl", "thumbnailUrl", "thumbnail_url"]) {
+        const candidate = objectValue[key];
+        if (typeof candidate === "string" && /^https?:\/\//i.test(candidate)) {
+            urls.add(candidate);
+        }
+    }
+    if (objectValue.image)
+        collectImageUrls(objectValue.image, urls);
+    if (objectValue.images)
+        collectImageUrls(objectValue.images, urls);
+    return urls;
+}
+function pickString(value) {
+    return typeof value === "string" && value.trim() ? value.trim() : undefined;
+}
+function serializePostMedia(post) {
+    const media = post.media && typeof post.media === "object"
+        ? post.media
+        : {};
+    const content = post.content && typeof post.content === "object" ? post.content : {};
+    const article = post.article && typeof post.article === "object"
+        ? post.article
+        : content.article && typeof content.article === "object"
+            ? content.article
+            : {};
+    const video = post.postVideo && typeof post.postVideo === "object"
+        ? post.postVideo
+        : content.video && typeof content.video === "object"
+            ? content.video
+            : {};
+    const imageUrls = Array.from(collectImageUrls([
+        media.imageUrls,
+        post.postImages,
+        content.images,
+        article.image,
+    ]));
+    const videoThumbnailUrl = pickString(media.videoThumbnailUrl) ||
+        pickString(video.thumbnailUrl) ||
+        pickString(video.thumbnail_url) ||
+        pickString(video.thumbnail);
+    const videoUrl = pickString(media.videoUrl) ||
+        pickString(video.videoUrl) ||
+        pickString(video.video_url);
+    const articleImageUrl = pickString(media.articleImageUrl) ||
+        Array.from(collectImageUrls(article.image))[0];
+    const articleUrl = pickString(media.articleUrl) ||
+        pickString(article.link) ||
+        pickString(article.article_url) ||
+        pickString(article.articleUrl) ||
+        pickString(article.url);
+    const mediaTypes = Array.from(new Set([
+        ...(Array.isArray(media.mediaTypes)
+            ? media.mediaTypes.map((type) => typeof type === "string" ? type.trim() : "")
+            : []),
+        imageUrls.length > 0 ? "image" : "",
+        videoThumbnailUrl || videoUrl ? "video" : "",
+        articleImageUrl || articleUrl ? "article" : "",
+    ].filter(Boolean)));
+    if (imageUrls.length === 0 &&
+        !videoThumbnailUrl &&
+        !videoUrl &&
+        !articleImageUrl &&
+        !articleUrl) {
+        return undefined;
+    }
+    return {
+        imageUrls,
+        ...(videoThumbnailUrl ? { videoThumbnailUrl } : {}),
+        ...(videoUrl ? { videoUrl } : {}),
+        ...(articleImageUrl ? { articleImageUrl } : {}),
+        ...(articleUrl ? { articleUrl } : {}),
+        mediaTypes,
+    };
+}
 function serializeLinkedInPost(post) {
+    const media = serializePostMedia(post);
     return {
-        text: post.text || post.content || "",
+        text: post.text || (typeof post.content === "string" ? post.content : "") || "",
         date: normalizePostDate(post),
         reactions: post.reactionsCount ?? post.engagement?.likes ?? 0,
         comments: post.commentsCount ?? post.engagement?.comments ?? 0,
         url: normalizePostUrl(post),
         isRepost: Boolean(post.isRepublishedPost || post.repostedBy || post.repostedAt),
+        ...(media ? { media } : {}),
     };
 }
 function isUsableSerializedPost(post) {

package/dist/tools/prompts.js

@@ -363,9 +363,9 @@ export function getPostFindLeadsScoutRegistry() {
             reusePolicy: "The first completed Message Drafting 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/execution-slice identity mismatches or the initial output failed. If filters were chosen but leadScoringRubrics are not yet visible when the branch reads campaign state, Message Drafting must not wait, retry, or return blocked; missing saved rubrics are parent-owned filter setup, and the branch should return status ready with basisStatus usable_initial when campaign/list/table identity and the non-empty execution slice match. User copy feedback before approve-message is an explicit Message Drafting revision and must be routed back through the message branch with the current recommendation and basis.",
         },
         usage: {
-            codex: "After confirm_lead_list copies source rows and the initial campaign-table execution slice exists, ask the filter-choice question immediately. Do not spawn anything before that question. After the answer, launch only Message Drafting whenever Codex agent-launch policy is satisfied. The registry lookup is not a launch: after get_post_find_leads_scout_registry, immediately invoke Task/spawn_agent or the host background-agent mechanism before loading filter-leads.md or saving rubrics. If filters are chosen, the parent stays on Filter Rules and drafts/saves rubrics with MCP tools while Message Drafting runs in the background. If filters are skipped, move to Messages/message review after Message Drafting is ready. Treat YOLO/autonomous mode as campaign-scoped permission for this single post-import worker; do not ask for another permission click in YOLO. If the user has not enabled YOLO and has not explicitly asked for background agents/subagents/parallel agents/delegation/message bg agent in this campaign, ask once before loading the long message prompt in the parent. If permission is granted and the named Message Drafting custom agent is unavailable, spawn a generic gpt-5.5 xhigh Message Drafting background agent with the same lean campaign/table basis. If no background-agent tool is callable, start the same full message branch inline before filter drafting, or return blocked/retry-needed; do not wait until filters are saved and then call the registry.",
+            codex: "After confirm_lead_list copies source rows and the initial campaign-table execution slice exists, ask the filter-choice question immediately. Do not spawn anything before that question. After the answer, launch only Message Drafting whenever Codex agent-launch policy is satisfied. The registry lookup is not a launch: after get_post_find_leads_scout_registry, immediately invoke Task/spawn_agent or the host background-agent mechanism before loading filter-leads.md, before saving rubrics, and before treating skip-filters as ready for message review. Both choices route through this kickoff; do not let filters_skipped jump straight from filter-choice to message-generation. If filters are chosen, the parent stays on Filter Rules and drafts/saves rubrics with MCP tools while Message Drafting runs in the background. If filters are skipped, move to Messages/message review only after Message Drafting has started or is ready; update_campaign(currentStep=messages) is not proof of launch. Treat YOLO/autonomous mode as campaign-scoped permission for this single post-import worker; do not ask for another permission click in YOLO. If the user has not enabled YOLO and has not explicitly asked for background agents/subagents/parallel agents/delegation/message bg agent in this campaign, ask once before loading the long message prompt in the parent. If permission is granted and the named Message Drafting custom agent is unavailable, spawn a generic gpt-5.5 xhigh Message Drafting background agent with the same lean campaign/table basis. If no background-agent tool is callable, start the same full message branch inline before filter drafting or before skip-filter message review, or return blocked/retry-needed; do not wait until filters are saved and then call the registry.",
             claude: "After confirm_lead_list copies source rows and the initial campaign-table execution slice exists, ask the filter-choice question immediately. Do not invoke any Task/Agent before that question. After the answer, invoke only Message Drafting. If filters are chosen, parent drafts/saves rubrics with MCP tools while Message Drafting runs, asks filter approval, then joins Message Drafting. If filters are skipped, invoke only Message Drafting and move to Messages/message review.",
-            parentThreadRule: 'Named agents are optional acceleration, but message drafting is not optional. The only normal background worker is Message Drafting. YOLO/autonomous mode counts as campaign-scoped permission for this single post-import worker; do not ask for another permission click in YOLO. If a named agent is unavailable after permission, use a generic gpt-5.5 xhigh Message Drafting background agent. source work and filter work stay in the parent thread with MCP tools. If post-find-leads-message-scout is available, run it as the background Message Draft Builder after the filter-choice answer. The registry lookup is not a launch: get_post_find_leads_scout_registry only identifies the worker, and Message Drafting counts as started only after Task/spawn_agent or the host background-agent tool is invoked, or after the parent begins the same full message branch inline because no background-agent tool is callable. This launch must happen before loading filter-leads.md, save_rubrics, or filter approval. If post-find-leads-message-scout is absent, do not customer-surface install status. Do not silently fall back to parent-thread message drafting; the main thread must execute the same message branch from CampaignOffer state, selected source state, workflowTableId, and initial campaign-table execution slice rows. If no background-agent tool is callable, start that same full message branch inline before filter drafting, or return blocked/retry-needed; do not wait until filters are saved and then call the registry. The Message Drafting handoff must be lean. Do not paste copied row counts, brief hashes, review-batch hashes, full reviewBatchRowIds, broad row data, or local debug artifacts into the spawn prompt. Local markdown/json files are not normal-path inputs. The filter-choice question is the first post-import user gate; do not load post-lead registries or filter references before it. Message drafting starts after the filter-choice answer, must load get_subskill_prompt({ subskillName: "generate-messages" }), and must load every required message asset named by generate-messages Mode 0 through get_subskill_asset before drafting. Reference Asset Loading means loading the required pre-draft reference pack before drafting; return blocked/retry-needed if required assets cannot be loaded; load ai-tells.md because it is never optional. The branch loads the full generate-messages prompt and every referenced asset through get_subskill_asset. After generating/revising the candidate and before returning ready, must load get_subskill_prompt({ subskillName: "create-campaign-v2-validation" }) as the final internal validation gate, must read live campaign table state through scoped MCP/product tools, and must reject mismatched selectedLeadListId/workflowTableId/campaign/workspace input. Do not block when filters were chosen but leadScoringRubrics are not yet visible in the branch read; the parent owns save_rubrics and filter approval in parallel, so Message Drafting should return status ready with basisStatus usable_initial when the campaign/list/table and non-empty execution slice match. Do not use any alternate, local-artifact, or examples-only message prompt. User copy feedback, message QA, or rewrite requests before approve-message must be routed back to Message Drafting with the current recommendation, lean campaign/table basis, and latest user text; the parent must not rewrite or QA the template from memory and must not call update_campaign_brief before approve-message. The worker validates internally and returns only templateRecommendation, tokenFillRules, renderedGoodSample, status, approveOrReviseRecommendation, validationStatus, outputAt, outputHash, and blocked/retry detail. Do not render renderedFallbackSample, risk notes, or a qaReceipt on the normal happy path. On the filter path, save_rubrics keeps the browser on Filter Rules after save_rubrics so the user can approve the saved criteria; only then move to Filter Leads, show `Filters saved + waiting for message approval`, and wait there for message approval. Enrichment, filtering, Generate Message cells, sender setup, sequence attach, and launch wait for template approval on the Use Template path. On the skip path, move to Messages/message review after Message Drafting is ready and wait for message approval before enrichment or Settings. Do not render message review from checklist or shortcut instructions; message review requires a messageDraftRecommendation whose basis proves the generate-messages prompt, required message assets, and validation gate ran for the current campaign/table execution slice. Do not automatically rerun Message Drafting after filters/enrichment finish; show the initial draft by default and offer an enriched rewrite only with explicit user opt-in. Handoff and recommendation output are Markdown with labeled fields, not raw JSON.',
+            parentThreadRule: 'Named agents are optional acceleration, but message drafting is not optional. The only normal background worker is Message Drafting. YOLO/autonomous mode counts as campaign-scoped permission for this single post-import worker; do not ask for another permission click in YOLO. If a named agent is unavailable after permission, use a generic gpt-5.5 xhigh Message Drafting background agent. source work and filter work stay in the parent thread with MCP tools. If post-find-leads-message-scout is available, run it as the background Message Draft Builder after the filter-choice answer. The registry lookup is not a launch: get_post_find_leads_scout_registry only identifies the worker, and Message Drafting counts as started only after Task/spawn_agent or the host background-agent tool is invoked, or after the parent begins the same full message branch inline because no background-agent tool is callable. This launch must happen before loading filter-leads.md, save_rubrics, filter approval, or skip-filter message review; currentStep=messages is not proof of launch. If post-find-leads-message-scout is absent, do not customer-surface install status. Do not silently fall back to parent-thread message drafting; the main thread must execute the same message branch from CampaignOffer state, selected source state, workflowTableId, and initial campaign-table execution slice rows. If no background-agent tool is callable, start that same full message branch inline before filter drafting or before skip-filter message review, or return blocked/retry-needed; do not wait until filters are saved and then call the registry. The Message Drafting handoff must be lean. Do not paste copied row counts, brief hashes, review-batch hashes, full reviewBatchRowIds, broad row data, or local debug artifacts into the spawn prompt. Local markdown/json files are not normal-path inputs. The filter-choice question is the first post-import user gate; do not load post-lead registries or filter references before it. Message drafting starts after the filter-choice answer, must load get_subskill_prompt({ subskillName: "generate-messages" }), and must load every required message asset named by generate-messages Mode 0 through get_subskill_asset before drafting. Reference Asset Loading means loading the required pre-draft reference pack before drafting; return blocked/retry-needed if required assets cannot be loaded; load ai-tells.md because it is never optional. The branch loads the full generate-messages prompt and every referenced asset through get_subskill_asset. After generating/revising the candidate and before returning ready, must load get_subskill_prompt({ subskillName: "create-campaign-v2-validation" }) as the final internal validation gate, must read live campaign table state through scoped MCP/product tools, and must reject mismatched selectedLeadListId/workflowTableId/campaign/workspace input. Do not block when filters were chosen but leadScoringRubrics are not yet visible in the branch read; the parent owns save_rubrics and filter approval in parallel, so Message Drafting should return status ready with basisStatus usable_initial when the campaign/list/table and non-empty execution slice match. Do not use any alternate, local-artifact, or examples-only message prompt. User copy feedback, message QA, or rewrite requests before approve-message must be routed back to Message Drafting with the current recommendation, lean campaign/table basis, and latest user text; the parent must not rewrite or QA the template from memory and must not call update_campaign_brief before approve-message. The worker validates internally and returns only templateRecommendation, tokenFillRules, renderedGoodSample, status, approveOrReviseRecommendation, validationStatus, outputAt, outputHash, and blocked/retry detail. Do not render renderedFallbackSample, risk notes, or a qaReceipt on the normal happy path. On the filter path, save_rubrics keeps the browser on Filter Rules after save_rubrics so the user can approve the saved criteria; only then move to Filter Leads, show `Filters saved + waiting for message approval`, and wait there for message approval. Enrichment, filtering, Generate Message cells, sender setup, sequence attach, and launch wait for template approval on the Use Template path. On the skip path, move to Messages/message review after Message Drafting has started or is ready and wait for message approval before enrichment or Settings. Do not render message review from checklist or shortcut instructions; message review requires a messageDraftRecommendation whose basis proves the generate-messages prompt, required message assets, and validation gate ran for the current campaign/table execution slice. Do not automatically rerun Message Drafting after filters/enrichment finish; show the initial draft by default and offer an enriched rewrite only with explicit user opt-in. Handoff and recommendation output are Markdown with labeled fields, not raw JSON.',
             prepareMessagesRule: 'Default create-campaign stays on the existing reviewBatchLimit:15 first campaign-table execution slice. Only call start_campaign_message_preparation when the user explicitly asks for more prepared messages or a send count. For "prepare/generate X messages", set targetPreparedMessages:X, omit maxRowsToCheck so the backend calibrates on at least 100 rows, estimates the row budget from observed rubric/pass yield, caps maxRowsToCheck at 2500, and use approvalMode:mark_ready. After the calibration sample settles, the backend adapts later batches up to 250 rows while recalculating yield. Poll get_campaign_message_preparation_status and summarize preparation-job status: checked rows, passed/prepared/approved count, target, estimated row budget remaining, and stop reason. For "approve X messages", use approvalMode:approve but still do not launch. For "schedule X sends", use approvalMode:approve to approve exactly the bounded X-message cohort during preparation, then continue through sender, sequence, and final launch greenlight; final launch must verify that bounded cohort and must not broad approve-all. campaignId is CampaignOffer.id. If the user asks to stop preparation, the target is wrong, or status shows the wrong campaign/table, call cancel_campaign_message_preparation; otherwise do not cancel a healthy prepare run. cancel_campaign_message_preparation cancels the same pending workflow-table cells as the UI Cancel Pending Cells action. Low-level selectors are diagnostics and recovery only for this lane. start_campaign remains forbidden until final launch greenlight.',
         },
     };

package/package.json

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

package/skills/create-campaign/SKILL.md

@@ -427,12 +427,15 @@ After confirmed source rows exist in the campaign table, do not load the
 message registry or any deep filter/message prompt
 before the filter-choice question. After `confirm_lead_list`, ask add filters
 vs skip filters immediately. Once the user answers, launch only Message Drafting
-from the same campaign/table basis. If the user chooses filters, the parent
+from the same campaign/table basis. This kickoff is required for both answers:
+`Use filters` and `Skip filters`. If the user chooses filters, the parent
 thread moves to Filter Rules, loads the filter reference, saves rubrics, then
 asks for filter approval while Message Drafting runs. After approval, move to
 Filter Leads and show `Filters saved + waiting for message approval` while the
-message recommendation is reviewed. If the user skips filters, move to
-Messages/message review. Enrichment/filtering and Generate Message cells wait
+message recommendation is reviewed. If the user skips filters, start Message
+Drafting first, then move to Messages/message review after it has started or
+returned a ready recommendation. `update_campaign({ currentStep: "messages" })`
+is not proof of kickoff. Enrichment/filtering and Generate Message cells wait
 for message approval. AI Generated is an explicit opt-out from the template
 path.
 
@@ -915,11 +918,12 @@ updates.
 3. Follow that prompt and workflow config exactly.
 4. For filter and message setup, keep the parent thread as a lean orchestrator.
    The only normal background agent is `post-find-leads-message-scout` for
-   Message Drafting. When filters are chosen, launch Message Drafting, then keep
-   filters in the parent thread: load `references/filter-leads.md`, draft
-   production rubrics, call `save_rubrics`, ask filter approval, and then join
-   Message Drafting for template review. When filters are skipped, launch only
-   Message Drafting.
+   Message Drafting. Both post-import choices must launch Message Drafting.
+   When filters are chosen, launch Message Drafting, then keep filters in the
+   parent thread: load `references/filter-leads.md`, draft production rubrics,
+   call `save_rubrics`, ask filter approval, and then join Message Drafting for
+   template review. When filters are skipped, launch only Message Drafting
+   before treating the campaign as in Messages/message review.
 5. For message generation, keep the parent thread as a lean orchestrator and
    use the `post-find-leads-message-scout` compatibility agent for Message
    Drafting whenever the host exposes it
@@ -968,10 +972,12 @@ updates.
    After rubrics save, keep Filter Rules visible for approval; after approval,
    move to Filter Leads and show `Filters saved + waiting for message approval`
    until the template is approved.
-   If filters are skipped, move to Messages/message review. Queue the bounded
-   campaign-table execution-slice `enrichCellId` cells only after message approval. Move to
-   Messages only after at least one review row passes and one generated message
-   is ready.
+   If filters are skipped, launch Message Drafting before moving to
+   Messages/message review; updating `currentStep` to `messages` is not proof
+   that the background worker started. Queue the bounded campaign-table
+   execution-slice `enrichCellId` cells only after message approval. Move to the
+   generated-row Messages review only after at least one review row passes and
+   one generated message is ready.
    Do not ask the user to approve the brief before shell creation unless they
    explicitly requested a no-write draft; the shell itself is the review surface.
 7. The main thread owns watch navigation. Call

package/skills/create-campaign-v2/SKILL.md

@@ -293,11 +293,11 @@ customer-facing source-choice labels.
 
 ## Prospect Setup Workstreams
 
-After `confirm_lead_list` copies a non-empty source into the campaign and records the compact review batch, ask the filter-choice question immediately. Do not call `get_post_find_leads_scout_registry`, load filter/message prompts, or spawn Message Drafting before that question. Customer-facing work before the question: short setup summary plus add filters, skip filters, or revise source; no extra watch link.
+After `confirm_lead_list` copies source rows and records the review batch, ask the filter-choice question immediately. Do not call `get_post_find_leads_scout_registry`, load filter/message prompts, or spawn Message Drafting before that question. Before the question: short setup summary plus add filters, skip filters, or revise source; no extra watch link.
 
-After filter choice, the only normal background worker is Message Drafting (`post-find-leads-message-scout`). The registry lookup is not a launch. Call the registry, then start Message Drafting via `Task`, `spawn_agent`, or host equivalent before loading `references/filter-leads.md` or `save_rubrics`. YOLO already grants permission; do not ask for another permission click. If no background tool is callable, start the same full branch inline before filter drafting or return `blocked` / `retry-needed`. Do not wait until filters are saved and then call the registry.
+After filter choice, the only normal background worker is Message Drafting (`post-find-leads-message-scout`). The registry lookup is not a launch. Both choices must run this kickoff: call the registry, then start Message Drafting via `Task`, `spawn_agent`, or host equivalent before filter refs, `save_rubrics`, or skip review. YOLO already grants permission; do not ask for another permission click. If no background tool is callable, start the same full branch inline before filter drafting or skip review, or return `blocked` / `retry-needed`. `update_campaign({ currentStep: "messages" })` is not proof of kickoff.
 
-The parent thread is the orchestrator and the filter writer. On the filters path, start Message Drafting, then load `references/filter-leads.md`, save rubrics, and ask users to approve saved criteria. Keep `currentStep` on Filter Rules and show `Filters saved + waiting for message approval`; do not queue cells until message approval. Tell the user Message Drafting is preparing the template in the background.
+The parent thread is the orchestrator and the filter writer. On the filters path, start Message Drafting, load `references/filter-leads.md`, save rubrics, and ask users to approve saved criteria. Keep `currentStep` on Filter Rules and show `Filters saved + waiting for message approval`; do not queue cells until message approval. Tell the user Message Drafting is preparing the template in the background.
 
 Message Drafting must not wait for `save_rubrics` or require visible
 `leadScoringRubrics` before returning a reusable template. The parent waits for

package/skills/create-campaign-v2/SOUL.md

@@ -296,10 +296,12 @@ For prospect setup work, call `get_post_find_leads_scout_registry` after
 the user chooses filters, not before the filter-choice question. After
 `confirm_lead_list` copies source rows and records the first review/process
 sample, ask add-filters vs skip-filters immediately. After the answer, launch
-only Message Drafting (`post-find-leads-message-scout`). If the user chooses
-filters, the parent thread keeps the browser on Filter Rules, loads the filter
-reference, drafts/saves rubrics with MCP tools, and asks for filter approval
-while Message Drafting runs.
+only Message Drafting (`post-find-leads-message-scout`). This applies to both
+answers: the skip-filters path still routes through the Message Drafting
+kickoff before it enters message review. `update_campaign` to Messages is not a
+worker launch. If the user chooses filters, the parent thread keeps the browser
+on Filter Rules, loads the filter reference, drafts/saves rubrics with MCP
+tools, and asks for filter approval while Message Drafting runs.
 
 The parent thread is the orchestrator and the filter writer. On the filters path
 it must verify `save_rubrics`, keep the browser on Filter Rules, and ask for