@sendinel/mcp-server 1.0.99 → 1.0.101

package/build/tools/analytics.js

@@ -1,3 +1,4 @@
+import { readPeriodCampaigns, campaignPeriodFields } from "@sendinel/domain";
 import { isTrueConversionEvent, TRUE_CONVERSION_DEFINITION } from "@sendinel/domain";
 import { percentRate, groupMetricRows, readRevenue, isComplainedRow, isOpenedRow, countPeople, isClickedRow, summarizeEmailRows, countEmailRows, isDeliveredRow, isBouncedRow, fetchAllRows, readAllRows } from "@sendinel/domain";
 import { z } from 'zod';
@@ -851,9 +852,10 @@ export function registerAnalyticsTools(server) {
             days: z.number().int().min(1).max(365).optional().describe('Lookback period in days, default 30'),
             site_id: z.string().uuid().optional(),
             campaign_id: z.string().uuid().optional(),
+            period: z.string().min(1).optional().describe('Return one enrollment period in by_period; existing totals keep their date window.'),
             group_by: z.enum(['campaign', 'site', 'company', 'day', 'week']).optional(),
         },
-    }, async ({ days = 30, site_id, campaign_id, group_by }) => {
+    }, async ({ days = 30, site_id, campaign_id, group_by, period }) => {
         const projectId = getProjectId();
         const since = new Date(Date.now() - days * 24 * 60 * 60 * 1000).toISOString();
         let q = db()
@@ -868,20 +870,28 @@ export function registerAnalyticsTools(server) {
         const { data: logs, error } = await q;
         if (error)
             return txt(`Error: ${error.message}`);
+        let periodCampaigns;
+        try {
+            periodCampaigns = campaign_id || group_by === 'campaign' ? await readPeriodCampaigns(db(), projectId, { siteId: site_id, campaignId: campaign_id, start: since }) : new Map();
+        }
+        catch {
+            return txt("Error: Could not load results by period.");
+        }
+        const selectedFields = (id) => campaignPeriodFields(periodCampaigns.get(id)?.result, period);
         const rows = logs ?? [];
-        if (!rows.length)
+        if (!rows.length && !periodCampaigns.size)
             return j({ message: `No email activity in the last ${days} days.`, total: 0 });
         const { data: attributionRows, error: attributionError } = await readRevenue({ sb: db(), projectId, siteId: site_id, campaignId: campaign_id, start: since });
         if (attributionError)
             return txt(`Error: ${attributionError.message}`);
         const scopedAttributionRows = attributionRows ?? [];
-        const computeMetrics = (set) => {
-            const total = set.length;
-            const delivered = set.filter(isDeliveredRow).length;
-            const opened = countPeople(set, isOpenedRow);
-            const clicked = countPeople(set, isClickedRow);
-            const bounced = set.filter(isBouncedRow).length;
-            const complained = set.filter(isComplainedRow).length;
+        const computeMetrics = (set, counts) => {
+            const total = counts?.sent ?? set.length;
+            const delivered = counts?.delivered ?? set.filter(isDeliveredRow).length;
+            const opened = counts?.opened ?? countPeople(set, isOpenedRow);
+            const clicked = counts?.clicked ?? countPeople(set, isClickedRow);
+            const bounced = counts?.bounced ?? set.filter(isBouncedRow).length;
+            const complained = counts?.complained ?? set.filter(isComplainedRow).length;
             return {
                 total_sent: total, delivered, opened, clicked, bounced, complained,
                 delivery_rate: total > 0 ? `${percentRate(delivered, total, 1)?.toFixed(1)}%` : 'N/A',
@@ -892,7 +902,7 @@ export function registerAnalyticsTools(server) {
                 click_to_open: opened > 0 ? `${percentRate(clicked, opened, 1)?.toFixed(1)}%` : 'N/A',
             };
         };
-        const overall = computeMetrics(rows);
+        const overall = computeMetrics(rows, campaign_id ? periodCampaigns.get(campaign_id)?.result.totals : undefined);
         const trueConversionAnalytics = buildTrueConversionAnalytics({
             logs: rows,
             attributionRows: scopedAttributionRows,
@@ -913,9 +923,13 @@ export function registerAnalyticsTools(server) {
                     byKey[key] = [];
                 byKey[key].push(r);
             });
+            if (group_by === 'campaign')
+                for (const id of periodCampaigns.keys())
+                    byKey[id] ??= [];
             grouped = Object.entries(byKey).map(([id, set]) => ({
                 [`${group_by}_id`]: id,
-                ...computeMetrics(set),
+                ...computeMetrics(set, group_by === 'campaign' ? periodCampaigns.get(id)?.result.totals : undefined),
+                ...(group_by === 'campaign' ? selectedFields(id) : {}),
             })).sort((a, b) => b.total_sent - a.total_sent);
         }
         else if (group_by === 'company') {
@@ -987,6 +1001,7 @@ export function registerAnalyticsTools(server) {
         return j({
             period: `Last ${days} days`,
             overall,
+            ...(campaign_id ? selectedFields(campaign_id) : {}),
             true_conversion_analytics: trueConversionAnalytics,
             best_send_times_utc: bestHours,
             trend_vs_prior_period: trend,

package/build/tools/campaigns.js

@@ -1,3 +1,4 @@
+import { readCampaignPeriods, campaignPeriodFields } from "@sendinel/domain";
 import { CAMPAIGN_BRANCH_CONDITIONS, campaignBranchConditionValue, isContactPropertyConditionList, STEP_PROPERTY_CONDITIONS_ERROR, validateStepPropertyRules } from "@sendinel/domain";
 import { z } from 'zod';
 import Anthropic from '@anthropic-ai/sdk';
@@ -643,13 +644,14 @@ export function registerCampaignTools(server) {
         description: 'List campaigns, optionally filtered by site and/or status',
         inputSchema: {
             site_id: z.string().uuid().optional(),
+            period: z.string().min(1).optional().describe("Return one enrollment period in by_period; totals remain all-time."),
             status: z.enum(['draft', 'active', 'paused', 'completed', 'archived']).optional(),
             limit: z.number().int().min(1).max(100).optional().default(25),
         },
-    }, async ({ site_id, status, limit }) => {
+    }, async ({ site_id, status, limit, period }) => {
         let q = db()
             .from('campaigns')
-            .select('id, site_id, name, type, status, sends_per_hour, total_enrolled, total_sent, total_opened, total_clicked, created_at')
+            .select('id, site_id, name, type, status, sends_per_hour, total_enrolled, total_sent, total_opened, total_clicked, created_at, period_key')
             .eq('project_id', getProjectId())
             .order('created_at', { ascending: false })
             .limit(limit ?? 25);
@@ -664,10 +666,16 @@ export function registerCampaignTools(server) {
         // 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,
+        const withPeople = await Promise.all(rows.map(async (row) => {
+            const periods = await readCampaignPeriods(db(), getProjectId(), row);
+            const { period_key: _periodKey, ...legacy } = row;
+            return {
+                ...legacy,
+                ...campaignPeriodFields(periods, period),
+                ...(periods?.totals ? { total_sent: periods.totals.sent } : {}),
+                unique_opened: periods?.totals?.opened ?? (engagement.ok ? engagement.opened.get(row.id) ?? 0 : null),
+                unique_clicked: periods?.totals?.clicked ?? (engagement.ok ? engagement.clicked.get(row.id) ?? 0 : null),
+            };
         }));
         return { content: [{ type: 'text', text: JSON.stringify(withPeople, null, 2) }] };
     });
@@ -3409,8 +3417,8 @@ Return ONLY valid JSON with this exact shape:
             openWorldHint: false,
         },
         description: 'Get full details of a single campaign including all steps, current enrollment counts, and settings.',
-        inputSchema: { campaign_id: z.string().uuid() },
-    }, async ({ campaign_id }) => {
+        inputSchema: { campaign_id: z.string().uuid(), period: z.string().min(1).optional().describe("Return results for one enrollment period; totals remain all-time.") },
+    }, async ({ campaign_id, period }) => {
         const projectId = getProjectId();
         const { data: campaign, error: campErr } = await db()
             .from('campaigns')
@@ -3465,6 +3473,7 @@ Return ONLY valid JSON with this exact shape:
         const visibilityError = stepsError ?? enrollError ?? sentError ?? queuedEmailError ?? failedSendError ?? queueError ?? dlqError;
         if (visibilityError)
             return j({ error: visibilityError.message, code: 'CAMPAIGN_VISIBILITY_QUERY_FAILED' });
+        const periods = await readCampaignPeriods(db(), projectId, campaign);
         const outstandingRows = queueRows ?? [];
         const pendingOrRetryRows = outstandingRows.filter((row) => row.status !== 'processing');
         const retryingCount = outstandingRows.filter((row) => row.status === 'retry').length;
@@ -3478,7 +3487,9 @@ Return ONLY valid JSON with this exact shape:
         const unresolvedCount = dlqUnresolvedCount ?? 0;
         return j({
             ...campaign,
-            total_sent: sentCount ?? 0,
+            total_sent: periods?.totals?.sent ?? sentCount ?? 0,
+            ...(periods?.totals ? { unique_opened: periods.totals.opened, unique_clicked: periods.totals.clicked } : {}),
+            ...campaignPeriodFields(periods, period),
             steps: steps ?? [],
             active_enrollments: enrollCount ?? 0,
             send_incomplete: queuedCount > 0 || failedCount > 0 || outstandingRows.length > 0 || unresolvedCount > 0,

package/build/tools/contacts.js

@@ -1166,21 +1166,27 @@ Requirements: urgency without desperation, acknowledge the gap, one clear CTA, v
         if (!rows.length)
             return j([]);
         const companyIds = rows.map((company) => company.id);
-        const { data: subscribers, error: subscriberError } = await db()
-            .from('subscribers')
-            .select('company_id, engagement_score, total_opens, total_clicks, lifecycle_stage, last_engaged_at')
-            .eq('project_id', projectId)
-            .in('company_id', companyIds);
-        if (subscriberError)
-            return txt(`Error: ${subscriberError.message}`);
         const grouped = new Map();
-        for (const subscriber of subscribers ?? []) {
-            const companyId = typeof subscriber.company_id === 'string' ? subscriber.company_id : null;
-            if (!companyId)
-                continue;
-            const bucket = grouped.get(companyId) ?? [];
-            bucket.push(subscriber);
-            grouped.set(companyId, bucket);
+        for (let offset = 0;; offset += 1000) {
+            const { data: subscribers, error: subscriberError } = await db()
+                .from('subscribers')
+                .select('company_id, engagement_score, total_opens, total_clicks, lifecycle_stage, last_engaged_at')
+                .eq('project_id', projectId)
+                .in('company_id', companyIds)
+                .order('id')
+                .range(offset, offset + 999);
+            if (subscriberError)
+                return txt(`Error: ${subscriberError.message}`);
+            for (const subscriber of subscribers ?? []) {
+                const companyId = typeof subscriber.company_id === 'string' ? subscriber.company_id : null;
+                if (!companyId)
+                    continue;
+                const bucket = grouped.get(companyId) ?? [];
+                bucket.push(subscriber);
+                grouped.set(companyId, bucket);
+            }
+            if ((subscribers ?? []).length < 1000)
+                break;
         }
         return j(rows.map((company) => ({
             ...company,
@@ -2196,11 +2202,21 @@ Requirements: urgency without desperation, acknowledge the gap, one clear CTA, v
                 return j({ inactive_count: 0, sample: [], message: 'No subscribed contacts for this site.' });
             q = q.in('id', ids);
         }
-        const { data: suppressed } = await db()
-            .from('suppressions')
-            .select('email')
-            .eq('project_id', projectId);
-        const suppressedSet = new Set((suppressed ?? []).map((s) => s.email));
+        const suppressedSet = new Set();
+        for (let offset = 0;; offset += 1000) {
+            const { data: suppressed, error: suppressionError } = await db()
+                .from('suppressions')
+                .select('email')
+                .eq('project_id', projectId)
+                .order('email')
+                .range(offset, offset + 999);
+            if (suppressionError)
+                return txt(`Error: ${suppressionError.message}`);
+            for (const suppression of suppressed ?? [])
+                suppressedSet.add(suppression.email);
+            if ((suppressed ?? []).length < 1000)
+                break;
+        }
         const { data: contacts, error } = await q.order('engagement_score', { ascending: true }).limit(sampleLimit);
         if (error)
             return txt(`Error: ${error.message}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sendinel/mcp-server",
-  "version": "1.0.99",
+  "version": "1.0.101",
   "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",