@agifyai/leadify-mcp 8.4.2 → 8.5.1

package/README.md

@@ -200,7 +200,8 @@ Pour `add_leads` et `update_lead`, `location` utilise l’objet canonique
 `{ city, region?, postalCode?, countryCode, street? }`. `city` et le code pays
 ISO-2 `countryCode` sont obligatoires. La projection `geo` est calculée par
 Leadify et ne doit jamais être envoyée par un agent MCP.
-| `delete_sequence_messages` | Supprimer uniquement les messages de séquence générés d'un lead, après confirmation explicite. |
+| `preview_reset_sequence_messages` / `execute_reset_sequence_messages` | Prévisualiser puis effacer irréversiblement les messages générés d'un prospect, d'une liste explicite ou d'un groupe explicite. L'exécution exige le digest de preview et une clé d'idempotence. |
+| `preview_reset_ai_fields` / `execute_reset_ai_fields` | Prévisualiser puis effacer irréversiblement les champs IA d'un prospect, d'une liste explicite ou d'un groupe explicite, sans toucher aux contacts, flags manuels, activités ou campagnes. |
 | `delete_leads` | Supprimer définitivement des leads par leurs IDs. |
 | `update_schema` | Ajouter ou modifier les définitions de champs d'un groupe. |
 | `delete_columns` | Supprimer des colonnes du schéma et des données d'un groupe. |
@@ -258,4 +259,5 @@ Leadify et ne doit jamais être envoyée par un agent MCP.
 | `set_outreach_connection_request` | Toggle du flag connectionRequestEnabled (LinkedIn invite vs cold DM). |
 | `trigger_outreach` | Générer un message d'outreach via l'agent Trigger.dev (dry-run par défaut). `force=true` pour re-générer sur un lead déjà traité. |
 | `append_fine_tuning` | Appendre du contenu à une section du Fine Tuning (nonNegotiableRules, pitfalls, structure, examples). Toujours en mode append — garantie contractuelle. |
+| `set_fine_tuning_output_config` | Remplacer uniquement la configuration métier de sorties d’un Fine Tuning (`linkedinConnection`, `linkedinMessage`, `email`, activations et quantités). Préserve Markdown, langues et fallback ; ne génère, ne planifie, n’active ni n’envoie aucun outreach. |
 | `pipeline_next_lead` | Sélectionner le prochain lead à traiter (score descendant, sans message). Exclusion des IDs déjà vus, limit 1-5. |

package/dist/tools/fine_tuning.d.ts

@@ -1,2 +1,5 @@
 import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-export declare function registerFineTuningTools(server: McpServer): void;
+import { type LeadifyClient } from "../client.js";
+type FineTuningClient = Pick<LeadifyClient, "get" | "patch">;
+export declare function registerFineTuningTools(server: McpServer, client?: FineTuningClient): void;
+export {};

package/dist/tools/fine_tuning.js

@@ -1,6 +1,21 @@
 import { z } from "zod";
 import { getClient } from "../client.js";
 import { toolResult, handleToolError } from "../types.js";
+const outputSettingSchema = z.discriminatedUnion("enabled", [
+    z.object({ enabled: z.literal(true), count: z.number().int().min(1).max(5) }).strict(),
+    z.object({ enabled: z.literal(false) }).strict(),
+]);
+const outputConfigSchema = z.object({
+    mode: z.literal("selected"),
+    outputs: z.object({
+        linkedinConnection: z.discriminatedUnion("enabled", [
+            z.object({ enabled: z.literal(true), count: z.literal(1) }).strict(),
+            z.object({ enabled: z.literal(false) }).strict(),
+        ]),
+        linkedinMessage: outputSettingSchema,
+        email: outputSettingSchema,
+    }).strict().refine((outputs) => Object.values(outputs).some((output) => output.enabled), "At least one output category must be enabled."),
+}).strict();
 // Dedicated tool for the Fine Tuning page (separate from OutreachSettings).
 // Both concepts live in the DB (FineTuning + OutreachSettings) and the API
 // keeps them strictly separated: this endpoint NEVER touches OutreachSettings.
@@ -15,7 +30,7 @@ import { toolResult, handleToolError } from "../types.js";
 //                            content).
 // The split exists so neither caller is ever confused about which behavior
 // they triggered.
