@sellable/mcp 0.1.854 → 0.1.856

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

@@ -265,11 +265,20 @@ export type RefillV3AdvanceRowReadback = {
 };
 export declare const REFILL_V3_TERMINAL_ROW_CLASSIFICATIONS: readonly ["capacity_met", "campaigns_exhausted", "no_eligible_campaigns", "externally_gated", "deferred", "blocked", "scope_unresolved", "defect"];
 export type RefillV3TerminalRowClassification = (typeof REFILL_V3_TERMINAL_ROW_CLASSIFICATIONS)[number];
+export declare const REFILL_V3_PAID_CREDIT_REFRESH_ATTEMPT_OUTCOMES: readonly ["skipped_fresh", "succeeded", "failed", "not_attempted"];
+export type RefillV3PaidCreditRefreshAttemptEvidence = {
+    attemptedAt: string | null;
+    outcome: (typeof REFILL_V3_PAID_CREDIT_REFRESH_ATTEMPT_OUTCOMES)[number];
+    errorClass: string | null;
+    errorDetail: string | null;
+    durationMs: number | null;
+};
 export type RefillV3TerminalRowEvidence = RefillV3AdvanceRowReadback & {
     terminalClassification: RefillV3TerminalRowClassification;
     approvedDelta: number;
     scheduledDelta: number;
     paidCreditEvidence?: RefillWorldStatePaidCreditEvidence;
+    paidCreditRefreshAttempt?: RefillV3PaidCreditRefreshAttemptEvidence;
 };
 export type RefillV3AdvanceTerminalEvidence = {
     rows: RefillV3TerminalRowEvidence[];
@@ -686,6 +695,30 @@ export declare const REFILL_V3_ADVANCE_OUTPUT_SCHEMA: Readonly<{
                                     };
                                 };
                             };
+                            readonly paidCreditRefreshAttempt: {
+                                readonly type: "object";
+                                readonly additionalProperties: false;
+                                readonly required: readonly ["attemptedAt", "outcome", "errorClass", "errorDetail", "durationMs"];
+                                readonly properties: {
+                                    readonly attemptedAt: {
+                                        readonly type: readonly ["string", "null"];
+                                    };
+                                    readonly outcome: {
+                                        readonly type: "string";
+                                        readonly enum: readonly ["skipped_fresh", "succeeded", "failed", "not_attempted"];
+                                    };
+                                    readonly errorClass: {
+                                        readonly type: readonly ["string", "null"];
+                                    };
+                                    readonly errorDetail: {
+                                        readonly type: readonly ["string", "null"];
+                                    };
+                                    readonly durationMs: {
+                                        readonly type: readonly ["integer", "null"];
+                                        readonly minimum: 0;
+                                    };
+                                };
+                            };
                             readonly senderId: {
                                 readonly type: "string";
                                 readonly minLength: 1;
@@ -792,6 +825,30 @@ export declare const REFILL_V3_ADVANCE_OUTPUT_SCHEMA: Readonly<{
                                     };
                                 };
                             };
+                            readonly paidCreditRefreshAttempt: {
+                                readonly type: "object";
+                                readonly additionalProperties: false;
+                                readonly required: readonly ["attemptedAt", "outcome", "errorClass", "errorDetail", "durationMs"];
+                                readonly properties: {
+                                    readonly attemptedAt: {
+                                        readonly type: readonly ["string", "null"];
+                                    };
+                                    readonly outcome: {
+                                        readonly type: "string";
+                                        readonly enum: readonly ["skipped_fresh", "succeeded", "failed", "not_attempted"];
+                                    };
+                                    readonly errorClass: {
+                                        readonly type: readonly ["string", "null"];
+                                    };
+                                    readonly errorDetail: {
+                                        readonly type: readonly ["string", "null"];
+                                    };
+                                    readonly durationMs: {
+                                        readonly type: readonly ["integer", "null"];
+                                        readonly minimum: 0;
+                                    };
+                                };
+                            };
                             readonly senderId: {
                                 readonly type: "string";
                                 readonly minLength: 1;
@@ -898,6 +955,30 @@ export declare const REFILL_V3_ADVANCE_OUTPUT_SCHEMA: Readonly<{
                                     };
                                 };
                             };
