@sellable/mcp 0.1.744 → 0.1.746

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

@@ -649,6 +649,9 @@ export declare function refillSendsCommand(input?: RefillSendsCommandInput): {
         subskillName: string;
         assetPath: string;
         expectedVersion: string;
+        minimumVersion: string;
+        compatibleMajor: string;
+        versionPolicy: string;
     };
     yolo: boolean;
     executionMode: RefillSendsExecutionMode;
@@ -656,6 +659,19 @@ export declare function refillSendsCommand(input?: RefillSendsCommandInput): {
     workspaceResolution: string;
     intent: RefillSendsIntent;
 };
+export declare const REFILL_FLOW_MINIMUM_VERSION = "v1.8";
+export declare const REFILL_FLOW_COMPATIBLE_MAJOR = "v1";
+/**
+ * Whether an observed flow-asset version satisfies the consumer's contract.
+ *
+ * Compatible when the major matches and the minor is >= the minimum. An
+ * unparseable or absent version stays a mismatch: this widens the accepted
+ * range, it never weakens the requirement that a version be verified at all.
+ */
+export declare function isCompatibleRefillFlowVersion(actualVersion: unknown, bounds?: {
+    minimumVersion?: string;
+    compatibleMajor?: string;
+}): boolean;
 type WorkspaceExactTarget = {
     campaignId: string;
     tableId: string;
@@ -809,6 +825,9 @@ export declare function executeRefillSendsCommand(input?: RefillSendsCommandInpu
         subskillName: string;
         assetPath: string;
         expectedVersion: string;
+        minimumVersion: string;
+        compatibleMajor: string;
+        versionPolicy: string;
     };
     yolo: boolean;
     executionMode: RefillSendsExecutionMode;
@@ -912,6 +931,9 @@ export declare function executeRefillSendsCommand(input?: RefillSendsCommandInpu
         subskillName: string;
         assetPath: string;
         expectedVersion: string;
+        minimumVersion: string;
+        compatibleMajor: string;
+        versionPolicy: string;
     };
     yolo: boolean;
     executionMode: RefillSendsExecutionMode;
@@ -1020,6 +1042,9 @@ export declare function executeRefillSendsCommand(input?: RefillSendsCommandInpu
         subskillName: string;
         assetPath: string;
         expectedVersion: string;
+        minimumVersion: string;
+        compatibleMajor: string;
+        versionPolicy: string;
     };
     yolo: boolean;
     executionMode: RefillSendsExecutionMode;
@@ -1182,6 +1207,9 @@ export declare function executeRefillSendsCommand(input?: RefillSendsCommandInpu
         subskillName: string;
         assetPath: string;
         expectedVersion: string;
+        minimumVersion: string;
+        compatibleMajor: string;
+        versionPolicy: string;
     };
     yolo: boolean;
     executionMode: RefillSendsExecutionMode;
@@ -1349,6 +1377,9 @@ export declare function executeRefillSendsCommand(input?: RefillSendsCommandInpu
         subskillName: string;
         assetPath: string;
         expectedVersion: string;
+        minimumVersion: string;
+        compatibleMajor: string;
+        versionPolicy: string;
     };
     yolo: boolean;
     executionMode: RefillSendsExecutionMode;
@@ -1465,6 +1496,9 @@ export declare function executeRefillSendsCommand(input?: RefillSendsCommandInpu
         subskillName: string;
         assetPath: string;
         expectedVersion: string;
+        minimumVersion: string;
+        compatibleMajor: string;
+        versionPolicy: string;
     };
     yolo: boolean;
     executionMode: RefillSendsExecutionMode;
@@ -1584,6 +1618,9 @@ export declare function executeRefillSendsCommand(input?: RefillSendsCommandInpu
         subskillName: string;
         assetPath: string;
         expectedVersion: string;
+        minimumVersion: string;
+        compatibleMajor: string;
+        versionPolicy: string;
     };
     yolo: boolean;
     executionMode: RefillSendsExecutionMode;
@@ -1702,6 +1739,9 @@ export declare function executeRefillSendsCommand(input?: RefillSendsCommandInpu
         subskillName: string;
         assetPath: string;
         expectedVersion: string;
+        minimumVersion: string;
+        compatibleMajor: string;
+        versionPolicy: string;
     };
     yolo: boolean;
     executionMode: RefillSendsExecutionMode;
@@ -1823,6 +1863,9 @@ export declare function executeRefillSendsCommand(input?: RefillSendsCommandInpu
         subskillName: string;
         assetPath: string;
         expectedVersion: string;
+        minimumVersion: string;
+        compatibleMajor: string;
+        versionPolicy: string;
     };
     yolo: boolean;
     executionMode: RefillSendsExecutionMode;
@@ -1985,6 +2028,9 @@ export declare function executeRefillSendsCommand(input?: RefillSendsCommandInpu
         subskillName: string;
         assetPath: string;
         expectedVersion: string;
+        minimumVersion: string;
+        compatibleMajor: string;
+        versionPolicy: string;
     };
     yolo: boolean;
     executionMode: RefillSendsExecutionMode;
@@ -2093,6 +2139,9 @@ export declare function executeRefillSendsCommand(input?: RefillSendsCommandInpu
         subskillName: string;
         assetPath: string;
         expectedVersion: string;
+        minimumVersion: string;
+        compatibleMajor: string;
+        versionPolicy: string;
     };
     yolo: boolean;
     executionMode: RefillSendsExecutionMode;
@@ -2259,6 +2308,9 @@ export declare function executeRefillSendsCommand(input?: RefillSendsCommandInpu
         subskillName: string;
         assetPath: string;
         expectedVersion: string;
+        minimumVersion: string;
+        compatibleMajor: string;
+        versionPolicy: string;
     };
     yolo: boolean;
     executionMode: RefillSendsExecutionMode;
@@ -2381,6 +2433,9 @@ export declare function executeRefillSendsCommand(input?: RefillSendsCommandInpu
         subskillName: string;
         assetPath: string;
         expectedVersion: string;
+        minimumVersion: string;
+        compatibleMajor: string;
+        versionPolicy: string;
     };
     yolo: boolean;
     executionMode: RefillSendsExecutionMode;
@@ -2516,6 +2571,9 @@ export declare function executeRefillSendsCommand(input?: RefillSendsCommandInpu
         subskillName: string;
         assetPath: string;
         expectedVersion: string;
+        minimumVersion: string;
+        compatibleMajor: string;
+        versionPolicy: string;
     };
     yolo: boolean;
     executionMode: RefillSendsExecutionMode;
@@ -2641,6 +2699,9 @@ export declare function executeRefillSendsCommand(input?: RefillSendsCommandInpu
         subskillName: string;
         assetPath: string;
         expectedVersion: string;
+        minimumVersion: string;
+        compatibleMajor: string;
+        versionPolicy: string;
     };
     yolo: boolean;
     executionMode: RefillSendsExecutionMode;
@@ -2765,6 +2826,9 @@ export declare function executeRefillSendsCommand(input?: RefillSendsCommandInpu
         subskillName: string;
         assetPath: string;
         expectedVersion: string;
+        minimumVersion: string;
+        compatibleMajor: string;
+        versionPolicy: string;
     };
     yolo: boolean;
     executionMode: RefillSendsExecutionMode;
@@ -2922,6 +2986,9 @@ export declare function executeRefillSendsCommand(input?: RefillSendsCommandInpu
         subskillName: string;
         assetPath: string;
         expectedVersion: string;
+        minimumVersion: string;
+        compatibleMajor: string;
+        versionPolicy: string;
     };
     yolo: boolean;
     executionMode: RefillSendsExecutionMode;
@@ -3042,6 +3109,9 @@ export declare function executeRefillSendsCommand(input?: RefillSendsCommandInpu
         subskillName: string;
         assetPath: string;
         expectedVersion: string;
+        minimumVersion: string;
+        compatibleMajor: string;
+        versionPolicy: string;
     };
     yolo: boolean;
     executionMode: RefillSendsExecutionMode;
@@ -3136,6 +3206,9 @@ export declare function executeRefillSendsCommand(input?: RefillSendsCommandInpu
         subskillName: string;
         assetPath: string;
         expectedVersion: string;
+        minimumVersion: string;
+        compatibleMajor: string;
+        versionPolicy: string;
     };
     yolo: boolean;
     executionMode: RefillSendsExecutionMode;
@@ -3226,6 +3299,9 @@ export declare function executeRefillSendsCommand(input?: RefillSendsCommandInpu
         subskillName: string;
         assetPath: string;
         expectedVersion: string;
+        minimumVersion: string;
+        compatibleMajor: string;
+        versionPolicy: string;
     };
     yolo: boolean;
     executionMode: RefillSendsExecutionMode;
@@ -3343,6 +3419,9 @@ export declare function executeRefillSendsCommand(input?: RefillSendsCommandInpu
         subskillName: string;
         assetPath: string;
         expectedVersion: string;
+        minimumVersion: string;
+        compatibleMajor: string;
+        versionPolicy: string;
     };
     yolo: boolean;
     executionMode: RefillSendsExecutionMode;
@@ -3572,6 +3651,9 @@ export declare function executeRefillSendsCommand(input?: RefillSendsCommandInpu
         subskillName: string;
         assetPath: string;
         expectedVersion: string;
+        minimumVersion: string;
+        compatibleMajor: string;
+        versionPolicy: string;
     };
     yolo: boolean;
     executionMode: RefillSendsExecutionMode;
@@ -3807,6 +3889,9 @@ export declare function executeRefillSendsCommand(input?: RefillSendsCommandInpu
         subskillName: string;
         assetPath: string;
         expectedVersion: string;
+        minimumVersion: string;
+        compatibleMajor: string;
+        versionPolicy: string;
     };
     yolo: boolean;
     executionMode: RefillSendsExecutionMode;
@@ -4040,6 +4125,9 @@ export declare function executeRefillSendsCommand(input?: RefillSendsCommandInpu
         subskillName: string;
         assetPath: string;
         expectedVersion: string;
+        minimumVersion: string;
+        compatibleMajor: string;
+        versionPolicy: string;
     };
     yolo: boolean;
     executionMode: RefillSendsExecutionMode;
@@ -4269,6 +4357,9 @@ export declare function executeRefillSendsCommand(input?: RefillSendsCommandInpu
         subskillName: string;
         assetPath: string;
         expectedVersion: string;
+        minimumVersion: string;
+        compatibleMajor: string;
+        versionPolicy: string;
     };
     yolo: boolean;
     executionMode: RefillSendsExecutionMode;
@@ -4503,6 +4594,9 @@ export declare function executeRefillSendsCommand(input?: RefillSendsCommandInpu
         subskillName: string;
         assetPath: string;
         expectedVersion: string;
+        minimumVersion: string;
+        compatibleMajor: string;
+        versionPolicy: string;
     };
     yolo: boolean;
     executionMode: RefillSendsExecutionMode;
@@ -4739,6 +4833,9 @@ export declare function executeRefillSendsCommand(input?: RefillSendsCommandInpu
         subskillName: string;
         assetPath: string;
         expectedVersion: string;
+        minimumVersion: string;
+        compatibleMajor: string;
+        versionPolicy: string;
     };
     yolo: boolean;
     executionMode: RefillSendsExecutionMode;
@@ -4974,6 +5071,9 @@ export declare function executeRefillSendsCommand(input?: RefillSendsCommandInpu
         subskillName: string;
         assetPath: string;
         expectedVersion: string;
+        minimumVersion: string;
+        compatibleMajor: string;
+        versionPolicy: string;
     };
     yolo: boolean;
     executionMode: RefillSendsExecutionMode;
@@ -5213,6 +5313,9 @@ export declare function executeRefillSendsCommand(input?: RefillSendsCommandInpu
         subskillName: string;
         assetPath: string;
         expectedVersion: string;
+        minimumVersion: string;
+        compatibleMajor: string;
+        versionPolicy: string;
     };
     yolo: boolean;
     executionMode: RefillSendsExecutionMode;
@@ -5445,6 +5548,9 @@ export declare function executeRefillSendsCommand(input?: RefillSendsCommandInpu
         subskillName: string;
         assetPath: string;
         expectedVersion: string;
+        minimumVersion: string;
+        compatibleMajor: string;
+        versionPolicy: string;
     };
     yolo: boolean;
     executionMode: RefillSendsExecutionMode;
@@ -5683,6 +5789,9 @@ export declare function executeRefillSendsCommand(input?: RefillSendsCommandInpu
         subskillName: string;
         assetPath: string;
         expectedVersion: string;
+        minimumVersion: string;
+        compatibleMajor: string;
+        versionPolicy: string;
     };
     yolo: boolean;
     executionMode: RefillSendsExecutionMode;
@@ -5919,6 +6028,9 @@ export declare function executeRefillSendsCommand(input?: RefillSendsCommandInpu
         subskillName: string;
         assetPath: string;
         expectedVersion: string;
+        minimumVersion: string;
+        compatibleMajor: string;
+        versionPolicy: string;
     };
     yolo: boolean;
     executionMode: RefillSendsExecutionMode;
@@ -6151,6 +6263,9 @@ export declare function executeRefillSendsCommand(input?: RefillSendsCommandInpu
         subskillName: string;
         assetPath: string;
         expectedVersion: string;
+        minimumVersion: string;
+        compatibleMajor: string;
+        versionPolicy: string;
     };
     yolo: boolean;
     executionMode: RefillSendsExecutionMode;
@@ -6388,6 +6503,9 @@ export declare function executeRefillSendsCommand(input?: RefillSendsCommandInpu
         subskillName: string;
         assetPath: string;
         expectedVersion: string;
+        minimumVersion: string;
+        compatibleMajor: string;
+        versionPolicy: string;
     };
     yolo: boolean;
     executionMode: RefillSendsExecutionMode;
@@ -6627,6 +6745,9 @@ export declare function executeRefillSendsCommand(input?: RefillSendsCommandInpu
         subskillName: string;
         assetPath: string;
         expectedVersion: string;
+        minimumVersion: string;
+        compatibleMajor: string;
+        versionPolicy: string;
     };
     yolo: boolean;
     executionMode: RefillSendsExecutionMode;
@@ -6864,6 +6985,9 @@ export declare function executeRefillSendsCommand(input?: RefillSendsCommandInpu
         subskillName: string;
         assetPath: string;
         expectedVersion: string;
+        minimumVersion: string;
+        compatibleMajor: string;
+        versionPolicy: string;
     };
     yolo: boolean;
     executionMode: RefillSendsExecutionMode;
@@ -7095,6 +7219,9 @@ export declare function executeRefillSendsCommand(input?: RefillSendsCommandInpu
         subskillName: string;
         assetPath: string;
         expectedVersion: string;
+        minimumVersion: string;
+        compatibleMajor: string;
+        versionPolicy: string;
     };
     yolo: boolean;
     executionMode: RefillSendsExecutionMode;
@@ -7332,6 +7459,9 @@ export declare function executeRefillSendsCommand(input?: RefillSendsCommandInpu
         subskillName: string;
         assetPath: string;
         expectedVersion: string;
+        minimumVersion: string;
+        compatibleMajor: string;
+        versionPolicy: string;
     };
     yolo: boolean;
     executionMode: RefillSendsExecutionMode;
@@ -7567,6 +7697,9 @@ export declare function executeRefillSendsCommand(input?: RefillSendsCommandInpu
         subskillName: string;
         assetPath: string;
         expectedVersion: string;
+        minimumVersion: string;
+        compatibleMajor: string;
+        versionPolicy: string;
     };
     yolo: boolean;
     executionMode: RefillSendsExecutionMode;
@@ -7798,6 +7931,9 @@ export declare function executeRefillSendsCommand(input?: RefillSendsCommandInpu
         subskillName: string;
         assetPath: string;
         expectedVersion: string;
+        minimumVersion: string;
+        compatibleMajor: string;
+        versionPolicy: string;
     };
     yolo: boolean;
     executionMode: RefillSendsExecutionMode;
@@ -8034,6 +8170,9 @@ export declare function executeRefillSendsCommand(input?: RefillSendsCommandInpu
         subskillName: string;
         assetPath: string;
         expectedVersion: string;
+        minimumVersion: string;
+        compatibleMajor: string;
+        versionPolicy: string;
     };
     yolo: boolean;
     executionMode: RefillSendsExecutionMode;
@@ -8272,6 +8411,9 @@ export declare function executeRefillSendsCommand(input?: RefillSendsCommandInpu
         subskillName: string;
         assetPath: string;
         expectedVersion: string;
+        minimumVersion: string;
+        compatibleMajor: string;
+        versionPolicy: string;
     };
     yolo: boolean;
     executionMode: RefillSendsExecutionMode;
@@ -8508,6 +8650,9 @@ export declare function executeRefillSendsCommand(input?: RefillSendsCommandInpu
         subskillName: string;
         assetPath: string;
         expectedVersion: string;
+        minimumVersion: string;
+        compatibleMajor: string;
+        versionPolicy: string;
     };
     yolo: boolean;
     executionMode: RefillSendsExecutionMode;
@@ -8775,6 +8920,9 @@ export declare function executeRefillSendsCommand(input?: RefillSendsCommandInpu
         subskillName: string;
         assetPath: string;
         expectedVersion: string;
+        minimumVersion: string;
+        compatibleMajor: string;
+        versionPolicy: string;
     };
     yolo: boolean;
     executionMode: RefillSendsExecutionMode;
@@ -9007,6 +9155,9 @@ export declare function executeRefillSendsCommand(input?: RefillSendsCommandInpu
         subskillName: string;
         assetPath: string;
         expectedVersion: string;
+        minimumVersion: string;
+        compatibleMajor: string;
+        versionPolicy: string;
     };
     yolo: boolean;
     executionMode: RefillSendsExecutionMode;
@@ -9245,6 +9396,9 @@ export declare function executeRefillSendsCommand(input?: RefillSendsCommandInpu
         subskillName: string;
         assetPath: string;
         expectedVersion: string;
+        minimumVersion: string;
+        compatibleMajor: string;
+        versionPolicy: string;
     };
     yolo: boolean;
     executionMode: RefillSendsExecutionMode;
@@ -9481,6 +9635,9 @@ export declare function executeRefillSendsCommand(input?: RefillSendsCommandInpu
         subskillName: string;
         assetPath: string;
         expectedVersion: string;
+        minimumVersion: string;
+        compatibleMajor: string;
+        versionPolicy: string;
     };
     yolo: boolean;
     executionMode: RefillSendsExecutionMode;
@@ -9713,6 +9870,9 @@ export declare function executeRefillSendsCommand(input?: RefillSendsCommandInpu
         subskillName: string;
         assetPath: string;
         expectedVersion: string;
+        minimumVersion: string;
+        compatibleMajor: string;
+        versionPolicy: string;
     };
     yolo: boolean;
     executionMode: RefillSendsExecutionMode;
@@ -9950,6 +10110,9 @@ export declare function executeRefillSendsCommand(input?: RefillSendsCommandInpu
         subskillName: string;
         assetPath: string;
         expectedVersion: string;
+        minimumVersion: string;
+        compatibleMajor: string;
+        versionPolicy: string;
     };
     yolo: boolean;
     executionMode: RefillSendsExecutionMode;
@@ -10189,6 +10352,9 @@ export declare function executeRefillSendsCommand(input?: RefillSendsCommandInpu
         subskillName: string;
         assetPath: string;
         expectedVersion: string;
+        minimumVersion: string;
+        compatibleMajor: string;
+        versionPolicy: string;
     };
     yolo: boolean;
     executionMode: RefillSendsExecutionMode;
@@ -10426,6 +10592,9 @@ export declare function executeRefillSendsCommand(input?: RefillSendsCommandInpu
         subskillName: string;
         assetPath: string;
         expectedVersion: string;
+        minimumVersion: string;
+        compatibleMajor: string;
+        versionPolicy: string;
     };
     yolo: boolean;
     executionMode: RefillSendsExecutionMode;
@@ -10705,6 +10874,9 @@ export declare function executeRefillSendsCommand(input?: RefillSendsCommandInpu
         subskillName: string;
         assetPath: string;
         expectedVersion: string;
+        minimumVersion: string;
+        compatibleMajor: string;
+        versionPolicy: string;
     };
     yolo: boolean;
     executionMode: RefillSendsExecutionMode;
@@ -10928,6 +11100,9 @@ export declare function executeRefillSendsCommand(input?: RefillSendsCommandInpu
         subskillName: string;
         assetPath: string;
         expectedVersion: string;
+        minimumVersion: string;
+        compatibleMajor: string;
+        versionPolicy: string;
     };
     yolo: boolean;
     executionMode: RefillSendsExecutionMode;
@@ -11186,6 +11361,9 @@ export declare function executeRefillSendsCommand(input?: RefillSendsCommandInpu
         subskillName: string;
         assetPath: string;
         expectedVersion: string;
+        minimumVersion: string;
+        compatibleMajor: string;
+        versionPolicy: string;
     };
     yolo: boolean;
     executionMode: RefillSendsExecutionMode;
@@ -11348,6 +11526,9 @@ export declare function executeRefillSendsCommand(input?: RefillSendsCommandInpu
         subskillName: string;
         assetPath: string;
         expectedVersion: string;
+        minimumVersion: string;
+        compatibleMajor: string;
+        versionPolicy: string;
     };
     yolo: boolean;
     executionMode: RefillSendsExecutionMode;
@@ -11516,6 +11697,9 @@ export declare function executeRefillSendsCommand(input?: RefillSendsCommandInpu
         subskillName: string;
         assetPath: string;
         expectedVersion: string;
+        minimumVersion: string;
+        compatibleMajor: string;
+        versionPolicy: string;
     };
     yolo: boolean;
     executionMode: RefillSendsExecutionMode;
@@ -11682,6 +11866,9 @@ export declare function executeRefillSendsCommand(input?: RefillSendsCommandInpu
         subskillName: string;
         assetPath: string;
         expectedVersion: string;
+        minimumVersion: string;
+        compatibleMajor: string;
+        versionPolicy: string;
     };
     yolo: boolean;
     executionMode: RefillSendsExecutionMode;
@@ -11844,6 +12031,9 @@ export declare function executeRefillSendsCommand(input?: RefillSendsCommandInpu
         subskillName: string;
         assetPath: string;
         expectedVersion: string;
+        minimumVersion: string;
+        compatibleMajor: string;
+        versionPolicy: string;
     };
     yolo: boolean;
     executionMode: RefillSendsExecutionMode;
@@ -12011,6 +12201,9 @@ export declare function executeRefillSendsCommand(input?: RefillSendsCommandInpu
         subskillName: string;
         assetPath: string;
         expectedVersion: string;
+        minimumVersion: string;
+        compatibleMajor: string;
+        versionPolicy: string;
     };
     yolo: boolean;
     executionMode: RefillSendsExecutionMode;
@@ -12180,6 +12373,9 @@ export declare function executeRefillSendsCommand(input?: RefillSendsCommandInpu
         subskillName: string;
         assetPath: string;
         expectedVersion: string;
+        minimumVersion: string;
+        compatibleMajor: string;
+        versionPolicy: string;
     };
     yolo: boolean;
     executionMode: RefillSendsExecutionMode;
@@ -12348,6 +12544,9 @@ export declare function executeRefillSendsCommand(input?: RefillSendsCommandInpu
         subskillName: string;
         assetPath: string;
         expectedVersion: string;
+        minimumVersion: string;
+        compatibleMajor: string;
+        versionPolicy: string;
     };
     yolo: boolean;
     executionMode: RefillSendsExecutionMode;
@@ -12456,6 +12655,9 @@ export declare function executeRefillSendsCommand(input?: RefillSendsCommandInpu
         subskillName: string;
         assetPath: string;
         expectedVersion: string;
+        minimumVersion: string;
+        compatibleMajor: string;
+        versionPolicy: string;
     };
     yolo: boolean;
     executionMode: RefillSendsExecutionMode;
@@ -12577,6 +12779,9 @@ export declare function executeRefillSendsCommand(input?: RefillSendsCommandInpu
         subskillName: string;
         assetPath: string;
         expectedVersion: string;
+        minimumVersion: string;
+        compatibleMajor: string;
+        versionPolicy: string;
     };
     yolo: boolean;
     executionMode: RefillSendsExecutionMode;
@@ -12785,6 +12990,9 @@ export declare function executeRefillSendsCommand(input?: RefillSendsCommandInpu
         subskillName: string;
         assetPath: string;
         expectedVersion: string;
+        minimumVersion: string;
+        compatibleMajor: string;
+        versionPolicy: string;
     };
     yolo: boolean;
     executionMode: RefillSendsExecutionMode;

package/dist/tools/refill-sends.js

@@ -423,6 +423,49 @@ 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";
+export const REFILL_FLOW_COMPATIBLE_MAJOR = "v1";
+function parseFlowVersion(value) {
+    if (typeof value !== "string")
+        return null;
+    const match = /^v(\d+)\.(\d+)$/.exec(value.trim());
+    if (!match)
+        return null;
+    const major = Number(match[1]);
+    const minor = Number(match[2]);
+    return Number.isInteger(major) && Number.isInteger(minor)
+        ? { major, minor }
+        : null;
+}
+/**
+ * Whether an observed flow-asset version satisfies the consumer's contract.
+ *
+ * Compatible when the major matches and the minor is >= the minimum. An
+ * unparseable or absent version stays a mismatch: this widens the accepted
+ * range, it never weakens the requirement that a version be verified at all.
+ */
+export function isCompatibleRefillFlowVersion(actualVersion, bounds = {}) {
+    const minimum = parseFlowVersion(bounds.minimumVersion ?? REFILL_FLOW_MINIMUM_VERSION);
+    const actual = parseFlowVersion(actualVersion);
+    if (!minimum || !actual)
+        return false;
+    const expectedMajor = parseFlowVersion(`${bounds.compatibleMajor ?? REFILL_FLOW_COMPATIBLE_MAJOR}.0`);
+    if (!expectedMajor || actual.major !== expectedMajor.major)
+        return false;
+    return actual.minor >= minimum.minor;
+}
 function buildRefillSendsCommand(input) {
     const workspaceId = normalizeExplicitWorkspaceId(input.workspaceId);
     const senders = normalizeStrings(input.senders);
@@ -454,7 +497,13 @@ function buildRefillSendsCommand(input) {
         workflowAsset: {
             subskillName: "refill-sends-workflow",
             assetPath: "core/flow.v1.json",
-            expectedVersion: "v1.8",
+            // 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.
+            expectedVersion: REFILL_FLOW_MINIMUM_VERSION,
+            minimumVersion: REFILL_FLOW_MINIMUM_VERSION,
+            compatibleMajor: REFILL_FLOW_COMPATIBLE_MAJOR,
+            versionPolicy: "compatible_range",
         },
         yolo,
         executionMode,
@@ -502,7 +551,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 exactly workflow:"refill-sends-workflow" and version:"v1.8". Report the verified version before D1. Any other or unverified version is workflow_version_mismatch and must stop before get_refill_target_plan or mutation.',
+            '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.',
             "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)}`

package/package.json

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

package/skills/refill-sends/SKILL.md

@@ -74,10 +74,14 @@ get_subskill_prompt({ subskillName: "refill-sends-workflow" })
 get_subskill_asset({ subskillName: "refill-sends-workflow", assetPath: "core/flow.v1.json" })
 ```
 
-Continue chunks until `hasMore:false`; require
-exactly `workflow:"refill-sends-workflow"` and `version:"v1.8"`, then report
-that verified version before D1. Any other or unverified version is
-`workflow_version_mismatch`: stop before `get_refill_target_plan` or mutation.
+Continue chunks until `hasMore:false`; require `workflow:"refill-sends-workflow"`
+and a COMPATIBLE version: same major (`v1`) and minor at or above the minimum
+`v1.8` — so `v1.8`, `v1.9`, `v1.10` all pass and `v2.x` does not. Report the
+verified version before D1. A missing, unparseable, wrong-major, or
+below-minimum version is `workflow_version_mismatch`: stop before
+`get_refill_target_plan` or mutation. Do NOT require exact string equality: the
+flow asset ships in the npm package while this skill is installed separately,
+so an exact pin makes every additive contract change a breaking one.
 Route intent is immutable:
 workspace-wide `--yolo` uses `intent:"auto"` from first plan through terminal.
 

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

@@ -24,15 +24,20 @@ In `--yolo`, the coordinator may
 perform every fresh planner-ranked safe transition among existing campaigns,
 lanes, and source families. It may not create a new campaign.
 
-The host must load the entire asset and verify exactly `version:"v1.8"` before
-D1. It reports that verified version explicitly. A different or unverified
-version is `workflow_version_mismatch` and stops before planner or mutation.
+The host must load the entire asset and verify a COMPATIBLE version before D1:
+same major (`v1`) and minor at or above the minimum `v1.8`, so `v1.9` and
+`v1.10` are accepted and `v2.x` is not. It reports that verified version
+explicitly. A missing, unparseable, wrong-major, or below-minimum version is
+`workflow_version_mismatch` and stops before planner or mutation. Exact-string
+matching is forbidden here: the asset ships in the npm package while the
+verifying skill installs separately, so an exact pin makes every additive
+change breaking.
 
 ## Closed-loop executor
 
 ```mermaid
 flowchart TD
-    A["Receive exact workspace, sender/action selectors, and date envelope"] --> ASSET["Verify complete flow.v1.json, workflow refill-sends-workflow, exact version v1.8"]
+    A["Receive exact workspace, sender/action selectors, and date envelope"] --> ASSET["Verify complete flow.v1.json, workflow refill-sends-workflow, compatible version v1 >= v1.8"]
     ASSET --> D1["Call get_refill_target_plan read-only with immutable route intent"]
     D1 --> RENDER["Render sender/campaign waterfall, coverage ledger, bounded side effects, forbidden actions, and stop condition"]
     RENDER --> D2["Call refill_sends with workspaceCoordinator true and displayed revision/action pins"]

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

@@ -18,6 +18,9 @@
       "validation": {
         "workflow": "refill-sends-workflow",
         "exactVersion": "v1.8",
+        "versionPolicy": "compatible_range",
+        "minimumVersion": "v1.8",
+        "compatibleMajor": "v1",
         "requiredTopLevelKeys": [
           "states",
           "gateOrder",