@sendinel/mcp-server 1.0.38 → 1.0.39

package/build/tools/campaigns.js

@@ -305,6 +305,33 @@ async function executeBroadcast(input) {
     }
     return { ok: true, campaignId: campaign.id, stepId: step.id, enrolled: input.contactIds.length, nextSendAt };
 }
+/** #3714: a send nobody could receive leaves one audit row (counts by reason, no addresses). */
+function logRefusedSend(kind, siteId, sendClass, audience, extra = {}) {
+    const reasons = {};
+    if (audience.notOnSender > 0)
+        reasons.not_subscribed_to_sender = audience.notOnSender;
+    for (const [reason, count] of Object.entries(audience.heldBack)) {
+        if (count > 0)
+            reasons[`consent_${reason}`] = count;
+    }
+    return logAudit({
+        action: 'send.refused',
+        resourceType: 'site',
+        resourceId: siteId,
+        details: {
+            kind,
+            outcome: 'nothing_sent',
+            send_class: sendClass,
+            site_id: siteId,
+            campaign_id: null,
+            requested: audience.matched,
+            enrolled: 0,
+            refused: Object.values(reasons).reduce((sum, count) => sum + count, 0),
+            reasons,
+            ...extra,
+        },
+    });
+}
 function heldBackLines(audience) {
     return {
         matched: audience.matched,
@@ -909,6 +936,7 @@ export function registerCampaignTools(server) {
             });
         }
         if (contactIds.length === 0) {
+            await logRefusedSend('broadcast_to_segment', site_id, 'broadcast', audience, { audience: { segment_id } });
             return j({
                 error: 'Nobody in this segment can get email from this sender right now.',
                 code: 'EMPTY_SEGMENT',
@@ -1153,6 +1181,7 @@ export function registerCampaignTools(server) {
             return j({ error: `Could not load this audience: ${error instanceof Error ? error.message : String(error)}`, code: 'AUDIENCE_LOOKUP_FAILED' });
         }
         if (resolved.contactIds.length === 0) {
+            await logRefusedSend('send_broadcast', site.id, sendClass, resolved, { audience: segment_id ? { segment_id } : { inline_rules: true } });
             return j({ error: 'Nobody in this audience can get this email from this sender.', code: 'EMPTY_AUDIENCE', audience: heldBackLines(resolved), rules });
         }
         let content;

package/package.json

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