@sellable/mcp 0.1.510 → 0.1.512

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

@@ -0,0 +1,281 @@
+{
+  "version": "v1.0",
+  "workflow": "refill-sends-workflow",
+  "principle": "Use the target planner and scheduler readback as canonical facts. Refresh stale paid-InMail credit facts before scheduler-wait decisions; do not change scheduler allocation logic.",
+  "requiredBootstrap": [
+    {
+      "tool": "get_subskill_prompt",
+      "requiredValues": {
+        "subskillName": "refill-sends-workflow"
+      },
+      "mustReadUntil": {
+        "hasMore": false
+      }
+    },
+    {
+      "tool": "get_subskill_asset",
+      "requiredValues": {
+        "subskillName": "refill-sends-workflow",
+        "assetPath": "core/flow.v1.json"
+      },
+      "mustReadUntil": {
+        "hasMore": false
+      },
+      "validation": {
+        "workflow": "refill-sends-workflow",
+        "versionPrefix": "v1",
+        "requiredTopLevelKeys": [
+          "states",
+          "gateOrder",
+          "yoloMode"
+        ]
+      }
+    }
+  ],
+  "gateOrder": [
+    "target_plan_read",
+    "paid_inmail_credit_freshness_gate",
+    "target_action_selection",
+    "bounded_table_action",
+    "scheduler_wait_readback",
+    "completion_or_blocker"
+  ],
+  "sharedFacts": [
+    "workspaceId",
+    "senderId",
+    "campaignId",
+    "tableId",
+    "columnId",
+    "actionType",
+    "targetDate",
+    "untilDate",
+    "targetShapeRevision",
+    "stateRevision",
+    "paidInmail.status",
+    "paidInmail.available",
+    "paidInmail.threshold",
+    "paidInmail.maxStalenessSeconds",
+    "remainingProjectedGap",
+    "remainingReadyOrProjectedGap",
+    "readyToSchedule",
+    "scheduled",
+    "projected"
+  ],
+  "states": [
+    {
+      "id": "target_plan_read",
+      "description": "Read the canonical target plan before any mutation or wait loop.",
+      "allowedTools": [
+        "get_refill_target_plan"
+      ],
+      "requiredOutput": [
+        "target.eligibleSenderLedger",
+        "target.senderRefillPlans",
+        "target.globalActionQueue",
+        "targetShapeRevision",
+        "stateRevision"
+      ],
+      "transitions": [
+        {
+          "when": "status == complete",
+          "to": "completion_or_blocker"
+        },
+        {
+          "when": "any selected senderRefillPlans[].paidInmail.status is missing_credit_facts or stale_credit_facts",
+          "to": "paid_inmail_credit_freshness_gate"
+        },
+        {
+          "when": "globalActionQueue or actionCandidates contains refresh_paid_inmail_credits",
+          "to": "paid_inmail_credit_freshness_gate"
+        },
+        {
+          "otherwise": "target_action_selection"
+        }
+      ]
+    },
+    {
+      "id": "paid_inmail_credit_freshness_gate",
+      "description": "Make paid-InMail credit freshness deterministic before trusting scheduler wait decisions.",
+      "allowedTools": [
+        "refresh_paid_inmail_credits",
+        "get_refill_target_plan"
+      ],
+      "rules": [
+        "This gate precedes scheduler_wait_readback, even when remainingReadyOrProjectedGap is 0.",
+        "Refresh only exact sender ids present in the rendered target packet.",
+        "Refresh each selected sender at most once per refill_sends command call.",
+        "The refresh receipt must include approvalSource, workspaceId, senderId, actionKey, campaignId, tableId, columnId, threshold, maxStalenessSeconds, and targetPlanFingerprint.",
+        "After refresh, rerun get_refill_target_plan with the same workspaceId and selectors before choosing a prep, approval, source-copy, or scheduler-wait action.",
+        "If facts remain missing or stale after the single refresh attempt, stop with paid_inmail_credit_freshness_blocked rather than entering scheduler wait.",
+        "If fresh facts are below threshold, report the exact threshold blocker or same-campaign connection fallback; do not lower thresholds in yolo mode."
+      ],
+      "disallowedBeforeReread": [
+        "wait_for_scheduler",
+        "start_campaign_message_preparation",
+        "confirm_lead_list",
+        "select_campaign_cells",
+        "queue_campaign_cells",
+        "start_campaign"
+      ],
+      "transitions": [
+        {
+          "when": "post_refresh_target_plan has no missing/stale paid-InMail facts for selected lanes",
+          "to": "target_action_selection"
+        },
+        {
+          "when": "post_refresh_target_plan still has missing/stale paid-InMail facts",
+          "to": "completion_or_blocker"
+        }
+      ]
+    },
+    {
+      "id": "target_action_selection",
+      "description": "Choose only the globally ranked planner primitive after freshness gates pass.",
+      "allowedTools": [
+        "get_refill_target_plan",
+        "get_campaign_refill_state",
+        "get_scheduler_fill_capacity"
+      ],
+      "rules": [
+        "Use target.globalActionQueue[0] as the only cross-sender yolo action.",
+        "manualAlternates are not yolo actions.",
+        "If projected coverage is complete, no-op.",
+        "If remainingReadyOrProjectedGap is 0 and remainingProjectedGap is positive, scheduler wait is allowed only after paid_inmail_credit_freshness_gate is clean.",
+        "If ready buffer is short, choose bounded existing-row prep, bounded approval, same-source copy, or provider-aligned source-more according to the planner."
+      ],
+      "transitions": [
+        {
+          "when": "next action is wait_for_scheduler and paid freshness gate is clean",
+          "to": "scheduler_wait_readback"
+        },
+        {
+          "when": "next action is a bounded table/source/prep/approval primitive",
+          "to": "bounded_table_action"
+        },
+        {
+          "when": "no safe action remains or non-scheduler blocker exists",
+          "to": "completion_or_blocker"
+        }
+      ]
+    },
+    {
+      "id": "bounded_table_action",
+      "description": "Run one safe primitive, then reread the target plan.",
+      "allowedTools": [
+        "start_campaign_message_preparation",
+        "get_campaign_message_preparation_status",
+        "import_leads",
+        "wait_for_lead_list_ready",
+        "confirm_lead_list",
+        "select_campaign_cells",
+        "queue_campaign_cells",
+        "wait_for_campaign_processing",
+        "get_refill_target_plan"
+      ],
+      "rules": [
+        "One primitive per loop.",
+        "No broad approval.",
+        "No scheduler writes.",
+        "Reread get_refill_target_plan before any second primitive.",
+        "Continue while targetShapeRevision is stable and projected coverage progresses."
+      ],
+      "transitions": [
+        {
+          "after": "terminal primitive result and target reread",
+          "to": "target_plan_read"
+        }
+      ]
+    },
+    {
+      "id": "scheduler_wait_readback",
+      "description": "Read-only scheduler polling after rows are ready and paid-credit facts are fresh.",
+      "allowedTools": [
+        "get_refill_target_plan",
+        "get_scheduler_fill_capacity"
+      ],
+      "entryConditions": [
+        "remainingReadyOrProjectedGap == 0",
+        "remainingProjectedGap > 0",
+        "no selected paid-InMail lane has missing_credit_facts or stale_credit_facts",
+        "no refresh_paid_inmail_credits action remains in target.globalActionQueue or actionCandidates"
+      ],
+      "rules": [
+        "Poll every 60-120 seconds or on the host continuation interval.",
+        "Stop waiting when projected coverage fills the target.",
+        "Leave wait if a concrete non-scheduler blocker appears.",
+        "Do not mark complete or blocked only because awaiting_scheduler_after_ready_buffer persists."
+      ],
+      "transitions": [
+        {
+          "when": "projected coverage fills target",
+          "to": "completion_or_blocker"
+        },
+        {
+          "when": "paid facts become missing/stale again",
+          "to": "paid_inmail_credit_freshness_gate"
+        },
+        {
+          "when": "ready buffer no longer covers gap",
+          "to": "target_action_selection"
+        }
+      ]
+    },
+    {
+      "id": "completion_or_blocker",
+      "description": "Report exact no-op, completion proof, or blocker with ids and revisions.",
+      "allowedTools": [
+        "get_refill_target_plan",
+        "get_campaign_refill_state",
+        "get_scheduler_fill_capacity"
+      ],
+      "terminal": true
+    }
+  ],
+  "yoloMode": {
+    "approvalSource": "explicit_yolo_flag",
+    "autoExecutableActions": [
+      "refresh_paid_inmail_credits",
+      "start_campaign_message_preparation",
+      "same_source_copy",
+      "bounded_generated_message_approval",
+      "wait_for_scheduler"
+    ],
+    "neverAutoExecute": [
+      "lower_paid_inmail_threshold",
+      "create_campaign",
+      "create_connection_campaign",
+      "switch_source_family",
+      "direct_scheduler_write",
+      "start_unselected_campaign",
+      "archive_or_delete"
+    ],
+    "driftStops": [
+      "workspaceId",
+      "sender set",
+      "campaignId",
+      "tableId",
+      "columnId",
+      "actionType",
+      "targetDate",
+      "untilDate",
+      "targetShapeRevision",
+      "paid-InMail threshold feasibility",
+      "side-effect class"
+    ]
+  },
+  "verification": {
+    "requiredProof": [
+      "final get_refill_target_plan",
+      "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"
+    ],
+    "notCompletionProof": [
+      "prepared rows alone",
+      "approved rows alone",
+      "ready-to-schedule rows alone",
+      "awaiting_scheduler_after_ready_buffer"
+    ]
+  }
+}