@sellable/mcp 0.1.104 → 0.1.105

package/agents/source-scout-linkedin-engagement.md

@@ -7,10 +7,10 @@ Required first step:
 - Load the canonical provider prompt before searching. If the parent supplies a
   draft `campaignOfferId`, call `get_provider_prompt({ provider:
 "signal-discovery", campaignOfferId, confirmed: true })` and include that same
-  `campaignOfferId` in `search_signals` so the user can watch source work in the
-  campaign UI. Treat that as a campaign-attached persisted search; do not run a
-  post-mint search without the campaign ID. If no campaign ID is supplied, run
-  campaignless preview mode.
+  `campaignOfferId` plus `currentStep: "signal-discovery"` in `search_signals`
+  so the user can watch source work in the campaign UI. Treat that as a
+  campaign-attached persisted search; do not run a post-mint search without the
+  campaign ID. If no campaign ID is supplied, run campaignless preview mode.
 
 Use the inherited Sellable MCP tools when available:
 

package/agents/source-scout-prospeo-contact.md

@@ -6,9 +6,10 @@ Required first step:
 
 - Load the canonical provider prompt before searching. If the parent supplies a
   draft `campaignOfferId`, call `get_provider_prompt({ provider: "prospeo",
-campaignOfferId, confirmed: true })` and include that same `campaignOfferId` in
-  `search_prospeo` so the user can watch source work in the campaign UI. If no
-  campaign ID is supplied, run campaignless preview mode. Treat post-mint
+campaignOfferId, confirmed: true })` and include that same `campaignOfferId`
+  plus `currentStep: "prospeo"` in `search_prospeo` so the user can watch source
+  work in the campaign UI. If no campaign ID is supplied, run campaignless
+  preview mode. Treat post-mint
   searches with `campaignOfferId` as campaign-attached persisted search tabs;
   do not run a live campaign search without the campaign ID.
 

package/agents/source-scout-sales-nav.md

@@ -7,8 +7,9 @@ Required first step:
 - Load the canonical provider prompt before searching. If the parent supplies a
   draft `campaignOfferId`, call `get_provider_prompt({ provider: "sales-nav",
 campaignOfferId, confirmed: true })` and include that same `campaignOfferId` in
-  `search_sales_nav` so the user can watch source work in the campaign UI. If no
-  campaign ID is supplied, run campaignless preview mode. Treat post-mint
+  `search_sales_nav` with `currentStep: "sales-nav"` so the user can watch
+  source work in the campaign UI. If no campaign ID is supplied, run
+  campaignless preview mode. Treat post-mint
   searches with `campaignOfferId` as campaign-attached persisted search tabs;
   do not run a live campaign search without the campaign ID.
 

package/dist/tools/leads.js

@@ -594,7 +594,7 @@ export const leadToolDefinitions = [
     },
     {
         name: "search_sales_nav",
-        description: 'Search LinkedIn Sales Navigator. Requires get_provider_prompt({ provider: "sales-nav" }) first. Returns normalized results with pagination. `campaignOfferId` is optional for directional preview runs; include it only when the search should be associated with a campaign.',
+        description: 'Search LinkedIn Sales Navigator. Requires get_provider_prompt({ provider: "sales-nav" }) first. Returns normalized results with pagination. `campaignOfferId` is optional for directional preview runs; include it only when the search should be associated with a campaign. Post-mint create-campaign-v2 watch runs MUST pass campaignOfferId and currentStep: "sales-nav" so the search appears in the watched campaign UI. Omitting campaignOfferId post-mint orphans the search from the UI.',
         inputSchema: {
             type: "object",
             properties: {
@@ -739,7 +739,7 @@ export const leadToolDefinitions = [
     },
     {
         name: "search_prospeo",
-        description: 'Search Prospeo for people using filters and optional domainFilterId. Requires get_provider_prompt({ provider: "prospeo" }) first. When targeting known accounts, call load_csv_domains for CSV-on-disk workflows or save_domain_filters for pasted/raw domain lists, then pass domainFilterId. Raw domain inputs and company-name targeting are NOT supported in this MCP tool. Strategy: start with 2-3 high-signal filters (title/seniority + industry or domainFilterId + headcount), then tighten one filter at a time. For security, AppSec, SOC, RevOps, Demand Gen, and similar function-specific lanes, do not widen with bare seniority labels like "Head" or "Director" alone; pair them with explicit function-title keywords and inspect the sample for off-function `Head of X` leakage. Prefer person location over company HQ unless HQ is explicitly needed. `campaignOfferId` routing rule: OMIT campaignOfferId ONLY in pre-mint Phase 84 `find leads` discovery mode (validating ICP before the commit gate). In every other context — post-mint lead additions, operator-driven searches on a live campaign, any search where the intent is to persist results to a specific campaign — you MUST pass campaignOfferId so the search shows up in that campaign\'s Contact Search panel. Omitting campaignOfferId post-mint orphans the search from the UI. Returns normalized results with pagination.',
+        description: 'Search Prospeo for people using filters and optional domainFilterId. Requires get_provider_prompt({ provider: "prospeo" }) first. When targeting known accounts, call load_csv_domains for CSV-on-disk workflows or save_domain_filters for pasted/raw domain lists, then pass domainFilterId. Raw domain inputs and company-name targeting are NOT supported in this MCP tool. Strategy: start with 2-3 high-signal filters (title/seniority + industry or domainFilterId + headcount), then tighten one filter at a time. For security, AppSec, SOC, RevOps, Demand Gen, and similar function-specific lanes, do not widen with bare seniority labels like "Head" or "Director" alone; pair them with explicit function-title keywords and inspect the sample for off-function `Head of X` leakage. Prefer person location over company HQ unless HQ is explicitly needed. `campaignOfferId` routing rule: OMIT campaignOfferId ONLY in pre-mint Phase 84 `find leads` discovery mode (validating ICP before the commit gate). In every other context — post-mint lead additions, operator-driven searches on a live campaign, any search where the intent is to persist results to a specific campaign — you MUST pass campaignOfferId so the search shows up in that campaign\'s Contact Search panel. Post-mint create-campaign-v2 watch runs MUST pass currentStep: "prospeo". Omitting campaignOfferId post-mint orphans the search from the UI. Returns normalized results with pagination.',
         inputSchema: {
             type: "object",
             properties: {
@@ -848,7 +848,7 @@ export const leadToolDefinitions = [
     },
     {
         name: "search_signals",
-        description: 'Search LinkedIn posts for signal discovery. Requires get_provider_prompt({ provider: "signal-discovery" }) first. Supports keyword search, profile posts, company posts, or a single post URL. Use campaignless preview mode for directional discovery; include `campaignOfferId` only when the search should persist into campaign state. Returns a compact summary with recommended posts to avoid context bloat.',
+        description: 'Search LinkedIn posts for signal discovery. Requires get_provider_prompt({ provider: "signal-discovery" }) first. Supports keyword search, profile posts, company posts, or a single post URL. Use campaignless preview mode for directional discovery; include `campaignOfferId` when the search should persist into campaign state. Post-mint create-campaign-v2 watch runs MUST pass campaignOfferId and currentStep: "signal-discovery" so the search appears in the watched campaign UI. Omitting campaignOfferId post-mint orphans the search from the UI. Returns a compact summary with recommended posts to avoid context bloat.',
         inputSchema: {
             type: "object",
             properties: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sellable/mcp",
-  "version": "0.1.104",
+  "version": "0.1.105",
   "type": "module",
   "description": "Sellable MCP server for Claude Code and Codex campaign workflows",
   "main": "dist/index.js",

package/skills/create-campaign-v2/SKILL.md

@@ -432,6 +432,13 @@ to be worth a LinkedIn test. I'll compare source paths by expected volume,
 sampled ICP fit, activity/warmth signal, cleanup risk, and tradeoffs. This
 usually takes ~3-5 min, and I'll show you the source decision + sample before
 anything goes live.`
