@sendinel/mcp-server 1.0.3 → 1.0.5

package/build/tools/automations.js

@@ -7,9 +7,133 @@ import { buildVoicePrompt, buildEmailSystemPrompt } from '../lib/voice.js';
 import { getAnthropicModelId } from '../anthropic-model.js';
 const txt = (text) => ({ content: [{ type: 'text', text }] });
 const j = (data) => txt(JSON.stringify(data, null, 2));
+function normalizeValue(value) {
+    if (typeof value !== 'string')
+        return null;
+    const normalized = value.trim().toLowerCase().replace(/[\s-]+/g, '_');
+    return normalized || null;
+}
+function normalizeList(value) {
+    const raw = Array.isArray(value) ? value : typeof value === 'string' ? [value] : [];
+    return Array.from(new Set(raw.map(normalizeValue).filter((item) => Boolean(item))));
+}
+function triggerConfig(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value))
+        return { events: [], tags: [] };
+    const config = value;
+    return {
+        events: normalizeList(config.events ?? config.event_names ?? config.trigger_event_names),
+        tags: normalizeList(config.tags ?? config.trigger_tags ?? config.entity_tags ?? config.project_tags),
+    };
+}
+function campaignMatchesTrigger(campaign, input) {
+    const config = triggerConfig(campaign.trigger_config);
+    const legacyEvent = normalizeValue(campaign.trigger_event_name);
+    const legacyTag = normalizeValue(campaign.trigger_tag);
+    const campaignEvents = Array.from(new Set([...(legacyEvent ? [legacyEvent] : []), ...config.events]));
+    const campaignTags = Array.from(new Set([...(legacyTag ? [legacyTag] : []), ...config.tags]));
+    const event = normalizeValue(input.event);
+    const tags = new Set((input.tags ?? []).map(normalizeValue).filter((tag) => Boolean(tag)));
+    if (campaignEvents.length > 0 && (!event || !campaignEvents.includes(event)))
+        return false;
+    if (campaignTags.length > 0 && !campaignTags.some((tag) => tags.has(tag)))
+        return false;
+    return campaignEvents.length > 0 || campaignTags.length > 0;
+}
+async function enrollSubscriberIntoTriggeredCampaigns(input) {
+    const { subscriber_id, campaign_id, site_id, trigger_event_name, trigger_event_names, trigger_tag, trigger_tags, next_send_at, context } = input;
+    const triggerEvents = Array.from(new Set([...normalizeList(trigger_event_names), ...(trigger_event_name ? [trigger_event_name] : [])]));
+    const triggerTags = Array.from(new Set([...normalizeList(trigger_tags), ...(trigger_tag ? [trigger_tag] : [])]));
+    const projectId = getProjectId();
+    const { data: subscriber, error: subscriberError } = await db()
+        .from('subscribers')
+        .select('id, email, global_unsubscribed, cooled_at')
+        .eq('id', subscriber_id)
+        .eq('project_id', projectId)
+        .maybeSingle();
+    if (subscriberError)
+        return txt(`Error: ${subscriberError.message}`);
+    if (!subscriber)
+        return j({ error: 'Subscriber not found', code: 'NOT_FOUND' });
+    if (subscriber.global_unsubscribed)
+        return j({ enrolled: 0, skipped: 'global_unsubscribed' });
+    if (subscriber.cooled_at)
+        return j({ enrolled: 0, skipped: 'cooled_contact' });
+    const { data: suppression } = await db()
+        .from('suppressions')
+        .select('id')
+        .eq('project_id', projectId)
+        .eq('email', subscriber.email)
+        .maybeSingle();
+    if (suppression)
+        return j({ enrolled: 0, skipped: 'suppressed' });
+    let query = db()
+        .from('campaigns')
+        .select('id, name, site_id, trigger_event_name, trigger_tag, trigger_config')
+        .eq('project_id', projectId)
+        .eq('type', 'triggered')
+        .eq('status', 'active');
+    if (campaign_id)
+        query = query.eq('id', campaign_id);
+    if (site_id)
+        query = query.eq('site_id', site_id);
+    if (!campaign_id && !triggerEvents.length && !triggerTags.length) {
+        return txt('Provide campaign_id, trigger_event_name(s), or trigger_tag(s).');
+    }
+    const { data: candidateCampaigns, error: campaignError } = await query;
+    if (campaignError)
+        return txt(`Error: ${campaignError.message}`);
+    const campaigns = campaign_id
+        ? (candidateCampaigns ?? [])
+        : (candidateCampaigns ?? []).filter((campaign) => triggerEvents.some(event => campaignMatchesTrigger(campaign, { event, tags: triggerTags }))
+            || (!triggerEvents.length && campaignMatchesTrigger(campaign, { tags: triggerTags })));
+    if (!campaigns?.length)
+        return j({ enrolled: 0, campaigns: [], skipped: 'no_matching_active_automation' });
+    const sendAt = next_send_at ?? new Date().toISOString();
+    const rows = campaigns.map((campaign) => ({
+        campaign_id: campaign.id,
+        contact_id: subscriber_id,
+        current_step: 0,
+        status: 'active',
+        enrolled_at: new Date().toISOString(),
+        next_send_at: sendAt,
+        enrollment_context: context ?? {},
+    }));
+    const { data: inserted, error: enrollError } = await db()
+        .from('campaign_enrollments')
+        .upsert(rows, { onConflict: 'campaign_id,contact_id', ignoreDuplicates: true })
+        .select('id, campaign_id');
+    if (enrollError)
+        return txt(`Error: ${enrollError.message}`);
+    if (inserted?.length) {
+        for (const campaign of campaigns) {
+            const count = inserted.filter((row) => row.campaign_id === campaign.id).length;
+            if (count > 0) {
+                const { data: current } = await db().from('campaigns').select('total_enrolled').eq('id', campaign.id).maybeSingle();
+                await db().from('campaigns').update({ total_enrolled: (current?.total_enrolled ?? 0) + count }).eq('id', campaign.id);
+            }
+        }
+    }
+    return j({
+        enrolled: inserted?.length ?? 0,
+        subscriber_id,
+        campaigns: campaigns.map((campaign) => ({
+            id: campaign.id,
+            name: campaign.name,
+            matched: Boolean(inserted?.some((row) => row.campaign_id === campaign.id)),
+        })),
+    });
+}
 export function registerAutomationTools(server) {
     // ── list_automations ──────────────────────────────────────────────────────
     server.registerTool('list_automations', {
+        title: 'List Automations',
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
         description: 'List content automation sources (RSS feeds, GitHub Issues, webhooks, schedules). Each source auto-generates email drafts when new content is found.',
         inputSchema: {
             site_id: z.string().uuid().optional().describe('Filter by site UUID'),
@@ -31,97 +155,189 @@ export function registerAutomationTools(server) {
         return j(data ?? []);
     });
     server.registerTool('enroll_automation', {
+        title: 'Enroll Automation',
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
         description: 'Enroll a subscriber into active triggered automation campaigns. Match by campaign_id, trigger_event_name, or trigger_tag. Safe to call repeatedly.',
         inputSchema: {
             subscriber_id: z.string().uuid().describe('Subscriber/contact UUID to enroll'),
             campaign_id: z.string().uuid().optional().describe('Specific triggered campaign UUID'),
             site_id: z.string().uuid().optional().describe('Optional site scope when matching by trigger'),
             trigger_event_name: z.string().optional().describe('Event trigger name, e.g. signup'),
+            trigger_event_names: z.array(z.string()).optional().describe('OR-combined event trigger names, e.g. ["contact_created", "form_submitted"]'),
             trigger_tag: z.string().optional().describe('Tag trigger name'),
+            trigger_tags: z.array(z.string()).optional().describe('Tag/entity filters for reusable triggered campaigns'),
             next_send_at: z.string().datetime().optional().describe('First send time. Defaults to now.'),
             context: z.record(z.string(), z.unknown()).optional().describe('Optional enrollment context metadata'),
         },
-    }, async ({ subscriber_id, campaign_id, site_id, trigger_event_name, trigger_tag, next_send_at, context }) => {
+    }, enrollSubscriberIntoTriggeredCampaigns);
+    server.registerTool('create_escalation_ladder', {
+        title: 'Create Escalation Ladder',
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
+        description: 'Create or update response-gated escalation ladder steps for an active triggered campaign. This defines the ladder only; automatic advancement remains disabled until response detection is wired.',
+        inputSchema: {
+            campaign_id: z.string().uuid().describe('Active triggered campaign UUID'),
+            steps: z.array(z.object({
+                step_index: z.number().int().min(0).describe('Zero-based ladder step index'),
+                wait_hours: z.number().int().min(0).default(0).describe('Hours to wait before this step is eligible'),
+                channel: z.enum(['email', 'sms', 'voicemail', 'manual']).describe('Planned channel for the step'),
+                action_type: z.enum(['send_win_back_draft', 'send_template', 'notify_human', 'no_op']).describe('Action to take if the contact has not responded'),
+                content_ref: z.record(z.string(), z.unknown()).optional().describe('Reference to existing content/template/draft metadata'),
+                response_gate: z.record(z.string(), z.boolean()).optional().describe('Response signals that halt the ladder, e.g. { "reply": true, "click": true, "booking": true }'),
+            })).min(1).max(20),
+        },
+    }, async ({ campaign_id, steps }) => {
         const projectId = getProjectId();
-        const { data: subscriber, error: subscriberError } = await db()
-            .from('subscribers')
-            .select('id, email, global_unsubscribed')
-            .eq('id', subscriber_id)
+        const { data: campaign, error: campaignError } = await db()
+            .from('campaigns')
+            .select('id, name, type, status')
+            .eq('id', campaign_id)
             .eq('project_id', projectId)
             .maybeSingle();
-        if (subscriberError)
-            return txt(`Error: ${subscriberError.message}`);
-        if (!subscriber)
-            return j({ error: 'Subscriber not found', code: 'NOT_FOUND' });
-        if (subscriber.global_unsubscribed)
-            return j({ enrolled: 0, skipped: 'global_unsubscribed' });
-        const { data: suppression } = await db()
-            .from('suppressions')
+        if (campaignError)
+            return txt(`Error: ${campaignError.message}`);
+        if (!campaign)
+            return j({ error: 'Campaign not found', code: 'NOT_FOUND' });
+        if (campaign.type !== 'triggered')
+            return j({ error: 'Escalation ladders require a triggered campaign', code: 'INVALID_CAMPAIGN_TYPE' });
+        const rows = steps.map((step) => ({
+            campaign_id,
+            step_index: step.step_index,
+            wait_hours: step.wait_hours ?? 0,
+            channel: step.channel,
+            action_type: step.action_type,
+            content_ref: step.content_ref ?? {},
+            response_gate: step.response_gate ?? { reply: true, click: true, booking: true },
+            updated_at: new Date().toISOString(),
+        }));
+        const { data, error } = await db()
+            .from('campaign_step_gates')
+            .upsert(rows, { onConflict: 'campaign_id,step_index' })
+            .select('id, campaign_id, step_index, wait_hours, channel, action_type, content_ref, response_gate')
+            .order('step_index', { ascending: true });
+        if (error)
+            return txt(`Error: ${error.message}`);
+        return j({
+            campaign_id,
+            campaign_name: campaign.name,
+            status: campaign.status,
+            steps: data ?? [],
+            advancement_enabled: false,
+            note: 'Ladder definition saved. Automatic response-gated advancement is intentionally disabled until reply/booking signal schemas are confirmed.',
+        });
+    });
+    server.registerTool('enroll_in_escalation_ladder', {
+        title: 'Enroll In Escalation Ladder',
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
+        description: 'Enroll a subscriber into an active triggered campaign that has escalation ladder steps. Reuses enroll_automation suppression and unsubscribe checks.',
+        inputSchema: {
+            subscriber_id: z.string().uuid().describe('Subscriber/contact UUID to enroll'),
+            campaign_id: z.string().uuid().describe('Triggered campaign UUID with ladder steps'),
+            next_send_at: z.string().datetime().optional().describe('First eligible send time. Defaults to now.'),
+            context: z.record(z.string(), z.unknown()).optional().describe('Optional enrollment context metadata'),
+        },
+    }, async ({ subscriber_id, campaign_id, next_send_at, context }) => {
+        const projectId = getProjectId();
+        const { data: gate, error: gateError } = await db()
+            .from('campaign_step_gates')
             .select('id')
-            .eq('project_id', projectId)
-            .eq('email', subscriber.email)
+            .eq('campaign_id', campaign_id)
+            .limit(1)
             .maybeSingle();
-        if (suppression)
-            return j({ enrolled: 0, skipped: 'suppressed' });
-        let query = db()
+        if (gateError)
+            return txt(`Error: ${gateError.message}`);
+        if (!gate)
+            return j({ enrolled: 0, skipped: 'no_escalation_ladder_steps' });
+        return enrollSubscriberIntoTriggeredCampaigns({
+            subscriber_id,
+            campaign_id,
+            next_send_at,
+            context: { ...(context ?? {}), escalation_ladder: true, project_id: projectId },
+        });
+    });
+    server.registerTool('list_escalation_ladder_status', {
+        title: 'List Escalation Ladder Status',
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+        description: 'List enrollment status for a response-gated escalation ladder campaign, including current step and response-exit fields.',
+        inputSchema: {
+            campaign_id: z.string().uuid().describe('Escalation ladder campaign UUID'),
+        },
+    }, async ({ campaign_id }) => {
+        const projectId = getProjectId();
+        const { data: campaign, error: campaignError } = await db()
             .from('campaigns')
-            .select('id, name, site_id, trigger_event_name, trigger_tag')
+            .select('id, name, status')
+            .eq('id', campaign_id)
             .eq('project_id', projectId)
-            .eq('type', 'triggered')
-            .eq('status', 'active');
-        if (campaign_id)
-            query = query.eq('id', campaign_id);
-        if (site_id)
-            query = query.eq('site_id', site_id);
-        if (trigger_event_name)
-            query = query.eq('trigger_event_name', trigger_event_name.trim());
-        if (trigger_tag)
-            query = query.eq('trigger_tag', trigger_tag.trim().toLowerCase());
-        if (!campaign_id && !trigger_event_name && !trigger_tag) {
-            return txt('Provide campaign_id, trigger_event_name, or trigger_tag.');
-        }
-        const { data: campaigns, error: campaignError } = await query;
+            .maybeSingle();
         if (campaignError)
             return txt(`Error: ${campaignError.message}`);
-        if (!campaigns?.length)
-            return j({ enrolled: 0, campaigns: [], skipped: 'no_matching_active_automation' });
-        const sendAt = next_send_at ?? new Date().toISOString();
-        const rows = campaigns.map((campaign) => ({
-            campaign_id: campaign.id,
-            contact_id: subscriber_id,
-            current_step: 0,
-            status: 'active',
-            enrolled_at: new Date().toISOString(),
-            next_send_at: sendAt,
-            enrollment_context: context ?? {},
-        }));
-        const { data: inserted, error: enrollError } = await db()
-            .from('campaign_enrollments')
-            .upsert(rows, { onConflict: 'campaign_id,contact_id', ignoreDuplicates: true })
-            .select('id, campaign_id');
-        if (enrollError)
-            return txt(`Error: ${enrollError.message}`);
-        if (inserted?.length) {
-            for (const campaign of campaigns) {
-                const count = inserted.filter((row) => row.campaign_id === campaign.id).length;
-                if (count > 0) {
-                    const { data: current } = await db().from('campaigns').select('total_enrolled').eq('id', campaign.id).maybeSingle();
-                    await db().from('campaigns').update({ total_enrolled: (current?.total_enrolled ?? 0) + count }).eq('id', campaign.id);
-                }
-            }
+        if (!campaign)
+            return j({ error: 'Campaign not found', code: 'NOT_FOUND' });
+        const [{ data: steps, error: stepsError }, { data: enrollments, error: enrollmentsError }] = await Promise.all([
+            db()
+                .from('campaign_step_gates')
+                .select('id, step_index, wait_hours, channel, action_type, response_gate')
+                .eq('campaign_id', campaign_id)
+                .order('step_index', { ascending: true }),
+            db()
+                .from('campaign_enrollments')
+                .select('id, contact_id, current_step, status, enrolled_at, next_send_at, completed_at, exited_reason, response_detected_at, response_type, enrollment_context')
+                .eq('campaign_id', campaign_id)
+                .order('enrolled_at', { ascending: false }),
+        ]);
+        if (stepsError)
+            return txt(`Error: ${stepsError.message}`);
+        if (enrollmentsError)
+            return txt(`Error: ${enrollmentsError.message}`);
+        const contactIds = [...new Set((enrollments ?? []).map((row) => row.contact_id))];
+        let contactsById = new Map();
+        if (contactIds.length) {
+            const { data: contacts } = await db()
+                .from('subscribers')
+                .select('id, email, first_name')
+                .eq('project_id', projectId)
+                .in('id', contactIds);
+            contactsById = new Map((contacts ?? []).map((contact) => [contact.id, contact]));
         }
         return j({
-            enrolled: inserted?.length ?? 0,
-            subscriber_id,
-            campaigns: campaigns.map((campaign) => ({
-                id: campaign.id,
-                name: campaign.name,
-                matched: Boolean(inserted?.some((row) => row.campaign_id === campaign.id)),
+            campaign,
+            steps: steps ?? [],
+            advancement_enabled: false,
+            enrollments: (enrollments ?? []).map((row) => ({
+                ...row,
+                subscriber: contactsById.get(row.contact_id) ?? null,
             })),
         });
     });
     // ── preview_automation ────────────────────────────────────────────────────
     server.registerTool('preview_automation', {
+        title: 'Preview Automation',
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
         description: 'Preview what content would be fetched from a source right now, without generating a draft. Use this to inspect GitHub issues, RSS items, etc. before triggering a full run.',
         inputSchema: {
             source_id: z.string().uuid().describe('The content source UUID to preview'),
@@ -199,6 +415,13 @@ export function registerAutomationTools(server) {
     });
     // ── trigger_automation ────────────────────────────────────────────────────
     server.registerTool('trigger_automation', {
+        title: 'Trigger Automation',
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: true,
+        },
         description: 'Run a content source on demand right now — fetches new content, generates a certificate-prompted email draft, and adds it to the approval queue. Returns the draft ID. Use preview_automation first to confirm what content will be pulled.',
         inputSchema: {
             source_id: z.string().uuid().describe('The content source UUID to trigger'),

package/build/tools/brand-kit.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerBrandKitTools(server: McpServer): void;