@agifyai/leadify-mcp 9.12.0 → 9.13.0

package/README.md

@@ -276,6 +276,7 @@ Leadify et ne doit jamais être envoyée par un agent MCP.
 | `get_capture_coverage` | Boîtes mail et comptes LinkedIn réellement captés, avec leur état. |
 | `get_follow_up_cadence` | Rythme de relance de l'organisation (lecture seule). |
 | `get_prospect_approach` | Avant d'écrire à une personne : son Approche (quotidien, problématique, ce qu'elle veut, ce qu'on lui apporte). |
+| `list_outreach_review_queue` | La file « À valider » de Leadify (page `/to-review`) en un appel, en lecture seule : filtres campagne, canal, type de message et état (`TO_REVIEW` par défaut), `total`, `counts`, `truncated`. Le texte des messages seulement avec `include_text`. |
 | `preview_move_leads` | Essai à blanc du déplacement de fiches vers un autre groupe de la même organisation : sélection par identifiants, vue ou filtre (500 fiches au plus par appel, lots ensuite), refus par fiche avec motif, doublons dans le groupe cible, champs de schéma et relations à ajouter, blocages et empreinte du plan. |
 | `move_leads` | Appliquer un déplacement prévisualisé ; exige l'empreinte de la prévisualisation et une clé d'idempotence. La fiche garde son identifiant et tout son historique ; jamais de fusion. |
 | `undo_move_leads` / `get_lead_move` | Annuler ou relire une opération de déplacement par son identifiant. |
