@leadbay/mcp 0.21.0 → 0.21.1

package/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Changelog — @leadbay/mcp
 
+## 0.21.1 — 2026-06-16
+
+- **CSV import no longer 400s on a lead status the agent didn't uppercase** (product#3745): `leadbay_import_leads` / `leadbay_import_and_qualify` forwarded `default_status` / `statuses` values verbatim to `POST /imports/{id}/update_mappings`, whose backend `MappingsPayload` decodes them as the strict, case-sensitive `LeadStatus` enum (`DEFAULT, INBOUND, UNWANTED, WANTED, LOST, WON`). A value like "Won" failed deserialization and the whole call 400'd with an opaque "JSON deserialization error" before any record committed — JM hit this trying to tag 179 companies as Won. The MCP now owns the canonical set and enforces it before sending: status values are matched case-insensitively to their enum member ("Won" → "WON"), an empty default means no default, and a genuinely unknown status returns a clear `IMPORT_INVALID_STATUS` error naming the valid values instead of an opaque backend 400. The two tools' input schemas now declare the enum.
+
 ## 0.21.0 — 2026-06-16
 
 - **Hosted MCP now triggers OAuth sign-in in Claude Desktop / ChatGPT** (remote custom connectors): the Fly endpoint was not an OAuth-compliant resource server, so a remote client had nothing to discover, never prompted the user to sign in, and then surfaced a host-side "needs auth / token expired" state even though the user never had a token. The server now implements the MCP authorization spec (RFC 9728): it serves OAuth 2.0 Protected Resource Metadata at `/.well-known/oauth-protected-resource[/<resource>]` and answers an unauthenticated (or invalid/expired) `POST /mcp` with `401` + `WWW-Authenticate: Bearer ... resource_metadata="…"`. The client discovers the Leadbay authorization server (the existing regional backend used by `login --oauth`) and runs the browser sign-in. Tool requests auto-probe both regions, so a valid token routes correctly and a stale one re-prompts instead of erroring.

package/dist/bin.js

@@ -10828,6 +10828,13 @@ function coerceCell(client, v, path) {
     return String(v);
   throw client.makeError("IMPORT_INVALID_CELL_TYPE", `Cell at ${path} is ${Array.isArray(v) ? "an array" : typeof v}, expected string|number|boolean|null`, `Convert the value to a string before passing.`, "POST /imports");
 }
+function enforceLeadStatus(client, raw, path) {
+  const canonical = String(raw).trim().toUpperCase();
+  if (!LEAD_STATUS_SET.has(canonical)) {
+    throw client.makeError("IMPORT_INVALID_STATUS", `${path} ${JSON.stringify(raw)} is not a valid lead status`, `Use one of ${LEAD_STATUSES.join(", ")} (case-insensitive), or omit it.`, "POST /imports");
+  }
+  return canonical;
+}
 function prepareDomainsMode(client, inputs) {
   const validInputs = [];
   const malformedDomains = [];
@@ -10949,6 +10956,12 @@ function prepareRecordsMode(client, records, mappings, customFieldCatalog) {
     if (normDomain && !byDomain.has(normDomain))
       byDomain.set(normDomain, idx);
   });
+  const statuses = {};
+  for (const [cell, status] of Object.entries(mappings.statuses ?? {})) {
+    statuses[cell] = enforceLeadStatus(client, status, `mappings.statuses[${JSON.stringify(cell)}]`);
+  }
+  const rawDefault = mappings.default_status;
+  const default_status = rawDefault == null || String(rawDefault).trim() === "" ? null : enforceLeadStatus(client, rawDefault, "mappings.default_status");
   return {
     mode: "records",
     validInputs,
@@ -10958,8 +10971,8 @@ function prepareRecordsMode(client, records, mappings, customFieldCatalog) {
     header,
     mappings: {
       fields: { ...normalizedFields },
-      statuses: mappings.statuses ?? {},
-      default_status: mappings.default_status ?? null
+      statuses,
+      default_status
     }
   };
 }
@@ -11334,7 +11347,7 @@ async function runImportInBackground(client, prep, uploadedChunks, opts, ctx, ha
     })();
   }, 0);
 }
