conduyt-mcp 4.18.0 → 4.20.0

package/dist/client.js

@@ -150,6 +150,14 @@ export class ConduytClient {
             const json = JSON.parse(text);
             if (json?.error)
                 msg = json.error;
+            // Structured error details (e.g. STAGE_REQUIREMENTS carries
+            // lostReasonOptions) must reach the agent, or a "must be one of the
+            // configured options" error is unactionable. Bounded so a pathological
+            // body can't bloat the message.
+            const details = Object.fromEntries(Object.entries(json ?? {}).filter(([k]) => k !== "error"));
+            if (Object.keys(details).length > 0) {
+                msg = `${msg} ${JSON.stringify(details).slice(0, 1000)}`;
+            }
         }
         catch {
             if (text)

package/dist/tools/deals.js

@@ -104,6 +104,7 @@ export function registerDealTools(server, client) {
         expectedCloseDate: z.string().optional().describe("Expected close date (ISO 8601)"),
         assignedTo: z.string().optional().describe("Reassign to user (owner) UUID"),
         source: z.string().trim().min(1).max(500).nullable().optional().describe("Attribution source for THIS deal (the trigger that produced it) — distinct from the contact's first-touch source. Pass null to clear it; a blank string is rejected. 1-500 chars."),
+        lostReason: z.string().optional().describe("Reason for a lost/disqualified deal. Some stages REQUIRE this on entry (the move fails with code STAGE_REQUIREMENTS listing lostReasonOptions when the stage has a configured dropdown — resend with one of those exact values)."),
         customFields: z.record(z.any()).optional().describe("Structured custom-field values to merge, keyed by field key"),
     }, async ({ id, ...updates }) => {
         const result = await client.patch(`/api/v1/deals/${id}`, updates);

package/dist/tools/users.js

@@ -41,6 +41,12 @@ export function registerUserTools(server, client) {
         phone: z.string().optional().describe("Updated phone"),
         role: z.enum(["member", "admin", "owner"]).optional().describe("Updated role"),
         permissions: z.array(z.string()).optional().describe("Updated permission scopes"),
+        position: z.string().nullable().optional().describe("Rep-profile position/title, merge-taggable as {{user.position}} (owner/admin only; null clears)"),
+        mobilePhone: z.string().nullable().optional().describe("Rep-profile mobile phone, merge-taggable as {{user.mobilePhone}} (owner/admin only; null clears)"),
+        custom1: z.string().nullable().optional().describe("Rep-profile custom field 1, merge-taggable as {{user.custom1}} (owner/admin only; null clears)"),
+        custom2: z.string().nullable().optional().describe("Rep-profile custom field 2, merge-taggable as {{user.custom2}} (owner/admin only; null clears)"),
+        custom3: z.string().nullable().optional().describe("Rep-profile custom field 3, merge-taggable as {{user.custom3}} (owner/admin only; null clears)"),
+        custom4: z.string().nullable().optional().describe("Rep-profile custom field 4, merge-taggable as {{user.custom4}} (owner/admin only; null clears)"),
     }, async ({ id, ...updates }) => {
         const result = await client.patch(`/api/v1/users/${id}`, updates);
         return formatResult(result);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "conduyt-mcp",
-  "version": "4.18.0",
+  "version": "4.20.0",
   "description": "MCP server for Conduyt CRM — expose CRM operations as AI-accessible tools",
   "type": "module",
   "main": "dist/index.js",

package/scripts/coverage-manifest.json

@@ -499,6 +499,21 @@
       "match": "/api/v1/webhooks",
       "status": "planned",
       "reason": "outbound webhook subscription management (distinct from the inbound /webhooks/ receivers)"
+    },
+    {
+      "match": "/api/v1/automation-folders",
+      "status": "planned",
+      "reason": "automation-folder organization (shipped 2026-08) \u2014 agent-relevant workflow housekeeping; typed tools wanted"
+    },
+    {
+      "match": "/api/v1/call-flows",
+      "status": "planned",
+      "reason": "call-flow builder API (shipped 2026-08-21) \u2014 agent-relevant; typed tools follow once the canvas UI (#25) settles the surface"
+    },
+    {
+      "match": "/api/v1/ring-groups",
+      "status": "planned",
+      "reason": "ring-group management (call-flows companion, shipped 2026-08-21) \u2014 agent-relevant; typed tools with the call-flow set"
     }
   ]
-}
+}

package/scripts/coverage-matrix.json

