@leadbay/mcp 0.39.8 → 0.39.9

package/MIGRATION.md

@@ -32,9 +32,9 @@ field. On the `notification_id` path the job is done when `in_progress` is false
 `still_running[]` is empty on that path from the first poll and must not be read
 as "done". On the `lead_ids` path, done means `still_running[]` is empty.
 
-`leadbay_bulk_enrich_status` answers `ENRICH_JOB_NO_COUNTERS` when the enrichment
-notification carries no per-contact counters (the common case) — re-call with the
-`lead_ids` the launch returned.
+`leadbay_bulk_enrich_status` no longer answers `ENRICH_JOB_NO_COUNTERS`. An
+enrichment notification never carries per-contact counters, so the tool reads the
+job's lead set back from the backend and answers through the per-lead path.
 
 ## Errors removed
 
@@ -43,8 +43,8 @@ notification carries no per-contact counters (the common case) — re-call with
 no longer exist, and neither does `~/.leadbay/bulks.json` or the
 `LEADBAY_BULK_STORE_ALLOW_MEMORY` escape hatch. The replacements are
 `ENRICH_STATUS_INPUT_REQUIRED`, `ENRICH_JOB_NOT_FOUND`, `ENRICH_JOB_WRONG_KIND`,
-`ENRICH_JOB_NO_COUNTERS`, `QUALIFY_STATUS_INPUT_REQUIRED`, `QUALIFY_JOB_NOT_FOUND`
-and `QUALIFY_JOB_WRONG_KIND`. The 0.5.0 sections below describe the old store and
+`QUALIFY_STATUS_INPUT_REQUIRED`, `QUALIFY_JOB_NOT_FOUND` and
+`QUALIFY_JOB_WRONG_KIND`. The 0.5.0 sections below describe the old store and
 are kept as history.
 
 ---

package/dist/bin.js

