conduyt-mcp 4.56.0 → 4.57.0

package/dist/index.js

@@ -25,6 +25,7 @@ import { registerCustomFieldTools } from "./tools/custom-fields.js";
 import { registerSmartListTools } from "./tools/smart-lists.js";
 import { registerUserTools } from "./tools/users.js";
 import { registerBulkTools } from "./tools/bulk.js";
+import { registerBatchOperationTools } from "./tools/batch-operations.js";
 import { registerDncTools } from "./tools/dnc.js";
 import { registerSavedFilterTools } from "./tools/saved-filters.js";
 import { registerDripCampaignTools } from "./tools/drip-campaigns.js";
@@ -92,6 +93,7 @@ registerCustomFieldTools(server, client);
 registerSmartListTools(server, client);
 registerUserTools(server, client);
 registerBulkTools(server, client);
+registerBatchOperationTools(server, client);
 registerDncTools(server, client);
 registerSavedFilterTools(server, client);
 registerDripCampaignTools(server, client);

package/dist/tools/batch-operations.d.ts

@@ -0,0 +1,7 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { ConduytClient } from "../client.js";
+/**
+ * Run Batch (Conduyt #80, 2026-09-15): one logged task on many contacts — the contacts page's "Select all N
+ * matching → Run Batch" action and the Run Batch page. Admins and owners only.
+ */
+export declare function registerBatchOperationTools(server: McpServer, client: ConduytClient): void;

package/dist/tools/batch-operations.js

