@agifyai/leadify-mcp 8.5.1 → 8.5.3

package/README.md

@@ -102,6 +102,14 @@ Mode watch :
 npm run dev
 ```
 
+Canari de vérité commerciale en lecture seule :
+
+```bash
+LEADIFY_CANARY_ORGANIZATION_ID=org-id npm run canary:commercial
+```
+
+Le canari sélectionne une organisation et un groupe accessibles, relit la même source deux fois, ne publie aucun message et n'ajoute aucune activité. Les variables `LEADIFY_CANARY_LEAD_GROUP_ID`, `LEADIFY_CANARY_EMAIL`, `LEADIFY_CANARY_LINKEDIN_URL` et `LEADIFY_CANARY_LEAD_ID` permettent de fixer une cible déjà autorisée ; la clé et le contenu des conversations ne sont jamais affichés.
+
 ### Architecture
 
 ```
@@ -211,7 +219,8 @@ Leadify et ne doit jamais être envoyée par un agent MCP.
 | `get_campaign_logs` | Récupérer les logs de campagne avec filtres et pagination. |
 | `delete_campaign_log` | Supprimer une entrée de log de campagne. |
 | `update_campaign_stats` | Mettre à jour les statistiques d'email d'une campagne pour un groupe de leads. |
-| `create_campaign` | Créer une nouvelle campagne rattachée à un groupe de leads (statut DRAFT). |
+| `create_campaign` | Créer une campagne DRAFT mono-canal rattachée à un groupe de leads. `channel` (`LINKEDIN` ou `EMAIL`) est obligatoire ; `start_at`, `end_at` et `timezone` configurent la fenêtre métier. À `end_at`, Leadify ferme la campagne idempotemment, annule uniquement les jobs prouvablement pré-fournisseur et préserve les autres pour réconciliation. |
+| `update_campaign_configuration` | Corriger le canal ou la fenêtre d'une campagne DRAFT encore ouverte, sans activation ni enrôlement. |
 | `list_campaigns` | Lister compactement les campagnes d'une organisation explicitement sélectionnée et leur statut courant. |
 | `get_campaign` | Récupérer les détails d'une campagne et ses KPIs temps réel. |
 | `update_campaign_status` | Changer le statut d'une campagne (DRAFT, ACTIVE, PAUSED, COMPLETED). |
@@ -221,6 +230,12 @@ Leadify et ne doit jamais être envoyée par un agent MCP.
 | `signal_disable` | Désactiver un signal (faux positif / écarté manuellement). Flip de `state` uniquement. |
 | `signal_delete` | Supprimer définitivement un signal (cas rare : donnée erronée, doublon). |
 | `add_activity` | Journaliser une interaction prospect (LinkedIn, email, call) dans le feed du lead. |
