@sellable/mcp 0.1.151 → 0.1.153

package/README.md

@@ -272,9 +272,10 @@ Parallel execution contract:
   filter/message prompts before that question. Once the user answers, launch the
   message-generation scout from the same campaign/table basis. If the user
   chooses filters, also launch the filter-leads scout, show Filter Rules, save
-  rubrics, then keep the browser on Filter Leads while the message
-  recommendation is reviewed. If filters are skipped, move to Messages/message
-  review. Product cells still wait for template approval.
+  rubrics, then ask for filter approval. After approval, keep the browser on
+  Filter Leads while the message recommendation is reviewed. If filters are
+  skipped, move to Messages/message review. Enrichment/filtering and Generate
+  Message cells wait for message approval.
 - Claude host: use the installed `source-scout-linkedin-engagement`,
   `source-scout-sales-nav`, and `source-scout-prospeo-contact` Task/Agent
   subagents for parallel lead-source scouting only when the current session

package/agents/post-find-leads-filter-scout.md

@@ -1,7 +1,8 @@
 You are Lead Fit Builder for Sellable create-campaign-v2.
 
-Your job starts only after the lead source has been approved or auto-confirmed
-and the bounded review batch exists in the campaign table.
+Your job starts only after the lead source has been approved or auto-confirmed,
+the confirmed source list has been copied into the campaign table, and the first
+review/process sample exists.
 Work only on the lead filter branch. Do not source new leads, draft messages,
 import leads, create campaigns, or ask the user questions. Your only live
 campaign mutation is calling `save_rubrics` after the production rubrics are
@@ -15,7 +16,7 @@ Required inputs:
 - selected source decision and provider/list state
 - `selectedLeadListId`
 - `workflowTableId`
-- imported review-batch rows, including row ids/hash when available
+- first review/process sample rows, including row ids/hash when available
 - filter choice
 
 Required first steps:
@@ -39,7 +40,7 @@ via `save_rubrics` plus the parent-thread summary.
 
 Process:
 
-1. Preserve the approved source decision and review-batch sample math supplied
+1. Preserve the approved source decision and review/process sample math supplied
    by the parent; do not re-run sourcing.
 2. Turn the sample's good-fit and false-positive patterns into a strict but
    campaign-native filter.

package/agents/post-find-leads-message-scout.md

@@ -1,9 +1,10 @@
 You are Message Draft Builder for Sellable create-campaign-v2.
 
-Your job starts only after the source is approved and the bounded review batch
-exists in the campaign table. Work only on the message-generation branch. Do not
-source leads, create lead filters, import leads, confirm lead lists, queue cells,
-attach sequences, start campaigns, ask the user questions, or mutate live
+Your job starts only after the source is approved, the confirmed source list has
+been copied into the campaign table, the first review/process sample exists, and
+the parent has recorded the filter choice. Work only on the message-draft branch.
+Do not source leads, create lead filters, import leads, confirm lead lists, queue
+cells, attach sequences, start campaigns, ask the user questions, or mutate live
 campaign state. The main thread owns approval and campaign writes.
 
 ## Source Of Truth
@@ -16,8 +17,8 @@ Use the live campaign inputs supplied by the parent thread:
 - selected source decision and provider state
 - `selectedLeadListId` or selected source list context
 - `workflowTableId`
-- imported review-batch rows from that selected list, including row IDs and a
-  review-batch row hash when available
+- first review/process sample rows from that selected list, including row IDs
+  and a sample row hash when available
 - filter basis at branch start: `pending`, `use-filters`, or `skip-filters`
 - any already-saved fit/rubric result summaries supplied by the parent
 
@@ -30,7 +31,7 @@ All live reads must come from scoped MCP/product tools by campaign and
 workspace, such as `get_campaign`, `get_campaign_context`, and
 `get_rows_minimal({ tableId: workflowTableId })`, or from equivalent parent
 thread payloads. Reject the task as `blocked` if the campaign id, workspace,
-`selectedLeadListId`, `workflowTableId`, or review-batch row ids do not match
+`selectedLeadListId`, `workflowTableId`, or review sample row ids do not match
 the branch input.
 
 ## Required First Steps
@@ -42,8 +43,8 @@ the branch input.
 
 2. Use that prompt as the drafting contract. Do not use create-campaign
    safety/checklist instructions as a substitute for the full prompt.
-3. Draft only from the campaign brief, selected source context, and imported
-   review-batch rows supplied by the parent.
+3. Draft only from the campaign brief, selected source context, and first
+   review/process sample rows supplied by the parent.
 4. Keep the work provisional until the user chooses `Use Template` in Messages.
 
 ## Owned Output
@@ -52,12 +53,12 @@ Return the following to the parent thread:
 
 - proposed first-message template using supported `{{...}}` tokens
 - token fill rules and fallbacks
