conduyt-mcp 4.87.0 → 4.89.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/dialer-settings.d.ts

@@ -1,4 +1,5 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
 import { ConduytClient } from "../client.js";
 type DisclosureOn = "inbound" | "outbound" | "both";
 type RecordingPolicy = {
@@ -20,6 +21,8 @@ type RecordingPolicy = {
 export declare function effectiveRecordingPolicy(raw: unknown): RecordingPolicy | null;
 /** the iPhone line has no inbound calls: what its policy does there, the way the server applies it */
 export declare function iphoneDomain(policy: RecordingPolicy): RecordingPolicy;
+/** 0 = the wrap-up auto-release is off, otherwise 30..3600 seconds (the API refuses anything else with 400) */
+export declare const wrapupAutoReleaseSecondsSchema: z.ZodEffects<z.ZodNumber, number, number>;
 /**
  * Smart Dialing policy (GET/PATCH /api/v1/dialer/settings): the account-wide rules every rep's Smart Dialing run
  * follows. Read needs the dialer scope; update needs the settings scope (admin). (#95/#96, 2026-09-16)

package/dist/tools/dialer-settings.js

@@ -29,24 +29,27 @@ export function iphoneDomain(policy) {
     const on = policy.disclosure.on;
     return { ...policy, inbound: false, disclosure: on === "inbound" ? { enabled: false, on: "outbound" } : { enabled: policy.disclosure.enabled, on: "outbound" } };
 }
+/** 0 = the wrap-up auto-release is off, otherwise 30..3600 seconds (the API refuses anything else with 400) */
+export const wrapupAutoReleaseSecondsSchema = z.number().int().refine((n) => n === 0 || (n >= 30 && n <= 3600), "wrapupAutoReleaseSeconds must be 0 (off) or a whole number of seconds from 30 to 3600");
 /**
  * Smart Dialing policy (GET/PATCH /api/v1/dialer/settings): the account-wide rules every rep's Smart Dialing run
  * follows. Read needs the dialer scope; update needs the settings scope (admin). (#95/#96, 2026-09-16)
  */
 export function registerDialerSettingsTools(server, client) {
-    server.tool("conduyt_get_dialer_settings", "Read the account's Smart Dialing policy: autoAdvanceEnabled + pauseSeconds + advanceOn ('disposition' = the next dial waits for a saved disposition, 'timer' = the pause starts when the call ends), openLeadOnDial (the lead's record opens as each Smart Dialing call goes out), smartDialCallerId ('local_presence' = an area-code match from the number pool, the rep's own line when no pool exists; 'did' = always the rep's own line), and localPresenceConfigured (whether a number pool exists).", {}, async () => formatResult(await client.get("/api/v1/dialer/settings")));
-    server.tool("conduyt_update_dialer_settings", "Change the account's Smart Dialing policy (admin: settings scope). Send only the fields to change: autoAdvanceEnabled, pauseSeconds (1-60), advanceOn ('disposition' | 'timer'), openLeadOnDial (true = the lead's record opens as each Smart Dialing call goes out), smartDialCallerId ('local_presence' | 'did'). Returns the policy as saved.", {
+    server.tool("conduyt_get_dialer_settings", "Read the account's Smart Dialing policy: autoAdvanceEnabled + pauseSeconds + advanceOn ('disposition' = the next dial waits for a saved disposition, 'timer' = the pause starts when the call ends), openLeadOnDial (the lead's record opens as each Smart Dialing call goes out), smartDialCallerId ('local_presence' = an area-code match from the number pool, the rep's own line when no pool exists; 'did' = always the rep's own line), wrapupAutoReleaseSeconds (seconds of continuous wrap-up after which a rep returns to Available automatically: 0 = off, otherwise 30 to 3600; default 300), and localPresenceConfigured (whether a number pool exists).", {}, async () => formatResult(await client.get("/api/v1/dialer/settings")));
+    server.tool("conduyt_update_dialer_settings", "Change the account's Smart Dialing policy (admin: settings scope). Send only the fields to change: autoAdvanceEnabled, pauseSeconds (1-60), advanceOn ('disposition' | 'timer'), openLeadOnDial (true = the lead's record opens as each Smart Dialing call goes out), smartDialCallerId ('local_presence' | 'did'), wrapupAutoReleaseSeconds (0 = off, otherwise 30 to 3600: seconds of continuous wrap-up after which a rep returns to Available automatically). Returns the policy as saved.", {
         autoAdvanceEnabled: z.boolean().optional().describe("Start the next dial automatically after a call"),
         pauseSeconds: z.number().int().min(1).max(60).optional().describe("Seconds between calls when auto-advance is on"),
         advanceOn: z.enum(["disposition", "timer"]).optional().describe("'disposition': wait for a saved disposition; 'timer': the pause starts when the call ends"),
         openLeadOnDial: z.boolean().optional().describe("Open the lead's record as each Smart Dialing call goes out (default true)"),
         smartDialCallerId: z.enum(["local_presence", "did"]).optional().describe("Line Smart Dialing calls go out on: Local Presence (default) or the rep's own DID"),
-    }, async ({ autoAdvanceEnabled, pauseSeconds, advanceOn, openLeadOnDial, smartDialCallerId }) => {
-        if ([autoAdvanceEnabled, pauseSeconds, advanceOn, openLeadOnDial, smartDialCallerId].every((v) => v === undefined)) {
-            return { content: [{ type: "text", text: "Nothing to change: pass at least one of autoAdvanceEnabled, pauseSeconds, advanceOn, openLeadOnDial, smartDialCallerId." }], isError: true };
+        wrapupAutoReleaseSeconds: wrapupAutoReleaseSecondsSchema.optional().describe("Seconds of continuous wrap-up after which a rep returns to Available automatically: 0 = off, otherwise 30 to 3600 (default 300)"),
+    }, async ({ autoAdvanceEnabled, pauseSeconds, advanceOn, openLeadOnDial, smartDialCallerId, wrapupAutoReleaseSeconds }) => {
+        if ([autoAdvanceEnabled, pauseSeconds, advanceOn, openLeadOnDial, smartDialCallerId, wrapupAutoReleaseSeconds].every((v) => v === undefined)) {
+            return { content: [{ type: "text", text: "Nothing to change: pass at least one of autoAdvanceEnabled, pauseSeconds, advanceOn, openLeadOnDial, smartDialCallerId, wrapupAutoReleaseSeconds." }], isError: true };
         }
         // undefined fields drop out of the JSON body, so only the named changes reach the route
-        const result = await client.patch("/api/v1/dialer/settings", { autoAdvanceEnabled, pauseSeconds, advanceOn, openLeadOnDial, smartDialCallerId });
+        const result = await client.patch("/api/v1/dialer/settings", { autoAdvanceEnabled, pauseSeconds, advanceOn, openLeadOnDial, smartDialCallerId, wrapupAutoReleaseSeconds });
         return formatResult(result);
     });
     // Call recording policy (the Call recording card of Settings, released 2026-09-30): which calls are recorded and

package/package.json

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

package/scripts/coverage-manifest.json

@@ -10,6 +10,11 @@
       "status": "planned",
       "reason": "single-function read; the list tool plus update/delete/test exist, a typed get is wanted but not built (4.23.0)"
     },
+    {
+      "match": "POST /api/v1/feature-interest",
+      "status": "excluded",
+      "reason": "session-only UI endpoint, not an API-key capability (the signed-in user's interest click on an unreleased feature, e.g. the Gmail inbox; no API-key access)"
+    },
     {
       "match": "/api/health",
       "status": "excluded",

package/scripts/coverage-matrix.json

@@ -1,11 +1,11 @@
 {
-  "generatedAt": "2026-10-13T14:36:32.489Z",
+  "generatedAt": "2026-10-15T15:19:50.604Z",
   "toolCount": 350,
-  "totalEndpoints": 1080,
+  "totalEndpoints": 1085,
   "counts": {
     "covered": 309,
-    "excluded": 321,
-    "planned": 450,
+    "excluded": 324,
+    "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"
@@ -2826,6 +2834,10 @@
       "status": "planned",
       "reason": "client error ingestion"
     },
+    "POST /api/v1/feature-interest": {
+      "status": "excluded",
+      "reason": "session-only UI endpoint, not an API-key capability (the signed-in user's interest click on an unreleased feature, e.g. the Gmail inbox; no API-key access)"
+    },
     "GET /api/v1/files": {
       "status": "planned",
       "reason": "file listing/metadata is agent-useful; upload stays browser-side"
@@ -3227,10 +3239,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"