@agifyai/leadify-mcp 8.6.1 → 8.6.3

package/README.md

@@ -210,6 +210,13 @@ des sélecteurs courants sans effacer son historique. Les champs legacy
 restent disponibles pour compatibilité/export, mais ne sont jamais synchronisés
 depuis ce modèle.
 
+Il n’existe plus de score de confiance événementiel : le statut et ses preuves
+portent seuls la validation utile. `Event.description` explique l’audience et
+l’utilité de l’événement ; `activity_summary` explique ce que l’entreprise y
+fait, présente ou cible. `proof_excerpt` reste l’extrait exact destiné aux
+agents et à l’audit. `record_event_participations` sert aussi bien à créer une
+participation qu’à ajouter une nouvelle preuve ou à corriger le snapshot.
+
 Pour `add_leads` et `update_lead`, `location` utilise l’objet canonique
 `{ city, region?, postalCode?, countryCode, street? }`. `city` et le code pays
 ISO-2 `countryCode` sont obligatoires. La projection `geo` est calculée par

package/dist/tools/events.js

@@ -19,13 +19,14 @@ const role = z.enum([
     "OTHER",
 ]);
 const status = z.enum(["UNVERIFIED", "VERIFIED", "DISPUTED", "REFUTED"]);
-const confidence = z.enum(["LOW", "MEDIUM", "HIGH"]);
 const nullableLabel = z.string().trim().min(1).max(500).nullable().optional();