-export function registerFineTuningTools(server) {
+export function registerFineTuningTools(server, client) {
     // ── get_fine_tuning ───────────────────────────────────────────────────
     server.tool("get_fine_tuning", "Get the fine tuning configuration for a specific lead group. Returns exactly " +
         "the 5 levers of the Fine Tuning page and nothing else: " +
@@ -34,7 +49,7 @@ export function registerFineTuningTools(server) {
             "banned in the outreach pipeline)."),
     }, async ({ lead_group_id }) => {
         try {
-            const data = await getClient().get(`/api/lead-group/${encodeURIComponent(lead_group_id)}/fine-tuning`);
+            const data = await (client ?? getClient()).get(`/api/lead-group/${encodeURIComponent(lead_group_id)}/fine-tuning`);
             return toolResult(data);
         }
         catch (error) {
@@ -76,7 +91,7 @@ export function registerFineTuningTools(server) {
             "any previous content is lost. Pass an empty string to clear the section."),
     }, async ({ lead_group_id, section, content }) => {
         try {
-            const data = await getClient().patch(`/api/lead-group/${encodeURIComponent(lead_group_id)}/fine-tuning/section/${encodeURIComponent(section)}`, { content });
+            const data = await (client ?? getClient()).patch(`/api/lead-group/${encodeURIComponent(lead_group_id)}/fine-tuning/section/${encodeURIComponent(section)}`, { content });
             return toolResult({
                 ...(data && typeof data === "object" ? data : {}),
                 _note: `Wholesale replace of section '${section}' for lead group ${lead_group_id}.`,
@@ -86,4 +101,24 @@ export function registerFineTuningTools(server) {
             return handleToolError(error);
         }
     });
+    // ── set_fine_tuning_output_config ─────────────────────────────────────
+    server.tool("set_fine_tuning_output_config", "Replace ONLY the business output configuration of a lead group's Fine Tuning. " +
+        "Use this when its enabled output categories or quantities must change. " +
+        "Accepts only the business categories linkedinConnection, linkedinMessage, and email; " +
+        "it never accepts technical card or field names. A selected configuration must enable at " +
+        "least one category; enabled linkedinConnection is exactly 1, while LinkedIn messages and " +
+        "emails are 1–5. Markdown sections, supportedLanguages, and fallbackLanguage are preserved. " +
+        "This only persists Fine Tuning configuration: it never generates outreach, schedules work, " +
+        "activates campaigns, or sends messages. Returns the exact persisted Fine Tuning configuration.", {
+        lead_group_id: z.string().describe("ID of the accessible lead group whose output configuration to update."),
+        output_config: outputConfigSchema.describe("Selected business output configuration. Provide all three category keys and no technical card/field names."),
+    }, async ({ lead_group_id, output_config }) => {
+        try {
+            const data = await (client ?? getClient()).patch(`/api/lead-group/${encodeURIComponent(lead_group_id)}/fine-tuning/output-config`, { outputConfig: output_config });
+            return toolResult(data);
+        }
+        catch (error) {
+            return handleToolError(error);
+        }
+    });
 }

package/dist/tools/leads.js

@@ -33,6 +33,31 @@ const leadUpdateSchema = z.object({
         }
     }
 });
+const destructiveResetScopeShape = {
+    organization_id: z.string().trim().min(1).describe("Explicit organization ID. The server verifies tenant access and admin permission."),
+    scope: z.enum(["lead", "lead_ids", "lead_group"]).describe("Exactly one explicit target scope; no implicit group or organization selection is allowed."),
+    lead_id: z.string().trim().min(1).optional().describe("Required only when scope is lead."),
+    lead_ids: z.array(z.string().trim().min(1)).min(1).max(100).optional().describe("Required only when scope is lead_ids; unique JSON list of lead IDs."),
+    lead_group_id: z.string().trim().min(1).optional().describe("Required only when scope is lead_group."),
+};
+const destructiveResetScopeSchema = z.object(destructiveResetScopeShape).superRefine((value, context) => {
+    const exactly = value.scope === "lead" ? Boolean(value.lead_id) && !value.lead_ids && !value.lead_group_id
+        : value.scope === "lead_ids" ? !value.lead_id && Boolean(value.lead_ids) && !value.lead_group_id
+            : !value.lead_id && !value.lead_ids && Boolean(value.lead_group_id);
+    if (!exactly)
+        context.addIssue({ code: z.ZodIssueCode.custom, message: "Provide exactly the identifier required by scope and no other target identifier." });
+    if (value.lead_ids && new Set(value.lead_ids).size !== value.lead_ids.length)
+        context.addIssue({ code: z.ZodIssueCode.custom, path: ["lead_ids"], message: "lead_ids must not contain duplicates." });
+});
+function resetScopePayload(value) {
+    return {
+        organizationId: value.organization_id,
+        scope: value.scope,
+        ...(value.scope === "lead" ? { leadId: value.lead_id } : {}),
+        ...(value.scope === "lead_ids" ? { leadIds: value.lead_ids } : {}),
+        ...(value.scope === "lead_group" ? { leadGroupId: value.lead_group_id } : {}),
+    };
+}
 function projectLead(lead, fields) {
     const source = lead && typeof lead === "object" ? lead : {};
     const data = source.data && typeof source.data === "object" ? source.data : {};
@@ -51,6 +76,30 @@ function compactLeadsResponse(data, fields, includeSchema) {
     return result;
 }
 export function registerLeadTools(server, client = getClient()) {
+    for (const reset of [
+        { key: "sequence_messages", label: "generated sequence messages" },
+        { key: "ai_fields", label: "AI-generated fields" },
+    ]) {
+        const route = reset.key === "sequence_messages" ? "sequence-messages" : "ai-fields";
+        server.tool(`preview_reset_${reset.key}`, `Preview the irreversible reset of ${reset.label}. This is non-mutating and returns the mandatory previewDigest, exact lead IDs and fields that would be cleared. Select one explicit scope only.`, destructiveResetScopeShape, async (params) => {
+            try {
+                const checked = destructiveResetScopeSchema.parse(params);
+                return toolResult(await client.post(`/api/resets/${route}/preview`, resetScopePayload(checked)));
+            }
+            catch (error) {
+                return handleToolError(error);
+            }
+        });
+        server.tool(`execute_reset_${reset.key}`, `IRREVERSIBLE: execute the ${reset.label} reset only after its preview. Requires that preview's exact digest and a unique idempotency key; the result includes persisted readback. This never sends outreach or changes campaigns, activities or contacts.`, { ...destructiveResetScopeShape, preview_digest: z.string().regex(/^[a-f0-9]{64}$/), idempotency_key: z.string().trim().min(8).max(200) }, async (params) => {
+            try {
+                const checked = destructiveResetScopeSchema.parse(params);
+                return toolResult(await client.post(`/api/resets/${route}/execute`, { ...resetScopePayload(checked), previewDigest: params.preview_digest, idempotencyKey: params.idempotency_key }));
+            }
+            catch (error) {
+                return handleToolError(error);
+            }
+        });
+    }
     // ── add_leads ──────────────────────────────────────────────────────────
     server.tool("add_leads", "Add one or more leads to a specific lead group in Leadify. Provide the group ID " +
         "and an array of lead objects with any combination of fields (email, firstName, " +
@@ -231,20 +280,6 @@ export function registerLeadTools(server, client = getClient()) {
             return handleToolError(error);
         }
     });
-    // ── delete_sequence_messages ──────────────────────────────────────────
-    server.tool("delete_sequence_messages", "Permanently remove only the generated LinkedIn and email sequence messages for one lead. " +
-        "It does not modify the lead's contact data, qualification, activities, campaign state, or any other fields. " +
-        "This action is irreversible: obtain explicit user confirmation before calling it.", {
-        lead_id: z.string().describe("ID of the lead whose generated sequence messages must be removed."),
-    }, async ({ lead_id }) => {
-        try {
-            const data = await client.post("/api/delete-sequence-messages", { leadId: lead_id });
-            return toolResult(data);
-        }
-        catch (error) {
-            return handleToolError(error);
-        }
-    });
     // ── delete_leads ───────────────────────────────────────────────────────
     server.tool("delete_leads", "Permanently delete one or more leads by their IDs. This action is irreversible. " +
         "Returns the count and IDs of deleted leads. If some leads are not found or " +

package/dist/version.d.ts

@@ -1,3 +1,3 @@
 export declare const MCP_PACKAGE_NAME = "@agifyai/leadify-mcp";
 export declare const MCP_SERVER_NAME = "leadify";
-export declare const MCP_VERSION = "8.4.2";
+export declare const MCP_VERSION = "8.5.1";

package/dist/version.js

@@ -1,3 +1,3 @@
 export const MCP_PACKAGE_NAME = "@agifyai/leadify-mcp";
 export const MCP_SERVER_NAME = "leadify";
-export const MCP_VERSION = "8.4.2";
+export const MCP_VERSION = "8.5.1";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agifyai/leadify-mcp",
-  "version": "8.4.2",
+  "version": "8.5.1",
   "description": "MCP server for Leadify lead management API",
   "type": "module",
   "main": "dist/index.js",