conduyt-mcp 4.86.0 → 4.88.0

package/dist/tools/contacts.d.ts

@@ -9,4 +9,5 @@ export declare const MERGE_TIMEOUT_MS = 75000;
 export declare const LOSER_ORDER_NOTE = "losers are merged in the order given: for each field the survivor lacks, the first loser in this order with a value wins; reorder to change precedence; the dry run's filledFields shows which fields will be filled";
 export declare const MERGE_PREVIEW_MAX = 50;
 export declare const MERGE_PREVIEW_TTL_MS: number;
+export declare const EMAIL_LOOKUP_NOTE = "Exact email lookup: one address, or up to 20 distinct addresses in an array. Each is trimmed and lower-cased and matches the contact's primary email OR any secondary email slot (email_2 and up); it is an exact match, not a substring search (use `search` for partial text). Combines with every other filter (AND) inside your account and visibility. An empty or invalid address, or more than 20 distinct addresses, is a 400. On a workspace whose identifier index is still being built, the lookup answers 422 when the stored spellings of the requested addresses exceed its stored-spelling bind budget (a count of spellings, not of contacts; other filters do not help); ask support to complete the identifier backfill. Send addresses once; duplicates collapse.";
 export declare function registerContactTools(server: McpServer, client: ConduytClient): void;

package/dist/tools/contacts.js

@@ -52,10 +52,14 @@ function createMergePreviewStore() {
         drop(key) { rows.delete(key); },
     };
 }
