@agifyai/leadify-mcp 8.6.8 → 8.6.9

package/README.md

@@ -295,8 +295,8 @@ Leadify et ne doit jamais être envoyée par un agent MCP.
 | `update_company_brain_sections` | Modifier uniquement les sections globales encore actives (`identity`, `positioning`, `allowedVocabulary`, `prohibitedVocabulary`, `legalConstraints`). Les anciennes sections Offre/Verticale sont filtrées et refusées. |
 | `publish_context_workspace` | Publier une révision prête du Company Brain après confirmation explicite (`confirm_publish: true`). Admin de l'organisation requis ; les raisons de non-readiness sont renvoyées par le serveur. |
 | `list_persona_contracts` / `get_persona_contract` | Lister ou lire les contrats Persona canoniques d’une organisation explicitement sélectionnée. |
-| `create_persona_contract` | Créer un Persona tenant-scoped et lié à une Verticale depuis un contrat canonique complet. |
-| `replace_persona_contract` / `patch_persona_contract` | Remplacer ou modifier un contrat canonique avec verrou optimiste ; aucune colonne Persona historique n’est exposée. |
+| `create_persona_contract` | Créer un Persona tenant-scoped et lié à une Verticale depuis un contrat canonique v2 complet et strict. Toute clé inconnue est refusée. |
+| `replace_persona_contract` / `patch_persona_contract` | Remplacer ou modifier un contrat canonique v2 avec verrou optimiste. Le document est revalidé intégralement avant l’écriture et aucune colonne Persona historique n’est exposée. |
 | `change_persona_status` | Passer un Persona entre `DRAFT`, `ACTIVE` et `ARCHIVED` avec le même verrou `updated_at`, readiness et protection des références. |
 | `list_data_sources` | Lister toutes les sources de données configurées (par pays puis nom). |
 | `create_data_source` | Créer une nouvelle source de données (admin uniquement). |

package/dist/tools/context_entities.d.ts

