@sellable/mcp 0.1.909 → 0.1.911

package/dist/tools/direct-campaigns.js

@@ -35,7 +35,7 @@ function sanitizeForCampaign(text) {
 export const directCampaignToolDefinitions = [
     {
         name: "add_to_inmail_campaign",
-        description: "Add leads to a sender's InMail direct campaign table (dedupes by default). Auto-creates the table if missing.",
+        description: "Add leads with caller-authored Subject and Message copy to a sender's direct InMail execution queue. This is the canonical one-off InMail path when recipients and exact copy are already known; it auto-creates the correctly typed table and dedupes by default. Do not create a normal campaign or a Generate Message column for this shape.",
         inputSchema: {
             type: "object",
             properties: {
@@ -63,7 +63,7 @@ export const directCampaignToolDefinitions = [
     },
     {
         name: "add_to_connection_campaign",
-        description: "Add leads to a sender's Connection direct campaign table (dedupes by default). Auto-creates the table if missing.",
+        description: "Add leads with caller-authored Message copy to a sender's direct Connection execution queue. This is the canonical one-off connection-plus-DM path when recipients and exact copy are already known; it auto-creates the correctly typed table and dedupes by default.",
         inputSchema: {
             type: "object",
             properties: {
@@ -158,7 +158,7 @@ export const directCampaignToolDefinitions = [
     },
     {
         name: "start_direct_campaign",
-        description: "Start a direct campaign for a sender (sets status to ACTIVE).",
+        description: "Start the sender's canonical direct campaign after its rows/copy are reviewed and the user explicitly approves launch (sets status to ACTIVE). Use the same type passed to the add tool. Do not use start_campaign for a table created by add_to_inmail_campaign or add_to_connection_campaign.",
         inputSchema: {
             type: "object",
             properties: {
@@ -200,7 +200,7 @@ export const directCampaignToolDefinitions = [
     },
     {
         name: "get_or_create_direct_campaign_table",
-        description: "Get or create the direct campaign workflow table for a sender and type (comment_campaign, inmail_campaign, connection_campaign, post_campaign). Returns the tableId and whether it was created.",
+        description: "Inspect or explicitly create the canonical direct campaign workflow table for a sender and type (comment_campaign, inmail_campaign, connection_campaign, post_campaign). Usually call the matching add_to_* tool instead because it creates the table and rows together. Returns the tableId and whether it was created.",
         inputSchema: {
             type: "object",
             properties: {

package/dist/tools/one-off.js

@@ -73,7 +73,7 @@ export const onDemandToolDefinitions = [
     },
     {
         name: "create_on_demand_campaign",
-        description: "Create a lightweight CampaignOffer + workflow table, set senders, and initialize sequence columns. Auto-selects template by sender tiers unless provided.\n\n" +
+        description: "Create a lightweight general CampaignOffer + workflow table, set senders, and initialize sequence columns. This is not the caller-authored direct InMail path: when exact recipients, Subject, and Message are already supplied, use add_to_inmail_campaign and start_direct_campaign instead. Auto-selects template by sender tiers unless provided.\n\n" +
             "INPUTS: Pass EITHER clientProspectId (existing prospect ID) OR senderLinkedinUrl (sender's LinkedIn profile URL). One is required.",
         inputSchema: {
             type: "object",
@@ -149,7 +149,7 @@ export const onDemandToolDefinitions = [
     },
     {
         name: "start_on_demand_campaign",
-        description: "Start an on-demand campaign table (set campaignStatus ACTIVE).",
+        description: "Start a general on-demand campaign table (set campaignStatus ACTIVE). Do not use this for a typed direct InMail/Connection table; use start_direct_campaign with the matching type.",
         inputSchema: {
             type: "object",
             properties: {

package/dist/tools/refill-executors.js

@@ -1942,9 +1942,45 @@ export async function broadenSignalSearch(action, workspaceId) {
                         name: campaign.name ?? "",
                     },
                 }, requestOptions);
+                const estimates = estimateResponse.estimates ?? [];
+                const estimatedPostIds = new Set(estimates
+                    .map((estimate) => stringValue(estimate.postId))
+                    .filter((postId) => Boolean(postId)));
+                const reportedUnavailablePosts = (estimateResponse.unavailablePosts ?? []).flatMap((entry) => {
+                    const postId = stringValue(entry.postId);
+                    if (!postId)
+                        return [];
+                    return [
+                        {
+                            postId,
+                            reason: stringValue(entry.reason) ?? "evaluation_unavailable",
+                        },
+                    ];
+                });
+                const reportedUnavailablePostIds = new Set(reportedUnavailablePosts.map((entry) => entry.postId));
+                const missingEstimatePosts = candidates.flatMap((candidate) => estimatedPostIds.has(candidate.postId) ||
+                    reportedUnavailablePostIds.has(candidate.postId)
+                    ? []
+                    : [{ postId: candidate.postId, reason: "missing_estimate" }]);
+                const unavailablePosts = [
+                    ...reportedUnavailablePosts,
+                    ...missingEstimatePosts,
+                ];
+                if (unavailablePosts.length > 0) {
+                    return {
+                        candidatePostCount: candidates.length,
+                        engagerSum: 0,
+                        observedPassRate: 0,
+                        projectedYield: 0,
+                        floor: Math.min(SIGNAL_YIELD_FLOOR_CAP, Math.max(1, remainingPrepGap)),
+                        scrapePostIds: [],
+                        carriedPostIds: [],
+                        evaluationUnavailable: { posts: unavailablePosts },
+                    };
+                }
                 const sampled = selectRefillV3SignalPostsFromSamples({
                     candidates,
-                    estimates: estimateResponse.estimates ?? [],
+                    estimates,
                     maxPosts: scrapeCap,
                 });
                 postYieldSamples = sampled.samples;
@@ -1970,6 +2006,34 @@ export async function broadenSignalSearch(action, workspaceId) {
                 remainingPrepGap,
                 maxPosts: maxPostsToScrape,
             });
+        const evaluationUnavailable = "evaluationUnavailable" in yieldProjection
+            ? recordValue(yieldProjection.evaluationUnavailable)
+            : null;
+        if (evaluationUnavailable) {
+            const runScopedCleanup = await cleanupRunScopedDerivedTabs();
+            return {
+                status: "refused",
+                refusalReason: "signal_post_icp_evaluation_unavailable: one or more candidate posts lacked a complete headline-ICP evaluation; no qualification or exhaustion receipt was recorded",
+                result: {
+                    class: "source_retryable",
+                    code: "signal_post_icp_evaluation_unavailable",
+                    retryable: true,
+                    universeExhausted: false,
+                    campaignOfferId,
+                    keywordSource: effectiveKeywordSource,
+                    keywordsTried: searchKeywords,
+                    usedKeywords,
+                    searchedKeywords: negativeList,
+                    excludedPostIds,
+                    candidatePostCount: yieldProjection.candidatePostCount,
+                    unavailablePosts: Array.isArray(evaluationUnavailable.posts)
+                        ? evaluationUnavailable.posts
+                        : [],
+                    searchSummary,
+                    runScopedCleanup,
+                },
+            };
+        }
         const noQualifyingV3Post = isRefillV3SinglePassAction(action) &&
             yieldProjection.scrapePostIds.length === 0;
         if (noQualifyingV3Post ||

package/package.json

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

package/skills/create-campaign/SKILL.md

@@ -77,6 +77,10 @@ allowed-tools:
   - mcp__sellable__attach_sequence
   - mcp__sellable__attach_recommended_sequence
   - mcp__sellable__start_campaign
+  - mcp__sellable__add_to_inmail_campaign
+  - mcp__sellable__add_to_connection_campaign
+  - mcp__sellable__get_or_create_direct_campaign_table
+  - mcp__sellable__start_direct_campaign
 ---
 
 # Sellable Create Campaign
@@ -86,6 +90,30 @@ It bootstraps auth and host capabilities, then loads the internal
 the internal campaign workflow prompt and `core/flow.v2.json` through MCP. Keep
 this wrapper thin; the packaged workflow is the operational source of truth.
 
+## Direct Manual-Copy Campaign Routing
+
+Route a bounded one-off request to the direct campaign tools when the user
+already supplies the recipients and exact message copy. For InMail, require a
+LinkedIn URL, Subject, and Message per row, select the intended sender, then use
+`add_to_inmail_campaign`. For a connection-plus-DM request, use
+`add_to_connection_campaign`. These tools create or reuse the canonical typed
+execution-queue table; do not call `create_campaign`,
+`create_on_demand_campaign`, or a connection helper first.
+
+Do not create a normal Campaign Builder Generate Message column, rewrite the
+approved manual copy, or repair the typed direct table merely because its
+message is stored in a plain `Message` text column. That is the owned schema for
+`inmail_campaign` and `connection_campaign` tables.
+
+Show the bounded recipients and exact copy for review before adding rows. Never
+call `start_direct_campaign` until the user explicitly approves launch. When
+approved, start the same direct type used by the add tool; do not call
+`start_campaign` for that table.
+
+Billing diagnostics are not launch authority. Honor a billing error returned by
+the actual add/start mutation, but never interpret `billing_required`
+diagnostics as an enforced block when the billing rollout gate is disabled.
+
 ## Inbox Reply Tool Boundary
 
 Inbox reply tools are outside campaign creation. If a user asks to search,
@@ -291,6 +319,7 @@ only from a source that can describe this turn:
   context. Do not infer an ID from the friendly name, do not infer effort from
   `alwaysThinkingEnabled`, and do not show this self-report to the user during
   normal campaign setup.
+
 - Do not run a nested `claude -p`, inspect `~/.claude/settings.json`, or read
   Claude CLI defaults as proof of the user's active Claude Code session. Those
   checks can validate a new child session or saved defaults, but not this