@sellable/mcp 0.1.768 → 0.1.769

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

@@ -1,397 +0,0 @@
-{
-  "version": "v1.0",
-  "workflow": "refill-sends-v2-workflow",
-  "principle": "Execute refill sends v2 through a fenced run record: bootstrap, plan, execute, verify, and report. Dry runs stay read-only; real runs execute only packet-named bounded work.",
-  "revisionProjectionContract": {
-    "action": "revise_message_template_and_rerun",
-    "requiredAuthorities": [
-      "targetConfig",
-      "runHandle",
-      "reportingContext",
-      "messageTemplateRevision.source:user_approved",
-      "messageTemplateRevision.templateMarkdown",
-      "messageTemplateRevision.priorTemplateAuthorityDigest",
-      "messageTemplateRevision.nextTemplateAuthorityDigest",
-      "messageTemplateRevision.cohortRowIds[1..500]",
-      "messageTemplateRevision.requestId",
-      "messageTemplateRevision.effectId",
-      "messageTemplateRevision.revisionOperationId"
-    ],
-    "noInference": "Absent or partial messageTemplateRevision means no revision; forceRerun never synthesizes authority.",
-    "continuation": "Preserve targetConfig and the server runHandle separately through resume/takeover, journal, outcome, replay, and terminal report.",
-    "reporting": "Preserve refill_reporting.v2 exactly, including live epoch/sequence/reset/watermark, semantic counts, blockers, compatibility, and terminal outcome; redact raw copy/prospect fields."
-  },
-  "laneSources": [
-    "managed_waterfall",
-    "dashboard_evergreen",
-    "active_campaign"
-  ],
-  "terminalReasons": [
-    "complete",
-    "capped_by_scheduler",
-    "loaded_awaiting_scheduler",
-    "lanes_exhausted",
-    "blocked",
-    "no_refillable_campaigns",
-    "not_an_evergreen_workspace"
-  ],
-  "blockers": ["workspace_access"],
-  "enumeratedRungs": [
-    "start_campaign",
-    "approve_messages",
-    "wait_for_active_work",
-    "enrich_more",
-    "reconcile_source_copy",
-    "rerun_errored_cells",
-    "add_leads_same_source",
-    "paid_lane_fallback",
-    "next_campaign",
-    "wait_for_scheduler",
-    "done"
-  ],
-  "rungLabels": {
-    "start_campaign": "start the paused campaign so ready rows can schedule",
-    "approve_messages": "approve generated messages that are ready for review",
-    "wait_for_active_work": "wait for active campaign work to finish",
-    "enrich_more": "enrich the next batch of unenriched rows",
-    "reconcile_source_copy": "copy leads already found into the campaign table",
-    "add_leads_same_source": "find more leads via this campaign's original source",
-    "paid_lane_fallback": "move paid InMail demand to the connection fallback lane",
-    "next_campaign": "move to the next campaign in the lane",
-    "wait_for_scheduler": "wait for the scheduler to pick up ready rows",
-    "done": "finish the refill run",
-    "rerun_errored_cells": "re-run errored enrichment/message cells"
-  },
-  "hardRules": [
-    "dry-runs write journals only and never create run records",
-    "execute only the packet fingerprint captured at the last plan gate",
-    "validate packet coherence before dispatch; replan once, then block packet_incoherent",
-    "repair rungs come from the plan packet; the loop bounds and refuses, never self-emits repair actions",
-    "capped_by_scheduler is complete, never poll",
-    "awaiting scheduler is not an end state; window-closed reports name remaining-ready, expected pickup time, and resume handle",
-    "honest-rubric-fail means a human updates the rubric or changes lead source",
-    "source replenishment beyond same-source-automatic is a scoped create-campaign handoff, never refill-owned provider search",
-    "connection-only evergreen lanes with exact [\"send_invite\"] proof are invite-only refill capacity; never infer DM, InMail, Sales Nav cascade, paid-credit refresh, message generation, follow-up, sequence mutation, scheduler writes, launch, or send work from them",
-    "revise_message_template_and_rerun is allowed only as the exact packet head backed by the complete explicit user-approved revision projection contract",
-    "no campaign creation, provider-family switch, threshold lowering, scheduler writes, sends, archives, deletes, or brief/filter/message/sequence/sender mutation without a separate approval packet"
-  ],
-  "requiredBootstrap": [
-    {
-      "tool": "get_auth_status",
-      "purpose": "Confirm MCP auth before reading workspace or starting a refill run."
-    },
-    {
-      "tool": "get_active_workspace",
-      "purpose": "Resolve explicit workspace evidence when the request did not provide workspaceId."
-    },
-    {
-      "tool": "refill_sends_v2",
-      "requiredValues": {
-        "workspaceId": "{workspaceId}"
-      },
-      "requiredOutput": [
-        "terminal, in_progress, blocked, or dry_run status",
-        "resume handle {runId, fence, gate} when in_progress"
-      ]
-    },
-    {
-      "tool": "get_subskill_prompt",
-      "requiredValues": {
-        "subskillName": "refill-sends-v2-workflow"
-      },
-      "mustReadUntil": {
-        "hasMore": false
-      }
-    },
-    {
-      "tool": "get_subskill_asset",
-      "requiredValues": {
-        "subskillName": "refill-sends-v2-workflow",
-        "assetPath": "core/flow.v1.json"
-      },
-      "mustReadUntil": {
-        "hasMore": false
-      },
-      "validation": {
-        "workflow": "refill-sends-v2-workflow",
-        "versionPrefix": "v1",
-        "requiredTopLevelKeys": [
-          "states",
-          "gateOrder",
-          "enumeratedRungs",
-          "rungLabels",
-          "verification",
-          "laneSources",
-          "terminalReasons",
-          "blockers",
-          "hardRules"
-        ]
-      }
-    },
-    {
-      "tool": "get_refill_plan_v2",
-      "requiredValues": {
-        "workspaceId": "{workspaceId}",
-        "intent": "auto"
-      },
-      "requiredOutput": [
-        "planRevision or workspace_access blocker",
-        "stateRevision",
-        "packet with supplyCensus/censusReason when available",
-        "pipelineDiagnosis checklist when blocked",
-        "sideEffects"
-      ]
-    }
-  ],
-  "gateOrder": ["bootstrap", "plan", "execute", "verify", "report"],
-  "states": [
-    {
-      "id": "bootstrap",
-      "description": "Load the command contract, workflow prompt, flow asset, and workspace facts. A real run starts or resumes a fenced run record; dryRun:true stays read-only and journal-only.",
-      "allowedTools": [
-        "get_auth_status",
-        "get_active_workspace",
-        "list_workspaces",
-        "get_workspace",
-        "refill_sends_v2",
-        "get_subskill_prompt",
-        "get_subskill_asset",
-        "get_refill_plan_v2"
-      ],
-      "onEnter": [
-        {
-          "tool": "get_auth_status"
-        },
-        {
-          "tool": "refill_sends_v2",
-          "requiredFields": ["workspaceId"]
-        },
-        {
-          "tool": "get_subskill_prompt",
-          "requiredValues": {
-            "subskillName": "refill-sends-v2-workflow"
-          }
-        },
-        {
-          "tool": "get_subskill_asset",
-          "requiredValues": {
-            "subskillName": "refill-sends-v2-workflow",
-            "assetPath": "core/flow.v1.json"
-          }
-        }
-      ],
-      "transitions": {
-        "contract_loaded": "plan",
-        "resume_handle_loaded": "verify",
-        "dry_run_requested": "report"
-      }
-    },
-    {
-      "id": "plan",
-      "description": "Read a fresh get_refill_plan_v2 packet with runState fed back from the run record. The loop captures planRevision, stateRevision, and targetShapeRevision, then validates packet coherence before dispatch. The packet's supplyCensus, censusReason, and pipelineDiagnosis checklist explain the rung choice. If packet_incoherent appears, replan once; a second incoherent packet blocks.",
-      "allowedTools": ["get_refill_plan_v2"],
-      "onEnter": [
-        {
-          "tool": "get_refill_plan_v2",
-          "requiredFields": ["workspaceId"],
-          "optionalFields": [
-            "intent",
-            "senderIds",
-            "runState",
-            "journal",
-            "journalNote"
-          ]
-        }
-      ],
-      "requiredOutput": [
-        "planRevision starts with pr1: unless blocker is workspace_access",
-        "stateRevision and targetShapeRevision captured",
-        "chosen label (evergreenRung token) is in enumeratedRungs",
-        "supplyCensus and censusReason justify prep/source/repair choices",
-        "pipelineDiagnosis checklist names firstFailing when blocked",
-        "terminal doneReason maps to terminalReasons"
-      ],
-      "allowedRungsSource": "enumeratedRungs",
-      "doNotAllow": [
-        "add_column",
-        "add_on_demand_leads",
-        "add_rubric_item",
-        "add_teammate",
-        "add_to_comment_campaign",
-        "add_to_connection_campaign",
-        "add_to_inmail_campaign",
-        "archive_campaign",
-        "attach_recommended_sequence",
-        "attach_sequence",
-        "bulk_enrich_with_prospeo",
-        "cancel_campaign_message_preparation",
-        "cancel_find_leads",
-        "cancel_lead_import",
-        "capture_post_idea",
-        "check_rubric",
-        "commit_blueprint",
-        "confirm_harvest_job_companies",
-        "confirm_lead_list",
-        "confirm_prospeo_company_accounts",
-        "copy_sender_config",
-        "create_campaign",
-        "create_on_demand_campaign",
-        "create_on_demand_table",
-        "create_workspace",
-        "create_workflow_table",
-        "delete_column",
-        "delete_rubric_item",
-        "duplicate_campaign",
-        "enrich_with_prospeo",
-        "fill_campaign_horizon",
-        "get_or_create_direct_campaign_table",
-        "import_leads",
-        "load_csv_dnc_entries",
-        "load_csv_domains",
-        "load_csv_linkedin_leads",
-        "mark_post_published",
-        "migrate_flat_configs",
-        "pause_campaign",
-        "pause_direct_campaign",
-        "pause_on_demand_campaign",
-        "prepare_campaign_ab_test",
-        "queue_campaign_cells",
-        "queue_cells",
-        "record_campaign_review_batch",
-        "record_engage_proven_search",
-        "refill_sends",
-        "refresh_paid_inmail_credits",
-        "refresh_sender_engagement",
-        "revise_message_template_and_rerun",
-        "save_domain_filters",
-        "save_hook_research",
-        "save_post_draft",
-        "save_rubrics",
-        "send_inbox_draft",
-        "send_inbox_manual_reply",
-        "set_active_workspace",
-        "set_campaign_waterfall_order",
-        "set_company_info",
-        "set_engage_state",
-        "set_engage_style_guide",
-        "set_headline_icp_criteria",
-        "set_sender_calendar_link",
-        "set_sender_routing",
-        "setup_evergreen_campaigns",
-        "start_campaign",
-        "start_campaign_message_preparation",
-        "start_direct_campaign",
-        "start_on_demand_campaign",
-        "update_campaign",
-        "update_campaign_brief",
-        "update_cell",
-        "update_column",
-        "update_find_leads_run",
-        "update_inbox_draft",
-        "update_post_draft",
-        "update_published_post_metrics",
-        "update_rubric_item",
-        "upsert_engage_tracked_person",
-        "upsert_rubric"
-      ],
-      "transitions": {
-        "work_named": "execute",
-        "terminal_doneReason": "report",
-        "workspace_access": "report",
-        "packet_incoherent_replan": "plan",
-        "packet_incoherent_blocked": "report"
-      }
-    },
-    {
-      "id": "execute",
-      "description": "Execute exactly the packet head action through refill_sends_v2 internals. Bounded approvals, message preparation, same-source copies, rerun_errored_cells, saved signal continuations, paid-credit refreshes, and pinned-lane starts are allowed only when named by the packet. Execute only the fingerprint captured at the last plan gate; stale packets refuse and return to plan.",
-      "allowedTools": [
-        "refill_sends_v2",
-        "start_campaign_message_preparation",
-        "confirm_lead_list",
-        "import_leads",
-        "search_signals",
-        "select_promising_posts",
-        "start_campaign",
-        "queue_campaign_cells"
-      ],
-      "doNotAllow": [
-        "create_campaign",
-        "create_on_demand_campaign",
-        "setup_evergreen_campaigns",
-        "set_campaign_waterfall_order",
-        "refresh_paid_inmail_credits",
-        "send_inbox_draft",
-        "send_inbox_manual_reply",
-        "update_campaign_brief",
-        "set_headline_icp_criteria",
-        "set_sender_routing"
-      ],
-      "transitions": {
-        "planned_recorded": "verify",
-        "stale_packet": "plan",
-        "non_yolo_continuation": "report",
-        "lease_lost": "report"
-      }
-    },
-    {
-      "id": "verify",
-      "description": "Verify whole-row outcomes before another plan read. Reattach to an own active prep job by requestSource/requestHash; never re-dispatch prep while a matching job is active. Foreign prep waits until clear or blocks foreign_prep_active. wait_for_active_work and wait_for_source_import reread the plan on bounded cadence. wait_for_scheduler is cross-invocation: each tool call polls briefly under the host guard, heartbeats the lease, and returns in_progress sweep guidance so the agent re-invokes refill_sends_v2 with {runId,fence}. The approximately five minute scheduler budget is cumulative at the run level.",
-      "allowedTools": ["refill_sends_v2", "get_refill_plan_v2"],
-      "onEnter": [
-        {
-          "tool": "refill_sends_v2",
-          "requiredFields": ["workspaceId", "runId", "fence"]
-        }
-      ],
-      "hardRules": [
-        "do not re-dispatch prep when an own active job exists; reattach and poll status",
-        "capped_by_scheduler is complete",
-        "replan-driven repair: the planner names rerun_errored_cells, approve_messages, start_campaign, or source work; the loop bounds and refuses",
-        "conversion verdict is journaled from packet facts after the first prep batch; the plan gate withholds a second unproven prep batch",
-        "zero pickup after a confirmed sweep is debugged from pipelineDiagnosis, not waited out forever",
-        "Sales Nav and Prospeo continuation packets render a scoped $sellable:create-campaign [campaignId] handoff for same saved-search identity, import mode add into the same source list, source work only"
-      ],
-      "transitions": {
-        "verify_poll": "verify",
-        "verified": "plan",
-        "in_progress_resume": "verify",
-        "terminal": "report",
-        "blocked": "report"
-      },
-      "repeatUntil": "terminal_or_in_progress_resume_or_blocked"
-    },
-    {
-      "id": "report",
-      "description": "Present the terminal or blocked report. Terminal proof is the run record at g4_terminal with a doneReason plus journal planned->did->outcome lines and a terminal block. loaded_awaiting_scheduler keeps the token for run-record compatibility, but report copy must include remaining-ready count, exact expected pickup time, and the resume handle; never render bare loaded, awaiting scheduler copy. Blocked Sales Nav and Prospeo packets reprint the scoped $sellable:create-campaign [campaignId] handoff text.",
-      "allowedTools": [],
-      "onEnter": [
-        {
-          "action": "present_run_terminal_or_resume_report"
-        }
-      ],
-      "terminal": true
-    }
-  ],
-  "verification": {
-    "requiredProof": [
-      "run record reached g4_terminal with a named doneReason",
-      "journal contains planned -> did -> outcome lines",
-      "journal contains terminal block and index line",
-      "planRevision has pr1: prefix unless blocker is workspace_access",
-      "chosen evergreenRung belongs to enumeratedRungs and has a plain-language rungLabels entry",
-      "managed_waterfall, dashboard_evergreen, or active_campaign lane source recorded",
-      "laneChain recorded when active_campaign chain is selected",
-      "supplyCensus/censusReason and pipelineDiagnosis checklist reviewed when present",
-      "in_progress results include runId, fence, gate, and sweep or wait guidance"
-    ],
-    "notCompletionProof": [
-      "called get_refill_plan_v2 alone",
-      "plan packet alone",
-      "action queue exists but no planned/did/outcome journal evidence",
-      "in_progress continuation without {runId,fence,gate}",
-      "journal absence",
-      "bare loaded awaiting scheduler report without expected pickup time"
-    ]
-  }
-}