@sellable/mcp 0.1.512 → 0.1.514

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

@@ -0,0 +1,115 @@
+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;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            workspaceId: {
+                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): Promise<{
+    readOnly: boolean;
+    mode: string;
+    forbiddenActions: 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

@@ -0,0 +1,162 @@
+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: "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: {
+                workspaceId: {
+                    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,
+        },
+    },
+];
+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 {
+        ...(await maybeAddLostFenceGuidance(result, { ...input, workspaceId })),
+        readOnly: false,
+        forbiddenActions: FORBIDDEN_ACTIONS,
+        boundedAuthority: BOUNDED_AUTHORITY,
+    };
+}