@sellable/mcp 0.1.475 → 0.1.477

package/dist/tools/refill-sends.js

@@ -1,5 +1,7 @@
 import { getRefillTargetPlan } from "./refill-target-plan.js";
 import { refreshPaidInmailCredits } from "./senders.js";
+import { startPrepareCampaignMessages } from "./campaign-message-preparation.js";
+import { confirmLeadList } from "./leads.js";
 const DEFAULT_SCHEDULER_FORWARD_HOURS = 48;
 function normalizeStrings(values) {
     if (!Array.isArray(values))
@@ -58,7 +60,7 @@ function normalizeTargetDate(value) {
 export const refillSendsToolDefinitions = [
     {
         name: "refill_sends",
-        description: "Typed command entrypoint for Sellable refill sends. Accepts --yolo semantics and optional sender selectors, then returns the bounded execution contract for the skill-led refill workflow. In --yolo, it may refresh stale paid InMail credit cache facts for exact selected senders once, then rerun and return the post-refresh target plan. This tool does not mutate campaigns, import leads, approve messages, schedule sends, launch, archive, delete, or write scheduler rows.",
+        description: "Typed command entrypoint for Sellable refill sends. Accepts --yolo semantics and optional sender selectors, then returns the bounded execution contract for the skill-led refill workflow. In --yolo, it may refresh stale paid InMail credit cache facts once, or execute exactly one safe primitive from target.globalActionQueue[0] (bounded existing-row preparation, bounded same-source copy, or read-only wait) and reread. It does not approve messages without the bounded approval gate, lower paid InMail thresholds, switch source families, create campaigns, schedule sends, launch, archive, delete, or write scheduler rows.",
         inputSchema: {
             type: "object",
             properties: {
@@ -197,7 +199,7 @@ export function refillSendsCommand(input = {}) {
             "Render target.eligibleSenderLedger and target.senderRefillPlans before mutation. Preserve the coverage labels Need to prepare, Goal, Already sent, Scheduled, Ready and waiting to be scheduled, and Still need.",
             "Use target.globalActionQueue as the only cross-sender yolo queue: execute only target.globalActionQueue[0], one globally ranked primitive, then rerun get_refill_target_plan before choosing another action.",
             "If get_refill_target_plan returns status complete, report eligible sender ledger, target.senderRefillPlans, gross target, selected days, sent count, scheduled count, projected count, campaign ids, targetShapeRevision, and no-op proof without asking for approval.",
-            "Refill target lanes are only connection invites (send_invite) or paid InMails (send_inmail_closed). Do not count send_dm or send_inmail_open as horizon target capacity; they may exist in sequences, but the planner must pick the refill lane from the most recent active campaign-backed send evidence for each sender.",
+            "Refill target lanes are connection invites (send_invite), standalone paid InMails (send_inmail_closed), or unified Sales Nav cascades represented publicly as send_inmail_closed with campaign classification sales_nav_cascade. For a Sales Nav cascade, refill the selected campaign first; its sequence can route prospects to Open InMail, paid InMail while fresh credits are >= 5, or same-campaign connection fallback without asking for separate open/paid/connection campaigns. Do not count send_dm as horizon target capacity.",
             "If remainingReadyOrProjectedGap is 0 but remainingProjectedGap is positive, run only a persistent read-only scheduler wait/reread loop; do not ask for prep/import/approval and do not close out while scheduler pickup is the only remaining state.",
             `Resolve route with resolve_campaign_fill_route({ intent: "${intent}"${input.campaignId ? `, campaignId: "${input.campaignId}"` : ""}${input.tableId ? `, tableId: "${input.tableId}"` : ""} }).`,
             'If the plain route shows stale managed waterfall evidence, archived/completed shared slots, or targets that do not cover the selected sender set, immediately call resolve_campaign_fill_route({ intent: "active" }) and inspect current dashboard-active ACTIVE/PAUSED campaign-backed sequence campaigns before declaring a sender blocked.',
@@ -213,14 +215,14 @@ export function refillSendsCommand(input = {}) {
             "Treat current dashboard-active PAUSED campaign-backed sequence campaigns as start-eligible candidates: read refill state before deciding whether to prep, approve, start, or skip.",
             "Fresh reread get_campaign_refill_state immediately before any import, prep, approval, or horizon-fill mutation.",
             "Maintain a target-window saturation ledger per selected sender from get_refill_target_plan: selected days, gross capacity, actual sent counts, future scheduler-owned scheduled counts, projected counts, ready-to-schedule buffer, remaining projected gap, paid InMail threshold feasibility, targetShapeRevision, stateRevision, and next MCP primitive.",
-            "In --yolo, this tool automatically maintains a run-local refreshedPaidInmailSenderIds set: when the first target plan returns refresh_paid_inmail_credits candidates for selected paid-InMail lanes, it refreshes each exact sender at most once, reruns get_refill_target_plan, and returns the post-refresh targetPlan before any prep/import/approval/start action is chosen.",
+            "In --yolo, this tool automatically maintains a run-local refreshedPaidInmailSenderIds set: when the first target plan returns refresh_paid_inmail_credits candidates for selected paid-InMail lanes, it refreshes each exact sender at most once, reruns get_refill_target_plan, and returns the post-refresh targetPlan before any prep/source-copy/read-only wait action is chosen.",
             "Do not present paid-credit refresh as the next operator action after refill_sends returns autoPaidInmailRefresh and the post-refresh targetPlan.",
-            "If paid InMail feasibility remains below threshold after that automatic refresh, report the exact sender/campaign/table/column threshold action or connection fallback; --yolo must not lower paid InMail thresholds or create campaigns.",
+            "If paid InMail feasibility remains below threshold after that automatic refresh, report the exact sender/campaign/table/column threshold action or same-campaign connection fallback; --yolo must not lower paid InMail thresholds or create campaigns.",
             "In --yolo or after one Accept, continue through every safe selected sender/campaign action covered by the rendered target packet; sent/scheduled-count progress changes stateRevision and should continue while targetShapeRevision is stable.",
             "Do not complete a fill/schedule request until a final get_refill_target_plan or refill-state reread proves projected coverage (sent + scheduled) fills the scheduler-forward target window. Treat awaiting_scheduler_after_ready_buffer as loaded, awaiting scheduler when ready buffer covers the gap; do not import/prep more rows in that state, and keep polling unless Christian stops/statuses the run or a concrete non-scheduler blocker such as paid_inmail_below_threshold appears.",
         ],
         approvalContract: yolo
-            ? "Auto-accept only the rendered bounded refill target packet after get_refill_target_plan and fresh reread. Execute one globally ranked primitive from target.globalActionQueue at a time, then rerun get_refill_target_plan before taking another action. Continue through every safe apply/prep/start action inside that packet, including start_campaign only for exact selected PAUSED campaign-backed sequence refill targets named in the packet. After each action, rerun get_refill_target_plan; keep going while targetShapeRevision is stable and projected coverage (sent + scheduled) progresses toward the target, even though stateRevision changes. Ready-to-schedule rows are buffer, not completion. If ready buffer covers the projected gap, use only persistent read-only scheduler wait/reread and keep the run open until projected coverage fills or Christian stops/statuses it. Stop immediately if targetShapeRevision changes because sender set, route, ids, caps, dates, blockers, action class, paid InMail threshold feasibility, or side-effect class drifts. --yolo does not authorize lowering paid InMail thresholds or creating connection campaigns."
+            ? "Auto-accept only the rendered bounded refill target packet after get_refill_target_plan and fresh reread. Execute one globally ranked primitive from target.globalActionQueue at a time, then rerun get_refill_target_plan before taking another action. Continue through every safe prep/source-copy/read-only wait action inside that packet. Approval, start_campaign, source-family switches, threshold changes, and campaign creation require their own explicit gates. After each safe action, rerun get_refill_target_plan; keep going while targetShapeRevision is stable and projected coverage (sent + scheduled) progresses toward the target, even though stateRevision changes. Ready-to-schedule rows are buffer, not completion. If ready buffer covers the projected gap, use only persistent read-only scheduler wait/reread and keep the run open until projected coverage fills or Christian stops/statuses it. Stop immediately if targetShapeRevision changes because sender set, route, ids, caps, dates, blockers, action class, paid InMail threshold feasibility, or side-effect class drifts. --yolo does not authorize lowering paid InMail thresholds or creating connection campaigns."
             : hasSenderSelectors
                 ? "Before mutation, post the full bounded refill packet in normal chat as Markdown, including workspace, sender scope, campaign table, exact ids, caps/dates, gross target, sent count, scheduled count, projected count, ready buffer, remaining projected gap, paid InMail threshold feasibility, targetShapeRevision/stateRevision, side effects, forbidden actions, and stop condition. Then ask the final Accept/Decline structured approval question with a compact body that refers back to the posted packet instead of duplicating it. Only ask when get_refill_target_plan reports a positive remaining projected/ready gap. If target is complete by projected coverage, no-op without approval. If ready buffer covers the projected gap, run only persistent read-only scheduler wait/reread and keep the run open until projected coverage fills or Christian stops/statuses it. Threshold changes and campaign creation need separate explicit approval."
                 : "Ask which eligible enrolled senders to refill first, then, before mutation, post the full bounded refill packet in normal chat as Markdown and ask the final Accept/Decline structured approval question with a compact body that refers back to the posted packet.",
@@ -302,6 +304,14 @@ function recordValue(value) {
 function stringValue(value) {
     return typeof value === "string" && value.trim() ? value.trim() : null;
 }
+function numberValue(value) {
+    return typeof value === "number" && Number.isFinite(value) ? value : null;
+}
+function stringArray(value) {
+    if (!Array.isArray(value))
+        return [];
+    return value.filter((item) => typeof item === "string");
+}
 function paidRefreshActionFrom(value) {
     const action = recordValue(value);
     if (!action || action.type !== "refresh_paid_inmail_credits")
@@ -349,6 +359,121 @@ function collectPaidInmailRefreshActions(plan) {
         add(action);
     return [...bySender.values()];
 }
+function firstGlobalAction(plan) {
+    const root = recordValue(plan);
+    const target = recordValue(root?.target);
+    const globalActionQueue = Array.isArray(target?.globalActionQueue)
+        ? target.globalActionQueue
+        : [];
+    const [first] = globalActionQueue;
+    return recordValue(first);
+}
+function actionIds(action) {
+    return recordValue(action.ids) ?? {};
+}
+function actionToolInput(action) {
+    return recordValue(action.toolInput) ?? {};
+}
+function actionCampaignId(action) {
+    const ids = actionIds(action);
+    const toolInput = actionToolInput(action);
+    return (stringValue(toolInput.campaignId) ??
+        stringValue(toolInput.campaignOfferId) ??
+        stringValue(ids.campaignId) ??
+        stringValue(action.campaignId));
+}
+function actionTableId(action) {
+    const ids = actionIds(action);
+    const toolInput = actionToolInput(action);
+    return (stringValue(toolInput.tableId) ??
+        stringValue(ids.tableId) ??
+        stringValue(action.tableId));
+}
+function actionSourceLeadListId(action) {
+    const ids = actionIds(action);
+    const toolInput = actionToolInput(action);
+    return (stringValue(toolInput.sourceLeadListId) ??
+        stringValue(ids.sourceLeadListId) ??
+        stringValue(action.sourceLeadListId));
+}
+async function executeOneYoloPrimitive(action) {
+    if (!action)
+        return { status: "no_action" };
+    if (action.yoloEligible === false) {
+        return {
+            status: "refused",
+            refusalReason: "first global action is not yolo eligible",
+        };
+    }
+    switch (action.type) {
+        case "wait_for_scheduler":
+        case "wait_for_active_work":
+        case "wait_for_source_import":
+            return { status: "read_only_reread", result: { waited: true } };
+        case "prepare_messages": {
+            const campaignId = actionCampaignId(action);
+            const tableId = actionTableId(action) ?? undefined;
+            const toolInput = actionToolInput(action);
+            const targetPreparedMessages = numberValue(toolInput.targetPreparedMessages);
+            const approvalMode = toolInput.approvalMode === "approve" ? "approve" : "mark_ready";
+            if (!campaignId || !targetPreparedMessages || targetPreparedMessages <= 0) {
+                return {
+                    status: "refused",
+                    refusalReason: "prepare_messages action is missing campaignId or bounded targetPreparedMessages",
+                };
+            }
+            const result = await startPrepareCampaignMessages({
+                campaignId,
+                tableId,
+                targetPreparedMessages,
+                approvalMode,
+                autoContinue: true,
+            });
+            return { status: "executed_and_reread", result };
+        }
+        case "copy_selected_source_rows": {
+            const campaignOfferId = actionCampaignId(action);
+            const sourceLeadListId = actionSourceLeadListId(action);
+            const toolInput = actionToolInput(action);
+            const sourceRowIds = stringArray(toolInput.sourceRowIds);
+            const sourceRowLimit = numberValue(toolInput.sourceRowLimit);
+            const sourceFingerprint = stringValue(toolInput.sourceFingerprint) ??
+                stringValue(actionIds(action).sourceFingerprint);
+            if (!campaignOfferId || !sourceLeadListId || !sourceFingerprint) {
+                return {
+                    status: "refused",
+                    refusalReason: "copy_selected_source_rows action is missing campaignOfferId, sourceLeadListId, or sourceFingerprint",
+                };
+            }
+            if (sourceRowIds.length === 0 && (!sourceRowLimit || sourceRowLimit <= 0)) {
+                return {
+                    status: "refused",
+                    refusalReason: "copy_selected_source_rows action is missing exact sourceRowIds or a bounded sourceRowLimit",
+                };
+            }
+            const result = await confirmLeadList({
+                campaignOfferId,
+                sourceLeadListId,
+                currentStep: null,
+                confirmed: true,
+                sourceRowIds: sourceRowIds.length > 0 ? sourceRowIds : undefined,
+                sourceRowLimit: sourceRowIds.length > 0 ? undefined : sourceRowLimit ?? undefined,
+                reviewBatchLimit: sourceRowIds.length > 0 ? sourceRowIds.length : sourceRowLimit ?? undefined,
+            });
+            return { status: "executed_and_reread", result };
+        }
+        case "approve_messages":
+            return {
+                status: "refused",
+                refusalReason: "approve_messages requires the bounded approval mutation gate; refill_sends yolo will not treat select_campaign_cells as approval",
+            };
+        default:
+            return {
+                status: "refused",
+                refusalReason: `action ${String(action.type)} is not a safe yolo primitive`,
+            };
+    }
+}
 export async function executeRefillSendsCommand(input = {}) {
     const command = refillSendsCommand(input);
     if (input.yolo !== true) {
@@ -361,6 +486,12 @@ export async function executeRefillSendsCommand(input = {}) {
                 failedPaidInmailRefreshes: [],
                 note: "Automatic paid InMail credit refresh only runs for --yolo refill_sends calls.",
             },
+            yoloExecution: {
+                enabled: false,
+                status: "not_run_without_yolo",
+                selectedAction: null,
+                targetPlanReread: false,
+            },
         };
     }
     const targetPlanInput = targetPlanInputFor(input);
@@ -391,10 +522,21 @@ export async function executeRefillSendsCommand(input = {}) {
     const targetPlan = refreshActions.length > 0
         ? await getRefillTargetPlan(targetPlanInput)
         : targetPlanBeforePaidRefresh;
+    const selectedAction = refreshActions.length > 0 ? null : firstGlobalAction(targetPlan);
+    const primitiveAttempt = refreshActions.length > 0
+        ? null
+        : await executeOneYoloPrimitive(selectedAction);
+    const shouldRereadAfterPrimitive = primitiveAttempt?.status === "executed_and_reread" ||
+        primitiveAttempt?.status === "read_only_reread";
+    const postActionTargetPlan = shouldRereadAfterPrimitive
+        ? await getRefillTargetPlan(targetPlanInput)
+        : null;
+    const finalTargetPlan = postActionTargetPlan ?? targetPlan;
     return {
         ...command,
-        targetPlan,
+        targetPlan: finalTargetPlan,
         targetPlanBeforePaidRefresh: refreshActions.length > 0 ? targetPlanBeforePaidRefresh : null,
+        targetPlanBeforeYoloPrimitive: refreshActions.length === 0 && postActionTargetPlan ? targetPlan : null,
         autoPaidInmailRefresh: {
             enabled: true,
             status: refreshActions.length === 0
@@ -411,5 +553,23 @@ export async function executeRefillSendsCommand(input = {}) {
                 ? "refill_sends refreshed stale paid InMail credit facts internally, once per sender, then returned the post-refresh targetPlan."
                 : "No stale or missing paid InMail credit refresh candidates were present in the initial target plan.",
         },
+        yoloExecution: refreshActions.length > 0
+            ? {
+                enabled: true,
+                status: "skipped_after_paid_refresh",
+                selectedAction: null,
+                targetPlanReread: true,
+            }
+            : {
+                enabled: true,
+                status: primitiveAttempt?.status ?? "no_action",
+                selectedAction,
+                result: primitiveAttempt?.result,
+                targetPlanReread: shouldRereadAfterPrimitive,
+                refusalReason: primitiveAttempt?.refusalReason,
+                postActionFirstAction: postActionTargetPlan
+                    ? firstGlobalAction(postActionTargetPlan)
+                    : null,
+            },
     };
 }

package/dist/tools/refill-target-plan.js

@@ -9,6 +9,13 @@ const SAFE_PACKET_ACTION_TYPES = new Set([
     "approve_messages",
     "start_paused_campaign",
     "wait_for_scheduler",
+    "wait_for_active_work",
+    "wait_for_source_import",
+    "copy_selected_source_rows",
+    "continue_signal_discovery_source",
+    "continue_sales_nav_source",
+    "continue_prospeo_source",
+    "manual_source_replenishment",
     "refresh_paid_inmail_credits",
     "lower_paid_inmail_threshold",
     "switch_to_connection_lane",
@@ -18,6 +25,10 @@ const MANUAL_ONLY_PACKET_ACTION_TYPES = new Set([
     "lower_paid_inmail_threshold",
     "switch_to_connection_lane",
     "create_connection_campaign",
+    "continue_signal_discovery_source",
+    "continue_sales_nav_source",
+    "continue_prospeo_source",
+    "manual_source_replenishment",
 ]);
 const SOURCE_PLAN_STATES = new Set([
     "not_needed",
@@ -26,6 +37,8 @@ const SOURCE_PLAN_STATES = new Set([
     "needs_signal_import",
     "waiting_for_import",
     "needs_confirm",
+    "needs_same_source_copy",
+    "needs_provider_continuation",
     "source_shortfall",
     "provider_exhausted",
     "provider_missing",
@@ -57,6 +70,9 @@ function stringValue(value) {
 function booleanValue(value) {
     return typeof value === "boolean" ? value : undefined;
 }
+function campaignClassificationValue(value) {
+    return value === "sales_nav_cascade" ? "sales_nav_cascade" : undefined;
+}
 function stringArray(value) {
     if (!Array.isArray(value))
         return [];
@@ -149,6 +165,16 @@ function sanitizeActionCandidate(candidate) {
         tableId: stringValue(candidate.tableId),
         tableName: stringValue(candidate.tableName) ?? null,
         columnId: stringValue(candidate.columnId) ?? null,
+        sourceLeadListId: stringValue(candidate.sourceLeadListId) ?? null,
+        leadSourceProvider: stringValue(candidate.leadSourceProvider) ?? null,
+        sourceFingerprint: stringValue(candidate.sourceFingerprint) ?? null,
+        sourceInventoryStatus: stringValue(candidate.sourceInventoryStatus) ?? null,
+        sourceRowIds: stringArray(candidate.sourceRowIds),
+        sourceRowLimit: typeof candidate.sourceRowLimit === "number"
+            ? candidate.sourceRowLimit
+            : undefined,
+        activeJobId: stringValue(candidate.activeJobId) ?? null,
+        activeImportStatus: stringValue(candidate.activeImportStatus) ?? null,
         targetRows: typeof candidate.targetRows === "number" ? candidate.targetRows : undefined,
         columnRole: stringValue(candidate.columnRole),
         rowSelector: sanitizeRowSelector(candidate.rowSelector),
@@ -186,6 +212,21 @@ function sanitizeToolInput(value) {
         campaignId: stringValue(value.campaignId),
         tableId: stringValue(value.tableId),
         columnId: stringValue(value.columnId) ?? null,
+        sourceLeadListId: stringValue(value.sourceLeadListId) ?? null,
+        leadSourceProvider: stringValue(value.leadSourceProvider) ?? null,
+        sourceFingerprint: stringValue(value.sourceFingerprint) ?? null,
+        activeJobId: stringValue(value.activeJobId) ?? null,
+        activeImportStatus: stringValue(value.activeImportStatus) ?? null,
+        sourceInventoryStatus: stringValue(value.sourceInventoryStatus) ?? null,
+        sourceRowIds: stringArray(value.sourceRowIds),
+        sourceRowLimit: typeof value.sourceRowLimit === "number"
+            ? value.sourceRowLimit
+            : undefined,
+        campaignOfferId: stringValue(value.campaignOfferId),
+        provider: stringValue(value.provider),
+        allowDifferentSourceLeadList: typeof value.allowDifferentSourceLeadList === "boolean"
+            ? value.allowDifferentSourceLeadList
+            : undefined,
         targetPreparedMessages: typeof value.targetPreparedMessages === "number"
             ? value.targetPreparedMessages
             : undefined,
@@ -212,6 +253,10 @@ function sanitizePacketIds(value) {
         campaignId: stringValue(value.campaignId),
         tableId: stringValue(value.tableId),
         columnId: stringValue(value.columnId) ?? null,
+        sourceLeadListId: stringValue(value.sourceLeadListId) ?? null,
+        leadSourceProvider: stringValue(value.leadSourceProvider) ?? null,
+        sourceFingerprint: stringValue(value.sourceFingerprint) ?? null,
+        activeJobId: stringValue(value.activeJobId) ?? null,
     };
 }
 function sanitizeStructuredAction(action, selectedBySender, mode, rank) {
@@ -307,6 +352,7 @@ function sanitizeCampaignRanking(value) {
             tableId: stringValue(option.tableId) ?? "",
             tableName: stringValue(option.tableName) ?? null,
             campaignStatus: stringValue(option.campaignStatus) ?? null,
+            classification: campaignClassificationValue(option.classification),
             supportsSelectedLane: option.supportsSelectedLane === true,
             rankSignals: stringArray(option.rankSignals),
             rankReason: stringValue(option.rankReason) ?? "",
@@ -330,6 +376,9 @@ function sanitizeSourcePlan(value) {
         reason: stringValue(value.reason),
         campaignId: stringValue(value.campaignId),
         tableId: stringValue(value.tableId),
+        sourceLeadListId: stringValue(value.sourceLeadListId) ?? null,
+        leadSourceProvider: stringValue(value.leadSourceProvider) ?? null,
+        sourceFingerprint: stringValue(value.sourceFingerprint) ?? null,
         remainingRowsNeeded: typeof value.remainingRowsNeeded === "number"
             ? value.remainingRowsNeeded
             : undefined,
@@ -351,6 +400,11 @@ function sanitizePaidInmail(value) {
         tableId: stringValue(value.tableId) ?? null,
         tableName: stringValue(value.tableName) ?? null,
         columnId: stringValue(value.columnId) ?? null,
+        maxStalenessSeconds: numberValue(value.maxStalenessSeconds),
+        campaignClassification: campaignClassificationValue(value.campaignClassification) ?? null,
+        connectionFallbackAvailable: booleanValue(value.connectionFallbackAvailable) ?? false,
+        connectionFallbackCampaignId: stringValue(value.connectionFallbackCampaignId) ?? null,
+        connectionFallbackCampaignName: stringValue(value.connectionFallbackCampaignName) ?? null,
         suggestedThreshold: typeof value.suggestedThreshold === "number"
             ? value.suggestedThreshold
             : null,
@@ -622,7 +676,7 @@ function sanitizeRefillTargetPlanResult(result) {
 export const refillTargetPlanToolDefinitions = [
     {
         name: "get_refill_target_plan",
-        description: "read-only refill target planner to call before any refill mutation. It identifies eligible senders and infers one implicit refill lane per sender: connection invites or paid InMails, chosen from future scheduled, recent scheduled, and ready-to-schedule evidence in active campaign-backed sequence campaigns before falling back to campaign sequences. DMs and open-profile InMails are follow-up sequence actions, not refill target lanes. By default the planner computes the scheduler-forward 48-hour target window, selected sender-local days whose sending windows overlap that window, gross target, actual sent coverage, scheduler-owned scheduled coverage, projected coverage (sent + scheduled), ready buffer, remaining projected gap, paid InMail credit/threshold feasibility, bounded action candidates, and targetRevision drift proof. This tool does not create rows, import leads, prepare messages, approve messages, does not schedule sends, start campaigns, lower paid InMail thresholds, create campaigns, launch, spend InMail credits, or write scheduler fields. Complete projected targets no-op without approval; loaded, awaiting scheduler targets use read-only wait/reread until projected coverage fills.",
+        description: "read-only refill target planner to call before any refill mutation. It identifies eligible senders and infers one implicit refill lane per sender. For unified Sales Nav cascade campaigns, the public refill lane is the paid-InMail cascade target (send_inmail_closed) with campaign classification sales_nav_cascade; the same campaign can still route prospects to Open InMail or connection-request fallback based on row eligibility and fresh paid credits >= 5. Non-cascade lanes remain connection invites or paid InMails, chosen from future scheduled, recent scheduled, and ready-to-schedule evidence in active campaign-backed sequence campaigns before falling back to campaign sequences. DMs remain follow-up sequence actions, not refill target lanes. By default the planner computes the scheduler-forward 48-hour target window, selected sender-local days whose sending windows overlap that window, gross target, actual sent coverage, scheduler-owned scheduled coverage, projected coverage (sent + scheduled), ready buffer, remaining projected gap, paid InMail credit/threshold/freshness feasibility, same-campaign connection fallback availability, bounded action candidates, and targetRevision drift proof. This tool does not create rows, import leads, prepare messages, approve messages, does not schedule sends, start campaigns, lower paid InMail thresholds, create campaigns, launch, spend InMail credits, or write scheduler fields. Complete projected targets no-op without approval; loaded, awaiting scheduler targets use read-only wait/reread until projected coverage fills.",
         inputSchema: {
             type: "object",
             properties: {
@@ -676,7 +730,7 @@ export const refillTargetPlanToolDefinitions = [
                         type: "string",
                         enum: ["send_invite", "send_inmail_closed"],
                     },
-                    description: "Optional refill target lane override. Supported refill lanes are connection invites (send_invite) and paid InMails (send_inmail_closed) only. If omitted, the planner infers one per-sender lane from active campaign future scheduled, recent scheduled, and ready-to-schedule evidence before falling back to selected active campaign sequences.",
+                    description: "Optional refill target lane override. Supported public refill lanes are connection invites (send_invite) and paid InMails / unified Sales Nav cascades (send_inmail_closed) only. If omitted, the planner infers one per-sender lane from active campaign future scheduled, recent scheduled, and ready-to-schedule evidence before falling back to selected active campaign sequences.",
                 },
                 approvalMode: {
                     type: "string",

package/dist/tools/registry.d.ts

@@ -2952,6 +2952,8 @@ export declare const allTools: ({
             keepInSync?: undefined;
             jobId?: undefined;
             reviewBatchLimit?: undefined;
+            sourceRowIds?: undefined;
+            sourceRowLimit?: undefined;
             allowPartialSourceList?: undefined;
             includeRawImportResult?: undefined;
             selections?: undefined;
@@ -3146,6 +3148,8 @@ export declare const allTools: ({
             keepInSync?: undefined;
             jobId?: undefined;
             reviewBatchLimit?: undefined;
+            sourceRowIds?: undefined;
+            sourceRowLimit?: undefined;
             allowPartialSourceList?: undefined;
             includeRawImportResult?: undefined;
             selections?: undefined;
@@ -3239,6 +3243,8 @@ export declare const allTools: ({
             keepInSync?: undefined;
             jobId?: undefined;
             reviewBatchLimit?: undefined;
+            sourceRowIds?: undefined;
+            sourceRowLimit?: undefined;
             allowPartialSourceList?: undefined;
             includeRawImportResult?: undefined;
             selections?: undefined;
@@ -3404,6 +3410,8 @@ export declare const allTools: ({
             keepInSync?: undefined;
             jobId?: undefined;
             reviewBatchLimit?: undefined;
+            sourceRowIds?: undefined;
+            sourceRowLimit?: undefined;
             allowPartialSourceList?: undefined;
             includeRawImportResult?: undefined;
             selections?: undefined;
@@ -3511,6 +3519,8 @@ export declare const allTools: ({
             keepInSync?: undefined;
             jobId?: undefined;
             reviewBatchLimit?: undefined;
+            sourceRowIds?: undefined;
+            sourceRowLimit?: undefined;
             allowPartialSourceList?: undefined;
             includeRawImportResult?: undefined;
             selections?: undefined;
@@ -3627,6 +3637,8 @@ export declare const allTools: ({
             keepInSync?: undefined;
             jobId?: undefined;
             reviewBatchLimit?: undefined;
+            sourceRowIds?: undefined;
+            sourceRowLimit?: undefined;
             allowPartialSourceList?: undefined;
             includeRawImportResult?: undefined;
             selections?: undefined;
@@ -3732,6 +3744,8 @@ export declare const allTools: ({
             keepInSync?: undefined;
             jobId?: undefined;
             reviewBatchLimit?: undefined;
+            sourceRowIds?: undefined;
+            sourceRowLimit?: undefined;
             allowPartialSourceList?: undefined;
             includeRawImportResult?: undefined;
             selections?: undefined;
@@ -3842,6 +3856,8 @@ export declare const allTools: ({
             keepInSync?: undefined;
             jobId?: undefined;
             reviewBatchLimit?: undefined;
+            sourceRowIds?: undefined;
+            sourceRowLimit?: undefined;
             allowPartialSourceList?: undefined;
             includeRawImportResult?: undefined;
             selections?: undefined;
@@ -3940,6 +3956,8 @@ export declare const allTools: ({
             keepInSync?: undefined;
             jobId?: undefined;
             reviewBatchLimit?: undefined;
+            sourceRowIds?: undefined;
+            sourceRowLimit?: undefined;
             allowPartialSourceList?: undefined;
             includeRawImportResult?: undefined;
             selections?: undefined;
@@ -4830,6 +4848,8 @@ export declare const allTools: ({
             keepInSync?: undefined;
             jobId?: undefined;
             reviewBatchLimit?: undefined;
+            sourceRowIds?: undefined;
+            sourceRowLimit?: undefined;
             allowPartialSourceList?: undefined;
             includeRawImportResult?: undefined;
             selections?: undefined;
@@ -4937,6 +4957,8 @@ export declare const allTools: ({
             keepInSync?: undefined;
             jobId?: undefined;
             reviewBatchLimit?: undefined;
+            sourceRowIds?: undefined;
+            sourceRowLimit?: undefined;
             allowPartialSourceList?: undefined;
             includeRawImportResult?: undefined;
             selections?: undefined;
@@ -5982,6 +6004,8 @@ export declare const allTools: ({
             keepInSync?: undefined;
             jobId?: undefined;
             reviewBatchLimit?: undefined;
+            sourceRowIds?: undefined;
+            sourceRowLimit?: undefined;
             allowPartialSourceList?: undefined;
             includeRawImportResult?: undefined;
             selections?: undefined;
@@ -6136,6 +6160,8 @@ export declare const allTools: ({
             keepInSync?: undefined;
             jobId?: undefined;
             reviewBatchLimit?: undefined;
+            sourceRowIds?: undefined;
+            sourceRowLimit?: undefined;
             allowPartialSourceList?: undefined;
             includeRawImportResult?: undefined;
             selections?: undefined;
@@ -6277,6 +6303,8 @@ export declare const allTools: ({
             keepInSync?: undefined;
             jobId?: undefined;
             reviewBatchLimit?: undefined;
+            sourceRowIds?: undefined;
+            sourceRowLimit?: undefined;
             allowPartialSourceList?: undefined;
             includeRawImportResult?: undefined;
             selections?: undefined;
@@ -6373,6 +6401,8 @@ export declare const allTools: ({
             keepInSync?: undefined;
             jobId?: undefined;
             reviewBatchLimit?: undefined;
+            sourceRowIds?: undefined;
+            sourceRowLimit?: undefined;
             allowPartialSourceList?: undefined;
             includeRawImportResult?: undefined;
             selections?: undefined;
@@ -6419,6 +6449,17 @@ export declare const allTools: ({
                 type: string;
                 description: string;
             };
+            sourceRowIds: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+            sourceRowLimit: {
+                type: string;
+                description: string;
+            };
             allowPartialSourceList: {
                 type: string;
                 description: string;
@@ -6628,6 +6669,8 @@ export declare const allTools: ({
             keepInSync?: undefined;
             jobId?: undefined;
             reviewBatchLimit?: undefined;
+            sourceRowIds?: undefined;
+            sourceRowLimit?: undefined;
             allowPartialSourceList?: undefined;
             includeRawImportResult?: undefined;
         };
@@ -6725,6 +6768,8 @@ export declare const allTools: ({
             keepInSync?: undefined;
             jobId?: undefined;
             reviewBatchLimit?: undefined;
+            sourceRowIds?: undefined;
+            sourceRowLimit?: undefined;
             allowPartialSourceList?: undefined;
             includeRawImportResult?: undefined;
             selections?: undefined;

package/dist/tools/sequencer.js

@@ -65,13 +65,12 @@ export const sequencerToolDefinitions = [
         name: "attach_recommended_sequence",
         description: "Attach the tier-recommended sequence template to a campaign. " +
             "Delegates template selection to the backend's existing tier-aware selector " +
-            "(selectTemplateForTiers), which picks `If Open Profile -> INMAIL_OPEN, else INVITE` " +
-            "for Sales Nav/Recruiter senders and `INVITE -> accepted -> DM` for Basic, Premium, or mixed sender sets. " +
-            "Paid InMail Campaign is not auto-selected because it can spend InMail credits; " +
-            "use attach_sequence with an explicit paid-InMail template only after the user opts in. " +
+            "(selectTemplateForTiers), which picks the unified Sales Nav cascade for Sales Nav/Recruiter senders: " +
+            "Open Profile check -> Open InMail, otherwise fresh paid credits >= 5 -> paid InMail, otherwise same-campaign connection request -> accepted wait -> DM. " +
+            "Basic, Premium, or mixed sender sets still get `INVITE -> accepted -> DM`. " +
+            "This is the default Sales Nav product path; use attach_sequence directly only when the caller needs a custom non-recommended cadence. " +
             "Prefer this over attach_sequence during the create-campaign-v2 autonomous tail — " +
-            "it removes the risk of hand-authoring an invalid template mid-long-context. " +
-            "Use attach_sequence directly only when the caller needs a custom non-recommended cadence.",
+            "it removes the risk of hand-authoring an invalid template mid-long-context.",
         inputSchema: {
             type: "object",
             properties: {

package/package.json

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

package/skills/create-campaign-v2/references/final-handoff-contract.md

@@ -58,10 +58,12 @@ currentStep: "sequence" })` to attach the sender via the v3 senders route and
    move the watched app to Sequence.
 8. Call `attach_recommended_sequence({ campaignId, currentStep: "send" })` to
    bind the tier-aware recommended sequence. Explain the sequence choice in the
-   handoff: Sales Nav/Recruiter senders get the Sales Nav Open Profile
-   strategy, Basic/Premium/mixed senders get the Premium invite-to-DM strategy,
-   and Paid InMail Campaign is only an explicit paid-InMail opt-in because it
-   can spend InMail credits. If that response does not persist `currentStep:
+   handoff: Sales Nav/Recruiter senders get the unified Sales Nav cascade
+   (Open Profile -> Open InMail, otherwise fresh paid credits >= 5 -> paid
+   InMail, otherwise connection request -> accepted wait -> DM), while
+   Basic/Premium/mixed senders get the Premium invite-to-DM strategy. The manual
+   Paid InMail Campaign remains an explicit custom template, not the normal
+   recommended path. If that response does not persist `currentStep:
 "send"`, call `update_campaign({ campaignId, currentStep: "send" })`.
    Then reread `get_campaign({ campaignId })` and `list_tables()` and verify the
    current `workflowTableId` has `hasSequence:true`. A campaign-level
@@ -69,9 +71,9 @@ currentStep: "sequence" })` to attach the sender via the v3 senders route and
    copy step has moved the campaign to a new current campaign table while an old
    stale shell table still owns the sequence columns. In that stale-shell case,
    either repair only the current workflowTableId with `attach_sequence` using
-   the same non-paid product template the recommended selector would have chosen,
-   or stop and report the stale-shell sequence blocker if replacement was not
-   explicitly approved. Never choose a paid-InMail template for this repair.
+   the same product template the recommended selector would have chosen, or stop
+   and report the stale-shell sequence blocker if replacement was not explicitly
+   approved. Do not substitute the manual Paid InMail Campaign for this repair.
 9. Surface the `handoff.orientation` string from `auto-execute.yaml` and
    summarize the visible Settings/Sequence/Send state without repeating the
    watch URL.