+const nullableNarrative = z.string().trim().min(1).max(5_000).nullable().optional();
 const nullableUrl = z.string().trim().url().max(2048).nullable().optional();
 const idempotencyKey = z.string().trim().min(1).max(255);
 const eventFields = {
     name: z.string().trim().min(1).max(300),
     edition: z.string().trim().min(1).max(200),
+    description: nullableNarrative.describe("Readable description of the event, its audience, purpose and importance."),
     starts_on: dateOnly,
     ends_on: dateOnly,
     city: nullableLabel,
@@ -50,6 +51,7 @@ const updateEventShape = {
     event_id: z.string().trim().min(1),
     name: eventFields.name.optional(),
     edition: eventFields.edition.optional(),
+    description: eventFields.description,
     starts_on: eventFields.starts_on.optional(),
     ends_on: eventFields.ends_on.optional(),
     city: eventFields.city,
@@ -62,7 +64,7 @@ const updateEventShape = {
     idempotency_key: idempotencyKey,
 };
 const updateEventInput = z.object(updateEventShape).strict().superRefine((value, context) => {
-    const mutable = ["name", "edition", "starts_on", "ends_on", "city", "country_code", "venue", "official_url", "last_verified_on"];
+    const mutable = ["name", "edition", "description", "starts_on", "ends_on", "city", "country_code", "venue", "official_url", "last_verified_on"];
     const supplied = mutable.filter((key) => value[key] !== undefined);
     if (value.archive && supplied.length > 0) {
         context.addIssue({ code: z.ZodIssueCode.custom, path: ["archive"], message: "Archive and field updates must be separate idempotent operations." });
@@ -83,10 +85,10 @@ const participationItem = z.object({
     stands: z.array(z.string().trim().min(1).max(200)).max(50).optional().default([]),
     source_urls: z.array(z.string().trim().url().max(2048)).max(50).optional().default([]),
     source_provider: nullableLabel,
+    activity_summary: nullableNarrative.describe("Readable summary of what the company does, presents or targets at this event."),
     proof_excerpt: z.string().trim().min(1).max(20_000),
     observed_on: dateOnly,
     verified_on: dateOnly.nullable().optional(),
-    confidence,
     status,
     correction_reason: z.string().trim().min(1).max(5_000).optional(),
     idempotency_key: idempotencyKey,
@@ -121,10 +123,10 @@ function participationPayload(item) {
         stands: item.stands,
         sourceUrls: item.source_urls,
         sourceProvider: item.source_provider,
+        activitySummary: item.activity_summary,
         proofExcerpt: item.proof_excerpt,
         observedOn: item.observed_on,
         verifiedOn: item.verified_on,
-        confidence: item.confidence,
         status: item.status,
         correctionReason: item.correction_reason,
         idempotencyKey: item.idempotency_key,
@@ -208,6 +210,7 @@ export function registerEventTools(server, client = getClient()) {
                 slug: input.slug,
                 name: input.name,
                 edition: input.edition,
+                description: input.description,
                 startsOn: input.starts_on,
                 endsOn: input.ends_on,
                 city: input.city,
@@ -236,6 +239,7 @@ export function registerEventTools(server, client = getClient()) {
                     organizationId: input.organization_id,
                     name: input.name,
                     edition: input.edition,
+                    description: input.description,
                     startsOn: input.starts_on,
                     endsOn: input.ends_on,
                     city: input.city,
@@ -260,13 +264,12 @@ export function registerEventTools(server, client = getClient()) {
         editions: z.array(z.string().trim().min(1).max(200)).max(100).optional(),
         roles: z.array(role).max(20).optional(),
         statuses: z.array(status).min(1).max(10).optional().default(["VERIFIED"]),
-        confidences: z.array(confidence).max(10).optional(),
         starts_on_from: dateOnly.optional(),
         starts_on_to: dateOnly.optional(),
         include_facts: z.boolean().optional().default(false),
         limit: z.number().int().min(1).max(100).optional().default(50),
         cursor: z.string().trim().min(1).optional(),
-    }, async ({ organization_id, event_ids, account_ids, lead_id, editions, roles, statuses, confidences, starts_on_from, starts_on_to, include_facts, limit, cursor }) => {
+    }, async ({ organization_id, event_ids, account_ids, lead_id, editions, roles, statuses, starts_on_from, starts_on_to, include_facts, limit, cursor }) => {
         try {
             const params = new URLSearchParams({
                 organizationId: organization_id,
@@ -280,7 +283,6 @@ export function registerEventTools(server, client = getClient()) {
                 params.set("leadId", lead_id);
             setCsv(params, "editions", editions);
             setCsv(params, "roles", roles);
-            setCsv(params, "confidences", confidences);
             if (starts_on_from)
                 params.set("startsOnFrom", starts_on_from);
             if (starts_on_to)
@@ -318,7 +320,7 @@ export function registerEventTools(server, client = getClient()) {
             return handleToolError(error);
         }
     });
-    server.tool("record_event_participations", "Validate or record 1-100 company-event participation observations. Set validate_only=true for a no-write dry-run. Each item targets exactly one account_id or resolvable lead_id and has its own idempotency key. Corrections append an immutable fact and require correction_reason; there is no delete operation. VERIFIED requires a source URL, proof excerpt and verification date. Uncertain or absent data cannot be cited as attendance.", {
+    server.tool("record_event_participations", "Create participation evidence, add a corroborating source, or correct 1-100 company-event observations. Set validate_only=true for a no-write dry-run. activity_summary is the readable account of what the company does at the event; proof_excerpt remains the exact agent/audit evidence. Each item targets exactly one account_id or resolvable lead_id and has its own idempotency key. Corrections append an immutable fact and require correction_reason; there is no delete operation. VERIFIED requires a source URL, proof excerpt and verification date. Uncertain or absent data cannot be cited as attendance.", {
         organization_id: z.string().trim().min(1),
         batch_id: z.string().trim().min(1).max(255),
         validate_only: z.boolean().optional().default(false),

package/dist/tools/leads.js

@@ -10,7 +10,6 @@ const eventFilterSchema = z.object({
         "CONTRIBUTOR", "PARTICIPANT", "UNKNOWN", "OTHER",
     ])).max(20).optional(),
     statuses: z.array(z.enum(["UNVERIFIED", "VERIFIED", "DISPUTED", "REFUTED"])).min(1).max(10).optional(),
-    confidences: z.array(z.enum(["LOW", "MEDIUM", "HIGH"])).max(10).optional(),
     starts_on_from: z.string().regex(/^\d{4}-\d{2}-\d{2}$/).optional(),
     starts_on_to: z.string().regex(/^\d{4}-\d{2}-\d{2}$/).optional(),
 }).strict().superRefine((value, context) => {
@@ -193,7 +192,7 @@ export function registerLeadTools(server, client = getClient()) {
             "operator to value. Operators: equals, not_equals, contains, not_contains, " +
             "gte, lte, is_true, is_false, is_null, is_not_null. " +
             'Example: {"industry": {"contains": "tech"}, "company": {"is_not_null": "true"}}'),
-        event_filter: eventFilterSchema.optional().describe("Structured company-event participation filter. Values within one list use OR; event, edition, role, status, confidence and date dimensions use AND against the same participation. statuses defaults to [VERIFIED]. Pass uncertain statuses explicitly for review. There is no negative or absence filter."),
+        event_filter: eventFilterSchema.optional().describe("Structured company-event participation filter. Values within one list use OR; event, edition, role, status and date dimensions use AND against the same participation. statuses defaults to [VERIFIED]. Pass uncertain statuses explicitly for review. There is no confidence score, negative operator or absence filter."),
     }, async ({ group_id, view_id, page, limit, search, fields, include_schema, filters, event_filter }) => {
         try {
             const params = new URLSearchParams();
@@ -220,7 +219,6 @@ export function registerLeadTools(server, client = getClient()) {
                     ...(checked.editions ? { editions: checked.editions } : {}),
                     ...(checked.roles ? { roles: checked.roles } : {}),
                     statuses: checked.statuses ?? ["VERIFIED"],
-                    ...(checked.confidences ? { confidences: checked.confidences } : {}),
                     ...(checked.starts_on_from ? { startsOnFrom: checked.starts_on_from } : {}),
                     ...(checked.starts_on_to ? { startsOnTo: checked.starts_on_to } : {}),
                 }));

package/dist/tools/personas.js

@@ -40,6 +40,16 @@ const signalTierRule = z.object({
     signal_id: z.string().optional(),
     tier: z.enum(["hot", "warm", "cold"]).optional(),
 });
+// Persona v2 owns entity-specific qualification contracts. Keep their nested
+// shape forward-compatible here: the Leadify API remains the authority that
+// validates the versioned Company/Person contracts, while the MCP must never
+// silently strip them before forwarding the wholesale upsert.
+const companyQualification = z
+    .record(z.unknown())
+    .describe("Versioned Company Persona qualification contract forwarded unchanged to Leadify.");
+const personQualification = z
+    .record(z.unknown())
+    .describe("Versioned Person Persona qualification contract forwarded unchanged to Leadify.");
 const extraPromptPhase = z.object({
     scope: z.enum(["qualify", "outreach"]).optional(),
     insertion_point: z
@@ -319,6 +329,9 @@ export function registerPersonaTools(server, client) {
             .min(1)
             .describe("Required Vertical ID in the same organization."),
         description: z.string().optional().describe("Detailed persona description."),
+        // Persona v2 qualification contracts
+        company_qualification: companyQualification.optional(),
+        person_qualification: personQualification.optional(),
         // targeting
         target_profile: z
             .record(z.unknown())
@@ -449,6 +462,10 @@ export function registerPersonaTools(server, client) {
                 body.expectedUpdatedAt = params.expected_updated_at;
             if (params.description !== undefined)
                 body.description = params.description;
+            if (params.company_qualification !== undefined)
+                body.companyQualification = params.company_qualification;
+            if (params.person_qualification !== undefined)
+                body.personQualification = params.person_qualification;
             if (params.target_profile !== undefined)
                 body.targetProfile = params.target_profile;
             if (params.disqualification_criteria !== undefined)

package/dist/version.d.ts

@@ -1,3 +1,3 @@
 export declare const MCP_PACKAGE_NAME = "@agifyai/leadify-mcp";
 export declare const MCP_SERVER_NAME = "leadify";
-export declare const MCP_VERSION = "8.6.1";
+export declare const MCP_VERSION: string;

package/dist/version.js

@@ -1,3 +1,7 @@
+import packageJson from "../package.json" with { type: "json" };
 export const MCP_PACKAGE_NAME = "@agifyai/leadify-mcp";
 export const MCP_SERVER_NAME = "leadify";
-export const MCP_VERSION = "8.6.1";
+// publish.yml may select the next patch release immediately before building.
+// Read the package manifest so the MCP handshake always reports that same
+// published artifact version rather than a stale source constant.
+export const MCP_VERSION = packageJson.version;

package/package.json

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