@sendinel/mcp-server 1.0.184 → 1.0.185

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

@@ -0,0 +1,6 @@
+/** Stored campaign rates are measurements only when an importer supplied their source. */
+export declare function campaignMetricsView<T extends Record<string, unknown>>(campaign: T): T & {
+    open_rate: unknown;
+    click_rate: unknown;
+    unsubscribe_rate: unknown;
+};

package/build/lib/campaign-metrics.js

@@ -0,0 +1,9 @@
+/** Stored campaign rates are measurements only when an importer supplied their source. */
+export function campaignMetricsView(campaign) {
+    return {
+        ...campaign,
+        open_rate: campaign.metrics_source == null ? null : campaign.open_rate,
+        click_rate: campaign.metrics_source == null ? null : campaign.click_rate,
+        unsubscribe_rate: campaign.metrics_source == null ? null : campaign.unsubscribe_rate,
+    };
+}

package/build/tools/campaigns.js

@@ -1,3 +1,4 @@
+import { campaignMetricsView } from '../lib/campaign-metrics.js';
 import { withCreatedItems } from '../lib/mcp-created-items.js';
 import { validateStepMultiEventRules, stepMultiEventRulesView, validateStepAbsenceRule, stepAbsenceRuleView } from "@sendinel/domain";
 import { readCampaignMetricGroups, SENT_STATUSES } from "@sendinel/domain";
@@ -799,7 +800,7 @@ export function registerCampaignTools(server) {
     }, 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, period_key, segment_id, trigger_type, trigger_event_name, trigger_tag, trigger_config, send_class, unsub_footer_template, requires_approval, approved_by, approved_at, send_at')
+            .select('id, site_id, name, type, status, sends_per_hour, total_enrolled, total_sent, total_opened, total_clicked, open_rate, click_rate, unsubscribe_rate, metrics_source, created_at, period_key, segment_id, trigger_type, trigger_event_name, trigger_tag, trigger_config, send_class, unsub_footer_template, requires_approval, approved_by, approved_at, send_at')
             .eq('project_id', getProjectId())
             .order('created_at', { ascending: false })
             .limit(limit ?? 25);
