@sendinel/mcp-server 1.0.171 → 1.0.172

package/build/lib/email-generation.d.ts

@@ -1,5 +1,9 @@
 import type Anthropic from '@anthropic-ai/sdk';
 import { type ComposerBlock } from './composer-blocks.js';
+/** Known unsupported targeting must fail before a model can invent a property rule. */
+export declare function unsupportedAudienceReason(description: string): string | null;
+export declare class AudienceNotUnderstoodError extends Error {
+}
 export declare function parseAudienceRules(anthropic: Anthropic, description: string): Promise<Record<string, unknown>>;
 export type GeneratedEmail = {
     subject: string;

package/build/lib/email-generation.js

@@ -11,24 +11,39 @@ import { BLOCK_GENERATION_SCHEMA, blocksToHtml, blocksToText, normalizeComposerB
 function parseJsonResponse(raw) {
     return JSON.parse(raw.replace(/```json?\n?|```/g, '').trim());
 }
+const EMAIL_DOMAIN_AUDIENCE_MESSAGE = 'Audiences by email address or domain are not supported. Create a segment using a tag or property rule, or pass segment_id for a saved segment.';
+/** Known unsupported targeting must fail before a model can invent a property rule. */
+export function unsupportedAudienceReason(description) {
+    return /\be-?mail[\s_-]+domains?\b|\be-?mail(?:\s+addresses?)?\s+(?:ends?\s+with|contains?|matches?|is\b|at\b)|@[a-z0-9](?:[a-z0-9.-]*\.)[a-z]{2,}\b/i.test(description)
+        ? EMAIL_DOMAIN_AUDIENCE_MESSAGE : null;
+}
+export class AudienceNotUnderstoodError extends Error {
+}
 export async function parseAudienceRules(anthropic, description) {
+    const unsupported = unsupportedAudienceReason(description);
+    if (unsupported)
+        throw new AudienceNotUnderstoodError(unsupported);
     const resp = await anthropic.messages.create({
         model: getAnthropicModelId(),
         max_tokens: AI_MAX_TOKENS,
         ...outputConfig("low"),
-        system: 'You translate natural language audience descriptions into a JSON filter rules object. Return ONLY valid JSON. Available keys: lifecycle_stage (lead|trial|customer|churned|win-back), payment (object with plan, mrr_cents, ltv_cents, subscription_status, trial_ends_at, churned_at, paid_at), min_score, max_score, source, subscribed_after, subscribed_before, has_opened, has_clicked, tag, custom_property, exclude_suppressed. Example: {"payment":{"plan":"pro","trial_ends_at":{"within_days":7}},"lifecycle_stage":"trial"}. Today is ' + new Date().toISOString().slice(0, 10) + '.',
+        system: 'You translate natural language audience descriptions into a JSON filter rules object. Return ONLY valid JSON. Available keys: match_all, lifecycle_stage (lead|trial|customer|churned|win-back), payment (object with plan, mrr_cents, ltv_cents, subscription_status, trial_ends_at, churned_at, paid_at), min_score, max_score, source, subscribed_after, subscribed_before, has_opened, has_clicked, tag, custom_property (a string like "plan=pro"), exclude_suppressed. Everyone, all contacts, all subscribers or all means {"match_all":true}. There is no email address or email-domain rule. Never invent keys or use custom_property for email targeting; return {"error":"' + EMAIL_DOMAIN_AUDIENCE_MESSAGE + '"} instead. For any other unsupported audience return an error object explaining why. Example: {"payment":{"plan":"pro","trial_ends_at":{"within_days":7}},"lifecycle_stage":"trial"}. Today is ' + new Date().toISOString().slice(0, 10) + '.',
         messages: [{ role: 'user', content: description }],
     });
     const text = anthropicCheckedText(resp);
+    let rules;
     try {
-        const rules = parseJsonResponse(text);
+        rules = parseJsonResponse(text);
         if (!rules || typeof rules !== 'object' || Array.isArray(rules))
             throw new Error('not an object');
-        return rules;
     }
     catch {
-        throw new Error(`Could not understand the audience "${description}". Try a saved segment instead.`);
+        throw new AudienceNotUnderstoodError(`Could not understand the audience "${description}". Try a saved segment instead.`);
     }
+    if ('error' in rules)
+        throw new AudienceNotUnderstoodError(typeof rules.error === 'string'
+            ? rules.error : 'This audience is not supported. Try a saved segment instead.');
+    return rules;
 }
 export async function generateEmailFromBrief(anthropic, projectId, siteId, brief) {
     const [{ data: site, error: siteError }, { data: project, error: projectError }] = await Promise.all([

package/build/tools/campaigns.js

@@ -4,7 +4,7 @@ import { resolveCampaignReentry, readCampaignPeriods, campaignPeriodFields } fro
 import { CAMPAIGN_BRANCH_CONDITIONS, campaignBranchConditionValue, isContactPropertyConditionList, STEP_PROPERTY_CONDITIONS_ERROR, validateStepPropertyRules } from "@sendinel/domain";
 import { z } from 'zod';
 import Anthropic from '@anthropic-ai/sdk';
-import { stripActiveEmailContent, assertSendAccepted, providerSendError, sendError, SendRefusedError, BLOCKING_CONTENT_ISSUE_KINDS, computeSendContentKey, findContentIssues, sendingHostOf, NAME_FALLBACKS, ONE_SEND_MATCH_STATUSES, ONE_SEND_SENT_STATUSES, ONE_SEND_WINDOW_DAYS, normalizeTriggerConfig, renderTemplateString as renderTemplateVars, resolveBrandTokens, brandWarnings, readAllRows, isSegmentRulesError, scopeSegmentRulesToSite, SegmentRulesError, validateSegmentRules, validateUnsubFooterTemplate, } from '@sendinel/domain';
+import { stripActiveEmailContent, assertSendAccepted, providerSendError, sendError, SendRefusedError, BLOCKING_CONTENT_ISSUE_KINDS, computeSendContentKey, findContentIssues, sendingHostOf, NAME_FALLBACKS, ONE_SEND_MATCH_STATUSES, ONE_SEND_SENT_STATUSES, ONE_SEND_WINDOW_DAYS, normalizeTriggerConfig, renderTemplateString as renderTemplateVars, resolveBrandTokens, brandWarnings, readAllRows, isSegmentRulesError, scopeSegmentRulesToSite, SegmentRulesError, validateSegmentRules, validateUnsubFooterTemplate, SEGMENT_MATCH_ALL, } from '@sendinel/domain';
 // Subpath import, not the barrel above -- reply-actions.ts uses node:crypto,
 // and MCP-server-side that's fine (this never runs in an Edge Function), but
 // keeping it off the shared barrel avoids re-creating the Edge-Function
@@ -22,7 +22,7 @@ import { fireWebhookEvent } from '../lib/webhook-events.js';
 import { approvalNext, approvalExcerpt, assertChannelCanExecute, currentChannelContext, requestApproval, checkApproval, withApproval } from '../lib/action-approvals.js';
 import { sandboxAudience, broadcastApprovalNext } from '../lib/sandbox-audience.js';
 import { resolveSegmentContactIds, resolveSendAudience } from '../lib/send-audience.js';
-import { generateEmailFromBrief, parseAudienceRules } from '../lib/email-generation.js';
+import { AudienceNotUnderstoodError, generateEmailFromBrief, parseAudienceRules, unsupportedAudienceReason } from '../lib/email-generation.js';
 import { getAnthropicModelId } from '../anthropic-model.js';
 import { AI_MAX_TOKENS, outputConfig, anthropicCheckedText } from '@sendinel/domain';
 import { getScheduleWindowBounds, groupScheduleByCampaign, parseFutureDate } from '../lib/schedule.js';
@@ -1580,8 +1580,12 @@ export function registerCampaignTools(server) {
                 sites: (sites ?? []).map((s) => ({ id: s.id, name: s.name, from_email: s.from_email })),
             });
         }
+        const everyone = audience !== undefined && ['everyone', 'all contacts', 'all subscribers', 'all'].includes(audience.trim().toLowerCase().replace(/[.!?,;:]+$/, '').trim());
+        const unsupported = audience ? unsupportedAudienceReason(audience) : null;
+        if (unsupported)
+            return j({ error: unsupported, code: 'AUDIENCE_NOT_UNDERSTOOD' });
         const apiKey = process.env.ANTHROPIC_API_KEY;
-        if ((audience || brief) && !apiKey)
+        if (((audience && !everyone) || brief) && !apiKey)
             return j({ error: 'ANTHROPIC_API_KEY not configured', code: 'AI_NOT_CONFIGURED' });
         const anthropic = apiKey ? new Anthropic({ apiKey }) : null;
         let rules;
@@ -1600,12 +1604,17 @@ export function registerCampaignTools(server) {
             rules = scopeSegmentRulesToSite(segment.rules, segment.site_id);
             segmentName = segment.name;
         }
+        else if (everyone) {
+            rules = { ...SEGMENT_MATCH_ALL };
+            segmentName = audience;
+        }
         else {
             try {
                 rules = await parseAudienceRules(anthropic, audience);
             }
             catch (error) {
-                return j({ error: error instanceof Error ? dbToolError(error).error : String(error), code: 'AUDIENCE_NOT_UNDERSTOOD' });
+                return j({ error: error instanceof AudienceNotUnderstoodError ? error.message
+                        : error instanceof Error ? dbToolError(error).error : String(error), code: 'AUDIENCE_NOT_UNDERSTOOD' });
             }
             segmentName = audience;
         }

package/package.json

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