@sellable/mcp 0.1.641 → 0.1.642

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

@@ -745,9 +745,127 @@ export declare function executeRefillSendsCommand(input?: RefillSendsCommandInpu
         status: string;
         workspaceTargetPlan: unknown;
         selectedTarget?: undefined;
+        exactTargetPlan?: undefined;
+        note?: undefined;
+        completedTarget?: undefined;
+        exactRunResult?: undefined;
+    };
+    continuation: {
+        required: boolean;
+        userActionRequired: boolean;
+        kind?: undefined;
+        owner?: undefined;
+        tool?: undefined;
+        arguments?: undefined;
+        stopCondition?: undefined;
+    };
+    targetDate: string | null;
+    untilDate: string | null;
+    horizonSendDays: number | null;
+    fillWindow: {
+        mode: string;
+        targetDate: string;
+        description: string;
+        untilDate?: undefined;
+        horizonSendDays?: undefined;
+        horizonHours?: undefined;
+    } | {
+        mode: string;
+        untilDate: string;
+        description: string;
+        targetDate?: undefined;
+        horizonSendDays?: undefined;
+        horizonHours?: undefined;
+    } | {
+        mode: string;
+        horizonSendDays: number | null;
+        horizonHours: number | null;
+        description: string;
+        targetDate?: undefined;
+        untilDate?: undefined;
+    };
+    approvalMode: RefillSendsApprovalMode;
+    campaignId: string | null;
+    tableId: string | null;
+    targetConfig: RefillTargetConfigV1 | null;
+    runHandle: RefillRunHandleV1 | null;
+    reportingContext: RefillReportingContextV2 | null;
+    messageTemplateRevision: MessageTemplateRevisionV1 | null;
+    senderScope: string;
+    senderSelectors: {
+        senders: string[];
+        senderIds: string[];
+        senderNames: string[];
+    };
+    firstOperationalSteps: string[];
+    approvalContract: string;
+    forbiddenActions: string[];
+    hostExamples: {
+        claude: string[];
+        codex: string[];
+        mcpTool: {
+            name: string;
+            arguments: {
+                workspaceCoordinator?: boolean | undefined;
+                messageTemplateRevision?: MessageTemplateRevisionV1 | undefined;
+                reportingContext?: RefillReportingContextV2 | undefined;
+                targetConfig?: RefillTargetConfigV1 | undefined;
+                runHandle?: RefillRunHandleV1 | undefined;
+                fence?: number | undefined;
+                runId?: string | undefined;
+                expectedActionKey?: string | undefined;
+                expectedTargetShapeRevision?: string | undefined;
+                targetDate: string | null;
+                untilDate: string | null;
+                horizonSendDays: number | null;
+                campaignId: string | undefined;
+                tableId: string | undefined;
+                intent: RefillSendsIntent;
+                approvalMode: RefillSendsApprovalMode;
+                workspaceId: string | null;
+                actionTypes?: ("send_invite" | "send_inmail_closed")[] | undefined;
+                yolo: boolean;
+                senders: string[];
+                senderIds: string[];
+                senderNames: string[];
+            };
+        };
+    };
+    actionTypes?: ("send_invite" | "send_inmail_closed")[] | undefined;
+    command: string;
+    tool: string;
+    promptName: string;
+    workflowPromptName: string;
+    workflowAsset: {
+        subskillName: string;
+        assetPath: string;
+    };
+    yolo: boolean;
+    executionMode: RefillSendsExecutionMode;
+    workspaceId: string | null;
+    workspaceResolution: string;
+    intent: RefillSendsIntent;
+} | {
+    status: "terminal";
+    doneReason: "loaded_awaiting_scheduler";
+    note: string;
+    targetPlan: unknown;
+    exactTargetPlan: unknown;
+    orchestration: {
+        mode: string;
+        scope: string;
+        checkpointedFields: string[];
+        transportBudgetMs: number;
+    };
+    coordinator: {
+        scope: string;
+        status: string;
+        selectedTarget: WorkspaceExactTarget;
+        workspaceTargetPlan: unknown;
+        exactTargetPlan: unknown;
+        note: string;
         completedTarget?: undefined;
         exactRunResult?: undefined;
-        note?: undefined;
     };
     continuation: {
         required: boolean;
@@ -857,9 +975,10 @@ export declare function executeRefillSendsCommand(input?: RefillSendsCommandInpu
         status: string;
         selectedTarget: WorkspaceExactTarget | null;
         workspaceTargetPlan?: undefined;
+        exactTargetPlan?: undefined;
+        note?: undefined;
         completedTarget?: undefined;
         exactRunResult?: undefined;
-        note?: undefined;
     };
     continuation: {
         required: boolean;
@@ -1079,6 +1198,7 @@ export declare function executeRefillSendsCommand(input?: RefillSendsCommandInpu
             conflicts?: undefined;
         };
         selectedTarget?: undefined;
+        exactTargetPlan?: undefined;
         note?: undefined;
     };
     continuation: {
@@ -1188,6 +1308,149 @@ export declare function executeRefillSendsCommand(input?: RefillSendsCommandInpu
     workspaceId: string | null;
     workspaceResolution: string;
     intent: RefillSendsIntent;
+} | {
+    status: "terminal";
+    doneReason: "loaded_awaiting_scheduler";
+    note: string;
+    targetPlan: unknown;
+    exactTargetPlan: unknown;
+    orchestration: {
+        mode: string;
+        scope: string;
+        checkpointedFields: string[];
+        transportBudgetMs: number;
+    };
+    coordinator: {
+        scope: string;
+        status: string;
+        completedTarget: WorkspaceExactTarget | null;
+        selectedTarget: WorkspaceExactTarget;
+        workspaceTargetPlan: unknown;
+        exactTargetPlan: unknown;
+        exactRunResult: {
+            runSnapshot: unknown;
+            readOnly: boolean;
+            forbiddenActions: string[];
+            boundedAuthority: string;
+            status: "terminal";
+            doneReason: string;
+            report: Record<string, unknown>;
+            runId: string;
+            guidance?: string;
+            journalPath?: string | null;
+            targetConfig?: RefillTargetConfigV1;
+            runHandle?: RefillRunHandleV1;
+            refillReporting?: Record<string, unknown>;
+            blocker?: undefined;
+            conflicts?: undefined;
+        };
+        note: string;
+    };
+    continuation: {
+        required: boolean;
+        userActionRequired: boolean;
+        kind?: undefined;
+        owner?: undefined;
+        tool?: undefined;
+        arguments?: undefined;
+        stopCondition?: undefined;
+    };
+    runSnapshot: unknown;
+    readOnly: boolean;
+    forbiddenActions: string[];
+    boundedAuthority: string;
+    report: Record<string, unknown>;
+    runId: string;
+    guidance?: string;
+    journalPath?: string | null;
+    targetConfig: RefillTargetConfigV1 | null;
+    runHandle: RefillRunHandleV1 | null;
+    refillReporting?: Record<string, unknown>;
+    blocker?: undefined;
+    conflicts?: undefined;
+    targetDate: string | null;
+    untilDate: string | null;
+    horizonSendDays: number | null;
+    fillWindow: {
+        mode: string;
+        targetDate: string;
+        description: string;
+        untilDate?: undefined;
+        horizonSendDays?: undefined;
+        horizonHours?: undefined;
+    } | {
+        mode: string;
+        untilDate: string;
+        description: string;
+        targetDate?: undefined;
+        horizonSendDays?: undefined;
+        horizonHours?: undefined;
+    } | {
+        mode: string;
+        horizonSendDays: number | null;
+        horizonHours: number | null;
+        description: string;
+        targetDate?: undefined;
+        untilDate?: undefined;
+    };
+    approvalMode: RefillSendsApprovalMode;
+    campaignId: string | null;
+    tableId: string | null;
+    reportingContext: RefillReportingContextV2 | null;
+    messageTemplateRevision: MessageTemplateRevisionV1 | null;
+    senderScope: string;
+    senderSelectors: {
+        senders: string[];
+        senderIds: string[];
+        senderNames: string[];
+    };
+    firstOperationalSteps: string[];
+    approvalContract: string;
+    hostExamples: {
+        claude: string[];
+        codex: string[];
+        mcpTool: {
+            name: string;
+            arguments: {
+                workspaceCoordinator?: boolean | undefined;
+                messageTemplateRevision?: MessageTemplateRevisionV1 | undefined;
+                reportingContext?: RefillReportingContextV2 | undefined;
+                targetConfig?: RefillTargetConfigV1 | undefined;
+                runHandle?: RefillRunHandleV1 | undefined;
+                fence?: number | undefined;
+                runId?: string | undefined;
+                expectedActionKey?: string | undefined;
+                expectedTargetShapeRevision?: string | undefined;
+                targetDate: string | null;
+                untilDate: string | null;
+                horizonSendDays: number | null;
+                campaignId: string | undefined;
+                tableId: string | undefined;
+                intent: RefillSendsIntent;
+                approvalMode: RefillSendsApprovalMode;
+                workspaceId: string | null;
+                actionTypes?: ("send_invite" | "send_inmail_closed")[] | undefined;
+                yolo: boolean;
+                senders: string[];
+                senderIds: string[];
+                senderNames: string[];
+            };
+        };
+    };
+    actionTypes?: ("send_invite" | "send_inmail_closed")[] | undefined;
+    command: string;
+    tool: string;
+    promptName: string;
+    workflowPromptName: string;
+    workflowAsset: {
+        subskillName: string;
+        assetPath: string;
+    };
+    yolo: boolean;
+    executionMode: RefillSendsExecutionMode;
+    workspaceId: string | null;
+    workspaceResolution: string;
+    intent: RefillSendsIntent;
 } | {
     ok: boolean;
     status: "blocked";
@@ -1219,6 +1482,7 @@ export declare function executeRefillSendsCommand(input?: RefillSendsCommandInpu
             conflicts?: undefined;
         };
         workspaceTargetPlan?: undefined;
+        exactTargetPlan?: undefined;
         note?: undefined;
     };
     continuation: {
@@ -1349,6 +1613,7 @@ export declare function executeRefillSendsCommand(input?: RefillSendsCommandInpu
             conflicts?: undefined;
         };
         note: string;
+        exactTargetPlan?: undefined;
     };
     continuation: {
         required: boolean;
@@ -1490,6 +1755,7 @@ export declare function executeRefillSendsCommand(input?: RefillSendsCommandInpu
             conflicts?: undefined;
         };
         workspaceTargetPlan?: undefined;
+        exactTargetPlan?: undefined;
         note?: undefined;
     };
     continuation: {
@@ -1647,9 +1913,9 @@ export declare function executeRefillSendsCommand(input?: RefillSendsCommandInpu
         scope: string;
         status: string | undefined;
         selectedTarget: WorkspaceExactTarget | null;
+        note?: undefined;
         completedTarget?: undefined;
         exactRunResult?: undefined;
-        note?: undefined;
     } | undefined;
     orchestration: {
         checkpointedFields: string[];
@@ -1796,9 +2062,9 @@ export declare function executeRefillSendsCommand(input?: RefillSendsCommandInpu
         scope: string;
         status: string | undefined;
         selectedTarget: WorkspaceExactTarget | null;
+        note?: undefined;
         completedTarget?: undefined;
         exactRunResult?: undefined;
-        note?: undefined;
     } | undefined;
     orchestration: {
         checkpointedFields: string[];
@@ -1949,9 +2215,9 @@ export declare function executeRefillSendsCommand(input?: RefillSendsCommandInpu
         scope: string;
         status: string | undefined;
         selectedTarget: WorkspaceExactTarget | null;
+        note?: undefined;
         completedTarget?: undefined;
         exactRunResult?: undefined;
-        note?: undefined;
     } | undefined;
     orchestration: {
         checkpointedFields: string[];
@@ -2102,9 +2368,9 @@ export declare function executeRefillSendsCommand(input?: RefillSendsCommandInpu
         scope: string;
         status: string | undefined;
         selectedTarget: WorkspaceExactTarget | null;
+        note?: undefined;
         completedTarget?: undefined;
         exactRunResult?: undefined;
-        note?: undefined;
     } | undefined;
     orchestration: {
         checkpointedFields: string[];
@@ -2253,9 +2519,9 @@ export declare function executeRefillSendsCommand(input?: RefillSendsCommandInpu
         scope: string;
         status: string | undefined;
         selectedTarget: WorkspaceExactTarget | null;
+        note?: undefined;
         completedTarget?: undefined;
         exactRunResult?: undefined;
-        note?: undefined;
     } | undefined;
     orchestration: {
         checkpointedFields: string[];
@@ -2407,9 +2673,9 @@ export declare function executeRefillSendsCommand(input?: RefillSendsCommandInpu
         scope: string;
         status: string | undefined;
         selectedTarget: WorkspaceExactTarget | null;
+        note?: undefined;
         completedTarget?: undefined;
         exactRunResult?: undefined;
-        note?: undefined;
     } | undefined;
     orchestration: {
         checkpointedFields: string[];
@@ -2563,9 +2829,9 @@ export declare function executeRefillSendsCommand(input?: RefillSendsCommandInpu
         scope: string;
         status: string | undefined;
         selectedTarget: WorkspaceExactTarget | null;
+        note?: undefined;
         completedTarget?: undefined;
         exactRunResult?: undefined;
-        note?: undefined;
     } | undefined;
     orchestration: {
         checkpointedFields: string[];

package/dist/tools/refill-sends.js

@@ -691,6 +691,9 @@ async function selectWorkspaceExactTarget(input, workspacePlanOverride, options
         };
     }
     let completedExactTargetCount = 0;
+    let schedulerLoadedExactTargetCount = 0;
+    let lastSchedulerLoadedTarget = null;
+    let lastSchedulerLoadedPlan = null;
     for (const selectedTarget of targetCandidates) {
         const exactInput = {
             ...workspaceInput,
@@ -708,6 +711,12 @@ async function selectWorkspaceExactTarget(input, workspacePlanOverride, options
             completedExactTargetCount += 1;
             continue;
         }
+        if (yoloPlanIsSchedulerLoaded(exactTargetPlan)) {
+            schedulerLoadedExactTargetCount += 1;
+            lastSchedulerLoadedTarget = selectedTarget;
+            lastSchedulerLoadedPlan = exactTargetPlan;
+            continue;
+        }
         let targetConfig;
         try {
             targetConfig = normalizeRefillTargetConfig(recordValue(exactTargetPlan)?.targetConfig);
@@ -753,6 +762,15 @@ async function selectWorkspaceExactTarget(input, workspacePlanOverride, options
             targetConfig,
         };
     }
+    if (lastSchedulerLoadedTarget && lastSchedulerLoadedPlan) {
+        return {
+            status: "awaiting_scheduler",
+            note: `All exposed exact targets were already complete or scheduler-loaded; ${schedulerLoadedExactTargetCount} exact targets have enough ready inventory to cover their projected gaps. No identical refill fence was reopened.`,
+            workspacePlan,
+            exactTargetPlan: lastSchedulerLoadedPlan,
+            selectedTarget: lastSchedulerLoadedTarget,
+        };
+    }
     return {
         status: "blocked",
         code: "workspace_exact_target_unavailable",
@@ -781,6 +799,16 @@ function yoloPlanIsComplete(plan) {
             coverage.grossTarget > 0 &&
             coverage.remainingProjectedGap === 0));
 }
+function yoloPlanIsSchedulerLoaded(plan) {
+    const coverage = yoloCoverage(plan);
+    return (coverage.status === "awaiting_scheduler_after_ready_buffer" ||
+        (coverage.status !== "blocked" &&
+            typeof coverage.grossTarget === "number" &&
+            coverage.grossTarget > 0 &&
+            typeof coverage.remainingProjectedGap === "number" &&
+            coverage.remainingProjectedGap > 0 &&
+            coverage.remainingReadyOrProjectedGap === 0));
+}
 function workspaceConnectivityEmptyState(plan) {
     const target = yoloTarget(plan);
     const emptyState = recordValue(target?.emptyState);
@@ -1550,6 +1578,41 @@ export async function executeRefillSendsCommand(input = {}) {
                     },
                 };
             }
+            if (coordinatorSelection.status === "awaiting_scheduler") {
+                return {
+                    ...command,
+                    status: "terminal",
+                    doneReason: "loaded_awaiting_scheduler",
+                    note: coordinatorSelection.note,
+                    targetPlan: coordinatorSelection.workspacePlan,
+                    exactTargetPlan: coordinatorSelection.exactTargetPlan,
+                    orchestration: {
+                        mode: "fenced_bounded_yolo",
+                        scope: "workspace_exact_target_coordinator",
+                        checkpointedFields: [
+                            "runId",
+                            "fence",
+                            "runState",
+                            "actionKey",
+                            "requestId",
+                            "effectId",
+                        ],
+                        transportBudgetMs: 40_000,
+                    },
+                    coordinator: {
+                        scope: "workspace",
+                        status: "loaded_awaiting_scheduler",
+                        selectedTarget: coordinatorSelection.selectedTarget,
+                        workspaceTargetPlan: coordinatorSelection.workspacePlan,
+                        exactTargetPlan: coordinatorSelection.exactTargetPlan,
+                        note: coordinatorSelection.note,
+                    },
+                    continuation: {
+                        required: false,
+                        userActionRequired: false,
+                    },
+                };
+            }
             if (coordinatorSelection.status === "blocked") {
                 return {
                     ...command,
@@ -1774,6 +1837,44 @@ export async function executeRefillSendsCommand(input = {}) {
                     },
                 };
             }
+            if (nextSelection.status === "awaiting_scheduler") {
+                return {
+                    ...command,
+                    ...result,
+                    status: "terminal",
+                    doneReason: "loaded_awaiting_scheduler",
+                    note: nextSelection.note,
+                    targetPlan: nextSelection.workspacePlan,
+                    exactTargetPlan: nextSelection.exactTargetPlan,
+                    orchestration: {
+                        mode: "fenced_bounded_yolo",
+                        scope: "workspace_exact_target_coordinator",
+                        checkpointedFields: [
+                            "runId",
+                            "fence",
+                            "runState",
+                            "actionKey",
+                            "requestId",
+                            "effectId",
+                        ],
+                        transportBudgetMs: 40_000,
+                    },
+                    coordinator: {
+                        scope: "workspace",
+                        status: "loaded_awaiting_scheduler",
+                        completedTarget: selectedCoordinatorTarget,
+                        selectedTarget: nextSelection.selectedTarget,
+                        workspaceTargetPlan: nextSelection.workspacePlan,
+                        exactTargetPlan: nextSelection.exactTargetPlan,
+                        exactRunResult: result,
+                        note: nextSelection.note,
+                    },
+                    continuation: {
+                        required: false,
+                        userActionRequired: false,
+                    },
+                };
+            }
             if (nextSelection.status === "blocked") {
                 return {
                     ...command,

package/package.json

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