@sellable/mcp 0.1.555 → 0.1.557

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

@@ -30,22 +30,6 @@
           "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": [
@@ -77,44 +61,6 @@
     "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",
@@ -242,7 +188,7 @@
     },
     {
       "id": "scheduler_wait_readback",
-      "description": "Exact-date scheduler sweep or read-only polling after rows are ready and paid-credit facts are fresh.",
+      "description": "Read-only scheduler polling after rows are ready and paid-credit facts are fresh.",
       "allowedTools": [
         "get_refill_target_plan",
         "get_scheduler_fill_capacity",
@@ -257,9 +203,6 @@
       "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.",
@@ -268,11 +211,6 @@
         "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"
@@ -305,7 +243,6 @@
       "start_campaign_message_preparation",
       "same_source_copy",
       "bounded_generated_message_approval",
-      "run_scheduler_sweep",
       "wait_for_scheduler"
     ],
     "neverAutoExecute": [
@@ -334,137 +271,16 @@
   "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-contract.d.ts

@@ -1,157 +0,0 @@
-export declare const REFILL_CONTRACT_VERSION: "2.0.0";
-export declare const REFILL_CONTRACT_CACHE_VERSION: "refill-contract-v1";
-export declare const REFILL_CONTRACT_SUPPORTED_MAJOR: 2;
-export declare const REFILL_CONTRACT_ERROR_CODES: readonly ["refill_contract_not_implemented", "unsupported_refill_contract_major", "refill_contract_hash_mismatch", "refill_contract_semantic_mismatch"];
-export type RefillContractErrorCode = (typeof REFILL_CONTRACT_ERROR_CODES)[number];
-export declare class RefillContractError extends Error {
-    readonly code: RefillContractErrorCode;
-    constructor(code: RefillContractErrorCode, message: string);
-}
-export declare const REFILL_SCOPE_IDS: readonly ["workspace_id", "target_date", "sender_selectors", "campaign_selectors", "approval_mode", "contract_identity", "installed_identity"];
-export declare const REFILL_GATE_IDS: readonly ["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"];
-export declare const REFILL_STATE_IDS: readonly ["planning", "awaiting_approval", "executing", "settling", "replanning", "terminal"];
-export declare const REFILL_ACTION_IDS: readonly ["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"];
-export declare const REFILL_RECEIPT_IDS: readonly ["target_plan_receipt", "preparation_receipt", "scheduler_receipt", "run_receipt"];
-export declare const REFILL_SIDE_EFFECT_CLASS_IDS: readonly ["read_only", "message_preparation", "message_approval", "source_replenishment", "credit_refresh", "campaign_start", "scheduler_placement"];
-export declare const REFILL_FORBIDDEN_ACTION_IDS: readonly ["direct_send", "raw_scheduler_write", "campaign_create", "campaign_archive_delete", "threshold_lowering", "unselected_source_mutation", "unapproved_campaign_start", "sender_config_write"];
-export declare const REFILL_TERMINAL_REASON_IDS: readonly ["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"];
-export type RefillScopeId = (typeof REFILL_SCOPE_IDS)[number];
-export type RefillGateId = (typeof REFILL_GATE_IDS)[number];
-export type RefillStateId = (typeof REFILL_STATE_IDS)[number];
-export type RefillActionId = (typeof REFILL_ACTION_IDS)[number];
-export type RefillReceiptId = (typeof REFILL_RECEIPT_IDS)[number];
-export type RefillSideEffectClassId = (typeof REFILL_SIDE_EFFECT_CLASS_IDS)[number];
-export type RefillForbiddenActionId = (typeof REFILL_FORBIDDEN_ACTION_IDS)[number];
-export type RefillTerminalReasonId = (typeof REFILL_TERMINAL_REASON_IDS)[number];
-export type RefillAction = {
-    [Kind in RefillActionId]: {
-        kind: Kind;
-        actionKey: string;
-        sideEffectClass: RefillSideEffectClassId;
-    };
-}[RefillActionId];
-export type RefillReceipt = {
-    [Kind in RefillReceiptId]: {
-        kind: Kind;
-        actionKey: string;
-        recordedAt: string;
-    };
-}[RefillReceiptId];
-export type RefillTerminal = {
-    [Reason in RefillTerminalReasonId]: {
-        kind: "terminal";
-        reason: Reason;
-        evidence: Record<string, unknown>;
-    };
-}[RefillTerminalReasonId];
-export declare function canonicalizeRefillContract(value: unknown): string;
-export declare function computeRefillContractHash(value: unknown): string;
-export declare const REFILL_CONTRACT_HASH: string;
-export declare const refillContract: {
-    readonly contractHash: string;
-    readonly contractVersion: "2.0.0";
-    readonly cacheVersion: "refill-contract-v1";
-    readonly supportedMajor: 2;
-    readonly semantics: {
-        readonly scope: {
-            id: "workspace_id" | "target_date" | "sender_selectors" | "campaign_selectors" | "approval_mode" | "contract_identity" | "installed_identity";
-        }[];
-        readonly gates: {
-            id: "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";
-        }[];
-        readonly states: {
-            id: "planning" | "awaiting_approval" | "executing" | "settling" | "replanning" | "terminal";
-        }[];
-        readonly actions: {
-            id: "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";
-            sideEffectClass: "read_only" | "message_preparation" | "message_approval" | "source_replenishment" | "credit_refresh" | "campaign_start" | "scheduler_placement";
-        }[];
-        readonly receipts: readonly [{
-            readonly id: "target_plan_receipt";
-            readonly requiredFields: readonly ["refillLaneKey", "branchMetrics", "ledger", "targetDate", "actionKey", "targetShapeRevision", "stateRevision"];
-        }, {
-            readonly id: "preparation_receipt";
-            readonly requiredFields: readonly ["dependency", "circuit", "batchCalibration", "cooperativeStop"];
-        }, {
-            readonly id: "scheduler_receipt";
-            readonly requiredFields: readonly ["receiptVersion", "diagnosticsVersion", "status", "trigger", "workspaceId", "runId", "leaseFence", "expectedTargetsHash", "maxPlacements", "readyCellsFound", "cellsConsidered", "cellsScheduled", "cellsSkipped", "cellsDeferred", "campaignScopeSummary", "expectedTargetSummary", "changedCounts", "summary", "nextAction", "errorCount", "error"];
-        }, {
-            readonly id: "run_receipt";
-            readonly requiredFields: readonly ["runId", "fence", "gate", "gateSeq", "events", "doneReason"];
-        }];
-        readonly sideEffectClasses: {
-            id: "read_only" | "message_preparation" | "message_approval" | "source_replenishment" | "credit_refresh" | "campaign_start" | "scheduler_placement";
-        }[];
-        readonly forbiddenActions: {
-            id: "direct_send" | "raw_scheduler_write" | "campaign_create" | "campaign_archive_delete" | "threshold_lowering" | "unselected_source_mutation" | "unapproved_campaign_start" | "sender_config_write";
-        }[];
-        readonly terminalReasons: {
-            id: "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";
-            terminalKind: string;
-        }[];
-        readonly transitions: readonly [{
-            readonly from: "planning";
-            readonly to: "awaiting_approval";
-        }, {
-            readonly from: "awaiting_approval";
-            readonly to: "executing";
-        }, {
-            readonly from: "executing";
-            readonly to: "settling";
-        }, {
-            readonly from: "settling";
-            readonly to: "replanning";
-        }, {
-            readonly from: "replanning";
-            readonly to: "executing";
-        }, {
-            readonly from: "replanning";
-            readonly to: "terminal";
-        }];
-    };
-    readonly backendBindings: {
-        readonly planner: {
-            readonly 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")[];
-            readonly receiptFields: readonly ["refillLaneKey", "branchMetrics", "ledger", "targetDate", "actionKey", "targetShapeRevision", "stateRevision"];
-        };
-        readonly preparation: {
-            readonly dependencyClasses: readonly ["active", "transient", "permanent", "changed", "exhausted"];
-            readonly dependencyReasons: readonly ["active_cells", "dependency_timeout", "rate_limited", "provider_unavailable", "authentication_failed", "validation_failed", "schema_invalid", "config_epoch_changed", "source_epoch_changed", "frontier_exhausted", "unknown_dependency"];
-            readonly circuitStates: readonly ["closed", "open", "half_open", "reset"];
-            readonly cooperativeStopReasons: readonly ["target_satisfied_during_prep"];
-            readonly receiptFields: readonly ["dependency", "circuit", "batchCalibration", "cooperativeStop"];
-        };
-        readonly scheduler: {
-            readonly targetOutcomes: readonly ["included", "omitted"];
-            readonly omissionReasons: readonly ["no_ready_cells", "not_scheduler_eligible", "sender_mismatch", "capacity_prefiltered", "outside_target_date", "receipt_error"];
-            readonly runStatuses: readonly ["ran", "window_closed_noop", "failed"];
-            readonly nextActions: readonly ["refresh_paid_inmail_credits_then_rerun", "wait_for_capacity_or_window", "inspect_sender_mismatch", "no_ready_cells_continue_refill_prep", "scheduled_cells", "investigate_deferred_reasons", "investigate_scheduler_failure"];
-            readonly receiptFields: readonly ["receiptVersion", "diagnosticsVersion", "status", "trigger", "workspaceId", "runId", "leaseFence", "expectedTargetsHash", "maxPlacements", "readyCellsFound", "cellsConsidered", "cellsScheduled", "cellsSkipped", "cellsDeferred", "campaignScopeSummary", "expectedTargetSummary", "changedCounts", "summary", "nextAction", "errorCount", "error"];
-        };
-        readonly run: {
-            readonly gates: readonly ["g0_bootstrap", "g1_plan", "g2_execute", "g3_verify", "g4_terminal"];
-            readonly states: readonly ["planning", "awaiting_approval", "executing", "settling", "replanning", "terminal"];
-            readonly resultKinds: readonly ["started", "awaiting_approval", "active_run_in_progress", "resumed", "lease_lost", "scope_drift", "approval_expired", "approval_fingerprint_mismatch"];
-            readonly terminalReasons: readonly ["complete", "capped_by_scheduler", "loaded_awaiting_scheduler", "lanes_exhausted", "blocked", "not_an_evergreen_workspace", "no_refillable_campaigns"];
-            readonly refusals: readonly ["scope_drift", "approval_expired", "approval_fingerprint_mismatch", "legacy_read_only", "expected_target_overflow", "scheduler_receipt_incomplete"];
-            readonly scopeFields: readonly ["workspaceId", "intent", "senderIds", "campaignIds", "tableIds", "actionIds", "approvalMode", "dateSelector", "senderTimezones", "expectedTargetsHash", "maxPlacements", "contract", "installed"];
-            readonly approvalFields: readonly ["scopeHash", "targetShapeRevision", "actionFingerprint", "expectedTargetsHash", "sideEffectEnvelope", "maxPlacements", "approvalExpiresAt", "approvalFingerprint"];
-        };
-    };
-};
-export type RefillContract = typeof refillContract;
-export declare function assertSupportedRefillContractMajor(version: string): void;
-export declare function validateRefillContractAsset(value: unknown): RefillContract;
-export declare function refillContractSemanticProjection(): {
-    contractVersion: "2.0.0";
-    cacheVersion: "refill-contract-v1";
-    contractHash: string;
-    semanticIds: {
-        [k: string]: string[];
-    };
-};
-export declare function validateRefillFlowProjection(value: unknown): void;
-export declare function renderRefillBootstrapGuidance(): string;
-export declare function renderRefillSafetyGuidance(): string;
-export declare function renderRefillTerminalGuidance(): string;
-export declare function assertNeverRefillVariant(value: never): never;