@sellable/mcp 0.1.613 → 0.1.615-phase111.20260720001632

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

@@ -1,6 +1,7 @@
 import type { appendIndexLine, appendJournalEvent, createRunJournal, renderBootstrapSection, renderCrashedAbandonedSection, renderExecutionEventSection, renderPlanSection, renderTerminalSection } from "./refill-journal.js";
 import type { advanceRefillRunGateRemote, completeRefillRun, heartbeatRefillRun, recordRunOutcome, recordRunPlanned, refillRunStatus, startRefillRunRemote } from "./refill-run-client.js";
 import type { getPrepareCampaignMessagesStatus } from "./tools/campaign-message-preparation.js";
+import { type MessageTemplateRevisionV1, type RefillReportingContextV2, type RefillRunHandleV1, type RefillTargetConfigV1 } from "./tools/campaign-processing.js";
 import type { executeOneYoloPrimitive, executeStartCampaignPrimitive, prepareRowSelectorValue, refillPrepareRequestHash, refreshPaidInmailCreditsWithRetry } from "./tools/refill-executors.js";
 export type RefillLoopGate = "g0_bootstrap" | "g1_plan" | "g2_execute" | "g3_verify" | "g4_terminal";
 export interface RefillV2LoopInput {
@@ -15,6 +16,10 @@ export interface RefillV2LoopInput {
         runId: string;
         fence: number;
     };
+    runHandle?: RefillRunHandleV1;
+    targetConfig?: RefillTargetConfigV1;
+    reportingContext?: RefillReportingContextV2;
+    messageTemplateRevision?: MessageTemplateRevisionV1;
     approvalMode?: "approve" | "mark_ready";
     dryRun?: boolean;
     agentKeywords?: string[];
@@ -69,6 +74,10 @@ export interface RefillV2LoopDeps {
         targetDate?: string;
         untilDate?: string;
         horizonSendDays?: number;
+        targetConfig?: RefillTargetConfigV1;
+        runHandle?: RefillRunHandleV1;
+        reportingContext?: RefillReportingContextV2;
+        messageTemplateRevision?: MessageTemplateRevisionV1;
         runState?: Record<string, unknown>;
         journal?: boolean;
     }) => Promise<Record<string, unknown>>;