@@ -1,11 +1,11 @@
 {
-  "generatedAt": "2026-08-06T22:46:04.536Z",
+  "generatedAt": "2026-08-22T18:59:24.922Z",
   "toolCount": 173,
-  "totalEndpoints": 842,
+  "totalEndpoints": 872,
   "counts": {
     "covered": 161,
-    "excluded": 248,
-    "planned": 433,
+    "excluded": 255,
+    "planned": 456,
     "uncategorized": 0
   },
   "matrix": {
@@ -395,6 +395,10 @@
       "status": "planned",
       "reason": "API key admin beyond self-check"
     },
+    "GET /api/v1/api-keys/:id": {
+      "status": "planned",
+      "reason": "API key admin beyond self-check"
+    },
     "PATCH /api/v1/api-keys/:id": {
       "status": "planned",
       "reason": "API key admin beyond self-check"
@@ -533,6 +537,22 @@
       "status": "planned",
       "reason": "execution inspection"
     },
+    "GET /api/v1/automation-folders": {
+      "status": "planned",
+      "reason": "automation-folder organization (shipped 2026-08) — agent-relevant workflow housekeeping; typed tools wanted"
+    },
+    "POST /api/v1/automation-folders": {
+      "status": "planned",
+      "reason": "automation-folder organization (shipped 2026-08) — agent-relevant workflow housekeeping; typed tools wanted"
+    },
+    "PATCH /api/v1/automation-folders/:id": {
+      "status": "planned",
+      "reason": "automation-folder organization (shipped 2026-08) — agent-relevant workflow housekeeping; typed tools wanted"
+    },
+    "DELETE /api/v1/automation-folders/:id": {
+      "status": "planned",
+      "reason": "automation-folder organization (shipped 2026-08) — agent-relevant workflow housekeeping; typed tools wanted"
+    },
     "GET /api/v1/automations": {
       "status": "covered",
       "tools": [
@@ -970,6 +990,50 @@
       "status": "planned",
       "reason": "calendar/booking management beyond current appointment tools"
     },
+    "GET /api/v1/call-flows": {
+      "status": "planned",
+      "reason": "call-flow builder API (shipped 2026-08-21) — agent-relevant; typed tools follow once the canvas UI (#25) settles the surface"
+    },
+    "POST /api/v1/call-flows": {
+      "status": "planned",
+      "reason": "call-flow builder API (shipped 2026-08-21) — agent-relevant; typed tools follow once the canvas UI (#25) settles the surface"
+    },
+    "GET /api/v1/call-flows/:id": {
+      "status": "planned",
+      "reason": "call-flow builder API (shipped 2026-08-21) — agent-relevant; typed tools follow once the canvas UI (#25) settles the surface"
+    },
+    "PATCH /api/v1/call-flows/:id": {
+      "status": "planned",
+      "reason": "call-flow builder API (shipped 2026-08-21) — agent-relevant; typed tools follow once the canvas UI (#25) settles the surface"
+    },
+    "DELETE /api/v1/call-flows/:id": {
+      "status": "planned",
+      "reason": "call-flow builder API (shipped 2026-08-21) — agent-relevant; typed tools follow once the canvas UI (#25) settles the surface"
+    },
+    "POST /api/v1/call-flows/:id/publish": {
+      "status": "planned",
+      "reason": "call-flow builder API (shipped 2026-08-21) — agent-relevant; typed tools follow once the canvas UI (#25) settles the surface"
+    },
+    "POST /api/v1/call-flows/:id/simulate": {
+      "status": "planned",
+      "reason": "call-flow builder API (shipped 2026-08-21) — agent-relevant; typed tools follow once the canvas UI (#25) settles the surface"
+    },
+    "POST /api/v1/call-flows/:id/unpublish": {
+      "status": "planned",
+      "reason": "call-flow builder API (shipped 2026-08-21) — agent-relevant; typed tools follow once the canvas UI (#25) settles the surface"
+    },
+    "GET /api/v1/call-flows/:id/validate": {
+      "status": "planned",
+      "reason": "call-flow builder API (shipped 2026-08-21) — agent-relevant; typed tools follow once the canvas UI (#25) settles the surface"
+    },
+    "POST /api/v1/call-flows/audio": {
+      "status": "planned",
+      "reason": "call-flow builder API (shipped 2026-08-21) — agent-relevant; typed tools follow once the canvas UI (#25) settles the surface"
+    },
+    "GET /api/v1/call-flows/roster": {
+      "status": "planned",
+      "reason": "call-flow builder API (shipped 2026-08-21) — agent-relevant; typed tools follow once the canvas UI (#25) settles the surface"
+    },
     "GET /api/v1/calls": {
       "status": "covered",
       "tools": [
@@ -1381,6 +1445,10 @@
       "status": "excluded",
       "reason": "CRON_SECRET-gated infrastructure jobs; never key-callable"
     },
+    "GET /api/v1/cron/process-automation-redispatch": {
+      "status": "excluded",
+      "reason": "CRON_SECRET-gated infrastructure jobs; never key-callable"
+    },
     "GET /api/v1/cron/process-batches": {
       "status": "excluded",
       "reason": "CRON_SECRET-gated infrastructure jobs; never key-callable"
@@ -1389,6 +1457,10 @@
       "status": "excluded",
       "reason": "CRON_SECRET-gated infrastructure jobs; never key-callable"
     },
+    "GET /api/v1/cron/process-call-lifecycle-intents": {
+      "status": "excluded",
+      "reason": "CRON_SECRET-gated infrastructure jobs; never key-callable"
+    },
     "GET /api/v1/cron/process-consent-outbox": {
       "status": "excluded",
       "reason": "CRON_SECRET-gated infrastructure jobs; never key-callable"
@@ -1489,6 +1561,10 @@
       "status": "excluded",
       "reason": "CRON_SECRET-gated infrastructure jobs; never key-callable"
     },
+    "GET /api/v1/cron/reap-stale-group-calls": {
+      "status": "excluded",
+      "reason": "CRON_SECRET-gated infrastructure jobs; never key-callable"
+    },
     "GET /api/v1/cron/reconcile-document-sends": {
       "status": "excluded",
       "reason": "CRON_SECRET-gated infrastructure jobs; never key-callable"
@@ -1501,6 +1577,10 @@
       "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"
+    },
     "GET /api/v1/cron/recurring-tasks": {
       "status": "excluded",
       "reason": "CRON_SECRET-gated infrastructure jobs; never key-callable"
@@ -1513,6 +1593,10 @@
       "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"
+    },
     "GET /api/v1/cron/resume-imports": {
       "status": "excluded",
       "reason": "CRON_SECRET-gated infrastructure jobs; never key-callable"
@@ -2377,6 +2461,10 @@
       "status": "planned",
       "reason": "integration management"
     },
+    "POST /api/v1/integrations/dpp/ingest": {
+      "status": "planned",
+      "reason": "integration management"
+    },
     "GET /api/v1/integrations/health": {
       "status": "planned",
       "reason": "integration management"
@@ -2941,6 +3029,30 @@
       "status": "planned",
       "reason": "additional report surfaces beyond ai/insights"
     },
+    "GET /api/v1/ring-groups": {
+      "status": "planned",
+      "reason": "ring-group management (call-flows companion, shipped 2026-08-21) — agent-relevant; typed tools with the call-flow set"
+    },
+    "POST /api/v1/ring-groups": {
+      "status": "planned",
+      "reason": "ring-group management (call-flows companion, shipped 2026-08-21) — agent-relevant; typed tools with the call-flow set"
+    },
+    "GET /api/v1/ring-groups/:id": {
+      "status": "planned",
+      "reason": "ring-group management (call-flows companion, shipped 2026-08-21) — agent-relevant; typed tools with the call-flow set"
+    },
+    "PATCH /api/v1/ring-groups/:id": {
+      "status": "planned",
+      "reason": "ring-group management (call-flows companion, shipped 2026-08-21) — agent-relevant; typed tools with the call-flow set"
+    },
+    "DELETE /api/v1/ring-groups/:id": {
+      "status": "planned",
+      "reason": "ring-group management (call-flows companion, shipped 2026-08-21) — agent-relevant; typed tools with the call-flow set"
+    },
+    "POST /api/v1/ring-groups/release-number": {
+      "status": "planned",
+      "reason": "ring-group management (call-flows companion, shipped 2026-08-21) — agent-relevant; typed tools with the call-flow set"
+    },
     "GET /api/v1/saved-filters": {
       "status": "planned",
       "reason": "saved filter management"
@@ -3643,6 +3755,10 @@
       "status": "excluded",
       "reason": "inbound provider callback receivers (Twilio/Resend/etc.), not client-callable"
     },
+    "POST /api/v1/webhooks/voice/flow-step": {
+      "status": "excluded",
+      "reason": "inbound provider callback receivers (Twilio/Resend/etc.), not client-callable"
+    },
     "POST /api/v1/webhooks/voice/inbound": {
       "status": "excluded",
       "reason": "inbound provider callback receivers (Twilio/Resend/etc.), not client-callable"
@@ -3651,6 +3767,10 @@
       "status": "excluded",
       "reason": "inbound provider callback receivers (Twilio/Resend/etc.), not client-callable"
     },
+    "POST /api/v1/webhooks/voice/ring-group-step": {
+      "status": "excluded",
+      "reason": "inbound provider callback receivers (Twilio/Resend/etc.), not client-callable"
+    },
     "POST /api/v1/webhooks/voice/status": {
       "status": "excluded",
       "reason": "inbound provider callback receivers (Twilio/Resend/etc.), not client-callable"