conduyt-mcp 4.32.0 → 4.33.0

package/dist/tools/lifecycle.js

@@ -36,7 +36,7 @@ const masterStatusName = z
     .max(40)
     .regex(/^[a-z0-9][a-z0-9 _-]*$/i, "letters, numbers, spaces, - and _ only");
 export function registerLifecycleTools(server, client) {
-    server.tool("conduyt_get_lifecycle_settings", "Read the account's Lifecycle v2 configuration, shaped for read-before-write: masterStatuses.effective is the full list a contact's masterStatus may take (the five built-in defaults plus the account's customs — the raw settings key stores only the customs); intakeDeals is the automatic deal-on-intake config, or null with an intakeDealsNote explaining that null can mean either not-configured or not-visible-to-your-key (the setting is admin-visible; member-tier responses omit it).", {}, async () => {
+    server.tool("conduyt_get_lifecycle_settings", "Read the account's Lifecycle configuration (v2 + v3), shaped for read-before-write: dealWorkingMode and lostPropagation say how the tenant works leads and whether lost propagation is live; masterStatuses.effective is the full list a contact's masterStatus may take (the five built-in defaults plus the account's customs — the raw settings key stores only the customs); intakeDeals is the automatic deal-on-intake config, or null with an intakeDealsNote explaining that null can mean either not-configured or not-visible-to-your-key (the setting is admin-visible; member-tier responses omit it).", {}, async () => {
         const result = await client.get("/api/v1/settings");
         const raw = result?.data ?? {};
         const customs = Array.isArray(raw.masterStatuses)
@@ -46,7 +46,22 @@ export function registerLifecycleTools(server, client) {
         // and an unconfigured account also lacks it. The two are not
         // distinguishable from here, so null is reported with a note saying so.
         const intakeDeals = raw.intakeDeals && typeof raw.intakeDeals === "object" ? raw.intakeDeals : null;
+        // Lifecycle v3 (2026-09-08): how the tenant works leads, and whether LOST
+        // propagation is live for it (P2: contact flips to lost when its LAST
+        // open card closes lost; a new open card reopens it; forward-only from
+        // enabledAt; off = the nightly shadow report only).
+        const dealWorkingMode = raw.dealWorkingMode === "pipeline" || raw.dealWorkingMode === "status" ? raw.dealWorkingMode : null;
+        const lostRaw = raw.lostPropagation && typeof raw.lostPropagation === "object" ? raw.lostPropagation : null;
+        const lostPropagation = {
+            enabled: lostRaw?.enabled === true,
+            enabledAt: typeof lostRaw?.enabledAt === "string" ? lostRaw.enabledAt : null,
+        };
         const shaped = {
+            dealWorkingMode,
+            dealWorkingModeNote: dealWorkingMode === null
+                ? "null = not chosen yet (legacy account) — 'pipeline': every inbound contact gets a deal card (intakeDeals required); 'status': the contact is the opportunity"
+                : undefined,
+            lostPropagation,
             masterStatuses: {
                 defaults: DEFAULT_MASTER_STATUSES,
                 customs,
@@ -68,6 +83,12 @@ export function registerLifecycleTools(server, client) {
             .optional()
             .describe("Policy for contacts that already exist (default 'if_no_open')"),
     }, async (params) => patchGeneralSettings(client, { intakeDeals: params }));
+    server.tool("conduyt_update_deal_working_mode", "Set how this tenant works leads (Lifecycle v3). 'pipeline': every inbound contact gets a deal card in the intake pipeline — requires intakeDeals enabled with a pipelineId and stageId (conduyt_update_intake_deals first), and a new form/webhook/line cannot go live without a pipeline. 'status': the contact is the opportunity, no automatic cards (small shops). Switchable later; new tenants default to 'pipeline'.", {
+        mode: z.enum(["pipeline", "status"]).describe("'pipeline' (cards on every inbound) or 'status' (the contact is the opportunity)"),
+    }, async ({ mode }) => patchGeneralSettings(client, { dealWorkingMode: mode }));
+    server.tool("conduyt_update_lost_propagation", "Turn LOST propagation on or off for this tenant (Lifecycle v3 P2). When on: a contact's masterStatus flips to 'lost' within a minute of its LAST open deal card closing lost (a per-minute resolver applies the rule on the committed state) (carrying that card's lostReason into masterStatusReason), a new open card on a lost/abandoned/disqualified contact reopens it, and a won contact never flips. Forward-only from the first enable (enabledAt is stamped server-side): existing history never flips by itself. A terminal masterStatus silences every drip, sequence and playbook for that contact, so read the nightly shadow report first (job run 'lost-propagation-shadow': contacts that would flip, their reasons, and the automations that would go quiet) before enabling.", {
+        enabled: z.boolean().describe("true = flips happen live from now on; false = shadow report only"),
+    }, async ({ enabled }) => patchGeneralSettings(client, { lostPropagation: { enabled } }));
     server.tool("conduyt_update_master_statuses", "Set the account's custom lead lifecycle statuses. The five defaults (open, won, lost, abandoned, disqualified) always exist and cannot be removed; this REPLACES the custom list on top of them (max 20 names, 1-40 chars each, letters/numbers/spaces/-/_ only). Terminal statuses stop all outbound automation for a contact. Requires settings:edit.", {
         statuses: z
             .array(masterStatusName)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "conduyt-mcp",
-  "version": "4.32.0",
+  "version": "4.33.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-07T18:36:27.469Z",
-  "toolCount": 217,
-  "totalEndpoints": 925,
+  "generatedAt": "2026-09-09T04:17:05.786Z",
+  "toolCount": 219,
+  "totalEndpoints": 929,
   "counts": {
     "covered": 202,
-    "excluded": 278,
+    "excluded": 282,
     "planned": 445,
     "uncategorized": 0
   },
@@ -1553,6 +1553,10 @@
       "status": "excluded",
       "reason": "CRON_SECRET-gated infrastructure jobs; never key-callable"
     },
+    "GET /api/v1/cron/lost-propagation-shadow": {
+      "status": "excluded",
+      "reason": "CRON_SECRET-gated infrastructure jobs; never key-callable"
+    },
     "GET /api/v1/cron/mailbox-delta-recovery": {
       "status": "excluded",
       "reason": "CRON_SECRET-gated infrastructure jobs; never key-callable"
@@ -1757,6 +1761,10 @@
       "status": "excluded",
       "reason": "CRON_SECRET-gated infrastructure jobs; never key-callable"
     },
+    "GET /api/v1/cron/resolve-master-status": {
+      "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"
@@ -4076,6 +4084,14 @@
       "status": "excluded",
       "reason": "inbound provider callback receivers (Twilio/Resend/etc.), not client-callable"
     },
+    "POST /api/v1/webhooks/voice/vendor-recording": {
+      "status": "excluded",
+      "reason": "inbound provider callback receivers (Twilio/Resend/etc.), not client-callable"
+    },
+    "POST /api/v1/webhooks/voice/vendor-status": {
+      "status": "excluded",
+      "reason": "inbound provider callback receivers (Twilio/Resend/etc.), not client-callable"
+    },
     "POST /api/v1/webhooks/voice/voicemail": {
       "status": "excluded",
       "reason": "inbound provider callback receivers (Twilio/Resend/etc.), not client-callable"