@@ -95,6 +104,9 @@ export type RefillV2LoopResult = {
     gate: RefillLoopGate;
     guidance: string;
     journalPath?: string | null;
+    targetConfig?: RefillTargetConfigV1;
+    runHandle?: RefillRunHandleV1;
+    refillReporting?: Record<string, unknown>;
 } | {
     status: "blocked";
     blocker: string;
@@ -105,6 +117,9 @@ export type RefillV2LoopResult = {
     holderRunId?: string;
     report?: Record<string, unknown>;
     journalPath?: string | null;
+    targetConfig?: RefillTargetConfigV1;
+    runHandle?: RefillRunHandleV1;
+    refillReporting?: Record<string, unknown>;
 } | {
     status: "terminal";
     doneReason: string;
@@ -112,5 +127,21 @@ export type RefillV2LoopResult = {
     runId: string;
     guidance?: string;
     journalPath?: string | null;
+    targetConfig?: RefillTargetConfigV1;
+    runHandle?: RefillRunHandleV1;
+    refillReporting?: Record<string, unknown>;
+};
+export declare function packetCoherenceFailure(plan: Record<string, unknown>): string | null;
+export declare function terminalProjection(value: {
+    targetConfig?: unknown;
+    runHandle?: unknown;
+    refillReporting?: unknown;
+    reporting?: unknown;
+    lastOutcome?: unknown;
+}): {
+    messageTemplateRevisionOutcome?: {} | null | undefined;
+    refillReporting?: Record<string, unknown> | undefined;
+    runHandle?: RefillRunHandleV1 | undefined;
+    targetConfig?: RefillTargetConfigV1 | undefined;
 };
 export declare function runRefillV2Loop(input: RefillV2LoopInput, deps: RefillV2LoopDeps): Promise<RefillV2LoopResult>;

package/dist/refill-run-loop.js

@@ -1,7 +1,9 @@
 import { SellableApiError } from "./api.js";
 import { decodeRefillReadinessAuthority, refillReadinessExpectationInput, refillReadinessFingerprint, } from "./refill-readiness.js";
+import { normalizeMessageTemplateRevision, normalizeRefillRunHandle, normalizeRefillTargetConfig, } from "./tools/campaign-processing.js";
 import { buildRunStateFromLocalHints } from "./tools/evergreen-refill-plan.js";
 import { classifyPaidInmailRefreshReceipt, prepareRowSelectorValue as defaultPrepareRowSelectorValue, refillPrepareRequestHash as defaultRefillPrepareRequestHash, validateAgentSuppliedBroadenKeywords, } from "./tools/refill-executors.js";
+import { sanitizeRefillReportingProjection } from "./tools/refill-target-plan.js";
 const DEFAULT_BUDGETS = {
     maxGateCyclesPerInvocation: 4,
     pollIntervalMs: 5_000,
@@ -1320,7 +1322,7 @@ function getPlanLine(plan) {
         fallbackSummary: stringValue(recordValue(itinerary.fallback)?.trigger) ?? "",
     };
 }
-function packetCoherenceFailure(plan) {
+export function packetCoherenceFailure(plan) {
     const fingerprint = fingerprintFromPlan(plan);
     if (!fingerprint.planRevision || !fingerprint.targetShapeRevision) {
         return "missing_fingerprint";
@@ -1344,8 +1346,79 @@ function packetCoherenceFailure(plan) {
         (!actionCampaignId(action) || !stringValue(toolInput.tableId))) {
         return "malformed_prepare_tool_input";
     }
+    if (type === "revise_message_template_and_rerun") {
+        try {
+            const targetConfig = normalizeRefillTargetConfig(toolInput.targetConfig);
+            const runHandle = normalizeRefillRunHandle(toolInput.runHandle);
+            const revision = normalizeMessageTemplateRevision(toolInput.messageTemplateRevision);
+            if (!revision ||
+                actionCampaignId(action) !== targetConfig.campaignId ||
+                actionTableId(action) !== targetConfig.tableId ||
+                (isRecord(plan.targetConfig) &&
+                    safeJson(normalizeRefillTargetConfig(plan.targetConfig)) !==
+                        safeJson(targetConfig)) ||
+                (typeof action.effectId === "string" &&
+                    action.effectId !== revision.effectId) ||
+                (typeof action.requestId === "string" &&
+                    action.requestId !== revision.requestId) ||
+                (typeof action.revisionOperationId === "string" &&
+                    action.revisionOperationId !== revision.revisionOperationId) ||
+                runHandle.runId.trim().length === 0) {
+                return "malformed_message_template_revision";
+            }
+        }
+        catch {
+            return "malformed_message_template_revision";
+        }
+    }
     return null;
 }
+function reportingFrom(value) {
+    if (!isRecord(value))
+        return undefined;
+    return (sanitizeRefillReportingProjection(value.refillReporting) ??
+        sanitizeRefillReportingProjection(value.reporting) ??
+        (isRecord(value.packet)
+            ? sanitizeRefillReportingProjection(value.packet.reporting)
+            : undefined));
+}
+export function terminalProjection(value) {
+    const targetConfig = value.targetConfig
+        ? normalizeRefillTargetConfig(value.targetConfig)
+        : undefined;
+    const runHandle = value.runHandle
+        ? normalizeRefillRunHandle(value.runHandle)
+        : undefined;
+    const refillReporting = sanitizeRefillReportingProjection(value.refillReporting) ??
+        sanitizeRefillReportingProjection(value.reporting);
+    return {
+        ...(targetConfig ? { targetConfig } : {}),
+        ...(runHandle ? { runHandle } : {}),
+        ...(refillReporting ? { refillReporting } : {}),
+        ...(value.lastOutcome !== undefined
+            ? { messageTemplateRevisionOutcome: value.lastOutcome }
+            : {}),
+    };
+}
+function exactLoopProjection(input, ctx, plan = ctx.plan) {
+    const planPacket = isRecord(plan?.packet) ? plan.packet : null;
+    const targetConfig = input.targetConfig ??
+        ctx.targetConfig ??
+        (isRecord(plan?.targetConfig) ? plan.targetConfig : undefined) ??
+        (isRecord(planPacket?.targetConfig) ? planPacket.targetConfig : undefined);
+    const refillReporting = reportingFrom(plan) ??
+        reportingFrom(planPacket) ??
+        reportingFrom(ctx.runState);
+    const executedRevision = stringValue(lastAction(ctx)?.type) === "revise_message_template_and_rerun"
+        ? ctx.runState.lastOutcome
+        : undefined;
+    return terminalProjection({
+        targetConfig,
+        runHandle: ctx.runHandle,
+        refillReporting,
+        lastOutcome: executedRevision,
+    });
+}
 async function safeJournalAppend(ctx, deps, block) {
     if (!ctx.journalPath)
         return;
@@ -1402,21 +1475,28 @@ async function createJournal(input, deps, runId) {
 }
 async function startOrResume(input, deps) {
     const initialRunState = buildRunStateFromLocalHints(input.workspaceId);
+    const targetConfig = input.targetConfig
+        ? normalizeRefillTargetConfig(input.targetConfig)
+        : null;
+    const requestedHandle = input.runHandle
+        ? normalizeRefillRunHandle(input.runHandle)
+        : input.resume;
     const started = await deps.runClient.startRefillRunRemote({
         workspaceId: input.workspaceId,
-        config: {
-            intent: input.intent ?? "auto",
-            senderIds: input.senderIds,
-            actionTypes: input.actionTypes,
-            approvalMode: input.approvalMode ?? "approve",
-            ...(input.targetDate ? { targetDate: input.targetDate } : {}),
-            ...(input.untilDate ? { untilDate: input.untilDate } : {}),
-            ...(typeof input.horizonSendDays === "number"
-                ? { horizonSendDays: input.horizonSendDays }
-                : {}),
-        },
+        config: targetConfig ??
+            {
+                intent: input.intent ?? "auto",
+                senderIds: input.senderIds,
+                actionTypes: input.actionTypes,
+                approvalMode: input.approvalMode ?? "approve",
+                ...(input.targetDate ? { targetDate: input.targetDate } : {}),
+                ...(input.untilDate ? { untilDate: input.untilDate } : {}),
+                ...(typeof input.horizonSendDays === "number"
+                    ? { horizonSendDays: input.horizonSendDays }
+                    : {}),
+            },
         runState: initialRunState,
-        resume: input.resume,
+        resume: requestedHandle,
     });
     if (isLeaseLost(started)) {
         return {
@@ -1437,7 +1517,15 @@ async function startOrResume(input, deps) {
     const result = started;
     const runId = stringValue(result.runId);
     const fence = numberValue(result.fence);
-    if (!runId || fence == null) {
+    let runHandle = null;
+    try {
+        runHandle = normalizeRefillRunHandle(recordValue(result.handle) ??
+            (runId && fence != null ? { runId, fence } : undefined));
+    }
+    catch {
+        runHandle = null;
+    }
+    if (!runId || fence == null || !runHandle) {
         return {
             status: "blocked",
             blocker: "bad_start_response",
@@ -1445,6 +1533,9 @@ async function startOrResume(input, deps) {
             report: { response: started },
         };
     }
+    input.runHandle = runHandle;
+    if (targetConfig)
+        input.targetConfig = targetConfig;
     const gate = (stringValue(result.gate) ?? "g0_bootstrap");
     const gateSeq = numberValue(result.gateSeq) ?? 0;
     const runState = recordValue(result.runState) ??
@@ -1460,6 +1551,8 @@ async function startOrResume(input, deps) {
         workspaceId: input.workspaceId,
         runId,
         fence,
+        runHandle,
+        targetConfig,
         gate,
         gateSeq,
         runState,
@@ -1616,6 +1709,7 @@ async function completeTerminal(input, deps, ctx, doneReasonInput, reportInput =
         blockedContinuations: ctx.blockedContinuations,
         journalPath: ctx.journalPath,
         ...reportInput,
+        ...exactLoopProjection(input, ctx),
     };
     const terminalRunState = mergeRunState(ctx.runState, {
         terminal: {
@@ -1676,6 +1770,7 @@ async function completeTerminal(input, deps, ctx, doneReasonInput, reportInput =
         report,
         runId: ctx.runId,
         journalPath: ctx.journalPath,
+        ...exactLoopProjection(input, ctx),
         ...(doneReason === "lanes_exhausted"
             ? {
                 guidance: "Lane chain exhausted. Before reporting, call resolve_campaign_fill_route for this workspace: if skippedTargets holds a non-archived DRAFT campaign blocked only by campaign_sequence_missing that already has imported prospect rows and a complete builder pipeline, finish its setup per the repairable-draft fallback (update_campaign attaching exactly the already-eligible refill senders, then attach_recommended_sequence WITHOUT currentStep so the approved-message gate stays intact) and re-invoke refill_sends --yolo with the same workspace scope; the bounded ladder then prepares/approves messages and starts the campaign through its normal gates.",
@@ -2127,6 +2222,9 @@ async function gateExecute(input, deps, ctx) {
                 toolInput: {
                     ...actionToolInput(action),
                     approvalMode: input.approvalMode ?? actionToolInput(action).approvalMode,
+                    ...(input.reportingContext
+                        ? { reportingContext: input.reportingContext }
+                        : {}),
                 },
             }, input.workspaceId);
         }
@@ -2250,6 +2348,7 @@ async function verifyPrepareAction(input, deps, ctx, action, budgets) {
     const expectedHash = expectedPrepareRequestHash(deps, action);
     const tableId = stringValue(actionToolInput(action).tableId) ?? undefined;
     const campaignId = actionCampaignId(action) ?? undefined;
+    const reportingHistory = arrayValue(recordValue(input.reportingContext?.liveHistory)?.snapshots);
     let latestStatus = null;
     for (let poll = 0; poll < budgets.maxPollsPerWait; poll += 1) {
         latestStatus = await getStatus({
@@ -2257,6 +2356,10 @@ async function verifyPrepareAction(input, deps, ctx, action, budgets) {
             jobId,
             campaignId,
             tableId,
+            ...(input.reportingContext
+                ? { reportingContext: input.reportingContext }
+                : {}),
+            ...(reportingHistory.length > 0 ? { history: reportingHistory } : {}),
         });
         const statusRecord = recordValue(latestStatus) ?? {};
         const requestSource = stringValue(statusRecord.requestSource);
@@ -3413,6 +3516,7 @@ async function heartbeatAndContinue(input, deps, ctx) {
         gate: ctx.gate,
         guidance: "Per-invocation gate budget reached. Re-invoke refill_sends with the same arguments (including workspaceId and any targetDate/untilDate/horizonSendDays) plus this runId/fence to continue.",
         journalPath: ctx.journalPath,
+        ...exactLoopProjection(input, ctx),
     };
 }
 export async function runRefillV2Loop(input, deps) {
@@ -3467,15 +3571,18 @@ export async function runRefillV2Loop(input, deps) {
                 continue;
             }
             if (ctx.gate === "g4_terminal") {
+                const projection = exactLoopProjection(input, ctx);
                 return {
                     status: "terminal",
                     doneReason: normalizeDoneReason(recordValue(ctx.runState.terminal)?.doneReason),
                     report: {
                         doneReason: normalizeDoneReason(recordValue(ctx.runState.terminal)?.doneReason),
                         journalPath: ctx.journalPath,
+                        ...projection,
                     },
                     runId: ctx.runId,
                     journalPath: ctx.journalPath,
+                    ...projection,
                 };
             }
         }

package/dist/server.js

@@ -52,7 +52,7 @@ import { addRubricItem, checkRubric, deleteRubricItem, draftRubrics, saveRubrics
 import { getSchedulerFillCapacity } from "./tools/scheduler-fill-capacity.js";
 import { runSchedulerSweep } from "./tools/scheduler-run.js";
 import { getSenderRoutingTool, setSenderRoutingTool, } from "./tools/sender-routing.js";
-import { getSender, listSenders, refreshPaidInmailCredits, } from "./tools/senders.js";
+import { getSender, listSenders, refreshPaidInmailCredits, setSenderCalendarLink, } from "./tools/senders.js";
 import { attachRecommendedSequence, attachSequence, createWorkflowTable, } from "./tools/sequencer.js";
 import { setupEvergreenCampaigns } from "./tools/setup-evergreen-campaigns.js";
 import { exportTableCsv, listTables } from "./tools/tables.js";
@@ -577,6 +577,9 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
             case "get_sender":
                 result = await getSender(args);
                 break;
+            case "set_sender_calendar_link":
+                result = await setSenderCalendarLink(args);
+                break;
             case "refresh_paid_inmail_credits":
                 result = await refreshPaidInmailCredits(args);
                 break;