@sellable/mcp 0.1.899 → 0.1.901

package/dist/tools/refill-v3-advance-contract.d.ts

@@ -146,7 +146,7 @@ export declare const REFILL_V3_ADVANCE_INPUT_SCHEMA: Readonly<{
         readonly yolo: {
             readonly type: "boolean";
             readonly default: true;
-            readonly description: "The YOLO AUTONOMY GRANT. It defaults to true so an ordinary run continues through bounded preparation and one eligible PAUSED derived-evergreen start instead of stopping for another approval. It is not a mode and selects nothing: WHICH campaign may start is derived from the workspace's own campaigns. Pass false only for an explicit conservative, review-first run.";
+            readonly description: "The YOLO AUTONOMY GRANT. It defaults to true so an ordinary run continues through bounded preparation and one route-selected start-eligible PAUSED campaign instead of stopping for another approval. It is not a mode and selects nothing: WHICH campaign may start is derived from the workspace's canonical waterfall. A finite non-evergreen candidate must already expose positive bounded supply. Pass false only for an explicit conservative, review-first run.";
         };
     };
 }>;
@@ -157,13 +157,14 @@ export type RefillV3AdvanceResultKind = (typeof REFILL_V3_ADVANCE_RESULT_KINDS)[
  * existing authority that owns it; the coordinator never invents an authority
  * and never carries executable prose.
  */
-export declare const REFILL_V3_ADVANCE_ACTION_KINDS: readonly ["refresh_paid_credit_fact", "recheck_sender_connection", "fill_ready", "start_evergreen_campaign"];
+export declare const REFILL_V3_ADVANCE_ACTION_KINDS: readonly ["refresh_paid_credit_fact", "recheck_sender_connection", "fill_ready", "start_paused_campaign", "start_evergreen_campaign"];
 export type RefillV3AdvanceActionKind = (typeof REFILL_V3_ADVANCE_ACTION_KINDS)[number];
 /** The exact existing owner each action key dispatches to. */
 export declare const REFILL_V3_ADVANCE_ACTION_AUTHORITIES: Readonly<{
     readonly refresh_paid_credit_fact: "getOrRefreshPaidInmailCreditFact";
     readonly recheck_sender_connection: "recheckRefillV3SenderConnection";
     readonly fill_ready: "fillRefillV3Ready";
+    readonly start_paused_campaign: "startRefillV3PausedCampaign";
     readonly start_evergreen_campaign: "startRefillV3EvergreenCampaign";
 }>;
 export type RefillV3AdvanceAuthority = (typeof REFILL_V3_ADVANCE_ACTION_AUTHORITIES)[RefillV3AdvanceActionKind];
@@ -464,7 +465,7 @@ export declare const REFILL_V3_ADVANCE_OUTPUT_SCHEMA: Readonly<{
                 };
                 readonly kind: {
                     readonly type: "string";
-                    readonly enum: readonly ["refresh_paid_credit_fact", "recheck_sender_connection", "fill_ready", "start_evergreen_campaign"];
+                    readonly enum: readonly ["refresh_paid_credit_fact", "recheck_sender_connection", "fill_ready", "start_paused_campaign", "start_evergreen_campaign"];
                 };
                 readonly actionKey: {
                     readonly type: "string";
@@ -472,7 +473,7 @@ export declare const REFILL_V3_ADVANCE_OUTPUT_SCHEMA: Readonly<{
                 };
                 readonly authority: {
                     readonly type: "string";
-                    readonly enum: ("getOrRefreshPaidInmailCreditFact" | "recheckRefillV3SenderConnection" | "fillRefillV3Ready" | "startRefillV3EvergreenCampaign")[];
+                    readonly enum: ("getOrRefreshPaidInmailCreditFact" | "recheckRefillV3SenderConnection" | "fillRefillV3Ready" | "startRefillV3PausedCampaign" | "startRefillV3EvergreenCampaign")[];
                 };
             };
         };

package/dist/tools/refill-v3-advance-contract.js

@@ -170,7 +170,7 @@ export const REFILL_V3_ADVANCE_INPUT_SCHEMA = Object.freeze({
         yolo: {
             type: "boolean",
             default: true,
-            description: "The YOLO AUTONOMY GRANT. It defaults to true so an ordinary run continues through bounded preparation and one eligible PAUSED derived-evergreen start instead of stopping for another approval. It is not a mode and selects nothing: WHICH campaign may start is derived from the workspace's own campaigns. Pass false only for an explicit conservative, review-first run.",
+            description: "The YOLO AUTONOMY GRANT. It defaults to true so an ordinary run continues through bounded preparation and one route-selected start-eligible PAUSED campaign instead of stopping for another approval. It is not a mode and selects nothing: WHICH campaign may start is derived from the workspace's canonical waterfall. A finite non-evergreen candidate must already expose positive bounded supply. Pass false only for an explicit conservative, review-first run.",
         },
     },
 });