+/** (API ?email=, app main 318adf38d) exact lookup of one address; the API trims and lower-cases, so a stray space is harmless */
+const EMAIL_LOOKUP_ONE = z.string().trim().min(1).max(254);
+export const EMAIL_LOOKUP_NOTE = "Exact email lookup: one address, or up to 20 distinct addresses in an array. Each is trimmed and lower-cased and matches the contact's primary email OR any secondary email slot (email_2 and up); it is an exact match, not a substring search (use `search` for partial text). Combines with every other filter (AND) inside your account and visibility. An empty or invalid address, or more than 20 distinct addresses, is a 400. On a workspace whose identifier index is still being built, the lookup answers 422 when the stored spellings of the requested addresses exceed its stored-spelling bind budget (a count of spellings, not of contacts; other filters do not help); ask support to complete the identifier backfill. Send addresses once; duplicates collapse.";
 export function registerContactTools(server, client) {
     const mergePreviews = createMergePreviewStore();
-    server.tool("conduyt_list_contacts", "List and search contacts with filtering. Returns paginated results with name, email, phone, tags, source, and assignee. Each row carries `revision` (integer save revision; pass it back as expectedRevision on conduyt_update_contact or the collaborator tools).", {
+    server.tool("conduyt_list_contacts", "List and search contacts with filtering. To find the contact(s) holding a known email address, pass `email` (exact match on the primary or any secondary email); `search` is a substring search. Returns paginated results with name, email, phone, tags, source, and assignee. Each row carries `revision` (integer save revision; pass it back as expectedRevision on conduyt_update_contact or the collaborator tools).", {
         search: z.string().optional().describe("Search by name, email, or phone number"),
+        email: z.union([EMAIL_LOOKUP_ONE, z.array(EMAIL_LOOKUP_ONE).min(1).max(20)]).optional().describe(EMAIL_LOOKUP_NOTE),
         tag: z.string().optional().describe("Filter by tag name"),
         source: z.string().optional().describe("Filter by source (e.g. 'signup', 'import', 'manual')"),
         assignedTo: z.string().optional().describe("Filter by assigned user ID"),
@@ -63,10 +67,13 @@ export function registerContactTools(server, client) {
         excludeMasterStatus: z.array(z.string().trim().min(1).max(40)).max(20).optional().describe("Hide contacts whose lead status is one of these — e.g. ['won','lost','abandoned','disqualified'] is the 'Active' view. Naming a status in both lists is a 400."),
         page: z.number().optional().describe("Page number (default 1)"),
         per_page: z.number().optional().describe("Results per page (default 25, max 100)"),
-    }, async ({ search, tag, source, assignedTo, masterStatus, excludeMasterStatus, page, per_page }) => {
+    }, async ({ search, email, tag, source, assignedTo, masterStatus, excludeMasterStatus, page, per_page }) => {
         const params = new URLSearchParams();
         if (search)
             params.set("search", search);
+        // repeated `email` params, one per address (the API reads every occurrence); an omitted or empty array sends none
+        for (const address of email === undefined ? [] : Array.isArray(email) ? email : [email])
+            params.append("email", address);
         if (tag)
             params.set("tag", tag);
         if (source)

package/dist/tools/saved-filters.d.ts

@@ -1,3 +1,4 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { ConduytClient } from "../client.js";
+export declare const SMART_VIEW_ICON_IDS: readonly ["heart", "star", "trophy", "badge", "target", "eye", "clock", "hourglass", "siren", "bolt", "fire", "rain", "funnel", "pyramid", "flag", "pin", "push-pin", "thumbs-up", "thumbs-down", "coffee", "rocket", "number-1", "number-2", "number-3", "number-4", "number-5", "number-6", "number-7", "number-8", "number-9"];
 export declare function registerSavedFilterTools(server: McpServer, client: ConduytClient): void;

package/dist/tools/saved-filters.js

@@ -26,6 +26,14 @@ const filtersSchema = z
     .union([z.array(groupSchema).max(10), z.array(ruleSchema).max(20)])
     .optional()
     .describe('Grouped filter payload (max 10 groups × 20 rules), e.g. [{"conjunction":"AND","rules":[{"field":"source","operator":"equals","value":"facebook"}]}]. A flat rule array is also accepted and saved as a single AND group. Omit for an empty filter set.');
+// The 30 current Smart View icon ids in picker order (app branch fable/smart-view-icons: public/smart-view-icons/manifest.json,
+// lib/smart-view-icons.ts). The 17 legacy ids the API still accepts as deprecated inputs are deliberately NOT advertised here.
+export const SMART_VIEW_ICON_IDS = [
+    "heart", "star", "trophy", "badge", "target", "eye", "clock", "hourglass", "siren", "bolt",
+    "fire", "rain", "funnel", "pyramid", "flag", "pin", "push-pin", "thumbs-up", "thumbs-down", "coffee",
+    "rocket", "number-1", "number-2", "number-3", "number-4", "number-5", "number-6", "number-7", "number-8", "number-9",
+];
+const iconSchema = (omitted) => z.enum(SMART_VIEW_ICON_IDS).optional().describe(`The view's icon, one of: ${SMART_VIEW_ICON_IDS.join(", ")}. ${omitted}. This tool accepts current ids only.`);
 export function registerSavedFilterTools(server, client) {
     server.tool("conduyt_list_saved_filters", "List YOUR saved contact filters (the web app's 'Saved' dropdown on All Contacts). Each entry has a name, the grouped filter payload, and sort. Saved filters are personal to the API key's user. Requires the 'saved-filters' scope.", {
         entity_type: z.enum(["contact"]).optional().describe("Entity type (default 'contact')"),
@@ -43,11 +51,12 @@ export function registerSavedFilterTools(server, client) {
         sortField: z.string().optional().describe("Sort field applied with the filter (default createdAt)"),
         sortOrder: z.enum(["asc", "desc"]).optional().describe("Sort direction (default desc)"),
         entityType: z.enum(["contact"]).optional().describe("Entity type (default 'contact')"),
+        icon: iconSchema("Omitted: default heart"),
     }, async (params) => {
         // (Smart Views 09-24) saved filters are personal Smart Views now: the same body creates one (personal for a
         // rep key; an admin key creates a SHARED view, admins have no private filters); POST /saved-filters is retired (410)
         // personal: true keeps the saved-filter contract for EVERY key (an admin key creates a private view, never a shared one)
-        const result = await client.post("/api/v1/smart-views", { name: params.name, filters: params.filters, sortField: params.sortField, sortOrder: params.sortOrder, personal: true });
+        const result = await client.post("/api/v1/smart-views", { name: params.name, filters: params.filters, sortField: params.sortField, sortOrder: params.sortOrder, icon: params.icon, personal: true });
         return formatResult(result);
     });
     server.tool("conduyt_update_saved_filter", "Rename a saved filter (a personal Smart View) or replace its filters/sort. Owner-only — a personal view is its owner's for every role. Use conduyt_list_saved_filters or conduyt_list_smart_views to find the id. Requires the 'saved-filters' scope.", {
@@ -56,7 +65,8 @@ export function registerSavedFilterTools(server, client) {
         filters: filtersSchema,
         sortField: z.string().optional(),
         sortOrder: z.enum(["asc", "desc"]).optional(),
-    }, async ({ id, name, filters, sortField, sortOrder }) => {
+        icon: iconSchema("Omitted: unchanged"),
+    }, async ({ id, name, filters, sortField, sortOrder, icon }) => {
         // Inline body (undefined fields drop out in JSON) — keeps the shape
         // readable by the contract verifier's static parser.
         const result = await client.patch(`/api/v1/smart-views/${encodeURIComponent(id)}`, {
@@ -64,6 +74,7 @@ export function registerSavedFilterTools(server, client) {
             filters,
             sortField,
             sortOrder,
+            icon,
         });
         return formatResult(result);
     });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "conduyt-mcp",
-  "version": "4.86.0",
+  "version": "4.88.0",
   "mcpName": "com.conduyt/mcp",
   "description": "MCP server for Conduyt CRM — expose CRM operations as AI-accessible tools",
   "type": "module",

package/scripts/coverage-matrix.json

@@ -1,11 +1,11 @@
 {
-  "generatedAt": "2026-10-13T14:36:32.489Z",
+  "generatedAt": "2026-10-15T02:16:36.008Z",
   "toolCount": 350,
-  "totalEndpoints": 1080,
+  "totalEndpoints": 1084,
   "counts": {
     "covered": 309,
-    "excluded": 321,
-    "planned": 450,
+    "excluded": 323,
+    "planned": 452,
     "uncategorized": 0
   },
   "matrix": {
@@ -1941,6 +1941,10 @@
       "status": "excluded",
       "reason": "CRON_SECRET-gated infrastructure jobs; never key-callable"
     },
+    "GET /api/v1/cron/recover-attachment-ledgers": {
+      "status": "excluded",
+      "reason": "CRON_SECRET-gated infrastructure jobs; never key-callable"
+    },
     "GET /api/v1/cron/recover-booking-side-effects": {
       "status": "excluded",
       "reason": "CRON_SECRET-gated infrastructure jobs; never key-callable"
@@ -1957,6 +1961,10 @@
       "status": "excluded",
       "reason": "CRON_SECRET-gated infrastructure jobs; never key-callable"
     },
+    "GET /api/v1/cron/release-google-grants": {
+      "status": "excluded",
+      "reason": "CRON_SECRET-gated infrastructure jobs; never key-callable"
+    },
     "GET /api/v1/cron/reply-capture-drain": {
       "status": "excluded",
       "reason": "CRON_SECRET-gated infrastructure jobs; never key-callable"
@@ -3227,10 +3235,18 @@
       "status": "planned",
       "reason": "lead routing rule management"
     },
+    "GET /api/v1/mailbox/callback/google": {
+      "status": "planned",
+      "reason": "mailbox sync surfaces"
+    },
     "GET /api/v1/mailbox/callback/microsoft": {
       "status": "planned",
       "reason": "mailbox sync surfaces"
     },
+    "POST /api/v1/mailbox/connect/google": {
+      "status": "planned",
+      "reason": "mailbox sync surfaces"
+    },
     "POST /api/v1/mailbox/connect/microsoft": {
       "status": "planned",
       "reason": "mailbox sync surfaces"