@sellable/mcp 0.1.510 → 0.1.512

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

@@ -183,7 +183,9 @@ function sanitizeActionCandidate(candidate) {
             : undefined,
         activeJobId: stringValue(candidate.activeJobId) ?? null,
         activeImportStatus: stringValue(candidate.activeImportStatus) ?? null,
-        targetRows: typeof candidate.targetRows === "number" ? candidate.targetRows : undefined,
+        targetRows: typeof candidate.targetRows === "number"
+            ? candidate.targetRows
+            : undefined,
         columnRole: stringValue(candidate.columnRole),
         rowSelector: sanitizeRowSelector(candidate.rowSelector),
         actionKey: stringValue(candidate.actionKey),
@@ -209,7 +211,9 @@ function sanitizeRowSelector(value) {
     return {
         type: value.type,
         ...(typeof value.limit === "number" ? { limit: value.limit } : {}),
-        ...(Array.isArray(value.rowIds) ? { rowIds: stringArray(value.rowIds) } : {}),
+        ...(Array.isArray(value.rowIds)
+            ? { rowIds: stringArray(value.rowIds) }
+            : {}),
     };
 }
 function sanitizeToolInput(value) {
@@ -451,11 +455,15 @@ function sanitizeStructuredSenderPlans(value, selectedBySender) {
                     selectedDays: Array.isArray(plan.horizon.selectedDays)
                         ? plan.horizon.selectedDays
                         : [],
+                    requestedTarget: numberValue(plan.horizon.requestedTarget),
                     grossTarget: numberValue(plan.horizon.grossTarget),
                     schedulerFillableSlots: typeof plan.horizon.schedulerFillableSlots === "number"
                         ? plan.horizon.schedulerFillableSlots
                         : null,
                     schedulerFillableSlotsKnown: plan.horizon.schedulerFillableSlotsKnown === true,
+                    schedulerCapacityTarget: typeof plan.horizon.schedulerCapacityTarget === "number"
+                        ? plan.horizon.schedulerCapacityTarget
+                        : null,
                     capacityConfidence: stringValue(plan.horizon.capacityConfidence) ?? "unknown",
                     schedulerCapacityMode: stringValue(plan.horizon.schedulerCapacityMode),
                 }
@@ -517,7 +525,9 @@ function emptyUnsupportedResult(result) {
             eligibleSenderLedger: [],
             senderRefillPlans: [],
             globalActionQueue: [],
+            requestedTarget: 0,
             grossTarget: 0,
+            effectiveTarget: 0,
             sent: 0,
             scheduled: 0,
             projected: 0,
@@ -564,7 +574,7 @@ function sanitizeBlockers(blockers, selectedKeys) {
         if (!actionType)
             return true;
         const senderId = parts[0];
-        return selectedKeys.size === 0 || selectedKeys.has(`${senderId}:${actionType}`);
+        return (selectedKeys.size === 0 || selectedKeys.has(`${senderId}:${actionType}`));
     });
 }
 function sanitizeRefillTargetPlanResult(result) {
@@ -626,6 +636,13 @@ function sanitizeRefillTargetPlanResult(result) {
         };
     });
     const grossTarget = senderPlans.reduce((sum, plan) => sum + numberValue(plan.grossTarget), 0);
+    const requestedTarget = senderPlans.reduce((sum, plan) => sum + numberValue(plan.requestedTarget), 0);
+    const effectiveTarget = senderPlans.reduce((sum, plan) => {
+        const target = typeof plan.schedulerCapacityTarget === "number"
+            ? plan.schedulerCapacityTarget
+            : numberValue(plan.grossTarget);
+        return sum + target;
+    }, 0);
     const sent = senderPlans.reduce((sum, plan) => sum + numberValue(plan.sent), 0);
     const scheduled = senderPlans.reduce((sum, plan) => sum + numberValue(plan.scheduled), 0);
     const projected = sent + scheduled;
