@sellable/mcp 0.1.507 → 0.1.508

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

@@ -10,6 +10,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",
@@ -19,6 +26,14 @@ const MANUAL_ONLY_PACKET_ACTION_TYPES = new Set([
     "lower_paid_inmail_threshold",
     "switch_to_connection_lane",
     "create_connection_campaign",
+    "continue_sales_nav_source",
+    "continue_prospeo_source",
+    "manual_source_replenishment",
+]);
+const TERMINAL_NO_ACTION_BLOCKER_CODES = new Set([
+    "paid_inmail_below_threshold",
+    "paid_inmail_credit_missing",
+    "paid_inmail_credit_stale",
 ]);
 const SOURCE_PLAN_STATES = new Set([
     "not_needed",
@@ -27,6 +42,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",
@@ -156,6 +173,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),
@@ -190,9 +217,25 @@ function sanitizeToolInput(value) {
         return {};
     return {
         senderId: stringValue(value.senderId),
+        actionType: allowedActionType(value.actionType),
         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,
@@ -219,6 +262,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) {
@@ -241,6 +288,7 @@ function sanitizeStructuredAction(action, selectedBySender, mode, rank) {
     return {
         rank,
         type: action.type,
+        actionType: allowedActionType(action.actionType),
         toolName: stringValue(action.toolName) ?? null,
         sideEffectClass: stringValue(action.sideEffectClass),
         ids,
@@ -338,6 +386,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,
@@ -586,14 +637,16 @@ function sanitizeRefillTargetPlanResult(result) {
     const eligibleSenderLedger = sanitizeEligibleSenderLedger(target.eligibleSenderLedger, selectedBySender);
     const senderRefillPlans = sanitizeStructuredSenderPlans(target.senderRefillPlans, selectedBySender);
     const globalActionQueue = buildSanitizedGlobalActionQueue(senderRefillPlans);
-    const status = blockers.some((blocker) => ["sender_disconnected", "sender_sales_nav_disconnected"].includes(String(blocker.code)))
-        ? "blocked"
-        : remainingProjectedGap === 0
-            ? "complete"
-            : grossTarget <= 0
-                ? "blocked"
-                : remainingReadyOrProjectedGap === 0
-                    ? "awaiting_scheduler_after_ready_buffer"
+    const hasTerminalNoActionBlocker = globalActionQueue.length === 0 &&
+        blockers.some((blocker) => TERMINAL_NO_ACTION_BLOCKER_CODES.has(String(blocker.code)));
+    const status = remainingProjectedGap === 0
+        ? "complete"
+        : grossTarget <= 0
+            ? "blocked"
+            : remainingReadyOrProjectedGap === 0
+                ? "awaiting_scheduler_after_ready_buffer"
+                : hasTerminalNoActionBlocker
+                    ? "blocked"
                     : "needs_refill";
     return {
         ...result,

package/dist/tools/registry.d.ts

@@ -584,89 +584,6 @@ export declare const allTools: ({
         required: string[];
         additionalProperties: boolean;
     };
-} | {
-    name: string;
-    description: string;
-    inputSchema: {
-        type: string;
-        properties: {
-            campaignId: {
-                type: string;
-                description: string;
-            };
-            tableId: {
-                type: string;
-            };
-            targetPreparedMessages: {
-                type: string;
-                minimum: number;
-                maximum: number;
-            };
-            maxRowsToCheck: {
-                type: string;
-                minimum: number;
-                maximum: number;
-                description: string;
-            };
-            batchSize: {
-                type: string;
-                minimum: number;
-                maximum: number;
-                description: string;
-            };
-            maxBatchRows: {
-                type: string;
-                minimum: number;
-                maximum: number;
-                description: string;
-            };
-            approvalMode: {
-                type: string;
-                enum: string[];
-                description: string;
-            };
-            autoContinue: {
-                type: string;
-            };
-            disableLowPassRateStop: {
-                type: string;
-                description: string;
-            };
-            rowSelector: {
-                type: string;
-                description: string;
-                properties: {
-                    type: {
-                        type: string;
-                        enum: string[];
-                    };
-                    basisHash: {
-                        type: string;
-                    };
-                    rowIds: {
-                        type: string;
-                        items: {
-                            type: string;
-                        };
-                    };
-                    limit: {
-                        type: string;
-                        minimum: number;
-                        maximum: number;
-                    };
-                };
-                required: string[];
-                additionalProperties: boolean;
-            };
-            workspaceId: {
-                type: string;
-                description: string;
-            };
-            jobId?: undefined;
-        };
-        required: string[];
-        additionalProperties: boolean;
-    };
 } | {
     name: string;
     description: string;
@@ -692,9 +609,11 @@ export declare const allTools: ({
             batchSize?: undefined;
             maxBatchRows?: undefined;
             approvalMode?: undefined;
+            rowSelector?: undefined;
             autoContinue?: undefined;
+            senderId?: undefined;
+            actionType?: undefined;
             disableLowPassRateStop?: undefined;
-            rowSelector?: undefined;
         };
         additionalProperties: boolean;
         required?: undefined;
@@ -3131,6 +3050,8 @@ export declare const allTools: ({
             keepInSync?: undefined;
             jobId?: undefined;
             reviewBatchLimit?: undefined;
+            sourceRowIds?: undefined;
+            sourceRowLimit?: undefined;
             allowPartialSourceList?: undefined;
             includeRawImportResult?: undefined;
             selections?: undefined;
@@ -3325,6 +3246,8 @@ export declare const allTools: ({
             keepInSync?: undefined;
             jobId?: undefined;
             reviewBatchLimit?: undefined;
+            sourceRowIds?: undefined;
+            sourceRowLimit?: undefined;
             allowPartialSourceList?: undefined;
             includeRawImportResult?: undefined;
             selections?: undefined;
@@ -3418,6 +3341,8 @@ export declare const allTools: ({
             keepInSync?: undefined;
             jobId?: undefined;
             reviewBatchLimit?: undefined;
+            sourceRowIds?: undefined;
+            sourceRowLimit?: undefined;
             allowPartialSourceList?: undefined;
             includeRawImportResult?: undefined;
             selections?: undefined;
@@ -3583,6 +3508,8 @@ export declare const allTools: ({
             keepInSync?: undefined;
             jobId?: undefined;
             reviewBatchLimit?: undefined;
+            sourceRowIds?: undefined;
+            sourceRowLimit?: undefined;
             allowPartialSourceList?: undefined;
             includeRawImportResult?: undefined;
             selections?: undefined;
@@ -3690,6 +3617,8 @@ export declare const allTools: ({
             keepInSync?: undefined;
             jobId?: undefined;
             reviewBatchLimit?: undefined;
+            sourceRowIds?: undefined;
+            sourceRowLimit?: undefined;
             allowPartialSourceList?: undefined;
             includeRawImportResult?: undefined;
             selections?: undefined;
@@ -3806,6 +3735,8 @@ export declare const allTools: ({
             keepInSync?: undefined;
             jobId?: undefined;
             reviewBatchLimit?: undefined;
+            sourceRowIds?: undefined;
+            sourceRowLimit?: undefined;
             allowPartialSourceList?: undefined;
             includeRawImportResult?: undefined;
             selections?: undefined;
@@ -3911,6 +3842,8 @@ export declare const allTools: ({
             keepInSync?: undefined;
             jobId?: undefined;
             reviewBatchLimit?: undefined;
+            sourceRowIds?: undefined;
+            sourceRowLimit?: undefined;
             allowPartialSourceList?: undefined;
             includeRawImportResult?: undefined;
             selections?: undefined;
@@ -4021,6 +3954,8 @@ export declare const allTools: ({
             keepInSync?: undefined;
             jobId?: undefined;
             reviewBatchLimit?: undefined;
+            sourceRowIds?: undefined;
+            sourceRowLimit?: undefined;
             allowPartialSourceList?: undefined;
             includeRawImportResult?: undefined;
             selections?: undefined;
@@ -4119,6 +4054,8 @@ export declare const allTools: ({
             keepInSync?: undefined;
             jobId?: undefined;
             reviewBatchLimit?: undefined;
+            sourceRowIds?: undefined;
+            sourceRowLimit?: undefined;
             allowPartialSourceList?: undefined;
             includeRawImportResult?: undefined;
             selections?: undefined;
@@ -5009,6 +4946,8 @@ export declare const allTools: ({
             keepInSync?: undefined;
             jobId?: undefined;
             reviewBatchLimit?: undefined;
+            sourceRowIds?: undefined;
+            sourceRowLimit?: undefined;
             allowPartialSourceList?: undefined;
             includeRawImportResult?: undefined;
             selections?: undefined;
@@ -5116,6 +5055,8 @@ export declare const allTools: ({
             keepInSync?: undefined;
             jobId?: undefined;
             reviewBatchLimit?: undefined;
+            sourceRowIds?: undefined;
+            sourceRowLimit?: undefined;
             allowPartialSourceList?: undefined;
             includeRawImportResult?: undefined;
             selections?: undefined;
@@ -6161,6 +6102,8 @@ export declare const allTools: ({
             keepInSync?: undefined;
             jobId?: undefined;
             reviewBatchLimit?: undefined;
+            sourceRowIds?: undefined;
+            sourceRowLimit?: undefined;
             allowPartialSourceList?: undefined;
             includeRawImportResult?: undefined;
             selections?: undefined;
@@ -6315,6 +6258,8 @@ export declare const allTools: ({
             keepInSync?: undefined;
             jobId?: undefined;
             reviewBatchLimit?: undefined;
+            sourceRowIds?: undefined;
+            sourceRowLimit?: undefined;
             allowPartialSourceList?: undefined;
             includeRawImportResult?: undefined;
             selections?: undefined;
@@ -6456,6 +6401,8 @@ export declare const allTools: ({
             keepInSync?: undefined;
             jobId?: undefined;
             reviewBatchLimit?: undefined;
+            sourceRowIds?: undefined;
+            sourceRowLimit?: undefined;
             allowPartialSourceList?: undefined;
             includeRawImportResult?: undefined;
             selections?: undefined;
@@ -6552,6 +6499,8 @@ export declare const allTools: ({
             keepInSync?: undefined;
             jobId?: undefined;
             reviewBatchLimit?: undefined;
+            sourceRowIds?: undefined;
+            sourceRowLimit?: undefined;
             allowPartialSourceList?: undefined;
             includeRawImportResult?: undefined;
             selections?: undefined;
@@ -6598,6 +6547,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;
@@ -6807,6 +6767,8 @@ export declare const allTools: ({
             keepInSync?: undefined;
             jobId?: undefined;
             reviewBatchLimit?: undefined;
+            sourceRowIds?: undefined;
+            sourceRowLimit?: undefined;
             allowPartialSourceList?: undefined;
             includeRawImportResult?: undefined;
         };
@@ -6904,6 +6866,8 @@ export declare const allTools: ({
             keepInSync?: undefined;
             jobId?: undefined;
             reviewBatchLimit?: undefined;
+            sourceRowIds?: undefined;
+            sourceRowLimit?: undefined;
             allowPartialSourceList?: undefined;
             includeRawImportResult?: undefined;
             selections?: undefined;

package/package.json

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

package/skills/refill-sends/SKILL.md

@@ -92,10 +92,16 @@ When the host can call typed MCP tools, start with:
 refill_sends({ yolo?: boolean, executionMode?: "manual" | "scheduled" | "yolo", requireWorkspace?: boolean, workspaceId?: string, senders?: string[], senderIds?: string[], senderNames?: string[], horizonSendDays?: number, untilDate?: "YYYY-MM-DD", targetDate?: "YYYY-MM-DD" })
 ```
 
-That command helper only normalizes arguments and returns the execution
-contract. It does not mutate. Continue with the workflow below for route
-selection, state rereads, approval gating, source import, preparation, and
-bounded approval.
+That command helper normalizes arguments and returns the execution contract. In
+non-yolo mode it does not mutate. In `--yolo`, it may execute exactly one safe
+bounded primitive from the fresh `target.globalActionQueue[0]`, then reread and
+return the new target plan; currently safe primitives are paid-credit refresh,
+existing-row message preparation, same-source row copy, and read-only wait
+rereads. It does not run unbounded approval, lower
+paid-InMail thresholds, switch source families, create campaigns, launch, send,
+or write scheduler rows. Continue with the workflow below for route selection,
+state rereads, approval gating, source import, preparation, and bounded
+approval.
 
 ## Workspace Contract
 
@@ -199,12 +205,20 @@ Structured planner packet:
 - `manualAlternates` are not yolo actions. Threshold lowering and campaign
   creation are manual continuations only.
 
+Refill action ladder: approve generated rows only when an explicit bounded
+approval gate exists, process all existing same-campaign unenriched/unprepared
+rows in bounded batches before any source work, then copy bounded net-new rows
+from the selected source (`selectedLeadListId`, provider, and source
+fingerprint preserved), then use provider-aligned source-more. A new source or
+provider switch changes the reply-rate baseline and is a manual alternate, not a
+`--yolo` side effect.
+
 Run-local paid-credit guard: in `--yolo`, the `refill_sends` MCP command
 automatically maintains a `refreshedPaidInmailSenderIds` set for the current
 command call. If its first target plan has stale/missing paid-InMail credit
 facts, it refreshes each selected sender at most once, reruns
 `get_refill_target_plan`, and returns the post-refresh `targetPlan` before
-choosing the next prep/approval/start action. If fresh facts are still below
+choosing the next prep/source-copy/bounded-approval/read-only wait action. If fresh facts are still below
 threshold, below-threshold paid-InMail facts fall back to an existing connection
 lane, the same Sales Nav cascade campaign's connection branch, or a manual
 continuation.
@@ -238,10 +252,7 @@ next action in `--yolo`. Do not present paid-credit refresh as the next operator
 action after `refill_sends` returns `autoPaidInmailRefresh` and the
 post-refresh `targetPlan`. Trust `refill_sends.autoPaidInmailRefresh`: it should
 show the exact sender ids refreshed once, sender-credit-cache write receipts,
-and a returned post-refresh `targetPlan`. Also inspect
-`refill_sends.yoloExecution`: if it applied a supported yolo action, continue
-from the final returned `targetPlan`; otherwise continue from the post-refresh
-packet or `targetPlanBeforeYoloAction`.
+and a returned post-refresh `targetPlan`. Continue from that post-refresh packet.
 If paid InMail is below threshold after the fresh credit read, report the exact
 campaign/table/column threshold action or same-campaign connection fallback;
 `--yolo` does not lower paid-InMail thresholds or create campaigns.
@@ -296,7 +307,7 @@ they change `stateRevision`, not `targetShapeRevision`, and do not require a
 second approval.
 
 In `--yolo`, continue as far as the rendered packet safely allows. After each
-apply/prep/start result, reread state, settle processing when needed, and move to
+apply/prep/source-copy/bounded-approval/read-only wait result, reread state, settle processing when needed, and move to
 the next selected sender or start-eligible same-packet campaign instead of
 stopping after the first partial result. If no in-packet safe action remains,
 return concrete continuation options with campaign names, exact ids, which option
@@ -310,7 +321,7 @@ selected sender: selected send days, gross capacity, actual sent cells, future
 scheduler-owned scheduled cells with non-null `scheduledFor`, projected count,
 ready-to-schedule buffer, remaining projected gap, paid-InMail feasibility,
 `targetShapeRevision`, `stateRevision`, and the next MCP primitive that can
-reduce the gap. After every apply/prep/start result, wait for processing, reread
+reduce the gap. After every apply/prep/source-copy/bounded-approval/read-only wait result, wait for processing, reread
 the target plan/refill state, recompute the ledger, then keep applying safe
 bounded actions until projected coverage fills the target window or a concrete
 non-scheduler blocker is proven.

package/skills/refill-sends-workflow/SKILL.md

@@ -120,12 +120,19 @@ in-progress wait state, not a reason to mark the goal complete or blocked.
    - `nextActions[0]` is the current sender's smallest safe primitive.
    - `manualAlternates` are not yolo actions. Threshold lowering and campaign
      creation are manual continuations only.
+   Refill action ladder: approve generated rows only when an explicit bounded
+   approval gate exists, process all existing same-campaign
+   unenriched/unprepared rows in bounded batches before any source work, then
+   copy bounded net-new rows from the selected source (`selectedLeadListId`,
+   provider, and source fingerprint preserved), then use provider-aligned
+   source-more. A new source or provider switch changes the reply-rate baseline
+   and is a manual alternate, not a `--yolo` side effect.
    Run-local paid-credit guard: in `--yolo`, the `refill_sends` MCP command
    automatically maintains a `refreshedPaidInmailSenderIds` set for the current
    command call. If its first target plan has stale/missing paid-InMail credit
    facts, it refreshes each selected sender at most once, reruns
    `get_refill_target_plan`, and returns the post-refresh `targetPlan` before
-   choosing the next prep/approval/start action. If fresh facts are still below
+   choosing the next prep/source-copy/bounded-approval/read-only wait action. If fresh facts are still below
    threshold, below-threshold paid-InMail facts fall back to an existing
    connection lane, the same Sales Nav cascade campaign's connection branch, or
    a manual continuation.
@@ -161,10 +168,8 @@ in-progress wait state, not a reason to mark the goal complete or blocked.
    operator action after `refill_sends` returns `autoPaidInmailRefresh` and the
    post-refresh `targetPlan`. Trust `refill_sends.autoPaidInmailRefresh`: it
    should show the exact sender ids refreshed once, sender-credit-cache write
-   receipts, and a returned post-refresh `targetPlan`. Also inspect
-   `refill_sends.yoloExecution`: if it applied a supported yolo action,
-   continue from the final returned `targetPlan`; otherwise continue from the
-   post-refresh packet or `targetPlanBeforeYoloAction`. If paid InMail is below threshold after the fresh credit read, report
+   receipts, and a returned post-refresh `targetPlan`. Continue from that
+   post-refresh packet. If paid InMail is below threshold after the fresh credit read, report
    the exact campaign/table/column threshold action or same-campaign
    connection fallback; `--yolo` does not lower paid-InMail thresholds or create campaigns.
 2. Call `resolve_campaign_fill_route`. Use `intent:"plain"` for generic
@@ -566,7 +571,7 @@ same refill request, do not ask the `Accept` / `Decline` question. Instead:
    caps/dates, approval mode, blockers, and side-effect class still match the
    packet;
 4. execute only the exact packet;
-5. after each terminal credit-refresh/apply/prep/start result, rerun
+5. after each terminal credit-refresh/apply/prep/source-copy/bounded-approval/read-only wait result, rerun
    `get_refill_target_plan`, reread state, settle processing when needed,
    recompute the target-window saturation ledger, and continue with the next smallest
    safe action inside the same bounded packet until every selected sender is