@sellable/mcp 0.1.512 → 0.1.513

package/dist/api.js

@@ -1,9 +1,9 @@
-import { getConfig, getConfigPath } from "./auth.js";
 import { createWriteStream } from "node:fs";
 import { mkdir, rename, rm, stat } from "node:fs/promises";
 import path from "node:path";
 import { Readable } from "node:stream";
 import { pipeline } from "node:stream/promises";
+import { getConfig, getConfigPath } from "./auth.js";
 export class SellableApiError extends Error {
     status;
     body;
@@ -21,18 +21,21 @@ export class SellableApiError extends Error {
 export class SellableApi {
     buildError(status, errorText) {
         const isAuthError = status === 401 || status === 403;
+        const isWorkspaceMembershipError = status === 403 && errorText.includes("No access to workspace");
         const missingWorkspace = status === 400 && errorText.includes("Workspace");
-        const guidance = isAuthError
-            ? "Sellable authentication failed.\n\n" +
-                "Run the first-run Sellable login flow from a Sellable workflow, then retry.\n\n" +
-                "If the browser login page shows a manual fallback command, use:\n" +
-                "sellable auth set <token> --workspace-id <workspace_id>\n\n" +
-                `Current config path: ${getConfigPath()}\n\n` +
-                "Older copied Settings tokens can be stale, restricted, or missing write/credit permissions. Sign in again so Sellable mints the current agent token."
-            : missingWorkspace
-                ? "No active workspace selected.\n\n" +
-                    "Run list_workspaces then set_active_workspace to choose a workspace."
-                : undefined;
+        const guidance = isWorkspaceMembershipError
+            ? "The authenticated user is not a member of this workspace. Confirm the workspaceId or ask a workspace admin to add the user; re-login will not help."
+            : isAuthError
+                ? "Sellable authentication failed.\n\n" +
+                    "Run the first-run Sellable login flow from a Sellable workflow, then retry.\n\n" +
+                    "If the browser login page shows a manual fallback command, use:\n" +
+                    "sellable auth set <token> --workspace-id <workspace_id>\n\n" +
+                    `Current config path: ${getConfigPath()}\n\n` +
+                    "Older copied Settings tokens can be stale, restricted, or missing write/credit permissions. Sign in again so Sellable mints the current agent token."
+                : missingWorkspace
+                    ? "No active workspace selected.\n\n" +
+                        "Run list_workspaces then set_active_workspace to choose a workspace."
+                    : undefined;
         return new SellableApiError(status, errorText, guidance);
     }
     async requestResponse(method, path, body, options) {

package/dist/refill-journal.js

@@ -74,7 +74,7 @@ export function createRunJournal(params) {
     }
     const startedAt = (params.now ?? new Date()).toISOString();
     const header = [
-        `# Refill Sends Evergreen Run ${runId}`,
+        `# Refill Sends V2 Run ${runId}`,
         "",
         `- Run ID: ${runId}`,
         `- Workspace ID: ${params.workspaceId}`,

package/dist/server.js

@@ -9,12 +9,8 @@ import { prepareCampaignAbTest } from "./tools/campaign-ab-test.js";
 import { resolveCampaignFillRoute } from "./tools/campaign-fill-routing.js";
 import { fillCampaignHorizon } from "./tools/campaign-horizon-fill.js";
 import { cancelPrepareCampaignMessages, getPrepareCampaignMessagesStatus, startPrepareCampaignMessages, } from "./tools/campaign-message-preparation.js";
-import { getCampaignRefillState } from "./tools/campaign-refill-state.js";
-import { getEvergreenRefillPlan } from "./tools/evergreen-refill-plan.js";
-import { getRefillTargetPlan } from "./tools/refill-target-plan.js";
-import { refillSendsEvergreenCommand } from "./tools/refill-sends-evergreen.js";
-import { getSchedulerFillCapacity } from "./tools/scheduler-fill-capacity.js";
 import { getCampaignTableSchema, queueCampaignCells, recordCampaignReviewBatch, reviseMessageTemplateAndRerun, selectCampaignCells, waitForCampaignProcessing, } from "./tools/campaign-processing.js";
+import { getCampaignRefillState } from "./tools/campaign-refill-state.js";
 import { archiveCampaign, createCampaign, duplicateCampaign, getCampaign, getCampaignMessagesPreview, getCampaigns, pauseCampaign, startCampaign, updateCampaign, updateCampaignBrief, } from "./tools/campaigns.js";
 import { queueCells, updateCell } from "./tools/cells.js";
 import { handleStartCliLogin, handleWaitForCliLogin, } from "./tools/cli-login.js";
@@ -31,6 +27,7 @@ import { searchEngagementPosts } from "./tools/engage-discovery.js";
 import { copySenderConfigTool, getEngageMemoryTool, migrateFlatConfigsTool, recordEngageProvenSearchTool, setEngageStyleGuideTool, upsertEngageTrackedPersonTool, } from "./tools/engage-memory.js";
 import { getEngageStateTool, setEngageStateTool, } from "./tools/engage-state.js";
 import { bulkEnrichWithProspeo, enrichWithProspeo, getProspeoCredits, } from "./tools/enrichment.js";
+import { getRefillPlanV2 } from "./tools/evergreen-refill-plan.js";
 import { getCampaignFramework } from "./tools/framework.js";
 import { confirmHarvestJobCompanies, searchHarvestJobs, } from "./tools/harvest-jobs.js";
 import { checkInboxReplyEligibility, getInboxThread, searchInboxThreads, sendInboxDraft, sendInboxManualReply, updateInboxDraft, } from "./tools/inbox.js";
@@ -41,10 +38,13 @@ import { addOnDemandLeads, createOnDemandCampaign, createOnDemandTable, initOnDe
 import { upsertRubric } from "./tools/processing.js";
 import { completeSenderResearch, getPostFindLeadsScoutRegistry, getSourceScoutRegistry, getSubskillAsset, getSubskillPrompt, listSubskillPrompts, searchSubskillPrompts, } from "./tools/prompts.js";
 import { waitForCampaignTableReady, waitForLeadListReady, } from "./tools/readiness.js";
+import { refillSendsV2Command } from "./tools/refill-sends-v2.js";
 import { executeRefillSendsCommand } from "./tools/refill-sends.js";
+import { getRefillTargetPlan } from "./tools/refill-target-plan.js";
 import { allTools } from "./tools/registry.js";
 import { getRows, getTableRows, getTableRowsMinimal } from "./tools/rows.js";
 import { addRubricItem, checkRubric, deleteRubricItem, draftRubrics, saveRubrics, selectNecessaryRubrics, updateRubricItem, waitForRubricResults, } from "./tools/rubrics.js";
+import { getSchedulerFillCapacity } from "./tools/scheduler-fill-capacity.js";
 import { getSenderRoutingTool, setSenderRoutingTool, } from "./tools/sender-routing.js";
 import { getSender, listSenders, refreshPaidInmailCredits, } from "./tools/senders.js";
 import { attachRecommendedSequence, attachSequence, createWorkflowTable, } from "./tools/sequencer.js";
@@ -225,8 +225,9 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
             case "get_campaign_refill_state":
                 result = await getCampaignRefillState(args);
                 break;
+            case "get_refill_plan_v2":
             case "get_evergreen_refill_plan":
-                result = await getEvergreenRefillPlan(args);
+                result = await getRefillPlanV2(args);
                 break;
             case "get_refill_target_plan":
                 result = await getRefillTargetPlan(args);
@@ -237,8 +238,9 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
             case "refill_sends":
                 result = await executeRefillSendsCommand(args);
                 break;
+            case "refill_sends_v2":
             case "refill_sends_evergreen":
-                result = refillSendsEvergreenCommand(args);
+                result = refillSendsV2Command(args);
                 break;
             case "setup_evergreen_campaigns":
                 result = await setupEvergreenCampaigns(args);

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

@@ -1,12 +1,13 @@
-type GetEvergreenRefillPlanInput = {
+type GetRefillPlanV2Input = {
     workspaceId?: string;
+    intent?: "auto" | "evergreen" | "plain" | "active";
     senderIds?: string[];
     runState?: Record<string, unknown>;
     journal?: boolean;
     journalNote?: string;
 };
 export declare function sanitizeEvergreenRefillPlanResult(value: unknown): Record<string, unknown>;
-export declare const evergreenRefillPlanToolDefinitions: {
+export declare const refillPlanV2ToolDefinitions: {
     name: string;
     description: string;
     inputSchema: {
@@ -26,6 +27,11 @@ export declare const evergreenRefillPlanToolDefinitions: {
                 type: string;
                 description: string;
             };
+            intent: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
             journal: {
                 type: string;
                 description: string;
@@ -39,11 +45,25 @@ export declare const evergreenRefillPlanToolDefinitions: {
         additionalProperties: boolean;
     };
 }[];
-export declare function getEvergreenRefillPlan(input: GetEvergreenRefillPlanInput): Promise<{
+export declare function getRefillPlanV2(input: GetRefillPlanV2Input): Promise<{
+    readOnly: boolean;
+    blocker: string;
+    workspaceId: string;
+    guidance: string;
+    warnings: string[];
+    journalPath: string | null;
+    text: string;
+    workspaceResolution: string;
+} | {
     warnings: any[];
     journalPath: string | null;
     text: string;
     workspaceId: string;
     workspaceResolution: string;
+    readOnly?: undefined;
+    blocker?: undefined;
+    guidance?: undefined;
 }>;
+/** @deprecated Use getRefillPlanV2. */
+export declare const getEvergreenRefillPlan: typeof getRefillPlanV2;
 export {};

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

@@ -1,5 +1,5 @@
 import * as path from "node:path";
-import { getApi } from "../api.js";
+import { getApi, SellableApiError } from "../api.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";
@@ -45,7 +45,7 @@ function buildRunStateFromLocalHints(workspaceId) {
         passRates: state?.passRates ?? [],
     };
 }
-async function postEvergreenRefillPlan(body, workspaceId) {
+async function postRefillPlanV2(body, workspaceId) {
     const api = getApi();
     const requestOptions = workspaceRequestOptions(workspaceId);
     return requestOptions
@@ -75,7 +75,7 @@ function writeDryRunJournal(params) {
         ? params.result.bootstrap
         : {};
     appendJournalEvent(created.filePath, renderBootstrapSection({
-        summary: "Evergreen refill dry-run bootstrap",
+        summary: "Refill v2 dry-run bootstrap across managed waterfall, dashboard evergreen, and active campaign lanes",
         senderSummary: JSON.stringify(bootstrap.senders ?? []),
         laneSummary: JSON.stringify(bootstrap.laneOrder ?? []),
         targetSummary: JSON.stringify(bootstrap.target ?? []),
@@ -113,14 +113,48 @@ function writeDryRunJournal(params) {
         fileName: path.basename(created.filePath),
         workspaceId: params.workspaceId,
         dryRun: true,
-        summary: "evergreen refill dry-run",
+        summary: "refill v2 dry-run",
     });
     return created.filePath;
 }
-export const evergreenRefillPlanToolDefinitions = [
+function writeWorkspaceAccessJournal(params) {
+    const created = createRunJournal({
+        workspaceId: params.workspaceId,
+        dryRun: true,
+    });
+    appendJournalEvent(created.filePath, renderBootstrapSection({
+        summary: "Refill v2 dry-run bootstrap stopped at workspace access",
+        senderSummary: "[]",
+        laneSummary: "[]",
+        targetSummary: `workspaceId=${params.workspaceId}`,
+        creditSummary: "[]",
+    }));
+    appendJournalEvent(created.filePath, renderPlanSection({
+        chosenSummary: "workspace_access blocker",
+        itinerarySummaries: ["No workspace campaign state read"],
+        fallbackSummary: "terminal:workspace_access",
+    }));
+    appendJournalEvent(created.filePath, renderTerminalSection({
+        summary: `blocker=workspace_access workspaceId=${params.workspaceId} ${params.guidance}`,
+    }));
+    appendIndexLine({
+        runId: created.runId,
+        fileName: path.basename(created.filePath),
+        workspaceId: params.workspaceId,
+        dryRun: true,
+        summary: "refill v2 dry-run workspace_access blocker",
+    });
+    return created.filePath;
+}
+function isWorkspaceAccessError(error) {
+    return (error instanceof SellableApiError &&
+        error.status === 403 &&
+        error.body.includes("No access to workspace"));
+}
+export const refillPlanV2ToolDefinitions = [
     {
-        name: "get_evergreen_refill_plan",
-        description: "Read-only evergreen refill dry-run planner. It performs no mutations, does not schedule, send, approve, prepare, or refresh credits, and writes a local dry-run journal file unless journal:false is passed.",
+        name: "get_refill_plan_v2",
+        description: "Read-only refill sends v2 dry-run planner across managed waterfall, dashboard evergreen, and active campaign lanes. It performs no mutations, does not schedule, send, approve, prepare, or refresh credits, and writes a local dry-run journal file unless journal:false is passed.",
         inputSchema: {
             type: "object",
             properties: {
@@ -136,6 +170,11 @@ export const evergreenRefillPlanToolDefinitions = [
                     type: "object",
                     description: "Optional synthetic v1 run state. When provided, replaces local lane-memory hints.",
                 },
+                intent: {
+                    type: "string",
+                    enum: ["auto", "evergreen", "plain", "active"],
+                    description: 'Planner intent. Defaults to "auto" for refill-sends-v2.',
+                },
                 journal: {
                     type: "boolean",
                     description: "Set false to skip the local dry-run journal write.",
@@ -150,19 +189,55 @@ export const evergreenRefillPlanToolDefinitions = [
         },
     },
 ];
-export async function getEvergreenRefillPlan(input) {
+export async function getRefillPlanV2(input) {
     const workspaceId = normalizeExplicitWorkspaceId(input.workspaceId);
     if (!workspaceId) {
-        throw new Error("workspaceId is required for get_evergreen_refill_plan.");
+        throw new Error("workspaceId is required for get_refill_plan_v2.");
     }
     const runState = input.runState !== undefined
         ? input.runState
         : buildRunStateFromLocalHints(workspaceId);
-    const raw = await postEvergreenRefillPlan({
-        workspaceId,
-        senderIds: input.senderIds,
-        runState,
-    }, workspaceId);
+    let raw;
+    try {
+        raw = await postRefillPlanV2({
+            workspaceId,
+            intent: input.intent ?? "auto",
+            senderIds: input.senderIds,
+            runState,
+        }, workspaceId);
+    }
+    catch (error) {
+        if (!isWorkspaceAccessError(error))
+            throw error;
+        const guidance = error instanceof SellableApiError && error.guidance
+            ? error.guidance
+            : "The authenticated user is not a member of this workspace. Confirm the workspaceId or ask a workspace admin to add the user; re-login will not help.";
+        const warnings = [];
+        let journalPath = null;
+        if (input.journal !== false) {
+            try {
+                journalPath = writeWorkspaceAccessJournal({ workspaceId, guidance });
+            }
+            catch {
+                warnings.push("journalWriteFailed");
+            }
+        }
+        return {
+            readOnly: true,
+            blocker: "workspace_access",
+            workspaceId,
+            guidance,
+            warnings,
+            journalPath,
+            text: [
+                "Refill sends v2 dry-run blocked: workspace_access",
+                `Workspace: ${workspaceId}`,
+                guidance,
+                journalPath ? `Journal: ${journalPath}` : "Journal: not written",
+            ].join("\n"),
+            workspaceResolution: "explicit",
+        };
+    }
     const sanitized = sanitizeEvergreenRefillPlanResult(raw);
     const warnings = Array.isArray(sanitized.warnings)
         ? [...sanitized.warnings]
@@ -181,7 +256,7 @@ export async function getEvergreenRefillPlan(input) {
         }
     }
     const summary = [
-        "Evergreen refill dry-run plan:",
+        "Refill sends v2 dry-run plan:",
         ...planSummaryLines(sanitized),
         journalPath ? `Journal: ${journalPath}` : "Journal: not written",
     ].join("\n");
@@ -194,3 +269,5 @@ export async function getEvergreenRefillPlan(input) {
         workspaceResolution: "explicit",
     };
 }
+/** @deprecated Use getRefillPlanV2. */
+export const getEvergreenRefillPlan = getRefillPlanV2;

package/dist/tools/prompts.d.ts

@@ -137,7 +137,8 @@ export interface PostFindLeadsScoutRegistryResponse {
 }
 export declare const DEFAULT_SUBSKILL_PROMPT_CHUNK_CHARS = 48000;
 export declare const MAX_SUBSKILL_PROMPT_CHUNK_CHARS = 48000;
-export declare const ALLOWED_SUBSKILL_PROMPT_NAMES: 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"];
+export declare const DEPRECATED_SUBSKILL_PROMPT_REPLACEMENTS: Record<string, string>;
+export declare const ALLOWED_SUBSKILL_PROMPT_NAMES: 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-v2", "refill-sends-v2-workflow", "refill-sends-workflow", "research", "research-prospect", "research-sender", "weekly-campaign-summary", "workflow-sequences"];
 export declare const promptToolDefinitions: ({
     name: string;
     description: string;
@@ -181,7 +182,7 @@ export declare const promptToolDefinitions: ({
         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-evergreen", "refill-sends-evergreen-workflow", "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-v2", "refill-sends-v2-workflow", "refill-sends-workflow", "research", "research-prospect", "research-sender", "weekly-campaign-summary", "workflow-sequences"];
                 description: string;
             };
             offset: {
@@ -216,7 +217,7 @@ export declare const promptToolDefinitions: ({
         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-evergreen", "refill-sends-evergreen-workflow", "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-v2", "refill-sends-v2-workflow", "refill-sends-workflow", "research", "research-prospect", "research-sender", "weekly-campaign-summary", "workflow-sequences"];
                 description: string;
             };
             assetPath: {

package/dist/tools/prompts.js

@@ -13,8 +13,10 @@ import { markCreateCampaignPromptLoaded, markResearchPromptLoaded, markSenderRes
 // ~3s.
 export const DEFAULT_SUBSKILL_PROMPT_CHUNK_CHARS = 48_000;
 export const MAX_SUBSKILL_PROMPT_CHUNK_CHARS = 48_000;
-const DEPRECATED_SUBSKILL_PROMPT_REPLACEMENTS = {
+export const DEPRECATED_SUBSKILL_PROMPT_REPLACEMENTS = {
     "generate-messages-compact": "generate-messages",
+    "refill-sends-evergreen": "refill-sends-v2",
+    "refill-sends-evergreen-workflow": "refill-sends-v2-workflow",
 };
 export const ALLOWED_SUBSKILL_PROMPT_NAMES = [
     "building-gtm-tables",
@@ -40,6 +42,8 @@ export const ALLOWED_SUBSKILL_PROMPT_NAMES = [
     "refill-sends",
     "refill-sends-evergreen",
     "refill-sends-evergreen-workflow",
+    "refill-sends-v2",
+    "refill-sends-v2-workflow",
     "refill-sends-workflow",
     "research",
     "research-prospect",

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

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

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

@@ -0,0 +1,49 @@
+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.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                workspaceId: {
+                    type: "string",
+                    description: "Explicit request-scoped workspace id.",
+                },
+            },
+            required: ["workspaceId"],
+            additionalProperties: false,
+        },
+    },
+];
+export function refillSendsV2Command(input) {
+    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 })",
+        ],
+    };
+}

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-evergreen", "refill-sends-evergreen-workflow", "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-v2", "refill-sends-v2-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-evergreen", "refill-sends-evergreen-workflow", "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-v2", "refill-sends-v2-workflow", "refill-sends-workflow", "research", "research-prospect", "research-sender", "weekly-campaign-summary", "workflow-sequences"];
                 description: string;
             };
             assetPath: {
@@ -585,20 +585,6 @@ export declare const allTools: ({
         additionalProperties: boolean;
         required?: undefined;
     };
-} | {
-    name: string;
-    description: string;
-    inputSchema: {
-        type: string;
-        properties: {
-            workspaceId: {
-                type: string;
-                description: string;
-            };
-        };
-        required: string[];
-        additionalProperties: boolean;
-    };
 } | {
     name: string;
     description: string;
@@ -7197,6 +7183,20 @@ export declare const allTools: ({
         };
         required: string[];
     };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            workspaceId: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+        additionalProperties: boolean;
+    };
 } | {
     name: string;
     description: string;

package/dist/tools/registry.js

@@ -5,8 +5,8 @@ import { campaignAbTestToolDefinitions } from "./campaign-ab-test.js";
 import { campaignFillRoutingToolDefinitions } from "./campaign-fill-routing.js";
 import { campaignHorizonFillToolDefinitions } from "./campaign-horizon-fill.js";
 import { campaignMessagePreparationToolDefinitions } from "./campaign-message-preparation.js";
-import { campaignRefillStateToolDefinitions } from "./campaign-refill-state.js";
 import { campaignProcessingToolDefinitions } from "./campaign-processing.js";
+import { campaignRefillStateToolDefinitions } from "./campaign-refill-state.js";
 import { campaignToolDefinitions } from "./campaigns.js";
 import { cellToolDefinitions } from "./cells.js";
 import { startCliLoginToolDef, waitForCliLoginToolDef } from "./cli-login.js";
@@ -23,6 +23,7 @@ import { engageDiscoveryToolDefinitions } from "./engage-discovery.js";
 import { engageMemoryToolDefinitions } from "./engage-memory.js";
 import { engageStateToolDefinitions } from "./engage-state.js";
 import { enrichmentToolDefinitions } from "./enrichment.js";
+import { refillPlanV2ToolDefinitions } from "./evergreen-refill-plan.js";
 import { frameworkToolDefinitions } from "./framework.js";
 import { harvestJobToolDefinitions } from "./harvest-jobs.js";
 import { inboxToolDefinitions } from "./inbox.js";
@@ -33,10 +34,9 @@ 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 { refillSendsV2ToolDefinitions } from "./refill-sends-v2.js";
 import { refillSendsToolDefinitions } from "./refill-sends.js";
+import { refillTargetPlanToolDefinitions } from "./refill-target-plan.js";
 import { rowToolDefinitions } from "./rows.js";
 import { rubricToolDefinitions } from "./rubrics.js";
 import { schedulerFillCapacityToolDefinitions } from "./scheduler-fill-capacity.js";
@@ -54,11 +54,11 @@ export const allTools = [
     ...campaignAbTestToolDefinitions,
     ...campaignFillRoutingToolDefinitions,
     ...campaignRefillStateToolDefinitions,
-    ...evergreenRefillPlanToolDefinitions,
+    ...refillPlanV2ToolDefinitions,
     ...refillTargetPlanToolDefinitions,
     ...schedulerFillCapacityToolDefinitions,
     ...refillSendsToolDefinitions,
-    ...refillSendsEvergreenToolDefinitions,
+    ...refillSendsV2ToolDefinitions,
     ...setupEvergreenCampaignsToolDefinitions,
     ...campaignHorizonFillToolDefinitions,
     ...campaignMessagePreparationToolDefinitions,

package/package.json

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

package/skills/refill-sends-evergreen/SKILL.md

@@ -1,84 +1,19 @@
 ---
 name: refill-sends-evergreen
-description: Plan evergreen waterfall send refill work through the Phase 85 dry-run workflow.
+description: Deprecated alias for refill-sends-v2.
 visibility: public
 allowed-tools:
-  - mcp__sellable__refill_sends_evergreen
-  - mcp__sellable__get_evergreen_refill_plan
   - mcp__sellable__get_subskill_prompt
-  - mcp__sellable__get_subskill_asset
-  - mcp__sellable__get_auth_status
-  - mcp__sellable__get_active_workspace
-  - mcp__sellable__list_workspaces
-  - mcp__sellable__get_workspace
 ---
 
 # Refill Sends Evergreen
 
-Use this public command wrapper for evergreen waterfall refill requests such as
-"refill evergreen", "fill evergreen senders", "load evergreen lanes", or
-"plan evergreen refill".
+Superseded by refill-sends-v2. The prompt name now redirects through
+`DEPRECATED_SUBSKILL_PROMPT_REPLACEMENTS`; do not call this deprecated prompt
+directly.
 
-Host command names:
-
-- Claude Code: `/sellable:refill-sends-evergreen`
-- Codex: `$sellable:refill-sends-evergreen`
-
-Phase 85 is read-only, dry-run, zero mutations. It plans the deterministic
-waterfall-ladder refill packet and writes a local dry-run journal, but it does
-not prepare messages, approve messages, start campaigns, schedule sends, send
-messages, refresh paid InMail credit facts, create campaigns, or change source
-configuration. Execution ships in the follow-up phase.
-
-## Entry
-
-Resolve the explicit `workspaceId` from the request, automation config, or
-active workspace readback. Scheduled or autonomous usage must carry
-`workspaceId` on every tool call. If the workspace is missing or ambiguous, stop
-with `WORKSPACE_REQUIRED`; do not switch the shared active workspace.
-
-Start with the command contract:
+Use `refill-sends-v2` instead:
 
 ```text
-refill_sends_evergreen({ workspaceId })
+get_subskill_prompt({ subskillName: "refill-sends-v2" })
 ```
-
-Then load the internal workflow prompt and flow asset:
-
-```text
-get_subskill_prompt({ subskillName: "refill-sends-evergreen-workflow" })
-get_subskill_asset({ subskillName: "refill-sends-evergreen-workflow", assetPath: "core/flow.v1.json" })
-```
-
-Continue both loads until `hasMore:false`; parse the flow JSON and verify
-`workflow:"refill-sends-evergreen-workflow"` with a `v1` version before the
-planner call.
-
-Call the dry-run planner with the explicit workspace id:
-
-```text
-get_evergreen_refill_plan({ workspaceId, senderIds?, runState?, journal?, journalNote? })
-```
-
-Use `senderIds` only when the user scoped the request to exact senders. Use
-`runState` only for an explicit what-if dry run; otherwise let the MCP read
-local lane memory hints. Leave `journal` enabled unless the user specifically
-asked for no local journal.
-
-## Report
-
-Review the returned packet before giving a recommendation:
-
-- `planRevision` starts with `pr1:`.
-- `stateRevision` identifies the current readback.
-- `packet` is the operator-facing facts receipt.
-- `plans[]` contains per-sender lane decisions and itinerary details.
-- `globalActionQueue[]` is a dry-run sequence only in Phase 85.
-- `evergreen.enumeratedRungs` and each action's `evergreenRung` map to the
-  locked ladder from the workflow asset.
-- `journalPath` points to the dry-run markdown journal written by the MCP.
-- `sideEffects` must be all false.
-
-Report campaign names and sender names first, ids second. Include the chosen
-rung, the itinerary, the plan revision, the journal path, and any blockers or
-warnings. Stop after the report; do not execute the action queue in Phase 85.

package/skills/refill-sends-evergreen-workflow/SKILL.md

@@ -1,107 +1,20 @@
 ---
 name: refill-sends-evergreen-workflow
-description: Internal read-only workflow for evergreen waterfall refill dry-run planning.
+description: Deprecated alias for refill-sends-v2-workflow.
 visibility: internal
 allowed-tools:
-  - mcp__sellable__refill_sends_evergreen
-  - mcp__sellable__get_evergreen_refill_plan
   - mcp__sellable__get_subskill_prompt
-  - mcp__sellable__get_subskill_asset
-  - mcp__sellable__get_auth_status
-  - mcp__sellable__get_active_workspace
-  - mcp__sellable__list_workspaces
-  - mcp__sellable__get_workspace
 ---
 
 # Refill Sends Evergreen Workflow
 
-This internal workflow is the Phase 85 plan surface for evergreen waterfall
-refill. It is read-only, dry-run, zero mutations. The workflow has three gates:
-bootstrap, plan, and report.
+Superseded by refill-sends-v2-workflow. The prompt name now redirects through
+`DEPRECATED_SUBSKILL_PROMPT_REPLACEMENTS`; do not call this deprecated prompt or
+its old flow asset directly.
 
-Runtime flow asset: after loading this prompt, load
-`get_subskill_asset({ subskillName: "refill-sends-evergreen-workflow", assetPath: "core/flow.v1.json" })`
-through MCP, continue chunks until `hasMore:false`, parse the JSON, and verify
-`workflow:"refill-sends-evergreen-workflow"` with a `v1` version before any
-planner call. If the asset cannot load or parse, stop with
-`blocked:evergreen_refill_workflow_asset_unavailable`; do not emulate it from
-local files or memory.
+Use `refill-sends-v2-workflow` instead:
 
-## G0 Bootstrap Facts
-
-Resolve the request-scoped `workspaceId` using read-only auth and workspace
-tools. Scheduled or autonomous runs must not rely on implicit workspace state.
-Call `refill_sends_evergreen({ workspaceId })` first to receive the command
-contract, then call `get_evergreen_refill_plan({ workspaceId })` for the dry-run
-packet.
-
-Optional inputs:
-
-- `senderIds`: exact sender scope when the user named senders.
-- `runState`: synthetic v1 lane memory for what-if dry runs. Use it only when
-  the user intentionally wants a hypothetical cursor, pin, or cooldown state.
-- `journal:false`: skip the local journal only when explicitly requested.
-- `journalNote`: append operator context to the dry-run terminal section.
-
-## G1 Evergreen Ladder
-
-The planner chooses from this locked rung order:
-
-1. `start_campaign`: a paused selected lane has scheduler-ready supply but must
-   be live before the scheduler can pick it up.
-2. `approve_messages`: generated rows are ready for a bounded approval step.
-3. `wait_for_active_work`: enrichment, generation, import, or preparation is
-   already active, so the next honest action is to wait for that work to finish.
-4. `enrich_more`: exact-set enrichment can close the current ready gap.
-5. `reconcile_source_copy`: same-source rows exist and can be copied without
-   changing source family or source fingerprint.
-6. `add_leads_same_source`: the same source path can add bounded new supply.
-7. `paid_lane_fallback`: paid InMail is blocked or below threshold, so the same
-   waterfall can fall back to an existing supported lane.
-8. `next_campaign`: the current lane is exhausted, cooling down, pinned away, or
-   unsafe, and the next surviving campaign lane should be inspected.
-9. `wait_for_scheduler`: ready or projected supply covers the target, and only
-   scheduler pickup remains.
-10. `done`: the sender or lane is complete for the selected target window, or a
-    scheduler cap makes additional preparation unnecessary.
-
-Forward-only lane rule: a lane can move to a later rung or a later surviving
-campaign, but the dry-run packet must not jump backward to invent work that the
-facts do not support. Pinned-campaign rule: a pinned campaign stays selected
-until the planner proves a blocker, cooldown, exhaustion, or safer next lane.
-Capped-is-complete rule: when scheduler capacity is lower than the requested
-target and ready/projected coverage satisfies that cap, report `done` with the
-cap reason. Honest-itinerary rule: show what was checked, what was skipped, and
-why; never hide uncertainty behind a confident source recommendation.
-
-Guardrails inherited from the Phase 83 evergreen workflow: no campaign creation,
-no provider-family switch, no threshold lowering, no scheduler writes, no
-launch/send/archive/delete, no brief/filter/message/sequence/sender mutation,
-no message preparation, no message approval, no paid InMail credit refresh, no
-source mutation, no row queueing, and no campaign status change.
-
-## Journal
-
-`get_evergreen_refill_plan` writes a local dry-run journal unless
-`journal:false` is passed. Read the returned `journalPath` from the tool result
-and include it in the report. The journal contains bootstrap, plan, and terminal
-sections plus an index line under the run journal directory. If the tool returns
-`journalPath:null` with a `journalWriteFailed` warning, report the warning and
-continue with the dry-run packet; do not retry by writing local files yourself.
-
-## Report Contract
-
-Completion for Phase 85 means packet reviewed and journal written. Merely
-calling `get_evergreen_refill_plan` is not completion proof.
-
-Report these facts:
-
-- workspace id and selected sender scope;
-- plan revision and state revision;
-- selected campaign and lane per sender;
-- chosen rung and dry-run action queue;
-- itinerary, skipped lanes, blockers, cooldowns, and warnings;
-- journal path;
-- side effects proof, which must show all false values.
-
-Stop after the report. The Phase 85 workflow never executes the action queue.
+```text
+get_subskill_prompt({ subskillName: "refill-sends-v2-workflow" })
+get_subskill_asset({ subskillName: "refill-sends-v2-workflow", assetPath: "core/flow.v1.json" })
+```

package/skills/refill-sends-v2/SKILL.md

@@ -0,0 +1,96 @@
+---
+name: refill-sends-v2
+description: Plan refill sends v2 work through the read-only three-lane dry-run planner.
+visibility: public
+allowed-tools:
+  - mcp__sellable__refill_sends_v2
+  - mcp__sellable__get_refill_plan_v2
+  - mcp__sellable__get_subskill_prompt
+  - mcp__sellable__get_subskill_asset
+  - mcp__sellable__get_auth_status
+  - mcp__sellable__get_active_workspace
+  - mcp__sellable__list_workspaces
+  - mcp__sellable__get_workspace
+---
+
+# Refill Sends V2
+
+Use this public command wrapper for refill planning requests such as "refill
+sends", "fill evergreen senders", "load everyone up", "plan Damiano", or "show a
+dry-run for this workspace".
+
+Host command names:
+
+- Claude Code: `/sellable:refill-sends-v2`
+- Codex: `$sellable:refill-sends-v2`
+
+This is plan-only, read-only, dry-run, zero mutations. It creates no campaigns,
+does not prepare or approve messages, does not start campaigns, does not
+schedule or send messages, does not refresh paid InMail credit facts, and does
+not change source configuration. Execution remains in the Phase 86 workflow.
+
+## Entry
+
+Resolve the explicit `workspaceId` from the request, automation config, or
+active workspace readback. Scheduled or autonomous usage must carry
+`workspaceId` on every tool call. If the workspace is missing or ambiguous, stop
+with `WORKSPACE_REQUIRED`; do not switch the shared active workspace.
+
+Start with the command contract:
+
+```text
+refill_sends_v2({ workspaceId })
+```
+
+Then load the internal workflow prompt and flow asset:
+
+```text
+get_subskill_prompt({ subskillName: "refill-sends-v2-workflow" })
+get_subskill_asset({ subskillName: "refill-sends-v2-workflow", assetPath: "core/flow.v1.json" })
+```
+
+Continue both loads until `hasMore:false`; parse the flow JSON and verify
+`workflow:"refill-sends-v2-workflow"` with a `v1` version before the planner
+call.
+
+Call the dry-run planner with the explicit workspace id:
+
+```text
+get_refill_plan_v2({ workspaceId, intent:"auto", senderIds?, runState?, journal?, journalNote? })
+```
+
+The default `intent:"auto"` checks the three lane-source families in order:
+
+- `managed_waterfall` for product-managed evergreen waterfall lanes.
+- `dashboard_evergreen` for dashboard-visible evergreen campaigns.
+- `active_campaign` for regular active campaigns that should refill through a
+  deterministic lane chain.
+
+Use `senderIds` only when the user scoped the request to exact senders. Use
+`runState` only for an explicit what-if dry run; otherwise let the MCP read
+local lane memory hints. Leave `journal` enabled unless the user specifically
+asked for no local journal.
+
+## Report
+
+Review the returned packet before giving a recommendation:
+
+- `planRevision` starts with `pr1:`.
+- `stateRevision` identifies the current readback.
+- `packet` is the operator-facing facts receipt.
+- `plans[]` contains per-sender lane decisions and itinerary details.
+- `globalActionQueue[]` is a dry-run sequence only.
+- `evergreen.laneOrder[].source` uses `managed_waterfall`,
+  `dashboard_evergreen`, or `active_campaign`.
+- `evergreen.senderLaneSelections[].laneChain` records the ordered lane chain
+  when a regular active campaign chain is selected.
+- Terminals can include `done` or `no_refillable_campaigns`.
+- A membership 403 must return the structured `workspace_access` blocker; report
+  it as a read-only blocker, not a login retry.
+- `journalPath` points to the dry-run markdown journal written by the MCP.
+- `sideEffects` must be all false.
+
+Report campaign names and sender names first, ids second. Include the lane
+source, lane chain when present, chosen rung, itinerary, plan revision, journal
+path, and any blockers or warnings. Stop after the report; do not execute the
+action queue.

package/skills/refill-sends-v2-workflow/SKILL.md

@@ -0,0 +1,127 @@
+---
+name: refill-sends-v2-workflow
+description: Internal read-only workflow for refill sends v2 dry-run planning.
+visibility: internal
+allowed-tools:
+  - mcp__sellable__refill_sends_v2
+  - mcp__sellable__get_refill_plan_v2
+  - mcp__sellable__get_subskill_prompt
+  - mcp__sellable__get_subskill_asset
+  - mcp__sellable__get_auth_status
+  - mcp__sellable__get_active_workspace
+  - mcp__sellable__list_workspaces
+  - mcp__sellable__get_workspace
+---
+
+# Refill Sends V2 Workflow
+
+This internal workflow is the read-only, dry-run, zero mutations plan surface
+for refill sends v2. The workflow has three gates: bootstrap, plan, and report.
+It covers product-managed evergreen workspaces, dashboard evergreen workspaces,
+and non-evergreen active campaign workspaces without creating new campaigns.
+
+Runtime flow asset: after loading this prompt, load
+`get_subskill_asset({ subskillName: "refill-sends-v2-workflow", assetPath: "core/flow.v1.json" })`
+through MCP, continue chunks until `hasMore:false`, parse the JSON, and verify
+`workflow:"refill-sends-v2-workflow"` with a `v1` version before any planner
+call. If the asset cannot load or parse, stop with
+`blocked:refill_sends_v2_workflow_asset_unavailable`; do not emulate it from
+local files or memory.
+
+## G0 Bootstrap Facts
+
+Resolve the request-scoped `workspaceId` using read-only auth and workspace
+tools. Scheduled or autonomous runs must not rely on implicit workspace state.
+Call `refill_sends_v2({ workspaceId })` first to receive the command contract,
+then call `get_refill_plan_v2({ workspaceId, intent:"auto" })` for the dry-run
+packet.
+
+Optional inputs:
+
+- `senderIds`: exact sender scope when the user named senders.
+- `intent`: defaults to `auto`. Use explicit `evergreen`, `plain`, or `active`
+  only for a what-if comparison.
+- `runState`: synthetic v1 lane memory for what-if dry runs. Use it only when
+  the user intentionally wants a hypothetical cursor, pin, cooldown state, or
+  laneChain replay.
+- `journal:false`: skip the local journal only when explicitly requested.
+- `journalNote`: append operator context to the dry-run terminal section.
+
+## G1 Lane Sources
+
+The planner reports the lane source for every selected lane:
+
+1. `managed_waterfall`: product-managed evergreen waterfall lanes.
+2. `dashboard_evergreen`: dashboard-visible evergreen campaigns that are not in
+   the managed waterfall snapshot.
+3. `active_campaign`: regular active campaigns ranked into a deterministic
+   laneChain for non-evergreen refill planning.
+
+If no lane family has refillable campaigns, report `no_refillable_campaigns`.
+If the user lacks membership on a requested workspace, report the structured
+`workspace_access` blocker with the workspace id and journal path.
+
+## G2 Refill Ladder
+
+The planner chooses from this locked rung order:
+
+1. `start_campaign`: a paused selected lane has scheduler-ready supply but must
+   be live before the scheduler can pick it up.
+2. `approve_messages`: generated rows are ready for a bounded approval step.
+3. `wait_for_active_work`: enrichment, generation, import, or preparation is
+   already active, so the next honest action is to wait for that work to finish.
+4. `enrich_more`: exact-set enrichment can close the current ready gap.
+5. `reconcile_source_copy`: same-source rows exist and can be copied without
+   changing source family or source fingerprint.
+6. `add_leads_same_source`: the same source path can add bounded new supply.
+7. `paid_lane_fallback`: paid InMail is blocked or below threshold, so the same
+   waterfall can fall back to an existing supported lane.
+8. `next_campaign`: the current lane is exhausted, cooling down, pinned away, or
+   unsafe, and the next surviving campaign lane should be inspected.
+9. `wait_for_scheduler`: ready or projected supply covers the target, and only
+   scheduler pickup remains.
+10. `done`: the sender or lane is complete for the selected target window, a
+    scheduler cap makes additional preparation unnecessary, or
+    `no_refillable_campaigns` is the honest terminal.
+
+Forward-only lane rule: a lane can move to a later rung or a later surviving
+campaign, but the dry-run packet must not jump backward to invent work that the
+facts do not support. Pinned-campaign rule: a pinned campaign stays selected
+until the planner proves a blocker, cooldown, exhaustion, or safer next lane.
+Capped-is-complete rule: when scheduler capacity is lower than the requested
+target and ready/projected coverage satisfies that cap, report `done` with the
+cap reason. Honest-itinerary rule: show what was checked, what was skipped, and
+why; never hide uncertainty behind a confident source recommendation.
+
+Guardrails: no campaign creation, no provider-family switch, no threshold
+lowering, no scheduler writes, no launch/send/archive/delete, no
+brief/filter/message/sequence/sender mutation, no message preparation, no
+message approval, no paid InMail credit refresh, no source mutation, no row
+queueing, and no campaign status change.
+
+## Journal
+
+`get_refill_plan_v2` writes a local dry-run journal unless `journal:false` is
+passed. Read the returned `journalPath` from the tool result and include it in
+the report. The journal contains bootstrap, plan, and terminal sections plus an
+index line under the run journal directory. If the tool returns
+`journalPath:null` with a `journalWriteFailed` warning, report the warning and
+continue with the dry-run packet; do not retry by writing local files yourself.
+
+## Report Contract
+
+Completion means packet reviewed and journal written. Merely calling
+`get_refill_plan_v2` is not completion proof.
+
+Report these facts:
+
+- workspace id and selected sender scope;
+- plan revision and state revision;
+- selected campaign, lane source, and laneChain per sender;
+- chosen rung and dry-run action queue;
+- itinerary, skipped lanes, blockers, cooldowns, and warnings;
+- `no_refillable_campaigns` terminals and `workspace_access` blockers;
+- journal path;
+- side effects proof, which must show all false values.
+
+Stop after the report. This workflow never executes the action queue.

package/skills/refill-sends-v2-workflow/core/flow.v1.json

@@ -0,0 +1,266 @@
+{
+  "version": "v1.0",
+  "workflow": "refill-sends-v2-workflow",
+  "principle": "Plan refill sends v2 as a read-only dry-run with zero mutations across managed_waterfall, dashboard_evergreen, and active_campaign lane sources.",
+  "laneSources": ["managed_waterfall", "dashboard_evergreen", "active_campaign"],
+  "terminalReasons": ["done", "no_refillable_campaigns"],
+  "blockers": ["workspace_access"],
+  "enumeratedRungs": [
+    "start_campaign",
+    "approve_messages",
+    "wait_for_active_work",
+    "enrich_more",
+    "reconcile_source_copy",
+    "add_leads_same_source",
+    "paid_lane_fallback",
+    "next_campaign",
+    "wait_for_scheduler",
+    "done"
+  ],
+  "requiredBootstrap": [
+    {
+      "tool": "get_auth_status",
+      "purpose": "Confirm MCP auth before reading workspace or plan facts."
+    },
+    {
+      "tool": "get_active_workspace",
+      "purpose": "Resolve explicit workspace evidence when the request did not provide workspaceId."
+    },
+    {
+      "tool": "refill_sends_v2",
+      "requiredValues": {
+        "workspaceId": "{workspaceId}"
+      },
+      "requiredOutput": [
+        "readOnly true",
+        "approvalContract says Phase 86 handles execution"
+      ]
+    },
+    {
+      "tool": "get_subskill_prompt",
+      "requiredValues": {
+        "subskillName": "refill-sends-v2-workflow"
+      },
+      "mustReadUntil": {
+        "hasMore": false
+      }
+    },
+    {
+      "tool": "get_subskill_asset",
+      "requiredValues": {
+        "subskillName": "refill-sends-v2-workflow",
+        "assetPath": "core/flow.v1.json"
+      },
+      "mustReadUntil": {
+        "hasMore": false
+      },
+      "validation": {
+        "workflow": "refill-sends-v2-workflow",
+        "versionPrefix": "v1",
+        "requiredTopLevelKeys": [
+          "states",
+          "gateOrder",
+          "enumeratedRungs",
+          "verification",
+          "laneSources",
+          "terminalReasons",
+          "blockers"
+        ]
+      }
+    },
+    {
+      "tool": "get_refill_plan_v2",
+      "requiredValues": {
+        "workspaceId": "{workspaceId}",
+        "intent": "auto"
+      },
+      "requiredOutput": [
+        "planRevision or workspace_access blocker",
+        "stateRevision",
+        "packet",
+        "journalPath",
+        "sideEffects"
+      ]
+    }
+  ],
+  "gateOrder": ["bootstrap", "plan", "report"],
+  "states": [
+    {
+      "id": "bootstrap",
+      "description": "Load the read-only command contract, workflow prompt, flow asset, and workspace facts.",
+      "allowedTools": [
+        "get_auth_status",
+        "get_active_workspace",
+        "list_workspaces",
+        "get_workspace",
+        "refill_sends_v2",
+        "get_subskill_prompt",
+        "get_subskill_asset",
+        "get_refill_plan_v2"
+      ],
+      "onEnter": [
+        {
+          "tool": "get_auth_status"
+        },
+        {
+          "tool": "refill_sends_v2",
+          "requiredFields": ["workspaceId"]
+        },
+        {
+          "tool": "get_subskill_prompt",
+          "requiredValues": {
+            "subskillName": "refill-sends-v2-workflow"
+          }
+        },
+        {
+          "tool": "get_subskill_asset",
+          "requiredValues": {
+            "subskillName": "refill-sends-v2-workflow",
+            "assetPath": "core/flow.v1.json"
+          }
+        }
+      ],
+      "transitions": {
+        "contract_loaded": "plan"
+      }
+    },
+    {
+      "id": "plan",
+      "description": "Call the read-only refill sends v2 dry-run planner exactly once for this invocation.",
+      "allowedTools": ["get_refill_plan_v2"],
+      "onEnter": [
+        {
+          "tool": "get_refill_plan_v2",
+          "requiredFields": ["workspaceId"],
+          "optionalFields": [
+            "intent",
+            "senderIds",
+            "runState",
+            "journal",
+            "journalNote"
+          ]
+        }
+      ],
+      "requiredOutput": [
+        "sideEffects all false",
+        "planRevision starts with pr1: unless blocker is workspace_access",
+        "journalPath reported",
+        "chosen evergreenRung is in enumeratedRungs",
+        "lane sources are managed_waterfall, dashboard_evergreen, or active_campaign",
+        "terminal can be no_refillable_campaigns"
+      ],
+      "allowedRungsSource": "enumeratedRungs",
+      "doNotAllow": [
+        "add_column",
+        "add_on_demand_leads",
+        "add_rubric_item",
+        "add_teammate",
+        "add_to_comment_campaign",
+        "add_to_connection_campaign",
+        "add_to_inmail_campaign",
+        "archive_campaign",
+        "attach_recommended_sequence",
+        "attach_sequence",
+        "bulk_enrich_with_prospeo",
+        "cancel_campaign_message_preparation",
+        "cancel_lead_import",
+        "capture_post_idea",
+        "check_rubric",
+        "commit_blueprint",
+        "confirm_harvest_job_companies",
+        "confirm_lead_list",
+        "confirm_prospeo_company_accounts",
+        "copy_sender_config",
+        "create_campaign",
+        "create_on_demand_campaign",
+        "create_on_demand_table",
+        "create_workspace",
+        "create_workflow_table",
+        "delete_column",
+        "delete_rubric_item",
+        "duplicate_campaign",
+        "enrich_with_prospeo",
+        "fill_campaign_horizon",
+        "get_or_create_direct_campaign_table",
+        "import_leads",
+        "load_csv_dnc_entries",
+        "load_csv_domains",
+        "load_csv_linkedin_leads",
+        "mark_post_published",
+        "migrate_flat_configs",
+        "pause_campaign",
+        "pause_direct_campaign",
+        "pause_on_demand_campaign",
+        "prepare_campaign_ab_test",
+        "queue_campaign_cells",
+        "queue_cells",
+        "record_campaign_review_batch",
+        "record_engage_proven_search",
+        "refill_sends",
+        "refresh_paid_inmail_credits",
+        "revise_message_template_and_rerun",
+        "save_domain_filters",
+        "save_hook_research",
+        "save_post_draft",
+        "save_rubrics",
+        "send_inbox_draft",
+        "send_inbox_manual_reply",
+        "set_active_workspace",
+        "set_campaign_waterfall_order",
+        "set_company_info",
+        "set_engage_state",
+        "set_engage_style_guide",
+        "set_headline_icp_criteria",
+        "set_sender_routing",
+        "setup_evergreen_campaigns",
+        "start_campaign",
+        "start_campaign_message_preparation",
+        "start_direct_campaign",
+        "start_on_demand_campaign",
+        "update_campaign",
+        "update_campaign_brief",
+        "update_cell",
+        "update_column",
+        "update_inbox_draft",
+        "update_post_draft",
+        "update_published_post_metrics",
+        "update_rubric_item",
+        "upsert_engage_tracked_person",
+        "upsert_rubric"
+      ],
+      "transitions": {
+        "packet_returned": "report",
+        "workspace_access": "report"
+      }
+    },
+    {
+      "id": "report",
+      "description": "Present packet, lane source, laneChain, itinerary, warnings, blockers, plan revision, and journal path; then stop.",
+      "allowedTools": [],
+      "onEnter": [
+        {
+          "action": "present_packet_itinerary_and_journal_path"
+        }
+      ],
+      "terminal": true
+    }
+  ],
+  "verification": {
+    "requiredProof": [
+      "sideEffects all false in get_refill_plan_v2 response",
+      "planRevision has pr1: prefix unless blocker is workspace_access",
+      "journalPath reported or journalWriteFailed warning surfaced",
+      "chosen evergreenRung belongs to enumeratedRungs",
+      "lane source belongs to managed_waterfall, dashboard_evergreen, active_campaign",
+      "laneChain recorded when active_campaign chain is selected",
+      "no_refillable_campaigns terminal reported when no lane is refillable",
+      "packet reviewed with itinerary and blockers"
+    ],
+    "notCompletionProof": [
+      "called get_refill_plan_v2 alone",
+      "action queue exists",
+      "ready rows alone",
+      "operator wants execution"
+    ]
+  }
+}