@leadbay/mcp 0.14.1 → 0.15.0

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # Changelog — @leadbay/mcp
 
+## 0.15.0 — 2026-05-27
+
+- **Sentry observability**: every non-2xx Leadbay API outcome now lands in
+  Sentry with the full envelope — `code`, `message`, `hint`, `endpoint`,
+  `region`, `http_status`, `latency_ms`, `retry_after`, agent `triggered_by`.
+  Previously business errors (NOT_FOUND, AUTH_EXPIRED, QUOTA_EXCEEDED,
+  FORBIDDEN, LEAD_NOT_FOUND, etc.) only landed in PostHog, and even the
+  unexpected throws that reached Sentry carried only a bare exception with
+  `tool` + `organization` tags. A new `source` tag (`business` vs
+  `unexpected`) plus per-event fingerprint `["mcp", tool, code]` keeps the
+  Sentry issue list groupable.
+- HTTP status now propagates through `LeadbayError._meta.http_status` so
+  `API_ERROR` (catch-all unmapped statuses) is filterable by status in
+  Sentry instead of collapsing into one undifferentiated bucket.
+
 ## 0.13.0 — 2026-05-21
 
 - **Agent memory v1**: added always-on recall/capture/review tools backed by

package/dist/bin.js

@@ -11,7 +11,7 @@ import {
   granularWriteTools,
   resolveAgentMemorySummary,
   resolveRegion
-} from "./chunk-SX4SKXMM.js";
+} from "./chunk-5IL7SC7L.js";
 
 // src/bin.ts
 import { realpathSync } from "fs";