-var CHUNK_SIZE, POLL_INTERVAL_MS2, DEFAULT_PER_PHASE_BUDGET_MS, DEFAULT_TOTAL_BUDGET_MS, STABILIZATION_POLLS, MAX_COLUMN_NAME_LEN, RESERVED_COLUMN_RE, CUSTOM_FIELD_RE, IMPORT_RESOLVER_FIELDS, PUBLIC_MAILBOX_DOMAINS, importLeads;
+var CHUNK_SIZE, POLL_INTERVAL_MS2, DEFAULT_PER_PHASE_BUDGET_MS, DEFAULT_TOTAL_BUDGET_MS, STABILIZATION_POLLS, MAX_COLUMN_NAME_LEN, RESERVED_COLUMN_RE, CUSTOM_FIELD_RE, IMPORT_RESOLVER_FIELDS, PUBLIC_MAILBOX_DOMAINS, LEAD_STATUSES, LEAD_STATUS_SET, importLeads;
 var init_import_leads = __esm({
   "../core/dist/composite/import-leads.js"() {
     "use strict";
@@ -11379,6 +11392,15 @@ var init_import_leads = __esm({
       "163.com",
       "126.com"
     ]);
+    LEAD_STATUSES = [
+      "DEFAULT",
+      "INBOUND",
+      "UNWANTED",
+      "WANTED",
+      "LOST",
+      "WON"
+    ];
+    LEAD_STATUS_SET = new Set(LEAD_STATUSES);
     importLeads = {
       name: "leadbay_import_leads",
       annotations: {
@@ -11437,11 +11459,12 @@ var init_import_leads = __esm({
               },
               statuses: {
                 type: "object",
-                description: "Optional status string mapping (rarely needed). Defaults to {}."
+                description: `Optional map of raw CSV status-cell text \u2192 lead status (rarely needed). Keys are the verbatim cell strings; values must be one of ${LEAD_STATUSES.join(", ")} (case-insensitive). Defaults to {}.`
               },
               default_status: {
                 type: ["string", "null"],
-                description: "Optional default status. Defaults to null."
+                enum: [...LEAD_STATUSES, null],
+                description: `Optional default lead status applied to rows without an explicit status. One of ${LEAD_STATUSES.join(", ")} (case-insensitive). Defaults to null.`
               }
             },
             required: ["fields"]
@@ -17499,8 +17522,15 @@ var init_import_and_qualify = __esm({
                 type: "object",
                 description: "Ergonomic shorthand: `{CsvColumn: <number-id>}` or `{CsvColumn: '<field-name>'}` for custom-field mappings. Resolved against /crm/custom_fields catalog."
               },
-              statuses: { type: "object", description: "Optional status string mapping." },
-              default_status: { type: ["string", "null"], description: "Optional default status." }
+              statuses: {
+                type: "object",
+                description: `Optional map of raw CSV status-cell text \u2192 lead status. Values must be one of ${LEAD_STATUSES.join(", ")} (case-insensitive); keys are the verbatim cell strings.`
+              },
+              default_status: {
+                type: ["string", "null"],
+                enum: [...LEAD_STATUSES, null],
+                description: `Optional default lead status. One of ${LEAD_STATUSES.join(", ")} (case-insensitive).`
+              }
             },
             // mappings has a closed shape (fields/custom_fields/statuses/default_status).
             // Inner objects (fields, custom_fields, statuses) keep open shapes
@@ -25928,7 +25958,7 @@ var OAUTH_BASE_URLS = {
     fr: "https://staging.api.leadbay.app"
   }
 };
-var VERSION = "0.21.0";
+var VERSION = "0.21.1";
 var HELP = `
 leadbay-mcp ${VERSION} \u2014 Leadbay Model Context Protocol server
 

package/dist/http-server.js

@@ -11524,6 +11524,22 @@ function coerceCell(client, v, path) {
     return String(v);
   throw client.makeError("IMPORT_INVALID_CELL_TYPE", `Cell at ${path} is ${Array.isArray(v) ? "an array" : typeof v}, expected string|number|boolean|null`, `Convert the value to a string before passing.`, "POST /imports");
 }
+var LEAD_STATUSES = [
+  "DEFAULT",
+  "INBOUND",
+  "UNWANTED",
+  "WANTED",
+  "LOST",
+  "WON"
+];
+var LEAD_STATUS_SET = new Set(LEAD_STATUSES);
+function enforceLeadStatus(client, raw, path) {
+  const canonical = String(raw).trim().toUpperCase();
+  if (!LEAD_STATUS_SET.has(canonical)) {
+    throw client.makeError("IMPORT_INVALID_STATUS", `${path} ${JSON.stringify(raw)} is not a valid lead status`, `Use one of ${LEAD_STATUSES.join(", ")} (case-insensitive), or omit it.`, "POST /imports");
+  }
+  return canonical;
+}
 function prepareDomainsMode(client, inputs) {
   const validInputs = [];
   const malformedDomains = [];
@@ -11645,6 +11661,12 @@ function prepareRecordsMode(client, records, mappings, customFieldCatalog) {
     if (normDomain && !byDomain.has(normDomain))
       byDomain.set(normDomain, idx);
   });
+  const statuses = {};
+  for (const [cell, status] of Object.entries(mappings.statuses ?? {})) {
+    statuses[cell] = enforceLeadStatus(client, status, `mappings.statuses[${JSON.stringify(cell)}]`);
+  }
+  const rawDefault = mappings.default_status;
+  const default_status = rawDefault == null || String(rawDefault).trim() === "" ? null : enforceLeadStatus(client, rawDefault, "mappings.default_status");
   return {
     mode: "records",
     validInputs,
@@ -11654,8 +11676,8 @@ function prepareRecordsMode(client, records, mappings, customFieldCatalog) {
     header,
     mappings: {
       fields: { ...normalizedFields },
-      statuses: mappings.statuses ?? {},
-      default_status: mappings.default_status ?? null
+      statuses,
+      default_status
     }
   };
 }
@@ -12048,11 +12070,12 @@ var importLeads = {
           },
           statuses: {
             type: "object",
-            description: "Optional status string mapping (rarely needed). Defaults to {}."
+            description: `Optional map of raw CSV status-cell text \u2192 lead status (rarely needed). Keys are the verbatim cell strings; values must be one of ${LEAD_STATUSES.join(", ")} (case-insensitive). Defaults to {}.`
           },
           default_status: {
             type: ["string", "null"],
-            description: "Optional default status. Defaults to null."
+            enum: [...LEAD_STATUSES, null],
+            description: `Optional default lead status applied to rows without an explicit status. One of ${LEAD_STATUSES.join(", ")} (case-insensitive). Defaults to null.`
           }
         },
         required: ["fields"]
@@ -17627,8 +17650,15 @@ var importAndQualify = {
             type: "object",
             description: "Ergonomic shorthand: `{CsvColumn: <number-id>}` or `{CsvColumn: '<field-name>'}` for custom-field mappings. Resolved against /crm/custom_fields catalog."
           },
-          statuses: { type: "object", description: "Optional status string mapping." },
-          default_status: { type: ["string", "null"], description: "Optional default status." }
+          statuses: {
+            type: "object",
+            description: `Optional map of raw CSV status-cell text \u2192 lead status. Values must be one of ${LEAD_STATUSES.join(", ")} (case-insensitive); keys are the verbatim cell strings.`
+          },
+          default_status: {
+            type: ["string", "null"],
+            enum: [...LEAD_STATUSES, null],
+            description: `Optional default lead status. One of ${LEAD_STATUSES.join(", ")} (case-insensitive).`
+          }
         },
         // mappings has a closed shape (fields/custom_fields/statuses/default_status).
         // Inner objects (fields, custom_fields, statuses) keep open shapes
@@ -22461,7 +22491,7 @@ function parseWriteEnv(env = process.env) {
 }
 
 // src/http-server.ts
-var VERSION = true ? "0.21.0" : "0.0.0-dev";
+var VERSION = true ? "0.21.1" : "0.0.0-dev";
 var PORT = Number(process.env.PORT ?? 8080);
 var HOST = process.env.HOST ?? "0.0.0.0";
 var sseSessions = /* @__PURE__ */ new Map();

package/dist/installer-electron.js

@@ -1466,7 +1466,7 @@ var init_installer_gui = __esm({
     init_install_dxt();
     init_install_shared();
     init_oauth();
-    VERSION = "0.21.0";
+    VERSION = "0.21.1";
     PORT = Number(process.env.LEADBAY_INSTALLER_PORT ?? 0);
     sessions = /* @__PURE__ */ new Map();
     OAUTH_BASE_URLS = {

package/dist/installer-gui.js

@@ -873,7 +873,7 @@ async function oauthLogin(opts) {
 }
 
 // installer/installer-gui.ts
-var VERSION = "0.21.0";
+var VERSION = "0.21.1";
 var PORT = Number(process.env.LEADBAY_INSTALLER_PORT ?? 0);
 var sessions = /* @__PURE__ */ new Map();
 var OAUTH_BASE_URLS = {

package/package.json

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