@sellable/mcp 0.1.148 → 0.1.150

package/skills/create-campaign-v2/core/flow.v2.json

@@ -588,20 +588,9 @@
           ]
         },
         {
-          "action": "launch_message_draft_builder_after_review_batch_import",
-          "tool": "get_post_find_leads_scout_registry",
-          "target": "post-find-leads-message-scout",
-          "requiresNonEmptyRows": true,
-          "mustRunBefore": [
-            "filter-choice question",
-            "filter approval",
-            "save_rubrics"
-          ],
-          "mode": "background_when_host_supports_subagents",
-          "fallback": "if no real background branch can start, say the real sequence and do not claim background drafting is running",
-          "toolCallRequiredInBranch": "get_subskill_prompt({ subskillName: \"generate-messages\", offset, limit }) until hasMore=false",
-          "runtimeProofTransport": "CampaignOffer.watchNarration.workerDetails.messageDraftBuilder",
-          "purpose": "start the provisional message draft from the imported review batch immediately; do not defer this to filter approval"
+          "action": "summarize_review_batch_and_advance_to_filter_choice",
+          "purpose": "ask filter choice immediately; no post-lead registries, filter refs, or message prompts first",
+          "maxCustomerCopyLines": 4
         }
       ],
       "requiredCampaignState": [
@@ -611,8 +600,6 @@
       ],
       "allowedTools": [
         "get_subskill_prompt",
-        "get_subskill_asset",
-        "get_post_find_leads_scout_registry",
         "import_leads",
         "wait_for_lead_list_ready",
         "confirm_lead_list",
@@ -620,16 +607,18 @@
         "get_rows_minimal",
         "update_campaign",
         "AskUserQuestion",
-        "request_user_input",
-        "Task",
-        "spawn_agent"
+        "request_user_input"
       ],
       "doNotAllow": [
+        "get_post_find_leads_scout_registry",
+        "Task",
+        "spawn_agent",
         "list_senders",
         "queue_cells",
         "start_campaign",
         "enrich_with_prospeo",
-        "bulk_enrich_with_prospeo"
+        "bulk_enrich_with_prospeo",
+        "save_rubrics"
       ],
       "waitFor": "review_batch_imported",
       "transitions": {
@@ -659,6 +648,13 @@
           ]
         }
       ],
