@sellable/mcp 0.1.938 → 0.1.939-wip.refill-autonomy.20260920182009

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

@@ -896,3 +896,5 @@ export type RefillV3AdvanceToolInput = {
  * as a thrown transport error and can never become a plausible receipt.
  */
 export declare function advanceRefillV3Tool(input: RefillV3AdvanceToolInput): Promise<RefillV3AdvanceResult>;
+/** Internal continuation owns the transport flight; public advance cannot overtake it. */
+export declare function advanceRefillV3FromContinuation(input: RefillV3AdvanceToolInput): Promise<RefillV3AdvanceResult>;

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

@@ -27,7 +27,7 @@
  */
 import { getApi } from "../api.js";
 import { REFILL_V3_ADVANCE_INPUT_SCHEMA, REFILL_V3_ADVANCE_OUTPUT_SCHEMA, decodeRefillV3AdvanceResult, } from "./refill-v3-advance-contract.js";
-import { recordRefillV3RunTransition, resolveRefillV3RunToken, } from "./refill-v3-run-token-transport.js";
+import { assertNoRefillV3Continuation, recordRefillV3RunTransition, resolveRefillV3RunToken, } from "./refill-v3-run-token-transport.js";
 import { normalizeExplicitWorkspaceId, workspaceRequestOptions, } from "./workspace-context.js";
 /** The one authenticated backend boundary this projection may reach. */
 export const REFILL_V3_ADVANCE_ROUTE = "/api/v3/mcp/refill-v3/advance";
@@ -59,6 +59,15 @@ export const refillV3AdvanceToolDefinitions = [
  * as a thrown transport error and can never become a plausible receipt.
  */
 export async function advanceRefillV3Tool(input) {
+    assertNoRefillV3Continuation({
+        ...input,
+        workspaceId: normalizeExplicitWorkspaceId(input.workspaceId) ?? "",
+        scope: input.scope,
+    });
+    return advanceRefillV3FromContinuation(input);
+}
+/** Internal continuation owns the transport flight; public advance cannot overtake it. */
+export async function advanceRefillV3FromContinuation(input) {
     const workspaceId = normalizeExplicitWorkspaceId(input.workspaceId);
     if (!workspaceId) {
         throw new Error("Explicit workspaceId is required for refill_v3_advance. Name the target workspace instead of switching the shared active workspace.");
@@ -67,9 +76,7 @@ export async function advanceRefillV3Tool(input) {
     const transportScope = {
         workspaceId,
         scope: input.scope,
-        ...(input.campaignId === undefined
-            ? {}
-            : { campaignId: input.campaignId }),
+        ...(input.campaignId === undefined ? {} : { campaignId: input.campaignId }),
         yolo,
     };
     const runToken = resolveRefillV3RunToken(transportScope, input.runToken);

package/dist/tools/refill-v3-campaign-work.d.ts

@@ -230,6 +230,8 @@ export type RefillV3AuthorityReceipt = {
     beforeFingerprint: string | null;
     afterFingerprint: string | null;
     changedFields: readonly string[];
+    /** Net-new rows confirmed by the source-copy owner, excluding skipped duplicates. */
+    sourceRowsCopied?: number;
     effectKey: string | null;
     rollback: {
         available: boolean;

package/dist/tools/refill-v3-campaign-work.js

@@ -694,7 +694,8 @@ export async function runRefillV3CampaignWork(input) {
         echo.evidenceFingerprint !== packet.scope.evidenceFingerprint) {
         return refuse(callLog, "stale_evidence", `The output was formed against version ${echo.campaignVersion}/${echo.evidenceFingerprint}, not ${packet.scope.campaignVersion}/${packet.scope.evidenceFingerprint}.`);
     }
-    if (packet.evidence.diagnosticRowRef?.selectorRef === "copyIntegrityBlockedMessages:actionable:v1") {
+    if (packet.evidence.diagnosticRowRef?.selectorRef ===
+        "copyIntegrityBlockedMessages:actionable:v1") {
         return refuse(callLog, "stale_evidence", "refresh the current plan; this diagnostic selector is retired");
     }
     // 5. One evidence packet can authorize at most one mutation per task.

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

@@ -1,4 +1,4 @@
-export declare const REFILL_V3_CONTINUE_RESULT_KINDS: readonly ["world_advanced", "world_step_pending", "world_terminal", "attention_refresh_required", "model_decision_required", "attention_correction_required", "campaign_work_completed"];
+export declare const REFILL_V3_CONTINUE_RESULT_KINDS: readonly ["continuation_pending", "world_advanced", "world_step_pending", "world_terminal", "attention_refresh_required", "model_decision_required", "attention_correction_required", "campaign_work_completed"];
 export declare const REFILL_V3_CONTINUE_INPUT_SCHEMA: Readonly<{
     readonly type: "object";
     readonly additionalProperties: false;
@@ -220,7 +220,11 @@ export declare const REFILL_V3_CONTINUE_OUTPUT_SCHEMA: Readonly<{
     readonly properties: {
         readonly kind: {
             readonly type: "string";
-            readonly enum: readonly ["world_advanced", "world_step_pending", "world_terminal", "attention_refresh_required", "model_decision_required", "attention_correction_required", "campaign_work_completed"];
+            readonly enum: readonly ["continuation_pending", "world_advanced", "world_step_pending", "world_terminal", "attention_refresh_required", "model_decision_required", "attention_correction_required", "campaign_work_completed"];
+        };
+        readonly retryAfterMs: {
+            readonly type: "integer";
+            readonly minimum: 1;
         };
         readonly advanceResult: {
             readonly type: "object";
@@ -265,6 +269,18 @@ export declare const REFILL_V3_CONTINUE_OUTPUT_SCHEMA: Readonly<{
     };
     readonly additionalProperties: false;
     readonly allOf: readonly [{
+        readonly if: {
+            readonly required: readonly ["kind"];
+            readonly properties: {
+                readonly kind: {
+                    readonly const: "continuation_pending";
+                };
+            };
+        };
+        readonly then: {
+            readonly required: readonly ["kind", "retryAfterMs"];
+        };
+    }, {
         readonly if: {
             readonly required: readonly ["kind"];
             readonly properties: {

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

@@ -43,6 +43,7 @@ const REFILL_V3_CAMPAIGN_WORK_ACTION_SCHEMA = Object.freeze({
     },
 });
 export const REFILL_V3_CONTINUE_RESULT_KINDS = [
+    "continuation_pending",
     "world_advanced",
     "world_step_pending",
     "world_terminal",
@@ -120,6 +121,7 @@ export const REFILL_V3_CONTINUE_OUTPUT_SCHEMA = Object.freeze({
     required: ["kind"],
     properties: {
         kind: { type: "string", enum: [...REFILL_V3_CONTINUE_RESULT_KINDS] },
+        retryAfterMs: { type: "integer", minimum: 1 },
         advanceResult: { type: "object" },
         packet: { type: "object" },
         correction: { type: "object" },
@@ -142,6 +144,13 @@ export const REFILL_V3_CONTINUE_OUTPUT_SCHEMA = Object.freeze({
     },
     additionalProperties: false,
     allOf: [
+        {
+            if: {
+                required: ["kind"],
+                properties: { kind: { const: "continuation_pending" } },
+            },
+            then: { required: ["kind", "retryAfterMs"] },
+        },
         {
             if: {
                 required: ["kind"],

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

@@ -215,7 +215,11 @@ export declare const refillV3ContinueToolDefinitions: {
         readonly properties: {
             readonly kind: {
                 readonly type: "string";
-                readonly enum: readonly ["world_advanced", "world_step_pending", "world_terminal", "attention_refresh_required", "model_decision_required", "attention_correction_required", "campaign_work_completed"];
+                readonly enum: readonly ["continuation_pending", "world_advanced", "world_step_pending", "world_terminal", "attention_refresh_required", "model_decision_required", "attention_correction_required", "campaign_work_completed"];
+            };
+            readonly retryAfterMs: {
+                readonly type: "integer";
+                readonly minimum: 1;
             };
             readonly advanceResult: {
                 readonly type: "object";
@@ -260,6 +264,18 @@ export declare const refillV3ContinueToolDefinitions: {
         };
         readonly additionalProperties: false;
         readonly allOf: readonly [{
+            readonly if: {
+                readonly required: readonly ["kind"];
+                readonly properties: {
+                    readonly kind: {
+                        readonly const: "continuation_pending";
+                    };
+                };
+            };
+            readonly then: {
+                readonly required: readonly ["kind", "retryAfterMs"];
+            };
+        }, {
             readonly if: {
                 readonly required: readonly ["kind"];
                 readonly properties: {
@@ -371,6 +387,9 @@ export type RefillV3ContinueInput = {
     decision?: unknown;
 };
 export type RefillV3ContinueResult = {
+    kind: "continuation_pending";
+    retryAfterMs: number;
+} | {
     kind: "world_advanced";
     advanceResult: Extract<RefillV3AdvanceResult, {
         kind: "advanced";
@@ -484,6 +503,7 @@ export type RefillV3ContinueDependencies = {
         lane: RefillWorldStateLane;
         evidenceFingerprint: string;
         effectFingerprint: string;
+        sourceRowsCopied?: number;
         /** Closed external wait classification; never diagnostic provider prose. */
         externalReasonCode?: "endpoint_temporarily_unavailable";
         /**
@@ -561,7 +581,7 @@ export declare function continueRefillV3Tool(input: {
     campaignId?: string;
     yolo?: boolean;
     decision?: unknown;
-}): Promise<RefillV3ContinueResult>;
+}, dependencies?: RefillV3ContinueDependencies): Promise<RefillV3ContinueResult>;
 import { getPrepareCampaignMessagesStatus, startPrepareCampaignMessages } from "./campaign-message-preparation.js";
 import { queueCampaignCells, selectCampaignCells, selectRepairableCampaignCells } from "./campaign-processing.js";
 import { getProviderPrompt } from "./leads.js";

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

@@ -4,13 +4,13 @@ import { handleAddColumn } from "./blueprint-commit.js";
 import { getCampaignTableSchema, waitForCampaignProcessing, } from "./campaign-processing.js";
 import { handleUpdateColumn } from "./column-update.js";
 import { executeOneYoloPrimitive } from "./refill-executors.js";
-import { advanceRefillV3Tool, } from "./refill-v3-advance.js";
+import { advanceRefillV3FromContinuation, } from "./refill-v3-advance.js";
 import { REFILL_V3_EXHAUSTION_PREDICATE, REFILL_V3_POSTS_SEARCH_SPENT_AVENUE, } from "./refill-v3-attention-packet-contract.js";
 import { isRefillV3CampaignWorkReceiptAction, } from "./refill-v3-campaign-work-receipt-contract.js";
 import { REFILL_V3_ACTION_RESULTS, REFILL_V3_PREPARATION_REUSE_POINTS, decodeRefillV3CampaignWorkOutput, runRefillV3CampaignWork, } from "./refill-v3-campaign-work.js";
 import { REFILL_V3_CONTINUE_INPUT_SCHEMA, REFILL_V3_CONTINUE_OUTPUT_SCHEMA, } from "./refill-v3-continue-contract.js";
 import { refillV3EnrichmentBatchPlan, refillV3LastCohortStatsFromStatus, } from "./refill-v3-enrichment-batch-plan.js";
-import { retainedRefillV3Attention } from "./refill-v3-run-token-transport.js";
+import { resumeRefillV3Continuation, retainedRefillV3Attention, startRefillV3Continuation, } from "./refill-v3-run-token-transport.js";
 import { dispatchRefillV3SourceFamily, } from "./refill-v3-source-family-dispatch.js";
 import { getRefillV3WorldStateTool } from "./refill-v3-world-state.js";
 import { normalizeExplicitWorkspaceId } from "./workspace-context.js";
@@ -18,7 +18,7 @@ export const REFILL_V3_CONTINUE_TOOL_NAME = "refill_v3_continue";
 export const refillV3ContinueToolDefinitions = [
     {
         name: REFILL_V3_CONTINUE_TOOL_NAME,
-        description: "Continue exactly one server-issued Refill V3 campaign-attention packet. Call first without decision: after a fresh revalidation, the tool deterministically owns live-job waiting, selected-source row copying, exact actionable enrichment, and same-template message generation. It returns model_decision_required only when the accurate packet needs a genuine repair, criteria, rubric, waterfall, or source-expansion judgment; then call again with that one closed decision. Only an exact fresh packet can dispatch one existing campaign-work authority, which re-observes the exact sender/date and settles before a sibling campaign may advance. The caller cannot supply batch sizes, readiness digests, retry counters, fill inputs, scheduler inputs, or idempotency keys.",
+        description: "Continue exactly one server-issued Refill V3 campaign-attention packet. continuation_pending means the same operation is still running: wait retryAfterMs and call this tool with identical scope and no decision until it returns. Reconcile transport timeouts the same way; do not call advance or dispatch another search while pending. Call first without decision: after a fresh revalidation, the tool deterministically owns live-job waiting, selected-source row copying, exact actionable enrichment, and same-template message generation. It returns model_decision_required only when the accurate packet needs a genuine repair, criteria, rubric, waterfall, or source-expansion judgment; then call again with that one closed decision. Only an exact fresh packet can dispatch one existing campaign-work authority, which re-observes the exact sender/date and settles before a sibling campaign may advance. The caller cannot supply batch sizes, readiness digests, retry counters, fill inputs, scheduler inputs, or idempotency keys.",
         inputSchema: REFILL_V3_CONTINUE_INPUT_SCHEMA,
         outputSchema: REFILL_V3_CONTINUE_OUTPUT_SCHEMA,
         annotations: {
@@ -204,6 +204,9 @@ export async function runRefillV3CampaignWorkWithProductionOwners(input, owners
             : null,
         afterFingerprint: params.outcome === "applied" ? fingerprint(params.after) : null,
         changedFields: params.changedFields ?? [],
+        ...(params.sourceRowsCopied === undefined
+            ? {}
+            : { sourceRowsCopied: params.sourceRowsCopied }),
         effectKey: params.outcome === "applied" ? params.idempotencyKey : null,
         rollback: params.outcome === "applied"
             ? { available: false, input: null, result: null }
@@ -407,11 +410,21 @@ export async function runRefillV3CampaignWorkWithProductionOwners(input, owners
                     },
                 }, request.scope.workspaceId);
                 if (attempt.status === "executed_and_reread") {
+                    // confirm_lead_list's rowCount includes already-present rows. Only
+                    // leadsImported proves a new cohort; a duplicate copy cannot reset
+                    // the lane's bounded preparation budget.
+                    const imported = record(record(attempt.result)?.importSummary)?.leadsImported;
+                    const sourceRowsCopied = typeof imported === "number" &&
+                        Number.isSafeInteger(imported) &&
+                        imported > 0
+                        ? imported
+                        : 0;
                     return receipt({
-                        outcome: "applied",
+                        outcome: sourceRowsCopied > 0 ? "applied" : "no_effect",
                         result,
                         idempotencyKey: request.idempotencyKey,
-                        changedFields: ["campaignSourceRows"],
+                        changedFields: sourceRowsCopied > 0 ? ["campaignSourceRows"] : [],
+                        sourceRowsCopied,
                         after: attempt.result,
                     });
                 }
@@ -1206,7 +1219,7 @@ export async function readRefillV3CampaignMessageCount(input) {
     return generatedMessageCountFrom(stats);
 }
 const DEFAULT_DEPENDENCIES = {
-    advance: advanceRefillV3Tool,
+    advance: advanceRefillV3FromContinuation,
     runCampaignWork: runRefillV3CampaignWorkWithProductionOwners,
     waitForCampaignProcessing,
     async attestCampaignTargetAfterWait(input) {
@@ -1378,8 +1391,10 @@ async function executeRefillV3Continuation(input, dependencies) {
         input.decision !== undefined) {
         return { kind: "attention_refresh_required", advanceResult };
     }
-    if (input.packet.evidence.diagnosticRowRef?.selectorRef === "copyIntegrityBlockedMessages:actionable:v1" ||
-        advanceResult.packet.evidence.diagnosticRowRef?.selectorRef === "copyIntegrityBlockedMessages:actionable:v1") {
+    if (input.packet.evidence.diagnosticRowRef?.selectorRef ===
+        "copyIntegrityBlockedMessages:actionable:v1" ||
+        advanceResult.packet.evidence.diagnosticRowRef?.selectorRef ===
+            "copyIntegrityBlockedMessages:actionable:v1") {
         return { kind: "attention_refresh_required", advanceResult };
     }
     // V33-VINCENT-001: a no-decision call is the server-owned classification
@@ -1483,6 +1498,10 @@ async function executeRefillV3Continuation(input, dependencies) {
                 lane: advanceResult.packet.scope.lane,
                 evidenceFingerprint: advanceResult.packet.scope.evidenceFingerprint,
                 effectFingerprint: receipt.afterFingerprint ?? receipt.idempotencyKey,
+                ...(receiptAction === "copy_selected_source_rows" &&
+                    receipt.sourceRowsCopied !== undefined
+                    ? { sourceRowsCopied: receipt.sourceRowsCopied }
+                    : {}),
                 ...(receipt.externalReasonCode === undefined
                     ? {}
                     : { externalReasonCode: receipt.externalReasonCode }),
@@ -1716,7 +1735,7 @@ export function continueRefillV3(input, dependencies = DEFAULT_DEPENDENCIES) {
     void entry.promise.then(retainResolvedResult, evictRejectedPromise);
     return entry.promise;
 }
-export async function continueRefillV3Tool(input) {
+export async function continueRefillV3Tool(input, dependencies = DEFAULT_DEPENDENCIES) {
     const workspaceId = normalizeExplicitWorkspaceId(input.workspaceId);
     const yolo = input.yolo ?? true;
     const transportScope = workspaceId
@@ -1729,6 +1748,11 @@ export async function continueRefillV3Tool(input) {
             yolo,
         }
         : null;
+    const pending = transportScope
+        ? resumeRefillV3Continuation(transportScope)
+        : null;
+    if (pending)
+        return pending;
     const retained = transportScope
         ? retainedRefillV3Attention(transportScope)
         : null;
@@ -1740,7 +1764,7 @@ export async function continueRefillV3Tool(input) {
         input.campaignId !== retained.campaignId) {
         throw new Error("campaign_target_identity_mismatch: the explicit continuation campaignId differs from the retained server-issued run target");
     }
-    return continueRefillV3({
+    return startRefillV3Continuation({ ...transportScope, campaignId: input.campaignId ?? retained.campaignId }, () => continueRefillV3({
         workspaceId,
         scope: input.scope,
         ...((input.campaignId ?? retained.campaignId) === undefined
@@ -1750,7 +1774,7 @@ export async function continueRefillV3Tool(input) {
         runToken: retained.runToken,
         packet: retained.packet,
         ...(input.decision === undefined ? {} : { decision: input.decision }),
-    });
+    }, dependencies));
 }
 import { getPrepareCampaignMessagesStatus, startPrepareCampaignMessages, } from "./campaign-message-preparation.js";
 import { queueCampaignCells, selectCampaignCells, selectRepairableCampaignCells, } from "./campaign-processing.js";

package/dist/tools/refill-v3-run-token-transport.d.ts

@@ -14,6 +14,7 @@
  */
 import type { RefillV3AdvanceResult } from "./refill-v3-advance-contract.js";
 import type { RefillV3CampaignAttentionPacket } from "./refill-v3-attention-packet-contract.js";
+import type { RefillV3ContinueResult } from "./refill-v3-continue.js";
 export type RefillV3RunTransportScope = {
     workspaceId: string;
     scope: unknown;
@@ -32,3 +33,15 @@ export declare function retainedRefillV3Attention(input: RefillV3RunTransportSco
 } | null;
 /** Test-only isolation owner; production code never clears live continuity. */
 export declare function resetRefillV3RunTokenTransportForTests(): void;
+export declare function assertNoRefillV3Continuation(input: RefillV3RunTransportScope): void;
+/**
+ * Keep a public retry attached BEFORE reading the successor token. The Sep 21
+ * Sellable source search outlived the MCP response; reading that newer token
+ * let a retry overtake the source receipt write. The flight owns no product
+ * decisions: it only retains one exact continuation through response loss.
+ * Completed results stay collectible after a pending response, including
+ * errors, until a caller observes them. This is process-local transport state;
+ * durable owner/run receipts remain the authority after an MCP restart.
+ */
+export declare function resumeRefillV3Continuation(input: RefillV3RunTransportScope): Promise<RefillV3ContinueResult> | null;
+export declare function startRefillV3Continuation(input: RefillV3RunTransportScope, execute: () => Promise<RefillV3ContinueResult>): Promise<RefillV3ContinueResult>;

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

@@ -31,9 +31,7 @@ function runKey(input) {
     return canonical({
         workspaceId: input.workspaceId,
         scope: input.scope,
-        ...(input.campaignId === undefined
-            ? {}
-            : { campaignId: input.campaignId }),
+        ...(input.campaignId === undefined ? {} : { campaignId: input.campaignId }),
         yolo: input.yolo !== false,
     });
 }
@@ -95,4 +93,69 @@ export function retainedRefillV3Attention(input) {
 /** Test-only isolation owner; production code never clears live continuity. */
 export function resetRefillV3RunTokenTransportForTests() {
     retainedRuns.clear();
+    continuationFlights.clear();
+}
+const continuationFlights = new Map();
+function continuationFlight(input) {
+    const exact = continuationFlights.get(runKey(input));
+    if (exact || input.campaignId !== undefined)
+        return exact;
+    const matches = [...continuationFlights.values()].filter((entry) => baseRunKey(entry.scope) === baseRunKey(input));
+    if (matches.length > 1)
+        throw new Error("Specify campaignId to resume the exact pending continuation.");
+    return matches[0];
+}
+export function assertNoRefillV3Continuation(input) {
+    if (continuationFlight(input)) {
+        throw new Error("continuation_pending: call refill_v3_continue with the same scope and no decision to collect the running operation before advancing.");
+    }
+}
+/**
+ * Keep a public retry attached BEFORE reading the successor token. The Sep 21
+ * Sellable source search outlived the MCP response; reading that newer token
+ * let a retry overtake the source receipt write. The flight owns no product
+ * decisions: it only retains one exact continuation through response loss.
+ * Completed results stay collectible after a pending response, including
+ * errors, until a caller observes them. This is process-local transport state;
+ * durable owner/run receipts remain the authority after an MCP restart.
+ */
+export function resumeRefillV3Continuation(input) {
+    const entry = continuationFlight(input);
+    return entry ? collectContinuation(entry) : null;
+}
+export function startRefillV3Continuation(input, execute) {
+    const existing = resumeRefillV3Continuation(input);
+    if (existing)
+        return existing;
+    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) };
+    continuationFlights.set(runKey(input), entry);
+    return collectContinuation(entry);
+}
+async function collectContinuation(entry) {
+    let timer;
+    const pending = Symbol("pending");
+    try {
+        const result = await Promise.race([
+            entry.promise,
+            new Promise((resolve) => {
+                timer = setTimeout(() => resolve(pending), 20_000);
+            }),
+        ]);
+        if (result === pending)
+            return { kind: "continuation_pending", retryAfterMs: 1000 };
+        if (continuationFlights.get(runKey(entry.scope)) === entry)
+            continuationFlights.delete(runKey(entry.scope));
+        return result;
+    }
+    catch (error) {
+        if (continuationFlights.get(runKey(entry.scope)) === entry)
+            continuationFlights.delete(runKey(entry.scope));
+        throw error;
+    }
+    finally {
+        clearTimeout(timer);
+    }
 }