@agifyai/leadify-mcp 8.8.0 → 9.0.0

package/README.md

@@ -267,7 +267,7 @@ Leadify et ne doit jamais être envoyée par un agent MCP.
 | `unenroll_campaign_audience` | Désenrôler uniquement la liste complète de `lead_ids` renvoyée par le preview courant. Relit et refuse toute sélection partielle, étendue ou périmée ; aucun envoi. |
 | `export_campaign` | Exporter les statistiques en CSV ; après clôture définitive, l'export provient du rapport final figé. |
 | `list_playbooks` / `get_playbook` | Lister et lire les « Messages types » (playbooks du rédacteur) d’une organisation, avec leur contenu complet à la dernière version. |
-| `publish_playbook` | Publier un message type : création, duplication ou nouvelle version (avec la version relue). Les refus du contrat du rédacteur sont rendus avec leur chemin. |
+| `publish_playbook` | Publier un message type : création, duplication ou nouvelle version (avec la version relue), avec ses langues autorisées et sa langue de repli (`allowed_languages`, `fallback_language`, obligatoires à la création, gardées de la version précédente ou de l’original si absentes). Les refus du contrat du rédacteur sont rendus avec leur chemin. |
 | `list_campaign_senders` | Lister les comptes d’envoi (LinkedIn, boîtes mail) de la personne qui porte la clé : les messages partent à son nom. |
 | `get_campaign_audience_options` | Compter les personnes d’un groupe et de chacun de ses segments pour choisir l’audience d’une campagne. |
 | `get_contact_policy` | Lire la politique de contact effective de l’organisation ou d’une campagne, en lecture seule. |
@@ -329,8 +329,6 @@ Leadify et ne doit jamais être envoyée par un agent MCP.
 | `update_outreach_urls` | Patch booking_url et/ou website_url uniquement. |
 | `set_outreach_connection_request` | Toggle du flag connectionRequestEnabled (LinkedIn invite vs cold DM). |
 | `trigger_outreach` | Générer un message via le runtime Write Outreach (dry-run par défaut). Le rédacteur libre peut fournir un `context_selection` complet Verticale–Offre–Persona ; aucun objet ou défaut n’est inféré. Avant une écriture, le runtime relit le digest et refuse toute persistance si le contexte a changé. |