@@ -1982,7 +1982,7 @@ WHEN TO USE: the user asks for a clickable / interactive artifact, dashboard, or
 
 WHEN NOT TO USE: the user wants a plain data answer (route to leadbay_pull_leads / leadbay_pull_followups) or to log a single real outreach you just did (leadbay_report_outreach).
 `;
-    leadbay_bulk_enrich_status = `Check status + per-lead contacts for a bulk enrichment you previously launched via leadbay_enrich_titles. Pass the \`notification_id\` for the job counters in one call, and/or the \`lead_ids\` + \`titles\` + \`email\` / \`phone\` the launch returned for per-lead progress. \`lead_ids\` alone is a valid call and is the reliable one: the job lookup is a scan of your recent notifications, so an archived job may not be found, and an enrichment notification does not always carry counters (then the tool answers \`ENRICH_JOB_NO_COUNTERS\` with the backend's running/finished flag and asks for \`lead_ids\`) \u2014 but the leads always answer. When \`include_contacts=true\` (opt-in), includes each contact's email/phone_number/job_title/enrichment.done.
+    leadbay_bulk_enrich_status = `Check status + per-lead contacts for a bulk enrichment you previously launched via leadbay_enrich_titles. Pass the \`notification_id\`, and/or the \`lead_ids\` + \`titles\` + \`email\` / \`phone\` the launch returned. Either one alone is a valid call: with \`notification_id\` the tool reads the job's lead set back from the backend, so an id kept from an earlier conversation still answers with per-lead progress. Pass \`lead_ids\` as well whenever you still have them \u2014 the job lookup is a scan of your recent notifications, so an archived job may not be found, but the leads always answer. \`titles\` / \`email\` / \`phone\` scope the count to the roles and channel THIS run asked for. When \`include_contacts=true\` (opt-in), includes each contact's email/phone_number/job_title/enrichment.done.
 
 WHEN TO USE: poll this REPEATEDLY after leadbay_enrich_titles returns a \`notification_id\`, staying active until the job is done \u2014 don't stop after one check, and don't hand the turn back to the user while progress is still climbing. "Done" = \`all_done:true\`, OR \`overall_progress.done\` has held steady across several SPACED polls (~15\u201330s apart) over at least ~90s\u20132 min of elapsed time (a reservation the provider never answers stays \`done:false\`, so \`all_done\` can stay false forever \u2014 don't spin indefinitely; a contact with nothing found does flip, to \`done:true\` with \`credits_used:0\`). Do NOT declare a plateau from the first few back-to-back reads: right after launch, \`overall_progress.done\` can sit flat while the backend is still spinning the job up, so space your polls out and give it real elapsed time before treating a flat count as terminal. Also do NOT declare a plateau while the result carries \`partial_failures\` \u2014 a flat \`done\` there means a transient per-lead fetch error (e.g. a 429), NOT an unresolvable contact; keep polling (respecting any \`retry_after\`) or surface it as a temporary status failure, rather than reporting those leads as permanently unresolved. Default \`include_contacts=false\` for the cheap interim polls; set \`include_contacts=true\` on the read you report from to pull each lead's enriched contacts for the completion report.
 
@@ -21087,7 +21087,26 @@ async function pMap(items, fn, concurrency) {
   await Promise.all(Array.from({ length: Math.min(concurrency, items.length) }, () => worker()));
   return out;
 }
-var STATUS_FETCH_CONCURRENCY, bulkEnrichStatus;
+async function readBulkLeadIds(client, bulkId) {
+  const ids = [];
+  for (let page = 0; page < BULK_LEADS_MAX_PAGES; page += 1) {
+    let res;
+    try {
+      res = await client.request("GET", `/leads/bulk_enrichments/${encodeURIComponent(bulkId)}/leads?contacts=false&count=${BULK_LEADS_PAGE_SIZE}&page=${page}`);
+    } catch {
+      return null;
+    }
+    for (const item of res?.items ?? []) {
+      if (item?.id)
+        ids.push(item.id);
+    }
+    const pages = res?.pagination?.pages ?? 1;
+    if (page + 1 >= pages)
+      return ids;
+  }
+  return null;
+}
+var STATUS_FETCH_CONCURRENCY, BULK_LEADS_PAGE_SIZE, BULK_LEADS_MAX_PAGES, bulkEnrichStatus;
 var init_bulk_enrich_status = __esm({
   "../core/dist/composite/bulk-enrich-status.js"() {
     "use strict";
@@ -21097,6 +21116,8 @@ var init_bulk_enrich_status = __esm({
     init_credits_helpers();
     init_tool_descriptions_generated();
     STATUS_FETCH_CONCURRENCY = 5;
+    BULK_LEADS_PAGE_SIZE = 100;
+    BULK_LEADS_MAX_PAGES = 3;
     bulkEnrichStatus = {
       name: "leadbay_bulk_enrich_status",
       annotations: {
@@ -21112,7 +21133,7 @@ var init_bulk_enrich_status = __esm({
         properties: {
           notification_id: {
             type: "string",
-            description: "The `notification_id` returned by leadbay_enrich_titles. Gives the job-level counters in one call."
+            description: "The `notification_id` returned by leadbay_enrich_titles. Answers on its own: the tool reads the job's lead set back from the backend, so an id kept from an earlier conversation still gives per-lead progress."
           },
           lead_ids: {
             type: "array",
@@ -21176,7 +21197,7 @@ var init_bulk_enrich_status = __esm({
       },
       execute: async (client, params, ctx) => {
         const includeContacts = params.include_contacts ?? false;
-        const leadIds = params.lead_ids ?? [];
+        let leadIds = params.lead_ids ?? [];
         const startMs = Date.now();
         if (!params.notification_id && leadIds.length === 0) {
           return {
@@ -21189,6 +21210,7 @@ var init_bulk_enrich_status = __esm({
         let bp = null;
         let inProgress = null;
         let launchedAt = null;
+        let bulkAnchorId = null;
         if (params.notification_id) {
           const n = await readNotificationById(client, params.notification_id);
           if (n && inferKind(n) !== "bulk_enrich") {
@@ -21204,6 +21226,7 @@ var init_bulk_enrich_status = __esm({
             bp = n.bulk_progress;
             inProgress = n.in_progress;
             launchedAt = n.created_at;
+            bulkAnchorId = anchorIdFor(n, "bulk_enrich");
           } else if (leadIds.length === 0) {
             return {
               error: true,
@@ -21213,6 +21236,9 @@ var init_bulk_enrich_status = __esm({
             };
           }
         }
+        if (!bp && leadIds.length === 0 && bulkAnchorId !== null) {
+          leadIds = await readBulkLeadIds(client, bulkAnchorId) ?? [];
+        }
         if (leadIds.length > 0) {
           const wantTitles = new Set((params.titles ?? []).map((t) => t.trim().toLowerCase()));
           const inThisRun = (c) => {
@@ -21316,13 +21342,18 @@ var init_bulk_enrich_status = __esm({
           };
         }
         if (!bp) {
+          const isReportRead2 = inProgress === false;
+          const creditsRemaining2 = isReportRead2 ? await readCreditsRemaining(client, true) : null;
           return {
-            error: true,
-            code: "ENRICH_JOB_NO_COUNTERS",
-            message: `This enrichment notification carries no per-contact counters; the backend reports it as ${inProgress ? "still running" : "finished"}`,
-            hint: "Re-call with the `lead_ids` returned by leadbay_enrich_titles (plus titles/email/phone) \u2014 that path counts contacts directly and works whether or not the notification has counters.",
+            notification_id: params.notification_id,
+            ...launchedAt ? { launched_at: launchedAt } : {},
+            status: inProgress ? "launched" : "complete",
+            leads: [],
+            overall_progress: { done: 0, total: 0, done_ratio: 0 },
             ...inProgress !== null ? { in_progress: inProgress } : {},
-            ...launchedAt ? { launched_at: launchedAt } : {}
+            all_done: isReportRead2,
+            ...isReportRead2 ? { credits_remaining: creditsRemaining2 } : {},
+            counts_hint: "This job's notification carries no per-contact counters and its lead set could not be read back, so done/total are 0. Re-call with the `lead_ids` returned by leadbay_enrich_titles (plus titles/email/phone) to count contacts directly."
           };
         }
         const done = bp.success_count + bp.failure_count + bp.quota_hit_count;
@@ -32162,7 +32193,7 @@ var OAUTH_BASE_URLS = {
     fr: "https://staging.api.leadbay.app"
   }
 };
-var VERSION = "0.39.8";
+var VERSION = "0.39.9";
 var HELP = `
 leadbay-mcp ${VERSION} \u2014 Leadbay Model Context Protocol server
 

