conduyt-mcp 4.26.0 → 4.28.0

package/dist/tools/ai-extended.js

@@ -124,6 +124,37 @@ export function registerAiExtendedTools(server, client) {
         const result = await client.post(`/api/v1/dialer/call/${callId}/ai-disposition`, {});
         return formatResult(result);
     });
+    server.tool("conduyt_ai_agenda", "The copilot's Today agenda for a user: what is on their calendar today (tenant timezone), callbacks they promised, messages waiting for a reply, overdue and due-today tasks, untouched new leads, recent-call follow-ups and deals going quiet — every visibility and opt-out rule applied — with a short brief on top (composed by the account's AI engine when available, otherwise a deterministic sentence built from the counts). Read-only.", {
+        userId: z.string().optional().describe("User UUID to build the agenda for (admins/owners only; defaults to the authenticated user)"),
+        narrative: z.boolean().optional().describe("false = skip the AI-composed brief and return the deterministic one (spends no AI budget)"),
+    }, async ({ userId, narrative }) => {
+        const params = new URLSearchParams();
+        if (userId)
+            params.set("userId", userId);
+        if (narrative === false)
+            params.set("narrative", "0");
+        const qs = params.toString();
+        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_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.26.0",
+  "version": "4.28.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-06T00:25:42.269Z",
-  "toolCount": 209,
-  "totalEndpoints": 911,
+  "generatedAt": "2026-09-06T05:48:44.694Z",
+  "toolCount": 212,
+  "totalEndpoints": 915,
   "counts": {
-    "covered": 194,
+    "covered": 196,
     "excluded": 274,
-    "planned": 443,
+    "planned": 445,
     "uncategorized": 0
   },
   "matrix": {
@@ -309,6 +309,26 @@
       "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"
+    },
     "POST /api/v1/ai/chat": {
       "status": "covered",
       "tools": [