-- one rendered good-fill sample for a plausible passing review-batch row
+- one rendered good-fill sample for a plausible passing review-sample row
 - one omit/fallback sample when the row signal is not safe
 - pass/fail notes against the generate-messages quality gates
 - compact runtime status: `ready`, `blocked`, `retry-needed`, or `stale`
 - basis token containing campaign revision/updatedAt, brief hash,
-  `selectedLeadListId`, `workflowTableId`, review-batch row ids/hash, filter
+  `selectedLeadListId`, `workflowTableId`, review sample row ids/hash, filter
   choice, and rubric/filter basis when present
 - output timestamp/hash and any retry/error detail
 
@@ -78,7 +79,7 @@ When reporting branch runtime proof, use this shape under
 - optional `compactOutputRef`, `compactOutput`, and `error`
 
 Do not tell the UI to show Message Draft Builder as running unless this proof
-exists and points at the current non-empty bounded review batch.
+exists and points at the current non-empty review/process sample.
 
 ## Basis Changes And Rewrites
 
@@ -89,7 +90,7 @@ row data became available after this branch started.
 
 Treat later filter/enrichment data as optional rewrite context. If campaign id,
 brief hash, selected source, `selectedLeadListId`, `workflowTableId`, and
-review-batch row ids/hash still match, keep the initial recommendation usable
+review sample row ids/hash still match, keep the initial recommendation usable
 and report `status: ready` with `basisStatus: "usable_initial"` or
 `"enriched_rewrite_available"`. The parent thread may offer the user a choice
 to keep the initial draft or rewrite with enriched/filter data, but the rewrite
@@ -98,7 +99,7 @@ must be explicit user opt-in.
 Retry or regenerate without asking only when the initial recommendation is
 missing, failed, structurally invalid, unsafe, or mismatched on campaign id,
 brief hash, selected source, `selectedLeadListId`, `workflowTableId`, or
-review-batch rows. Filter/rubric/enrichment basis drift alone is not a stale
+review sample rows. Filter/rubric/enrichment basis drift alone is not a stale
 blocker.
 
 ## Hard Rules

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

@@ -76,7 +76,7 @@ Return a concise structured result with:
   100 engagers, required engagers to scrape, average reachable engagers per
   post, expected usable prospects per post after cleanup, posts needed for
   target, whether the 10% planning floor clears after cleanup, selected post
-  count, review-batch import limit, expected usable lead range, and scale
+  count, first review/process sample size, expected usable lead range, and scale
   fallback
 - `estimated_good_fit_range`
 - `message_context_strength`, directional and source-specific
@@ -96,10 +96,11 @@ Evidence standards:
   exist, how many sampled engagers looked in-ICP, how many good-fit prospects
   that implies per 100 engagers, how many usable prospects one right-content
   post should yield after cleanup, how many engagers must be scraped for the
-  150-good-fit source target, how many posts are needed for that source target,
-  and which posts you would use. Also say the first campaign import remains the
-  bounded review batch.
+  300-good-fit source target at the 20% working assumption, how many posts are
+  needed for that source target, and which posts you would use. Also say the
+  source list is copied into the campaign and only the first 15 rows are used as
+  the review/process sample.
 - If `fetch_post_engagers` is unavailable or fails, report that explicitly and mark the estimate lower-confidence.
-- Keep LinkedIn Engagement viable when selected posts can produce roughly 150+ ICP-fit warm prospects before final filtering, even if Sales Nav is more scalable.
+- Keep LinkedIn Engagement viable when selected posts can produce roughly 300+ ICP-fit warm prospects before final filtering, even if Sales Nav is more scalable.
 - If sampled/projected fit after cleanup is below 10%, reject the Signals scrape
   path and recommend Sales Nav recent activity as the next source.

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

@@ -28,7 +28,7 @@ Process:
 2. Identify whether this is domain/account targeting, hiring-led targeting, or broad persona expansion.
 3. For domain targeting, use or create the standalone `domainFilterId` before searching; never pass raw domains directly into `search_prospeo`.
 4. For hiring-led targeting, use `company_job_posting_hiring_for` for the target open-role themes and `company_job_posting_quantity` when the brief needs an active hiring floor. Pair those company hiring filters with buyer/referrer person filters; do not treat hiring-led targeting as Sales Nav-only.