@@ -495,6 +496,24 @@ plus long se termine par `… [truncated: N characters in total]`. `list_follow_
 accepte `include_text` pour ajouter le message entier (`lastMessage.text`) à côté
 de son extrait de 500 caractères.
 
+### File « À valider » (PRD-2815)
+
+`list_outreach_review_queue` lit en un appel la file de la page `/to-review` :
+les messages de campagne qui attendent une décision humaine, dans l'ordre de la
+page, au plus 500, sans pagination. Filtres : `campaign_id`, `channel` (`EMAIL`,
+`LINKEDIN`), `message_type_id` et `state` (`TO_REVIEW` par défaut, `VALIDATED`,
+`CORRECTED`, `REFUSED`, ou `ALL`). Les identifiants des filtres viennent de
+`filters.campaigns` et `filters.messageTypes`. Chaque message garde l'essentiel
+(prospect, entreprise, campagne, canal, étape, type, départ prévu, créneau
+manqué, statut, objet) ; la révision, la date de création et les identifiants de
+campagne et de type, déjà dans `filters`, sont retirés. Sans le texte des
+messages, la file réelle de 73 messages tient en environ 30 000 caractères, sous
+la limite de 50 000 d'Hermès ; `include_text: true` ajoute `body`, le message
+entier (environ 500 caractères de plus par message) : au-delà d'une quarantaine
+de messages, filtrer d'abord. Si `truncated` vaut `true`, filtrer par campagne.
+Aucun outil ne valide, corrige ou refuse : cela reste humain. Route :
+`GET /api/outreach-review/queue` (permission `read`).
+
 ### Déplacer des prospects vers un autre groupe (PRD-2478)
 
 Pour réorganiser une base, **déplacer** les fiches plutôt que les copier

package/dist/server.js

@@ -2,6 +2,7 @@ import { registerAgentOutreachTools } from "./tools/agent_outreach.js";
 import { registerQualificationRunTools } from "./tools/qualification_runs.js";
 import { registerOutreachExclusionTools } from "./tools/outreach_exclusion.js";
 import { registerProspectionTrackingTools } from "./tools/prospection_tracking.js";
+import { registerOutreachReviewTools } from "./tools/outreach_review.js";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { registerAuthTools } from "./tools/auth.js";
 import { registerLeadTools } from "./tools/leads.js";
@@ -63,5 +64,6 @@ export function createServer() {
     registerQualificationRunTools(server);
     registerOutreachExclusionTools(server);
     registerProspectionTrackingTools(server);
+    registerOutreachReviewTools(server);
     return server;
 }

package/dist/tools/outreach_review.d.ts

@@ -0,0 +1,14 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { type LeadifyClient } from "../client.js";
+export declare const OUTREACH_REVIEW_TOOL_NAMES: readonly ["list_outreach_review_queue"];
+export declare const OUTREACH_REVIEW_STATES: readonly ["ALL", "TO_REVIEW", "VALIDATED", "CORRECTED", "REFUSED"];
+export declare const OUTREACH_REVIEW_CHANNELS: readonly ["EMAIL", "LINKEDIN"];
+type Client = Pick<LeadifyClient, "get">;
+/**
+ * One queue item without what only a write would need (revision, createdAt) and
+ * without the campaign and message type ids, which filters.campaigns and
+ * filters.messageTypes carry once. The body only with include_text.
+ */
+export declare function projectReviewItem(item: unknown, includeText: boolean): Record<string, unknown>;
+export declare function registerOutreachReviewTools(server: McpServer, client?: Client): void;
+export {};

package/dist/tools/outreach_review.js

@@ -0,0 +1,62 @@
+import { z } from "zod";
+import { getClient } from "../client.js";
+import { handleToolError } from "../types.js";
+// PRD-2815 — la file « À valider » de Leadify (page /to-review) en lecture seule,
+// par la route serveur GET /api/outreach-review/queue. Valider, corriger ou
+// refuser reste humain : aucune écriture ici.
+export const OUTREACH_REVIEW_TOOL_NAMES = ["list_outreach_review_queue"];
+export const OUTREACH_REVIEW_STATES = ["ALL", "TO_REVIEW", "VALIDATED", "CORRECTED", "REFUSED"];
+export const OUTREACH_REVIEW_CHANNELS = ["EMAIL", "LINKEDIN"];
+const id = z.string().trim().min(1).max(200);
+const READ_ONLY = { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true };
+const object = (v) => v && typeof v === "object" && !Array.isArray(v) ? v : {};
+/** One line of JSON: an agent runtime sets aside tool results above 50,000 characters. */
+const compact = (data) => ({ content: [{ type: "text", text: JSON.stringify(data) }] });
+/**
+ * One queue item without what only a write would need (revision, createdAt) and
+ * without the campaign and message type ids, which filters.campaigns and
+ * filters.messageTypes carry once. The body only with include_text.
+ */
+export function projectReviewItem(item, includeText) {
+    const i = object(item);
+    const result = {
+        id: i.id, leadId: i.leadId, leadName: i.leadName, companyName: i.companyName, campaignName: i.campaignName,
+        channel: i.channel, step: i.step, stepKind: i.stepKind, messageTypeName: object(i.messageType).name ?? null,
+        plannedDepartureAt: i.plannedDepartureAt, missedSlot: i.missedSlot, status: i.status, editedByHuman: i.editedByHuman,
+        subject: i.subject,
+    };
+    if (includeText)
+        result.body = i.body;
+    return result;
+}
+export function registerOutreachReviewTools(server, client = getClient()) {
+    server.tool("list_outreach_review_queue", "The Leadify 'À valider' queue (page /to-review) in ONE call: the campaign messages waiting for a human decision, in " +
+        "the page's order. Read-only: validating, correcting or refusing a message stays human, in Leadify. Answer: " +
+        "{organizationId, state, limit, total, counts {all, toReview, validated, corrected, refused}, truncated, items, " +
+        "filters {campaigns [{id, name}], messageTypes [{id, name}]}, notContactedToday {count, reasons}}. Each item: id, " +
+        "leadId, leadName, companyName, campaignName, channel, step, stepKind, messageTypeName, plannedDepartureAt, " +
+        "missedSlot, status (TO_REVIEW, APPROVED, SCHEDULED, SENT, REJECTED), editedByHuman, subject. To stay well under " +
+        "50,000 characters, the message text is left out by default (about 30,000 characters for 73 messages); " +
+        "include_text=true adds body, the whole message, about 500 characters more per message (about 68,000 for those 73): " +
+        "above about 40 messages, narrow with campaign_id, channel or message_type_id first. At most 500 messages, no pagination: when truncated " +
+        "is true, filter by campaign_id. Pass the ids found in filters.campaigns and filters.messageTypes.", {
+        organization_id: id.describe("Organization to read. Must be in the API key's scope."),
+        state: z.enum(OUTREACH_REVIEW_STATES).optional().describe("TO_REVIEW (default): waiting for validation. VALIDATED, CORRECTED, REFUSED: decided in the last 7 days. ALL: TO_REVIEW plus the messages validated, scheduled, sent or refused in the last 7 days."),
+        campaign_id: id.optional().describe("Only this campaign (filters.campaigns[].id)."),
+        channel: z.enum(OUTREACH_REVIEW_CHANNELS).optional().describe("EMAIL or LINKEDIN."),
+        message_type_id: id.optional().describe("Only this message type (filters.messageTypes[].id)."),
+        include_text: z.boolean().optional().describe("Also return body, the whole message text. Off by default."),
+    }, READ_ONLY, (async ({ organization_id, state, campaign_id, channel, message_type_id, include_text }) => {
+        try {
+            const query = new URLSearchParams(Object.entries({ organizationId: organization_id, campaignId: campaign_id, channel, messageTypeId: message_type_id, state: state ?? "TO_REVIEW" })
+                .filter((entry) => entry[1] !== undefined));
+            const { items, ...rest } = object(await client.get("/api/outreach-review/queue", query));
+            const { organizationId, state: readState, limit, total, counts, truncated, ...others } = rest;
+            return compact({ organizationId, state: readState, limit, total, counts, truncated,
+                items: Array.isArray(items) ? items.map(item => projectReviewItem(item, include_text === true)) : items, ...others });
+        }
+        catch (error) {
+            return handleToolError(error);
+        }
+    }));
+}

package/package.json

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