@@ -1599,9 +1599,28 @@ function initTelemetry(opts) {
       try {
         Sentry.withScope((scope) => {
           scope.setTag("tool", ctx.tool);
+          if (ctx.code) scope.setTag("error_code", ctx.code);
+          if (ctx.endpoint) scope.setTag("endpoint", ctx.endpoint);
+          if (ctx.region) scope.setTag("region", ctx.region);
+          if (ctx.http_status !== void 0) {
+            scope.setTag("http_status", String(ctx.http_status));
+          }
+          if (ctx.source) scope.setTag("source", ctx.source);
           if (me?.organization?.id) {
             scope.setTag("organization", me.organization.id);
           }
+          if (ctx.message) scope.setExtra("message", ctx.message);
+          if (ctx.hint) scope.setExtra("hint", ctx.hint);
+          if (ctx.triggered_by) scope.setExtra("triggered_by", ctx.triggered_by);
+          if (ctx.latency_ms !== void 0 && ctx.latency_ms !== null) {
+            scope.setExtra("latency_ms", ctx.latency_ms);
+          }
+          if (ctx.retry_after !== void 0 && ctx.retry_after !== null) {
+            scope.setExtra("retry_after", ctx.retry_after);
+          }
+          if (ctx.code && ctx.source === "business") {
+            scope.setFingerprint(["mcp", ctx.tool, ctx.code]);
+          }
           Sentry.captureException(err);
         });
       } catch (e) {
@@ -2265,6 +2284,22 @@ function buildServer(client, opts = {}) {
     }
   };
   const isLeadbayBusinessError = (err) => err != null && typeof err === "object" && err.error === true && typeof err.code === "string";
+  const buildBusinessCtx = (toolName, envelope, triggered_by) => {
+    const meta = envelope._meta ?? {};
+    return {
+      tool: toolName,
+      code: envelope.code,
+      message: envelope.message,
+      hint: envelope.hint,
+      endpoint: meta.endpoint,
+      region: meta.region,
+      latency_ms: meta.latency_ms ?? null,
+      retry_after: meta.retry_after ?? null,
+      http_status: meta.http_status,
+      triggered_by,
+      source: "business"
+    };
+  };
   const captureFrictionTelemetry = (toolName, result) => {
     if (toolName !== "leadbay_report_friction") return;
     if (!result || typeof result !== "object") return;
@@ -2384,6 +2419,10 @@ function buildServer(client, opts = {}) {
           error_code: envCode,
           triggered_by
         });
+        telemetry.captureException(
+          result,
+          buildBusinessCtx(name, result, triggered_by)
+        );
         if (DEBUG_ON) {
           process.stderr.write(
             `[leadbay-mcp debug] tool=${name} dur=${envDur}ms ok=false code=${envCode}
@@ -2481,8 +2520,14 @@ function buildServer(client, opts = {}) {
           error_code: code,
           triggered_by
         });
+        telemetry.captureException(err, buildBusinessCtx(name, err, triggered_by));
       } else {
-        telemetry.captureException(err, { tool: name });
+        telemetry.captureException(err, {
+          tool: name,
+          source: "unexpected",
+          message: typeof err?.message === "string" ? err.message : void 0,
+          triggered_by
+        });
         telemetry.captureToolCall({
           tool: name,
           ok: false,
@@ -2705,7 +2750,7 @@ async function createDefaultUpdateStateStore(opts = {}) {
 
 // src/bin.ts
 import { createRequire } from "module";
-var VERSION = "0.14.1";
+var VERSION = "0.15.0";
 var HELP = `
 leadbay-mcp ${VERSION} \u2014 Leadbay Model Context Protocol server
 
@@ -3055,7 +3100,7 @@ async function runLogin(args) {
   let result;
   try {
     if (pinnedRegion && !allowFallback) {
-      const { REGIONS } = await import("./dist-CRE74TH2.js");
+      const { REGIONS } = await import("./dist-2NAFYPXG.js");
       const baseUrl = REGIONS[pinnedRegion];
       const c = createClient({ region: pinnedRegion });
       const token = await loginAt(baseUrl, email, password);
@@ -3555,7 +3600,7 @@ leadbay-mcp install \u2014 detected MCP clients on this machine:
   let region;
   try {
     if (pinnedRegion && !allowFallback) {
-      const { REGIONS } = await import("./dist-CRE74TH2.js");
+      const { REGIONS } = await import("./dist-2NAFYPXG.js");
       const baseUrl = REGIONS[pinnedRegion];
       token = await loginAt(baseUrl, email, password);
       region = pinnedRegion;

package/dist/{chunk-SX4SKXMM.js → chunk-5IL7SC7L.js}

@@ -416,7 +416,7 @@ var LeadbayClient = class {
     }
     const retryAfter = parseRetryAfter(headers["retry-after"]);
     if (status === 401) {
-      return this.makeError("AUTH_EXPIRED", "Authentication token expired or invalid", "Your LEADBAY_TOKEN is no longer valid. Regenerate it: npx -y @leadbay/mcp login --email <you> --region <us|fr>, then restart your MCP client.", endpoint);
+      return this.makeError("AUTH_EXPIRED", "Authentication token expired or invalid", "Your LEADBAY_TOKEN is no longer valid. Regenerate it: npx -y @leadbay/mcp login --email <you> --region <us|fr>, then restart your MCP client.", endpoint, null, status);
     }
     if (status === 429 || status === 402 || parsed?.error === "quota_exceeded" || parsed?.error?.code === "quota_exceeded") {
       const hintBase = retryAfter ? `Wait ${retryAfter}s before retrying` : "Wait, then retry";
@@ -432,20 +432,21 @@ var LeadbayClient = class {
         // 429 is stale — retry the failed call.
         `${hintBase}, OR top up AI credits \u2014 top-ups clear the throttle immediately. Offer the user to generate a Stripe checkout URL via leadbay_create_topup_link, OR direct them to app.leadbay.ai \u2192 Billing. Check leadbay_account_status / leadbay_get_quota to see which resource window (daily/weekly/monthly) was hit. Once the user has topped up, the previous QUOTA_EXCEEDED is stale \u2014 re-call leadbay_account_status to refresh, then RETRY the original operation.`,
         endpoint,
-        retryAfter
+        retryAfter,
+        status
       );
     }
     if (status === 403) {
       const msg = parsed?.message || parsed?.error || parsed?.error?.message || "";
       if (typeof msg === "string" && (msg.includes("suspend") || msg.includes("billing"))) {
-        return this.makeError("BILLING_SUSPENDED", "Account billing is suspended", "Your Leadbay account billing is suspended. Contact Leadbay support.", endpoint);
+        return this.makeError("BILLING_SUSPENDED", "Account billing is suspended", "Your Leadbay account billing is suspended. Contact Leadbay support.", endpoint, null, status);
       }
-      return this.makeError("FORBIDDEN", "Insufficient permissions", "Your token does not have access to this resource. Contact Leadbay support to verify account permissions.", endpoint);
+      return this.makeError("FORBIDDEN", "Insufficient permissions", "Your token does not have access to this resource. Contact Leadbay support to verify account permissions.", endpoint, null, status);
     }
     if (status === 404) {
-      return this.makeError("NOT_FOUND", parsed?.message || parsed?.error?.message || "Resource not found", "Verify the ID is correct", endpoint);
+      return this.makeError("NOT_FOUND", parsed?.message || parsed?.error?.message || "Resource not found", "Verify the ID is correct", endpoint, null, status);
     }
-    return this.makeError("API_ERROR", parsed?.message || parsed?.error?.message || `API error (${status})`, "Try again or check the Leadbay API status", endpoint);
+    return this.makeError("API_ERROR", parsed?.message || parsed?.error?.message || `API error (${status})`, "Try again or check the Leadbay API status", endpoint, null, status);
   }
   // /me cache (60s TTL). Separate from resolveOrgId() which still works for
   // legacy callers (it now delegates here).
@@ -524,14 +525,15 @@ var LeadbayClient = class {
     await this.resolveOrgId();
     await this.resolveTasteProfile();
   }
-  makeError(code, message, hint, endpoint, retry_after) {
+  makeError(code, message, hint, endpoint, retry_after, http_status) {
     const out = { error: true, code, message, hint };
     if (endpoint || this._region) {
       out._meta = {
         region: this._region,
         endpoint: endpoint ?? "",
         latency_ms: this._lastMeta?.latency_ms ?? null,
-        retry_after: retry_after ?? null
+        retry_after: retry_after ?? null,
+        ...http_status !== void 0 ? { http_status } : {}
       };
     }
     return out;
@@ -4983,7 +4985,7 @@ var leadbay_add_leads_to_campaign = `## WHEN TO USE
 
 Trigger phrases: "add leads to <name> campaign", "attach these to <campaign>", "put these in Q2 Push", "add to existing campaign".
 
-Do NOT use for: "create a new campaign" \u2192 \`leadbay_create_campaign\`; "remove lead from campaign" \u2192 \`leadbay_create_campaign\`; "list campaigns" \u2192 \`leadbay_list_campaigns\`.
+Do NOT use for: "create a new campaign" \u2192 \`leadbay_create_campaign\`; "remove lead from campaign" \u2192 \`leadbay_remove_leads_from_campaign\`; "list campaigns" \u2192 \`leadbay_list_campaigns\`.
 
 Prefer when: existing campaign plus lead ids to attach; for a new campaign, use create_campaign
 
@@ -5021,7 +5023,7 @@ Attach a list of \`lead_ids\` to an existing campaign. Wraps \`POST /campaigns/{
 
 WHEN TO USE: the user has an existing campaign (created earlier in the session or visible via \`leadbay_list_campaigns\`) and wants to attach more leads to it.
 
-WHEN NOT TO USE: to create a NEW campaign (use \`leadbay_create_campaign\` with \`lead_ids\` seeded); to list campaigns (\`leadbay_list_campaigns\`); to view per-lead progression (\`leadbay_campaign_progression\`); to remove leads (not currently exposed in the MCP \u2014 direct backend \`DELETE /campaigns/{id}/leads\` would be needed).
+WHEN NOT TO USE: to create a NEW campaign (use \`leadbay_create_campaign\` with \`lead_ids\` seeded); to list campaigns (\`leadbay_list_campaigns\`); to view per-lead progression (\`leadbay_campaign_progression\`); to remove leads (use \`leadbay_remove_leads_from_campaign\`).
 
 **Response**: \`{added: number, already_present: number}\`. Use both counts in the confirmation \u2014 silent dedup hides useful information from the user.
 `;
@@ -6793,6 +6795,48 @@ WHEN NOT TO USE: to change status \u2014 call leadbay_set_epilogue_status with t
 
 This tool MUTATES state. The caller (agent or human-in-the-loop) is responsible for confirming intent before invocation; the MCP server does not soft-prompt for confirmation. See \`annotations.destructiveHint\`.
 `;
+var leadbay_remove_leads_from_campaign = `## WHEN TO USE
+
+Trigger phrases: "remove lead from campaign", "take this out of <campaign>", "remove these from Q2 Push", "delete lead from campaign", "clean up campaign".
+
+Do NOT use for: "add leads to campaign" \u2192 \`leadbay_add_leads_to_campaign\`; "create a new campaign" \u2192 \`leadbay_create_campaign\`; "list campaigns" \u2192 \`leadbay_list_campaigns\`.
+
+Prefer when: user wants to detach one or more leads from an existing campaign
+
+**Memory:** recall + capture via \`leadbay_agent_memory_*\` tools.
+
+Examples that SHOULD invoke this tool:
+- "Remove the Austin lead from my Q2 Push campaign."
+- "Take these 3 unqualified leads out of the Limoges Tour."
+- "Clean up campaign 1f12 \u2014 remove leads that bounced."
+
+Examples that should NOT invoke this tool (sound similar, route elsewhere):
+- "Add the top 5 to my Q2 Push."
+- "Create a new campaign with these 9 leads."
+- "What campaigns do I have?"
+
+## RENDER (quick)
+
+One-line confirmation: \u2705 Removed N leads from <campaign-name>.
+Offer NEXT STEPS chip for "View progression" (campaign_progression)
+or "Add different leads" (add_leads_to_campaign).
+
+---
+
+Detach a list of \`lead_ids\` from an existing campaign. Wraps \`DELETE /campaigns/{id}/leads\`. The backend returns 204 with no body when the mutation succeeds, so this tool returns a synthetic \`{removed}\` count equal to the number of submitted lead IDs.
+
+**Lead UUID source**: pass UUIDs returned from \`leadbay_pull_leads\`, \`leadbay_campaign_call_sheet\`, or \`leadbay_campaign_progression\`.
+
+**Why batch**: prefer one call with N leads over N calls with one lead each \u2014 the backend rebuilds campaign membership server-side on each call.
+
+---
+
+WHEN TO USE: the user wants to detach leads from an existing campaign \u2014 e.g. to clean out bounced contacts, remove disqualified leads, or correct an accidental add.
+
+WHEN NOT TO USE: to add leads (use \`leadbay_add_leads_to_campaign\`); to create a new campaign (\`leadbay_create_campaign\`); to view campaign status (\`leadbay_campaign_progression\`).
+
+**Response**: \`{removed: number}\` \u2014 synthetic count equal to the number of \`lead_ids\` submitted (backend returns 204 with no body).
+`;
 var leadbay_remove_pushback = `Clear an active pushback on one or more leads. They re-enter \`leadbay_pull_followups\` immediately. Use when the user changes their mind ("actually let's reach out now"), or when external context shifts (the company announces hiring / funding / a new product that makes them ripe sooner than the deferral window expected).
 
 Bulk-native: pass up to 1000 lead UUIDs per call. No status enum \u2014 pushback is binary (either an active window exists, or it doesn't).
@@ -12328,6 +12372,51 @@ var addLeadsToCampaign = {
   }
 };
 
+// ../core/dist/composite/remove-leads-from-campaign.js
+var removeLeadsFromCampaign = {
+  name: "leadbay_remove_leads_from_campaign",
+  annotations: {
+    title: "Remove leads from a campaign",
+    readOnlyHint: false,
+    destructiveHint: true,
+    idempotentHint: true,
+    openWorldHint: true
+  },
+  description: leadbay_remove_leads_from_campaign,
+  optional: true,
+  inputSchema: {
+    type: "object",
+    properties: {
+      campaign_id: {
+        type: "string",
+        description: "Campaign UUID (from leadbay_create_campaign or leadbay_list_campaigns)."
+      },
+      lead_ids: {
+        type: "array",
+        description: "Lead UUIDs to remove. Pass IDs sourced from Leadbay tools; invalid IDs are handled by the backend.",
+        items: { type: "string" },
+        minItems: 1
+      }
+    },
+    required: ["campaign_id", "lead_ids"],
+    additionalProperties: false
+  },
+  outputSchema: {
+    type: "object",
+    properties: {
+      removed: { type: "number", description: "Number of leads submitted for removal (backend returns 204, no per-lead breakdown)." }
+    },
+    required: ["removed"]
+  },
+  execute: async (client, params) => {
+    if (!params.lead_ids || params.lead_ids.length === 0) {
+      throw client.makeError("INVALID_PARAMS", "lead_ids must be a non-empty array", "Pass at least one lead UUID to remove.");
+    }
+    await client.requestVoid("DELETE", `/campaigns/${params.campaign_id}/leads`, { lead_ids: params.lead_ids });
+    return { removed: params.lead_ids.length };
+  }
+};
+
 // ../core/dist/composite/list-campaigns.js
 var listCampaigns = {
   name: "leadbay_list_campaigns",
@@ -17557,7 +17646,8 @@ var compositeWriteTools = [
   // Campaign write composites — persist a hand-picked cohort of leads.
   // Backend POST endpoints; gated behind LEADBAY_MCP_WRITE=1 in MCP.
   createCampaign,
-  addLeadsToCampaign
+  addLeadsToCampaign,
+  removeLeadsFromCampaign
 ];
 var compositeTools = [
   ...compositeReadTools,
@@ -17658,6 +17748,7 @@ export {
   tourPlan,
   createCampaign,
   addLeadsToCampaign,
+  removeLeadsFromCampaign,
   listCampaigns,
   campaignProgression,
   campaignCallSheet,

package/dist/{dist-CRE74TH2.js → dist-2NAFYPXG.js}

@@ -102,6 +102,7 @@ import {
   recallOrderedTitles,
   refinePrompt,
   removeEpilogue,
+  removeLeadsFromCampaign,
   removePushback,
   reportFriction,
   reportOutreach,
@@ -123,7 +124,7 @@ import {
   updateLens,
   updateLensFilter,
   withAgentMemoryMeta
-} from "./chunk-SX4SKXMM.js";
+} from "./chunk-5IL7SC7L.js";
 export {
   AgentMemoryCaptureInputSchema,
   AgentMemoryEntrySchema,
@@ -227,6 +228,7 @@ export {
   recallOrderedTitles,
   refinePrompt,
   removeEpilogue,
+  removeLeadsFromCampaign,
   removePushback,
   reportFriction,
   reportOutreach,

package/package.json

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