@sellable/mcp 0.1.554 → 0.1.555

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

@@ -30,6 +30,22 @@
           "yoloMode"
         ]
       }
+    },
+    {
+      "tool": "get_subskill_asset",
+      "requiredValues": {
+        "subskillName": "refill-sends-workflow",
+        "assetPath": "core/contract.v2.json"
+      },
+      "mustReadUntil": {
+        "hasMore": false
+      },
+      "validation": {
+        "supportedMajor": 2,
+        "contractVersion": "2.0.0",
+        "cacheVersion": "refill-contract-v1",
+        "contractHash": "e54ba0f80bc534fd70fd8c10c1caab109fe9a91c205cfc423f5f6735cd53fdc1"
+      }
     }
   ],
   "gateOrder": [
@@ -61,6 +77,44 @@
     "scheduled",
     "projected"
   ],
+  "scopeContract": {
+    "immutableApprovalEnvelope": [
+      "workspaceId",
+      "targetDate",
+      "senderIds",
+      "actionTypes",
+      "campaignIds",
+      "tableIds",
+      "sourceIds",
+      "targetShapeRevision",
+      "actionKey"
+    ],
+    "mutableProgress": [
+      "stateRevision",
+      "sent",
+      "scheduled",
+      "readyToSchedule",
+      "remainingProjectedGap"
+    ],
+    "executionRules": [
+      "Execute only target.globalActionQueue[0].",
+      "Execute one action, then perform a full authoritative reread before selecting any next action.",
+      "Mutable progress must not be treated as approval-scope drift while targetShapeRevision remains stable."
+    ]
+  },
+  "interruptionRecovery": {
+    "rules": [
+      "On resume, reread the canonical target plan and reconcile scheduler status or receipt with the matching requestKey and actionKey before retrying.",
+      "A matching terminal receipt must replay without a second scheduler execution.",
+      "An uncertain_outcome requires reconciliation; do not schedule again with the same or a replacement key until a canonical read resolves it."
+    ]
+  },
+  "multiDayOrdering": {
+    "rules": [
+      "For multiple target dates, finish D1 execution and the full D1 reread before planning D2.",
+      "Do not pre-plan or execute a later date from stale earlier-date state."
+    ]
+  },
   "states": [
     {
       "id": "target_plan_read",
@@ -188,7 +242,7 @@
     },
     {
       "id": "scheduler_wait_readback",
-      "description": "Read-only scheduler polling after rows are ready and paid-credit facts are fresh.",
+      "description": "Exact-date scheduler sweep or read-only polling after rows are ready and paid-credit facts are fresh.",
       "allowedTools": [
         "get_refill_target_plan",
         "get_scheduler_fill_capacity",
@@ -203,6 +257,9 @@
       "rules": [
         "Poll every 60-120 seconds or on the host continuation interval.",
         "Use run_scheduler_sweep with the explicit workspaceId when ready rows need scheduler pickup now; it places cells only inside existing gates and never sends.",
+        "A scheduler sweep is a visible workspace-wide scheduling side effect; the packet limits expected target changes but must disclose that unrelated eligible workspace work may also be scheduled.",
+        "For an explicit targetDate, execute only the request-scoped run_scheduler_sweep from target.globalActionQueue[0], then perform a full authoritative target-plan reread before any next action.",
+        "Reuse the matching requestKey and actionKey only for status or receipt reconciliation; replay a matching terminal receipt and stop on uncertain_outcome rather than scheduling again.",
         "cellsConsidered is allocation-attempt count; inspect campaignScopeSummary before assuming the selected refill campaign/table was included or ready-but-blocked.",
         "Read prefiltered, skipped, and deferred separately: prefiltered ready closed-InMail cells with stale paid-credit facts require refresh_paid_inmail_credits_then_rerun once, then rerun/status.",
         "wait_for_capacity_or_window means report loaded/capped/waiting and do not source or prep more rows; no_ready_cells_continue_refill_prep means return to the refill/prep ladder.",
@@ -211,6 +268,11 @@
         "Do not mark complete or blocked only because awaiting_scheduler_after_ready_buffer persists."
       ],
       "transitions": [
+        {
+          "when": "explicit targetDate and target.globalActionQueue[0] is request-scoped run_scheduler_sweep",
+          "action": "execute exactly one request-scoped run_scheduler_sweep, capture its complete receipt, and do not execute a returned next action",
+          "to": "target_plan_read"
+        },
         {
           "when": "projected coverage fills target",
           "to": "completion_or_blocker"
@@ -243,6 +305,7 @@
       "start_campaign_message_preparation",
       "same_source_copy",
       "bounded_generated_message_approval",
+      "run_scheduler_sweep",
       "wait_for_scheduler"
     ],
     "neverAutoExecute": [
@@ -271,16 +334,137 @@
   "verification": {
     "requiredProof": [
       "final get_refill_target_plan",
+      "get_campaign_refill_state for selected campaign/table facts",
+      "get_scheduler_fill_capacity for the exact sender/action/date",
+      "run_scheduler_sweep status or receipt for any executed sweep",
       "projected coverage sent + scheduled",
       "scheduler-owned cells with non-null scheduledFor when claiming scheduled",
       "paid-InMail freshness status clean before scheduler wait",
       "refresh receipt for each refreshed sender"
     ],
+    "forbiddenProof": [
+      "individual cell ids",
+      "Prisma",
+      "SQL",
+      "direct database access",
+      "production-environment scripts"
+    ],
+    "completionRules": [
+      "Report already sent actions separately from future scheduled actions.",
+      "Only scheduler-owned future scheduled actions count as scheduled coverage.",
+      "Prepared, approved, and ready rows remain intermediate evidence."
+    ],
     "notCompletionProof": [
       "prepared rows alone",
       "approved rows alone",
       "ready-to-schedule rows alone",
       "awaiting_scheduler_after_ready_buffer"
     ]
+  },
+  "refillContract": {
+    "contractVersion": "2.0.0",
+    "cacheVersion": "refill-contract-v1",
+    "contractHash": "e54ba0f80bc534fd70fd8c10c1caab109fe9a91c205cfc423f5f6735cd53fdc1",
+    "semanticIds": {
+      "scope": [
+        "workspace_id",
+        "target_date",
+        "sender_selectors",
+        "campaign_selectors",
+        "approval_mode",
+        "contract_identity",
+        "installed_identity"
+      ],
+      "gates": [
+        "workspace_access",
+        "approval_packet",
+        "source_family",
+        "threshold",
+        "scheduler",
+        "campaign_lifecycle",
+        "send_time",
+        "no_direct_send",
+        "one_primitive",
+        "fresh_reread",
+        "normalized_accounting",
+        "prep_circuit",
+        "terminal_truth"
+      ],
+      "states": [
+        "planning",
+        "awaiting_approval",
+        "executing",
+        "settling",
+        "replanning",
+        "terminal"
+      ],
+      "actions": [
+        "prepare_messages",
+        "approve_messages",
+        "rerun_errored_cells",
+        "start_paused_campaign",
+        "run_scheduler_sweep",
+        "scheduler_first_settle",
+        "wait_for_scheduler",
+        "wait_for_active_work",
+        "wait_for_source_import",
+        "copy_selected_source_rows",
+        "continue_signal_discovery_source",
+        "continue_sales_nav_source",
+        "continue_prospeo_source",
+        "manual_source_replenishment",
+        "refresh_paid_inmail_credits",
+        "lower_paid_inmail_threshold",
+        "switch_to_connection_lane",
+        "create_connection_campaign",
+        "next_campaign",
+        "done"
+      ],
+      "receipts": [
+        "target_plan_receipt",
+        "preparation_receipt",
+        "scheduler_receipt",
+        "run_receipt"
+      ],
+      "sideEffectClasses": [
+        "read_only",
+        "message_preparation",
+        "message_approval",
+        "source_replenishment",
+        "credit_refresh",
+        "campaign_start",
+        "scheduler_placement"
+      ],
+      "forbiddenActions": [
+        "direct_send",
+        "raw_scheduler_write",
+        "campaign_create",
+        "campaign_archive_delete",
+        "threshold_lowering",
+        "unselected_source_mutation",
+        "unapproved_campaign_start",
+        "sender_config_write"
+      ],
+      "terminalReasons": [
+        "projected_full",
+        "concrete_blocker",
+        "deadline_reached",
+        "iteration_limit",
+        "operator_stopped",
+        "capped_by_scheduler",
+        "loaded_awaiting_scheduler",
+        "lanes_exhausted",
+        "not_an_evergreen_workspace",
+        "no_refillable_campaigns"
+      ],
+      "transitions": [
+        "",
+        "",
+        "",
+        "",
+        "",
+        ""
+      ]
+    }
   }
 }

package/dist/refill-date-window.d.ts

@@ -1,34 +0,0 @@
-export type RefillDateWindowSource = "default_scheduler_forward" | "horizon_send_days" | "until_date" | "target_date";
-export type NormalizedRefillDateSelector = {
-    source: RefillDateWindowSource;
-    targetDate: string | null;
-    untilDate: string | null;
-    horizonSendDays: number | null;
-};
-export type RefillRunDateWindow = NormalizedRefillDateSelector & {
-    version: 1;
-    selectedDates: string[];
-    senderWindows?: Array<{
-        senderId: string | null;
-        timeZone: string | null;
-        selectedDates: string[];
-    }>;
-};
-type DateSelectorInput = {
-    targetDate?: unknown;
-    untilDate?: unknown;
-    horizonSendDays?: unknown;
-};
-export declare function normalizeRefillDateSelector(input: DateSelectorInput): NormalizedRefillDateSelector;
-export declare function refillDateSelectorBody(selector: NormalizedRefillDateSelector): {
-    targetDate?: string;
-    untilDate?: string;
-    horizonSendDays?: number;
-};
-export declare function dateWindowFromSelector(selector: NormalizedRefillDateSelector): RefillRunDateWindow;
-export declare function dateWindowFromPlan(plan: Record<string, unknown>, selector: NormalizedRefillDateSelector): RefillRunDateWindow;
-export declare function dateWindowFromRunState(runState: unknown): RefillRunDateWindow | null;
-export declare function selectorFromDateWindow(window: RefillRunDateWindow): NormalizedRefillDateSelector;
-export declare function dateSelectorMatchesWindow(selector: NormalizedRefillDateSelector, window: RefillRunDateWindow): boolean;
-export declare function schedulerSweepTargetDates(window: RefillRunDateWindow): string[];
-export {};

package/dist/refill-date-window.js

@@ -1,210 +0,0 @@
-function isRecord(value) {
-    return Boolean(value) && typeof value === "object" && !Array.isArray(value);
-}
-function stringValue(value) {
-    return typeof value === "string" && value.trim() ? value.trim() : null;
-}
-function numberValue(value) {
-    return typeof value === "number" && Number.isFinite(value) ? value : null;
-}
-function arrayValue(value) {
-    return Array.isArray(value) ? value : [];
-}
-function isValidDateKey(value) {
-    if (!/^\d{4}-\d{2}-\d{2}$/.test(value))
-        return false;
-    const [year, month, day] = value.split("-").map(Number);
-    const date = new Date(Date.UTC(year, month - 1, day));
-    return (date.getUTCFullYear() === year &&
-        date.getUTCMonth() === month - 1 &&
-        date.getUTCDate() === day);
-}
-function normalizeDateKey(value, field) {
-    if (value === undefined || value === null || value === "")
-        return null;
-    if (typeof value !== "string") {
-        throw new Error(`${field} must be a string in YYYY-MM-DD format.`);
-    }
-    const trimmed = value.trim();
-    if (!isValidDateKey(trimmed)) {
-        throw new Error(`${field} must be a valid YYYY-MM-DD calendar date.`);
-    }
-    return trimmed;
-}
-function normalizeHorizonSendDays(value) {
-    if (value === undefined)
-        return null;
-    if (typeof value !== "number" ||
-        !Number.isInteger(value) ||
-        value < 1 ||
-        value > 7) {
-        throw new Error("horizonSendDays must be an integer between 1 and 7.");
-    }
-    return value;
-}
-export function normalizeRefillDateSelector(input) {
-    const targetDate = normalizeDateKey(input.targetDate, "targetDate");
-    const untilDate = normalizeDateKey(input.untilDate, "untilDate");
-    const horizonSendDays = normalizeHorizonSendDays(input.horizonSendDays);
-    if (targetDate) {
-        return {
-            source: "target_date",
-            targetDate,
-            untilDate: null,
-            horizonSendDays: null,
-        };
-    }
-    if (untilDate) {
-        return {
-            source: "until_date",
-            targetDate: null,
-            untilDate,
-            horizonSendDays: null,
-        };
-    }
-    if (horizonSendDays !== null) {
-        return {
-            source: "horizon_send_days",
-            targetDate: null,
-            untilDate: null,
-            horizonSendDays,
-        };
-    }
-    return {
-        source: "default_scheduler_forward",
-        targetDate: null,
-        untilDate: null,
-        horizonSendDays: null,
-    };
-}
-export function refillDateSelectorBody(selector) {
-    if (selector.source === "target_date" && selector.targetDate) {
-        return { targetDate: selector.targetDate };
-    }
-    if (selector.source === "until_date" && selector.untilDate) {
-        return { untilDate: selector.untilDate };
-    }
-    if (selector.source === "horizon_send_days" &&
-        selector.horizonSendDays !== null) {
-        return { horizonSendDays: selector.horizonSendDays };
-    }
-    return {};
-}
-export function dateWindowFromSelector(selector) {
-    return {
-        version: 1,
-        ...selector,
-        selectedDates: selector.targetDate ? [selector.targetDate] : [],
-    };
-}
-function selectedDatesFromPlan(plan) {
-    const packet = isRecord(plan.packet) ? plan.packet : {};
-    const target = isRecord(packet.target) ? packet.target : {};
-    const window = isRecord(target.window) ? target.window : {};
-    const senderWindows = arrayValue(window.senderWindows).filter(isRecord);
-    const fromWindows = senderWindows.flatMap((senderWindow) => arrayValue(senderWindow.selectedDates)
-        .map((entry) => stringValue(entry))
-        .filter((entry) => Boolean(entry)));
-    if (fromWindows.length > 0)
-        return Array.from(new Set(fromWindows)).sort();
-    const senderRefillPlans = arrayValue(target.senderRefillPlans).filter(isRecord);
-    return Array.from(new Set(senderRefillPlans.flatMap((senderPlan) => {
-        const horizon = isRecord(senderPlan.horizon) ? senderPlan.horizon : {};
-        return arrayValue(horizon.selectedDays)
-            .filter(isRecord)
-            .map((day) => stringValue(day.date))
-            .filter((entry) => Boolean(entry));
-    }))).sort();
-}
-function senderWindowsFromPlan(plan) {
-    const packet = isRecord(plan.packet) ? plan.packet : {};
-    const target = isRecord(packet.target) ? packet.target : {};
-    const window = isRecord(target.window) ? target.window : {};
-    return arrayValue(window.senderWindows)
-        .filter(isRecord)
-        .map((senderWindow) => ({
-        senderId: stringValue(senderWindow.senderId),
-        timeZone: stringValue(senderWindow.timeZone),
-        selectedDates: arrayValue(senderWindow.selectedDates)
-            .map((entry) => stringValue(entry))
-            .filter((entry) => Boolean(entry)),
-    }));
-}
-export function dateWindowFromPlan(plan, selector) {
-    const packet = isRecord(plan.packet) ? plan.packet : {};
-    const request = isRecord(packet.request) ? packet.request : {};
-    const targetDate = stringValue(request.targetDate) ?? selector.targetDate ?? null;
-    const untilDate = stringValue(request.untilDate) ?? selector.untilDate ?? null;
-    const horizonSendDays = numberValue(request.horizonSendDays) ?? selector.horizonSendDays ?? null;
-    const source = targetDate
-        ? "target_date"
-        : untilDate
-            ? "until_date"
-            : horizonSendDays !== null
-                ? "horizon_send_days"
-                : selector.source;
-    const selectedDates = selectedDatesFromPlan(plan);
-    return {
-        version: 1,
-        source,
-        targetDate: source === "target_date" ? targetDate : null,
-        untilDate: source === "until_date" ? untilDate : null,
-        horizonSendDays: source === "horizon_send_days" ? horizonSendDays : null,
-        selectedDates: selectedDates.length > 0
-            ? selectedDates
-            : targetDate
-                ? [targetDate]
-                : [],
-        senderWindows: senderWindowsFromPlan(plan),
-    };
-}
-export function dateWindowFromRunState(runState) {
-    const state = isRecord(runState) ? runState : {};
-    const raw = isRecord(state.dateWindow) ? state.dateWindow : null;
-    if (!raw || raw.version !== 1)
-        return null;
-    const source = raw.source === "target_date" ||
-        raw.source === "until_date" ||
-        raw.source === "horizon_send_days" ||
-        raw.source === "default_scheduler_forward"
-        ? raw.source
-        : null;
-    if (!source)
-        return null;
-    return {
-        version: 1,
-        source,
-        targetDate: source === "target_date" ? stringValue(raw.targetDate) : null,
-        untilDate: source === "until_date" ? stringValue(raw.untilDate) : null,
-        horizonSendDays: source === "horizon_send_days"
-            ? numberValue(raw.horizonSendDays)
-            : null,
-        selectedDates: arrayValue(raw.selectedDates)
-            .map((entry) => stringValue(entry))
-            .filter((entry) => Boolean(entry)),
-    };
-}
-export function selectorFromDateWindow(window) {
-    return {
-        source: window.source,
-        targetDate: window.targetDate,
-        untilDate: window.untilDate,
-        horizonSendDays: window.horizonSendDays,
-    };
-}
-export function dateSelectorMatchesWindow(selector, window) {
-    return (selector.source === window.source &&
-        selector.targetDate === window.targetDate &&
-        selector.untilDate === window.untilDate &&
-        selector.horizonSendDays === window.horizonSendDays);
-}
-export function schedulerSweepTargetDates(window) {
-    if (window.source === "target_date" && window.targetDate) {
-        return [window.targetDate];
-    }
-    if (window.source === "until_date" ||
-        window.source === "horizon_send_days") {
-        return window.selectedDates;
-    }
-    return [];
-}

package/dist/tools/refill-sends-evergreen.d.ts

@@ -1,28 +0,0 @@
-type RefillSendsEvergreenInput = {
-    workspaceId?: string;
-};
-export declare const refillSendsEvergreenToolDefinitions: {
-    name: string;
-    description: string;
-    inputSchema: {
-        type: string;
-        properties: {
-            workspaceId: {
-                type: string;
-                description: string;
-            };
-        };
-        required: string[];
-        additionalProperties: boolean;
-    };
-}[];
-export declare function refillSendsEvergreenCommand(input: RefillSendsEvergreenInput): {
-    readOnly: boolean;
-    workspaceId: string | null;
-    firstOperationalSteps: string[];
-    approvalContract: string;
-    forbiddenActions: string[];
-    fillWindow: string;
-    hostExamples: string[];
-};
-export {};

package/dist/tools/refill-sends-evergreen.js

@@ -1,47 +0,0 @@
-export const refillSendsEvergreenToolDefinitions = [
-    {
-        name: "refill_sends_evergreen",
-        description: "Read-only Phase 85 evergreen refill command contract. It performs no mutations and only tells the operator to call get_evergreen_refill_plan for a dry-run packet and journal.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                workspaceId: {
-                    type: "string",
-                    description: "Explicit request-scoped workspace id.",
-                },
-            },
-            required: ["workspaceId"],
-            additionalProperties: false,
-        },
-    },
-];
-export function refillSendsEvergreenCommand(input) {
-    return {
-        readOnly: true,
-        workspaceId: input.workspaceId ?? null,
-        firstOperationalSteps: [
-            "Call get_evergreen_refill_plan with the explicit workspaceId.",
-            "Read the returned packet, globalActionQueue, per-sender plans, and itinerary before taking any action.",
-            "Review the dry-run journal file path returned by get_evergreen_refill_plan.",
-            "Phase 85 is PLAN-ONLY; execution arrives in Phase 86.",
-        ],
-        approvalContract: "Nothing is approved or executable in Phase 85. The evergreen command is read-only; Phase 86 introduces execution approval.",
-        forbiddenActions: [
-            "Do not schedule sends.",
-            "Do not send messages.",
-            "Do not approve messages.",
-            "Do not prepare messages.",
-            "Do not start or launch campaigns.",
-            "Do not create campaigns.",
-            "Do not switch providers or source families.",
-            "Do not lower paid InMail thresholds.",
-            "Do not refresh paid InMail credits.",
-            "Do not write scheduler fields.",
-        ],
-        fillWindow: "Use only the target window and caps returned by get_evergreen_refill_plan.",
-        hostExamples: [
-            "refill_sends_evergreen({ workspaceId })",
-            "get_evergreen_refill_plan({ workspaceId })",
-        ],
-    };
-}

package/skills/research/config.json

@@ -1,9 +0,0 @@
-{
-  "parallelMode": "wide",
-  "agentCount": 6,
-  "maxToolCallsPerAgent": 2,
-  "senderMaxAgents": 2,
-  "senderMaxToolCallsPerAgent": 3,
-  "progressMode": true,
-  "debugMode": true
-}