-5. Run the narrowest useful Prospeo people preview and 1-2 refinements if quality or scale is unclear. Check scale against the source target good-fit lead count (default about 150 usable prospects unless the parent supplies a different target) and cap source candidates at the provider limit. Use the first-page sample to compute projected good fits from a source-list export, not to recommend a 25-row import.
+5. Run the narrowest useful Prospeo people preview and 1-2 refinements if quality or scale is unclear. Check scale against the source target good-fit lead count (default about 300 usable prospects unless the parent supplies a different target) and cap source candidates at the provider limit. Use the first-page sample to compute projected good fits from a source-list export, not to recommend a 15-row review sample import.
 6. If `raw_result_count * projected_fit_rate_after_cleanup` is below the source target, do not recommend import yet. Tighten or broaden filters and retry until the projected usable pool clears target, or clearly report that the lane is too constrained.
 7. Call out that Prospeo gives contact/account and hiring-signal coverage but usually weaker LinkedIn intent than LinkedIn Engagement or Sales Nav activity slices.
 
@@ -57,7 +57,7 @@ Evidence standards:
   below 10% after reasonable refinement, recommend tightening the ICP/source
   direction rather than switching providers again.
 - Never recommend "import 25 leads" as the Prospeo source action. Recommend
-  exporting/materializing the source list with the approved `targetLeadCount`;
-  the parent thread later clones the bounded review batch with
-  `confirm_lead_list`.
+  exporting/materializing the approved source list; the parent thread later
+  copies the confirmed source rows into the campaign and treats only the first
+  15 rows as the review/process sample.
 - Treat Prospeo as an account/contact and company hiring-signal lane, not as proof of fresh LinkedIn intent.

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

@@ -44,7 +44,7 @@ Process:
    cannot plausibly reach the target after loosening.
 7. Use the first-page sample to compute projected good fits from the source-list
    export. The recommendation should name the source-list `targetLeadCount` for
-   `import_leads`, not a 25-row review-batch import.
+   `import_leads`, not a 15-row review sample import.
 8. Verify filters actually applied: returned search URL contains filters, first-page rows match the intended lane, and result count does not look like an unfiltered pool.
 
 Return a concise structured result with:
@@ -81,8 +81,8 @@ Evidence standards:
 - If projected good-fit after cleanup is below 10%, do not recommend Sales Nav
   as the winning source; recommend Prospeo as the next provider.
 - Never recommend "import 25 leads" as the Sales Nav source action. Recommend
-  exporting/materializing the source list with the approved `targetLeadCount`;
-  the parent thread later clones the bounded review batch with
-  `confirm_lead_list`.
+  exporting/materializing the approved source list; the parent thread later
+  copies the confirmed source rows into the campaign and treats only the first
+  15 rows as the review/process sample.
 - Do not hand-wave missing filter IDs.
 - If Sales Nav returns a giant unfiltered pool, discard that result and retry with valid filters before recommending it.

package/dist/tools/cells.js

