@sellable/mcp 0.1.736 → 0.1.737

package/dist/refill-run-loop.d.ts

@@ -166,6 +166,11 @@ declare function dominantSchedulerRefusalReason(receipt: Record<string, unknown>
     reason: string;
     count: number;
 } | null;
+type SchedulerRefusalDisposition = {
+    retryable: boolean | null;
+    blockerClass: "transient_or_refreshable" | "time_bound_capacity" | "operator_action_required" | "unknown";
+};
+declare function classifySchedulerRefusal(reason: string | null): SchedulerRefusalDisposition;
 declare function schedulerSweepNoOpBlocker(ctx: LoopContext, reportInput: Record<string, unknown>): Record<string, unknown> | null;
 export declare function packetCoherenceFailure(plan: Record<string, unknown>): string | null;
 export declare function terminalProjection(value: {
@@ -184,5 +189,6 @@ export declare function runRefillV2Loop(input: RefillV2LoopInput, deps: RefillV2
 export declare const refillRunLoopInternals: {
     schedulerSweepNoOpBlocker: typeof schedulerSweepNoOpBlocker;
     dominantSchedulerRefusalReason: typeof dominantSchedulerRefusalReason;
+    classifySchedulerRefusal: typeof classifySchedulerRefusal;
 };
 export {};

package/dist/refill-run-loop.js

@@ -432,6 +432,24 @@ function dominantSchedulerRefusalReason(receipt) {
     }
     return null;
 }
+function classifySchedulerRefusal(reason) {
+    if (!reason)
+        return { retryable: null, blockerClass: "unknown" };
+    // Infrastructure or freshness failures: the underlying facts can be re-read
+    // and the same sweep can then succeed without anyone changing configuration.
+    if (/(pool|timeout|timed[_ -]?out|connection|transient|unavailable|receipt[_ -]?invalid|stale|refresh)/i.test(reason)) {
+        return { retryable: true, blockerClass: "transient_or_refreshable" };
+    }
+    // Time-bound capacity: nothing is broken, the slot simply is not open yet.
+    if (/(window|capacity|daily[_ -]?limit|cooldown|rate[_ -]?limit)/i.test(reason)) {
+        return { retryable: true, blockerClass: "time_bound_capacity" };
+    }
+    // Standing gates: re-running cannot clear these; a human must act.
+    if (/(billing|credit[_ -]?threshold|disconnected|sender[_ -]?mismatch|not[_ -]?scheduler[_ -]?eligible|suspended|unauthor)/i.test(reason)) {
+        return { retryable: false, blockerClass: "operator_action_required" };
+    }
+    return { retryable: null, blockerClass: "unknown" };
+}
 // fix(112al): a sweep whose own receipt proves it placed zero while ready
 // inventory existed. Gated on the executed action actually being a scheduler
 // sweep and on a FRESH terminal receipt (ran / window_closed_noop), so an
@@ -461,8 +479,9 @@ function schedulerSweepNoOpBlocker(ctx, reportInput) {
                 dominantReason: dominant.reason,
                 dominantReasonSource: dominant.source,
                 dominantReasonCount: dominant.count,
+                ...classifySchedulerRefusal(dominant.reason),
             }
-            : {}),
+            : classifySchedulerRefusal(null)),
         ...(stringValue(receipt?.nextAction)
             ? { recommendedAction: stringValue(receipt?.nextAction) }
             : {}),
@@ -4806,4 +4825,5 @@ export async function runRefillV2Loop(input, deps) {
 export const refillRunLoopInternals = {
     schedulerSweepNoOpBlocker,
     dominantSchedulerRefusalReason,
+    classifySchedulerRefusal,
 };

package/package.json

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