@agifyai/leadify-mcp 8.8.0 → 8.9.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. |

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: the message type still follows the group's Fine Tuning languages).", {
         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/package.json

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