conduyt-mcp 4.28.0 → 4.30.0

package/dist/tools/ai-extended.js

@@ -155,6 +155,23 @@ export function registerAiExtendedTools(server, client) {
         const result = await client.post("/api/v1/ai/actions/execute", { actions, confirmationToken, ...(selectedIds ? { selectedIds } : {}), ...(resumeIds ? { resumeIds } : {}) });
         return formatResult(result);
     });
+    server.tool("conduyt_reply_suggestion", "Copilot Tier 2 — the suggested reply for a contact's LATEST inbound text or email (what they said, what they are asking, sentiment, and a draft reply shaped for the channel). Advice only: nothing is sent by this tool. state: ready | pending (the copilot has not read it yet) | none | decided | skipped (opt-out, do-not-contact, feature off).", {
+        contactId: z.string().describe("Contact UUID (must be visible to the caller)"),
+    }, async ({ contactId }) => {
+        const result = await client.get(`/api/v1/conversations/${encodeURIComponent(contactId)}/suggestion`);
+        return formatResult(result);
+    });
+    server.tool("conduyt_reply_suggestion_decide", "Copilot Tier 2 — record what was done with a suggested reply: accepted (the draft was taken into a composer), sent (with the outbound message id, after sending it through conduyt_send_message / the messages API), or dismissed. A suggestion moves once (accepted → sent is allowed).", {
+        contactId: z.string().describe("Contact UUID"),
+        messageId: z.string().describe("The inbound message the suggestion answers (suggestion.messageId)"),
+        decision: z.enum(["accepted", "sent", "dismissed"]),
+        sentMessageId: z.string().optional().describe("REQUIRED with decision=sent: the OUTBOUND message id that was sent — it must belong to this contact and be provider-confirmed (status sent/delivered, or queued with a provider id); a pending, draft or failed message is refused"),
+    }, async ({ contactId, messageId, decision, sentMessageId }) => {
+        if (decision === "sent" && !sentMessageId)
+            throw new Error("decision=sent requires sentMessageId (the confirmed outbound message that was sent)");
+        const result = await client.post(`/api/v1/conversations/${encodeURIComponent(contactId)}/suggestion`, { messageId, decision, ...(sentMessageId ? { sentMessageId } : {}) });
+        return formatResult(result);
+    });
     server.tool("conduyt_ai_daily_brief", "AI-generated daily brief for the current user. Summarizes today's priorities — deals needing attention, overdue tasks, hot leads, and recommended focus.", {}, async () => {
         const result = await client.get("/api/v1/ai/daily-brief");
         return formatResult(result);

package/dist/tools/automations.js

@@ -22,7 +22,7 @@ export function registerAutomationTools(server, client) {
     server.tool("conduyt_create_automation", "Create a new automation. Requires a name and trigger event. Use conduyt_resolve_names to convert human-readable names to UUIDs before building actions.", {
         name: z.string().describe("Automation name"),
         description: z.string().optional().describe("Description of what this automation does"),
-        triggerEvent: z.string().describe("Trigger event (e.g. 'contact.created', 'deal.stage_changed', 'tag.added', 'scheduled')"),
+        triggerEvent: z.string().describe("Trigger event (e.g. 'contact.created', 'deal.stage_changed', 'tag.added', 'scheduled', or 'message.understood' — fires when the copilot has read an inbound text/email and understood its intent; list them all with conduyt_list_automation_events)"),
         kind: z.enum(["native", "n8n"]).optional().describe("Automation type — 'native' for the built-in graph engine (use `actions`), 'n8n' for an external n8n webhook (requires n8nWorkflowId + n8nWebhookUrl). For agent-built automations use 'native'."),
         n8nWorkflowId: z.string().optional().describe("n8n workflow ID (required when kind='n8n')"),
         n8nWebhookUrl: z.string().optional().describe("n8n webhook URL (required when kind='n8n')"),
@@ -33,7 +33,7 @@ export function registerAutomationTools(server, client) {
         triggerConditions: z
             .any()
             .optional()
-            .describe("Conditions that must match for the trigger to fire. Scalar filters like tagId/pipelineId/bookingPageIds, plus per-event config: for 'contact.untouched' pass { untouchedDays: N } (integer 1-365) to fire once per quiet episode when a contact has had no outreach for N+ days — without it the trigger is the minutes-scale speed-to-lead alert. Unknown keys on native events are rejected at create/publish (422)."),
+            .describe("Conditions that must match for the trigger to fire. Scalar filters like tagId/pipelineId/bookingPageIds, plus per-event config: for 'message.understood' filter on the reading with { filters: [{ field: 'trigger.intent', operator: 'equals', value: 'document_sent' }] } (intents: interested, question, callback_requested, appointment_confirm, appointment_cancel, document_sent, objection, not_interested, opt_out, wrong_number, unclear; also trigger.channel sms|email and trigger.sentiment positive|neutral|negative; {{trigger.summary}} / {{trigger.ask}} are merge fields downstream); for 'contact.untouched' pass { untouchedDays: N } (integer 1-365) to fire once per quiet episode when a contact has had no outreach for N+ days — without it the trigger is the minutes-scale speed-to-lead alert. Unknown keys on native events are rejected at create/publish (422)."),
     }, async (params) => {
         const result = await client.post("/api/v1/automations", params);
         return formatResult(result);

package/package.json

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

package/scripts/coverage-matrix.json

@@ -1,10 +1,10 @@
 {
-  "generatedAt": "2026-09-06T05:48:44.694Z",
-  "toolCount": 212,
-  "totalEndpoints": 915,
+  "generatedAt": "2026-09-06T17:51:09.874Z",
+  "toolCount": 214,
+  "totalEndpoints": 919,
   "counts": {
-    "covered": 196,
-    "excluded": 274,
+    "covered": 198,
+    "excluded": 276,
     "planned": 445,
     "uncategorized": 0
   },
@@ -1473,6 +1473,18 @@
       "status": "planned",
       "reason": "conversation thread surfaces"
     },
+    "GET /api/v1/conversations/:contactId/suggestion": {
+      "status": "covered",
+      "tools": [
+        "conduyt_reply_suggestion"
+      ]
+    },
+    "POST /api/v1/conversations/:contactId/suggestion": {
+      "status": "covered",
+      "tools": [
+        "conduyt_reply_suggestion_decide"
+      ]
+    },
     "GET /api/v1/conversations/export": {
       "status": "planned",
       "reason": "conversation thread surfaces"
@@ -1637,6 +1649,10 @@
       "status": "excluded",
       "reason": "CRON_SECRET-gated infrastructure jobs; never key-callable"
     },
+    "GET /api/v1/cron/process-message-insights": {
+      "status": "excluded",
+      "reason": "CRON_SECRET-gated infrastructure jobs; never key-callable"
+    },
     "GET /api/v1/cron/process-outbox": {
       "status": "excluded",
       "reason": "CRON_SECRET-gated infrastructure jobs; never key-callable"
@@ -1999,6 +2015,10 @@
         "conduyt_ai_call_disposition"
       ]
     },
+    "POST /api/v1/dialer/call/:id/facetime-status": {
+      "status": "excluded",
+      "reason": "realtime browser dialer (WebRTC tokens, live call control) — needs a live audio session"
+    },
     "POST /api/v1/dialer/call/:id/hangup": {
       "status": "excluded",
       "reason": "realtime browser dialer (WebRTC tokens, live call control) — needs a live audio session"