@@ -0,0 +1,79 @@
+import { z } from "zod";
+import { formatResult } from "../client.js";
+/**
+ * Run Batch (Conduyt #80, 2026-09-15): one logged task on many contacts — the contacts page's "Select all N
+ * matching → Run Batch" action and the Run Batch page. Admins and owners only.
+ */
+export function registerBatchOperationTools(server, client) {
+    server.tool("conduyt_create_batch_operation", "Queue a Run Batch: ONE task applied to many contacts, logged with progress and cancel (no undo). Tasks: enroll (automationId of a published workflow), delete (the #73 engine: cleanup runs, contacts with an upcoming appointment are kept), add_tag / remove_tag (params.tagId), assign (params.userId — one rep) or a round-robin pool (params.userIds, 2–50 reps rotated in order; a rep who is no longer an active member is skipped), set_source (params.source — OVERWRITES the lead source), set_status (params.status — one of the account's lead statuses; a lead with a won deal keeps its status). Pick the contacts ONE way: contactIds (up to 50,000), filterPayload (universal filters), or filter + expectedTotal — the same filter you would give conduyt_list_contacts plus the meta.total it returned; the server re-counts and refuses with 409 expected_total_mismatch when the set moved, then freezes the matching ids (max 50,000). The run is processed in the background; poll conduyt_get_batch_operation. Requires the admin or owner role and an active subscription.", {
+        name: z.string().min(1).max(256).describe("A name for the run (shown on the Run Batch page)"),
+        operation: z.enum(["enroll", "delete", "add_tag", "remove_tag", "assign", "set_source", "set_status"]).describe("The task"),
+        automationId: z.string().uuid().optional().describe("enroll only: the published workflow"),
+        params: z.record(z.string(), z.unknown()).optional().describe("Task arguments: { tagId } | { userId } | { userIds: [...] } | { source } | { status }; none for enroll and delete"),
+        comment: z.string().max(2000).optional().describe("Why this run (stored with it)"),
+        contactIds: z.array(z.string().uuid()).min(1).max(50_000).optional().describe("Explicit contacts"),
+        filterPayload: z.array(z.record(z.string(), z.unknown())).min(1).optional().describe("Universal filter rules (the Smart View filter shape)"),
+        filter: z.record(z.string(), z.union([z.string(), z.array(z.string())])).optional().describe("The contact list filter parameters, exactly as for conduyt_list_contacts; at least one non-empty value"),
+        expectedTotal: z.number().int().positive().optional().describe("With filter: the total the list showed for it (meta.total)"),
+    }, async (params) => {
+        const body = { name: params.name, operation: params.operation };
+        if (params.automationId)
+            body.automationId = params.automationId;
+        if (params.params)
+            body.params = params.params;
+        if (params.comment)
+            body.comment = params.comment;
+        if (params.contactIds)
+            body.contactIds = params.contactIds;
+        else if (params.filterPayload)
+            body.filterPayload = params.filterPayload;
+        else {
+            body.filter = params.filter;
+            body.expectedTotal = params.expectedTotal;
+        }
+        const result = await client.post("/api/v1/batch-operations", body);
+        return formatResult(result);
+    });
+    server.tool("conduyt_list_batch_operations", "List Run Batch runs (newest first): task (operation + params with the display names), status (queued | running | completed | cancelled | failed), totals and progress, creator, comment.", {
+        status: z.enum(["queued", "running", "completed", "cancelled", "failed"]).optional().describe("Only runs in this status"),
+        createdBy: z.string().uuid().optional().describe("Only runs created by this user"),
+        page: z.number().int().positive().optional().describe("Page (default 1)"),
+        limit: z.number().int().positive().max(50).optional().describe("Rows per page (default 20, max 50)"),
+    }, async (params) => {
+        const qp = new URLSearchParams();
+        if (params.status)
+            qp.set("status", params.status);
+        if (params.createdBy)
+            qp.set("createdBy", params.createdBy);
+        if (params.page)
+            qp.set("page", String(params.page));
+        if (params.limit)
+            qp.set("limit", String(params.limit));
+        const qs = qp.toString();
+        const result = await client.get(`/api/v1/batch-operations${qs ? `?${qs}` : ""}`);
+        return formatResult(result);
+    });
+    server.tool("conduyt_get_batch_operation", "One Run Batch run with its per-contact items: status per contact (pending | success | error | skipped) with the reason (e.g. 'kept: upcoming appointment', 'tag already applied', 'a lead a deal has won keeps its status').", {
+        id: z.string().uuid().describe("The run id"),
+        itemStatus: z.enum(["all", "pending", "success", "error", "skipped"]).optional().describe("Only items in this status (default all)"),
+        page: z.number().int().positive().optional().describe("Item page (default 1)"),
+        limit: z.number().int().positive().max(50).optional().describe("Items per page (default 20, max 50)"),
+    }, async (params) => {
+        const qp = new URLSearchParams();
+        if (params.itemStatus)
+            qp.set("itemStatus", params.itemStatus);
+        if (params.page)
+            qp.set("page", String(params.page));
+        if (params.limit)
+            qp.set("limit", String(params.limit));
+        const qs = qp.toString();
+        const result = await client.get(`/api/v1/batch-operations/${params.id}${qs ? `?${qs}` : ""}`);
+        return formatResult(result);
+    });
+    server.tool("conduyt_cancel_batch_operation", "Stop a queued or running Run Batch. Contacts already processed stay as they are (there is no undo); claimed-but-unprocessed contacts go back to pending and are not touched.", {
+        id: z.string().uuid().describe("The run id"),
+    }, async (params) => {
+        const result = await client.post(`/api/v1/batch-operations/${params.id}/cancel`, {});
+        return formatResult(result);
+    });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "conduyt-mcp",
-  "version": "4.56.0",
+  "version": "4.57.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-15T16:44:24.985Z",
-  "toolCount": 264,
+  "toolCount": 268,
   "totalEndpoints": 979,
   "counts": {
-    "covered": 247,
+    "covered": 249,
     "excluded": 291,
-    "planned": 441,
+    "planned": 439,
     "uncategorized": 0
   },
   "matrix": {
@@ -739,16 +739,20 @@
       "reason": "batch operation monitoring"
     },
     "POST /api/v1/batch-operations": {
-      "status": "planned",
-      "reason": "batch operation monitoring"
+      "status": "covered",
+      "tools": [
+        "conduyt_create_batch_operation"
+      ]
     },
     "GET /api/v1/batch-operations/:id": {
       "status": "planned",
       "reason": "batch operation monitoring"
     },
     "POST /api/v1/batch-operations/:id/cancel": {
-      "status": "planned",
-      "reason": "batch operation monitoring"
+      "status": "covered",
+      "tools": [
+        "conduyt_cancel_batch_operation"
+      ]
     },
     "GET /api/v1/billing/addons": {
       "status": "excluded",