+- In watch mode, do not leave the user sitting on only `pick-provider` while
+  source scouts run. Move the campaign to the likely primary source lane
+  (`signal-discovery`, `sales-nav`, or `prospeo`) before background source
+  scouts, then run the first campaign-attached provider prompt + provider search
+  in the parent thread with `campaignOfferId`, `confirmed: true`, and
+  `currentStep` when the tool accepts it. Background scouts may continue after
+  the visible campaign tab exists.
 - After the lead sample/source decision is ready and approved,
   show the next progress line:
   `Lead source is set. I'll import the first 15-row review batch into the
@@ -542,6 +549,11 @@ message we should test.`
 then draft the message from the same sample.` Never say `kicking off two
 workstreams`, `in parallel`, or `background` unless parallel branches were
   actually launched.
+- Source scout parallelism must not hide all provider work from the watch UI.
+  The parent thread owns the first visible provider search: call the chosen
+  provider prompt/search with the minted CampaignOffer id and provider
+  `currentStep` before waiting on source-scout results, so relevant search tabs
+  appear in real time.
 - For post-lead workstreams, first call
   `get_post_find_leads_scout_registry` and launch exactly the returned
   `filter-leads` and `message-generation` scouts when real subagents are

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

@@ -520,6 +520,33 @@
           "when": "before_source_scouts_or_provider_search",
           "chatRenderRule": "Move the campaign watch view to Find Contacts before the main thread starts comparing source paths. Do not mention MCP or local artifacts."
         },
+        {
+          "action": "advance_watch_to_initial_source_lane",
+          "tool": "update_campaign",
+          "requiredFields": [
+            "campaignId",
+            "currentStep"
+          ],
+          "currentStepByPrimaryLane": {
+            "signals": "signal-discovery",
+            "salesNav": "sales-nav",
+            "prospeo": "prospeo",
+            "apollo": "apollo-ai",
+            "existingList": "saved-lists",
+            "uploadedDomains": "prospeo"
+          },
+          "when": "before_background_source_scouts",
+          "rule": "Choose the likely primary visible source lane from source intake, brief preference, or the best first lane the main thread will actually search. Do this before waiting on background scouts so watch mode never sits on only Pick Provider while source work happens elsewhere."
+        },
+        {
+          "action": "run_first_campaign_attached_source_search",
+          "requiredFields": [
+            "campaignOfferId",
+            "currentStep"
+          ],
+          "before": "waiting_on_background_source_scouts",
+          "rule": "Before relying on background source scouts, the parent thread must run the first provider prompt + provider search for the chosen visible lane with campaignOfferId and currentStep (signal-discovery, sales-nav, or prospeo) so the campaign UI creates the corresponding live search/tab. Background scouts may continue after that, but the user must see at least one relevant campaign-attached search begin in the watched page."
+        },
         {
           "action": "render_find_leads_progress",
           "requiredVisibleContent": [
@@ -555,7 +582,7 @@
           "action": "run_subskill",
           "target": "find-leads",
           "mode": "campaign-attached-required",
-          "sourceScoutRule": "Shell-first flow requires the CampaignOffer campaignId from durable state. Pass campaignId as campaignOfferId into every provider prompt/search that can persist source state (`get_provider_prompt({ provider, campaignOfferId, confirmed: true })`, `search_signals`, `search_sales_nav`, `search_prospeo`) so the user can watch the selected source inside the campaign. The later import_leads call must use the same campaignOfferId. When several source lanes are credible, scout them independently, then write one primary source recommendation and any runner-up tradeoffs. Do not import, confirm, enrich, queue, or start leads during source discovery."
+          "sourceScoutRule": "Shell-first flow requires the CampaignOffer campaignId from durable state. Pass campaignId as campaignOfferId into every provider prompt/search that can persist source state (`get_provider_prompt({ provider, campaignOfferId, confirmed: true })`, `search_signals`, `search_sales_nav`, `search_prospeo`) and include currentStep for tools that accept it so the user can watch the selected source inside the campaign. In watch mode, run the first campaign-attached provider search in the parent thread before waiting on background scouts; subagents can explore runner-up lanes after the visible campaign tab exists. The later import_leads call must use the same campaignOfferId. When several source lanes are credible, scout them independently, then write one primary source recommendation and any runner-up tradeoffs. Do not import, confirm, enrich, queue, or start leads during source discovery."
         },
         {
           "action": "optional_debug_artifacts",