@sellable/mcp 0.1.554 → 0.1.556

package/skills/refill-sends-workflow/core/contract.v2.json

@@ -0,0 +1,543 @@
+{
+  "contractVersion": "2.0.0",
+  "cacheVersion": "refill-contract-v1",
+  "supportedMajor": 2,
+  "semantics": {
+    "scope": [
+      {
+        "id": "workspace_id"
+      },
+      {
+        "id": "target_date"
+      },
+      {
+        "id": "sender_selectors"
+      },
+      {
+        "id": "campaign_selectors"
+      },
+      {
+        "id": "approval_mode"
+      },
+      {
+        "id": "contract_identity"
+      },
+      {
+        "id": "installed_identity"
+      }
+    ],
+    "gates": [
+      {
+        "id": "workspace_access"
+      },
+      {
+        "id": "approval_packet"
+      },
+      {
+        "id": "source_family"
+      },
+      {
+        "id": "threshold"
+      },
+      {
+        "id": "scheduler"
+      },
+      {
+        "id": "campaign_lifecycle"
+      },
+      {
+        "id": "send_time"
+      },
+      {
+        "id": "no_direct_send"
+      },
+      {
+        "id": "one_primitive"
+      },
+      {
+        "id": "fresh_reread"
+      },
+      {
+        "id": "normalized_accounting"
+      },
+      {
+        "id": "prep_circuit"
+      },
+      {
+        "id": "terminal_truth"
+      }
+    ],
+    "states": [
+      {
+        "id": "planning"
+      },
+      {
+        "id": "awaiting_approval"
+      },
+      {
+        "id": "executing"
+      },
+      {
+        "id": "settling"
+      },
+      {
+        "id": "replanning"
+      },
+      {
+        "id": "terminal"
+      }
+    ],
+    "actions": [
+      {
+        "id": "prepare_messages",
+        "sideEffectClass": "message_preparation"
+      },
+      {
+        "id": "approve_messages",
+        "sideEffectClass": "message_approval"
+      },
+      {
+        "id": "rerun_errored_cells",
+        "sideEffectClass": "message_preparation"
+      },
+      {
+        "id": "start_paused_campaign",
+        "sideEffectClass": "campaign_start"
+      },
+      {
+        "id": "run_scheduler_sweep",
+        "sideEffectClass": "scheduler_placement"
+      },
+      {
+        "id": "scheduler_first_settle",
+        "sideEffectClass": "read_only"
+      },
+      {
+        "id": "wait_for_scheduler",
+        "sideEffectClass": "read_only"
+      },
+      {
+        "id": "wait_for_active_work",
+        "sideEffectClass": "read_only"
+      },
+      {
+        "id": "wait_for_source_import",
+        "sideEffectClass": "read_only"
+      },
+      {
+        "id": "copy_selected_source_rows",
+        "sideEffectClass": "source_replenishment"
+      },
+      {
+        "id": "continue_signal_discovery_source",
+        "sideEffectClass": "source_replenishment"
+      },
+      {
+        "id": "continue_sales_nav_source",
+        "sideEffectClass": "source_replenishment"
+      },
+      {
+        "id": "continue_prospeo_source",
+        "sideEffectClass": "source_replenishment"
+      },
+      {
+        "id": "manual_source_replenishment",
+        "sideEffectClass": "source_replenishment"
+      },
+      {
+        "id": "refresh_paid_inmail_credits",
+        "sideEffectClass": "credit_refresh"
+      },
+      {
+        "id": "lower_paid_inmail_threshold",
+        "sideEffectClass": "read_only"
+      },
+      {
+        "id": "switch_to_connection_lane",
+        "sideEffectClass": "read_only"
+      },
+      {
+        "id": "create_connection_campaign",
+        "sideEffectClass": "read_only"
+      },
+      {
+        "id": "next_campaign",
+        "sideEffectClass": "read_only"
+      },
+      {
+        "id": "done",
+        "sideEffectClass": "read_only"
+      }
+    ],
+    "receipts": [
+      {
+        "id": "target_plan_receipt",
+        "requiredFields": [
+          "refillLaneKey",
+          "branchMetrics",
+          "ledger",
+          "targetDate",
+          "actionKey",
+          "targetShapeRevision",
+          "stateRevision"
+        ]
+      },
+      {
+        "id": "preparation_receipt",
+        "requiredFields": [
+          "dependency",
+          "circuit",
+          "batchCalibration",
+          "cooperativeStop"
+        ]
+      },
+      {
+        "id": "scheduler_receipt",
+        "requiredFields": [
+          "receiptVersion",
+          "diagnosticsVersion",
+          "status",
+          "trigger",
+          "workspaceId",
+          "runId",
+          "leaseFence",
+          "expectedTargetsHash",
+          "maxPlacements",
+          "readyCellsFound",
+          "cellsConsidered",
+          "cellsScheduled",
+          "cellsSkipped",
+          "cellsDeferred",
+          "campaignScopeSummary",
+          "expectedTargetSummary",
+          "changedCounts",
+          "summary",
+          "nextAction",
+          "errorCount",
+          "error"
+        ]
+      },
+      {
+        "id": "run_receipt",
+        "requiredFields": [
+          "runId",
+          "fence",
+          "gate",
+          "gateSeq",
+          "events",
+          "doneReason"
+        ]
+      }
+    ],
+    "sideEffectClasses": [
+      {
+        "id": "read_only"
+      },
+      {
+        "id": "message_preparation"
+      },
+      {
+        "id": "message_approval"
+      },
+      {
+        "id": "source_replenishment"
+      },
+      {
+        "id": "credit_refresh"
+      },
+      {
+        "id": "campaign_start"
+      },
+      {
+        "id": "scheduler_placement"
+      }
+    ],
+    "forbiddenActions": [
+      {
+        "id": "direct_send"
+      },
+      {
+        "id": "raw_scheduler_write"
+      },
+      {
+        "id": "campaign_create"
+      },
+      {
+        "id": "campaign_archive_delete"
+      },
+      {
+        "id": "threshold_lowering"
+      },
+      {
+        "id": "unselected_source_mutation"
+      },
+      {
+        "id": "unapproved_campaign_start"
+      },
+      {
+        "id": "sender_config_write"
+      }
+    ],
+    "terminalReasons": [
+      {
+        "id": "projected_full",
+        "terminalKind": "complete"
+      },
+      {
+        "id": "concrete_blocker",
+        "terminalKind": "stopped"
+      },
+      {
+        "id": "deadline_reached",
+        "terminalKind": "stopped"
+      },
+      {
+        "id": "iteration_limit",
+        "terminalKind": "stopped"
+      },
+      {
+        "id": "operator_stopped",
+        "terminalKind": "stopped"
+      },
+      {
+        "id": "capped_by_scheduler",
+        "terminalKind": "stopped"
+      },
+      {
+        "id": "loaded_awaiting_scheduler",
+        "terminalKind": "stopped"
+      },
+      {
+        "id": "lanes_exhausted",
+        "terminalKind": "stopped"
+      },
+      {
+        "id": "not_an_evergreen_workspace",
+        "terminalKind": "stopped"
+      },
+      {
+        "id": "no_refillable_campaigns",
+        "terminalKind": "stopped"
+      }
+    ],
+    "transitions": [
+      {
+        "from": "planning",
+        "to": "awaiting_approval"
+      },
+      {
+        "from": "awaiting_approval",
+        "to": "executing"
+      },
+      {
+        "from": "executing",
+        "to": "settling"
+      },
+      {
+        "from": "settling",
+        "to": "replanning"
+      },
+      {
+        "from": "replanning",
+        "to": "executing"
+      },
+      {
+        "from": "replanning",
+        "to": "terminal"
+      }
+    ]
+  },
+  "backendBindings": {
+    "planner": {
+      "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"
+      ],
+      "receiptFields": [
+        "refillLaneKey",
+        "branchMetrics",
+        "ledger",
+        "targetDate",
+        "actionKey",
+        "targetShapeRevision",
+        "stateRevision"
+      ]
+    },
+    "preparation": {
+      "dependencyClasses": [
+        "active",
+        "transient",
+        "permanent",
+        "changed",
+        "exhausted"
+      ],
+      "dependencyReasons": [
+        "active_cells",
+        "dependency_timeout",
+        "rate_limited",
+        "provider_unavailable",
+        "authentication_failed",
+        "validation_failed",
+        "schema_invalid",
+        "config_epoch_changed",
+        "source_epoch_changed",
+        "frontier_exhausted",
+        "unknown_dependency"
+      ],
+      "circuitStates": [
+        "closed",
+        "open",
+        "half_open",
+        "reset"
+      ],
+      "cooperativeStopReasons": [
+        "target_satisfied_during_prep"
+      ],
+      "receiptFields": [
+        "dependency",
+        "circuit",
+        "batchCalibration",
+        "cooperativeStop"
+      ]
+    },
+    "scheduler": {
+      "targetOutcomes": [
+        "included",
+        "omitted"
+      ],
+      "omissionReasons": [
+        "no_ready_cells",
+        "not_scheduler_eligible",
+        "sender_mismatch",
+        "capacity_prefiltered",
+        "outside_target_date",
+        "receipt_error"
+      ],
+      "runStatuses": [
+        "ran",
+        "window_closed_noop",
+        "failed"
+      ],
+      "nextActions": [
+        "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"
+      ],
+      "receiptFields": [
+        "receiptVersion",
+        "diagnosticsVersion",
+        "status",
+        "trigger",
+        "workspaceId",
+        "runId",
+        "leaseFence",
+        "expectedTargetsHash",
+        "maxPlacements",
+        "readyCellsFound",
+        "cellsConsidered",
+        "cellsScheduled",
+        "cellsSkipped",
+        "cellsDeferred",
+        "campaignScopeSummary",
+        "expectedTargetSummary",
+        "changedCounts",
+        "summary",
+        "nextAction",
+        "errorCount",
+        "error"
+      ]
+    },
+    "run": {
+      "gates": [
+        "g0_bootstrap",
+        "g1_plan",
+        "g2_execute",
+        "g3_verify",
+        "g4_terminal"
+      ],
+      "states": [
+        "planning",
+        "awaiting_approval",
+        "executing",
+        "settling",
+        "replanning",
+        "terminal"
+      ],
+      "resultKinds": [
+        "started",
+        "awaiting_approval",
+        "active_run_in_progress",
+        "resumed",
+        "lease_lost",
+        "scope_drift",
+        "approval_expired",
+        "approval_fingerprint_mismatch"
+      ],
+      "terminalReasons": [
+        "complete",
+        "capped_by_scheduler",
+        "loaded_awaiting_scheduler",
+        "lanes_exhausted",
+        "blocked",
+        "not_an_evergreen_workspace",
+        "no_refillable_campaigns"
+      ],
+      "refusals": [
+        "scope_drift",
+        "approval_expired",
+        "approval_fingerprint_mismatch",
+        "legacy_read_only",
+        "expected_target_overflow",
+        "scheduler_receipt_incomplete"
+      ],
+      "scopeFields": [
+        "workspaceId",
+        "intent",
+        "senderIds",
+        "campaignIds",
+        "tableIds",
+        "actionIds",
+        "approvalMode",
+        "dateSelector",
+        "senderTimezones",
+        "expectedTargetsHash",
+        "maxPlacements",
+        "contract",
+        "installed"
+      ],
+      "approvalFields": [
+        "scopeHash",
+        "targetShapeRevision",
+        "actionFingerprint",
+        "expectedTargetsHash",
+        "sideEffectEnvelope",
+        "maxPlacements",
+        "approvalExpiresAt",
+        "approvalFingerprint"
+      ]
+    }
+  },
+  "contractHash": "e54ba0f80bc534fd70fd8c10c1caab109fe9a91c205cfc423f5f6735cd53fdc1"
+}