@sellable/mcp 0.1.945 → 0.1.946

package/dist/tools/campaign-message-preparation.d.ts

@@ -63,7 +63,10 @@ type StartPrepareMessagesInput = PrepareMessagesBaseInput & PrepareMessagesReadi
     senderId?: string;
     actionType?: string;
 };
-type StatusPrepareMessagesInput = PrepareMessagesBaseInput;
+type StatusPrepareMessagesInput = PrepareMessagesBaseInput & {
+    /** With no jobId: the latest job started by this source, not the latest job. */
+    requestSource?: string;
+};
 type CancelPrepareMessagesInput = PrepareMessagesBaseInput;
 export declare const campaignMessagePreparationToolDefinitions: ({
     name: string;

package/dist/tools/campaign-message-preparation.js

@@ -269,6 +269,7 @@ export async function startPrepareCampaignMessages(input) {
         effectId: input.effectId,
         ...(reportingContext ? { reportingContext } : {}),
         ...(input.history ? { history: input.history } : {}),
+        ...(input.requestSource ? { requestSource: input.requestSource } : {}),
         ...(workspaceId ? { workspaceId } : {}),
     }, workspaceId ?? undefined);
     return sanitizePreparationResponse(result);

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

@@ -226,6 +226,10 @@ export declare const REFILL_V3_CONTINUE_OUTPUT_SCHEMA: Readonly<{
             readonly type: "integer";
             readonly minimum: 1;
         };
+        readonly runningForSeconds: {
+            readonly type: "integer";
+            readonly minimum: 0;
+        };
         readonly advanceResult: {
             readonly type: "object";
         };

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

@@ -122,6 +122,7 @@ export const REFILL_V3_CONTINUE_OUTPUT_SCHEMA = Object.freeze({
     properties: {
         kind: { type: "string", enum: [...REFILL_V3_CONTINUE_RESULT_KINDS] },
         retryAfterMs: { type: "integer", minimum: 1 },
+        runningForSeconds: { type: "integer", minimum: 0 },
         advanceResult: { type: "object" },
         packet: { type: "object" },
         correction: { type: "object" },

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

@@ -221,6 +221,10 @@ export declare const refillV3ContinueToolDefinitions: {
                 readonly type: "integer";
                 readonly minimum: 1;
             };
+            readonly runningForSeconds: {
+                readonly type: "integer";
+                readonly minimum: 0;
+            };
             readonly advanceResult: {
                 readonly type: "object";
             };
@@ -389,6 +393,7 @@ export type RefillV3ContinueInput = {
 export type RefillV3ContinueResult = {
     kind: "continuation_pending";
     retryAfterMs: number;
+    runningForSeconds?: number;
 } | {
     kind: "world_advanced";
     advanceResult: Extract<RefillV3AdvanceResult, {

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

@@ -458,10 +458,15 @@ export async function runRefillV3CampaignWorkWithProductionOwners(input, owners
                 const exactDiagnosticRowIds = request.rowIds ?? [];
                 let lastStatus = null;
                 try {
+                    // Read the ladder's OWN last cohort. Other owners (refill_sends exact
+                    // fills) start one- and two-row jobs on the same table; taking the
+                    // latest job of any source made every cohort look thin and pinned
+                    // the ladder to ten-row probes for the whole run.
                     lastStatus = await owners.getPrepareCampaignMessagesStatus({
                         workspaceId: request.scope.workspaceId,
                         campaignId: request.scope.campaignId,
                         tableId: request.scope.tableId,
+                        requestSource: "refill_v3_continue",
                     });
                 }
                 catch {

package/dist/tools/refill-v3-run-token-transport.js

@@ -130,7 +130,11 @@ export function startRefillV3Continuation(input, execute) {
     if (continuationFlights.size >= MAX_RETAINED_REFILL_RUNS) {
         throw new Error("Collect pending refill continuations before starting another scope.");
     }
-    const entry = { scope: input, promise: Promise.resolve().then(execute) };
+    const entry = {
+        scope: input,
+        promise: Promise.resolve().then(execute),
+        startedAt: Date.now(),
+    };
     continuationFlights.set(runKey(input), entry);
     return collectContinuation(entry);
 }
@@ -144,8 +148,15 @@ async function collectContinuation(entry) {
                 timer = setTimeout(() => resolve(pending), 20_000);
             }),
         ]);
+        // Each pending answer says how long the operation has run. Byte-identical
+        // answers to identical polls trip host loop guards (Hermes halts a tool
+        // after five), which stopped an unattended refill before its work settled.
         if (result === pending)
-            return { kind: "continuation_pending", retryAfterMs: 1000 };
+            return {
+                kind: "continuation_pending",
+                retryAfterMs: 1000,
+                runningForSeconds: Math.max(0, Math.round((Date.now() - entry.startedAt) / 1000)),
+            };
         if (continuationFlights.get(runKey(entry.scope)) === entry)
             continuationFlights.delete(runKey(entry.scope));
         return result;

package/dist/tools/registry.d.ts

@@ -11448,6 +11448,10 @@ export declare const allTools: ({
                 readonly type: "integer";
                 readonly minimum: 1;
             };
+            readonly runningForSeconds: {
+                readonly type: "integer";
+                readonly minimum: 0;
+            };
             readonly advanceResult: {
                 readonly type: "object";
             };

package/package.json

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

package/skills/refill-sends/SKILL.md

@@ -67,6 +67,21 @@ Scheduled results use five product meanings:
   customer action. Make the result available to the daily review; do not post a
   second routine message.
 
+Customer fixes. A blocked row's `reason.codes` names what only the customer can
+fix. Say it once per sender in plain words, with the next step, and keep filling
+every other sender and lane:
+
+- `sender_disconnected`: that sender's LinkedIn account is disconnected. Next
+  step: reconnect it in Sellable (LinkedIn accounts), or remove the sender if it
+  is no longer used.
+- `sales_nav_disconnected` or `paid_inmail_connection_health_recheck_required`:
+  Sellable cannot read that sender's Sales Navigator InMail credits. Next step:
+  reconnect Sales Navigator for that sender (or renew it if it lapsed).
+  Connection requests continue meanwhile.
+
+Retryable provider codes (`paid_inmail_credit_refresh_failed`, timeouts) are not
+customer tasks; never ask the customer to retry them.
+
 Interactive `refill-sends --yolo` always receives its actual result immediately.
 State connection invitations and paid InMail separately: invitation capacity is
 not paid InMail credit, and paid InMail coverage is never proof of invitation