conduyt-mcp 4.27.0 → 4.29.0

package/dist/tools/ai-extended.js

@@ -137,6 +137,41 @@ export function registerAiExtendedTools(server, client) {
         const result = await client.get(`/api/v1/ai/agenda${qs ? `?${qs}` : ""}`);
         return formatResult(result);
     });
+    server.tool("conduyt_ai_plan_actions", "Copilot actions — PLAN. Turn a natural-language request ('call Luis back tomorrow at 10', 'note on Ana: prefers texts', 'move the Roof deal to Proposal sent', 'draft a text to Ana about the quote') into a preview of concrete CRM actions resolved against records the caller can see (tasks, callbacks, notes, appointments, existing tags, deal stage moves, SMS/email DRAFTS). Nothing is written by this call. Returns the resolved actions (ready or with an issue such as an ambiguous name) and a single-use confirmationToken bound to that exact set; pass the actions array back UNMODIFIED with the token to conduyt_ai_execute_actions to apply. Drafts are never sent by the system.", {
+        message: z.string().min(1).max(2000).describe("What the rep wants done, in plain language"),
+        contactId: z.string().optional().describe("Contact UUID the request refers to when it says 'this contact' (must be visible to the caller)"),
+        dealId: z.string().optional().describe("Deal UUID the request refers to when it says 'this deal'"),
+    }, async ({ message, contactId, dealId }) => {
+        const section = contactId ? { type: "contact", id: contactId } : dealId ? { type: "deal", id: dealId } : undefined;
+        const result = await client.post("/api/v1/ai/actions", { message, ...(section ? { section } : {}) });
+        return formatResult(result);
+    });
+    server.tool("conduyt_ai_execute_actions", "Copilot actions — APPLY. Executes the ready actions from a conduyt_ai_plan_actions result through the same routes the UI uses (permissions, tenant scope, visibility, audit all apply). Send the plan's `actions` array back exactly as received plus its confirmationToken (single-use, expires in 5 minutes, bound to the caller and the exact set — any edit is refused). Optionally narrow with selectedIds. Returns a per-action result; drafts are not sent. Sending the same token again REPLAYS the run (nothing runs twice; the response says replayed:true). A result with inFlight:true was started but never confirmed — inspect the record, then resume it explicitly with resumeIds.", {
+        actions: z.array(z.record(z.unknown())).min(1).max(8).describe("The `actions` array from the plan, unmodified"),
+        confirmationToken: z.string().describe("The plan's confirmationToken"),
+        selectedIds: z.array(z.string()).optional().describe("First apply only: apply just these action ids (default: every ready action). A later call with the same token must resend the same selection — a run's action set cannot be widened."),
+        resumeIds: z.array(z.string()).optional().describe("Re-run actions the previous response reported with inFlight:true (started but never confirmed, e.g. the connection dropped mid-apply). Check the record first — the write may already exist — and only after the result's resumableAt (the earlier attempt can no longer be running); earlier resumes are refused. Later actions wait behind an in-flight one (plan order). Never re-run automatically."),
+    }, async ({ actions, confirmationToken, selectedIds, resumeIds }) => {
+        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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "conduyt-mcp",
-  "version": "4.27.0",
+  "version": "4.29.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,11 +1,11 @@
 {
-  "generatedAt": "2026-09-06T04:07:11.872Z",
-  "toolCount": 210,
-  "totalEndpoints": 912,
+  "generatedAt": "2026-09-06T14:27:53.877Z",
+  "toolCount": 214,
+  "totalEndpoints": 918,
   "counts": {
-    "covered": 194,
-    "excluded": 274,
-    "planned": 444,
+    "covered": 198,
+    "excluded": 275,
+    "planned": 445,
     "uncategorized": 0
   },
   "matrix": {
@@ -309,6 +309,22 @@
       "status": "excluded",
       "reason": "super-admin platform operations (Conduyt staff only)"
     },
+    "POST /api/v1/ai/actions": {
+      "status": "covered",
+      "tools": [
+        "conduyt_ai_plan_actions"
+      ]
+    },
+    "POST /api/v1/ai/actions/execute": {
+      "status": "covered",
+      "tools": [
+        "conduyt_ai_execute_actions"
+      ]
+    },
+    "GET /api/v1/ai/actions/runs/:id": {
+      "status": "planned",
+      "reason": "AI surfaces beyond chat/insights/tasks tools"
+    },
     "GET /api/v1/ai/agenda": {
       "status": "planned",
       "reason": "AI surfaces beyond chat/insights/tasks tools"
@@ -1457,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"
@@ -1621,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"