@agifyai/leadify-mcp 8.7.2 → 8.7.4

package/README.md

@@ -229,8 +229,8 @@ Leadify et ne doit jamais être envoyée par un agent MCP.
 | `test_api_key` | Vérifier que la clé API configurée est valide (health check). |
 | `list_lead_groups` | Lister les groupes accessibles d'une organisation explicitement sélectionnée, en vue compacte. |
 | `get_lead_group` | Consulter les métadonnées compactes d'un groupe accessible par son ID. |
-| `create_lead_group` | Créer un groupe et choisir son type canonique optionnel (`GENERIC`, `COMPANY` ou `PERSON`) via `entity_kind`. |
-| `update_lead_group` | Modifier un groupe, y compris son `entity_kind`, avec réconciliation du schéma côté Leadify. |
+| `create_lead_group` | Créer un groupe, choisir son type canonique optionnel et rattacher atomiquement `persona_id` avec l’`offer_id` ACTIVE du même tenant. |
+| `update_lead_group` | Modifier un groupe avec réconciliation du schéma ; lorsque le serveur exige un contexte complet, transmettre ensemble `persona_id` et `offer_id` sans inférer l’offre. |
 | `add_leads` | Ajouter un ou plusieurs leads à un groupe. |
 | `upsert_person_leads_with_employment` | Créer ou réconcilier atomiquement des Person Leads, PERSON, EMPLOYED_BY, projections et historique, sans effet commercial. |
 | `create_person_employment_evidence` / `get_person_employment_evidence` | Créer puis relire une preuve d’emploi individuelle tenant-scopée ; transmettre l’`evidence.id` retourné tel quel à l’upsert Person. |
@@ -278,6 +278,9 @@ Leadify et ne doit jamais être envoyée par un agent MCP.
 | `leadify_read_activity_feed` | Lire l'audit borné d'un lead ; le feed ne constitue jamais une preuve de réponse. |
 | `get_commercial_truth` | Réconcilier CRM, email, LinkedIn, Unipile et activité avec un statut, une fraîcheur et une action recommandée ; aucune écriture ni envoi. |
 | `compile_context_pack` | Compiler en lecture seule un Context Pack canonique depuis une cible explicite (`organization`, `lead_group`, `campaign`, `account`, `person`) ou un couple lead + campagne pour `WRITE_OUTREACH`. Retourne publications courantes, sources, freshness, contradictions et provenance, sans choisir de cible implicite. |
+| `get_claim_contradiction` | Lire une contradiction canonique tenant-scopée avec ses deux claims immuables, leurs preuves, sa version et son éventuelle résolution auditée. |
+| `resolve_claim_contradiction` | Arbitrer explicitement une contradiction relue par sélection d’un claim ou coexistence, avec justification, version, état attendu et clé d’idempotence ; aucun effet commercial. |
+| `resolve_claim_contradictions_batch` | Soumettre jusqu’à 100 arbitrages explicites et relire chaque résultat ordonné, sans choix automatique ni résolution implicite. |
 | `get_context_workspace` | Lire le seul Context Workspace encore exposé et versionné : le `company_brain` d'une organisation explicitement sélectionnée. Retourne le brouillon et la dernière version publiée ; l'historique GTM reste stocké mais n'est plus exposé. |
 | `list_verticals` / `get_vertical` | Lister ou lire les Verticales JSON simples d’une organisation explicitement sélectionnée, avec leurs Personas et Offres liées. |
 | `create_vertical` | Créer une Verticale tenant-scoped en `DRAFT`, sans activation ni sélection implicite. Son schéma JSON fermé porte les règles sectorielles et `commercialExperience` ; les métadonnées de preuve/source/provenance et les champs propres à l’Offre sont refusés. |

package/dist/server.js

@@ -20,6 +20,7 @@ import { registerCommercialTruthTools } from "./tools/commercial_truth.js";
 import { registerEventTools } from "./tools/events.js";
 import { registerContextEntityTools } from "./tools/context_entities.js";
 import { registerPersonEmploymentTools } from "./tools/person_employment.js";