+                            readonly paidCreditRefreshAttempt: {
+                                readonly type: "object";
+                                readonly additionalProperties: false;
+                                readonly required: readonly ["attemptedAt", "outcome", "errorClass", "errorDetail", "durationMs"];
+                                readonly properties: {
+                                    readonly attemptedAt: {
+                                        readonly type: readonly ["string", "null"];
+                                    };
+                                    readonly outcome: {
+                                        readonly type: "string";
+                                        readonly enum: readonly ["skipped_fresh", "succeeded", "failed", "not_attempted"];
+                                    };
+                                    readonly errorClass: {
+                                        readonly type: readonly ["string", "null"];
+                                    };
+                                    readonly errorDetail: {
+                                        readonly type: readonly ["string", "null"];
+                                    };
+                                    readonly durationMs: {
+                                        readonly type: readonly ["integer", "null"];
+                                        readonly minimum: 0;
+                                    };
+                                };
+                            };
                             readonly senderId: {
                                 readonly type: "string";
                                 readonly minLength: 1;

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

@@ -340,6 +340,12 @@ export const REFILL_V3_TERMINAL_ROW_CLASSIFICATIONS = [
     "scope_unresolved",
     "defect",
 ];
+export const REFILL_V3_PAID_CREDIT_REFRESH_ATTEMPT_OUTCOMES = [
+    "skipped_fresh",
+    "succeeded",
+    "failed",
+    "not_attempted",
+];
 /**
  * Required keys per variant. The decoder rejects any other key set.
  *
@@ -488,6 +494,27 @@ const TERMINAL_ROW_EVIDENCE_SCHEMA = {
         approvedDelta: { type: "integer", minimum: 0 },
         scheduledDelta: { type: "integer", minimum: 0 },
         paidCreditEvidence: REFILL_V3_WORLD_STATE_PAID_CREDIT_EVIDENCE_SCHEMA,
+        paidCreditRefreshAttempt: {
+            type: "object",
+            additionalProperties: false,
+            required: [
+                "attemptedAt",
+                "outcome",
+                "errorClass",
+                "errorDetail",
+                "durationMs",
+            ],
+            properties: {
+                attemptedAt: { type: ["string", "null"] },
+                outcome: {
+                    type: "string",
+                    enum: [...REFILL_V3_PAID_CREDIT_REFRESH_ATTEMPT_OUTCOMES],
+                },
+                errorClass: { type: ["string", "null"] },
+                errorDetail: { type: ["string", "null"] },
+                durationMs: { type: ["integer", "null"], minimum: 0 },
+            },
+        },
     },
 };
 const TERMINAL_EVIDENCE_SCHEMA = {
@@ -776,7 +803,11 @@ function decodeTerminalRowEvidence(value) {
         "approvedDelta",
         "scheduledDelta",
     ];
-    const keys = [...requiredKeys, "paidCreditEvidence"];
+    const keys = [
+        ...requiredKeys,
+        "paidCreditEvidence",
+        "paidCreditRefreshAttempt",
+    ];
     if (!onlyKeys(value, keys) || requiredKeys.some((key) => !(key in value))) {
         return null;
     }
@@ -793,12 +824,39 @@ function decodeTerminalRowEvidence(value) {
     if (value.paidCreditEvidence !== undefined && !paidCreditEvidence) {
         return null;
     }
+    let paidCreditRefreshAttempt;
+    if (value.paidCreditRefreshAttempt !== undefined) {
+        const attempt = value.paidCreditRefreshAttempt;
+        if (!isRecord(attempt) ||
+            !onlyKeys(attempt, [
+                "attemptedAt",
+                "outcome",
+                "errorClass",
+                "errorDetail",
+                "durationMs",
+            ]) ||
+            !(attempt.attemptedAt === null || typeof attempt.attemptedAt === "string") ||
+            !isOneOfAdvance(attempt.outcome, REFILL_V3_PAID_CREDIT_REFRESH_ATTEMPT_OUTCOMES) ||
+            !(attempt.errorClass === null || typeof attempt.errorClass === "string") ||
+            !(attempt.errorDetail === null || typeof attempt.errorDetail === "string") ||
+            !(attempt.durationMs === null || count(attempt.durationMs))) {
+            return null;
+        }
+        paidCreditRefreshAttempt = {
+            attemptedAt: attempt.attemptedAt,
+            outcome: attempt.outcome,
+            errorClass: attempt.errorClass,
+            errorDetail: attempt.errorDetail,
+            durationMs: attempt.durationMs,
+        };
+    }
     return {
         ...readback,
         terminalClassification: value.terminalClassification,
         approvedDelta: value.approvedDelta,
         scheduledDelta: value.scheduledDelta,
         ...(paidCreditEvidence ? { paidCreditEvidence } : {}),
+        ...(paidCreditRefreshAttempt ? { paidCreditRefreshAttempt } : {}),
     };
 }
 function decodeTerminalEvidence(value) {

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

@@ -415,6 +415,30 @@ export declare const refillV3AdvanceToolDefinitions: {
                                         };
                                     };
                                 };
+                                readonly paidCreditRefreshAttempt: {
+                                    readonly type: "object";
+                                    readonly additionalProperties: false;
+                                    readonly required: readonly ["attemptedAt", "outcome", "errorClass", "errorDetail", "durationMs"];
+                                    readonly properties: {
+                                        readonly attemptedAt: {
+                                            readonly type: readonly ["string", "null"];
+                                        };
+                                        readonly outcome: {
+                                            readonly type: "string";
+                                            readonly enum: readonly ["skipped_fresh", "succeeded", "failed", "not_attempted"];
+                                        };
+                                        readonly errorClass: {
+                                            readonly type: readonly ["string", "null"];
+                                        };
+                                        readonly errorDetail: {
+                                            readonly type: readonly ["string", "null"];
+                                        };
+                                        readonly durationMs: {
+                                            readonly type: readonly ["integer", "null"];
+                                            readonly minimum: 0;
+                                        };
+                                    };
+                                };
                                 readonly senderId: {
                                     readonly type: "string";
                                     readonly minLength: 1;
@@ -521,6 +545,30 @@ export declare const refillV3AdvanceToolDefinitions: {
                                         };
                                     };
                                 };
+                                readonly paidCreditRefreshAttempt: {
+                                    readonly type: "object";
+                                    readonly additionalProperties: false;
+                                    readonly required: readonly ["attemptedAt", "outcome", "errorClass", "errorDetail", "durationMs"];
+                                    readonly properties: {
+                                        readonly attemptedAt: {
+                                            readonly type: readonly ["string", "null"];
+                                        };
+                                        readonly outcome: {
+                                            readonly type: "string";
+                                            readonly enum: readonly ["skipped_fresh", "succeeded", "failed", "not_attempted"];
+                                        };
+                                        readonly errorClass: {
+                                            readonly type: readonly ["string", "null"];
+                                        };
+                                        readonly errorDetail: {
+                                            readonly type: readonly ["string", "null"];
+                                        };
+                                        readonly durationMs: {
+                                            readonly type: readonly ["integer", "null"];
+                                            readonly minimum: 0;
+                                        };
+                                    };
+                                };
                                 readonly senderId: {
                                     readonly type: "string";
                                     readonly minLength: 1;
@@ -627,6 +675,30 @@ export declare const refillV3AdvanceToolDefinitions: {
                                         };
                                     };
                                 };
+                                readonly paidCreditRefreshAttempt: {
+                                    readonly type: "object";
+                                    readonly additionalProperties: false;
+                                    readonly required: readonly ["attemptedAt", "outcome", "errorClass", "errorDetail", "durationMs"];
+                                    readonly properties: {
+                                        readonly attemptedAt: {
+                                            readonly type: readonly ["string", "null"];
+                                        };
+                                        readonly outcome: {
+                                            readonly type: "string";
+                                            readonly enum: readonly ["skipped_fresh", "succeeded", "failed", "not_attempted"];
+                                        };
+                                        readonly errorClass: {
+                                            readonly type: readonly ["string", "null"];
+                                        };
+                                        readonly errorDetail: {
+                                            readonly type: readonly ["string", "null"];
+                                        };
+                                        readonly durationMs: {
+                                            readonly type: readonly ["integer", "null"];
+                                            readonly minimum: 0;
+                                        };
+                                    };
+                                };
                                 readonly senderId: {
                                     readonly type: "string";
                                     readonly minLength: 1;

package/dist/tools/registry.d.ts

@@ -10541,6 +10541,30 @@ export declare const allTools: ({
                                         };
                                     };
                                 };
+                                readonly paidCreditRefreshAttempt: {
+                                    readonly type: "object";
+                                    readonly additionalProperties: false;
+                                    readonly required: readonly ["attemptedAt", "outcome", "errorClass", "errorDetail", "durationMs"];
+                                    readonly properties: {
+                                        readonly attemptedAt: {
+                                            readonly type: readonly ["string", "null"];
+                                        };
+                                        readonly outcome: {
+                                            readonly type: "string";
+                                            readonly enum: readonly ["skipped_fresh", "succeeded", "failed", "not_attempted"];
+                                        };
+                                        readonly errorClass: {
+                                            readonly type: readonly ["string", "null"];
+                                        };
+                                        readonly errorDetail: {
+                                            readonly type: readonly ["string", "null"];
+                                        };
+                                        readonly durationMs: {
+                                            readonly type: readonly ["integer", "null"];
+                                            readonly minimum: 0;
+                                        };
+                                    };
+                                };
                                 readonly senderId: {
                                     readonly type: "string";
                                     readonly minLength: 1;
@@ -10647,6 +10671,30 @@ export declare const allTools: ({
                                         };
                                     };
                                 };
+                                readonly paidCreditRefreshAttempt: {
+                                    readonly type: "object";
+                                    readonly additionalProperties: false;
+                                    readonly required: readonly ["attemptedAt", "outcome", "errorClass", "errorDetail", "durationMs"];
+                                    readonly properties: {
+                                        readonly attemptedAt: {
+                                            readonly type: readonly ["string", "null"];
+                                        };
+                                        readonly outcome: {
+                                            readonly type: "string";
+                                            readonly enum: readonly ["skipped_fresh", "succeeded", "failed", "not_attempted"];
+                                        };
+                                        readonly errorClass: {
+                                            readonly type: readonly ["string", "null"];
+                                        };
+                                        readonly errorDetail: {
+                                            readonly type: readonly ["string", "null"];
+                                        };
+                                        readonly durationMs: {
+                                            readonly type: readonly ["integer", "null"];
+                                            readonly minimum: 0;
+                                        };
+                                    };
+                                };
                                 readonly senderId: {
                                     readonly type: "string";
                                     readonly minLength: 1;
@@ -10753,6 +10801,30 @@ export declare const allTools: ({
                                         };
                                     };
                                 };
+                                readonly paidCreditRefreshAttempt: {
+                                    readonly type: "object";
+                                    readonly additionalProperties: false;
+                                    readonly required: readonly ["attemptedAt", "outcome", "errorClass", "errorDetail", "durationMs"];
+                                    readonly properties: {
+                                        readonly attemptedAt: {
+                                            readonly type: readonly ["string", "null"];
+                                        };
+                                        readonly outcome: {
+                                            readonly type: "string";
+                                            readonly enum: readonly ["skipped_fresh", "succeeded", "failed", "not_attempted"];
+                                        };
+                                        readonly errorClass: {
+                                            readonly type: readonly ["string", "null"];
+                                        };
+                                        readonly errorDetail: {
+                                            readonly type: readonly ["string", "null"];
+                                        };
+                                        readonly durationMs: {
+                                            readonly type: readonly ["integer", "null"];
+                                            readonly minimum: 0;
+                                        };
+                                    };
+                                };
                                 readonly senderId: {
                                     readonly type: "string";
                                     readonly minLength: 1;

package/package.json

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

package/skills/refill-sends/SKILL.md

@@ -623,8 +623,16 @@ those terminal results, report **every** entry in `terminalEvidence.rows`, one
 per scoped sender/date/lane—not only the headline deferral or blocker. Include
 `targetSlots`, `takenSlots`, `remainingTargetGap`, `fillableSlotsNow`,
 `blockedGap`, `terminalClassification`, `reasonCodes`, `approvedDelta`, and
-`scheduledDelta`. A cumulative observation or one surfaced blocker is never a
-row-complete terminal summary.
+`scheduledDelta`. When `reasonCodes` contains
+`paid_inmail_credit_refresh_failed`, also report `paidCreditRefreshAttempt`
+exactly: `attemptedAt`, `outcome`, `errorClass`, `errorDetail`, and `durationMs`.
+A cumulative observation, vague "credit refresh" label, or one surfaced blocker
+is never a row-complete terminal summary.
+
+Lead every row-complete terminal summary by stating that all scoped
+sender/date/lane rows were explored. Never say the workspace "stopped on" one
+sender or headline blocker: that blocker classifies one row after independent
+sibling work was explored; it is not the traversal stop.
 
 Resolve the workspace BEFORE the first call, exactly as the V1 route already
 requires. `workspaceId` must be an exact id on every automation call: when the

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

@@ -473,8 +473,16 @@ result, report **every** entry in `terminalEvidence.rows`, one per scoped
 sender/date/lane—not only the headline deferral or blocker. Include
 `targetSlots`, `takenSlots`, `remainingTargetGap`, `fillableSlotsNow`,
 `blockedGap`, `terminalClassification`, `reasonCodes`, `approvedDelta`, and
-`scheduledDelta`. A cumulative observation or one surfaced blocker is never a
-row-complete terminal summary.
+`scheduledDelta`. When `reasonCodes` contains
+`paid_inmail_credit_refresh_failed`, also report `paidCreditRefreshAttempt`
+exactly: `attemptedAt`, `outcome`, `errorClass`, `errorDetail`, and `durationMs`.
+A cumulative observation, vague "credit refresh" label, or one surfaced blocker
+is never a row-complete terminal summary.
+
+Lead every row-complete terminal summary by stating that all scoped
+sender/date/lane rows were explored. Never say the workspace "stopped on" one
+sender or headline blocker: that blocker classifies one row after independent
+sibling work was explored; it is not the traversal stop.
 
 This workflow chooses nothing. It never reads capacity, supply, family, or reason
 fields to decide what to do next; never declares a terminal, an exhaustion

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

@@ -152,12 +152,7 @@
         "subskill": "refill-sends-work-campaign",
         "pass": ["packet.scope", "packet.evidence"],
         "returnThrough": "refill_v3_continue",
-        "returnInput": [
-          "workspaceId",
-          "scope",
-          "decision",
-          "yolo"
-        ]
+        "returnInput": ["workspaceId", "scope", "decision", "yolo"]
       },
       "settlement": {
         "ownedBy": "refill_v3_continue",
@@ -225,7 +220,8 @@
         "terminalEvidence.rows[].terminalClassification",
         "terminalEvidence.rows[].reasonCodes",
         "terminalEvidence.rows[].approvedDelta",
-        "terminalEvidence.rows[].scheduledDelta"
+        "terminalEvidence.rows[].scheduledDelta",
+        "terminalEvidence.rows[].paidCreditRefreshAttempt"
       ],
       "campaignWorkInFlight": {
         "appliesToDeferralCode": "campaign_work_in_flight",
@@ -240,7 +236,7 @@
         "then": "call the advance tool again with the identical workspaceId, scope, and yolo grant",
         "note": "This is a bounded read-only wait inherited from Create Campaign. It holds the same campaign while its cells settle; it never authorizes selecting a sibling. A partial timeout returns to fresh advance, and the same deferral may authorize another bounded wait. NOTE on run identity: awaiting_external_change is a terminal, so the server already CLOSED the run and returned no runToken. The advance after this wait therefore omits runToken and opens a new run, which starts with zero progress-free campaign visits and zero retryable paid attempts."
       },
-      "then": "for any other deferral code, stop and report the scoped wait plus every scoped sender/date/lane row from terminalEvidence.rows; never summarize only the headline deferral"
+      "then": "for any other deferral code, stop and report the scoped wait plus every scoped sender/date/lane row from terminalEvidence.rows; state that all scoped sender/date/lane rows were explored; never say the workspace \"stopped on\" the headline deferral"
     },
     "complete": {
       "alreadyExecuted": false,
@@ -258,9 +254,10 @@
         "terminalEvidence.rows[].terminalClassification",
         "terminalEvidence.rows[].reasonCodes",
         "terminalEvidence.rows[].approvedDelta",
-        "terminalEvidence.rows[].scheduledDelta"
+        "terminalEvidence.rows[].scheduledDelta",
+        "terminalEvidence.rows[].paidCreditRefreshAttempt"
       ],
-      "then": "stop and report the terminal code plus every scoped sender/date/lane row from terminalEvidence.rows"
+      "then": "stop and report the terminal code plus every scoped sender/date/lane row from terminalEvidence.rows; state that all scoped sender/date/lane rows were explored; never say the workspace \"stopped on\" the headline terminal"
     },
     "blocked": {
       "alreadyExecuted": false,
@@ -281,9 +278,10 @@
         "terminalEvidence.rows[].terminalClassification",
         "terminalEvidence.rows[].reasonCodes",
         "terminalEvidence.rows[].approvedDelta",
-        "terminalEvidence.rows[].scheduledDelta"
+        "terminalEvidence.rows[].scheduledDelta",
+        "terminalEvidence.rows[].paidCreditRefreshAttempt"
       ],
-      "then": "stop and report the typed business blocker plus every scoped sender/date/lane row from terminalEvidence.rows"
+      "then": "stop and report the typed business blocker plus every scoped sender/date/lane row from terminalEvidence.rows; state that all scoped sender/date/lane rows were explored; never say the workspace \"stopped on\" the headline blocker"
     }
   },
   "forbidden": [