package/dist/http-server.js

@@ -4932,7 +4932,7 @@ WHEN TO USE: the user asks for a clickable / interactive artifact, dashboard, or
 
 WHEN NOT TO USE: the user wants a plain data answer (route to leadbay_pull_leads / leadbay_pull_followups) or to log a single real outreach you just did (leadbay_report_outreach).
 `;
-var leadbay_bulk_enrich_status = `Check status + per-lead contacts for a bulk enrichment you previously launched via leadbay_enrich_titles. Pass the \`notification_id\` for the job counters in one call, and/or the \`lead_ids\` + \`titles\` + \`email\` / \`phone\` the launch returned for per-lead progress. \`lead_ids\` alone is a valid call and is the reliable one: the job lookup is a scan of your recent notifications, so an archived job may not be found, and an enrichment notification does not always carry counters (then the tool answers \`ENRICH_JOB_NO_COUNTERS\` with the backend's running/finished flag and asks for \`lead_ids\`) \u2014 but the leads always answer. When \`include_contacts=true\` (opt-in), includes each contact's email/phone_number/job_title/enrichment.done.
+var leadbay_bulk_enrich_status = `Check status + per-lead contacts for a bulk enrichment you previously launched via leadbay_enrich_titles. Pass the \`notification_id\`, and/or the \`lead_ids\` + \`titles\` + \`email\` / \`phone\` the launch returned. Either one alone is a valid call: with \`notification_id\` the tool reads the job's lead set back from the backend, so an id kept from an earlier conversation still answers with per-lead progress. Pass \`lead_ids\` as well whenever you still have them \u2014 the job lookup is a scan of your recent notifications, so an archived job may not be found, but the leads always answer. \`titles\` / \`email\` / \`phone\` scope the count to the roles and channel THIS run asked for. When \`include_contacts=true\` (opt-in), includes each contact's email/phone_number/job_title/enrichment.done.
 
 WHEN TO USE: poll this REPEATEDLY after leadbay_enrich_titles returns a \`notification_id\`, staying active until the job is done \u2014 don't stop after one check, and don't hand the turn back to the user while progress is still climbing. "Done" = \`all_done:true\`, OR \`overall_progress.done\` has held steady across several SPACED polls (~15\u201330s apart) over at least ~90s\u20132 min of elapsed time (a reservation the provider never answers stays \`done:false\`, so \`all_done\` can stay false forever \u2014 don't spin indefinitely; a contact with nothing found does flip, to \`done:true\` with \`credits_used:0\`). Do NOT declare a plateau from the first few back-to-back reads: right after launch, \`overall_progress.done\` can sit flat while the backend is still spinning the job up, so space your polls out and give it real elapsed time before treating a flat count as terminal. Also do NOT declare a plateau while the result carries \`partial_failures\` \u2014 a flat \`done\` there means a transient per-lead fetch error (e.g. a 429), NOT an unresolvable contact; keep polling (respecting any \`retry_after\`) or surface it as a temporary status failure, rather than reporting those leads as permanently unresolved. Default \`include_contacts=false\` for the cheap interim polls; set \`include_contacts=true\` on the read you report from to pull each lead's enriched contacts for the completion report.
 
@@ -23290,6 +23290,27 @@ async function pMap(items, fn, concurrency) {
   await Promise.all(Array.from({ length: Math.min(concurrency, items.length) }, () => worker()));
   return out;
 }
+var BULK_LEADS_PAGE_SIZE = 100;
+var BULK_LEADS_MAX_PAGES = 3;
+async function readBulkLeadIds(client, bulkId) {
+  const ids = [];
+  for (let page = 0; page < BULK_LEADS_MAX_PAGES; page += 1) {
+    let res;
+    try {
+      res = await client.request("GET", `/leads/bulk_enrichments/${encodeURIComponent(bulkId)}/leads?contacts=false&count=${BULK_LEADS_PAGE_SIZE}&page=${page}`);
+    } catch {
+      return null;
+    }
+    for (const item of res?.items ?? []) {
+      if (item?.id)
+        ids.push(item.id);
+    }
+    const pages = res?.pagination?.pages ?? 1;
+    if (page + 1 >= pages)
+      return ids;
+  }
+  return null;
+}
 var bulkEnrichStatus = {
   name: "leadbay_bulk_enrich_status",
   annotations: {
@@ -23305,7 +23326,7 @@ var bulkEnrichStatus = {
     properties: {
       notification_id: {
         type: "string",
-        description: "The `notification_id` returned by leadbay_enrich_titles. Gives the job-level counters in one call."
+        description: "The `notification_id` returned by leadbay_enrich_titles. Answers on its own: the tool reads the job's lead set back from the backend, so an id kept from an earlier conversation still gives per-lead progress."
       },
       lead_ids: {
         type: "array",
@@ -23369,7 +23390,7 @@ var bulkEnrichStatus = {
   },
   execute: async (client, params, ctx) => {
     const includeContacts = params.include_contacts ?? false;
-    const leadIds = params.lead_ids ?? [];
+    let leadIds = params.lead_ids ?? [];
     const startMs = Date.now();
     if (!params.notification_id && leadIds.length === 0) {
       return {
@@ -23382,6 +23403,7 @@ var bulkEnrichStatus = {
     let bp = null;
     let inProgress = null;
     let launchedAt = null;
+    let bulkAnchorId = null;
     if (params.notification_id) {
       const n = await readNotificationById(client, params.notification_id);
       if (n && inferKind(n) !== "bulk_enrich") {
@@ -23397,6 +23419,7 @@ var bulkEnrichStatus = {
         bp = n.bulk_progress;
         inProgress = n.in_progress;
         launchedAt = n.created_at;
+        bulkAnchorId = anchorIdFor(n, "bulk_enrich");
       } else if (leadIds.length === 0) {
         return {
           error: true,
@@ -23406,6 +23429,9 @@ var bulkEnrichStatus = {
         };
       }
     }
+    if (!bp && leadIds.length === 0 && bulkAnchorId !== null) {
+      leadIds = await readBulkLeadIds(client, bulkAnchorId) ?? [];
+    }
     if (leadIds.length > 0) {
       const wantTitles = new Set((params.titles ?? []).map((t) => t.trim().toLowerCase()));
       const inThisRun = (c) => {
@@ -23509,13 +23535,18 @@ var bulkEnrichStatus = {
       };
     }
     if (!bp) {
+      const isReportRead2 = inProgress === false;
+      const creditsRemaining2 = isReportRead2 ? await readCreditsRemaining(client, true) : null;
       return {
-        error: true,
-        code: "ENRICH_JOB_NO_COUNTERS",
-        message: `This enrichment notification carries no per-contact counters; the backend reports it as ${inProgress ? "still running" : "finished"}`,
-        hint: "Re-call with the `lead_ids` returned by leadbay_enrich_titles (plus titles/email/phone) \u2014 that path counts contacts directly and works whether or not the notification has counters.",
+        notification_id: params.notification_id,
+        ...launchedAt ? { launched_at: launchedAt } : {},
+        status: inProgress ? "launched" : "complete",
+        leads: [],
+        overall_progress: { done: 0, total: 0, done_ratio: 0 },
         ...inProgress !== null ? { in_progress: inProgress } : {},
-        ...launchedAt ? { launched_at: launchedAt } : {}
+        all_done: isReportRead2,
+        ...isReportRead2 ? { credits_remaining: creditsRemaining2 } : {},
+        counts_hint: "This job's notification carries no per-contact counters and its lead set could not be read back, so done/total are 0. Re-call with the `lead_ids` returned by leadbay_enrich_titles (plus titles/email/phone) to count contacts directly."
       };
     }
     const done = bp.success_count + bp.failure_count + bp.quota_hit_count;
@@ -29435,7 +29466,7 @@ function parseWriteEnv(env = process.env) {
 }
 
 // src/http-server.ts
-var VERSION = true ? "0.39.8" : "0.0.0-dev";
+var VERSION = true ? "0.39.9" : "0.0.0-dev";
 var PORT = Number(process.env.PORT ?? 8080);
 var HOST = process.env.HOST ?? "0.0.0.0";
 var logger = {

package/dist/installer-electron.js

@@ -1805,7 +1805,7 @@ var init_installer_gui = __esm({
     init_install_dxt();
     init_install_shared();
     init_oauth();
-    VERSION = true ? "0.39.8" : "0.0.0-dev";
+    VERSION = true ? "0.39.9" : "0.0.0-dev";
     MESSAGES = {
       en: {
         installer: {

package/dist/installer-gui.js

@@ -1068,7 +1068,7 @@ async function oauthLogin(opts) {
 }
 
 // installer/installer-gui.ts
-var VERSION = true ? "0.39.8" : "0.0.0-dev";
+var VERSION = true ? "0.39.9" : "0.0.0-dev";
 var MESSAGES = {
   en: {
     installer: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@leadbay/mcp",
-  "version": "0.39.8",
+  "version": "0.39.9",
   "mcpName": "io.github.leadbay/leadbay-mcp",
   "description": "Model Context Protocol (MCP) server for Leadbay — AI lead discovery, qualification, and enrichment for Claude Desktop, Cursor, and Claude Code.",
   "type": "module",