@agifyai/leadify-mcp 8.5.0 → 8.5.2

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,7 @@ 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 : aucun défaut LinkedIn implicite. La fenêtre de campagne (`startAt`/`endAt`) et le contrat de clôture ne sont pas encore supportés par l'API Leadify ; ne pas utiliser cet outil pour une campagne bornée dans le temps avant cette livraison. |
 | `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 +229,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. |
@@ -259,4 +273,5 @@ Leadify et ne doit jamais être envoyée par un agent MCP.
 | `set_outreach_connection_request` | Toggle du flag connectionRequestEnabled (LinkedIn invite vs cold DM). |
 | `trigger_outreach` | Générer un message d'outreach via l'agent Trigger.dev (dry-run par défaut). `force=true` pour re-générer sur un lead déjà traité. |
 | `append_fine_tuning` | Appendre du contenu à une section du Fine Tuning (nonNegotiableRules, pitfalls, structure, examples). Toujours en mode append — garantie contractuelle. |
+| `set_fine_tuning_output_config` | Remplacer uniquement la configuration métier de sorties d’un Fine Tuning (`linkedinConnection`, `linkedinMessage`, `email`, activations et quantités). Préserve Markdown, langues et fallback ; ne génère, ne planifie, n’active ni n’envoie aucun outreach. |
 | `pipeline_next_lead` | Sélectionner le prochain lead à traiter (score descendant, sans message). Exclusion des IDs déjà vus, limit 1-5. |

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,6 @@
 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">;
+export declare function registerCampaignTools(server: McpServer, readClient?: CampaignReadClient, writeClient?: CampaignWriteClient): 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) {
     // ── 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,27 +88,31 @@ 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 linked to an existing lead group. channel is required " +
+        "so no campaign silently defaults to LinkedIn. The current Leadify API does not yet persist " +
+        "a campaign start/end window or closure contract: do not use this tool for a time-bounded " +
+        "campaign until that API support is released. Returns the new campaign ID; use " +
+        "update_campaign_status only after the campaign is fully configured and explicitly approved.", {
         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."),
         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, description, persona_id }) => {
         try {
             const body = {
                 name,
                 leadGroupId: lead_group_id,
+                channel,
             };
             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) {

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 {};