-| `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. |
 
 ### `source-icp-prospects` : sourcing Personne rattachée à une Company

package/dist/server.js

@@ -12,7 +12,6 @@ import { registerPersonaTools } from "./tools/personas.js";
 import { registerLeadGroupTools } from "./tools/lead_groups.js";
 import { registerOrganizationTools } from "./tools/organizations.js";
 import { registerPipelineTools } from "./tools/pipeline.js";
-import { registerFineTuningTools } from "./tools/fine_tuning.js";
 import { registerContextWorkspaceTools } from "./tools/context_workspace.js";
 import { registerLeadViewTools } from "./tools/views.js";
 import { registerRelationshipTools } from "./tools/relationships.js";
@@ -52,6 +51,5 @@ export function createServer() {
     registerDataSourceTools(server);
     registerPersonaTools(server);
     registerPipelineTools(server);
-    registerFineTuningTools(server);
     return server;
 }

package/dist/tools/campaign_wizard.js

@@ -19,11 +19,14 @@ function assertReviewMode(data) {
     }
     return data;
 }
+/** Langues d’un message type, codes du produit Leadify (PRD-2231). */
+const PLAYBOOK_LANGUAGES = ["fr", "en", "de", "es", "it"];
 export function registerCampaignWizardTools(server, injectedClient) {
     const client = () => injectedClient ?? getClient();
     // ── Messages types (playbooks) ─────────────────────────────────────────
     server.tool("list_playbooks", "List the organization's 'Messages types' (outreach playbooks) used by the outreach writer: id, name, kind " +
-        "(EVENT or GENERIC), latest version, validity window, linked event, channels with steps, and campaign usage.", {
+        "(EVENT or GENERIC), latest version, validity window, linked event, channels with steps, campaign usage, and " +
+        "languages {allowedLanguages, fallbackLanguage} (null: no languages declared on this message type).", {
         organization_id: organizationId,
         include_archived: z.boolean().optional().default(false).describe("Include archived playbooks."),
     }, async ({ organization_id, include_archived }) => {
@@ -35,7 +38,7 @@ export function registerCampaignWizardTools(server, injectedClient) {
         }
     });
     server.tool("get_playbook", "Read one 'Message type' at its latest version, with its full editable content (intent, eligibility, " +
-        "judgment guidance, promise, proofs, CTA, sequences and examples). Use it before publishing a new version.", {
+        "judgment guidance, promise, proofs, CTA, sequences and examples) and its languages. Use it before publishing a new version.", {
         organization_id: organizationId,
         playbook_id: z.string().min(1).describe("Playbook ID from list_playbooks."),
     }, async ({ organization_id, playbook_id }) => {
@@ -52,16 +55,39 @@ export function registerCampaignWizardTools(server, injectedClient) {
         "{startsAt?, endsAt?}, eligibility {all: [...]}, judgmentGuidance, promise, proofs [{id, statement, sourceUrl?}], " +
         "cta {description, url?}, sequences [{channel: EMAIL|LINKEDIN, steps: [{step, kind: EMAIL|LINKEDIN_INVITE|LINKEDIN_MESSAGE, delayDays, purpose}]}], " +
         "examples [{channel, step, subject?, body, commentary?}]. An EVENT playbook requires an eligibility condition " +
-        "{type: 'event_participation', eventId, status: 'VERIFIED'}. Contract refusals are returned with their JSON path.", {
+        "{type: 'event_participation', eventId, status: 'VERIFIED'}. Languages: the message is written in the prospect's " +
+        "preferred language when it is in allowed_languages, otherwise in fallback_language. Both are required to create a message type; " +
+        "omitted on a new version or a duplicate, the previous or source languages are kept. Contract refusals are returned with their JSON path.", {
         organization_id: organizationId,
         kind: z.enum(["EVENT", "GENERIC"]).describe("EVENT requires a verified event participation; GENERIC does not. Fixed after creation."),
         content: z.record(z.unknown()).describe("Playbook content (see the tool description)."),
         playbook_id: z.string().min(1).optional().describe("Existing playbook to publish a new version of."),
         expected_version: z.number().int().min(1).optional().describe("Latest version read by get_playbook; required with playbook_id."),
         duplicated_from_id: z.string().min(1).optional().describe("Playbook duplicated into a new one."),
-    }, async ({ organization_id, kind, content, playbook_id, expected_version, duplicated_from_id }) => {
+        allowed_languages: z
+            .array(z.enum(PLAYBOOK_LANGUAGES))
+            .min(1)
+            .optional()
+            .describe("Languages the message may be written in (fr, en, de, es, it). Requires fallback_language."),
+        fallback_language: z
+            .enum(PLAYBOOK_LANGUAGES)
+            .optional()
+            .describe("Language used when the prospect's preferred language is not allowed; one of allowed_languages."),
+    }, async ({ organization_id, kind, content, playbook_id, expected_version, duplicated_from_id, allowed_languages, fallback_language }) => {
         try {
+            if ((allowed_languages === undefined) !== (fallback_language === undefined)) {
+                return handleToolError(new Error("allowed_languages and fallback_language go together: set both, or neither to keep the previous languages."));
+            }
+            if (allowed_languages === undefined && playbook_id === undefined && duplicated_from_id === undefined) {
+                return handleToolError(new Error("A new message type needs its languages: set allowed_languages and fallback_language."));
+            }
+            if (allowed_languages !== undefined && fallback_language !== undefined && !allowed_languages.includes(fallback_language)) {
+                return handleToolError(new Error("fallback_language must be one of allowed_languages."));
+            }
             const body = { organizationId: organization_id, kind, content };
+            if (allowed_languages !== undefined && fallback_language !== undefined) {
+                body.languages = { allowedLanguages: allowed_languages, fallbackLanguage: fallback_language };
+            }
             if (playbook_id !== undefined)
                 body.playbookId = playbook_id;
             if (expected_version !== undefined)

package/dist/tools/pipeline.js

@@ -32,7 +32,8 @@ export function registerPipelineTools(server, client = getClient()) {
         "Vertical, Offer and Persona triplet. The backend requires all three objects to be " +
         "ACTIVE, tenant-scoped and linked; no default is inferred. Omit context_selection " +
         "to use the Lead Group-owned selection. The exact message-card set always comes " +
-        "from Fine Tuning and cannot be selected through technical card names.", {
+        "from the campaign's message type (playbook), the only source of writing instructions, " +
+        "and cannot be selected through technical card names.", {
         lead_id: z.string().describe("ID of the lead to generate a message for."),
         dryrun: z
             .boolean()
@@ -103,39 +104,6 @@ export function registerPipelineTools(server, client = getClient()) {
             return handleToolError(error);
         }
     });
-    // ── append_fine_tuning ───────────────────────────────────────────────────
-    server.tool("append_fine_tuning", "Append content to a Fine Tuning section for a lead group. " +
-        "ALWAYS in append mode — NEVER replaces existing content (contractual guarantee). " +
-        "Use this to incrementally build up rules and examples as you iterate with the user. " +
-        "Sections: nonNegotiableRules (imperative rules), pitfalls (traps to avoid), " +
-        "structure (imposed message structure), examples (validated message samples). " +
-        "For full rewrites, use the Leadify UI or the classic update endpoint.", {
-        lead_group_id: z.string().describe("ID of the lead group."),
-        section: z
-            .enum(["nonNegotiableRules", "pitfalls", "structure", "examples"])
-            .describe("Fine Tuning section to enrich."),
-        content: z
-            .string()
-            .describe("Content to APPEND (not replace). Concatenated after existing content."),
-        separator: z
-            .string()
-            .optional()
-            .default("\n\n---\n\n")
-            .describe("Separator between old and new content. Default: '\\n\\n---\\n\\n'."),
-    }, async ({ lead_group_id, section, content, separator }) => {
-        try {
-            const data = await client.post("/api/pipeline/append-fine-tuning", {
-                leadGroupId: lead_group_id,
-                section,
-                content,
-                separator,
-            });
-            return toolResult(data);
-        }
-        catch (error) {
-            return handleToolError(error);
-        }
-    });
     // ── pipeline_next_lead ───────────────────────────────────────────────────
     server.tool("pipeline_next_lead", "Select the next lead to process in the campaign pipeline. " +
         "Returns the hottest leads (highest score) that don't yet have a message " +

package/package.json

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

package/dist/tools/fine_tuning.d.ts

@@ -1,5 +0,0 @@
-import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-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,124 +0,0 @@
-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.
-//
-// Two write tools coexist by design, with NON-OVERLAPPING contracts:
-//   - append_fine_tuning  → ALWAYS appends, never replaces. Contractual guarantee
-//                            for the iterative build-up pattern (skill operator
-//                            accumulates rules and examples as the user iterates).
-//   - set_fine_tuning     → WHOLESALE replace of ONE section. Use when you need
-//                            to wipe + rewrite a section cleanly (e.g. after a big
-//                            refactor, or to clear a section by passing empty
-//                            content).
-// The split exists so neither caller is ever confused about which behavior
-// they triggered.
-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: " +
-        "(1) nonNegotiableRules (Markdown), (2) pitfalls (Markdown), (3) structure (Markdown), " +
-        "(4) supportedLanguages (string[]), (5) examples (Markdown), plus fallbackLanguage. " +
-        "Read STRICTLY from the FineTuning model — zero OutreachSettings mixed in. " +
-        "Use this when editing the Fine Tuning page or when an agent needs the copywriting " +
-        "guardrails (rules + pitfalls + structure + examples + languages). " +
-        "Upsert-on-read: if no FineTuning row exists for the lead group, one is created " +
-        "with defaults, so the response shape is always stable.", {
-        lead_group_id: z
-            .string()
-            .describe("ID of the lead group whose fine tuning configuration to fetch. " +
-            "Pass the lead_group_id directly; if you need to resolve it, use " +
-            "pipeline_next_lead (do NOT use get_leads — its payload is huge and is " +
-            "banned in the outreach pipeline)."),
-    }, async ({ lead_group_id }) => {
-        try {
-            const data = await (client ?? getClient()).get(`/api/lead-group/${encodeURIComponent(lead_group_id)}/fine-tuning`);
-            return toolResult(data);
-        }
-        catch (error) {
-            return handleToolError(error);
-        }
-    });
-    // ── set_fine_tuning ───────────────────────────────────────────────────
-    // WHOLESALE replace of one Fine Tuning section. Distinct from
-    // append_fine_tuning (which is append-only, contractual). Both tools
-    // coexist intentionally — pick the right one for the intent.
-    server.tool("set_fine_tuning", "WHOLESALE replace ONE section of the fine tuning configuration for a lead group. " +
-        "The target section is fully overwritten with the new content. " +
-        "This is the destructive counterpart of append_fine_tuning: use it when you need " +
-        "to wipe and rewrite a section cleanly (big refactor, schema change, full clear). " +
-        "SIBLING SECTIONS ARE NOT TOUCHED. Only the named section is replaced; the other 3 " +
-        "Markdown sections, supportedLanguages, and fallbackLanguage stay intact. " +
-        "To clear a section, pass content=\"\". " +
-        "DO NOT use this for incremental edits — use append_fine_tuning instead so the " +
-        "iterative build-up pattern is preserved (no accidental wipe of accumulated rules " +
-        "or examples). " +
-        "The 4 replaceable sections are: nonNegotiableRules, pitfalls, structure, examples. " +
-        "Languages (supportedLanguages, fallbackLanguage) are managed separately via the " +
-        "Fine Tuning UI or by a dedicated languages tool — this endpoint does not touch them. " +
-        "Wired to PATCH /api/lead-group/{id}/fine-tuning/section/{section} per the Leadify API " +
-        "contract: section is in the URL path (not the body), the request is a partial update " +
-        "(not a wholesale row replace — for that, fall back to the Leadify UI or a follow-up " +
-        "MCP tool, neither of which exists yet as of 3.6.1).", {
-        lead_group_id: z
-            .string()
-            .describe("ID of the lead group whose fine tuning section to overwrite."),
-        section: z
-            .enum(["nonNegotiableRules", "pitfalls", "structure", "examples"])
-            .describe("Which Fine Tuning section to replace. One of: " +
-            "nonNegotiableRules | pitfalls | structure | examples. " +
-            "Goes into the URL path as /section/{section} — not the request body."),
-        content: z
-            .string()
-            .describe("New content for the section (Markdown). The section is replaced WHOLESALE — " +
-            "any previous content is lost. Pass an empty string to clear the section."),
-    }, async ({ lead_group_id, section, content }) => {
-        try {
-            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}.`,
-            });
-        }
-        catch (error) {
-            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);
-        }
-    });
-}