@@ -662,7 +679,9 @@ function sanitizeRefillTargetPlanResult(result) {
             eligibleSenderLedger,
             senderRefillPlans,
             globalActionQueue,
+            requestedTarget,
             grossTarget,
+            effectiveTarget,
             sent,
             scheduled,
             projected,

package/dist/tools/registry.d.ts

@@ -236,7 +236,7 @@ export declare const allTools: ({
         properties: {
             subskillName: {
                 type: string;
-                enum: readonly ["building-gtm-tables", "content", "create-ab-test", "create-campaign", "create-campaign-brief", "create-campaign-v2", "create-campaign-v2-tail", "create-campaign-v2-validation", "create-evergreen-campaigns", "create-post", "create-rubric", "engage", "enrich-prospects", "fill-send-horizon", "find-leads", "foundation", "generate-messages", "interview", "load-voice", "refresh-sender-engagement", "refill-sends", "refill-sends-workflow", "research", "research-prospect", "research-sender", "weekly-campaign-summary", "workflow-sequences"];
+                enum: readonly ["building-gtm-tables", "content", "create-ab-test", "create-campaign", "create-campaign-brief", "create-campaign-v2", "create-campaign-v2-tail", "create-campaign-v2-validation", "create-evergreen-campaigns", "create-post", "create-rubric", "engage", "enrich-prospects", "fill-send-horizon", "find-leads", "foundation", "generate-messages", "interview", "load-voice", "refresh-sender-engagement", "refill-sends", "refill-sends-evergreen", "refill-sends-evergreen-workflow", "refill-sends-workflow", "research", "research-prospect", "research-sender", "weekly-campaign-summary", "workflow-sequences"];
                 description: string;
             };
             offset: {
@@ -271,7 +271,7 @@ export declare const allTools: ({
         properties: {
             subskillName: {
                 type: string;
-                enum: readonly ["building-gtm-tables", "content", "create-ab-test", "create-campaign", "create-campaign-brief", "create-campaign-v2", "create-campaign-v2-tail", "create-campaign-v2-validation", "create-evergreen-campaigns", "create-post", "create-rubric", "engage", "enrich-prospects", "fill-send-horizon", "find-leads", "foundation", "generate-messages", "interview", "load-voice", "refresh-sender-engagement", "refill-sends", "refill-sends-workflow", "research", "research-prospect", "research-sender", "weekly-campaign-summary", "workflow-sequences"];
+                enum: readonly ["building-gtm-tables", "content", "create-ab-test", "create-campaign", "create-campaign-brief", "create-campaign-v2", "create-campaign-v2-tail", "create-campaign-v2-validation", "create-evergreen-campaigns", "create-post", "create-rubric", "engage", "enrich-prospects", "fill-send-horizon", "find-leads", "foundation", "generate-messages", "interview", "load-voice", "refresh-sender-engagement", "refill-sends", "refill-sends-evergreen", "refill-sends-evergreen-workflow", "refill-sends-workflow", "research", "research-prospect", "research-sender", "weekly-campaign-summary", "workflow-sequences"];
                 description: string;
             };
             assetPath: {
@@ -474,39 +474,6 @@ export declare const allTools: ({
         required: string[];
         additionalProperties: boolean;
     };
-} | {
-    name: string;
-    description: string;
-    inputSchema: {
-        type: string;
-        properties: {
-            intent: {
-                type: string;
-                enum: string[];
-                description: string;
-            };
-            campaignId: {
-                type: string;
-                description: string;
-            };
-            tableId: {
-                type: string;
-                description: string;
-            };
-            limit: {
-                type: string;
-                minimum: number;
-                maximum: number;
-                description: string;
-            };
-            workspaceId: {
-                type: string;
-                description: string;
-            };
-        };
-        required: string[];
-        additionalProperties: boolean;
-    };
 } | {
     name: string;
     description: string;
@@ -624,45 +591,6 @@ export declare const allTools: ({
     inputSchema: {
         type: string;
         properties: {
-            capacityRequests: {
-                type: string;
-                minItems: number;
-                items: {
-                    type: string;
-                    properties: {
-                        senderId: {
-                            type: string;
-                            description: string;
-                        };
-                        actionType: {
-                            type: string;
-                            enum: string[];
-                            description: string;
-                        };
-                        cellId: {
-                            type: string;
-                            description: string;
-                        };
-                        columnId: {
-                            type: string;
-                            description: string;
-                        };
-                    };
-                    required: string[];
-                    additionalProperties: boolean;
-                };
-                description: string;
-            };
-            targetDate: {
-                type: string;
-                pattern: string;
-                description: string;
-            };
-            mode: {
-                type: string;
-                enum: string[];
-                description: string;
-            };
             workspaceId: {
                 type: string;
                 description: string;
@@ -1079,7 +1007,6 @@ export declare const allTools: ({
             useMessagingTemplate?: undefined;
             rubric?: undefined;
             flowVersion?: undefined;
-            workspaceId?: undefined;
         };
         required: string[];
         additionalProperties: boolean;
@@ -1118,7 +1045,6 @@ export declare const allTools: ({
             useMessagingTemplate?: undefined;
             rubric?: undefined;
             flowVersion?: undefined;
-            workspaceId?: undefined;
         };
         required: never[];
         additionalProperties?: undefined;
@@ -1157,7 +1083,6 @@ export declare const allTools: ({
             useMessagingTemplate?: undefined;
             rubric?: undefined;
             flowVersion?: undefined;
-            workspaceId?: undefined;
         };
         required: string[];
         additionalProperties?: undefined;
@@ -1239,7 +1164,6 @@ export declare const allTools: ({
             useMessagingTemplate?: undefined;
             rubric?: undefined;
             flowVersion?: undefined;
-            workspaceId?: undefined;
         };
         required: string[];
         additionalProperties: boolean;
@@ -1434,7 +1358,6 @@ export declare const allTools: ({
             useMessagingTemplate?: undefined;
             rubric?: undefined;
             flowVersion?: undefined;
-            workspaceId?: undefined;
         };
         required: never[];
         additionalProperties?: undefined;
@@ -1640,49 +1563,6 @@ export declare const allTools: ({
             clientProspectId?: undefined;
             senderLinkedinUrl?: undefined;
             messageGenerationMode?: undefined;
-            workspaceId?: undefined;
-        };
-        required: string[];
-        additionalProperties?: undefined;
-    };
-} | {
-    name: string;
-    description: string;
-    inputSchema: {
-        type: string;
-        properties: {
-            campaignId: {
-                type: string;
-                description: string;
-            };
-            workspaceId: {
-                type: string;
-                description: string;
-            };
-            limit?: undefined;
-            tableId?: undefined;
-            leadLimit?: undefined;
-            page?: undefined;
-            filters?: undefined;
-            name?: undefined;
-            clientProspectId?: undefined;
-            senderLinkedinUrl?: undefined;
-            offerPositioning?: undefined;
-            campaignBrief?: undefined;
-            messageGenerationMode?: undefined;
-            currentStep?: undefined;
-            watchNarration?: undefined;
-            leadSourceType?: undefined;
-            leadSourceProvider?: undefined;
-            selectedLeadListId?: undefined;
-            senderIds?: undefined;
-            currentStepTransition?: undefined;
-            clearCurrentStepIfMatches?: undefined;
-            interactionMode?: undefined;
-            enableICPFilters?: undefined;
-            useMessagingTemplate?: undefined;
-            rubric?: undefined;
-            flowVersion?: undefined;
         };
         required: string[];
         additionalProperties?: undefined;
@@ -1724,7 +1604,6 @@ export declare const allTools: ({
             useMessagingTemplate?: undefined;
             rubric?: undefined;
             flowVersion?: undefined;
-            workspaceId?: undefined;
         };
         required: string[];
         additionalProperties?: undefined;
@@ -2430,24 +2309,6 @@ export declare const allTools: ({
         };
         required: string[];
     };
-} | {
-    name: string;
-    description: string;
-    inputSchema: {
-        type: string;
-        properties: {
-            senderId: {
-                type: string;
-                description: string;
-            };
-            workspaceId: {
-                type: string;
-                description: string;
-            };
-        };
-        required: string[];
-        additionalProperties: boolean;
-    };
 } | {
     name: string;
     description: string;
@@ -3080,6 +2941,7 @@ export declare const allTools: ({
             previewOnly?: undefined;
             companySearchToken?: undefined;
             selectedCompanyIds?: undefined;
+            workspaceId?: undefined;
             domainFilterId?: undefined;
             type?: undefined;
             profileUrl?: undefined;
@@ -3276,6 +3138,7 @@ export declare const allTools: ({
             previewOnly?: undefined;
             companySearchToken?: undefined;
             selectedCompanyIds?: undefined;
+            workspaceId?: undefined;
             domainFilterId?: undefined;
             type?: undefined;
             profileUrl?: undefined;
@@ -3371,6 +3234,7 @@ export declare const allTools: ({
             previewOnly?: undefined;
             companySearchToken?: undefined;
             selectedCompanyIds?: undefined;
+            workspaceId?: undefined;
             domainFilterId?: undefined;
             type?: undefined;
             profileUrl?: undefined;
@@ -3538,6 +3402,7 @@ export declare const allTools: ({
             previewOnly?: undefined;
             companySearchToken?: undefined;
             selectedCompanyIds?: undefined;
+            workspaceId?: undefined;
             domainFilterId?: undefined;
             type?: undefined;
             profileUrl?: undefined;
@@ -3647,6 +3512,7 @@ export declare const allTools: ({
             previewOnly?: undefined;
             companySearchToken?: undefined;
             selectedCompanyIds?: undefined;
+            workspaceId?: undefined;
             domainFilterId?: undefined;
             type?: undefined;
             profileUrl?: undefined;
@@ -3765,6 +3631,7 @@ export declare const allTools: ({
             previewOnly?: undefined;
             companySearchToken?: undefined;
             selectedCompanyIds?: undefined;
+            workspaceId?: undefined;
             domainFilterId?: undefined;
             type?: undefined;
             profileUrl?: undefined;
@@ -3872,6 +3739,7 @@ export declare const allTools: ({
             previewOnly?: undefined;
             companySearchToken?: undefined;
             selectedCompanyIds?: undefined;
+            workspaceId?: undefined;
             domainFilterId?: undefined;
             type?: undefined;
             profileUrl?: undefined;
@@ -3984,6 +3852,7 @@ export declare const allTools: ({
             previewOnly?: undefined;
             companySearchToken?: undefined;
             selectedCompanyIds?: undefined;
+            workspaceId?: undefined;
             domainFilterId?: undefined;
             type?: undefined;
             profileUrl?: undefined;
@@ -4084,6 +3953,7 @@ export declare const allTools: ({
             previewOnly?: undefined;
             companySearchToken?: undefined;
             selectedCompanyIds?: undefined;
+            workspaceId?: undefined;
             domainFilterId?: undefined;
             type?: undefined;
             profileUrl?: undefined;
@@ -4976,6 +4846,7 @@ export declare const allTools: ({
             exclude?: undefined;
             companySearchToken?: undefined;
             selectedCompanyIds?: undefined;
+            workspaceId?: undefined;
             domainFilterId?: undefined;
             type?: undefined;
             profileUrl?: undefined;
@@ -5085,6 +4956,7 @@ export declare const allTools: ({
             seedDomains?: undefined;
             sort?: undefined;
             previewOnly?: undefined;
+            workspaceId?: undefined;
             domainFilterId?: undefined;
             type?: undefined;
             profileUrl?: undefined;
@@ -6071,6 +5943,10 @@ export declare const allTools: ({
                 type: string;
                 description: string;
             };
+            workspaceId: {
+                type: string;
+                description: string;
+            };
             searchName: {
                 type: string;
                 description: string;
@@ -6295,6 +6171,7 @@ export declare const allTools: ({
             previewOnly?: undefined;
             companySearchToken?: undefined;
             selectedCompanyIds?: undefined;
+            workspaceId?: undefined;
             domainFilterId?: undefined;
             sourceLeadListId?: undefined;
             targetLeadCount?: undefined;
@@ -6327,6 +6204,10 @@ export declare const allTools: ({
                 type: string;
                 description: string;
             };
+            workspaceId: {
+                type: string;
+                description: string;
+            };
             provider: {
                 type: string;
                 enum: string[];
@@ -6470,6 +6351,10 @@ export declare const allTools: ({
                 type: string;
                 description: string;
             };
+            workspaceId: {
+                type: string;
+                description: string;
+            };
             tableId: {
                 type: string;
                 description: string;
@@ -6568,6 +6453,10 @@ export declare const allTools: ({
                 type: string;
                 description: string;
             };
+            workspaceId: {
+                type: string;
+                description: string;
+            };
             sourceLeadListId: {
                 type: string;
                 description: string;
@@ -6800,6 +6689,7 @@ export declare const allTools: ({
             previewOnly?: undefined;
             companySearchToken?: undefined;
             selectedCompanyIds?: undefined;
+            workspaceId?: undefined;
             domainFilterId?: undefined;
             type?: undefined;
             profileUrl?: undefined;
@@ -6897,6 +6787,7 @@ export declare const allTools: ({
             previewOnly?: undefined;
             companySearchToken?: undefined;
             selectedCompanyIds?: undefined;
+            workspaceId?: undefined;
             domainFilterId?: undefined;
             type?: undefined;
             profileUrl?: undefined;

package/dist/tools/registry.js

@@ -33,6 +33,8 @@ import { onDemandToolDefinitions } from "./one-off.js";
 import { processingToolDefinitions } from "./processing.js";
 import { promptToolDefinitions } from "./prompts.js";
 import { readinessToolDefinitions } from "./readiness.js";
+import { evergreenRefillPlanToolDefinitions } from "./evergreen-refill-plan.js";
+import { refillSendsEvergreenToolDefinitions } from "./refill-sends-evergreen.js";
 import { refillTargetPlanToolDefinitions } from "./refill-target-plan.js";
 import { refillSendsToolDefinitions } from "./refill-sends.js";
 import { rowToolDefinitions } from "./rows.js";
@@ -52,9 +54,11 @@ export const allTools = [
     ...campaignAbTestToolDefinitions,
     ...campaignFillRoutingToolDefinitions,
     ...campaignRefillStateToolDefinitions,
+    ...evergreenRefillPlanToolDefinitions,
     ...refillTargetPlanToolDefinitions,
     ...schedulerFillCapacityToolDefinitions,
     ...refillSendsToolDefinitions,
+    ...refillSendsEvergreenToolDefinitions,
     ...setupEvergreenCampaignsToolDefinitions,
     ...campaignHorizonFillToolDefinitions,
     ...campaignMessagePreparationToolDefinitions,

package/dist/tools/senders.d.ts

@@ -34,7 +34,7 @@ export type SenderDetailResponse = {
 };
 export type RefreshPaidInmailCreditsInput = {
     senderId: string;
-    workspaceId?: string;
+    workspaceId: string;
 };
 export type PaidInmailCreditStatus = {
     available: number;
@@ -47,6 +47,7 @@ export type RefreshPaidInmailCreditsResponse = {
     senderId: string;
     refreshed: true;
     credits: PaidInmailCreditStatus;
+    receipt?: unknown;
     sideEffects: {
         refreshedLinkedInDerivedCreditFacts: true;
         updatedSenderCreditCache: true;

package/dist/tools/senders.js

@@ -136,20 +136,20 @@ export const senderToolDefinitions = [
     },
     {
         name: "refresh_paid_inmail_credits",
-        description: "Refresh the cached paid InMail credit facts for one exact sender in the active workspace by calling Sellable's product credit refresh path. This updates only the sender credit cache (balance, sentSince, checkedAt) and returns the fresh status. It does not mutate campaigns, lower thresholds, approve messages, schedule sends, start campaigns, send messages, spend InMail credits, or write scheduler fields. refill_sends --yolo normally handles get_refill_target_plan refresh_paid_inmail_credits candidates internally; use this standalone tool for manual diagnostics or explicit one-off refreshes, then rerun get_refill_target_plan before any refill mutation.",
+        description: "Refresh the cached paid InMail credit facts for one exact sender in the explicit request-scoped workspace by calling Sellable's scoped MCP credit refresh path. This updates only the sender credit cache/attempt metadata (balance, sentSince, checkedAt, last attempted/error/lease) and returns the sanitized coordinator receipt. It does not mutate campaigns, lower thresholds, approve messages, schedule sends, start campaigns, send messages, spend InMail credits, or write scheduler fields. refill_sends --yolo normally handles get_refill_target_plan refresh_paid_inmail_credits candidates internally; use this standalone tool for manual diagnostics or explicit one-off refreshes, then rerun get_refill_target_plan before any refill mutation.",
         inputSchema: {
             type: "object",
             properties: {
                 senderId: {
                     type: "string",
-                    description: "Exact Sender.id to refresh. The API verifies the sender belongs to the active workspace.",
+                    description: "Exact Sender.id to refresh. The API verifies the sender belongs to the explicit workspace.",
                 },
                 workspaceId: {
                     type: "string",
                     description: "Explicit request-scoped workspace id for scheduled/yolo refill automation. Pass this instead of switching the shared active workspace.",
                 },
             },
-            required: ["senderId"],
+            required: ["senderId", "workspaceId"],
             additionalProperties: false,
         },
     },
@@ -209,15 +209,17 @@ export async function refreshPaidInmailCredits(input) {
     }
     const api = getApi();
     const workspaceId = normalizeExplicitWorkspaceId(input.workspaceId);
+    if (!workspaceId) {
+        throw new Error("workspaceId is required.");
+    }
     const requestOptions = workspaceRequestOptions(workspaceId);
-    const body = workspaceId ? { workspaceId } : {};
-    const result = requestOptions
-        ? await api.post(`/api/v3/senders/${encodeURIComponent(senderId)}/refresh-inmail-credits`, body, requestOptions)
-        : await api.post(`/api/v3/senders/${encodeURIComponent(senderId)}/refresh-inmail-credits`, body);
+    const body = { workspaceId };
+    const result = await api.post(`/api/v3/mcp/senders/${encodeURIComponent(senderId)}/refresh-inmail-credits`, body, requestOptions);
     return {
         senderId,
         refreshed: true,
         credits: normalizeCreditStatus(result?.credits),
+        receipt: result?.receipt,
         sideEffects: {
             refreshedLinkedInDerivedCreditFacts: true,
             updatedSenderCreditCache: true,

package/package.json

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

package/skills/refill-sends/SKILL.md

@@ -7,6 +7,7 @@ allowed-tools:
   - mcp__sellable__get_refill_target_plan
   - mcp__sellable__get_scheduler_fill_capacity
   - mcp__sellable__refresh_paid_inmail_credits
+  - mcp__sellable__get_subskill_asset
   - mcp__sellable__get_auth_status
   - mcp__sellable__start_cli_login
   - mcp__sellable__wait_for_cli_login
@@ -151,19 +152,23 @@ explicitly stops/statuses the run, or a concrete non-scheduler blocker appears.
 Do not call the goal complete or blocked only because the current state is
 `awaiting_scheduler_after_ready_buffer`; treat it as loaded, awaiting scheduler.
 
-Load the internal workflow prompt before taking any operational step:
+Load the internal workflow prompt and deterministic flow asset before taking
+any operational step:
 
 ```text
 get_subskill_prompt({ subskillName: "refill-sends-workflow" })
+get_subskill_asset({ subskillName: "refill-sends-workflow", assetPath: "core/flow.v1.json" })
 ```
 
-Then follow that workflow exactly. The default path is read-only research:
-compute the refill target plan first, resolve the route, identify the
-sender-relevant campaign that most recently had scheduler-owned sends, read
-refill state for that target, report the next safe step using campaign names
-first, and stop before mutation unless the user has explicitly approved the
-exact workspace, campaign/table/source ids, caps/dates, approval mode, expected
-side effects, and stop/rollback condition.
+Continue both loads until `hasMore:false`; parse the flow JSON and verify
+`workflow:"refill-sends-workflow"` with a `v1` version. Then follow that
+workflow exactly. The default path is read-only research: compute the refill
+target plan first, resolve the route, identify the sender-relevant campaign
+that most recently had scheduler-owned sends, read refill state for that target,
+report the next safe step using campaign names first, and stop before mutation
+unless the user has explicitly approved the exact workspace,
+campaign/table/source ids, caps/dates, approval mode, expected side effects,
+and stop/rollback condition.
 
 Immediately after loading the internal workflow, call
 `get_refill_target_plan`. The target plan is the canonical first fact receipt:
@@ -223,6 +228,20 @@ 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.
 
+Freshness gate precedes scheduler wait: if any selected
+`target.senderRefillPlans[].paidInmail.status` is `missing_credit_facts` or
+`stale_credit_facts`, or the target plan contains a
+`refresh_paid_inmail_credits` candidate, do not enter `wait_for_scheduler` even
+when `remainingReadyOrProjectedGap:0`. Refresh the exact selected sender credit
+facts once, rerun `get_refill_target_plan`, and only then decide whether
+scheduler wait is the next safe action. If facts remain missing/stale after the
+single refresh attempt, stop with a paid-InMail freshness blocker instead of
+waiting on scheduler pickup.
+The standalone MCP refresh surface is the scoped route
+`/api/v3/mcp/senders/:senderId/refresh-inmail-credits` with explicit
+`workspaceId`; do not use active-workspace mutation as the automation control
+path.
+
 Compact refill lessons: sender-level target plan is final truth; trust
 `schedulerGate.sendable` and scheduler gate blockers, not raw
 `unipileAccountStatus` labels alone; use compact prep status checks for
@@ -239,8 +258,9 @@ will try to place and does not import, approve, schedule, refresh credits, or
 mutate.
 If the target plan is complete by projected coverage, report that the selected
 target is already filled and no-op without asking for approval. If the ready
-buffer covers the projected gap but scheduled coverage is still short, keep the
-run open in a persistent read-only scheduler wait loop. Poll
+buffer covers the projected gap, paid InMail credit facts are fresh for every
+selected paid-InMail lane, but scheduled coverage is still short, keep the run
+open in a persistent read-only scheduler wait loop. Poll
 `get_refill_target_plan` every 60-120 seconds, or on the host's next continuation
 interval, until projected coverage fills the target, a concrete non-scheduler
 blocker appears, or Christian explicitly asks to stop or only receive a status