@sendinel/mcp-server 1.0.100 → 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/package.json

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