@sellable/mcp 0.1.513 → 0.1.514

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

@@ -1,5 +1,11 @@
 type RefillSendsV2Input = {
     workspaceId?: string;
+    runId?: string;
+    fence?: number;
+    dryRun?: boolean;
+    approvalMode?: "approve" | "mark_ready";
+    senderIds?: string[];
+    intent?: "auto" | "evergreen" | "plain" | "active";
 };
 export declare const refillSendsV2ToolDefinitions: {
     name: string;
@@ -11,18 +17,99 @@ export declare const refillSendsV2ToolDefinitions: {
                 type: string;
                 description: string;
             };
+            runId: {
+                type: string;
+                description: string;
+            };
+            fence: {
+                type: string;
+                description: string;
+            };
+            dryRun: {
+                type: string;
+                description: string;
+            };
+            approvalMode: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            senderIds: {
+                type: string;
+                items: {
+                    type: string;
+                };
+            };
+            intent: {
+                type: string;
+                enum: string[];
+            };
         };
         required: string[];
         additionalProperties: boolean;
     };
 }[];
-export declare function refillSendsV2Command(input: RefillSendsV2Input): {
+export declare function refillSendsV2Command(input: RefillSendsV2Input): Promise<{
     readOnly: boolean;
-    workspaceId: string | null;
-    firstOperationalSteps: string[];
-    approvalContract: string;
+    mode: string;
     forbiddenActions: string[];
-    fillWindow: string;
-    hostExamples: string[];
-};
+    boundedAuthority: string;
+    blocker: string;
+    workspaceId: string;
+    guidance: string;
+    warnings: string[];
+    journalPath: string | null;
+    text: string;
+    workspaceResolution: string;
+} | {
+    readOnly: boolean;
+    mode: string;
+    forbiddenActions: string[];
+    boundedAuthority: string;
+    warnings: any[];
+    journalPath: string | null;
+    text: string;
+    workspaceId: string;
+    workspaceResolution: string;
+    blocker?: undefined;
+    guidance?: undefined;
+} | {
+    readOnly: boolean;
+    forbiddenActions: string[];
+    boundedAuthority: string;
+    status: "dry_run";
+    plan: Record<string, unknown>;
+} | {
+    readOnly: boolean;
+    forbiddenActions: string[];
+    boundedAuthority: string;
+    status: "in_progress";
+    runId: string;
+    fence: number;
+    gate: import("../refill-run-loop.js").RefillLoopGate;
+    guidance: string;
+    journalPath?: string | null;
+} | {
+    readOnly: boolean;
+    forbiddenActions: string[];
+    boundedAuthority: string;
+    status: "blocked";
+    blocker: string;
+    runId?: string;
+    fence?: number;
+    gate?: import("../refill-run-loop.js").RefillLoopGate;
+    guidance: string;
+    holderRunId?: string;
+    report?: Record<string, unknown>;
+    journalPath?: string | null;
+} | {
+    readOnly: boolean;
+    forbiddenActions: string[];
+    boundedAuthority: string;
+    status: "terminal";
+    doneReason: string;
+    report: Record<string, unknown>;
+    runId: string;
+    journalPath?: string | null;
+}>;
 export {};

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

@@ -1,7 +1,23 @@
+import { appendIndexLine, appendJournalEvent, createRunJournal, renderBootstrapSection, renderCrashedAbandonedSection, renderExecutionEventSection, renderPlanSection, renderTerminalSection, } from "../refill-journal.js";
+import { writeRefillWorkspaceState } from "../refill-local-state.js";
+import { advanceRefillRunGateRemote, completeRefillRun, heartbeatRefillRun, recordRunOutcome, recordRunPlanned, refillRunStatus, startRefillRunRemote, } from "../refill-run-client.js";
+import { runRefillV2Loop } from "../refill-run-loop.js";
+import { getPrepareCampaignMessagesStatus } from "./campaign-message-preparation.js";
+import { getRefillPlanV2 } from "./evergreen-refill-plan.js";
+import { executeOneYoloPrimitive, executeStartCampaignPrimitive, prepareRowSelectorValue, refillPrepareRequestHash, refreshPaidInmailCreditsWithRetry, } from "./refill-executors.js";
+const FORBIDDEN_ACTIONS = [
+    "Do not schedule sends.",
+    "Do not send messages.",
+    "Do not create campaigns.",
+    "Do not switch providers or source families.",
+    "Do not lower paid InMail thresholds.",
+    "Do not write scheduler fields.",
+];
+const BOUNDED_AUTHORITY = "Within the refill run, bounded approvals, preparation jobs, source copies, saved signal continuations, pinned-lane campaign starts, and paid-credit refreshes may execute only when named by the current packet and logged planned -> did -> outcome.";
 export const refillSendsV2ToolDefinitions = [
     {
         name: "refill_sends_v2",
-        description: "Read-only refill sends v2 command contract. It performs no mutations and tells the operator to call get_refill_plan_v2 for a dry-run packet and journal across managed waterfall, dashboard evergreen, and active campaign lanes.",
+        description: "Execute the refill sends v2 loop with run-record fencing, packet re-planning, shared refill executors, and resumable dry-run/real-run modes.",
         inputSchema: {
             type: "object",
             properties: {
@@ -9,41 +25,138 @@ export const refillSendsV2ToolDefinitions = [
                     type: "string",
                     description: "Explicit request-scoped workspace id.",
                 },
+                runId: {
+                    type: "string",
+                    description: "Optional refill run id to resume.",
+                },
+                fence: {
+                    type: "number",
+                    description: "Optional refill run fence to resume.",
+                },
+                dryRun: {
+                    type: "boolean",
+                    description: "When true, read the v2 packet and write only a dry-run journal.",
+                },
+                approvalMode: {
+                    type: "string",
+                    enum: ["approve", "mark_ready"],
+                    description: 'Message approval behavior for packet-named prep/approval actions. Defaults to "approve".',
+                },
+                senderIds: {
+                    type: "array",
+                    items: { type: "string" },
+                },
+                intent: {
+                    type: "string",
+                    enum: ["auto", "evergreen", "plain", "active"],
+                },
             },
             required: ["workspaceId"],
             additionalProperties: false,
         },
     },
 ];