+import { registerClaimContradictionTools } from "./tools/claim_contradictions.js";
 import { MCP_SERVER_NAME, MCP_VERSION } from "./version.js";
 export function createServer() {
     const server = new McpServer({
@@ -33,6 +34,7 @@ export function createServer() {
     registerLeadTools(server);
     registerRelationshipTools(server);
     registerCanonicalBackfillTools(server);
+    registerClaimContradictionTools(server);
     registerPersonEmploymentTools(server);
     registerEventTools(server);
     registerCommercialTruthTools(server);

package/dist/tools/claim_contradictions.d.ts

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

package/dist/tools/claim_contradictions.js

@@ -0,0 +1,85 @@
+import { z } from "zod";
+import { getClient } from "../client.js";
+import { handleToolError, toolResult } from "../types.js";
+const id = z.string().trim().min(1).max(200);
+const decision = z.discriminatedUnion("type", [
+    z.object({ type: z.literal("SELECT_CLAIM"), retained_claim_id: id }).strict(),
+    z.object({ type: z.literal("COEXIST") }).strict(),
+]);
+const resolutionFields = {
+    decision,
+    justification: z.string().trim().min(8).max(2_000),
+    expected_version: z.number().int().min(1),
+    expected_status: z.literal("OPEN"),
+    idempotency_key: z.string().trim().min(8).max(220),
+};
+const resolution = z.object(resolutionFields).strict();
+const resolutionItem = resolution.extend({ contradiction_id: id }).strict();
+function apiResolution(input) {
+    return {
+        decision: input.decision.type === "SELECT_CLAIM"
+            ? { type: input.decision.type, retainedClaimId: input.decision.retained_claim_id }
+            : { type: input.decision.type },
+        justification: input.justification,
+        expectedVersion: input.expected_version,
+        expectedStatus: input.expected_status,
+        idempotencyKey: input.idempotency_key,
+    };
+}
+export function registerClaimContradictionTools(server, client = getClient()) {
+    server.registerTool("get_claim_contradiction", {
+        title: "Read a canonical claim contradiction",
+        description: "Read one tenant-scoped ClaimContradiction with both immutable claims, their evidence, provenance, current version and audited resolution. This never resolves the contradiction or changes commercial state.",
+        inputSchema: {
+            organization_id: id.describe("Organization explicitly selected through discover_leadify_context."),
+            contradiction_id: id.describe("ClaimContradiction ID obtained from a fresh Context Pack or prior read."),
+        },
+        annotations: { readOnlyHint: true },
+    }, async ({ organization_id, contradiction_id }) => {
+        try {
+            return toolResult(await client.get(`/api/claim-contradictions/${encodeURIComponent(contradiction_id)}`, new URLSearchParams({ organizationId: organization_id })));
+        }
+        catch (error) {
+            return handleToolError(error);
+        }
+    });
+    server.registerTool("resolve_claim_contradiction", {
+        title: "Resolve a canonical claim contradiction",
+        description: "Persist one explicit, audited decision after reading the contradiction. SELECT_CLAIM must name one member claim; COEXIST keeps both. The server rejects stale versions, changed state, cross-tenant access and divergent idempotent replays. This never qualifies leads, creates messages, changes campaigns or sends outreach.",
+        inputSchema: {
+            organization_id: id.describe("Explicit organization; an admin write key is required."),
+            contradiction_id: id.describe("ClaimContradiction ID read immediately before this decision."),
+            ...resolutionFields,
+        },
+        annotations: { destructiveHint: false, idempotentHint: true },
+    }, async ({ organization_id, contradiction_id, ...input }) => {
+        try {
+            return toolResult(await client.post(`/api/claim-contradictions/${encodeURIComponent(contradiction_id)}/resolve`, { organizationId: organization_id, ...apiResolution(input) }));
+        }
+        catch (error) {
+            return handleToolError(error);
+        }
+    });
+    server.registerTool("resolve_claim_contradictions_batch", {
+        title: "Resolve explicit claim contradictions in a batch",
+        description: "Submit up to 100 independent, explicit ClaimContradiction decisions. The API reports each item in order as resolved, replayed or error; there is no automatic choice, latest-wins rule or commercial side effect.",
+        inputSchema: {
+            organization_id: id.describe("Explicit organization shared by every decision; an admin write key is required."),
+            decisions: z.array(resolutionItem).min(1).max(100),
+        },
+        annotations: { destructiveHint: false, idempotentHint: true },
+    }, async ({ organization_id, decisions }) => {
+        try {
+            return toolResult(await client.post("/api/claim-contradictions/resolve-batch", {
+                organizationId: organization_id,
+                decisions: decisions.map(({ contradiction_id, ...input }) => ({
+                    contradictionId: contradiction_id,
+                    ...apiResolution(input),
+                })),
+            }));
+        }
+        catch (error) {
+            return handleToolError(error);
+        }
+    });
+}

package/dist/tools/lead_groups.js

@@ -48,6 +48,11 @@ export function registerLeadGroupTools(server, writeClient) {
             .optional()
             .describe("ICP persona ID to assign. Must belong to the same org or be global. " +
             "Omit to create the group without a persona."),
+        offer_id: z
+            .string()
+            .nullable()
+            .optional()
+            .describe("Active offer ID to assign with persona_id. Must belong to the same organization."),
     }, async (params) => {
         try {
             const body = {
@@ -66,6 +71,8 @@ export function registerLeadGroupTools(server, writeClient) {
                 body.disabledTools = params.disabled_tools;
             if (params.persona_id !== undefined)
                 body.personaId = params.persona_id;
+            if (params.offer_id !== undefined)
+                body.offerId = params.offer_id;
             const data = await (writeClient ?? getClient()).post("/api/lead-group", body);
             return toolResult(data);
         }
@@ -91,6 +98,11 @@ export function registerLeadGroupTools(server, writeClient) {
             .nullable()
             .optional()
             .describe("New ICP persona ID. Pass null to unassign. Must belong to the same org or be global."),
+        offer_id: z
+            .string()
+            .nullable()
+            .optional()
+            .describe("Active offer ID to assign with persona_id. Pass null only when removing the binding."),
         persona_types: z
             .array(z.string())
             .optional()
@@ -116,6 +128,8 @@ export function registerLeadGroupTools(server, writeClient) {
                 body.entityKind = params.entity_kind;
             if (params.persona_id !== undefined)
                 body.personaId = params.persona_id;
+            if (params.offer_id !== undefined)
+                body.offerId = params.offer_id;
             if (params.persona_types !== undefined)
                 body.personaTypes = params.persona_types;
             if (params.company_profile !== undefined)

package/package.json

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