@@ -20,7 +20,7 @@ export const cellToolDefinitions = [
     },
     {
         name: "queue_cells",
-        description: "Queue explicit cells for processing. In create-campaign-v2 Filter Leads, pass only bounded review-batch enrichCellId values from get_rows_minimal; do not pass icpCellId values or full-table cells because the workflow cascade handles downstream ICP scoring.",
+        description: "Queue explicit cells for processing. In create-campaign-v2 Filter Leads, pass only first review/process sample enrichCellId values from get_rows_minimal; do not pass icpCellId values or full-table cells because the workflow cascade handles downstream ICP scoring.",
         inputSchema: {
             type: "object",
             properties: {

package/dist/tools/leads.d.ts

@@ -144,6 +144,12 @@ export type ConfirmLeadListInput = {
     campaignName?: string;
     keepInSync?: boolean;
     jobId?: string;
+    reviewBatchLimit?: number;
+    /**
+     * Deprecated alias for reviewBatchLimit. Confirming a lead list now copies the
+     * confirmed source into the campaign table; this value no longer caps clone
+     * scope.
+     */
     targetLeadCount?: number;
 };
 export type SelectPromisingPostsInput = {
@@ -234,6 +240,7 @@ export declare const leadToolDefinitions: ({
             campaignName?: undefined;
             keepInSync?: undefined;
             jobId?: undefined;
+            reviewBatchLimit?: undefined;
             selections?: undefined;
             selectionMode?: undefined;
         };
@@ -409,6 +416,7 @@ export declare const leadToolDefinitions: ({
             campaignName?: undefined;
             keepInSync?: undefined;
             jobId?: undefined;
+            reviewBatchLimit?: undefined;
             selections?: undefined;
             selectionMode?: undefined;
         };
@@ -483,6 +491,7 @@ export declare const leadToolDefinitions: ({
             campaignName?: undefined;
             keepInSync?: undefined;
             jobId?: undefined;
+            reviewBatchLimit?: undefined;
             selections?: undefined;
             selectionMode?: undefined;
         };
@@ -629,6 +638,7 @@ export declare const leadToolDefinitions: ({
             campaignName?: undefined;
             keepInSync?: undefined;
             jobId?: undefined;
+            reviewBatchLimit?: undefined;
             selections?: undefined;
             selectionMode?: undefined;
         };
@@ -717,6 +727,7 @@ export declare const leadToolDefinitions: ({
             campaignName?: undefined;
             keepInSync?: undefined;
             jobId?: undefined;
+            reviewBatchLimit?: undefined;
             selections?: undefined;
             selectionMode?: undefined;
         };
@@ -814,6 +825,7 @@ export declare const leadToolDefinitions: ({
             campaignName?: undefined;
             keepInSync?: undefined;
             jobId?: undefined;
+            reviewBatchLimit?: undefined;
             selections?: undefined;
             selectionMode?: undefined;
         };
@@ -893,6 +905,7 @@ export declare const leadToolDefinitions: ({
             campaignName?: undefined;
             keepInSync?: undefined;
             jobId?: undefined;
+            reviewBatchLimit?: undefined;
             selections?: undefined;
             selectionMode?: undefined;
         };
@@ -1511,6 +1524,7 @@ export declare const leadToolDefinitions: ({
             campaignName?: undefined;
             keepInSync?: undefined;
             jobId?: undefined;
+            reviewBatchLimit?: undefined;
             selections?: undefined;
             selectionMode?: undefined;
         };
@@ -1642,6 +1656,7 @@ export declare const leadToolDefinitions: ({
             campaignName?: undefined;
             keepInSync?: undefined;
             jobId?: undefined;
+            reviewBatchLimit?: undefined;
             selections?: undefined;
             selectionMode?: undefined;
         };
@@ -1761,6 +1776,7 @@ export declare const leadToolDefinitions: ({
             campaignName?: undefined;
             keepInSync?: undefined;
             jobId?: undefined;
+            reviewBatchLimit?: undefined;
             selections?: undefined;
             selectionMode?: undefined;
         };
@@ -1838,6 +1854,7 @@ export declare const leadToolDefinitions: ({
             campaignName?: undefined;
             keepInSync?: undefined;
             jobId?: undefined;
+            reviewBatchLimit?: undefined;
             selections?: undefined;
             selectionMode?: undefined;
         };
@@ -1877,6 +1894,10 @@ export declare const leadToolDefinitions: ({
                 type: string;
                 description: string;
             };
+            reviewBatchLimit: {
+                type: string;
+                description: string;
+            };
             confirmed: {
                 type: string;
                 description: string;
@@ -2035,6 +2056,7 @@ export declare const leadToolDefinitions: ({
             campaignName?: undefined;
             keepInSync?: undefined;
             jobId?: undefined;
+            reviewBatchLimit?: undefined;
         };
         required: string[];
     };
@@ -2114,6 +2136,7 @@ export declare const leadToolDefinitions: ({
             campaignName?: undefined;
             keepInSync?: undefined;
             jobId?: undefined;
+            reviewBatchLimit?: undefined;
             selections?: undefined;
             selectionMode?: undefined;
         };
@@ -2474,7 +2497,7 @@ export declare function importLeads(input: ImportLeadsInput): Promise<{
     estimatedEngagers: number;
     selectedPostCount: number;
     availableSelectedPostCount: number;
-    targetEngagerCount: number | null;
+    targetEngagerCount: number;
     maxPostsToScrape: number | null;
     limitedSelectedPosts: boolean;
     targetLeadCount: number | null;
@@ -2581,10 +2604,13 @@ export declare function confirmLeadList(input: ConfirmLeadListInput): Promise<{
         requestedTargetLeadCount?: number;
         sourceRowLimit?: number;
         async?: boolean;
+        hybrid?: boolean;
         campaignTableReady?: boolean;
         importStatus?: string | null;
         remainingRowCount?: number | null;
         rowCount?: number | null;
+        sourceRowCount?: number | null;
+        clonedSourceRowCount?: number | null;
     };
     messageDraftBuilder: {
         firstAllowedStartPoint: string;
@@ -2596,16 +2622,24 @@ export declare function confirmLeadList(input: ConfirmLeadListInput): Promise<{
             workflowTableId: string | null;
             reviewBatchRowIds: string[];
             reviewBatchRowCount: number;
+            copiedCampaignRowCount: number;
         };
         branchBasisFields: string[];
         promptRequired: string;
     };
     boundedReviewBatch: {
         requestedTargetLeadCount: number;
+        requestedReviewBatchLimit: number;
         importedRowCount: number;
-        keptRowCount: number | null;
+        keptRowCount: number;
+        reviewRowCount: number;
+        copiedCampaignRowCount: number;
+        sourceCandidateRowCount: number;
+        remainingCopyRowCount: number;
+        copyStillRunning: boolean;
         trimmedOverflowRowCount: number;
-    } | undefined;
+        sourceShortfall: boolean;
+    };
     message: string;
 }>;
 export declare function getProviderPrompt(input: GetProviderPromptInput): string;