@agifyai/leadify-mcp 8.6.6 → 8.6.8

package/README.md

@@ -289,6 +289,9 @@ Leadify et ne doit jamais être envoyée par un agent MCP.
 | `preview_canonical_relationship_migration` | Prévisualiser une migration de champs historiques, divergences et quarantaines comprises, sans mutation. |
 | `apply_canonical_relationship_migration` | Appliquer exactement un plan prévisualisé et borné grâce à son digest. |
 | `rollback_canonical_relationship_migration` | Tombstoner les liens créés par un plan de migration précis. |
+| `configure_lead_group_relations` | Configurer, dans un tenant explicitement vérifié, la projection legacy relue par une migration canonique. |
+| `preview_canonical_identity_backfill` | Prévisualiser le backfill d'identité tenant-scoped d'un groupe et de ses parents Company configurés. |
+| `apply_canonical_identity_backfill` | Appliquer exactement un backfill d'identité relu par digest, sans outreach ni activation. |
 | `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. |

package/dist/server.js

@@ -15,6 +15,7 @@ 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";
+import { registerCanonicalBackfillTools } from "./tools/canonical_backfill.js";
 import { registerCommercialTruthTools } from "./tools/commercial_truth.js";
 import { registerEventTools } from "./tools/events.js";
 import { registerContextEntityTools } from "./tools/context_entities.js";
@@ -30,6 +31,7 @@ export function createServer() {
     registerLeadViewTools(server);
     registerLeadTools(server);
     registerRelationshipTools(server);
+    registerCanonicalBackfillTools(server);
     registerEventTools(server);
     registerCommercialTruthTools(server);
     registerSchemaTools(server);

package/dist/tools/canonical_backfill.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerCanonicalBackfillTools(server: McpServer, client?: import("../client.js").LeadifyClient): void;

package/dist/tools/canonical_backfill.js

@@ -0,0 +1,70 @@
+import { z } from "zod";
+import { getClient } from "../client.js";
+import { handleToolError, toolResult } from "../types.js";
+const relationshipType = z.enum(["EMPLOYED_BY", "AFFILIATED_WITH", "PART_OF", "COLLEAGUE_OF"]);
+const relation = z.object({
+    field: z.string().trim().min(1),
+    lead_group_id: z.string().trim().min(1),
+    target_field: z.string().trim().min(1).optional(),
+    display_field: z.string().trim().min(1).optional(),
+    inverse_field: z.string().trim().min(1).optional(),
+    canonical_type: relationshipType.optional(),
+    canonical_endpoint_role: z.enum(["SOURCE", "TARGET"]).optional(),
+    canonical_label: z.string().trim().min(1).max(120).optional(),
+}).strict().superRefine((value, context) => {
+    if (Boolean(value.canonical_type) === Boolean(value.canonical_endpoint_role))
+        return;
+    context.addIssue({ code: z.ZodIssueCode.custom, path: ["canonical_type"], message: "canonical_type and canonical_endpoint_role must be provided together" });
+});
+function apiRelation(value) {
+    return {
+        field: value.field,
+        leadGroupId: value.lead_group_id,
+        targetField: value.target_field,
+        displayField: value.display_field,
+        inverseField: value.inverse_field,
+        canonicalType: value.canonical_type,
+        canonicalEndpointRole: value.canonical_endpoint_role,
+        canonicalLabel: value.canonical_label,
+    };
+}
+const backfillScope = {
+    organization_id: z.string().trim().min(1),
+    lead_group_id: z.string().trim().min(1),
+    lead_ids: z.array(z.string().trim().min(1)).min(1).max(100),
+};
+export function registerCanonicalBackfillTools(server, client = getClient()) {
+    server.tool("configure_lead_group_relations", "Configure the legacy projection that a canonical migration reads. The organization is mandatory and verified against both groups; canonical_type and canonical_endpoint_role must be specified together. This changes no lead, identity, canonical relationship, campaign, or outreach.", { organization_id: z.string().trim().min(1), lead_group_id: z.string().trim().min(1), relations: z.array(relation).max(100) }, async ({ organization_id, lead_group_id, relations }) => {
+        try {
+            return toolResult(await client.put(`/api/lead-group/${encodeURIComponent(lead_group_id)}/relations`, {
+                organizationId: organization_id,
+                relations: relations.map(apiRelation),
+            }));
+        }
+        catch (error) {
+            return handleToolError(error);
+        }
+    });
+    server.tool("preview_canonical_identity_backfill", "Preview the tenant-scoped canonical identity backfill for one LeadGroup. It reads only the listed leads and their configured Company parent, returns an exact plan digest, and creates no identity, relationship, outreach, or activation.", backfillScope, async ({ organization_id, lead_group_id, lead_ids }) => {
+        try {
+            return toolResult(await client.post("/api/canonical-identity/backfill", {
+                organizationId: organization_id, leadGroupId: lead_group_id, leadIds: lead_ids,
+                projectionTarget: "lead", dryRun: true,
+            }));
+        }
+        catch (error) {
+            return handleToolError(error);
+        }
+    });
+    server.tool("apply_canonical_identity_backfill", "Apply exactly a reviewed canonical identity backfill plan. The organization and LeadGroup stay explicit, and the backend rejects a changed digest, cross-tenant lead, missing parent, or missing canonical Company account. It never sends outreach or activates campaigns.", { ...backfillScope, expected_plan_digest: z.string().regex(/^[a-f0-9]{64}$/) }, async ({ organization_id, lead_group_id, lead_ids, expected_plan_digest }) => {
+        try {
+            return toolResult(await client.post("/api/canonical-identity/backfill", {
+                organizationId: organization_id, leadGroupId: lead_group_id, leadIds: lead_ids,
+                projectionTarget: "lead", dryRun: false, expectedPlanDigest: expected_plan_digest,
+            }));
+        }
+        catch (error) {
+            return handleToolError(error);
+        }
+    });
+}

package/dist/tools/schema.js

@@ -85,7 +85,7 @@ export function registerSchemaTools(server, client) {
         lead_group_id: z.string().describe("ID of the lead group to inspect."),
     }, async ({ lead_group_id }) => {
         try {
-            const data = await (client ?? getClient()).rpc("leadGroups/schemaMigrationPreview", { leadGroupId: lead_group_id });
+            const data = await (client ?? getClient()).post(`/api/lead-group/${encodeURIComponent(lead_group_id)}/schema-migration/preview`, {});
             return toolResult(data);
         }
         catch (error) {
@@ -102,8 +102,7 @@ export function registerSchemaTools(server, client) {
         confirmation: z.literal("apply_destructive_schema_migration").describe("Exact acknowledgement required by the server."),
     }, async ({ lead_group_id, expected_schema_hash, expected_plan_hash, confirmation }) => {
         try {
-            const data = await (client ?? getClient()).rpc("leadGroups/applySchemaMigration", {
-                leadGroupId: lead_group_id,
+            const data = await (client ?? getClient()).post(`/api/lead-group/${encodeURIComponent(lead_group_id)}/schema-migration/apply`, {
                 expectedSchemaHash: expected_schema_hash,
                 expectedPlanHash: expected_plan_hash,
                 confirmation,

package/package.json

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