@sendinel/mcp-server 1.0.38 → 1.0.40

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/build/tools/contacts.js

@@ -2109,17 +2109,22 @@ Requirements: urgency without desperation, acknowledge the gap, one clear CTA, v
             confidence_threshold: z.number().min(0.5).max(1).optional().describe('Minimum similarity (0.5-1.0, default 0.8)'),
             limit: z.number().int().min(1).max(200).optional().describe('Max duplicate groups (default 50)'),
             site_id: z.string().uuid().optional().describe('Filter to contacts subscribed to this site'),
+            include_test: z.boolean().optional().describe('Include is_test (seed/fixture) contacts. Default false, matching the dashboard contact list.'),
         },
-    }, async ({ confidence_threshold = 0.8, limit = 50, site_id }) => {
+    }, async ({ confidence_threshold = 0.8, limit = 50, site_id, include_test = false }) => {
         const projectId = getProjectId();
         const maxGroups = Math.min(limit, 200);
+        const CONTACT_SCAN_LIMIT = 2000;
         let q = db()
             .from('subscribers')
-            .select('id, email, first_name, last_name, engagement_score, lifecycle_stage, created_at, source')
+            .select('id, email, first_name, last_name, engagement_score, lifecycle_stage, created_at, source', { count: 'exact' })
             .eq('project_id', projectId)
             .eq('global_unsubscribed', false)
             .order('created_at', { ascending: true })
-            .limit(2000);
+            .limit(CONTACT_SCAN_LIMIT);
+        // #3604: hide seed/fixture rows like every other default contact view.
+        if (!include_test)
+            q = q.not('is_test', 'is', true);
         if (site_id) {
             const { data: subs } = await db()
                 .from('site_subscriptions')
@@ -2128,14 +2133,18 @@ Requirements: urgency without desperation, acknowledge the gap, one clear CTA, v
                 .eq('subscribed', true);
             const ids = (subs ?? []).map((s) => s.contact_id);
             if (!ids.length)
-                return j({ duplicate_groups: [], total_groups: 0 });
+                return j({ duplicate_groups: [], total_groups: 0, coverage: { contacts_scanned: 0, contacts_matching: 0, contact_limit: CONTACT_SCAN_LIMIT, complete: true } });
             q = q.in('id', ids);
         }
-        const { data: contacts, error } = await q;
+        const { data: contacts, error, count } = await q;
         if (error)
             return txt(`Error: ${error.message}`);
+        // #3604: say when the scan stopped at the limit instead of presenting a partial scan as complete.
+        const scanned = contacts?.length ?? 0;
+        const matching = typeof count === 'number' ? count : null;
+        const coverage = { contacts_scanned: scanned, contacts_matching: matching, contact_limit: CONTACT_SCAN_LIMIT, complete: matching === null ? null : matching <= scanned };
         if (!contacts?.length)
-            return j({ duplicate_groups: [], total_groups: 0 });
+            return j({ duplicate_groups: [], total_groups: 0, coverage });
         const lev = (a, b) => {
             const m = a.length, n = b.length;
             const dp = Array.from({ length: m + 1 }, (_, i) => i);
@@ -2211,7 +2220,7 @@ Requirements: urgency without desperation, acknowledge the gap, one clear CTA, v
         }
         groups.sort((a, b) => b.confidence - a.confidence);
         const result = groups.slice(0, maxGroups);
-        return j({ duplicate_groups: result, total_groups: result.length });
+        return j({ duplicate_groups: result, total_groups: result.length, coverage });
     });
     server.registerTool('merge_subscribers', {
         title: 'Merge Subscribers',

package/package.json

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