+      "hardRules": [
+        "ask_filter_choice_immediately_after_review_batch_import",
+        "do_not_call_get_subskill_prompt_before_filter_choice",
+        "do_not_call_get_subskill_asset_before_filter_choice",
+        "do_not_call_get_post_find_leads_scout_registry_before_filter_choice",
+        "do_not_spawn_post_lead_agents_before_filter_choice"
+      ],
       "requiredCampaignState": [
         "campaignId",
         "campaignBrief",
@@ -672,6 +668,11 @@
         "get_campaign_navigation_state"
       ],
       "doNotAllow": [
+        "get_subskill_prompt",
+        "get_subskill_asset",
+        "get_post_find_leads_scout_registry",
+        "Task",
+        "spawn_agent",
         "create_campaign",
         "list_senders",
         "import_leads",
@@ -693,7 +694,7 @@
     },
     {
       "id": "post-lead-workstreams",
-      "label": "Filter and message workstreams",
+      "label": "Filter workstream",
       "onEnter": [
         {
           "action": "persist_add_filters_approval",
@@ -715,17 +716,18 @@
           },
           "mustRunBefore": [
             "get_post_find_leads_scout_registry",
-            "launch_or_reuse_post_lead_workstreams",
+            "launch_lead_fit_builder_after_filter_choice",
             "save_rubrics"
           ]
         },
         {
           "tool": "get_post_find_leads_scout_registry",
-          "purpose": "load canonical post-lead worker names"
+          "purpose": "load canonical post-lead worker names only after the user has chosen filters"
         },
         {
-          "action": "launch_or_reuse_lead_fit_builder_and_existing_message_draft",
+          "action": "launch_lead_fit_builder_after_filter_choice",
           "mode": "parallel_when_host_supports_subagents",
+          "target": "post-find-leads-filter-scout",
           "inputs": [
             "campaignId",
             "campaignBrief",
@@ -734,9 +736,16 @@
             "reviewBatchRowIds/hash",
             "filterChoice"
           ],
-          "stateSource": "CampaignOffer and workflow table rows",
-          "debugFilesOptionalOnly": true,
-          "messageDraftRule": "reuse or join the Message Draft Builder branch that started immediately after confirm_lead_list; do not start first-time message drafting here unless the earlier branch failed to start"
+          "stateSource": "live campaign/table",
+          "debugFilesOptionalOnly": true
+        },
+        {
+          "action": "launch_message_draft_builder_after_filter_decision",
+          "mode": "parallel_when_host_supports_subagents",
+          "target": "post-find-leads-message-scout",
+          "when": "filters_enabled",
+          "doesNotQueueCells": true,
+          "customerNarration": "Say message agent is drafting."
         },
         {
           "action": "save_filter_rubrics_to_campaign",
@@ -793,10 +802,13 @@
       "hardRules": [
         "after_save_rubrics_currentStep_must_be_apply-icp-rubric",
         "do_not_move_browser_to_messages_until_filter_leads_step_is_current_or_filters_are_explicitly_skipped",
-        "message_draft_builder_start_is_not_deferred_until_filters"
+        "no_post_lead_worker_or_deep_prompt_before_filter_choice",
+        "lead_fit_builder_starts_only_after_filters_enabled",
+        "msg_draft_after_filter_choice",
+        "msg_draft_no_cells"
       ],
       "transitions": {
-        "post_lead_workstreams_ready": "message-review",
+        "post_lead_workstreams_ready": "message-generation",
         "revise_leads": "find-leads",
         "revise_rubric": "filter-rubric",
         "revise_messaging": "message-generation",
@@ -865,14 +877,23 @@
       "id": "message-generation",
       "label": "Message generation",
       "onEnter": [
+        {
+          "action": "set_message_review_visible_step_by_filter_choice",
+          "tool": "update_campaign",
+          "branchRules": [
+            "yes: currentStep=apply-icp-rubric; wait on Filter Leads",
+            "no: currentStep=messages; message review"
+          ],
+          "watchNarration.stage": "fit-message"
+        },
         {
           "action": "run_or_reconcile_message_draft_builder",
           "target": "post-find-leads-message-scout",
           "toolCallRequiredBeforeDraft": [
             "get_subskill_prompt({ subskillName: \"generate-messages\", offset, limit }) until hasMore=false",
-            "for approval-only parent-thread review, use get_subskill_asset({ subskillName: \"create-campaign-v2\", assetPath: \"references/message-review-safety-gate.md\" }) instead of loading generate-messages"
+            "parent approval uses references/message-review-safety-gate.md only"
           ],
-          "stateSource": "campaignBrief, selected source state, selectedLeadListId, workflowTableId, bounded review-batch row ids/hash",
+          "stateSource": "campaignBrief, source, selectedLeadListId, workflowTableId, review-batch row ids/hash",
           "outputState": "messageDraftRecommendation"
         }
       ],
@@ -887,11 +908,12 @@
         "get_subskill_asset",
         "get_campaign",
         "get_rows_minimal",
+        "update_campaign",
         "AskUserQuestion",
         "request_user_input"
       ],
       "toolRules": [
-        "Before message drafting, the Message Draft Builder branch loads the full get_subskill_prompt({ subskillName: \"generate-messages\" }) prompt and drafts from campaignBrief, selected source state, selectedLeadListId, workflowTableId, and imported review-batch rows. For approval-only parent-thread template review, load references/message-review-safety-gate.md and do not load the full generate-messages prompt.",
+        "Message Draft Builder loads full get_subskill_prompt({ subskillName: \"generate-messages\" }) from live state. Parent approval uses message-review-safety-gate only.",
         "Do not use brief.md, lead-review.md, or lead-sample.json as required live state; those files are optional debug context only.",
         "The compact messageDraftRecommendation must return templateRecommendation, tokenFillRules, renderedSample, concerns, status, basisToken, outputAt, outputHash, and error or retry detail.",
         "If campaign/source/table/review-batch basis does not match, classify the output stale or blocked."
@@ -902,7 +924,6 @@
         "save_rubrics",
         "import_leads",
         "confirm_lead_list",
-        "update_campaign",
         "queue_cells",
         "start_campaign",
         "generate_messages"

package/skills/create-campaign-v2/references/step-13-import-leads.md

@@ -106,7 +106,7 @@ fills the source lead list; it does **not** clone rows into the campaign table:
 ```text
 import_leads({
   campaignOfferId,
-  targetLeadCount: <sourceCandidateTarget; provider default>,
+  targetLeadCount: <sourceCandidateTarget from approved good-fit math>,
   // Signal Discovery only:
   targetEngagerCount: <ceil(targetGoodFitLeads / sampledFitRateAfterCleanup)>,
   maxPostsToScrape: <postsNeeded from approved math>
@@ -114,9 +114,15 @@ import_leads({
 ```
 
 Provider is inherited from the selected source decision (not re-selected here)
-and should already be saved on the campaign before import. Response returns
-`{ imported, skipped, duplicates }` — surface all three to the escalation logic
-so dedup ratios are visible.
+and should already be saved on the campaign before import. For Sales Nav and
+Prospeo, `<sourceCandidateTarget>` is not the 25-row review batch. It is the
+source-list export/materialization count from the approved source math:
+`min(rawResultCount, providerMax, ceil(targetGoodFitLeads /
+projectedFitRateAfterCleanup))`. If projected good fits remain below the target
+(often about 150+ usable prospects unless the campaign/source defaults specify
+otherwise), return to find-leads and refine filters before import. Response
+returns `{ imported, skipped, duplicates }` — surface all three to the
+escalation logic so dedup ratios are visible.
 
 For Signal Discovery, do not scrape every currently selected/promoted sample
 post by default. Before `import_leads`, reconcile selected posts with the
@@ -127,9 +133,11 @@ rate with a conservative cleanup factor, cap the source candidates at the
 approved provider limit, and select only enough posts to reach that engager
 count. The planning floor is 10% projected fit after cleanup; if Signal
 Discovery falls below that floor, do not import the source list. Route back to
-find-leads and move to Sales Nav recent activity instead. The subsequent
-`confirm_lead_list` call still uses `targetLeadCount: <importLimit>` so only the
-bounded review batch enters the campaign table.
+find-leads and move to Sales Nav recent activity instead. After the scrape,
+`wait_for_lead_list_ready` must clear the approved source-candidate target; if
+it reports `source_under_capacity`, do not call `confirm_lead_list`. The
+subsequent `confirm_lead_list` call still uses `targetLeadCount: <importLimit>`
+so only the bounded review batch enters the campaign table.
 
 For supplied direct lists, `confirm_lead_list` must receive
 `targetLeadCount: <importLimit>` or explicit `sourceRowIds` so a 100-row source

package/skills/create-campaign-v2/references/watch-guide-narration.md

@@ -194,10 +194,10 @@ After review batch import:
 ```json
 {
   "stage": "fit-message",
-  "headline": "I recommend adding filters",
-  "visibleState": "The first review batch is in the campaign. The visible sample looks mixed enough that filters should be added before message review.",
-  "agentIntent": "Codex is asking whether you want to further filter these leads before message review. Skip filters only if the visible rows already look clean.",
-  "nextAction": "Choose filters or skip",
+  "headline": "Filtering may not be needed",
+  "visibleState": "25 review leads are in the campaign table from 181 source candidates. Sample read: 23/25 look like senior target-role fits; 2 need cleanup or manual review. The browser is showing the filter-choice screen.",
+  "agentIntent": "Codex is not recommending filters because the sample already looks clean. Fit examples: Dave Kranowitz (Chief Revenue Officer); Marie Didominica (Head of Growth Marketing). Add filters only for a narrow exclusion.",
+  "nextAction": "Skip filters or add a narrow cleanup rule",
   "workerStatuses": {
     "leadFitBuilder": "idle",
     "messageDraftBuilder": "running"
@@ -206,11 +206,13 @@ After review batch import:
 ```
 
 Use this after the selected review rows are present and before filters are
-saved. This is add-filters intent, not active filtering. Recommend adding
-filters when the sample is mixed/noisy, tell the user to Choose filters or skip,
-and do not say filtering the batch before rubrics and message approval are
-saved. The Message Draft Builder should start immediately after the bounded
-review batch exists; mark it running only when that branch actually started.
+saved. The filter recommendation must be row-specific: say why filters are
+recommended from the sample counts and examples, or say filtering may not be
+needed when the visible review rows already look clean. This is a user decision
+gate, not active filtering; do not say filtering the batch before rubrics and
+message approval are saved. The Message Draft Builder should start immediately
+after the bounded review batch exists; mark it running only when that branch
+actually started.
 When the user chooses filters, immediately persist `enableICPFilters: true` and
 move to `create-icp-rubric` so the watched app shows Filter Rules while Codex
 defines the rules in chat. After `save_rubrics`, move to `apply-icp-rubric`

package/skills/providers/apollo.md

@@ -378,7 +378,14 @@ search_apollo({
 
 ### ABM / Domain List Targeting
 
-For account-based targeting, use `q_organization_domains_list` to search specific companies:
+For campaign routing, supplied company-domain lists should go to Prospeo first
+using `load_csv_domains` or `save_domain_filters`, then `domainFilterId`.
+Apollo still supports `q_organization_domains_list` as a secondary/legacy
+capability when the user explicitly chooses Apollo or needs an Apollo-only
+filter such as a technographic constraint.
+
+If Apollo is explicitly selected for account-based targeting, use
+`q_organization_domains_list` to search specific companies:
 
 ```json
 search_apollo({

package/skills/providers/prospeo.md

@@ -62,7 +62,7 @@ search_prospeo({
 - Pass `searchId` on subsequent pages to paginate.
 - Use `import_leads` with `provider: \"prospeo\"` and the `searchId` to create a lead list and start import.
 - **IMPORTANT:** If `import_leads` returns `needsModeSelection: true`, use `AskUserQuestion` to ask "add to existing leads or replace?" Do NOT assume.
-- Default source target is 300+ good-fit leads, capped at 2,500 source candidates for now.
+- Default source target is about 150 good-fit leads, capped at 2,500 source candidates for now.
 - Apply the campaign source planning floor: the sampled/projected good-fit rate
   after cleanup should be at least 10%. Prospeo is the terminal fallback; if the
   best reasonable Prospeo lane is still below 10%, tighten the ICP/source
@@ -95,6 +95,11 @@ Prospeo filters are split into person vs company. Most filters use `include` / `
 
 Preference rules:
 
+- For hiring-led campaigns, use `company_job_posting_hiring_for` to target the
+  open-role themes and `company_job_posting_quantity` when the campaign needs
+  an active hiring floor. Pair those company hiring filters with buyer/referrer
+  person filters such as founders, GTM leaders, talent leaders, or revenue
+  owners.
 - For ABM lists, use `load_csv_domains` + `domainFilterId` when the accounts are already in a CSV file on disk.
 - For pasted/raw domain lists, use `save_domain_filters` + `domainFilterId` instead of inline domains or `company.websites.include`.
 - If user input starts as company names, resolve names to domains first, then use `save_domain_filters`.
@@ -167,6 +172,11 @@ search_prospeo({
 
 ## When to Use Prospeo
 
+- **Hiring-led targeting**: Find companies hiring for specific roles with
+  `company_job_posting_hiring_for` and `company_job_posting_quantity`, then
+  identify reachable buyer/referrer contacts at those companies
+- **Account/domain targeting**: Use `domainFilterId` from `load_csv_domains` or
+  `save_domain_filters` for ABM searches
 - **Email Finding**: Get verified work emails from LinkedIn URLs
 - **Lead Enrichment**: Add company data, job history, and contact info to leads
 - **Bulk Operations**: Enrich up to 100 leads at once

package/skills/providers/sales-nav.md

@@ -387,7 +387,7 @@ User: "Save it"
 <limits>
 - 25 results per page
 - Maximum 100 pages (2,500 leads)
-- Default source target: 300+ good-fit leads, capped at 2,500 source
+- Default source target: about 150 good-fit leads, capped at 2,500 source
   candidates for now
 - Maximum 5 search calls per session
 - If user needs more than 2,500: explain limit, suggest splitting by region

package/skills/providers/signal-discovery.md

@@ -459,6 +459,9 @@ targetLeadCount, targetEngagerCount, maxPostsToScrape })` for the approved
 source-capacity plan without asking for another yes/no gate. Then
 `confirm_lead_list` imports only the bounded review batch into the campaign
 table. Do not confuse the source-candidate target with the review-batch size.
+If the completed source scrape comes back below the approved source-candidate
+target, do not call `confirm_lead_list`; select more posts, rerun source
+discovery, or move to Sales Nav.
 
 The promotion/select step is required campaign state. Use post IDs from the
 current campaign-scoped search result, not stale IDs copied from a source review