@@ -161,6 +161,13 @@ export declare const verticalContextContentSchema: z.ZodEffects<z.ZodObject<{
         implication?: string | undefined;
     }>, "many">>;
 }, "strict", z.ZodTypeAny, {
+    painPoints?: {
+        id: string;
+        title: string;
+        description?: string | undefined;
+        customerCaseIds?: string[] | undefined;
+        useCaseIds?: string[] | undefined;
+    }[] | undefined;
     allowedVocabulary?: string[] | undefined;
     prohibitedVocabulary?: string[] | undefined;
     legalConstraints?: {
@@ -191,13 +198,6 @@ export declare const verticalContextContentSchema: z.ZodEffects<z.ZodObject<{
         description?: string | undefined;
         customerCaseIds?: string[] | undefined;
     }[] | undefined;
-    painPoints?: {
-        id: string;
-        title: string;
-        description?: string | undefined;
-        customerCaseIds?: string[] | undefined;
-        useCaseIds?: string[] | undefined;
-    }[] | undefined;
     qualificationSignals?: {
         id: string;
         title: string;
@@ -226,6 +226,13 @@ export declare const verticalContextContentSchema: z.ZodEffects<z.ZodObject<{
         implication?: string | undefined;
     }[] | undefined;
 }, {
+    painPoints?: {
+        id: string;
+        title: string;
+        description?: string | undefined;
+        customerCaseIds?: string[] | undefined;
+        useCaseIds?: string[] | undefined;
+    }[] | undefined;
     allowedVocabulary?: string[] | undefined;
     prohibitedVocabulary?: string[] | undefined;
     legalConstraints?: {
@@ -256,13 +263,6 @@ export declare const verticalContextContentSchema: z.ZodEffects<z.ZodObject<{
         description?: string | undefined;
         customerCaseIds?: string[] | undefined;
     }[] | undefined;
-    painPoints?: {
-        id: string;
-        title: string;
-        description?: string | undefined;
-        customerCaseIds?: string[] | undefined;
-        useCaseIds?: string[] | undefined;
-    }[] | undefined;
     qualificationSignals?: {
         id: string;
         title: string;
@@ -291,6 +291,13 @@ export declare const verticalContextContentSchema: z.ZodEffects<z.ZodObject<{
         implication?: string | undefined;
     }[] | undefined;
 }>, {
+    painPoints?: {
+        id: string;
+        title: string;
+        description?: string | undefined;
+        customerCaseIds?: string[] | undefined;
+        useCaseIds?: string[] | undefined;
+    }[] | undefined;
     allowedVocabulary?: string[] | undefined;
     prohibitedVocabulary?: string[] | undefined;
     legalConstraints?: {
@@ -321,13 +328,6 @@ export declare const verticalContextContentSchema: z.ZodEffects<z.ZodObject<{
         description?: string | undefined;
         customerCaseIds?: string[] | undefined;
     }[] | undefined;
-    painPoints?: {
-        id: string;
-        title: string;
-        description?: string | undefined;
-        customerCaseIds?: string[] | undefined;
-        useCaseIds?: string[] | undefined;
-    }[] | undefined;
     qualificationSignals?: {
         id: string;
         title: string;
@@ -356,6 +356,13 @@ export declare const verticalContextContentSchema: z.ZodEffects<z.ZodObject<{
         implication?: string | undefined;
     }[] | undefined;
 }, {
+    painPoints?: {
+        id: string;
+        title: string;
+        description?: string | undefined;
+        customerCaseIds?: string[] | undefined;
+        useCaseIds?: string[] | undefined;
+    }[] | undefined;
     allowedVocabulary?: string[] | undefined;
     prohibitedVocabulary?: string[] | undefined;
     legalConstraints?: {
@@ -386,13 +393,6 @@ export declare const verticalContextContentSchema: z.ZodEffects<z.ZodObject<{
         description?: string | undefined;
         customerCaseIds?: string[] | undefined;
     }[] | undefined;
-    painPoints?: {
-        id: string;
-        title: string;
-        description?: string | undefined;
-        customerCaseIds?: string[] | undefined;
-        useCaseIds?: string[] | undefined;
-    }[] | undefined;
     qualificationSignals?: {
         id: string;
         title: string;

package/dist/tools/personas.js

@@ -6,9 +6,68 @@ import { LeadifyApiError, handleToolError, toolResult } from "../types.js";
  * versioned `personaContract`. These tools deliberately do not expose any
  * historical Persona field or field-specific patch operation.
  */
-const contractSchema = z
-    .record(z.unknown())
-    .describe("Complete versioned Persona contract. Leadify validates its exact schema.");
+const tierSchema = z.object({
+    rule: z.string(),
+    expectedEvidence: z.string(),
+    examples: z.array(z.string()).max(20),
+}).strict();
+const commonContractSchema = z.object({
+    schemaVersion: z.literal(2),
+    kind: z.enum(["PERSON", "COMPANY"]),
+    targeting: z.object({
+        targetProfile: z.unknown().nullable(),
+        disqualificationCriteria: z.unknown().nullable(),
+        schemaPacks: z.array(z.string()).max(2),
+        agentDomain: z.string().nullable(),
+        outputLanguage: z.string().nullable(),
+    }).strict(),
+    qualification: z.object({
+        tiers: z.object({
+            hot: tierSchema,
+            warm: tierSchema,
+            cold: tierSchema,
+            disqualified: tierSchema,
+        }).strict(),
+        signalExamples: z.array(z.object({
+            id: z.string().min(1),
+            signal: z.string().min(1),
+            level: z.enum(["GOLDEN", "CRITICAL", "STRONG", "INFO"]),
+            justification: z.string().min(1),
+        }).strict()).max(100),
+        signalTierRules: z.unknown().nullable(),
+        enableSignals: z.boolean(),
+    }).strict(),
+    intelligence: z.object({
+        activeTools: z.array(z.string()),
+        painPoints: z.unknown().nullable(),
+        icpStrategy: z.unknown().nullable(),
+        cardAnalysisSections: z.unknown().nullable(),
+    }).strict(),
+    outreach: z.object({
+        outreachSignalRouting: z.unknown().nullable(),
+        outreachTemplates: z.unknown().nullable(),
+        toneInstructions: z.string().nullable(),
+        outreachFields: z.unknown().nullable(),
+    }).strict(),
+}).strict();
+const personExtensionSchema = z.object({
+    assessmentAxes: z.object({
+        identityAndEmployment: z.object({ question: z.string(), expectedEvidence: z.string() }).strict(),
+        commercialLink: z.object({ question: z.string(), expectedEvidence: z.string() }).strict(),
+        actionPower: z.object({ question: z.string(), expectedEvidence: z.string() }).strict(),
+        individualMoment: z.object({ question: z.string(), expectedEvidence: z.string() }).strict(),
+    }).strict(),
+    roleArchetypes: z.array(z.object({
+        name: z.string().min(1),
+        relevanceRule: z.string(),
+        expectedEvidence: z.string(),
+        examples: z.array(z.string()).max(20),
+    }).strict()).max(50),
+}).strict();
+const contractSchema = z.discriminatedUnion("kind", [
+    commonContractSchema.extend({ kind: z.literal("COMPANY"), person: z.null() }).strict(),
+    commonContractSchema.extend({ kind: z.literal("PERSON"), person: personExtensionSchema }).strict(),
+]).describe("Complete strict Persona contract, schemaVersion 2.");
 const tenantScope = {
     organization_id: z
         .string()
@@ -27,6 +86,7 @@ function canonicalPersona(persona) {
     if (!persona.personaContract || typeof persona.personaContract !== "object") {
         throw new Error("PERSONA_CONTRACT_REQUIRED: run the audited Persona migration before using this MCP.");
     }
+    const contract = contractSchema.parse(persona.personaContract);
     return {
         id: persona.id,
         name: persona.name,
@@ -34,7 +94,7 @@ function canonicalPersona(persona) {
         updatedAt: persona.updatedAt,
         revision: persona.revision ?? 0,
         status: persona.status,
-        contract: persona.personaContract,
+        contract,
     };
 }
 async function fetchPersona(id, organizationId, client) {
@@ -155,7 +215,7 @@ export function registerPersonaTools(server, injectedClient) {
                 organizationId: organization_id,
                 id,
                 expectedUpdatedAt: expected_updated_at,
-                contract: setContractPath(contract, path, value),
+                contract: contractSchema.parse(setContractPath(contract, path, value)),
                 client,
             }));
         }

package/package.json

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