@sellable/mcp 0.1.537 → 0.1.538

package/dist/tools/evergreen-refill-plan.d.ts

@@ -3,6 +3,9 @@ type GetRefillPlanV2Input = {
     intent?: "auto" | "evergreen" | "plain" | "active";
     senderIds?: string[];
     runState?: Record<string, unknown>;
+    targetDate?: string | null;
+    untilDate?: string | null;
+    horizonSendDays?: number | null;
     journal?: boolean;
     journalNote?: string;
 };
@@ -38,6 +41,22 @@ export declare const refillPlanV2ToolDefinitions: {
                 enum: string[];
                 description: string;
             };
+            targetDate: {
+                type: string;
+                pattern: string;
+                description: string;
+            };
+            untilDate: {
+                type: string;
+                pattern: string;
+                description: string;
+            };
+            horizonSendDays: {
+                type: string;
+                minimum: number;
+                maximum: number;
+                description: string;
+            };
             journal: {
                 type: string;
                 description: string;

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

@@ -1,5 +1,6 @@
 import * as path from "node:path";
 import { getApi, SellableApiError } from "../api.js";
+import { normalizeRefillDateSelector, refillDateSelectorBody, } from "../refill-date-window.js";
 import { appendIndexLine, appendJournalEvent, createRunJournal, renderBootstrapSection, renderPlanSection, renderTerminalSection, } from "../refill-journal.js";
 import { readRefillWorkspaceState } from "../refill-local-state.js";
 import { normalizeExplicitWorkspaceId, workspaceRequestOptions, } from "./workspace-context.js";
@@ -175,6 +176,22 @@ export const refillPlanV2ToolDefinitions = [
                     enum: ["auto", "evergreen", "plain", "active"],
                     description: 'Planner intent. Defaults to "auto" for refill-sends-v2.',
                 },
+                targetDate: {
+                    type: "string",
+                    pattern: "^\\d{4}-\\d{2}-\\d{2}$",
+                    description: "Optional one exact sender-local date (YYYY-MM-DD) to plan. Takes precedence over untilDate and horizonSendDays.",
+                },
+                untilDate: {
+                    type: "string",
+                    pattern: "^\\d{4}-\\d{2}-\\d{2}$",
+                    description: "Optional inclusive sender-local through-date (YYYY-MM-DD) to plan.",
+                },
+                horizonSendDays: {
+                    type: "number",
+                    minimum: 1,
+                    maximum: 7,
+                    description: "Optional explicit next N sender-local send days to plan.",
+                },
                 journal: {
                     type: "boolean",
                     description: "Set false to skip the local dry-run journal write.",
@@ -197,6 +214,7 @@ export async function getRefillPlanV2(input) {
     const runState = input.runState !== undefined
         ? input.runState
         : buildRunStateFromLocalHints(workspaceId);
+    const dateSelector = normalizeRefillDateSelector(input);
     let raw;
     try {
         raw = await postRefillPlanV2({
@@ -204,6 +222,7 @@ export async function getRefillPlanV2(input) {
             intent: input.intent ?? "auto",
             senderIds: input.senderIds,
             runState,
+            ...refillDateSelectorBody(dateSelector),
         }, workspaceId);
     }
     catch (error) {

package/dist/tools/refill-executors.d.ts

@@ -14,12 +14,6 @@ export type PaidInmailCreditRefreshOptions = {
     maxStalenessSeconds?: number | null;
     paidInmailCreditsMaxStalenessSeconds?: number | null;
 };
-export type PaidInmailRefreshReceiptClassification = {
-    usableCurrentFacts: boolean;
-    status: string;
-    error: string | null;
-    refreshed: boolean;
-};
 export type YoloPrimitiveExecution = {
     enabled: true;
     status: "no_action" | "read_only_reread" | "executed_and_reread" | "refused" | "skipped_after_paid_refresh";
@@ -141,7 +135,6 @@ export declare function userAddedRowsLimitPayloadFromError(error: unknown): User
 export declare function sourceImportInProgressPayloadFromError(error: unknown): SourceImportInProgressPayload | null;
 export declare function paidRefreshActionFrom(value: unknown): PaidInmailRefreshAction | null;
 export declare function collectPaidInmailRefreshActions(plan: unknown): PaidInmailRefreshAction[];
-export declare function classifyPaidInmailRefreshReceipt(value: unknown): PaidInmailRefreshReceiptClassification;
 export declare function firstGlobalAction(plan: unknown): Record<string, unknown> | null;
 export declare function actionIds(action: Record<string, unknown>): Record<string, unknown>;
 export declare function actionToolInput(action: Record<string, unknown>): Record<string, unknown>;

package/dist/tools/refill-executors.js

@@ -10,11 +10,6 @@ const PAID_INMAIL_REFRESH_RETRY_DELAY_MS = Number(process.env.SELLABLE_MCP_PAID_
 const SIGNAL_DISCOVERY_MIN_REFILL_POSTS = 3;
 const SIGNAL_DISCOVERY_MAX_REFILL_POSTS = 10;
 const SIGNAL_DISCOVERY_TARGET_ROWS_PER_POST = 150;
-const USABLE_PAID_INMAIL_REFRESH_RECEIPT_STATUSES = new Set([
-    "fresh",
-    "refreshed",
-    "below_threshold",
-]);
 export function normalizeStrings(values) {
     if (!Array.isArray(values))
         return [];
@@ -211,23 +206,6 @@ export function collectPaidInmailRefreshActions(plan) {
         add(action);
     return [...bySender.values()];
 }
-export function classifyPaidInmailRefreshReceipt(value) {
-    const response = recordValue(value);
-    const nestedReceipt = recordValue(response?.receipt);
-    const status = stringValue(nestedReceipt?.status) ??
-        stringValue(response?.status) ??
-        (response?.refreshed === true ? "refreshed" : "not_refreshed");
-    const refreshed = response?.refreshed === true || nestedReceipt?.refreshed === true;
-    const usableCurrentFacts = refreshed || USABLE_PAID_INMAIL_REFRESH_RECEIPT_STATUSES.has(status);
-    return {
-        usableCurrentFacts,
-        status,
-        refreshed,
-        error: stringValue(response?.error) ??
-            stringValue(nestedReceipt?.error) ??
-            (usableCurrentFacts ? null : "paid InMail credit refresh did not return usable current facts"),
-    };
-}
 export function firstGlobalAction(plan) {
     const root = recordValue(plan);
     const target = recordValue(root?.target);

package/dist/tools/refill-sends-evergreen.d.ts

@@ -0,0 +1,28 @@
+type RefillSendsEvergreenInput = {
+    workspaceId?: string;
+};
+export declare const refillSendsEvergreenToolDefinitions: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            workspaceId: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+        additionalProperties: boolean;
+    };
+}[];
+export declare function refillSendsEvergreenCommand(input: RefillSendsEvergreenInput): {
+    readOnly: boolean;
+    workspaceId: string | null;
+    firstOperationalSteps: string[];
+    approvalContract: string;
+    forbiddenActions: string[];
+    fillWindow: string;
+    hostExamples: string[];
+};
+export {};

package/dist/tools/refill-sends-evergreen.js

@@ -0,0 +1,47 @@
+export const refillSendsEvergreenToolDefinitions = [
+    {
+        name: "refill_sends_evergreen",
+        description: "Read-only Phase 85 evergreen refill command contract. It performs no mutations and only tells the operator to call get_evergreen_refill_plan for a dry-run packet and journal.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                workspaceId: {
+                    type: "string",
+                    description: "Explicit request-scoped workspace id.",
+                },
+            },
+            required: ["workspaceId"],
+            additionalProperties: false,
+        },
+    },
+];
+export function refillSendsEvergreenCommand(input) {
+    return {
+        readOnly: true,
+        workspaceId: input.workspaceId ?? null,
+        firstOperationalSteps: [
+            "Call get_evergreen_refill_plan with the explicit workspaceId.",
+            "Read the returned packet, globalActionQueue, per-sender plans, and itinerary before taking any action.",
+            "Review the dry-run journal file path returned by get_evergreen_refill_plan.",
+            "Phase 85 is PLAN-ONLY; execution arrives in Phase 86.",
+        ],
+        approvalContract: "Nothing is approved or executable in Phase 85. The evergreen command is read-only; Phase 86 introduces execution approval.",
+        forbiddenActions: [
+            "Do not schedule sends.",
+            "Do not send messages.",
+            "Do not approve messages.",
+            "Do not prepare messages.",
+            "Do not start or launch campaigns.",
+            "Do not create campaigns.",
+            "Do not switch providers or source families.",
+            "Do not lower paid InMail thresholds.",
+            "Do not refresh paid InMail credits.",
+            "Do not write scheduler fields.",
+        ],
+        fillWindow: "Use only the target window and caps returned by get_evergreen_refill_plan.",
+        hostExamples: [
+            "refill_sends_evergreen({ workspaceId })",
+            "get_evergreen_refill_plan({ workspaceId })",
+        ],
+    };
+}

package/dist/tools/refill-sends-v2.d.ts

@@ -6,6 +6,9 @@ type RefillSendsV2Input = {
     approvalMode?: "approve" | "mark_ready";
     senderIds?: string[];
     intent?: "auto" | "evergreen" | "plain" | "active";
+    targetDate?: string | null;
+    untilDate?: string | null;
+    horizonSendDays?: number | null;
 };
 export declare const refillSendsV2ToolDefinitions: {
     name: string;
@@ -44,6 +47,22 @@ export declare const refillSendsV2ToolDefinitions: {
                 type: string;
                 enum: string[];
             };
+            targetDate: {
+                type: string;
+                pattern: string;
+                description: string;
+            };
+            untilDate: {
+                type: string;
+                pattern: string;
+                description: string;
+            };
+            horizonSendDays: {
+                type: string;
+                minimum: number;
+                maximum: number;
+                description: string;
+            };
         };
         required: string[];
         additionalProperties: boolean;

package/dist/tools/refill-sends-v2.js

@@ -18,7 +18,7 @@ const BOUNDED_AUTHORITY = "Within the refill run, bounded approvals, preparation
 export const refillSendsV2ToolDefinitions = [
     {
         name: "refill_sends_v2",
-        description: "Execute the refill sends v2 loop with run-record fencing, packet re-planning, shared refill executors, and resumable dry-run/real-run modes.",
+        description: "Execute the refill sends v2 loop with run-record fencing, packet re-planning, shared refill executors, and resumable dry-run/real-run modes. Date selectors match refill_sends: targetDate is one exact sender-local date, untilDate is inclusive, horizonSendDays is the next N sender-local send days, with precedence targetDate > untilDate > horizonSendDays > default scheduler-forward planning.",
         inputSchema: {
             type: "object",
             properties: {
@@ -51,6 +51,22 @@ export const refillSendsV2ToolDefinitions = [
                     type: "string",
                     enum: ["auto", "evergreen", "plain", "active"],
                 },
+                targetDate: {
+                    type: "string",
+                    pattern: "^\\d{4}-\\d{2}-\\d{2}$",
+                    description: "Optional one exact sender-local date (YYYY-MM-DD) to refill.",
+                },
+                untilDate: {
+                    type: "string",
+                    pattern: "^\\d{4}-\\d{2}-\\d{2}$",
+                    description: "Optional inclusive sender-local through-date (YYYY-MM-DD) to refill.",
+                },
+                horizonSendDays: {
+                    type: "number",
+                    minimum: 1,
+                    maximum: 7,
+                    description: "Optional explicit next N sender-local send days to refill.",
+                },
             },
             required: ["workspaceId"],
             additionalProperties: false,
@@ -99,6 +115,9 @@ export async function refillSendsV2Command(input) {
             workspaceId,
             intent: input.intent,
             senderIds: input.senderIds,
+            targetDate: input.targetDate,
+            untilDate: input.untilDate,
+            horizonSendDays: input.horizonSendDays,
             journal: true,
         });
         return {
@@ -113,6 +132,9 @@ export async function refillSendsV2Command(input) {
         workspaceId,
         intent: input.intent,
         senderIds: input.senderIds,
+        targetDate: input.targetDate,
+        untilDate: input.untilDate,
+        horizonSendDays: input.horizonSendDays,
         approvalMode: input.approvalMode ?? "approve",
         resume: resumeHandle(input),
     }, {
@@ -129,6 +151,9 @@ export async function refillSendsV2Command(input) {
             workspaceId: planInput.workspaceId,
             intent: planInput.intent,
             senderIds: planInput.senderIds,
+            targetDate: planInput.targetDate,
+            untilDate: planInput.untilDate,
+            horizonSendDays: planInput.horizonSendDays,
             runState: planInput.runState,
             journal: planInput.journal,
         }),
@@ -153,7 +178,11 @@ export async function refillSendsV2Command(input) {
         localState: {
             writeRefillWorkspaceState,
         },
-        requestSchedulerRun: (workspaceId) => runSchedulerSweep({ workspaceId, action: "run" }),
+        requestSchedulerRun: (workspaceId, options) => runSchedulerSweep({
+            workspaceId,
+            action: "run",
+            targetDate: options?.targetDate,
+        }),
     });
     return {
         ...(await maybeAddLostFenceGuidance(result, { ...input, workspaceId })),

package/dist/tools/refill-sends.d.ts

@@ -292,8 +292,6 @@ export declare function executeRefillSendsCommand(input?: RefillSendsCommandInpu
             attempts?: number;
             error: string;
             errors?: string[];
-            receiptStatus?: string;
-            receipt?: unknown;
         }[];
         refreshReceipts: {
             senderId: string;
@@ -303,8 +301,6 @@ export declare function executeRefillSendsCommand(input?: RefillSendsCommandInpu
             approvalSource: string;
             approvalPacket: PaidInmailRefreshApprovalPacket;
             receipt: import("./senders.js").RefreshPaidInmailCreditsResponse;
-            receiptStatus: string;
-            usableCurrentFacts: boolean;
         }[];
         attemptedSenderIds: string[];
         targetPlanReread: boolean;
@@ -313,14 +309,6 @@ export declare function executeRefillSendsCommand(input?: RefillSendsCommandInpu
         note: string;
     };
     yoloExecution: {
-        enabled: false;
-        status: "not_run_without_yolo";
-        selectedAction: null;
-        targetPlanReread: false;
-        result?: undefined;
-        refusalReason?: undefined;
-        postActionFirstAction?: undefined;
-    } | {
         enabled: true;
         status: "skipped_after_paid_refresh";
         selectedAction: null;

package/dist/tools/refill-sends.js

@@ -1,14 +1,18 @@
-import { actionIds, classifyPaidInmailRefreshReceipt, collectPaidInmailRefreshActions, executeOneYoloPrimitive, firstGlobalAction, normalizeStrings, numberValue, recordValue, refreshPaidInmailCreditsWithRetry, stringValue, } from "./refill-executors.js";
+import { actionIds, collectPaidInmailRefreshActions, executeOneYoloPrimitive, firstGlobalAction, normalizeStrings, numberValue, recordValue, refreshPaidInmailCreditsWithRetry, stringValue, } from "./refill-executors.js";
 import { getRefillTargetPlan } from "./refill-target-plan.js";
 import { createWorkspaceContext, normalizeExplicitWorkspaceId, } from "./workspace-context.js";
 const DEFAULT_SCHEDULER_FORWARD_HOURS = 48;
 const MCP_PAID_INMAIL_CREDITS_MAX_STALENESS_SECONDS = 4 * 60 * 60;
 function normalizeHorizonSendDays(value) {
-    if (value === undefined || value === null)
+    if (value === undefined)
         return null;
-    if (typeof value !== "number" || !Number.isFinite(value))
-        return null;
-    return Math.max(1, Math.min(7, Math.floor(value)));
+    if (typeof value !== "number" ||
+        !Number.isInteger(value) ||
+        value < 1 ||
+        value > 7) {
+        throw new Error("horizonSendDays must be an integer between 1 and 7.");
+    }
+    return value;
 }
 function normalizeUntilDate(value) {
     if (value === undefined || value === null || value === "")
@@ -91,7 +95,7 @@ export const refillSendsToolDefinitions = [
                     type: "number",
                     minimum: 1,
                     maximum: 7,
-                    description: "Compatibility override for an explicit sender-local send-day horizon. Omit for the default scheduler-forward 48-hour target window.",
+                    description: "Compatibility override for explicit next N sender-local send days. Omit for the default scheduler-forward 48-hour target window.",
                 },
                 untilDate: {
                     type: "string",
@@ -184,7 +188,7 @@ export function refillSendsCommand(input = {}) {
                     horizonHours: horizonSendDays === null ? DEFAULT_SCHEDULER_FORWARD_HOURS : null,
                     description: horizonSendDays === null
                         ? "Fill the default scheduler-forward 48-hour target window."
-                        : "Fill the explicit compatibility horizon by sender-local send days.",
+                        : `Fill the next ${horizonSendDays} sender-local send days.`,
                 },
         approvalMode,
         campaignId: input.campaignId ?? null,
@@ -231,7 +235,7 @@ export function refillSendsCommand(input = {}) {
             "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.",
             "Source/fallback primitives require receipt-proven exhaustion: existingRowFrontier.hasMoreFrontierRows:false, approvalCandidates:0, no fresh active prep, no stuckActiveCells, and no non-terminal approvedNotDispatched rows. Treat anomalies, stuckActiveCells, and non-terminal approvedNotDispatched as diagnose-and-report gates, not exhaustion. Terminal approvedNotDispatched blockers may be reported and then the ladder can proceed.",
-            "In manual/non-yolo, scheduled, and --yolo modes, this tool may automatically refresh stale or missing paid-InMail credit facts once per selected sender when the first target plan returns refresh_paid_inmail_credits candidates. This is the only newly allowed automatic write in manual/non-yolo mode; it reruns get_refill_target_plan and returns autoPaidInmailRefresh with attemptedSenderIds, refreshedPaidInmailSenderIds, failedPaidInmailRefreshes, and the post-refresh targetPlan before any prep/source-copy/bounded-approval/read-only wait 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/bounded-approval/read-only wait action is chosen.",
             "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 refresh_paid_inmail_credits, do not enter wait_for_scheduler even when remainingReadyOrProjectedGap is 0; refresh exact sender credit facts once, reread get_refill_target_plan, then choose scheduler wait only if freshness is clean.",
             "Scheduler-run receipt interpretation: cellsConsidered is allocation-attempt count, readyCellsFound is ready inventory before prefilters, and campaignScopeSummary must include the selected campaign/table before inferring it was ready-but-blocked. Read prefiltered, skipped, and deferred separately. For ready closed-InMail cells with stale paid-credit facts, route to refresh_paid_inmail_credits_then_rerun once, then rerun/status. wait_for_capacity_or_window means report loaded/capped/waiting and do not source or prep more rows. no_ready_cells_continue_refill_prep means return to the refill/prep ladder.",
             "For wait_for_active_work and wait_for_scheduler, honor the receipt's absolute wait.deadlineAt when present. If the deadline is expired on this call, escalate to diagnostics with the receipt evidence instead of issuing another blind wait.",
@@ -375,11 +379,7 @@ export async function executeRefillSendsCommand(input = {}) {
         ? { ...input, workspaceId: workspaceContext.context.workspaceId }
         : input;
     const command = refillSendsCommand(scopedInput);
-    const workspaceId = workspaceContext && workspaceContext.ok
-        ? workspaceContext.context.workspaceId
-        : normalizeExplicitWorkspaceId(scopedInput.workspaceId);
-    const canRefreshPaidInmailFacts = yolo || executionMode === "scheduled" || Boolean(workspaceId);
-    if (!canRefreshPaidInmailFacts) {
+    if (!yolo) {
         return {
             ...command,
             autoPaidInmailRefresh: {
@@ -387,7 +387,7 @@ export async function executeRefillSendsCommand(input = {}) {
                 status: "not_run_without_yolo",
                 refreshedPaidInmailSenderIds: [],
                 failedPaidInmailRefreshes: [],
-                note: "Automatic paid InMail credit refresh requires --yolo, scheduled mode, or an explicit workspaceId so the request can refresh exact sender facts safely.",
+                note: "Automatic paid InMail credit refresh only runs for --yolo refill_sends calls.",
             },
             yoloExecution: {
                 enabled: false,
@@ -397,6 +397,9 @@ export async function executeRefillSendsCommand(input = {}) {
             },
         };
     }
+    const workspaceId = workspaceContext && workspaceContext.ok
+        ? workspaceContext.context.workspaceId
+        : normalizeExplicitWorkspaceId(scopedInput.workspaceId);
     const targetPlanInput = targetPlanInputFor(scopedInput);
     const targetPlanBeforePaidRefresh = await getRefillTargetPlan(targetPlanInput);
     const refreshActions = collectPaidInmailRefreshActions(targetPlanBeforePaidRefresh);
@@ -422,7 +425,7 @@ export async function executeRefillSendsCommand(input = {}) {
         }
         const refreshResult = await refreshPaidInmailCreditsWithRetry(action.senderId, workspaceId, paidRefreshOptionsFromApprovalPacket(approvalPacket));
         if (refreshResult.receipt) {
-            const classification = classifyPaidInmailRefreshReceipt(refreshResult.receipt);
+            refreshedPaidInmailSenderIds.push(action.senderId);
             refreshReceipts.push({
                 senderId: action.senderId,
                 actionKey: action.actionKey ?? null,
@@ -431,23 +434,7 @@ export async function executeRefillSendsCommand(input = {}) {
                 approvalSource: "explicit_yolo_flag",
                 approvalPacket,
                 receipt: refreshResult.receipt,
-                receiptStatus: classification.status,
-                usableCurrentFacts: classification.usableCurrentFacts,
             });
-            if (classification.usableCurrentFacts) {
-                refreshedPaidInmailSenderIds.push(action.senderId);
-            }
-            else {
-                failedPaidInmailRefreshes.push({
-                    senderId: action.senderId,
-                    attempts: refreshResult.attempts,
-                    error: classification.error ??
-                        "paid InMail credit refresh did not return usable current facts",
-                    errors: refreshResult.errors,
-                    receiptStatus: classification.status,
-                    receipt: refreshResult.receipt,
-                });
-            }
         }
         else {
             failedPaidInmailRefreshes.push({
@@ -462,8 +449,8 @@ export async function executeRefillSendsCommand(input = {}) {
     const targetPlan = refreshActions.length > 0
         ? await getRefillTargetPlan(targetPlanInput)
         : targetPlanBeforePaidRefresh;
-    const selectedAction = yolo && refreshActions.length === 0 ? firstGlobalAction(targetPlan) : null;
-    const primitiveAttempt = !yolo || refreshActions.length > 0
+    const selectedAction = refreshActions.length > 0 ? null : firstGlobalAction(targetPlan);
+    const primitiveAttempt = refreshActions.length > 0
         ? null
         : await executeOneYoloPrimitive(selectedAction, workspaceId ?? undefined);
     const shouldRereadAfterPrimitive = primitiveAttempt?.status === "executed_and_reread" ||
@@ -476,9 +463,7 @@ export async function executeRefillSendsCommand(input = {}) {
         ...command,
         targetPlan: finalTargetPlan,
         targetPlanBeforePaidRefresh: refreshActions.length > 0 ? targetPlanBeforePaidRefresh : null,
-        targetPlanBeforeYoloPrimitive: yolo && refreshActions.length === 0 && postActionTargetPlan
-            ? targetPlan
-            : null,
+        targetPlanBeforeYoloPrimitive: refreshActions.length === 0 && postActionTargetPlan ? targetPlan : null,
         autoPaidInmailRefresh: {
             enabled: true,
             status: refreshActions.length === 0
@@ -497,30 +482,23 @@ export async function executeRefillSendsCommand(input = {}) {
                 ? "refill_sends refreshed stale paid InMail credit facts internally with bounded retries, 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: !yolo
+        yoloExecution: refreshActions.length > 0
             ? {
-                enabled: false,
-                status: "not_run_without_yolo",
+                enabled: true,
+                status: "skipped_after_paid_refresh",
                 selectedAction: null,
-                targetPlanReread: false,
+                targetPlanReread: true,
             }
-            : 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,
-                },
+            : {
+                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

@@ -1026,6 +1026,16 @@ function sanitizeRefillTargetPlanResult(result) {
         mcpSanitizedRefillLanes: true,
     };
 }
+function stripInternalTargetDateKeys(value) {
+    if (Array.isArray(value)) {
+        return value.map((item) => stripInternalTargetDateKeys(item));
+    }
+    if (!isRecord(value))
+        return value;
+    return Object.fromEntries(Object.entries(value)
+        .filter(([key]) => key !== "targetDateKey")
+        .map(([key, nested]) => [key, stripInternalTargetDateKeys(nested)]));
+}
 export const refillTargetPlanToolDefinitions = [
     {
         name: "get_refill_target_plan",
@@ -1042,7 +1052,7 @@ export const refillTargetPlanToolDefinitions = [
                     type: "number",
                     minimum: 1,
                     maximum: 7,
-                    description: "Compatibility override for explicit sender-local send-day horizon planning. Omit for the default scheduler-forward 48-hour target window; no-send days contribute zero target.",
+                    description: "Compatibility override for explicit next N sender-local send days. Omit for the default scheduler-forward 48-hour target window; no-send days are skipped while choosing the requested send days.",
                 },
                 untilDate: {
                     type: "string",
@@ -1052,7 +1062,7 @@ export const refillTargetPlanToolDefinitions = [
                 targetDate: {
                     type: "string",
                     pattern: "^\\d{4}-\\d{2}-\\d{2}$",
-                    description: "Optional exact sender-local YYYY-MM-DD date to fill. Distinct from untilDate: targetDate asks how many scheduler-fillable slots exist on only this date.",
+                    description: "Optional one exact sender-local date (YYYY-MM-DD) to fill. Distinct from untilDate: targetDate asks how many scheduler-fillable slots exist on only this date.",
                 },
                 campaignId: {
                     type: "string",
@@ -1102,11 +1112,14 @@ export const refillTargetPlanToolDefinitions = [
 ];
 export async function getRefillTargetPlan(input = {}) {
     const workspaceId = normalizeExplicitWorkspaceId(input.workspaceId);
+    const targetDate = input.targetDate;
+    const untilDate = targetDate ? undefined : input.untilDate;
+    const horizonSendDays = targetDate || untilDate ? undefined : input.horizonSendDays;
     const result = await postRefillTargetPlan({
         intent: input.intent,
-        horizonSendDays: input.horizonSendDays,
-        untilDate: input.untilDate,
-        targetDate: input.targetDate,
+        horizonSendDays,
+        untilDate,
+        targetDate,
         campaignId: input.campaignId,
         tableId: input.tableId,
         senderIds: input.senderIds,
@@ -1117,7 +1130,7 @@ export async function getRefillTargetPlan(input = {}) {
         paidInmailCreditsMaxStalenessSeconds: MCP_PAID_INMAIL_CREDITS_MAX_STALENESS_SECONDS,
         ...(workspaceId ? { workspaceId } : {}),
     }, workspaceId ?? undefined);
-    const sanitized = sanitizeRefillTargetPlanResult(result);
+    const sanitized = stripInternalTargetDateKeys(sanitizeRefillTargetPlanResult(result));
     if (!workspaceId || !isRecord(sanitized))
         return sanitized;
     return {

package/dist/tools/registry.d.ts

@@ -2758,6 +2758,22 @@ export declare const allTools: ({
                 enum: string[];
                 description: string;
             };
+            targetDate: {
+                type: string;
+                pattern: string;
+                description: string;
+            };
+            untilDate: {
+                type: string;
+                pattern: string;
+                description: string;
+            };
+            horizonSendDays: {
+                type: string;
+                minimum: number;
+                maximum: number;
+                description: string;
+            };
             journal: {
                 type: string;
                 description: string;
@@ -7385,6 +7401,10 @@ export declare const allTools: ({
                 enum: string[];
                 description: string;
             };
+            targetDate: {
+                type: string;
+                description: string;
+            };
         };
         required: string[];
         additionalProperties: boolean;
@@ -7426,6 +7446,22 @@ export declare const allTools: ({
                 type: string;
                 enum: string[];
             };
+            targetDate: {
+                type: string;
+                pattern: string;
+                description: string;
+            };
+            untilDate: {
+                type: string;
+                pattern: string;
+                description: string;
+            };
+            horizonSendDays: {
+                type: string;
+                minimum: number;
+                maximum: number;
+                description: string;
+            };
         };
         required: string[];
         additionalProperties: boolean;