@@ -818,7 +819,7 @@ export function registerCampaignTools(server) {
         const withPeople = await Promise.all(rows.map(async (row) => {
             const periods = await readCampaignPeriods(db(), getProjectId(), row);
             return {
-                ...row,
+                ...campaignMetricsView(row),
                 reentry_mode: row.period_key ? "per_event_period" : "once_ever",
                 requires_approval_description: ACTIVATION_APPROVAL_DESCRIPTION,
                 ...buildCampaignTriggerOutput(row, seenEvents),
@@ -938,7 +939,7 @@ export function registerCampaignTools(server) {
         if (error)
             return { content: [{ type: 'text', text: `Error: ${dbToolError(error).error}` }] };
         const warnings = await campaignTimezoneWarnings(data);
-        return { content: [{ type: 'text', text: JSON.stringify({ ...data, requires_approval_description: ACTIVATION_APPROVAL_DESCRIPTION, fires_on: buildCampaignFiresOn(data), trigger_diagnostics: buildCampaignTriggerDiagnostics(data), ...(warnings.length ? { warnings } : {}) }, null, 2) }] };
+        return { content: [{ type: 'text', text: JSON.stringify({ ...campaignMetricsView(data), requires_approval_description: ACTIVATION_APPROVAL_DESCRIPTION, fires_on: buildCampaignFiresOn(data), trigger_diagnostics: buildCampaignTriggerDiagnostics(data), ...(warnings.length ? { warnings } : {}) }, null, 2) }] };
     });
     const propertyConditions = z.array(z.union([
         z.object({ key: z.string(), op: z.enum(['eq', 'neq']), value: z.string() }).strict(),
@@ -1142,7 +1143,7 @@ export function registerCampaignTools(server) {
                 status,
             }).catch(() => { });
         }
-        return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+        return { content: [{ type: 'text', text: JSON.stringify(campaignMetricsView(data), null, 2) }] };
     });
     server.registerTool('enroll_contact', {
         title: 'Enroll Contact',
@@ -1930,7 +1931,7 @@ export function registerCampaignTools(server) {
             details: { template_id, template_slug: template.slug, source: 'mcp' },
         }).catch(() => { });
         return j({
-            ...campaign,
+            ...campaignMetricsView(campaign),
             steps_copied: steps.length,
             cloned_from_template_id: template_id,
             message: `Created draft campaign "${cloneName}" from template "${template.name}" (${steps.length} step(s) copied). It is a DRAFT — not active, and no contacts are enrolled.`,
@@ -3438,8 +3439,10 @@ Return ONLY valid JSON with this exact shape:
             }).catch(() => { }); // fire-and-forget
         }
         await logAudit({ action: 'campaign.created', resourceType: 'campaign', resourceId: campaign.id, details: { type: campaignType, ...targeting, activated: willActivate } });
+        const { open_rate, click_rate, unsubscribe_rate } = campaignMetricsView(campaign);
         return j({
             campaign_id: campaign.id,
+            open_rate, click_rate, unsubscribe_rate,
             name,
             type: campaignType,
             send_class: campaign.send_class,
@@ -3668,7 +3671,7 @@ Return ONLY valid JSON with this exact shape:
     }, async ({ approval_id, ...args }) => {
         if (approval_id) {
             const result = await resumeCampaignEdit('set_campaign_trigger', approval_id, args);
-            return j(result.error ? result : { ...result, ...await campaignTriggerOutput(result) });
+            return j(result.error ? result : { ...campaignMetricsView(result), ...await campaignTriggerOutput(result) });
         }
         if (!args.campaign_id)
             return j({ error: 'campaign_id is required', code: 'validation_failed' });
@@ -3708,7 +3711,7 @@ Return ONLY valid JSON with this exact shape:
         if (reentry.period_key !== undefined)
             updates.period_key = reentry.period_key;
         const result = await finishCampaignEdit('set_campaign_trigger', args, existing, updates, params => requestApproval('set_campaign_trigger', params));
-        return j(result.error || result.requires_approval ? result : { ...result, ...await campaignTriggerOutput(result) });
+        return j(result.error || result.requires_approval ? result : { ...campaignMetricsView(result), ...await campaignTriggerOutput(result) });
     });
     server.registerTool('update_campaign', {
         title: 'Update Campaign',
@@ -3744,7 +3747,7 @@ Return ONLY valid JSON with this exact shape:
             if (result.error)
                 return j(result);
             const warnings = await campaignTimezoneWarnings(result);
-            return j({ ...result, ...await campaignTriggerOutput(result), ...(warnings.length ? { warnings } : {}) });
+            return j({ ...campaignMetricsView(result), ...await campaignTriggerOutput(result), ...(warnings.length ? { warnings } : {}) });
         }
         const { campaign_id, name, site_id, segment_id, send_at, topic, trigger_event_name, trigger_tag, trigger_type, trigger_config, type, sends_per_hour, send_in_contact_timezone, send_class, unsub_footer_template, reentry_mode, period_key } = input;
         if (!campaign_id)
@@ -3860,7 +3863,7 @@ Return ONLY valid JSON with this exact shape:
         const diagnostics = buildCampaignTriggerDiagnostics(data);
         const warning = diagnostics.find((d) => d.includes('never fire')) || (diagnostics.length ? diagnostics[0] : null);
         return j({
-            ...data,
+            ...campaignMetricsView(data),
             fires_on: buildCampaignFiresOn(data),
             trigger_diagnostics: diagnostics,
             warnings: [...diagnostics, ...await campaignTimezoneWarnings(data)],
@@ -3948,7 +3951,7 @@ Return ONLY valid JSON with this exact shape:
         const failedCount = failedSendCount ?? 0;
         const unresolvedCount = dlqUnresolvedCount ?? 0;
         return j({
-            ...campaign,
+            ...campaignMetricsView(campaign),
             reentry_mode: campaign.period_key ? "per_event_period" : "once_ever",
             requires_approval_description: ACTIVATION_APPROVAL_DESCRIPTION,
             ...await campaignTriggerOutput(campaign),

package/package.json

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