+| `crm_lookup_person` | Lire la personne, les deals et le stage CRM d'une cible explicite, sans écrire dans le CRM. |
+| `email_read_thread` | Lire un thread email borné et ses réponses, exclusions de délivrabilité et ambiguïtés. |
+| `linkedin_read_conversation` | Lire la conversation LinkedIn bornée d'un profil explicitement sélectionné. |
+| `unipile_read_messages` | Lire les messages LinkedIn Unipile bornés d'un profil explicitement sélectionné. |
+| `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. N’utilise jamais la Data Room legacy ni ne choisit de cible implicite. |
 | `get_context_workspace` | Lire le Context Workspace canonique versionné (`company_brain` ou `gtm_playbook`) d'une organisation explicitement sélectionnée. Retourne le brouillon et la dernière version publiée. |
 | `list_canonical_relationships` | Lire les liens canoniques typés d'une organisation, dans les deux directions. |

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 { registerCommercialTruthTools } from "./tools/commercial_truth.js";
 import { MCP_SERVER_NAME, MCP_VERSION } from "./version.js";
 export function createServer() {
     const server = new McpServer({
@@ -27,6 +28,7 @@ export function createServer() {
     registerLeadViewTools(server);
     registerLeadTools(server);
     registerRelationshipTools(server);
+    registerCommercialTruthTools(server);
     registerSchemaTools(server);
     registerLogTools(server);
     registerCampaignTools(server);

package/dist/tools/campaigns.d.ts

@@ -1,5 +1,7 @@
 import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { type LeadifyClient } from "../client.js";
 type CampaignReadClient = Pick<LeadifyClient, "get">;
-export declare function registerCampaignTools(server: McpServer, readClient?: CampaignReadClient): void;
+type CampaignWriteClient = Pick<LeadifyClient, "post">;
+type CampaignMutationClient = Pick<LeadifyClient, "put">;
+export declare function registerCampaignTools(server: McpServer, readClient?: CampaignReadClient, writeClient?: CampaignWriteClient, mutationClient?: CampaignMutationClient): void;
 export {};

package/dist/tools/campaigns.js

@@ -19,7 +19,7 @@ function assertCampaignBelongsToOrganization(data, organizationId) {
     }
     return campaign;
 }
-export function registerCampaignTools(server, readClient) {
+export function registerCampaignTools(server, readClient, writeClient, mutationClient) {
     // ── update_campaign_stats ──────────────────────────────────────────────
     server.tool("update_campaign_stats", "Update email campaign statistics for a lead group. If the given campaignSlug " +
         "doesn't exist in the group's stats yet, it is created; otherwise provided fields " +
@@ -88,33 +88,67 @@ export function registerCampaignTools(server, readClient) {
         }
     });
     // ── create_campaign ────────────────────────────────────────────────────
-    server.tool("create_campaign", "Create a new campaign linked to an existing lead group. The campaign is initialized " +
-        "in DRAFT status and can be configured with a persona. Returns the new campaign ID. " +
-        "Use update_campaign_status afterwards to move it to ACTIVE when ready.", {
+    server.tool("create_campaign", "Create a mono-channel DRAFT campaign with an explicit channel, optional ISO-8601 start/end " +
+        "window, and IANA timezone. At endAt Leadify closes the campaign idempotently, cancels only " +
+        "pre-provider jobs, and preserves any provider-barrier job for reconciliation.", {
         name: z.string().describe("Campaign name."),
         lead_group_id: z.string().describe("ID of the lead group to associate."),
+        channel: z.enum(["LINKEDIN", "EMAIL"]).describe("Required effective delivery channel. Create separate campaigns for LinkedIn and email."),
+        start_at: z.string().datetime().optional().describe("Optional inclusive campaign start timestamp in ISO-8601 UTC."),
+        end_at: z.string().datetime().optional().describe("Optional exclusive campaign end timestamp in ISO-8601 UTC; must be after start_at."),
+        timezone: z.string().min(1).optional().describe("IANA timezone used for the campaign business window, for example Europe/Paris."),
         description: z.string().optional().describe("Optional description."),
         persona_id: z
             .string()
             .optional()
             .describe("ID of the persona to assign (optional)."),
-    }, async ({ name, lead_group_id, description, persona_id }) => {
+    }, async ({ name, lead_group_id, channel, start_at, end_at, timezone, description, persona_id }) => {
         try {
             const body = {
                 name,
                 leadGroupId: lead_group_id,
+                channel,
             };
+            if (start_at !== undefined)
+                body.startAt = start_at;
+            if (end_at !== undefined)
+                body.endAt = end_at;
+            if (timezone !== undefined)
+                body.timezone = timezone;
             if (description !== undefined)
                 body.description = description;
             if (persona_id !== undefined)
                 body.personaId = persona_id;
-            const data = await getClient().post("/api/campaign", body);
+            const data = await (writeClient ?? getClient()).post("/api/campaign", body);
             return toolResult(data);
         }
         catch (error) {
             return handleToolError(error);
         }
     });
+    server.tool("update_campaign_configuration", "Correct an open DRAFT campaign's channel or lifecycle window before activation. This tool refuses ACTIVE, PAUSED, COMPLETED, or closed campaigns and never activates or enrolls prospects.", {
+        id: z.string().describe("Campaign ID."),
+        channel: z.enum(["LINKEDIN", "EMAIL"]).optional(),
+        start_at: z.string().datetime().nullable().optional(),
+        end_at: z.string().datetime().nullable().optional(),
+        timezone: z.string().min(1).optional(),
+    }, async ({ id, channel, start_at, end_at, timezone }) => {
+        try {
+            const body = {};
+            if (channel !== undefined)
+                body.channel = channel;
+            if (start_at !== undefined)
+                body.startAt = start_at;
+            if (end_at !== undefined)
+                body.endAt = end_at;
+            if (timezone !== undefined)
+                body.timezone = timezone;
+            return toolResult(await (mutationClient ?? getClient()).put(`/api/campaign/${encodeURIComponent(id)}/configuration`, body));
+        }
+        catch (error) {
+            return handleToolError(error);
+        }
+    });
     // ── get_campaign ───────────────────────────────────────────────────────
     server.tool("get_campaign", "Retrieve a campaign chosen from list_campaigns, scoped to the explicitly selected " +
         "organization. Includes its normalized current status (DRAFT, ACTIVE, PAUSED, or COMPLETED) " +

package/dist/tools/commercial_truth.d.ts

@@ -0,0 +1,48 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { type LeadifyClient } from "../client.js";
+type CommercialReadClient = Pick<LeadifyClient, "get">;
+type RecordValue = Record<string, unknown>;
+export type CommercialSource = "crm" | "email" | "linkedin" | "unipile" | "leadify_activity";
+export type CommercialDirection = "inbound" | "outbound" | "system" | "mixed" | "unknown";
+export type CommercialStatus = "client" | "prospect" | "in_crm" | "not_in_crm" | "replied" | "contacted" | "excluded" | "audit_only" | "no_observed_activity" | "no_action" | "review_required" | "handoff_required" | "unknown";
+export interface CommercialFreshness {
+    observedAt: string | null;
+    state: "fresh" | "stale" | "unknown";
+    ageMs?: number;
+}
+export interface CommercialProjection {
+    source: CommercialSource | "reconciled";
+    date: string | null;
+    direction: CommercialDirection;
+    status: CommercialStatus;
+    optOut: boolean;
+    bounce: boolean;
+    suppression: boolean;
+    handoff: boolean;
+    freshness: CommercialFreshness;
+    ambiguities: string[];
+}
+export interface CommercialSourceSnapshot {
+    source: CommercialSource;
+    configured: boolean;
+    projection: CommercialProjection;
+    pagination: RecordValue;
+    evidence: RecordValue;
+    payload: RecordValue;
+}
+export interface CommercialReconciliation {
+    status: CommercialStatus;
+    recommendedAction: string;
+    responded: boolean;
+    inCrm: boolean;
+    crmStage: "client" | "prospect" | "none" | "unknown";
+    optOut: boolean;
+    bounce: boolean;
+    suppression: boolean;
+    handoff: boolean;
+    freshness: CommercialFreshness;
+    ambiguities: string[];
+}
+export declare function reconcileCommercialSources(sources: CommercialSourceSnapshot[]): CommercialReconciliation;
+export declare function registerCommercialTruthTools(server: McpServer, client?: CommercialReadClient): void;
+export {};