@@ -194,6 +194,9 @@ export const REFILL_V3_ADVANCE_ACTION_KINDS = [
     "refresh_paid_credit_fact",
     "recheck_sender_connection",
     "fill_ready",
+    "start_paused_campaign",
+    // Backward-compatible receipt/output vocabulary for runs created before
+    // the generic V1 paused-campaign authority was restored.
     "start_evergreen_campaign",
 ];
 /** The exact existing owner each action key dispatches to. */
@@ -201,6 +204,7 @@ export const REFILL_V3_ADVANCE_ACTION_AUTHORITIES = Object.freeze({
     refresh_paid_credit_fact: "getOrRefreshPaidInmailCreditFact",
     recheck_sender_connection: "recheckRefillV3SenderConnection",
     fill_ready: "fillRefillV3Ready",
+    start_paused_campaign: "startRefillV3PausedCampaign",
     start_evergreen_campaign: "startRefillV3EvergreenCampaign",
 });
 /**

package/dist/tools/refill-v3-advance.d.ts

@@ -111,7 +111,7 @@ export declare const refillV3AdvanceToolDefinitions: {
             readonly yolo: {
                 readonly type: "boolean";
                 readonly default: true;
-                readonly description: "The YOLO AUTONOMY GRANT. It defaults to true so an ordinary run continues through bounded preparation and one eligible PAUSED derived-evergreen start instead of stopping for another approval. It is not a mode and selects nothing: WHICH campaign may start is derived from the workspace's own campaigns. Pass false only for an explicit conservative, review-first run.";
+                readonly description: "The YOLO AUTONOMY GRANT. It defaults to true so an ordinary run continues through bounded preparation and one route-selected start-eligible PAUSED campaign instead of stopping for another approval. It is not a mode and selects nothing: WHICH campaign may start is derived from the workspace's canonical waterfall. A finite non-evergreen candidate must already expose positive bounded supply. Pass false only for an explicit conservative, review-first run.";
             };
         };
     }>;
@@ -183,7 +183,7 @@ export declare const refillV3AdvanceToolDefinitions: {
                     };
                     readonly kind: {
                         readonly type: "string";
-                        readonly enum: readonly ["refresh_paid_credit_fact", "recheck_sender_connection", "fill_ready", "start_evergreen_campaign"];
+                        readonly enum: readonly ["refresh_paid_credit_fact", "recheck_sender_connection", "fill_ready", "start_paused_campaign", "start_evergreen_campaign"];
                     };
                     readonly actionKey: {
                         readonly type: "string";
@@ -191,7 +191,7 @@ export declare const refillV3AdvanceToolDefinitions: {
                     };
                     readonly authority: {
                         readonly type: "string";
-                        readonly enum: ("getOrRefreshPaidInmailCreditFact" | "recheckRefillV3SenderConnection" | "fillRefillV3Ready" | "startRefillV3EvergreenCampaign")[];
+                        readonly enum: ("getOrRefreshPaidInmailCreditFact" | "recheckRefillV3SenderConnection" | "fillRefillV3Ready" | "startRefillV3PausedCampaign" | "startRefillV3EvergreenCampaign")[];
                     };
                 };
             };

package/dist/tools/refill-v3-continue-contract.d.ts

@@ -78,7 +78,7 @@ export declare const REFILL_V3_CONTINUE_INPUT_SCHEMA: Readonly<{
         readonly yolo: {
             readonly type: "boolean";
             readonly default: true;
-            readonly description: "The YOLO AUTONOMY GRANT. It defaults to true so an ordinary run continues through bounded preparation and one eligible PAUSED derived-evergreen start instead of stopping for another approval. It is not a mode and selects nothing: WHICH campaign may start is derived from the workspace's own campaigns. Pass false only for an explicit conservative, review-first run.";
+            readonly description: "The YOLO AUTONOMY GRANT. It defaults to true so an ordinary run continues through bounded preparation and one route-selected start-eligible PAUSED campaign instead of stopping for another approval. It is not a mode and selects nothing: WHICH campaign may start is derived from the workspace's canonical waterfall. A finite non-evergreen candidate must already expose positive bounded supply. Pass false only for an explicit conservative, review-first run.";
         };
         readonly decision: {
             readonly type: "object";

package/dist/tools/refill-v3-continue.d.ts

@@ -92,7 +92,7 @@ export declare const refillV3ContinueToolDefinitions: {
             readonly yolo: {
                 readonly type: "boolean";
                 readonly default: true;
-                readonly description: "The YOLO AUTONOMY GRANT. It defaults to true so an ordinary run continues through bounded preparation and one eligible PAUSED derived-evergreen start instead of stopping for another approval. It is not a mode and selects nothing: WHICH campaign may start is derived from the workspace's own campaigns. Pass false only for an explicit conservative, review-first run.";
+                readonly description: "The YOLO AUTONOMY GRANT. It defaults to true so an ordinary run continues through bounded preparation and one route-selected start-eligible PAUSED campaign instead of stopping for another approval. It is not a mode and selects nothing: WHICH campaign may start is derived from the workspace's canonical waterfall. A finite non-evergreen candidate must already expose positive bounded supply. Pass false only for an explicit conservative, review-first run.";
             };
             readonly decision: {
                 readonly type: "object";

package/dist/tools/refill-v3-continue.js

@@ -1155,6 +1155,26 @@ function generatedMessageCountFrom(value) {
         ? count
         : null;
 }
+function campaignSettlementIsReady(value) {
+    return (value !== null &&
+        typeof value === "object" &&
+        !Array.isArray(value) &&
+        value.ready === true);
+}
+function continuationResultFromAdvance(advanceResult) {
+    if (advanceResult.kind === "advanced") {
+        return { kind: "world_advanced", advanceResult };
+    }
+    if (advanceResult.kind === "run_step_pending") {
+        return { kind: "world_step_pending", advanceResult };
+    }
+    if (advanceResult.kind === "awaiting_external_change" ||
+        advanceResult.kind === "complete" ||
+        advanceResult.kind === "blocked") {
+        return { kind: "world_terminal", advanceResult };
+    }
+    return { kind: "attention_refresh_required", advanceResult };
+}
 /**
  * The common refill funnel is mechanical. Keep it out of the model loop.
  *
@@ -1454,6 +1474,31 @@ async function executeRefillV3Continuation(input, dependencies) {
             };
         }
     }
+    // RF-HANDOFF-001: a targeted YOLO continuation owns the exact
+    // sender/date/lane/campaign until its settled work is handed back to the
+    // coordinator. Returning at this boundary exposed newly approved,
+    // unassigned rows to the campaign-wide scheduler before the next outer tool
+    // call could run `fill_ready`; another sender could claim the cohort in that
+    // gap. Consume the refreshed run credential here so the next fresh
+    // observation either assigns+schedules the exact lane immediately or
+    // returns its next truthful coordinator state. A guarded/timeout settlement
+    // is deliberately not advanced because its preparation still owns work.
+    if (input.yolo === true &&
+        input.campaignId !== undefined &&
+        (preparationOwnsSettlement || directlyQueuedRowsOwnSettlement) &&
+        campaignSettlementIsReady(settlement)) {
+        const postSettlementAdvance = await reconnectPostAdvanceStage({
+            sleep: dependencies.sleep,
+            operation: () => dependencies.advance({
+                workspaceId,
+                campaignId: input.campaignId,
+                scope: input.scope,
+                yolo: true,
+                runToken,
+            }),
+        });
+        return continuationResultFromAdvance(postSettlementAdvance);
+    }
     return {
         kind: "campaign_work_completed",
         runToken,

package/dist/tools/registry.d.ts

@@ -10558,7 +10558,7 @@ export declare const allTools: ({
             readonly yolo: {
                 readonly type: "boolean";
                 readonly default: true;
-                readonly description: "The YOLO AUTONOMY GRANT. It defaults to true so an ordinary run continues through bounded preparation and one eligible PAUSED derived-evergreen start instead of stopping for another approval. It is not a mode and selects nothing: WHICH campaign may start is derived from the workspace's own campaigns. Pass false only for an explicit conservative, review-first run.";
+                readonly description: "The YOLO AUTONOMY GRANT. It defaults to true so an ordinary run continues through bounded preparation and one route-selected start-eligible PAUSED campaign instead of stopping for another approval. It is not a mode and selects nothing: WHICH campaign may start is derived from the workspace's canonical waterfall. A finite non-evergreen candidate must already expose positive bounded supply. Pass false only for an explicit conservative, review-first run.";
             };
         };
     }>;
@@ -10630,7 +10630,7 @@ export declare const allTools: ({
                     };
                     readonly kind: {
                         readonly type: "string";
-                        readonly enum: readonly ["refresh_paid_credit_fact", "recheck_sender_connection", "fill_ready", "start_evergreen_campaign"];
+                        readonly enum: readonly ["refresh_paid_credit_fact", "recheck_sender_connection", "fill_ready", "start_paused_campaign", "start_evergreen_campaign"];
                     };
                     readonly actionKey: {
                         readonly type: "string";
@@ -10638,7 +10638,7 @@ export declare const allTools: ({
                     };
                     readonly authority: {
                         readonly type: "string";
-                        readonly enum: ("getOrRefreshPaidInmailCreditFact" | "recheckRefillV3SenderConnection" | "fillRefillV3Ready" | "startRefillV3EvergreenCampaign")[];
+                        readonly enum: ("getOrRefreshPaidInmailCreditFact" | "recheckRefillV3SenderConnection" | "fillRefillV3Ready" | "startRefillV3PausedCampaign" | "startRefillV3EvergreenCampaign")[];
                     };
                 };
             };
@@ -11992,7 +11992,7 @@ export declare const allTools: ({
             readonly yolo: {
                 readonly type: "boolean";
                 readonly default: true;
-                readonly description: "The YOLO AUTONOMY GRANT. It defaults to true so an ordinary run continues through bounded preparation and one eligible PAUSED derived-evergreen start instead of stopping for another approval. It is not a mode and selects nothing: WHICH campaign may start is derived from the workspace's own campaigns. Pass false only for an explicit conservative, review-first run.";
+                readonly description: "The YOLO AUTONOMY GRANT. It defaults to true so an ordinary run continues through bounded preparation and one route-selected start-eligible PAUSED campaign instead of stopping for another approval. It is not a mode and selects nothing: WHICH campaign may start is derived from the workspace's canonical waterfall. A finite non-evergreen candidate must already expose positive bounded supply. Pass false only for an explicit conservative, review-first run.";
             };
             readonly decision: {
                 readonly type: "object";

package/package.json

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

package/skills/refill-sends/SKILL.md

@@ -712,9 +712,11 @@ bounded preparation and fallback steps instead of stopping for another
 approval. It decides two things together:
 
 - **Granted** (`yolo: true` on every call of that run): after a row's active
-  campaigns are exhausted, one derived-evergreen start-eligible campaign may be
-  started, and you receive it as an ordinary executed `start_evergreen_campaign`
-  action. Keep calling advance until a terminal without checking back.
+  campaigns are exhausted, one route-selected start-eligible PAUSED campaign
+  may be started, and you receive it as an ordinary executed
+  `start_paused_campaign` action. A finite non-evergreen candidate must expose
+  positive bounded supply. Keep calling advance until a terminal without
+  checking back.
 - **Withheld** (explicit `yolo:false` only): no paused campaign is started — the backend
   refuses it and answers the exhaustion terminal instead — and you surface each
   result and ASK before calling advance again.

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

@@ -393,7 +393,7 @@ you may keep going unattended:
 
 |                                | `yolo: true` (default)                                                                                                             | explicit `yolo: false`                                                          |
 | ------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------- |
-| paused derived-evergreen start | one may be started once a row's active campaigns are exhausted, arriving as an ordinary executed `start_evergreen_campaign` action | none: the backend REFUSES the start and answers the exhaustion terminal instead |
+| route-selected start-eligible PAUSED campaign | one may be started once a row's active campaigns are exhausted, arriving as an ordinary executed `start_paused_campaign` action; finite non-evergreen candidates require positive bounded supply | none: the backend REFUSES the start and answers the exhaustion terminal instead |
 | loop                           | call `refill_v3_advance` again immediately, through to a terminal, without checking back                                           | surface the result and ASK before the next call                                 |
 
 Never replace the default from a workspace flag, a campaign field, a tool

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

@@ -108,7 +108,7 @@
       "note": "yolo is the refill AUTONOMY GRANT. It is not a mode and selects no campaign. WHICH campaign may start stays derived from the workspace's own campaigns; the input only says whether this run may start one at all."
     },
     "grants": {
-      "execution": "One already-eligible PAUSED derived-evergreen campaign may be started once a row's active campaigns are exhausted. It arrives as an ordinary executed start_evergreen_campaign action.",
+      "execution": "One route-selected start-eligible PAUSED campaign may be started once a row's active campaigns are exhausted. A finite non-evergreen candidate must already expose positive bounded supply; an evergreen may start empty for refresh. It arrives as an ordinary executed start_paused_campaign action.",
       "loop": "Keep calling advance through re-observation until a terminal, without checking back with the operator between calls."
     },
     "withheld": {