-export function refillSendsV2Command(input) {
+function normalizeWorkspaceId(workspaceId) {
+    if (!workspaceId?.trim()) {
+        throw new Error("workspaceId is required for refill_sends_v2.");
+    }
+    return workspaceId.trim();
+}
+function resumeHandle(input) {
+    return input.runId && typeof input.fence === "number"
+        ? { runId: input.runId, fence: input.fence }
+        : undefined;
+}
+async function maybeAddLostFenceGuidance(result, input) {
+    if (result.status !== "blocked" ||
+        result.blocker !== "lease_lost" ||
+        !input.runId) {
+        return result;
+    }
+    try {
+        const status = await refillRunStatus({
+            workspaceId: input.workspaceId,
+            runId: input.runId,
+        });
+        return {
+            ...result,
+            guidance: [
+                result.guidance,
+                "Lease lockout window is approximately 10 minutes.",
+                `Holder status: ${JSON.stringify(status)}`,
+            ].join(" "),
+        };
+    }
+    catch {
+        return result;
+    }
+}
+export async function refillSendsV2Command(input) {
+    const workspaceId = normalizeWorkspaceId(input.workspaceId);
+    if (input.dryRun) {
+        const plan = await getRefillPlanV2({
+            workspaceId,
+            intent: input.intent,
+            senderIds: input.senderIds,
+            journal: true,
+        });
+        return {
+            ...plan,
+            readOnly: true,
+            mode: "dry_run",
+            forbiddenActions: FORBIDDEN_ACTIONS,
+            boundedAuthority: BOUNDED_AUTHORITY,
+        };
+    }
+    const result = await runRefillV2Loop({
+        workspaceId,
+        intent: input.intent,
+        senderIds: input.senderIds,
+        approvalMode: input.approvalMode ?? "approve",
+        resume: resumeHandle(input),
+    }, {
+        runClient: {
+            startRefillRunRemote,
+            refillRunStatus,
+            heartbeatRefillRun,
+            advanceRefillRunGateRemote,
+            recordRunPlanned,
+            recordRunOutcome,
+            completeRefillRun,
+        },
+        readPlan: async (planInput) => getRefillPlanV2({
+            workspaceId: planInput.workspaceId,
+            intent: planInput.intent,
+            senderIds: planInput.senderIds,
+            runState: planInput.runState,
+            journal: planInput.journal,
+        }),
+        executors: {
+            executeOneYoloPrimitive,
+            executeStartCampaignPrimitive,
+            refreshPaidInmailCreditsWithRetry,
+            getPrepareCampaignMessagesStatus,
+            refillPrepareRequestHash,
+            prepareRowSelectorValue,
+        },
+        journal: {
+            createRunJournal,
+            appendJournalEvent,
+            renderBootstrapSection,
+            renderPlanSection,
+            renderExecutionEventSection,
+            renderCrashedAbandonedSection,
+            renderTerminalSection,
+            appendIndexLine,
+        },
+        localState: {
+            writeRefillWorkspaceState,
+        },
+    });
     return {
-        readOnly: true,
-        workspaceId: input.workspaceId ?? null,
-        firstOperationalSteps: [
-            "Call get_refill_plan_v2 first with the explicit workspaceId.",
-            "Read the returned packet, globalActionQueue, per-sender plans, laneOrder source labels, laneChain values, and itinerary before taking any action.",
-            "Confirm which lane source was selected for each sender: managed_waterfall, dashboard_evergreen, or active_campaign.",
-            "Review the refill v2 dry-run journal file path returned by get_refill_plan_v2.",
-            "If the packet reports no_refillable_campaigns or workspace_access, stop and report that blocker instead of mutating.",
-            "This command is PLAN-ONLY; execution arrives in Phase 86.",
-        ],
-        approvalContract: "Nothing is approved or executable in Phase 87. The refill_sends_v2 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_refill_plan_v2.",
-        hostExamples: [
-            "refill_sends_v2({ workspaceId })",
-            "get_refill_plan_v2({ workspaceId })",
-        ],
+        ...(await maybeAddLostFenceGuidance(result, { ...input, workspaceId })),
+        readOnly: false,
+        forbiddenActions: FORBIDDEN_ACTIONS,
+        boundedAuthority: BOUNDED_AUTHORITY,
     };
 }