@leadbay/mcp 0.32.1 → 0.32.4

package/CHANGELOG.md

@@ -1,5 +1,33 @@
 # Changelog — @leadbay/mcp
 
+## 0.32.4 — 2026-09-01
+
+`leadbay_account_status.notifications` was permanently `[]` on the hosted server
+(product#4009). Same shape as product#4005: `buildServerFromClient` builds every
+hosted server without a `notificationsInbox`, `BuildServerOptions` makes it
+optional, so it compiled and failed silently.
+
+**Not fixed by wiring the inbox, because the inbox cannot exist there.** It is
+fed by a WS listener whose ticket (`GET /auth/ws`) is per-account, which is
+meaningless on a multi-tenant process, and the streamable transport builds a
+fresh `Server` per request so nothing would survive to be cached. Porting it
+would be the same mistake in a third place.
+
+`GET /notifications` is already per-account and already durable. On hosted the
+ledger IS the inbox, so `account_status` reads it on demand when no inbox is
+wired. Stdio is unchanged and still free — the WS listener already has the
+answer, and the ledger is not called.
+
+- `fetchTerminalNotifications(client)` in `notifications/catch-up.ts` returns
+  terminal, unseen entries directly. `isTerminalUnseen` is extracted so inbox
+  seeding and the inbox-less read cannot disagree about what counts.
+- A notifications failure resolves to `[]` rather than throwing. `account_status`
+  is the daily entry point; a ledger hiccup must not take the check-in down.
+- **Deliberately not done: `_meta.notifications` still does not ride hosted tool
+  responses.** Reviving it would mean a `GET /notifications` per tool call to
+  decorate every response. The cost lands on the check-in entry point only,
+  which is where the daily-rhythm channel is actually read.
+
 ## 0.32.0 — 2026-09-01
 
 A poll-budget timeout stops being an error (product#4007). The import wizard's

package/dist/bin.js

@@ -5568,6 +5568,28 @@ var init_inbox = __esm({
 });
 
 // ../core/dist/notifications/catch-up.js
+function isTerminalUnseen(n) {
+  if (!n.bulk_progress)
+    return false;
+  if (n.in_progress)
+    return false;
+  if (n.first_seen_at)
+    return false;
+  return true;
+}
+async function fetchTerminalNotifications(client, opts = {}) {
+  try {
+    const page = await client.listNotifications({
+      archived: false,
+      page: 0,
+      count: opts.count ?? DEFAULT_COUNT
+    });
+    return page.items.filter(isTerminalUnseen).map(toInboxEntry);
+  } catch (err) {
+    opts.logger?.warn?.(`notifications.fetch_terminal failed: ${err?.message ?? err?.code ?? err}`);
+    return [];
+  }
+}
 async function catchUpNotifications(client, inbox, opts = {}) {
   const count = opts.count ?? DEFAULT_COUNT;
   let added = 0;
@@ -5578,11 +5600,7 @@ async function catchUpNotifications(client, inbox, opts = {}) {
       count
     });
     for (const n of page.items) {
-      if (!n.bulk_progress)
-        continue;
-      if (n.in_progress)
-        continue;
-      if (n.first_seen_at)
+      if (!isTerminalUnseen(n))
         continue;
       const sizeBefore = inbox.size();
       inbox.record(n);
@@ -5599,6 +5617,7 @@ var DEFAULT_COUNT;
 var init_catch_up = __esm({
   "../core/dist/notifications/catch-up.js"() {
     "use strict";
+    init_revise_hint();
     DEFAULT_COUNT = 50;
   }
 });
@@ -20718,6 +20737,7 @@ var init_account_status = __esm({
   "../core/dist/composite/account-status.js"() {
     "use strict";
     init_agent_memory();
+    init_catch_up();
     init_credits_helpers();
     init_tool_descriptions_generated();
     accountStatus = {
@@ -20839,6 +20859,8 @@ var init_account_status = __esm({
             ctx?.logger?.warn?.(`account_status: quota_status failed: ${err?.message ?? err?.code ?? err}`);
           }
         }
+        const inbox = ctx?.notificationsInbox;
+        const notifications = inbox ? inbox.list() : await fetchTerminalNotifications(client, { logger: ctx?.logger });
         const lensId = me.last_requested_lens ?? null;
         const lensAsked = typeof ctx?.triggered_by === "string" && /\b(lens|lenses|audience|targeting|segment|filter)\b/i.test(ctx.triggered_by);
         let last_requested_lens_name = null;
@@ -20879,13 +20901,12 @@ var init_account_status = __esm({
           // on /me are intentionally NOT surfaced — they're defunct (see
           // SHAPE-DRIFT.md probe round 4).
           quota,
-          // Inbox of terminal bulk-progress notifications. Same shape the MCP
-          // server attaches to `_meta.notifications` on every tool response —
-          // duplicated here as a top-level field so the agent's daily-rhythm
-          // check-in (this composite) sees them without having to read _meta.
-          // Empty array when the WS listener isn't wired (OpenClaw, tests) OR
-          // when nothing has completed since the last ack.
-          notifications: ctx?.notificationsInbox?.list() ?? [],
+          // Terminal bulk-progress notifications. Same shape the MCP server
+          // attaches to `_meta.notifications` on every tool response — carried
+          // here as a top-level field so the agent's daily-rhythm check-in (this
+          // composite) sees them without reading _meta. See the read above for
+          // why hosted takes a different path to the same list.
+          notifications,
           // Non-null ONLY when the quota_status call failed. The agent must treat
           // this as "could not read quota" — NOT as zero usage, and NOT as a broken
           // login (the token just authenticated /users/me above). product#3761.
@@ -32940,7 +32961,7 @@ var OAUTH_BASE_URLS = {
     fr: "https://staging.api.leadbay.app"
   }
 };
-var VERSION = "0.32.1";
+var VERSION = "0.32.4";
 var HELP = `
 leadbay-mcp ${VERSION} \u2014 Leadbay Model Context Protocol server
 

package/dist/http-server.js

@@ -8101,9 +8101,82 @@ var COMPOSITE_FILE_TOOL_NAMES = /* @__PURE__ */ new Set([
   "leadbay_tour_plan"
 ]);
 
+// ../core/dist/notifications/revise-hint.js
+var HINT_BULK_ENRICH = "Contact enrichment just finished. Revise any prior output that named these leads' contacts (outreach drafts, contact lists, recommended-lead lists with contact_count, NEXT STEPS asking the user to wait for emails / phones). Re-fetch contacts via leadbay_get_contacts for the affected leads.";
+var HINT_BULK_QUALIFY = "Lead qualification just finished. Revise any prior lead list / ranking / outreach shortlist that depended on ai_agent_lead_score for these leads \u2014 today's leads, top-of-inbox, followups maps, prepare-outreach shortlists. Re-pull qualification answers via leadbay_research_lead_by_id or re-rank via leadbay_pull_leads.";
+var HINT_IMPORT = "CSV / CRM import just finished. Revise any prior output that referenced 'leads available' before the import landed \u2014 lead lists pulled from the affected lens, 'what's new today', followup planning. Re-pull the affected lens via leadbay_pull_leads / leadbay_pull_followups.";
+var HINT_OTHER = "Background work just completed. If you referenced its subject in prior output, re-fetch the affected data and revise.";
+function reviseHintFor(kind) {
+  switch (kind) {
+    case "bulk_enrich":
+      return HINT_BULK_ENRICH;
+    case "bulk_qualify":
+      return HINT_BULK_QUALIFY;
+    case "import":
+      return HINT_IMPORT;
+    default:
+      return HINT_OTHER;
+  }
+}
+function inferKind(n) {
+  if (n.links.some((l) => l.type === "bulk_enrichment"))
+    return "bulk_enrich";
+  if (n.file_import_id)
+    return "import";
+  if (n.bulk_progress)
+    return "bulk_qualify";
+  return "other";
+}
+function anchorIdFor(n, kind) {
+  if (kind === "bulk_enrich") {
+    const link = n.links.find((l) => l.type === "bulk_enrichment");
+    return link ? String(link.id) : null;
+  }
+  if (kind === "import")
+    return n.file_import_id;
+  return null;
+}
+function toInboxEntry(n) {
+  const kind = inferKind(n);
+  return {
+    notification_id: n.id,
+    kind,
+    anchor_id: anchorIdFor(n, kind),
+    title: n.title,
+    bulk_progress: n.bulk_progress,
+    completed_at: n.updated_at,
+    revise_hint: reviseHintFor(kind)
+  };
+}
+
 // ../core/dist/notifications/inbox.js
 var DEFAULT_TTL_MS = 24 * 60 * 60 * 1e3;
 
+// ../core/dist/notifications/catch-up.js
+var DEFAULT_COUNT = 50;
+function isTerminalUnseen(n) {
+  if (!n.bulk_progress)
+    return false;
+  if (n.in_progress)
+    return false;
+  if (n.first_seen_at)
+    return false;
+  return true;
+}
+async function fetchTerminalNotifications(client, opts = {}) {
+  try {
+    const page = await client.listNotifications({
+      archived: false,
+      page: 0,
+      count: opts.count ?? DEFAULT_COUNT
+    });
+    return page.items.filter(isTerminalUnseen).map(toInboxEntry);
+  } catch (err) {
+    opts.logger?.warn?.(`notifications.fetch_terminal failed: ${err?.message ?? err?.code ?? err}`);
+    return [];
+  }
+}
+
 // ../core/dist/tool-descriptions.generated.js
 var leadbay_account_history = `## WHEN TO USE
 
@@ -22490,6 +22563,8 @@ var accountStatus = {
         ctx?.logger?.warn?.(`account_status: quota_status failed: ${err?.message ?? err?.code ?? err}`);
       }
     }
+    const inbox = ctx?.notificationsInbox;
+    const notifications = inbox ? inbox.list() : await fetchTerminalNotifications(client, { logger: ctx?.logger });
     const lensId = me.last_requested_lens ?? null;
     const lensAsked = typeof ctx?.triggered_by === "string" && /\b(lens|lenses|audience|targeting|segment|filter)\b/i.test(ctx.triggered_by);
     let last_requested_lens_name = null;
@@ -22530,13 +22605,12 @@ var accountStatus = {
       // on /me are intentionally NOT surfaced — they're defunct (see
       // SHAPE-DRIFT.md probe round 4).
       quota,
-      // Inbox of terminal bulk-progress notifications. Same shape the MCP
-      // server attaches to `_meta.notifications` on every tool response —
-      // duplicated here as a top-level field so the agent's daily-rhythm
-      // check-in (this composite) sees them without having to read _meta.
-      // Empty array when the WS listener isn't wired (OpenClaw, tests) OR
-      // when nothing has completed since the last ack.
-      notifications: ctx?.notificationsInbox?.list() ?? [],
+      // Terminal bulk-progress notifications. Same shape the MCP server
+      // attaches to `_meta.notifications` on every tool response — carried
+      // here as a top-level field so the agent's daily-rhythm check-in (this
+      // composite) sees them without reading _meta. See the read above for
+      // why hosted takes a different path to the same list.
+      notifications,
       // Non-null ONLY when the quota_status call failed. The agent must treat
       // this as "could not read quota" — NOT as zero usage, and NOT as a broken
       // login (the token just authenticated /users/me above). product#3761.
@@ -22550,7 +22624,7 @@ var accountStatus = {
 
 // ../core/dist/composite/bulk-qualify-leads.js
 var PAGE_SIZE = 50;
-var DEFAULT_COUNT = 10;
+var DEFAULT_COUNT2 = 10;
 var MAX_COUNT = 25;
 var DEFAULT_PER_LEAD_BUDGET_MS = 9e4;
 var DEFAULT_TOTAL_BUDGET_MS2 = 5 * 6e4;
@@ -22598,7 +22672,7 @@ var bulkQualifyLeads = {
     properties: {
       count: {
         type: "number",
-        description: `How many fresh leads to qualify (default ${DEFAULT_COUNT}, max ${MAX_COUNT})`
+        description: `How many fresh leads to qualify (default ${DEFAULT_COUNT2}, max ${MAX_COUNT})`
       },
       leadIds: {
         type: "array",
@@ -22689,7 +22763,7 @@ var bulkQualifyLeads = {
     ]
   },
   execute: async (client, params, ctx) => {
-    const wantCount = Math.min(params.count ?? DEFAULT_COUNT, MAX_COUNT);
+    const wantCount = Math.min(params.count ?? DEFAULT_COUNT2, MAX_COUNT);
     const perLeadBudget = params.per_lead_budget_ms ?? DEFAULT_PER_LEAD_BUDGET_MS;
     const totalBudget = params.total_budget_ms ?? DEFAULT_TOTAL_BUDGET_MS2;
     const totalDeadline = Date.now() + totalBudget;
@@ -29473,7 +29547,7 @@ function parseWriteEnv(env = process.env) {
 }
 
 // src/http-server.ts
-var VERSION = true ? "0.32.1" : "0.0.0-dev";
+var VERSION = true ? "0.32.4" : "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

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

package/dist/installer-gui.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@leadbay/mcp",
-  "version": "0.32.1",
+  "version": "0.32.4",
   "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",