@sellable/mcp 0.1.768 → 0.1.769

package/dist/tools/{evergreen-refill-plan.js → refill-execution-plan.js}

@@ -35,7 +35,7 @@ function isRecord(value) {
 function deepClone(value) {
     return JSON.parse(JSON.stringify(value));
 }
-export function sanitizeEvergreenRefillPlanResult(value) {
+export function sanitizeRefillExecutionPlanResult(value) {
     if (!isRecord(value))
         return {};
     const sanitized = {};
@@ -76,7 +76,7 @@ export function sanitizeEvergreenRefillPlanResult(value) {
     }
     return sanitized;
 }
-export function projectedV2Packet(packet) {
+export function projectedRefillExecutionPacket(packet) {
     const target = isRecord(packet.target) ? packet.target : {};
     const reporting = sanitizeRefillReportingProjection(packet.reporting);
     const reportingContext = sanitizeRefillReportingContextProjection(packet.reportingContext);
@@ -120,7 +120,7 @@ export function buildRunStateFromLocalHints(workspaceId) {
         passRates: state?.passRates ?? [],
     };
 }
-async function postRefillPlanV2(body, workspaceId) {
+async function postRefillExecutionPlan(body, workspaceId) {
     const api = getApi();
     const requestOptions = workspaceRequestOptions(workspaceId);
     return requestOptions
@@ -150,7 +150,7 @@ function writeDryRunJournal(params) {
         ? params.result.bootstrap
         : {};
     appendJournalEvent(created.filePath, renderBootstrapSection({
-        summary: "Refill v2 dry-run bootstrap across managed waterfall, dashboard evergreen, and active campaign lanes",
+        summary: "Refill exact-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 ?? []),
@@ -188,7 +188,7 @@ function writeDryRunJournal(params) {
         fileName: path.basename(created.filePath),
         workspaceId: params.workspaceId,
         dryRun: true,
-        summary: "refill v2 dry-run",
+        summary: "refill exact-run dry-run",
     });
     return created.filePath;
 }
@@ -198,7 +198,7 @@ function writeWorkspaceAccessJournal(params) {
         dryRun: true,
     });
     appendJournalEvent(created.filePath, renderBootstrapSection({
-        summary: "Refill v2 dry-run bootstrap stopped at workspace access",
+        summary: "Refill exact-run dry-run bootstrap stopped at workspace access",
         senderSummary: "[]",
         laneSummary: "[]",
         targetSummary: `workspaceId=${params.workspaceId}`,
@@ -217,7 +217,7 @@ function writeWorkspaceAccessJournal(params) {
         fileName: path.basename(created.filePath),
         workspaceId: params.workspaceId,
         dryRun: true,
-        summary: "refill v2 dry-run workspace_access blocker",
+        summary: "refill exact-run dry-run workspace_access blocker",
     });
     return created.filePath;
 }
@@ -226,60 +226,10 @@ function isWorkspaceAccessError(error) {
         error.status === 403 &&
         error.body.includes("No access to workspace"));
 }
-export const refillPlanV2ToolDefinitions = [
-    {
-        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: {
-                workspaceId: {
-                    type: "string",
-                    description: "Explicit request-scoped workspace id.",
-                },
-                senderIds: {
-                    type: "array",
-                    items: { type: "string" },
-                },
-                actionTypes: {
-                    type: "array",
-                    items: {
-                        type: "string",
-                        enum: ["send_invite", "send_inmail_closed"],
-                    },
-                    description: "Optional exact refill lane selector.",
-                },
-                approvalMode: {
-                    type: "string",
-                    enum: ["approve", "mark_ready"],
-                },
-                runState: {
-                    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.",
-                },
-                journalNote: {
-                    type: "string",
-                    description: "Optional note appended to the terminal journal section.",
-                },
-            },
-            required: ["workspaceId"],
-            additionalProperties: false,
-        },
-    },
-];
-export async function getRefillPlanV2(input) {
+export async function getRefillExecutionPlan(input) {
     const workspaceId = normalizeExplicitWorkspaceId(input.workspaceId);
     if (!workspaceId) {
-        throw new Error("workspaceId is required for get_refill_plan_v2.");
+        throw new Error("workspaceId is required for the exact refill plan.");
     }
     const runState = input.runState !== undefined
         ? input.runState
@@ -316,14 +266,14 @@ export async function getRefillPlanV2(input) {
                 messageTemplateRevision,
                 runState,
             }));
-            raw = projectedV2Packet({
+            raw = projectedRefillExecutionPacket({
                 ...packet,
                 runHandle,
                 ...(reportingContext ? { reportingContext } : {}),
             });
         }
         else {
-            raw = await postRefillPlanV2({
+            raw = await postRefillExecutionPlan({
                 workspaceId,
                 intent: input.intent ?? "auto",
                 senderIds: input.senderIds,
@@ -362,7 +312,7 @@ export async function getRefillPlanV2(input) {
             warnings,
             journalPath,
             text: [
-                "Refill sends v2 dry-run blocked: workspace_access",
+                "Refill exact-run dry-run blocked: workspace_access",
                 `Workspace: ${workspaceId}`,
                 guidance,
                 journalPath ? `Journal: ${journalPath}` : "Journal: not written",
@@ -370,7 +320,7 @@ export async function getRefillPlanV2(input) {
             workspaceResolution: "explicit",
         };
     }
-    const sanitized = sanitizeEvergreenRefillPlanResult(raw);
+    const sanitized = sanitizeRefillExecutionPlanResult(raw);
     const warnings = Array.isArray(sanitized.warnings)
         ? [...sanitized.warnings]
         : [];
@@ -388,7 +338,7 @@ export async function getRefillPlanV2(input) {
         }
     }
     const summary = [
-        "Refill sends v2 dry-run plan:",
+        "Refill exact-run dry-run plan:",
         ...planSummaryLines(sanitized),
         journalPath ? `Journal: ${journalPath}` : "Journal: not written",
     ].join("\n");
@@ -401,5 +351,3 @@ export async function getRefillPlanV2(input) {
         workspaceResolution: "explicit",
     };
 }
-/** @deprecated Use getRefillPlanV2. */
-export const getEvergreenRefillPlan = getRefillPlanV2;

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

@@ -659,7 +659,7 @@ export declare function refillSendsCommand(input?: RefillSendsCommandInput): {
     workspaceResolution: string;
     intent: RefillSendsIntent;
 };
-export declare const REFILL_FLOW_MINIMUM_VERSION = "v1.8";
+export declare const REFILL_FLOW_MINIMUM_VERSION = "v1.9";
 export declare const REFILL_FLOW_COMPATIBLE_MAJOR = "v1";
 /**
  * Whether an observed flow-asset version satisfies the consumer's contract.

package/dist/tools/refill-sends.js

@@ -1,8 +1,8 @@
 import { decodeRefillReadinessAuthority, refillReadinessFingerprint, } from "../refill-readiness.js";
 import { getPrepareCampaignMessagesStatus } from "./campaign-message-preparation.js";
 import { MESSAGE_TEMPLATE_REVISION_INPUT_SCHEMA, REFILL_REPORTING_CONTEXT_INPUT_SCHEMA, REFILL_RUN_HANDLE_INPUT_SCHEMA, REFILL_TARGET_CONFIG_INPUT_SCHEMA, normalizeMessageTemplateRevision, normalizeRefillRunHandle, normalizeRefillTargetConfig, } from "./campaign-processing.js";
+import { executeRefillExactRun } from "./refill-exact-run.js";
 import { actionCampaignId, actionIds, actionSenderId, classifyPaidInmailRefreshReceipt, collectPaidInmailRefreshActions, executeOneYoloPrimitive, executeStartCampaignPrimitive, firstGlobalAction, normalizeStrings, numberValue, recordValue, refreshPaidInmailCreditsWithRetry, stringValue, } from "./refill-executors.js";
-import { refillSendsV2Command } from "./refill-sends-v2.js";
 import { getRefillTargetPlan } from "./refill-target-plan.js";
 import { listSenders } from "./senders.js";
 import { createWorkspaceContext, normalizeExplicitWorkspaceId, } from "./workspace-context.js";
@@ -428,19 +428,11 @@ export const refillSendsToolDefinitions = [
 export function refillSendsCommand(input = {}) {
     return buildRefillSendsCommand(normalizeRefillSendsInput(input));
 }
-// fix(112ao-4): the refill flow contract was matched by EXACT STRING across a
-// release boundary — the flow asset ships in the npm package (@sellable/mcp)
-// while the skill that verifies it is installed separately into
-// ~/.codex/plugins/cache. Exact equality makes EVERY contract change breaking:
-// bumping v1.8 -> v1.9 halted every customer-real run with
-// workflow_version_mismatch, and a full repo sweep could not have caught it
-// because the authoritative consumer is not in this repo.
-//
-// The version value itself is deliberately NOT changed here. What changes is
-// the comparison: consumers accept any same-major version at or above the
-// minimum, so additive flow changes ship without a coordinated skill release.
-// A breaking change still gets a major bump (v2), which correctly fails closed.
-export const REFILL_FLOW_MINIMUM_VERSION = "v1.8";
+// The canonical refill asset is v1.9. Consumers accept later additive v1
+// revisions so separately installed host wrappers do not turn v1.10 into an
+// accidental breaking change. A real breaking contract still gets v2 and
+// fails closed.
+export const REFILL_FLOW_MINIMUM_VERSION = "v1.9";
 export const REFILL_FLOW_COMPATIBLE_MAJOR = "v1";
 function parseFlowVersion(value) {
     if (typeof value !== "string")
@@ -502,9 +494,8 @@ function buildRefillSendsCommand(input) {
         workflowAsset: {
             subskillName: "refill-sends-workflow",
             assetPath: "core/flow.v1.json",
-            // fix(112ao-4): `expectedVersion` is retained verbatim so consumers
-            // already installed against the exact-match contract keep working. New
-            // consumers read the range fields instead. See REFILL_FLOW_VERSION_RANGE.
+            // Keep expectedVersion for older response readers; current consumers use
+            // the compatible same-major range fields.
             expectedVersion: REFILL_FLOW_MINIMUM_VERSION,
             minimumVersion: REFILL_FLOW_MINIMUM_VERSION,
             compatibleMajor: REFILL_FLOW_COMPATIBLE_MAJOR,
@@ -556,7 +547,7 @@ function buildRefillSendsCommand(input) {
         },
         firstOperationalSteps: [
             'Load get_subskill_prompt({ subskillName: "refill-sends-workflow" }) before any product operation.',
-            'Load get_subskill_asset({ subskillName: "refill-sends-workflow", assetPath: "core/flow.v1.json" }) before any product operation; continue chunks until hasMore is false, parse JSON, and require workflow:"refill-sends-workflow" plus a COMPATIBLE version: same major (v1) with minor at or above the v1.8 minimum, so v1.8, v1.9, and v1.10 all pass while v2.x does not. Report the verified version before D1. A missing, unparseable, wrong-major, or below-minimum version is workflow_version_mismatch and must stop before get_refill_target_plan or mutation. Do not compare the version by exact string equality.',
+            'Load get_subskill_asset({ subskillName: "refill-sends-workflow", assetPath: "core/flow.v1.json" }) before any product operation; continue chunks until hasMore is false, parse JSON, and require workflow:"refill-sends-workflow" plus a COMPATIBLE version: same major (v1) with minor at or above the v1.9 minimum, so v1.9 and v1.10 pass while v1.8 and v2.x do not. Report the verified version before D1. A missing, unparseable, wrong-major, or below-minimum version is workflow_version_mismatch and must stop before get_refill_target_plan or mutation. Do not compare the version by exact string equality.',
             "A skill cannot create or invoke /goal by itself. If this refill is already running inside an active Codex goal, keep that goal open until every selected sender lane is horizon-filled by projected coverage (sent + scheduled), Christian explicitly stops/statuses the run, or a concrete non-scheduler blocker appears.",
             `Call get_refill_target_plan({ intent: "${intent}"${workspaceId ? `, workspaceId: "${workspaceId}"` : ""}${input.campaignId ? `, campaignId: "${input.campaignId}"` : ""}${input.tableId ? `, tableId: "${input.tableId}"` : ""}${senderIds.length > 0 ? `, senderIds: ${JSON.stringify(senderIds)}` : ""}${senderNames.length > 0
                 ? `, senderNames: ${JSON.stringify(senderNames)}`
@@ -3967,7 +3958,7 @@ export async function executeRefillSendsCommand(input = {}) {
         // The tool contract promises that an already-approved packet's
         // expectedTargetShapeRevision/expectedActionKey are compared against a
         // fresh plan before any refresh or mutation; enforce that before handing
-        // control to the fenced v2 run loop.
+        // control to the fenced exact-run loop.
         if (!isWorkspaceCoordinator &&
             (scopedInput.expectedTargetShapeRevision || scopedInput.expectedActionKey)) {
             const targetPlanBeforeDispatch = await getRefillTargetPlan(targetPlanInputFor(scopedInput));
@@ -4001,7 +3992,7 @@ export async function executeRefillSendsCommand(input = {}) {
                 };
             }
         }
-        const result = await refillSendsV2Command({
+        const result = await executeRefillExactRun({
             workspaceId,
             intent: targetConfigIntent(exactTargetConfig) ?? scopedInput.intent ?? "auto",
             senderIds: exactTargetConfig?.senderScope.senderIds ??
@@ -4034,7 +4025,7 @@ export async function executeRefillSendsCommand(input = {}) {
                 ? { agentKeywords: scopedInput.agentKeywords }
                 : {}),
             // fix(111p, CloverF): the fence ledger seed (111k) was plumbed through
-            // the v2 input, the loop input, and initialRunState — but THIS dispatch
+            // the exact-run input, the loop input, and initialRunState — but THIS dispatch
             // never passed runState, so every fence still started amnesiac (fence 2
             // persisted zero attempts and re-resolved rung 1 while the coordinator
             // held the attempt ledger). Thread the freshest workspace runState in.

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

@@ -1835,7 +1835,7 @@ export function sanitizeRefillTargetPlanResult(result) {
         // The explicit template-revision primitive is fenced to an exact
         // campaign/table/cohort and is intentionally independent of sender lane
         // eligibility. get_refill_target_plan attaches it after its first strict
-        // sanitization; get_refill_plan_v2 then sanitizes that already-sanitized
+        // sanitization; the exact refill plan then sanitizes that already-sanitized
         // packet a second time. Preserve only that fully normalized primitive so a
         // disconnected sender cannot erase approved revision authority before the
         // fenced loop reaches g2_execute. Every other senderless/no-lane packet