@sendinel/mcp-server 1.0.56 → 1.0.57

package/build/lib/campaign-engagement.d.ts

@@ -0,0 +1,18 @@
+export type CampaignPeopleCounts = {
+    ok: true;
+    opened: Map<string, number>;
+    clicked: Map<string, number>;
+} | {
+    ok: false;
+    error: unknown;
+};
+/**
+ * Distinct recipients who opened / clicked, per campaign. `campaigns.total_opened` / `total_clicked`
+ * are event counters and can exceed total_sent (#3788). Mirrors the dashboard's
+ * `countUniqueEngagementByCampaign` (packages/dashboard/lib/campaign-step-engagement.ts): the MCP
+ * package cannot import dashboard code, so keep the two in step. A click counts as an open.
+ * One paged email_log query for the whole id set; a failed read is `{ ok: false }`, never zeros.
+ */
+export declare function countUniqueEngagementByCampaign(sb: {
+    from: (table: string) => any;
+}, projectId: string, campaignIds: string[]): Promise<CampaignPeopleCounts>;

package/build/lib/campaign-engagement.js

@@ -0,0 +1,56 @@
+import { readAllPages } from '@sendinel/domain';
+/** PostgREST caps a response at 1,000 rows, so page explicitly. */
+const PAGE_SIZE = 1000;
+/**
+ * Distinct recipients who opened / clicked, per campaign. `campaigns.total_opened` / `total_clicked`
+ * are event counters and can exceed total_sent (#3788). Mirrors the dashboard's
+ * `countUniqueEngagementByCampaign` (packages/dashboard/lib/campaign-step-engagement.ts): the MCP
+ * package cannot import dashboard code, so keep the two in step. A click counts as an open.
+ * One paged email_log query for the whole id set; a failed read is `{ ok: false }`, never zeros.
+ */
+export async function countUniqueEngagementByCampaign(sb, projectId, campaignIds) {
+    const opened = new Map();
+    const clicked = new Map();
+    if (campaignIds.length === 0)
+        return { ok: true, opened, clicked };
+    const read = await readAllPages((from, to) => sb
+        .from('email_log')
+        .select('id, campaign_id, contact_id, to_email, opened_at, clicked_at')
+        .eq('project_id', projectId)
+        .in('campaign_id', campaignIds)
+        .or('opened_at.not.is.null,clicked_at.not.is.null')
+        .order('id', { ascending: true })
+        .range(from, to), { cap: Number.MAX_SAFE_INTEGER, pageSize: PAGE_SIZE });
+    if (!read.ok)
+        return { ok: false, error: read.error };
+    const openedRecipients = new Map();
+    const clickedRecipients = new Map();
+    const add = (bucket, campaignId, recipient) => {
+        let set = bucket.get(campaignId);
+        if (!set) {
+            set = new Set();
+            bucket.set(campaignId, set);
+        }
+        set.add(recipient);
+    };
+    for (const row of read.rows) {
+        if (!row.campaign_id)
+            continue;
+        const recipient = row.contact_id
+            ? row.contact_id
+            : row.to_email
+                ? row.to_email.trim().toLowerCase()
+                : null;
+        if (!recipient)
+            continue;
+        if (row.opened_at || row.clicked_at)
+            add(openedRecipients, row.campaign_id, recipient);
+        if (row.clicked_at)
+            add(clickedRecipients, row.campaign_id, recipient);
+    }
+    for (const [id, set] of openedRecipients)
+        opened.set(id, set.size);
+    for (const [id, set] of clickedRecipients)
+        clicked.set(id, set.size);
+    return { ok: true, opened, clicked };
+}

package/build/tools/campaigns.js

@@ -24,6 +24,7 @@ import { checkCampaignContent, contactPropertyKeys, eventKeysFromHistory, conten
 import { recordBrandAssetUsage } from '../lib/brand-asset-usage.js';
 import { BLOCK_GENERATION_SCHEMA, blocksToHtml, blocksToText, normalizeComposerBlocks } from '../lib/composer-blocks.js';
 import { callSendinelV1 } from '../lib/v1-client.js';
+import { countUniqueEngagementByCampaign } from '../lib/campaign-engagement.js';
 const txt = (text) => ({ content: [{ type: 'text', text }] });
 const j = (data) => txt(JSON.stringify(data, null, 2));
 const SENT_EMAIL_STATUSES = ['sent', 'delivered', 'opened', 'clicked', 'bounced', 'complained', 'unsubscribed'];
@@ -599,7 +600,16 @@ export function registerCampaignTools(server) {
         const { data, error } = await q;
         if (error)
             return { content: [{ type: 'text', text: `Error: ${error.message}` }] };
-        return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+        // total_opened / total_clicked stay as the raw event counters (unchanged); unique_* are people
+        // counts that cannot exceed total_sent. null = the people-count lookup failed (unknown, not 0).
+        const rows = data ?? [];
+        const engagement = await countUniqueEngagementByCampaign(db(), getProjectId(), rows.map((row) => row.id));
+        const withPeople = rows.map((row) => ({
+            ...row,
+            unique_opened: engagement.ok ? engagement.opened.get(row.id) ?? 0 : null,
+            unique_clicked: engagement.ok ? engagement.clicked.get(row.id) ?? 0 : null,
+        }));
+        return { content: [{ type: 'text', text: JSON.stringify(withPeople, null, 2) }] };
     });
     server.registerTool('get_schedule', {
         title: 'Get Schedule',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sendinel/mcp-server",
-  "version": "1.0.56",
+  "version": "1.0.57",
   "description": "AI-controlled email operations control plane for campaigns, contacts, segments, analytics, and multi-provider sending via MCP.",
   "mcpName": "ai.sendinel/mcp-server",
   "type": "module",