@agifyai/leadify-mcp 8.1.1 → 8.3.0

package/README.md

@@ -203,6 +203,7 @@ Conséquences pratiques :
 | `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. |
+| `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. |
 | `update_company_brain_sections` | Modifier uniquement les sections indiquées du Company Brain : le MCP relit le brouillon ou la dernière publication, fusionne les sections ciblées, puis sauvegarde avec révision attendue et clé d'idempotence. |
 | `update_gtm_playbook_sections` | Modifier uniquement les sections indiquées du GTM Playbook, avec la même lecture-fusion-révision atomiquement contrôlée. |

package/dist/server.js

@@ -13,14 +13,16 @@ import { registerOrganizationTools } from "./tools/organizations.js";
 import { registerPipelineTools } from "./tools/pipeline.js";
 import { registerFineTuningTools } from "./tools/fine_tuning.js";
 import { registerContextWorkspaceTools } from "./tools/context_workspace.js";
+import { registerLeadViewTools } from "./tools/views.js";
 export function createServer() {
     const server = new McpServer({
         name: "leadify",
-        version: "8.1.1",
+        version: "8.3.0",
     });
     registerAuthTools(server);
     registerOrganizationTools(server);
     registerLeadGroupTools(server);
+    registerLeadViewTools(server);
     registerLeadTools(server);
     registerSchemaTools(server);
     registerLogTools(server);

package/dist/tools/context_workspace.d.ts

@@ -4,6 +4,9 @@ export interface ContextWorkspaceClient {
     put(path: string, body: unknown): Promise<unknown>;
     post(path: string, body: unknown): Promise<unknown>;
 }
+export interface ContextPackClient {
+    post(path: string, body: unknown): Promise<unknown>;
+}
 /** Bounded projection for agents: the active draft and latest published version only. */
 export declare function projectContextWorkspaceRead(data: unknown): Record<string, unknown>;
 export declare function registerContextWorkspaceTools(server: McpServer, client?: ContextWorkspaceClient): void;

package/dist/tools/context_workspace.js

@@ -102,6 +102,37 @@ async function updateSections(client, input) {
     });
 }
 export function registerContextWorkspaceTools(server, client = getClient()) {
+    server.registerTool("compile_context_pack", {
+        title: "Compile the canonical Context Pack",
+        description: "Compile the canonical, tenant-scoped Context Pack for one explicitly selected target. Use `target_kind` + `target_id` for organization, " +
+            "lead group, campaign, account, or person; use lead + campaign only for the WRITE_OUTREACH pack. This is read-only and never uses Data Room.",
+        inputSchema: {
+            organization_id: z.string().trim().min(1).describe("Organization explicitly selected through discover_leadify_context."),
+            target_kind: z.enum(["organization", "lead_group", "campaign", "account", "person"]).optional().describe("Direct canonical target; never causes an implicit lead/campaign selection."),
+            target_id: z.string().trim().min(1).optional().describe("Required for every target except organization."),
+            lead_id: z.string().trim().min(1).optional().describe("Lead targeted by a WRITE_OUTREACH pack; requires campaign_id."),
+            campaign_id: z.string().trim().min(1).optional().describe("Campaign targeted by a WRITE_OUTREACH pack; requires lead_id."),
+            max_evidence_age_ms: z.number().int().positive().max(90 * 24 * 60 * 60 * 1000).optional().describe("Optional freshness limit; defaults to 30 days and never exceeds 90 days."),
+        },
+        annotations: { readOnlyHint: true },
+    }, async ({ organization_id, target_kind, target_id, lead_id, campaign_id, max_evidence_age_ms }) => {
+        try {
+            if (target_kind) {
+                if (target_kind !== "organization" && !target_id)
+                    return toolResult({ error: "target_id is required for this target_kind" });
+                return toolResult(await client.post("/api/context-pack/target", { organizationId: organization_id, target: { kind: target_kind, ...(target_id ? { id: target_id } : {}) } }));
+            }
+            if (!lead_id || !campaign_id)
+                return toolResult({ error: "Provide target_kind (and target_id when needed), or both lead_id and campaign_id." });
+            const body = { organizationId: organization_id, leadId: lead_id, campaignId: campaign_id };
+            if (max_evidence_age_ms !== undefined)
+                body.maxEvidenceAgeMs = max_evidence_age_ms;
+            return toolResult(await client.post("/api/context-pack/compile", body));
+        }
+        catch (error) {
+            return handleToolError(error);
+        }
+    });
     server.registerTool("get_context_workspace", {
         title: "Read canonical versioned Context Workspace",
         description: "Read the canonical Leadify Context Workspace for one explicitly selected organization and kind. " +

package/dist/tools/views.d.ts

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

package/dist/tools/views.js

@@ -0,0 +1,56 @@
+import { z } from "zod";
+import { getClient } from "../client.js";
+import { handleToolError, toolResult } from "../types.js";
+const filterSchema = z.object({
+    field: z.string().describe("A standard, virtual, or selected lead-group schema field."),
+    operator: z.enum(["equals", "contains", "gte", "lte", "not_equals", "not_contains", "is_true", "is_false", "is_null", "is_not_null", "activity_days_ago", "activity_count_equals", "activity_count_gte", "activity_count_lte", "bbox"]),
+    value: z.unknown().optional(),
+});
+const viewConfigSchema = {
+    organization_id: z.string().describe("Organization that owns the explicitly selected lead group."),
+    lead_group_id: z.string().describe("Lead group ID. The view is shared with this group's organization."),
+    name: z.string().min(1),
+    filters: z.array(filterSchema),
+    columns: z.array(z.string()).optional(),
+    sort: z.object({ field: z.string(), direction: z.enum(["asc", "desc"]) }).optional(),
+    pagination: z.object({ page: z.number().int().min(1), limit: z.number().int().min(1).max(1000) }).optional(),
+};
+export function registerLeadViewTools(server) {
+    server.tool("list_lead_views", "List the virtual read-only default view and every saved view shared by the selected lead group's organization. Use get_lead_view for one full configuration.", { organization_id: z.string(), lead_group_id: z.string() }, async ({ organization_id, lead_group_id }) => {
+        try {
+            const data = await getClient().get(`/api/lead-group/${encodeURIComponent(lead_group_id)}/views`);
+            const result = data;
+            return toolResult({ ...result, organizationId: organization_id });
+        }
+        catch (error) {
+            return handleToolError(error);
+        }
+    });
+    server.tool("get_lead_view", "Read one selected saved view, or the read-only virtual view ID `default`, after selecting its organization and lead group.", { organization_id: z.string(), lead_group_id: z.string(), view_id: z.string() }, async ({ organization_id, lead_group_id, view_id }) => {
+        try {
+            const data = await getClient().get(`/api/lead-group/${encodeURIComponent(lead_group_id)}/views/${encodeURIComponent(view_id)}`);
+            return toolResult({ ...data, organizationId: organization_id });
+        }
+        catch (error) {
+            return handleToolError(error);
+        }
+    });
+    server.tool("preview_lead_view", "Validate a proposed organization-shared lead view without writing it. Use this before create_lead_view; no data or preference is changed.", viewConfigSchema, async ({ organization_id, lead_group_id, name, filters, columns, sort, pagination }) => {
+        try {
+            const data = await getClient().post(`/api/lead-group/${encodeURIComponent(lead_group_id)}/views/preview`, { organizationId: organization_id, name, filters, columns, sort, pagination });
+            return toolResult(data);
+        }
+        catch (error) {
+            return handleToolError(error);
+        }
+    });
+    server.tool("create_lead_view", "Create an organization-shared saved view after previewing it. Idempotency key is required: retry the same request with the same key; changing the payload with that key conflicts. Update and delete are intentionally unavailable.", { ...viewConfigSchema, idempotency_key: z.string().min(8).max(200) }, async ({ organization_id, lead_group_id, name, filters, columns, sort, pagination, idempotency_key }) => {
+        try {
+            const data = await getClient().post(`/api/lead-group/${encodeURIComponent(lead_group_id)}/views`, { organizationId: organization_id, name, filters, columns, sort, pagination, idempotencyKey: idempotency_key });
+            return toolResult(data);
+        }
+        catch (error) {
+            return handleToolError(error);
+        }
+    });
+}

package/package.json

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